Skip to content

docs: align human authorization guidance with ANP-03 v1.1 - #95

Open
Math1987 wants to merge 3 commits into
agent-network-protocol:mainfrom
Math1987:codex/docs-human-authorization
Open

docs: align human authorization guidance with ANP-03 v1.1#95
Math1987 wants to merge 3 commits into
agent-network-protocol:mainfrom
Math1987:codex/docs-human-authorization

Conversation

@Math1987

Copy link
Copy Markdown

🔗 Related Issue | 相关 Issue

Relates to #90.


📝 PR Type | PR 类型

  • Feature | 新功能
  • Bugfix | 问题修复
  • Documentation | 文档修改
  • Style | 代码格式(不影响功能)
  • Refactor | 重构
  • Test | 测试相关
  • Chore | 其他

📋 Description | 描述

Aligns the human-authorization documentation with ANP-03 v1.1 without changing any wire format or implementation behavior.

Before:

  • the English and Chinese technical white papers still described humanAuthorization as a dedicated DID verification relationship/key;
  • ANP-03 showed authorizationLevel values without stating that they are non-normative examples;
  • ANP-07 did not explicitly distinguish an interface-level requirement from completed authorization;
  • the Chinese did:wba guide still listed humanAuthorization as DID key material.

After:

  • did:wba authentication remains responsible for request identity;
  • ANP-07 humanAuthorization: true declares an interface-level requirement;
  • draft ANP-06 requiresHumanAuthorization remains a negotiation constraint, not proof of completed authorization;
  • the applicable business protocol and authorization policies define how human authorization is obtained or evidenced.

The broader ANP-03 v1.1 refresh of docs/did-wba入门指南.md is intentionally out of scope; this PR only removes its directly conflicting human-authorization statement.

Updated English and Chinese documentation together where mirrored.

Validation:

  • git diff --check
  • verified all added repository-internal Markdown links resolve
  • documentation-only change; no automated tests are applicable

⚠️ Breaking Changes | 破坏性变更

  • Yes
  • No

✅ Checklist | 检查项

  • The code compiles correctly | 代码可以正确编译 — N/A, documentation-only
  • All tests passed | 所有测试均通过 — N/A, documentation-only
  • Relevant documentation updated | 已更新相关文档
  • PR has been linked to the related issue | 已关联相关 Issue

Align the English white paper and ANP-03/ANP-07 guidance with the layered authorization model discussed in agent-network-protocol#90.
Mirror the ANP-03 v1.1 authorization-layer clarification in the Chinese white paper and ANP-03/ANP-07 specifications.
Correct only the human-authorization statement in the Chinese did:wba guide; a broader ANP-03 v1.1 guide refresh remains out of scope.
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