@agentunion/fastaun 0.5.33 → 0.5.35

package/_packed_docs/sdk/Ownership2.1-SDK/345/272/224/347/224/250/351/233/206/346/210/220/346/214/207/345/215/227.md

@@ -8,13 +8,13 @@
 
 | 角色／材料 | 职责 |
 | --- | --- |
-| sub | 被管理身份；自己签署并以本人身份向 NS 提交 `agent.md`。 |
+| sub | 普通被管理身份自己签署并以本人身份向 NS 提交 `agent.md`；现代 Group/Org 由实体主签、当前 owner token 上传。 |
 | owner／新 owner | 自己签署并向本人 Storage 发布 `sub_aids/{sub_aid}/owner.md`。 |
 | NS | 根据这两份当前权威文件验收并锁定关系；Storage 中的 sub 名片副本不参与验收。 |
 
-owner 权限不包含 sub 私钥或代签、代上传能力。普通名片更新保留全部关系字段及原 CAS；关系无效或暂不可确认只影响依赖 owner 的授权，不阻断普通名片和通信。
+普通主体的 owner 权限不包含 sub 私钥或代签、代上传能力。普通名片更新保留全部关系字段及原 CAS；关系无效或暂不可确认只影响依赖 owner 的授权，不阻断普通名片和通信。
 
-本流程用于普通主体；human 可作为 owner，不能作为声明 owner 的 sub。Group/Org 自身使用专属创建、解散和强制 rekey 转让流程：关系操作抛出 `not_applicable`，共识方法返回同名状态。它们仍可按普通 owner 规则管理其他 sub。
+本流程用于普通主体；human 可作为 owner，不能作为声明 owner 的 sub。现代 Group/Org 支持配对的 owner.md／agent.md 声明与通用共识；创建、绑定、解散和强制 rekey 转让仍由专属生命周期驱动，普通 bind/release/transfer 关系管理 Facade 对其返回 `not_applicable`。缺少 ownership 的历史实体名片保留读取兼容，NS 保留 `not_applicable` 标记，SDK 以实际返回 status 为准，不将 owner-only 视为共识。作为 owner 仍须遵守各入口的类型限制，local 编排的 owner 仅接受 human/agent。
 
 SDK 不维护 Ownership 任务状态机、WAL 或后台恢复，不提交独立 decisions 回执。NS 以归属事实判断冲突；锁定后，新的 accept/reject 不能改变关系，须走释放或转移。
 
@@ -319,7 +319,7 @@ if (current.status === 'consensus' && current.owner_aid === 'owner.agentid.pub')
 | `invalid` | 材料确定无效，不能授权。 |
 | `unavailable` | 当前事实不可确认，保留保护并等待。 |
 
-Group/Org 的 `not_applicable` 不属于六态。先判断 status，不能把占位版本 0／unlocked 当成无锁证据。无目标上下文的查询也不能枚举独立 owner 邀请。
+NS 对缺少 ownership 的历史 Group/Org 保留 `not_applicable` 标记，该状态不属于六态；现代实体声明参与双文件共识，SDK 以实际返回 status 为准。先判断 status，不能把占位版本 0／unlocked 当成无锁证据。无目标上下文的查询也不能枚举独立 owner 邀请。
 
 普通下载的 `verification.ownership_status` 是 legacy 展示字段。普通 peer 名片展示可按 ETag 复用 Ownership 快照，不必轮询重检；`owner.md` 可独立变化，实际管理操作仍由 SDK／服务端回源核验当前归属、权限和文件 CAS。清理后可再次出现版本 1，版本号不是全局关系标识。
 
@@ -360,4 +360,4 @@ SDK 不保存未完成操作，不在 `connect()` 后扫描任务或补发通知
 
 完整的新语义应配套发布 NS 与四 SDK。已有 2.1 NS 的普通绑定、本地绑定及目标 owner 文件先提交的本地转移，正常路径仍可能可用；sub 先同意的转移、Stage 与 owner 文件交错及相同归属重新签发，需要本轮 NS 修复。新 SDK 不调用 decisions，旧服务保留该接口不影响它；过渡版 SDK 若强依赖已移除接口，则需升级。Rust SDK 未随本轮改造，不能套用本文“无任务、无 WAL”的实现结论。
 
-Group/Org 名片由实体主签、当前 owner token 上传；失败稿保留完整多签原文、固定 owner／证书代际及原 CAS，应用显式重试，重连不自动 PUT。格式见 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传)。
+现代 Group/Org 名片由实体主签、当前 owner token 上传，主签不含 signer_aid，也不要求旧 entity_cert_fingerprint；SDK 生命周期流程先写配对 owner.md，再发布实体声明并确认共识。失败稿保留完整多签原文、固定 owner／证书代际及原 CAS，应用显式重试；当前 owner 具备本地实体密钥或可恢复的群绑定材料时，每连接首次访问对应实体检查并按需补齐共识，不在重连时遍历全部实体 PUT。格式见 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传)。

package/_packed_docs/sdk/Ownership2.1-SDK/345/274/200/345/217/221/344/270/216/347/247/273/346/244/215/346/214/207/345/215/227.md

@@ -4,13 +4,13 @@
 
 ## 1. 实现边界与角色
 
-关系事实来自 sub 在 NS 的 `agent.md` 和 owner 在本人 Storage 的 `owner.md`，由 NS 验收并锁定。sub 自签自传，owner 自签自传；owner 登录态不能代上传普通 sub 名片。SDK 不维护 Ownership 持久任务、WAL、审批账本或后台恢复，也不调用 decisions 接口。
+关系事实来自 sub 在 NS 的 `agent.md` 和 owner 在本人 Storage 的 `owner.md`，由 NS 验收并锁定。普通 sub 自签自传，owner 自签自传；owner 登录态不能代上传普通 sub 名片，现代 Group/Org 例外边界见下文。SDK 不维护 Ownership 持久任务、WAL、审批账本或后台恢复，也不调用 decisions 接口。
 
 未锁定时，以最后成功上传的 sub 声明为准；NS 比较 owner、sub、关系版本和有效授权等归属事实，不以消息 ID、声明 UUID 或时间判断归属冲突。拒绝只通知对方，不删除或回滚候选。锁定后新的 accept/reject 不能改变归属，必须走释放或转移；锁定前不保证多设备决定只能作出一次。
 
 普通名片解析、外层验签与关系验证分层。正文更新保留全部关系材料的存在性、类型和值及原 CAS，不以前置共识或 owner Storage 可用为条件；关系字段变更仍执行双文件授权。
 
-Group/Org 作为 sub 使用专属生命周期：通用关系编排抛出 `not_applicable`，共识返回同名结果；它们仍可按普通 owner 规则作为 owner。现代实体名片由实体主签、当前 owner token 上传，可选 owner 附签且全部验证，详见协议 §2.5。
+现代 Group/Org 作为 sub 同样支持配对 owner.md／agent.md 声明与通用共识；创建、绑定、转让和解散仍由专属生命周期驱动，普通 bind/release/transfer 关系编排抛出 `not_applicable`。NS 仅对缺少 ownership 的历史实体保留该标记，SDK 以实际返回 status 为准，不将 owner-only 视为共识。作为 owner 仍须遵守各入口的类型限制，local 编排的 owner 仅接受 human/agent。SDK 先写 owner.md，再以实体私钥主签、当前 owner token 发布 agent.md 并确认共识；不再要求旧 entity_cert_fingerprint 或主签 signer_aid，可选 owner 附签且全部验证，详见协议 §2.5。
 
 ## 2. 分层与最小依赖接口
 
@@ -57,7 +57,7 @@ YAML frontmatter＋可选 Markdown＋连续尾签块。首签前 payload 最多
 
 | 文件 | Schema 和身份 |
 | --- | --- |
-| `agent.md` | 基础字段 `aid/name/type/version`；owner 与 ownership 同时出现／省略，含完整 statement；主签者和认证上传者均为 sub。human 不得声明 owner。 |
+| `agent.md` | 基础字段 `aid/name/type/version`；owner 与 ownership 同时出现／省略，含完整 statement；普通主体由 sub 主签并本人上传，现代 Group/Org 由实体主签、当前 owner token 上传。human 不得声明 owner；历史实体格式另按兼容规则读取。 |
 | `owner.md` | 顶层恰为 `owner_aid/sub_aid/ownership`；路径 `owner_aid:/sub_aids/{sub_aid}/owner.md`；ownership 含 statement/action，仅 transfer_owner 另含 transfer。 |
 
 statement 恰含 `version/declaration_id/owner_aid/sub_aid/relation_version/declared_at`。action 为 `declare/release/transfer_owner`；transfer 恰含 `new_owner_aid/target_relation_version/expires_at`，绑定 `v+1`。文件角色取自资源上下文，不取自签名 TAG；不为 owner.md 伪造名片字段。
@@ -78,7 +78,7 @@ ECDSA P-256/SHA-256；签名为严格标准 Base64 的 ASN.1 DER，不能直接
 | 全文 SHA-256 | 包含全部签块的完整性与提交确认。 |
 | NS 原 ETag | 原样用于 If-Match，不能用本地摘要替代。 |
 
-agent／owner 默认 TAG 为 `AGENTMD-V2/OWNERSHIP-V2`，兼容标签以协议为准。普通两类文件主块禁止 signer_aid；附签必填，实体主块显式为实体 AID。已有附签全部验，数学失败不能降级成单签；末端删签不保证可检测。
+agent／owner 默认 TAG 为 `AGENTMD-V2/OWNERSHIP-V2`，兼容标签以协议为准。普通 agent.md、owner.md 与现代实体 agent.md 主块均禁止 signer_aid；附签必填，历史实体主块按原格式兼容验证。已有附签全部验，数学失败不能降级成单签；末端删签不保证可检测。
 
 `AIDStore.sign/verify`、agent.md 和 owner.md 复用唯一通用签验 core，业务 Schema／当前授权在外层校验。TS/JS 公共签验为 `Promise<Result>`；文件输入显式 `inputType: 'file'`，document 成功后才可原地写回。参数见 [API 手册](06-API手册.md#通用-sign--verify)。
 
@@ -376,7 +376,7 @@ await daemonClient.transferLocalSubaid(subClient, nextOwnerClient);
 
 - 普通名片失败稿留本地；显式重试先检查保存的条件，再回源。缺条件不能因远端同字节而清待办；正文更新保留完整关系材料。重连不自动 PUT 普通 pending。
 - 实体 pending 保存完整多签原文、原 CAS、固定 owner 和实体证书代际，应用显式重试；转移／rekey／解散后停止旧待办。现代上传取消额外 V2 授权，旧入口按协议 §2.5 隔离兼容；专属 create/transfer checkpoint 恢复不变。
-- fresh 实体 GET 同时发 Check、no-cache、multi-v1，验证全部签块及当前实体代际，仍为 not_applicable。独立 AIDStore 的 Python／Go 实体上传需注入权威 owner resolver，TS／JS 默认经 fresh NS／PKI 核对。
+- fresh 实体 GET 同时发 Check、no-cache、multi-v1，验证全部签块及当前实体代际；现代实体参与双文件共识，NS 对缺少 ownership 的历史实体保留 not_applicable 标记，SDK 按实际返回状态处理。独立 AIDStore 的 Python／Go 实体上传需注入权威 owner resolver，TS／JS 默认经 fresh NS／PKI 核对。
 - 普通 agent 注册 owner 可选；初始名片不写关系，有 owner 时注册当次使用专属短连接立即发起绑定并 finally close，不等后续 connect 恢复。部分 SDK 仍保留 registration_intent 元数据用于注册信息或兼容读取，不再据此恢复 Ownership 任务；注册成功不等于关系完成。
 - 支持原 2.1 的旧 NS，普通首次绑定、local bind 和新 owner 文件先齐的 local transfer 正常路径仍可用。完整支持双方任意到达顺序、转移候选隔离、Stage 交错重试及同事实重签，需要本轮 NS；旧 NS 在 sub 先接受 transfer 时可能报错，或因 owner SHA 基线导致已齐文件持续 pending、同事实重签被拒绝。
 - 新 SDK 不调用 decisions；仍依赖该接口的过渡 SDK 在接口删除后会遇到 404。旧 proof 或 metadata 不当作 unbound 或当前授权，不能借升级清空锁。不能把 Rust 的旧任务恢复或 Stage 限制当成本轮四 SDK 的行为。

package/_packed_docs/sdk/Ownership2.1/350/257/246/347/273/206/350/256/276/350/256/241.md

@@ -8,13 +8,13 @@
 
 ## 1. 设计边界
 
-通用 Ownership 2.1 排除 `group/org`：其 owner 来自专属服务的创建、解散、转移事实，不创建 owner.md、通用关系版本、锁、NS Ownership 账本或审批任务。通用 Facade 在副作用前直接返回 `not_applicable`、`retryable=false`，共识 `status/code=not_applicable`，不自动转调用其它方法。新 SDK 的实体名片分支以权威类型和生命周期为准；owner 必填、禁止通用 ownership/proof/release，实体私钥主签、owner token 上传并可选 owner 附签，上传校验实体当前证书代际及完整文件原字节；NS 旧客户端实体 token 与当前实体自签的受限旧格式入口见 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传)。
+自 SDK 0.5.31 起，现代 `group/org` 与其他非 human 主体统一使用配对的 `owner.md`／`agent.md`、`ownership.statement`、关系版本及双文件共识；生命周期 owner、active 状态和当前证书仍是实体授权约束，不另建 Ownership 事实账本。绑定、释放、转移仍由专属生命周期自动编排，普通管理 Facade 在副作用前返回 `not_applicable`、`retryable=false`，不自动转调用其它方法；该限制不适用于现代声明与共识查询。实体名片含当前 owner 及配对声明，清除旧 entity_cert_fingerprint，不带 signer_aid 的实体主签由当前 owner token 上传；owner.md 由 owner 本人签署发布。历史实体格式及旧客户端上传边界见 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传)。
 
-实体 fresh GET 同时携带 X-AUN-Ownership-Check: 1、Cache-Control: no-cache 和 X-AUN-Signature-Format: multi-v1，触发 NS 绕 LRU 全块新鲜验证，仍为 not_applicable、不进入通用账本；GET/HEAD 按 multi-v1 协商完整／首签表示，返回对应 ETag；current/stale、权威 owner/指纹与 missing/unavailable 边界遵循协议 §2.5。verified 下载全块验证历史证书及原始字节，不因当前 owner 或代际变化拒绝历史有效文件，历史成功不代表当前权限。上传仍新鲜校验当前生命周期及证书，不扩展 gateway.resolve。独立 AIDStore 的实体上传接线存在语言差异：Python／Go 须显式注入权威 entity owner resolver；TS／JS 默认通过 fresh NS 与 PKI 核对当前 owner 和实体证书指纹，不能假定四端均自动调用实体服务。
+实体 fresh GET 同时携带 X-AUN-Ownership-Check: 1、Cache-Control: no-cache 和 X-AUN-Signature-Format: multi-v1，触发 NS 绕 LRU 新鲜验证。现代声明进入通用双文件共识；仅缺少 ownership 的历史实体格式保留 not_applicable 及适用的实体响应头，不能用该兼容分支否定现代实体共识。GET/HEAD 按 multi-v1 协商完整／首签表示及对应 ETag；missing 为 404，权威依赖 unavailable 不伪装缺失。verified 下载全块验证历史证书及原始字节，历史成功不代表当前权限。Client 生命周期编排和访问补齐须另核对当前 owner、active 状态及本地实体签名材料；不能把独立 AIDStore 的注入方式等同于四端 Client 均自动调用实体服务，详见协议 §2.5。
 
-旧实体文件按历史读取规则保留；历史 relation/evidence/checkpoint 元数据不参与当前关系判定，也不是普通名片可用性的前置条件。当前实体上传按权威类型、生命周期、当前证书及新 Schema 验收。
+旧实体文件按历史读取规则保留，owner-only 不构成双文件共识，不能覆盖或降级现代关系；旧 entity_cert_fingerprint／signer_aid 按相应历史格式校验，特定旧 Group 的无指纹豁免不适用于 Org。历史 relation/evidence/checkpoint 元数据不参与当前关系判定，也不是普通名片可用性的前置条件。当前实体上传按配对声明、权威类型、生命周期、当前证书及现代 Schema 验收。
 
-Ownership 是 agent.md 之上的关系功能，不能因新增 Ownership 2.1 导致原有 agent.md 上传、下载、历史验签、展示或通信不可用。2.1 关系事实只由数据库中持久化的 sub_aid `agent.md` 与 owner_aid 自有 Storage 规范路径中的 `owner.md` 共同确认；数据库事务和 CAS 只负责完整 `agent.md` 的原子更新，不引入独立的第二份 2.1 关系事实。旧 SDK owner RPC 的 Auth JSONL 与 NS `ownership_proof` 是隔离的 legacy 兼容状态，不写 2.1 双文件，不构成 2.1 授权、lock/version/consensus，也不得覆盖已存现代声明。若数据库保留 owner_aid、关系版本或锁等索引列，它们只能服务于 `agent.md` 的 CAS 和查询，不能脱离两份文件单独判定 2.1 关系。只有需要当前 owner 关系的共识、授权和关系操作才执行 2.1 新鲜检查；关系缺失、legacy、stale 或关系依赖 unavailable 时，仅这些功能降级或拒绝授权，不能把普通读取兼容当作 current／consensus，也不能清空既有保护。
+Ownership 是 agent.md 之上的关系功能，不能因新增 Ownership 2.1 导致原有 agent.md 上传、下载、历史验签、展示或通信不可用。2.1 关系声明由数据库中持久化的 sub_aid `agent.md` 与 owner_aid 自有 Storage 规范路径中的 `owner.md` 共同确认，Group/Org 授权还须核对当前生命周期及实体证书；数据库事务和 CAS 只负责完整 `agent.md` 的原子更新，不引入独立的第二份 2.1 关系事实。旧 SDK owner RPC 的 Auth JSONL 与 NS `ownership_proof` 是隔离的 legacy 兼容状态，不写 2.1 双文件，不构成 2.1 授权、lock/version/consensus，也不得覆盖已存现代声明。若数据库保留 owner_aid、关系版本或锁等索引列，它们只能服务于 `agent.md` 的 CAS 和查询，不能脱离两份文件单独判定 2.1 关系。只有需要当前 owner 关系的共识、授权和关系操作才执行 2.1 新鲜检查；关系缺失、legacy、stale 或关系依赖 unavailable 时，仅这些功能降级或拒绝授权，不能把普通读取兼容当作 current／consensus，也不能清空既有保护。
 
 后续审查和验收必须同时覆盖下面的兼容矩阵；四 SDK 与 NS 按同一边界检查，不能只验收新增关系流程：
 
@@ -105,7 +105,7 @@ NS 下列路径以 [Go 服务根目录](../../../extensions/services/nameservice
 | --- | --- | --- |
 | `internal/httpserver/agentmd.go`：`get`、`put` | 有 LRU、writeGen 和名片 CAS；没有完整的 2.1 关系验收。get 会把部分 DB 故障映射为 404。 | 引入统一关系检查入口；新鲜 GET/HEAD 绕过缓存并先确认释放；PUT 无论有无检查头都执行基于 agent.md CAS 的保护。 |
 | 同文件：`validateAgentMDUpload`、`enforceStoredOwner` | 完整文件验签已有；锁主要依据旧名片 owner/proof。 | 拆开本身份验签和关系验收；原 owner 从持久化 agent.md 的 ownership 字段及旧名片确定，不能取待上传目标。 |
-| 同文件：`authorizeAgentMDUploader`、`verifyOwnerAgentMDAuthorization`、`verifyOwnershipProof` | 支持旧 proof、owner 授权头和群 owner 代理分支。 | 普通 2.1 本身份上传，旧分支不得覆盖已有关系。Group/Org 按权威类型分流到当前生命周期、实体主签、全块验签及 owner token 上传校验，不落通用账本，不允许自声明改类型绕锁。 |
+| 同文件：`authorizeAgentMDUploader`、`verifyOwnerAgentMDAuthorization`、`verifyOwnershipProof` | 支持旧 proof、owner 授权头和群 owner 代理分支。 | 普通 2.1 本身份上传，旧分支不得覆盖已有关系。现代 Group/Org 进入通用声明／共识及 CAS，同时校验权威类型、当前生命周期、实体主签、完整签名链和 owner token；不另建关系事实账本，不允许自声明改类型绕锁。 |
 | `internal/httpserver/agent_md_schema.go` | `aidParseTailStrictAt`、`validateStrictAgentMDMeta`、旧 ownership 校验。 | 复用严格解析，补 TAG、statement/action、文件角色和当前证书验证。 |
 | `internal/repository/mysql.go`：`CompareAndSwapAgentMD` | CAS 范围只有名片内容、摘要和更新时间。 | 让 ownership 字段随完整 `agent.md` 一起原子提交；不增加独立关系事实表或证据表。 |
 | `internal/httpserver/agentmd_cache.go` | 当前名片缓存。 | 继续供普通展示；不能作为最终授权依据。 |
@@ -184,7 +184,7 @@ TS/JS 的 [cert-utils.ts](../../ts/src/cert-utils.ts)、[JS 对应文件](../../
 
 owner.md 不具备名片必填的 name/type/version，不能直接复用“必须是 agent.md”校验。复用底层签名容器，在各模块内分别实现两种角色 schema；NS 不依赖 SDK 的包。
 
-当前证书材料通过既有权威查询获取，精确核对 AID、证书 DER 指纹、实际 `active_signing`、完整证书链及签名 OCSP。OCSP 绑定本次链选定的直接 issuer，核对 CertID serial、issuer name/key hash 与 ResponderID，只接受该 issuer 亲签及同一 issuer 内嵌证书，不接受委派 responder；链获取和 OCSP 接收后用当时当前时间检查新鲜度，末尾再次核对链有效期。未知签名身份类型时省略 `key_purpose`，不得将 owner.md 的签名者一律视为普通 signing 身份。Group/Org 主签证书属于实体并匹配 frontmatter 指纹，owner 可另附签，附签同样必须验证；已知群实体证书查询使用 `group_identity`。CA `observed_at` 与 OCSP `ThisUpdate` 距当前时间不得超过 30 秒，`ProducedAt` 不得超过 90 秒，三者未来偏差均不得超过 5 秒；`NextUpdate` 严格晚于当前时间和 `ThisUpdate`。CA 的 Go OCSP 签发器按分钟截断 `ProducedAt`，因此其窗口包含取整误差，其它当前状态窗口不变。NS 在最终提交前按当时的服务端时间重新核对；材料不可确认返回 unavailable，已知坏签名、无效链或吊销返回 invalid。
+当前证书材料通过既有权威查询获取，精确核对 AID、证书 DER 指纹、实际 `active_signing`、完整证书链及签名 OCSP。OCSP 绑定本次链选定的直接 issuer，核对 CertID serial、issuer name/key hash 与 ResponderID，只接受该 issuer 亲签及同一 issuer 内嵌证书，不接受委派 responder；链获取和 OCSP 接收后用当时当前时间检查新鲜度，末尾再次核对链有效期。未知签名身份类型时省略 `key_purpose`，不得将 owner.md 的签名者一律视为普通 signing 身份。现代 Group/Org 主签证书属于实体，以尾签指纹核对当前证书代际，不要求旧 frontmatter 指纹；owner 可另附签，附签同样必须验证；已知群实体证书查询使用 `group_identity`。CA `observed_at` 与 OCSP `ThisUpdate` 距当前时间不得超过 30 秒，`ProducedAt` 不得超过 90 秒，三者未来偏差均不得超过 5 秒；`NextUpdate` 严格晚于当前时间和 `ThisUpdate`。CA 的 Go OCSP 签发器按分钟截断 `ProducedAt`，因此其窗口包含取整误差，其它当前状态窗口不变。NS 在最终提交前按当时的服务端时间重新核对；材料不可确认返回 unavailable，已知坏签名、无效链或吊销返回 invalid。
 
 ### 4.2 五个内部文件方法
 
@@ -321,11 +321,11 @@ Storage 当前完整原文复核与 NS 提交之间没有跨服务一致快照
 
 内部编排器与消息处理器推进同一任务；sub-first 及 transfer 的历史 ready 通知不得再次创建绑定任务，owner-first 无需 owner.ready。普通名片更新仍使用现有名片 API，但必须完整保留锁定的关系字段。
 
-普通 `agent` 注册的 owner 可选；指定 owner 时，owner 意图先与 SDK 生成的固定 operation_id 一起持久保存；初始名片不写 owner 或旧 proof，并以条件创建提交。连接后用该 ID 进入绑定编排，响应丢失或重连都读取原任务，不另建操作、不默认批准；未指定 owner 时只初始化普通名片，不创建关系任务。NS 不可用时保留已有意图；已有关系或未知旧待上传文件不能由初始化路径覆盖。Group/Org 身份准备不生成通用注册意图；创建自动 owner 绑定，owner 持有实体材料，用实体私钥主签并以本人 token 上传，可选追加本人附签。专属 pending 保存实体命名空间、固定 owner、实体证书指纹、原完整多签文件及原 CAS，恢复不补造条件或跨 owner/rekey 代际重签。
+普通 `agent` 注册的 owner 可选；指定 owner 时，owner 意图先与 SDK 生成的固定 operation_id 一起持久保存；初始名片不写 owner 或旧 proof，并以条件创建提交。连接后用该 ID 进入绑定编排，响应丢失或重连都读取原任务，不另建操作、不默认批准；未指定 owner 时只初始化普通名片，不创建关系任务。NS 不可用时保留已有意图；已有关系或未知旧待上传文件不能由初始化路径覆盖。Group/Org 身份准备不生成这类通用注册意图；其创建由当前 owner 先条件发布本人签名的 owner.md，再用实体私钥签署含配对 statement 的 agent.md、以 owner token 条件上传，最后强制确认 owner 和关系版本的共识。创建／转移检查点保留可接续阶段，历史首次补齐默认 v=1，同 owner 的匹配声明复用当前版本；转移须核对旧 owner 的有效目标授权并使用 v+1，不补造条件或跨 owner/rekey 代际重签旧稿。
 
 普通显式上传与注册初始化分别保存待办。普通名片候选在本地 schema 和外层签名验证通过后、首次远端 preflight 前，先独立保存到既有元数据的私有 `local_draft_content`，不覆盖已确认的远端 content/ETag；自有且持有本地私钥的身份默认 resolve 优先返回该稿，标记 unverified、in_sync=false、source.agent_md_fetched=false。显式 download／forceRefresh 仍读取远端权威内容并保留草稿，只有服务端确认对应候选提交成功才清稿。重连不自动重传普通失败稿，普通注册 initial 失败稿同样需要应用显式重试；即使存在普通 pending 也不隐式 PUT。Ownership 2.1 任务及注册意图的既有恢复不能替代失败稿的显式重试。取得可靠 NS 原条件后，仍在 PUT 前持久保存完整签名字节、原 If-Match／If-None-Match 及关系快照；显式重试既有 pending 时先核原条件，缺失则保留原元数据及原错误，不因远端同字节而清除。2.1 正文更新核对原 owner、完整 statement、relation_version 和 lock。已有普通 legacy owner/proof 或 2.0 关系仅允许更新正文，完整保留 owner、ownership、ownership_proof、ownership_release 的存在性、类型和值；新 metadata 和外签执行当前规则，不自动迁入 2.1。该分支持久保存原全文、摘要、原 ETag 及完整关系快照，重试核对 base/candidate/remote 和原条件；全文及提交 ETag 均对应原提交时只观察确认，否则仅按仍成立的原条件重传原 blob，不刷新 CAS、不重签、不补造上下文。其它缺原上下文的旧待办仅允许版本 0 / unlocked 的初始关系；实际关系变更由对应 Ownership 任务恢复。
 
-Group/Org 名片失败稿及 pending 保留实体命名空间中的完整多签原文、原 CAS、固定 owner 和实体证书指纹，由应用显式重试，post-connect／重连不隐式 PUT。重试先验证完整原件及当前 owner、状态和证书代际，原条件完整且同代际原文／ETag 已确认提交时只观察完成。转移、rekey 或解散后停止旧代际待办，不更换身份、指纹或条件重签。新 SDK 现代上传不再保存、刷新或检查额外 V2 授权及过期窗口；旧 V2 兼容入口仍按协议 §2.5 校验；普通文件签名与当前证书检查保留。专属 create/transfer 自身 checkpoint 恢复机制不变。
+Group/Org 名片失败稿及 pending 保留实体命名空间中的完整签名原文、原 CAS、固定 owner 和签名证书代际，由应用显式重试；重试核对完整原件及当前 owner、状态和证书，原条件完整且同代际原文／ETag 已确认提交时只观察完成。转移、rekey 或解散后不更换身份、证书或条件重签旧稿。生命周期 create/transfer 检查点恢复与访问补齐另行保留：按当前身份、成功连接代际和单实体合并一次检查，缺本地实体材料直接停止；可用的本地共识匹配 owner 时结束，否则确认 active 生命周期 owner 后查询共识，仅在具备本人及实体私钥时补齐缺失声明。失败不在同一连接自动反复重试，真实重连后可重查；不在启动时遍历所有群重传名片。现代上传不需额外 V2 授权，历史兼容入口仍按协议 §2.5 校验。
 
 ### 7.2 转移的默认编程顺序
 
@@ -417,7 +417,7 @@ sub 收到 release 通知时，只有在持久历史中找到本人明确 accept
 
 共识检查从首次 NS GET 发出前开始计算整体 30 秒窗口，覆盖首读、证书/Storage 验证和末读；材料变化或超时返回可重试 unavailable。fresh HTTP 携带 no-cache 并禁止自动跟随重定向。收到 sub.cleaned 时，按任务固定上下文新鲜核对当前 NS 完整原文、ETag 和全文摘要；字段已清空时可记录当前 unbound/0 的清理观察。通知或观察进度不能证明本任务执行提交，也不能替代首次完成 release 所需的原件及原 CAS 关联核验。
 
-Group/Org 名片失败稿及 pending 保留实体命名空间中的完整多签原文、原 CAS、固定 owner 和实体证书指纹，由应用显式重试，post-connect／重连不隐式 PUT。重试先验证完整原件及当前 owner、状态和证书代际，原条件完整且同代际原文／ETag 已确认提交时只观察完成。转移、rekey 或解散后停止旧代际待办，不更换身份、指纹或条件重签。新 SDK 现代上传不再保存、刷新或检查额外 V2 授权及过期窗口；旧 V2 兼容入口仍按协议 §2.5 校验；普通文件签名与当前证书检查保留。专属 create/transfer 自身 checkpoint 恢复机制不变。
+Group/Org 的普通名片失败稿只按原字节和原 CAS 显式重试；生命周期 create/transfer 的检查点恢复以及首次访问的声明补齐是独立路径，不能笼统写为实体一律不恢复或重连自动重传旧稿。补齐先预筛本地实体材料，再按当前身份／连接代际共享单实体检查；已有可用共识匹配本人时跳过，否则确认 active 生命周期 owner 后查询并补齐。缺私钥、依赖 unavailable、关系 invalid 或其他 owner 冲突均不能按无主覆盖。具体顺序、版本复用和旧代际边界见第 7.1 节及协议 §2.5。
 
 重连恢复先读取 NS/Storage，再考虑待发消息、写入和删除。一次持久保存的 step 不能证明远端副作用已经发生，远端的新版本也不能被旧 step 覆盖。
 

package/_packed_docs/sdk/README.md

@@ -1,5 +1,7 @@
 # AUN Protocol - SDK 文档
 
+本目录为四 SDK **0.5.34** 的现行主文档入口；带版本号的专题及 CHANGELOG 保留其历史版本语义，不能替代当前 API 手册。
+
 AUN（Agent Union Network）定义 Agent 之间安全通信的标准接口，基于 WebSocket + JSON-RPC 2.0，涵盖身份、认证、消息、群组、存储、流式传输和端到端加密。
 
 ---
@@ -11,8 +13,9 @@ AUN（Agent Union Network）定义 Agent 之间安全通信的标准接口，基
 - **Gateway 连接**：当前各语言 SDK 稳定支持 Gateway 接入；Peer / Relay 仍处于协议定义或未实现状态。
 - **默认 E2EE**：P2P 和 Group V2 消息默认加密；普通明文消息需要显式关闭加密。
 - **统一 RPC / 事件 / Notify**：业务方法通过 `client.call(method, params)` 调用，事件通过 `client.on(event, handler)` 订阅；在线轻量通知通过 `client.notify()` 发送，支持同域和跨域在线 federation，详见 `Notify通知方案.md`。
+- **事件发布订阅**：四 SDK 的 `EventService` 支持同一 AID 在同一 Bus 上同时承担 bus/pub/sub；目录、订阅和待发布队列使用 SQLite／IndexedDB 持久化，`publications` / `subscriptions` 查询当前发布汇总与有效订阅，见 [API 手册](06-API手册.md#eventservice-事件发布订阅)。
 - **当前 access token**：自行发起要求 AID Bearer 的 HTTP 数据面请求时，每次请求前使用 Python `get_access_token()`、TypeScript / JavaScript `getAccessToken()` 或 Go `GetAccessToken()` 读取后台刷新维护的缓存；不得长期复用 `authenticate()` 首次返回的字符串。
-- **Service Proxy**：Python SDK 提供 `ServiceProxyClient`，provider 会先向 Gateway 注册 `proxy.*` 控制面服务列表，再在每条 proxy-server 隧道认证后注册数据面服务列表。
+- **Service Proxy**：Python、TypeScript、JavaScript 和 Go 均提供 `ServiceProxyClient`；provider 先向 Gateway 注册 `proxy.*` 控制面服务列表，再在每条 proxy-server 隧道认证后注册数据面服务列表。浏览器 JavaScript 需使用可承载 Authorization Bearer 的自定义 WebSocket factory。
 
 ---
 
@@ -33,16 +36,16 @@ BOB = f"bob-{random.randint(1000,9999)}.{DOMAIN}"
 
 
 async def create_client(aid: str) -> AUNClient:
-    store = AIDStore(aun_path="~/.aun/myapp", encryption_seed="")
+    store = AIDStore(aun_path="~/.aun/myapp", encryption_seed="", slot_id="main")
     loaded = store.load(aid)
     if not loaded["ok"]:
-        registered = await store.register(aid)
+        registered = await store.register(aid, type="human")
         if not registered["ok"]:
             raise RuntimeError(registered["error"]["message"])
         loaded = store.load(aid)
 
     client = AUNClient(loaded["data"]["aid"])
-    await client.connect({"slot_id": "main", "auto_reconnect": True})
+    await client.connect({"auto_reconnect": True})
     return client
 
 
@@ -109,12 +112,14 @@ Layer 1: 安全层   TLS + AUN E2EE
 | [03-核心概念](03-核心概念.md) | AID、AIDStore、AUNClient、九态状态机、E2EE |
 | [04-连接与认证](04-连接与认证.md) | 注册、加载、认证、当前 access token getter、连接、Python Push 自动登记、事件、agent.md |
 | [05-E2EE加密通信](05-E2EE加密通信.md) | E2EE 收发、ProtectedHeaders、密钥管理 |
-| [06-API手册](06-API手册.md) | AIDStore / AID / AUNClient / 四 SDK access token getter / Python PushFacade / ServiceProxyClient / 事件 / RPC 索引 |
+| [06-API手册](06-API手册.md) | AIDStore / AID / AUNClient / 四 SDK access token getter / EventService / Python PushFacade / ServiceProxyClient / 事件 / RPC 索引 |
 | [07-错误处理](07-错误处理.md) | Result、异常层级、错误码、重试策略 |
 | [08-最佳实践](08-最佳实践.md) | 幂等连接、多 AID、资源清理、测试数据保护 |
 | [AUN Storage架构设计](<../aun-fs/AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、服务端分层、类 Linux 权限、mount/symlink 和关键时序 |
 | [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
-| [CHANGELOG-0.5.6](CHANGELOG-0.5.6.md) | **0.5.6 版本更新日志**：验签缓存、消息窗口、显式 change-seed 与四语言能力边界 |
+| [AUN事件发布订阅应用集成指南](AUN事件发布订阅应用集成指南.md) | Bus / Pub / Sub 调用顺序、多角色、持久化恢复与目录查询 |
+| [AUN事件发布订阅开发移植指南](AUN事件发布订阅开发移植指南.md) | 四 SDK 的协议、队列、授权、持久化及实现边界 |
+| [CHANGELOG-0.5.6](CHANGELOG-0.5.6.md) | **历史 0.5.6 更新日志**：验签缓存、消息窗口、显式 change-seed 与当时的四语言能力边界 |
 
 RPC 专项手册：