@agentunion/fastaun 0.5.16 → 0.5.17

package/_packed_docs/INDEX.md

@@ -16,6 +16,7 @@
 | [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md) | Python / Go / TS / JS SDK AUNClient 内部拆分边界、执行步骤和验收矩阵 |
 | [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md) | AUNClient 完全门面化、ClientRuntime 单一状态源和四端分批迁移步骤 |
 | [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md) | Forward A/T/H 窗口、Group 成员可见性下界、Tail/History RPC、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和跨 SDK 验收门禁 |
+| [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md) | `message.send` 秒级 TTL 钳制、持久/volatile 双游标、按 device 收件箱、隐藏 slot lease/ACK、文件 epoch、消息调试计数器与 payload type 分类、多实例/跨域和四 SDK 测试矩阵 |
 | [消息同步与历史拉取代码审查问题清单](消息同步与历史拉取代码审查问题清单.md) | Python/Go 服务端、Gateway 与四 SDK 当前实现的 P0/P1/P2 问题、retention/Group Forward 可见性边界、跨语言差异、修复顺序和已排除误报 |
 | [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md) | 多语言 SDK 同网同服、test-runner 控制面的跨语言 E2E 方案 |
 | [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md) | SDK bootstrap 能力声明 + 服务端 policy 控制 1DH/per-AID wrap 的兼容方案 |
@@ -72,6 +73,7 @@
 - AUNClient 巨类拆分、内部组件边界、逐步迁移和验收矩阵 → [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md)
 - AUNClient 完全门面化、Runtime 状态归属、状态写入收口和四端分批实施 → [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md)
 - P2P/Group Message 的 A/T/H、Tail/History、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和分布式验收门禁 → [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md)
+- P2P `message.send` TTL 内存缓存、持久/volatile 游标、device 收件箱、隐藏 slot lease/ACK、服务 epoch、消息调试计数器与 payload type 分类、跨 SDK/双域验收 → [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md)
 - 当前实现的完整度、P0/P1/P2 缺陷、Python/Go 服务端差异、四 SDK 差异与 Go Group inbox-only 对齐项 → [消息同步与历史拉取代码审查问题清单](消息同步与历史拉取代码审查问题清单.md)
 - Python / TypeScript / Go / JavaScript 跨语言容器 E2E、internal 网络、每轮唯一 AID、test-runner、test-control API、用例矩阵 → [aun测试运行指南](aun测试运行指南.md)、[跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
 - 多语言 SDK 测试缺口与补测清单 → [审查与路线图目录](audit/)
@@ -152,6 +154,10 @@
 
 定义在原 Forward Cursor 上增加 A/T/H 实时扫描窗口：新 Head 一律先 Tail，仍有未扫描 Gap 时再执行一页后台 Forward；History 是独立只读 RPC。方案明确 A/T/H 只是扫描水位，SDK 仅保证响应页内唯一有序发布，跨页由应用按 message_id 幂等并按 seq 排序；同时区分物理 GC retention floor 与 Group Forward 成员可见性下界，规定缺 sender IK 时最多 3 秒 single-flight 同步 bootstrap、Forward 按服务端原始页最大 seq 推进、页内缺号视为永久空号、坏密文不阻塞水位、三个 Pull Gate 的前后台 FIFO 与 3 秒旁路，以及四语言 SDK、服务端、Gateway、兼容矩阵和分布式 E2E 门禁。
 
+### P2P 消息 TTL 内存缓存方案
+
+定义 P2P `message.send` 的秒级 `ttl` 语义：`ttl <= 0` 走原持久化路径，正数钳制到 1-3600 秒并进入不写数据库/WAL 的 volatile 通道。方案规定持久/volatile 独立游标、按 device 的内存收件箱、slot 隐藏的 lease/ACK、服务模块数据目录中的递增 epoch 文件、消息调试页的 volatile 计数器与 payload type 分类、重启丢失和多实例/跨域约束，并给出 Python/Go 服务端、四 SDK、单域、cross-SDK、E2E 与双域验收矩阵。
+
 ### 消息同步与历史拉取代码审查问题清单
 
 以当前代码为唯一事实来源，汇总 Python/Go Message 与 Group 服务端、Python/Go Gateway、Python/TypeScript/Go/JavaScript SDK 的实现完整度和横向一致性。问题按 P0/P1/P2 排序，覆盖跨 Gap ACK、retention 与 Group Forward 可见性边界、崩溃窗口、异步任务代际、反向快照、History 分页、GC/WAL/cache、响应上限、敏感日志与诊断缺口；明确迁移完成后 Python Group inbox-only 为基准，Go Group 仍合并旧表必须对齐，并记录已排除的误报。
@@ -206,7 +212,7 @@
 
 ### SDK 文档索引
 
-`docs/sdk/INDEX.md` 是 SDK 手册的三层子索引，覆盖快速开始、连接认证、Python `push_notify_aid` 自动登记与 PushFacade、E2EE V2、API 手册、Service Proxy、Storage VFS、Group FS、Group Index、Collab 和各类 RPC 手册。
+`docs/sdk/INDEX.md` 是 SDK 手册的三层子索引，覆盖快速开始、连接认证、E2EE V2、P2P device/TTL volatile 消息、Group 成员控制与两阶段群主转让、Storage MIME/Content-Type/OSS 403、Python `ErrorInfo.cause`、Group FS、Collab 和各类 RPC 手册。
 
 ### Service Proxy RPC 手册
 
@@ -234,7 +240,7 @@
 
 ### AUN Storage 架构设计
 
-定义 AUN Storage 的 SDK VFS、low-level storage client、Storage Service、Storage Core、Metadata Engine 和 Blob Backend 分层。文档明确大文件主数据流量直连 localfs/OSS/S3/COS backend，控制面通过 `storage.*` RPC 管理权限、配额、session/ticket、元数据提交和事件；普通应用通过 SDK VFS 使用类 POSIX 文件操作，底层 session/ticket/complete RPC 保留给 SDK 和高级客户端。文档还定义下载 ticket 与 AID Bearer 的语义边界、跨 issuer 下载和当前 access token getter 用法，以及类 Linux mode/ACL、目录 `x` 位、mount/unmount、symlink/readlink/lstat、share link 与 direct backend ticket 的授权边界。
+定义 AUN Storage 的 SDK VFS、low-level storage client、Storage Service、Storage Core、Metadata Engine 和 Blob Backend 分层。大文件主数据流量直连 localfs/OSS/S3/COS backend，控制面通过 `storage.*` RPC 管理权限、配额、session/ticket、元数据提交和事件；普通应用通过 SDK VFS 使用类 POSIX 文件操作。SDK 手册补充四语言实际字节 MIME 识别、session/PUT/complete Content-Type 一致性和 OSS 403 边界；底层 RPC 保留给能自行完成该编排的高级客户端。
 
 ### AUN Storage SDK 存储分层设计
 

package/_packed_docs/KITE_DOCS_GUIDE.md

@@ -46,6 +46,8 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | AUNClient 完全门面化与 Runtime 状态迁移细化方案 | `docs/design/AUNClient门面化与Runtime状态迁移细化方案.md` |
 | A/T/H、Tail/Forward、Group 成员可见性下界、History、缺 sender IK 有界同步 bootstrap、页内唯一有序发布、应用层跨页幂等排序、Pull Gate 与兼容边界 | `docs/消息同步与历史拉取改造方案.md` L7-375 |
 | 消息同步 TDD、Gateway、兼容性和分布式 E2E 门禁 | `docs/消息同步与历史拉取改造方案.md` L434-750 |
+| P2P 消息 `ttl` 秒级钳制、volatile 双游标、device 收件箱、隐藏 slot lease/ACK、epoch 文件、消息调试计数器与 payload type 分类和四 SDK/双域测试方案 | `docs/design/P2P消息TTL内存缓存方案.md` L1-369 |
+| P2P device 定向发送、TTL volatile 消息、SDK 自动游标/ACK/去重与公开事件字段 | `docs/sdk/06-API手册.md`、`docs/sdk/09-message-rpc-manual.md` |
 | 当前实现的代码审查结论、P0/P1/P2 问题与跨语言差异 | `docs/消息同步与历史拉取代码审查问题清单.md` L3-207 |
 | 消息同步问题修复顺序与已排除误报 | `docs/消息同步与历史拉取代码审查问题清单.md` L208-229 |
 | SDK 中如何使用 History、理解页内发布边界、缺 sender IK 有界同步 bootstrap、应用幂等、坏密文推进和 Piggy ACK | `docs/sdk/03-核心概念.md` L60-80、`docs/sdk/05-E2EE加密通信.md` L33-56、`docs/sdk/08-最佳实践.md` L89-116、`docs/sdk/09-message-rpc-manual.md` L278-395、`docs/sdk/09-group-rpc-manual.md` L1282-1353、L1547-1605 |

package/_packed_docs/agent.md/SCHEMA.md

@@ -125,21 +125,21 @@ version:
   example: "1.0.0"
 
 # ===== 描述信息 =====
-description:
-  type: string
-  required: false
-  max_length: 100
-  description: "一句话简介，用于列表展示"
-
-# ===== 头像 =====
-avatar:
-  type: string
-  required: false
-  max_length: 256
-  description: "头像地址或标识"
-
-# ===== 标签 =====
-tags:
+description:
+  type: string
+  required: false
+  max_length: 100
+  description: "一句话简介，用于列表展示"
+
+# ===== 头像 =====
+avatar:
+  type: string
+  required: false
+  max_length: 256
+  description: "头像地址或标识"
+
+# ===== 标签 =====
+tags:
   type: array
   required: false
   items: