docs(nips): allow relay-bounded agent ownership chains - #7193
Open
tlongwell-block wants to merge 1 commit into
Open
docs(nips): allow relay-bounded agent ownership chains#7193tlongwell-block wants to merge 1 commit into
tlongwell-block wants to merge 1 commit into
Conversation
Resolve ancestor endorsements from signed kind:0 profiles without changing the NIP-OA credential format. Define edge-counted depth, trusted roots, unconditional intermediate credentials, and fail-closed NIP-AA admission. Update session, revocation, quota, and privacy semantics and examples. Co-authored-by: Meli <5aaa86bce934fc3445fc254aab560a40923f10252f92107e665073dede0e04d3@buzz.block.builderlab.xyz> Signed-off-by: Meli <5aaa86bce934fc3445fc254aab560a40923f10252f92107e665073dede0e04d3@buzz.block.builderlab.xyz>
🔐 Codex Security Review
|
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
Allow agents to authorize child agents using existing NIP-OA credentials, with NIP-AA admission bounded by a relay-configurable ownership depth.
kind:0profiles. No new event kind, tag field, signing preimage, or credential format.n=1;n=0disables virtual admission; operators explicitly enable deeper chains.Deliberate tradeoffs
Enabling
n>1lets existing unconditional endorsements sponsor descendants without a new root signature. Intermediate endorsements must have empty conditions rather than introducing condition-composition semantics. This supplies neither signed per-agent delegation budgets nor immutable parent-path binding/global revocation. Profile changes affect the next authentication, not an established session's retained path; immediate revocation still requires disconnecting affected sessions.The direct-membership bypass is removed for known agents even at
n=1; relay classification must survive missing profiles. This is a normative spec change, not a claim of backward-compatible runtime behavior.Docs only: no relay/client implementation, config variable, provisioning UI, or executable formal model is included.
Related issue
Related: #7003 — a smaller recursive-lookup alternative using the existing OA/AA wire format, rather than introducing immutable grant-chain events. Does not close or modify that PR.
Testing
git diff --checkpassed; original OA credential rules/test-vector bytes and AA Step 4 verified unchanged; JSON code examples parse; new relative link target/heading checked.just cifailed duringtest-unitin unchangedbuzz-acptestacp::tests::keepalive_resets_idle_past_deadline: “keepalive should reset idle past the deadline; elapsed only 162.263917ms”. That lane stopped after 76/899 tests; later CI recipes did not run. Run was on base70895b355fcea9f99894b426c020052b715bd368with the docs patch; final wording clarifications followed. No green full-suite claim.