Add AR-PROV: Agent Provisioning Readiness category (discovery → access → commerce → provisioning) - #2
Open
developer-ainative wants to merge 2 commits into
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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/provisioningdiscovery profile with JSON Schema, four self-describing capability schemas, and a consent/security model. Full text inspec/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-AUTHstandardizes delegated access to an account a human already has (OAuth/OIDC, RFC 8414/9728, Web Bot Auth).AR-COMMstandardizes payment (x402, ACP, UCP, MPP).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
spec/categories/ar-prov.md(matching existingAR-*formatting and RFC 2119 usage)AR-PROV-01…10, grouped by three conformance levels — L1 Declared, L2 Programmatic, L3 Autonomous — so surfaces can adopt incrementally/.well-known/provisioningprofile + JSON Schema (modeled on the ecosystem's/.well-known/+ self-describing-schema convention)terms,account-create,credential-issuance,onboarding, reverse-domain named, transport-bound (REST / MCP / A2A)How it composes existing standards (no new primitives invented)
AR-AUTH— OAuth 2.0 + PKCE / OIDC. Provisioning produces the account that laterAR-AUTHflows authorize against.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-NNat 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-PROVcategory going forward. Happy to split this into smaller PRs (category text first, then schemas, then security section) if that's easier to review.Checklist
AR-*formatting and RFC 2119 usageFiled 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.