Skip to content

Add AR-PROV: Agent Provisioning Readiness category (discovery → access → commerce → provisioning) - #2

Open
developer-ainative wants to merge 2 commits into
agentready-org:mainfrom
developer-ainative:category/ar-prov
Open

developer-ainative wants to merge 2 commits into
agentready-org:mainfrom
developer-ainative:category/ar-prov

Conversation

@developer-ainative

Copy link
Copy Markdown

Summary

This PR proposes a sixth category, AR-PROV (Agent Provisioning Readiness), that extends the standard from discovering, accessing, and paying a surface to provisioning a new account on it — an agent, under verifiable authorization from a human, creating and configuring a new account, accepting machine-readable terms, and receiving scoped credentials, without a human completing a form.

It adds: a category definition, conformance requirements AR-PROV-01…10, three conformance levels, a /.well-known/provisioning discovery profile with JSON Schema, four self-describing capability schemas, and a consent/security model. Full text in spec/categories/ar-prov.md.

Motivation — the gap

The current categories take an agent from discovery to payment, but there's an unaddressed step between them:

  • AR-AUTH standardizes delegated access to an account a human already has (OAuth/OIDC, RFC 8414/9728, Web Bot Auth).
  • AR-COMM standardizes payment (x402, ACP, UCP, MPP).
  • Neither standardizes creating the account in the first place.

Today an agent that wants to use a new service on a user's behalf must fall back to driving a human signup form in a browser — brittle, unauditable, and outside the standard. As agent-led commerce moves from demos to production, "provision a new relationship" becomes as load-bearing as "log into an existing one."

The distinction in one line: AR-AUTH = an agent borrows access to an account a human already has; AR-PROV = an agent creates and configures a new account, under verifiable authorization.

What this PR adds

  • Category file spec/categories/ar-prov.md (matching existing AR-* formatting and RFC 2119 usage)
  • Requirements AR-PROV-01…10, grouped by three conformance levels — L1 Declared, L2 Programmatic, L3 Autonomous — so surfaces can adopt incrementally
  • Discovery surface: /.well-known/provisioning profile + JSON Schema (modeled on the ecosystem's /.well-known/ + self-describing-schema convention)
  • Capability schemas: terms, account-create, credential-issuance, onboarding, reverse-domain named, transport-bound (REST / MCP / A2A)

How it composes existing standards (no new primitives invented)

  • Auth substrate: builds directly on AR-AUTH — OAuth 2.0 + PKCE / OIDC. Provisioning produces the account that later AR-AUTH flows authorize against.
  • Consent: verifiable, scoped, expiring Mandates aligned with the W3C Verifiable Credentials data model and the AP2 Mandate pattern.
  • Agent identity: Web Bot Auth / A2A agent cards.
  • Transport: OpenAPI / MCP / A2A.

Alignment with the project's non-goals

This PR is deliberately consistent with the standard's stated philosophy: it defines conformance only — no tiers, no badges, no readiness grade. A surface either meets AR-PROV-NN at a given level or it does not. Scoring is left entirely to implementers and explicitly out of scope here.

Security & abuse considerations

Provisioning is higher-stakes than discovery or payment (durable accounts + standing credentials), so the proposal includes a security section: Sybil/spam mitigation via Principal-bound Mandates and provider-declared rate limits; least-privilege, revocable credentials; replay/forgery protection (nonce + expiry + signature verification); an auditable Principal → Agent → Mandate → account chain; and graceful, machine-readable step-up (AR-PROV-10) so providers that require human verification can say so in-band rather than failing opaquely.

Reference implementation & maintenance

An open reference implementation (FastAPI provider + MCP transport, with a conformance test suite) is published alongside this proposal, and we're offering to maintain the AR-PROV category going forward. Happy to split this into smaller PRs (category text first, then schemas, then security section) if that's easier to review.

Checklist

  • Category text follows existing AR-* formatting and RFC 2119 usage
  • JSON Schemas validate
  • Requirements mapped to conformance levels
  • Security considerations included
  • No grading/scoring introduced (consistent with project non-goals)
  • Reference implementation linked

Filed by AINative Studio. We're also publishing this spec in our own reference namespace so adoption isn't blocked on review cadence — upstream inclusion is the goal, and we'll keep the two in sync.

AINative Admin added 2 commits June 20, 2026 17:08
Proposes a sixth category extending the standard from discovering,
accessing, and paying a surface to provisioning a new account on it.

- 10 requirements (AR-PROV-01..10) across 3 conformance levels
  (L1 Declared, L2 Programmatic, L3 Autonomous)
- Discovery surface: /.well-known/provisioning profile + JSON Schema
- 4 capability schemas: terms, account-create, credential-issuance,
  onboarding
- Consent model: verifiable Mandates (W3C VC aligned)
- Security considerations for abuse vectors
- Reference implementation (AINative Studio, FastAPI + MCP + ZeroDB)

Defines conformance only — no scores, tiers, or badges (consistent
with project non-goals).
The category/ar-prov branch had diverged from upstream/main before the
project's structural pivot from a five-category skeleton draft
(AR-DISC/CONT/CAP/AUTH/COMM) to the real, data-backed v1.0 spec
(AR-FIND/READ/ACT). Per the parent spec's own changelog, that five-category
skeleton was superseded and its identifiers retired when v1.0 shipped.

- Rewrote spec/categories/ar-prov.md to extend AR-ACT (the current spec's
  closest neighbor to provisioning) instead of the retired namespace, and to
  use the spec's actual MUST/SHOULD/MAY requirement levels instead of a
  separate L1/L2/L3 conformance-tier model (the parent spec's own non-goals
  section rules out scoring/tiers).
- Restored data/ and spec/spec.md from upstream/main, both byte-identical to
  the current upstream state.
- Removed the abandoned spec/draft.md skeleton.
- Updated README.md to describe this branch's purpose (the AR-PROV proposal)
  and document the alignment rationale.

The proposal's substantive content (provisioning profile schema, Mandate
model, capability schemas, security considerations, reference
implementation) is preserved as-is; only the framing and identifier scheme
changed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant