@agentunion/fastaun-browser 0.5.18 → 0.5.20

package/_packed_docs/protocol/11-Storage-/345/255/220/345/215/217/350/256/256.md

@@ -31,6 +31,14 @@ Storage 服务是 AUN 协议的应用层扩展，提供对象存储能力。负
 
 ## 11.3 控制面方法
 
+**权威对象读取**：`storage.head_object`、`storage.get_object` 和 `storage.fs.stat` 可传 `consistency: authoritative`，绕过正负缓存并确认恢复可用性。结果包含 `consistency`、`exists`、`owner_aid`、`bucket`、规范 `path` 和 Unix 秒 `observed_at`；存在时附摘要及现有对象元数据，get 返回完整严格 Base64 `content`。故障、权限错误和恢复未完成不得返回 `exists=false`；下载或网关 404 不能证明权威不存在。
+
+
+
+规范 `default/agent.md` 与 `default/sub_aids/{sub_aid}/owner.md` 的上传会话使用独立临时对象，`create_upload_session` 返回 `session_id`；新客户端完成这些规范文件时必须携带同一 `session_id`。服务端核对会话的认证申请者、目标及有效期，验证完整内容后原子发布，失败保留旧完整文件。普通对象保持既有上传流程，不保证返回 `session_id`；该临时会话不记录 Ownership 关系事实或路径历史。
+
+Ownership 2.1 的 `default/sub_aids/{sub_aid}/owner.md` 必须公开可读，只有命名空间所属 owner 可修改、删除；该限制覆盖 ACL、token、父目录、移动、重命名、软链、挂载及自动清理，不能由通用权限顺序放宽。关系释放仍以 NS 验收为准；完整规则见 [Ownership 协议定义 2.1](Ownership协议定义2.1.md)。
+
 ### `storage.put_object`
 
 内联写入小对象（≤ 内联上限）。
@@ -67,9 +75,12 @@ Storage 服务是 AUN 协议的应用层扩展，提供对象存储能力。负
 | `owner_aid` | string | ❌ | 默认调用者 AID |
 | `bucket` | string | ❌ | 默认 `"default"` |
 | `object_key` | string | ✅ | 对象路径 |
+| `consistency` | string | ❌ | 传 `authoritative` 时绕过缓存并返回完整权威对象 |
 
 **响应**：`{ owner_aid, bucket, object_key, content (base64), content_type, size_bytes, sha256, version, updated_at }`
 
+可选 `consistency: authoritative` 返回本节定义的权威对象结果；权威 get 要求完整对象，不接受范围读取。
+
 **权限**：私有对象仅所有者可读；公开对象（`is_private=false`）任何 AID 可读。
 
 ### `storage.head_object`
@@ -80,15 +91,17 @@ Storage 服务是 AUN 协议的应用层扩展，提供对象存储能力。负
 
 **响应**：`{ owner_aid, bucket, object_key, content_type, size_bytes, sha256, version, etag, is_private, expire_at, created_at, updated_at }`
 
+可选 `consistency: authoritative` 返回本节定义的权威对象结果，包括明确当前不存在。
+
 **权限**：同 `get_object`。
 
 ### `storage.delete_object`
 
 删除单个对象。
 
-**参数**：同 `get_object`。
+**参数**：对象寻址同 `get_object`。
 
-**响应**：`{ deleted (bool), owner_aid, object_key }`
+**响应**：`{ deleted (bool), owner_aid, object_key }`。
 
 **权限**：仅所有者可删。
 
@@ -130,7 +143,7 @@ Storage 服务是 AUN 协议的应用层扩展，提供对象存储能力。负
 
 **权限**：仅所有者可列。
 
-### `storage.get_quota`
+### `storage.get_quota`
 
 查询存储配额使用情况。
 
@@ -142,30 +155,7 @@ Storage 服务是 AUN 协议的应用层扩展，提供对象存储能力。负
 
 **响应**：`{ owner_aid, used_bytes, object_count, quota_bytes }`
 
-**权限**：仅所有者可查。
-
-### `storage.relation_backup_provision`
-
-由 Auth 服务在 external owner relation 激活或重建时内部调用，普通客户端不得调用。请求必须带 `_caller_id="auth"`，参数如下：
-
-| 参数 | 类型 | 必需 | 说明 |
-|------|------|:----:|------|
-| `owner_aid` | string | 是 | 外部 owner AID |
-| `subject_aid` | string | 是 | 被管理的 subject AID；与 owner 不同 |
-| `proof_id` | string | 是 | 当前 active ownership proof |
-| `relation_version` | integer | 是 | 当前关系版本，>=1 |
-
-服务端在 owner 的 `default` bucket 创建或复用固定命名空间 `.aun/subjects/<lowercase_subject_aid>`，并写入 subject 的 `rw` ACL。成功响应包含 `schema=aun.relation-backup-namespace.v1`、`owner_aid`、`subject_aid`、`proof_id`、`relation_version`、`bucket=default`、`path`、`acl_source=ownership_relation`、`acl_generation`、`status=ready`、`on_revoke=retain_data_revoke_acl` 和 `data_retained=true`。首次 provision 的 `acl_generation` 为 1；同一 proof/version 重复调用幂等。
-
-### `storage.relation_backup_revoke`
-
-由 Auth 服务内部调用，参数为 `owner_aid`、`subject_aid` 和可选 `expected_relation_version`。服务端只移除 subject 的 relation ACL，不删除命名空间或其中数据，响应 `status=retained`、`data_retained=true`，并递增 `acl_generation`。记录不存在返回 `-32008`；Auth 之外的调用返回 `-32004`。
-
-### `storage.relation_backup_status`
-
-查询关系备份命名空间元数据，不返回目录内容。请求参数：`subject_aid` 必填，`owner_aid` 可选。调用者必须是 owner 或 subject；其它调用返回 `-32004`。未创建记录返回 `status=pending`、`acl_generation=0`、`data_retained=false`；已撤销记录返回 `status=retained`，数据仍保留。
-
-关系备份目录的权限约束：subject 仅在关系 `ready` 时访问自己的 `.aun/subjects/<subject>/` 后代，不能枚举 `.aun/subjects/` 根或其它 subject 目录，不能删除自己的 subject 根目录，也不能修改 ACL、visibility、token、share 或 mount。owner 可读写目录数据，但不能通过普通 Storage RPC 修改关系 ACL。
+**权限**：仅所有者可查。
 
 ---
 
@@ -214,7 +204,8 @@ Storage 服务是 AUN 协议的应用层扩展，提供对象存储能力。负
 | `size_bytes` | integer | ❌ | 期望大小，服务端校验 |
 | `expire_in_seconds` | integer | ❌ | 过期时间，默认永不过期 |
 | `metadata` | object | ❌ | 用户自定义元数据 |
-| `expected_version` | integer | ❌ | CAS 并发控制 |
+| `expected_version` | integer | ❌ | CAS 并发控制 |
+| `session_id` | string | ❌ | 规范 agent.md/owner.md 新上传必须沿用 create_upload_session 返回的同一会话 |
 
 **响应**：`{ owner_aid, bucket, object_key, size_bytes, content_type, sha256, version, etag, updated_at }`
 

package/_packed_docs/protocol/Ownership/345/215/217/350/256/256/345/256/232/344/271/211.md

@@ -0,0 +1,443 @@
+# Ownership 协议定义
+
+本文定义当前四端 SDK 使用的 ownership wire 协议、`agent.md` ownership 字段、identity escrow 封套、owner 代上传授权和现有 RPC 边界。协议版本以当前实现中的 `aun.ownership.v1` 为准；`v1` 是消息类型版本，关系声明本身使用 `version: 2`。
+
+这里的声明 `version: 2` 不等于 [Ownership协议定义2.0](Ownership协议定义2.0.md)。工作区的 [agent.md SCHEMA](../agent.md/SCHEMA.md) 已采用该另一套文档声明契约；本文件中的 `ownership_proof`、托管、代上传与 release 以当前四 SDK 和 Name Service 代码为准。
+
+ownership 是 `subject_aid` 与 `owner_aid` 之间的双方签名关系。关系编排由 SDK 完成，服务端不建立 ownership 专用状态机。消息、Storage、Name Service、Auth/CA 仍使用各自已有接口。
+
+## 1. 标识与不变量
+
+| 名称 | 定义 |
+| --- | --- |
+| `subject_aid` | 被管理的 AID；其 `agent.md` 由 subject 签名，完整关系下可由 owner 代上传 |
+| `owner_aid` | 管理 subject 的 AID |
+| `proof_id` | 小写 UUID v4；同一关系的双方声明、`agent.md` proof 和控制消息必须一致 |
+| `request_id` | 一次绑定或释放编排的消息关联 ID；非空，释放请求使用独立 ID |
+| `subject_type` / `type` | subject 的应用类型，默认 `agent`；SDK 不解释 `extensions` 中的业务字段 |
+| `extensions` | 每个签署者自己的声明扩展；双方不要求内容相同 |
+
+所有 AID 在 wire 上使用小写规范形式。控制消息必须由 SDK 通过加密 P2P 发送；应用层接收到的是 SDK 产生的 `ownership.request`，不直接处理控制 payload。
+
+## 2. Ownership P2P 消息 schema
+
+### 2.1 公共 payload
+
+每个控制消息作为 `message.send.params.payload` 传送：
+
+```json
+{
+  "type": "aun.ownership.v1",
+  "action": "bind.request",
+  "request_id": "request-20261009-001",
+  "proof_id": "550e8400-e29b-41d4-a716-446655440000",
+  "subject_aid": "subject.agentid.pub",
+  "owner_aid": "owner.agentid.pub"
+}
+```
+
+公共字段：
+
+| 字段 | 类型 | 必填 | 约束 |
+| --- | --- | --- | --- |
+| `type` | string | 是 | 固定为 `aun.ownership.v1` |
+| `action` | string | 是 | `bind.request`、`bind.response`、`bind.reject`、`escrow.ready`、`agent_md.updated` 或 `release.request` |
+| `request_id` | string | 是 | 去除首尾空白后非空；绑定后续消息必须匹配本地关系记录 |
+| `proof_id` | string | 是 | 小写 UUID v4 |
+| `subject_aid` | string | 是 | 小写、有效 AID |
+| `owner_aid` | string | 是 | 小写、有效 AID |
+| `subject_type` | string | 条件 | 绑定申请和响应中保存的 subject 类型 |
+
+`message.send` 的发送方必须是关系中的一方，接收 SDK 根据已确认的消息 sender 与 payload 中的 AID 交叉校验。未知 action、缺少公共字段、sender 不匹配或校验失败的 payload 仍由 SDK 消费，不作为普通应用消息投递。
+
+### 2.2 action 字段
+
+| action | 方向 | 附加必填字段 | 处理结果 |
+| --- | --- | --- | --- |
+| `bind.request` | 发起方 → 对端 | `statement`、`signature` | 接收方保存单方声明并发布本地 `ownership.request` |
+| `bind.response` | 审批方 → 发起方 | `statement`、`signature` | 合并对端声明；双方签名齐全后本地状态为 `active` |
+| `bind.reject` | 审批方 → 发起方 | 无 | 关系记录为 `rejected`，不启动 escrow 或代上传 |
+| `escrow.ready` | subject → owner | `escrow_path`、`escrow_download_url`、`escrow_password`、`escrow_sha256` | owner 下载并导入 subject identity，随后代上传 `agent.md` |
+| `agent_md.updated` | owner → subject | 无 | subject 下载、验签并同步 owner 已上传的 `agent.md` |
+| `release.request` | 原 owner → subject | `ownership_release` | subject 验证原关系后进入 rekey 和无 owner 名片上传 |
+
+绑定请求和响应中的 `statement`/`signature` 是当前消息发送者自己的声明。`bind.reject` 不携带新的签名声明，但必须匹配待审批的 `request_id`、`proof_id` 和双方 AID。`escrow.ready` 中的密码只在加密 P2P 中传送，不能写入公开日志或公开状态。
+
+双方签名完成即成立关系。subject 立即自行发布包含完整 proof 的 `agent.md`，随后独立尝试 identity 托管；发布或托管失败均不撤销关系，发布失败不阻止托管。owner 代上传须等 subject identity 已导入其持久化身份存储。
+
+### 2.3 示例 payload
+
+绑定申请和响应使用同一结构，只有签署角色和声明内容不同：
+
+```json
+{
+  "type": "aun.ownership.v1",
+  "action": "bind.request",
+  "request_id": "request-20261009-001",
+  "proof_id": "550e8400-e29b-41d4-a716-446655440000",
+  "subject_aid": "subject.agentid.pub",
+  "owner_aid": "owner.agentid.pub",
+  "subject_type": "agent",
+  "statement": {
+    "version": 2,
+    "proof_id": "550e8400-e29b-41d4-a716-446655440000",
+    "subject_aid": "subject.agentid.pub",
+    "owner_aid": "owner.agentid.pub",
+    "signer_aid": "owner.agentid.pub",
+    "role": "owner",
+    "signed_at": 1791523200,
+    "extensions": {"department": "clinic"}
+  },
+  "signature": {
+    "cert_fingerprint": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "signature": "BASE64_DER_ECDSA_SIGNATURE",
+    "signer_aid": "owner.agentid.pub",
+    "role": "owner",
+    "statement": {
+      "version": 2,
+      "proof_id": "550e8400-e29b-41d4-a716-446655440000",
+      "subject_aid": "subject.agentid.pub",
+      "owner_aid": "owner.agentid.pub",
+      "signer_aid": "owner.agentid.pub",
+      "role": "owner",
+      "signed_at": 1791523200,
+      "extensions": {"department": "clinic"}
+    }
+  }
+}
+```
+
+```json
+{
+  "type": "aun.ownership.v1",
+  "action": "escrow.ready",
+  "request_id": "request-20261009-001",
+  "proof_id": "550e8400-e29b-41d4-a716-446655440000",
+  "subject_aid": "subject.agentid.pub",
+  "owner_aid": "owner.agentid.pub",
+  "subject_type": "agent",
+  "escrow_path": "/.aun/ownership/subject.agentid.pub/550e8400-e29b-41d4-a716-446655440000.json",
+  "escrow_download_url": "https://storage.agentid.pub/download/opaque-ticket",
+  "escrow_password": "BASE64URL_RANDOM_PASSWORD",
+  "escrow_sha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+}
+```
+
+```json
+{
+  "type": "aun.ownership.v1",
+  "action": "release.request",
+  "request_id": "release-20261009-001",
+  "proof_id": "550e8400-e29b-41d4-a716-446655440000",
+  "subject_aid": "subject.agentid.pub",
+  "owner_aid": "owner.agentid.pub",
+  "ownership_release": {
+    "cert_fingerprint": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "signature": "BASE64_DER_ECDSA_RELEASE_SIGNATURE",
+    "signer_aid": "owner.agentid.pub",
+    "role": "owner",
+    "statement": {
+      "version": 1,
+      "action": "release",
+      "proof_id": "550e8400-e29b-41d4-a716-446655440000",
+      "subject_aid": "subject.agentid.pub",
+      "owner_aid": "owner.agentid.pub",
+      "signer_aid": "owner.agentid.pub",
+      "role": "owner",
+      "signed_at": 1791523260
+    }
+  }
+}
+```
+
+## 3. Ownership proof 与签名封套
+
+### 3.1 v2 声明
+
+关系声明的 wire schema 为：
+
+```json
+{
+  "version": 2,
+  "proof_id": "uuid-v4-lowercase",
+  "subject_aid": "subject.agentid.pub",
+  "owner_aid": "owner.agentid.pub",
+  "signer_aid": "owner.agentid.pub",
+  "role": "owner",
+  "signed_at": 1791523200,
+  "extensions": {"application": "clinic-app"}
+}
+```
+
+| 字段 | 类型 | 约束 |
+| --- | --- | --- |
+| `version` | integer | 固定为 `2` |
+| `proof_id` | string | 小写 UUID v4 |
+| `subject_aid`、`owner_aid` | string | 有效的小写 AID |
+| `signer_aid` | string | `role=subject` 时等于 `subject_aid`；`role=owner` 时等于 `owner_aid` |
+| `role` | string | 只能是 `subject` 或 `owner` |
+| `signed_at` | integer | Unix 秒，正整数；签署时必须落在证书有效期内 |
+| `extensions` | object | 可选；必须是对象，按原样进入该签署者的声明 |
+
+每个签署者独立生成声明。双方必须共享 `proof_id`、`subject_aid` 和 `owner_aid`，但 `signed_at` 和 `extensions` 可以不同。
+
+### 3.2 签名封套
+
+```json
+{
+  "cert_fingerprint": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+  "signature": "BASE64_STRICT_DER_ECDSA_SIGNATURE",
+  "signer_aid": "owner.agentid.pub",
+  "role": "owner",
+  "statement": {"version": 2, "proof_id": "...", "subject_aid": "...", "owner_aid": "...", "signer_aid": "...", "role": "owner", "signed_at": 1791523200}
+}
+```
+
+`cert_fingerprint` 必须匹配 `sha256:<64 个十六进制字符>`；`signature` 是 ECDSA P-256/SHA-256 DER 签名的严格 Base64。封套中的 `signer_aid`、`role` 和嵌套 `statement` 若存在，必须与外部声明一致；实现应保存实际签署的 statement，不能根据当前时间或默认扩展重新构造历史签名。
+
+签名字节严格定义为：
+
+```text
+UTF-8("AUN-AID-OWNER-RELATION-V1;") || canonical_json(statement)
+```
+
+`canonical_json` 使用 UTF-8、递归字典序键、无空格和稳定数字/转义编码。前缀末尾的可见分号是签名域的一部分。验证时按 AID 和指纹解析证书，检查证书 CN、指纹、角色和签署时间，再验证签名；下载历史名片不要求签名证书当前仍是 `active_signing`，上传时则要求相关证书当前为 `active_signing`。
+
+### 3.3 `ownership_proof` 对象
+
+```yaml
+ownership_proof:
+  proof_id: 550e8400-e29b-41d4-a716-446655440000
+  subject_aid: subject.agentid.pub
+  owner_aid: owner.agentid.pub
+  subject_signature: <signature envelope for role=subject>
+  owner_signature: <signature envelope for role=owner>
+```
+
+外部 owner 关系必须有 `subject_signature` 和 `owner_signature`。self-owner（`subject_aid == owner_aid`）只保留 `subject_signature`，必须省略 `owner_signature`。仅有 `subject_aid`/`owner_aid` 的不完整 proof 可由 subject 自行上传，但不能授权 owner 代上传。
+
+### 3.4 释放声明
+
+释放声明使用独立签名域：
+
+```text
+UTF-8("AUN-AID-OWNER-RELEASE-V1;") || canonical_json(statement)
+```
+
+其 statement 只允许以下字段：`version: 1`、`action: "release"`、`proof_id`、`subject_aid`、`owner_aid`、`signer_aid`、`role: "owner"`、正整数 `signed_at`。释放封套沿用 `cert_fingerprint`、`signature`、`signer_aid`、`role`、`statement` 字段。Name Service 将 release 的三元组与已保存的 ownership 关系匹配，匹配后才接受清除 owner 的名片。
+
+## 4. agent.md ownership 字段与状态
+
+### 4.1 frontmatter 约束
+
+其它基础字段（`aid`、`name`、`type`、`version`、正文和尾部 AUN 签名）遵循 [agent.md Schema](../agent.md/SCHEMA.md)。ownership 只增加以下字段：
+
+```yaml
+aid: subject.agentid.pub
+name: Subject
+type: agent
+version: 1.0.0
+owner: owner.agentid.pub
+ownership_proof:
+  proof_id: 550e8400-e29b-41d4-a716-446655440000
+  subject_aid: subject.agentid.pub
+  owner_aid: owner.agentid.pub
+  subject_signature: {...}
+  owner_signature: {...}
+```
+
+校验规则：
+
+1. `owner` 与 `ownership_proof.owner_aid` 必须是同一个小写 AID；`ownership_proof.subject_aid` 必须等于 frontmatter 的 `aid`。
+2. `ownership_proof` 出现时必须同时有 `owner`；`human` 类型不能携带 `owner` 或 proof。
+3. self-owner 不能出现 `owner_signature`。
+4. `ownership_release` 出现时必须同时省略 `owner` 和 `ownership_proof`；`human` 不能携带 release。
+5. proof 中已出现的每个签名都必须结构合法并能独立验签；缺少 owner 签名只表示 `incomplete`，不表示 owner 已授权。
+
+### 4.2 文件级 ownership 状态
+
+SDK 分别返回文件签名状态和 ownership 状态。ownership 状态定义如下：
+
+| 状态 | 条件 |
+| --- | --- |
+| `unbound` | 没有 `owner`、proof 或 release |
+| `incomplete` | 有 owner 或单方 proof，但外部关系尚未形成完整双方签名 |
+| `complete` | 外部关系双方签名均有效，或 self-owner 的 subject 单签有效 |
+| `released` | 有效 `ownership_release`，且 owner/proof 已移除 |
+| `invalid` | 字段、关系、证书、签名或时间校验失败 |
+
+subject 自行上传不完整 proof 是允许的；owner 代上传和完整关系发布必须达到 `complete`。文件尾部主体签名始终由 subject 签署，owner 代上传只改变 HTTP 上传授权者。
+
+## 5. Identity escrow 封套
+
+### 5.1 对象与明文包
+
+subject 将 identity 包序列化为 UTF-8 JSON 后加密。当前实现要求至少包含：
+
+```json
+{
+  "aid": "subject.agentid.pub",
+  "private_key_pem": "-----BEGIN PRIVATE KEY-----...",
+  "public_key_der_b64": "BASE64_DER_PUBLIC_KEY",
+  "curve": "P-256",
+  "cert": "-----BEGIN CERTIFICATE-----..."
+}
+```
+
+明文包包含私钥，只能经加密 P2P 交给 owner；owner 导入既有 AIDStore/IndexedDB identity store 后才用于 subject 签名。运行时缓存字段不作为公开 ownership 状态返回。
+
+### 5.2 加密封套 schema
+
+```json
+{
+  "version": 1,
+  "alg": "AES-256-GCM",
+  "kdf": "PBKDF2-SHA256",
+  "iterations": 200000,
+  "salt": "BASE64_16_BYTES",
+  "nonce": "BASE64_12_BYTES",
+  "ciphertext": "BASE64_CIPHERTEXT_AND_16_BYTE_TAG",
+  "sha256": "LOWERCASE_SHA256_OF_PLAINTEXT"
+}
+```
+
+固定参数为 AES-256-GCM、PBKDF2-SHA256 200000 次、16 字节 salt、12 字节 nonce、AAD `AUN-CERT-ESCROW-V1`。`ciphertext` 包含 GCM 认证 tag；`sha256` 校验解密后的明文。四端必须按相同字节规则序列化和解密，密码不写入 Storage 对象。
+
+对象路径固定为：
+
+```text
+/.aun/ownership/<lowercase_subject_aid>/<proof_id>.json
+```
+
+subject 在自己的 `default` bucket 写入对象，只向 `owner_aid` 授予该对象 `r` ACL，然后为 `viewer_aid=owner_aid` 申请下载票据。`escrow.ready` 传递路径、票据 URL、密码和明文摘要。
+
+票据地址沿用 Storage 约定，按 `logical_url`、`download_url`、`url` 顺序选择。owner 解密并校验 identity 后须导入已有身份存储并持久化：文件型 SDK 使用 `{aunPath}/AIDs/{subjectAid}/private/key.json` 与 `public/cert.pem`，浏览器 SDK 使用 IndexedDB `aun-keystore` 的 `key_pairs`、`certs`。私钥沿用身份存储的本地 seed 加密，重启后可重新加载；关系 metadata 不保存明文私钥。
+
+## 6. Owner 代上传授权
+
+owner 使用 subject identity 签署完整 `agent.md`，再使用 owner identity 生成 HTTP 头：
+
+```text
+X-AUN-AgentMD-Owner-Authorization: <base64url(JSON)>
+```
+
+解码后的 JSON schema：
+
+```json
+{
+  "version": 1,
+  "target_aid": "subject.agentid.pub",
+  "uploader_aid": "owner.agentid.pub",
+  "body_sha256": "LOWERCASE_SHA256_OF_HTTP_BODY",
+  "timestamp": 1791523200,
+  "nonce": "32_HEX_CHARS",
+  "cert_fingerprint": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "signature": "BASE64_STRICT_DER_ECDSA_SIGNATURE"
+}
+```
+
+签名输入为：
+
+```text
+AUN-AGENT-MD-UPLOAD-V1;<uploader_aid>;<target_aid>;<body_sha256>;<timestamp>;<nonce>
+```
+
+字段和服务端校验要求：
+
+- `target_aid` 必须等于请求 Host 对应的 subject AID；`uploader_aid` 必须等于 `agent.md.owner`。
+- `body_sha256` 必须等于 HTTP 正文的 SHA-256；`timestamp` 与服务端时间偏差不能超过 300 秒。
+- `nonce` 非空且长度不超过 128；当前 Name Service 不持久化 nonce，不能把 nonce 单独当作长期重放台账。
+- owner 证书指纹、CN、AID、公钥和签名必须匹配，证书当前必须是 `active_signing`，签名算法为 ECDSA P-256/SHA-256。
+- 代上传不能携带 owner bearer token 代替该授权头；subject 自行上传时使用现有 Bearer token，上传者 AID 必须等于 subject。
+
+## 7. 现有 RPC 与 HTTP 接口边界
+
+ownership 不新增 RPC。SDK 只组合已有能力：
+
+### 7.1 `message.send`
+
+```json
+{
+  "to": "peer.agentid.pub",
+  "encrypt": true,
+  "payload": {
+    "type": "aun.ownership.v1",
+    "action": "bind.request",
+    "request_id": "...",
+    "proof_id": "...",
+    "subject_aid": "...",
+    "owner_aid": "..."
+  }
+}
+```
+
+`to` 是对端 AID，`encrypt` 必须为 `true`。ownership 控制消息沿用持久 P2P 消息默认语义，不使用 volatile TTL。Message/Gateway 只转发加密 envelope，不解析 action 或 proof 业务字段。
+
+### 7.2 Storage RPC
+
+| 现有接口 | ownership 用途 | 关键参数边界 |
+| --- | --- | --- |
+| `storage.put_object`（或 SDK VFS `writeBytes`） | 写入 escrow JSON | subject 所有者、`default` bucket、固定 escrow 路径、`application/json` |
+| `storage.set_acl` | 授予 owner 读取 escrow 对象 | `grantee_aid=owner_aid`、`perms=r`；只作用于该 escrow 对象 |
+| `storage.create_download_ticket` | 生成 owner 下载票据 | `owner_aid=subject_aid`、`bucket=default`、对象 key 去掉开头 `/`、`viewer_aid=owner_aid` |
+| Storage 数据面 GET | 下载封套 | 跨 issuer 使用资源域票据；同 issuer 可使用当前 access token getter |
+
+SDK 不因 ownership 自动为其它业务目录建立 ACL、备份或清理策略。Storage 的通用 RPC 参数和错误语义见 [Storage RPC 手册](../sdk/09-storage-rpc-manual.md)。
+
+### 7.3 Name Service HTTP
+
+| 方法 | 用途 | ownership 相关校验 |
+| --- | --- | --- |
+| `PUT /agent.md` | subject 自签上传或 owner 代上传 | 校验 frontmatter、主体尾部签名、ownership proof、上传者和 owner 授权；成功返回 ETag |
+| `GET /agent.md`、`HEAD /agent.md` | 下载或查询版本 | 返回正文、ETag、`Last-Modified`；SDK 下载后分别验证文件签名和 ownership |
+
+服务端拒绝普通上传清除或替换已保存 owner；必须由原 owner 的有效 release 声明触发无 owner 文档上传。Name Service 不保存 SDK 的 `pending`/`active`/`released` 本地状态机。
+
+### 7.4 Auth/CA 与 SDK 本地接口
+
+Auth/CA 仅提供已有 token、证书解析、证书生命周期和 AID 校验能力，不提供 `ownership.bind`、`ownership.release` 等专用 RPC。SDK 本地使用已有 `AIDStore`/`AID`/`rekey`/identity 导入和 metadata 存储；这些是实现接口，不是跨模块 wire RPC。
+
+## 8. SDK 事件与本地状态
+
+有效 `bind.request` 被 SDK 拦截后发布：
+
+```json
+{
+  "event": "ownership.request",
+  "request_id": "...",
+  "proof_id": "...",
+  "subject_aid": "subject.agentid.pub",
+  "owner_aid": "owner.agentid.pub",
+  "subject_type": "agent",
+  "requester_aid": "owner.agentid.pub",
+  "requester_role": "owner",
+  "statement": {"version": 2, "...": "..."},
+  "signature": {"cert_fingerprint": "...", "signature": "..."}
+}
+```
+
+应用只能通过 `acceptOwnershipRequest(request_id, { extensions })` 或 `rejectOwnershipRequest(request_id)` 作出决定。SDK 本地关系记录至少关联 `subject_aid`、`owner_aid`、`proof_id`、`request_id`、双方原始声明/签名、`status` 和待发送消息；`subject_identity`、`escrow_password`、`escrow_download_url` 不得出现在公开状态摘要。
+
+绑定与释放的关键本地状态为：
+
+```text
+pending → active → release_pending → released
+pending → rejected
+release_pending → pending_rekey → pending_agent_md → pending_upload → released
+```
+
+`active` 只表示本地保存了完整关系 proof，不表示 escrow 或 owner 代上传已经成功。待发送消息、待审批事件、待上传正文和 rekey 阶段必须可持久化并在重连/重启后恢复。
+
+## 9. 校验与兼容要求
+
+接收 SDK 按以下顺序处理：
+
+1. 解密并解析消息，确认 `type`、action、sender、双方 AID、`request_id` 和 `proof_id`。
+2. 对 `bind.request`/`bind.response` 验证对端证书、statement 角色和签名；对后续消息匹配同一关系记录。
+3. 对 `escrow.ready` 校验 sender 是 subject、关系为 active，再下载、解密、校验明文摘要和 identity AID。
+4. 对 `release.request` 校验 sender 是原 owner，并验证完整旧 proof 或本地 active 记录；失败消息不投递应用层。
+5. 对 `agent.md` 下载分别返回文件签名状态和 ownership 状态；不得用文件签名成功替代关系 proof 验证。
+
+self-owner 不发送 bind P2P、没有 escrow 和外部审批。subject 不能单方发起 release。owner 代上传不新增 Name Service 或 Auth RPC；任何实现若修改 action 名、公共字段、签名域、escrow 参数或 HTTP 头，必须先更新协议并同步四端。
+
+参考实现：[TypeScript proof](../../ts/src/ownership-proof.ts)、[TypeScript client](../../ts/src/client.ts)、[Python protocol](../../python/src/aun_core/ownership_protocol.py)、[Go protocol](../../go/ownership_protocol.go)、[agent.md Schema](../agent.md/SCHEMA.md)、[Name Service agent.md handler](../../../extensions/services/nameservice/go/internal/httpserver/agentmd.go)。