@agentunion/fastaun-browser 0.4.8 → 0.4.9

package/CHANGELOG.md

@@ -6,6 +6,23 @@
 
 ---
 
+## 0.4.9 — 2026-06-03
+
+### 修复
+- V2 明文消息（P2P 和群组）投递时补充调用 `attachGatewayProximity()`，消息事件 payload 现可携带 `proximity`（`same_network`/`same_device`/`basis`/`asserted_by`）字段（四语言对齐）
+
+### 优化
+- `AUNClient` 运行时状态全面迁移至 `ClientRuntime` 统一抽象层，生命周期、消息投递、RPC 路由、身份、V2 E2EE、群组状态各子组件构造函数统一接收 `runtime` 参数，消除组件间直接引用主客户端对象
+- `LifecycleController`、`MessageDeliveryEngine`、`GroupStateCoordinator`、`IdentityRuntimeManager` 的状态读写全部改为通过 `runtime.*` setter/getter，提升可测试性
+- `RpcPipeline` 接管原 `AUNClient.call()` 全部路由逻辑，主客户端 `call()` 直接委托
+- `ConnectionOptions` 新增 `retry` 配置项，支持自定义重连策略
+- 移除 `PEER_PREKEYS_CACHE_TTL` 常量，相关逻辑统一收归运行时
+
+### 测试
+- 补充针对运行时抽象层重构后的浏览器 E2E 及单元测试覆盖
+
+---
+
 ## 0.4.8 — 2026-06-03
 
 ### 新功能

package/_packed_docs/CHANGELOG.md

@@ -6,6 +6,23 @@
 
 ---
 
+## 0.4.9 — 2026-06-03
+
+### 修复
+- V2 明文消息（P2P 和群组）投递时补充调用 `attachGatewayProximity()`，消息事件 payload 现可携带 `proximity`（`same_network`/`same_device`/`basis`/`asserted_by`）字段（四语言对齐）
+
+### 优化
+- `AUNClient` 运行时状态全面迁移至 `ClientRuntime` 统一抽象层，生命周期、消息投递、RPC 路由、身份、V2 E2EE、群组状态各子组件构造函数统一接收 `runtime` 参数，消除组件间直接引用主客户端对象
+- `LifecycleController`、`MessageDeliveryEngine`、`GroupStateCoordinator`、`IdentityRuntimeManager` 的状态读写全部改为通过 `runtime.*` setter/getter，提升可测试性
+- `RpcPipeline` 接管原 `AUNClient.call()` 全部路由逻辑，主客户端 `call()` 直接委托
+- `ConnectionOptions` 新增 `retry` 配置项，支持自定义重连策略
+- 移除 `PEER_PREKEYS_CACHE_TTL` 常量，相关逻辑统一收归运行时
+
+### 测试
+- 补充针对运行时抽象层重构后的浏览器 E2E 及单元测试覆盖
+
+---
+
 ## 0.4.8 — 2026-06-03
 
 ### 新功能

package/_packed_docs/INDEX.md

@@ -18,9 +18,10 @@
 | [AUN 服务端消息通信诊断面板方案](design/AUN服务端消息通信诊断面板方案.md) | aun-console 消息通信页的服务端可观察诊断面板总体方案 |
 | [服务端消息通信诊断面板 P0 方案](design/服务端消息通信诊断面板P0方案.md) | aun-console 消息通信页的服务端可观察 P0 诊断面板 |
 | [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md) | 远程 agent.md per-AID 本地文件/IndexedDB 缓存、消息信封与 RPC 响应 ETag 透传方案 |
-| [SDK 文档索引](sdk/INDEX.md) | SDK 使用手册、RPC 手册、E2EE 手册的子索引 |
-| [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md) | SDK 文档按行区间渐进式查阅方法 |
-| [协议文档目录](protocol/) | AUN 协议相关文档 |
+| [SDK 文档索引](sdk/INDEX.md) | SDK 使用手册、RPC 手册、E2EE 手册的子索引 |
+| [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md) | SDK 文档按行区间渐进式查阅方法 |
+| [Notify 通知方案](sdk/Notify通知方案.md) | `client.notify()` 在线轻量通知、路由和可靠消息分工 |
+| [协议文档目录](protocol/) | AUN 协议相关文档 |
 | [审查与路线图目录](audit/) | 历史审查、修复路线图、测试补充清单 |
 | [superpowers 目录](superpowers/) | AUN SDK 规范类补充文档 |
 
@@ -39,9 +40,10 @@
 
 ### SDK 使用与协议
 
-- Python / TS / Go / JS SDK 使用手册、RPC 参数、E2EE 机制 → [SDK 文档索引](sdk/INDEX.md)
-- 按主题和行区间查 SDK 文档 → [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md)
-- 协议细节、子协议和消息格式 → [协议文档目录](protocol/)
+- Python / TS / Go / JS SDK 使用手册、RPC 参数、E2EE 机制 → [SDK 文档索引](sdk/INDEX.md)
+- 按主题和行区间查 SDK 文档 → [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md)
+- `client.notify()` 在线轻量通知、AID/群路由和不离线存储边界 → [Notify 通知方案](sdk/Notify通知方案.md)
+- 协议细节、子协议和消息格式 → [协议文档目录](protocol/)
 - agent.md 远程缓存、`remote_etag` / `local_etag`、消息信封 ETag 透传 → [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md)
 
 ### 诊断与可观测性
@@ -106,6 +108,10 @@
 
 `docs/sdk/INDEX.md` 是 SDK 手册的三层子索引，覆盖快速开始、WebSocket 协议、核心概念、连接认证、E2EE、API 手册、错误处理、最佳实践、payload 和各类 RPC 手册。
 
-### SDK 查阅指南
-
-`docs/sdk/AUN_DOCS_GUIDE.md` 说明如何按行区间渐进式读取 SDK 文档，避免一次性加载过多文档内容。
+### SDK 查阅指南
+
+`docs/sdk/AUN_DOCS_GUIDE.md` 说明如何按行区间渐进式读取 SDK 文档，避免一次性加载过多文档内容。
+
+### Notify 通知方案
+
+定义 `client.notify()` 的 JSON-RPC Notification 发送语义。方案规定 notify 只投递在线长连接设备，不做离线存储、不分配 seq、不进入 pull/ack；同时说明服务端通知、AID 在线转发、群在线转发的路由模型，以及和 `message.send` / `group.send` 可靠应用事件的分工。

package/_packed_docs/KITE_DOCS_GUIDE.md

@@ -8,18 +8,18 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 
 ### Step 1：先读根级 Layer 1
 
-- `docs/INDEX.md` L7-25：根级文档地图。
+- `docs/INDEX.md` L7-26：根级文档地图。
 
 ### Step 2：按主题读根级 Layer 2
 
-- 测试与 E2E：`docs/INDEX.md` L31-38。
-- SDK 使用与协议：`docs/INDEX.md` L40-45。
-- 诊断与可观测性：`docs/INDEX.md` L47-53。
-- E2EE 与跨语言一致性：`docs/INDEX.md` L55-59。
+- 测试与 E2E：`docs/INDEX.md` L32-39。
+- SDK 使用与协议：`docs/INDEX.md` L41-47。
+- 诊断与可观测性：`docs/INDEX.md` L49-55。
+- E2EE 与跨语言一致性：`docs/INDEX.md` L57-61。
 
 ### Step 3：需要判断文档价值时读 Layer 3 摘要
 
-- `docs/INDEX.md` L63-111：重点文档摘要。
+- `docs/INDEX.md` L65-117：重点文档摘要。
 
 ### Step 4：再读目标文档章节
 
@@ -57,4 +57,5 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | agent.md ETag 透传时序图 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L88-185 |
 | agent.md 服务端与 SDK 实现流程 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L187-268 |
 | agent.md 本地持久化、竞态和测试点 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L269-317 |
-| SDK API、RPC、E2EE 使用细节 | `docs/sdk/AUN_DOCS_GUIDE.md` |
+| SDK API、RPC、E2EE 使用细节 | `docs/sdk/AUN_DOCS_GUIDE.md` |
+| Notify 在线轻量通知方案 | `docs/sdk/Notify通知方案.md` |

package/_packed_docs/sdk/AUN_DOCS_GUIDE.md

@@ -10,7 +10,7 @@ AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：
 - `AID`：不可变身份值对象，负责签名、验签和 agent.md 签验。
 - `AUNClient`：认证、连接、状态机、事件和 RPC。
 
-业务操作统一通过 `client.call(method, params)` 调用；消息、群组、存储、meta、stream 的参数见 `09-*-rpc-manual.md`。`message.send`、`message.thought.put`、`group.send`、`group.thought.put` 的业务 payload 见 `09-payload-reference.md`。
+业务操作统一通过 `client.call(method, params)` 调用；消息、群组、存储、meta、stream 的参数见 `09-*-rpc-manual.md`。`message.send`、`message.thought.put`、`group.send`、`group.thought.put` 的业务 payload 见 `09-payload-reference.md`。在线轻量通知方案见 `Notify通知方案.md`。
 
 ## 渐进式查阅流程
 
@@ -25,7 +25,7 @@ AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：
 - 身份与认证：AIDStore / AID / 注册 / 加载 / 证书
 - 连接与状态：AUNClient / 九态状态机 / Gateway / 重连
 - E2EE：默认加密、ProtectedHeaders、P2P / Group V2
-- RPC 与事件：`client.call()`、`client.on()`、RPC 手册
+- RPC 与事件：`client.call()`、`client.on()`、`client.notify()`、RPC 手册
 - agent.md：`AIDStore.upload_agent_md()`、`AIDStore.download_agent_md()`、`AIDStore.check_agent_md()`
 - 错误处理：Result、异常、错误码、重试
 
@@ -58,7 +58,8 @@ AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：
 | 发布、下载或检查 agent.md | [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md) |
 | 状态机和重连 | [03-核心概念](03-核心概念.md)、[04-连接与认证](04-连接与认证.md) |
 | 查方法签名 | [06-API手册](06-API手册.md) |
-| 查消息或群组 RPC | 对应 `09-*-rpc-manual.md` |
-| 查 payload 格式 | [09-payload-reference.md](09-payload-reference.md) |
+| 查消息或群组 RPC | 对应 `09-*-rpc-manual.md` |
+| 查 notify 在线轻量通知 | [Notify通知方案.md](Notify通知方案.md) |
+| 查 payload 格式 | [09-payload-reference.md](09-payload-reference.md) |
 | 排查错误 | [07-错误处理](07-错误处理.md) |
 | 写测试或 demo | [08-最佳实践](08-最佳实践.md) |

package/_packed_docs/sdk/INDEX.md

@@ -20,10 +20,11 @@
 | [09-payload-reference](09-payload-reference.md) | message / group / thought payload 格式 |
 | [09-message-rpc-manual](09-message-rpc-manual.md) | P2P 消息 RPC |
 | [09-group-rpc-manual](09-group-rpc-manual.md) | 群组 RPC |
-| [09-storage-rpc-manual](09-storage-rpc-manual.md) | 存储 RPC |
-| [09-meta-rpc-manual](09-meta-rpc-manual.md) | meta RPC 和信任根 |
-| [09-stream-rpc-manual](09-stream-rpc-manual.md) | stream RPC |
-| [09-custody-api-manual](09-custody-api-manual.md) | 可选 AID 托管 HTTP API |
+| [09-storage-rpc-manual](09-storage-rpc-manual.md) | 存储 RPC |
+| [09-meta-rpc-manual](09-meta-rpc-manual.md) | meta RPC 和信任根 |
+| [09-stream-rpc-manual](09-stream-rpc-manual.md) | stream RPC |
+| [09-custody-api-manual](09-custody-api-manual.md) | 可选 AID 托管 HTTP API |
+| [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知设计 |
 
 ---
 
@@ -54,8 +55,9 @@
 
 ### RPC 与事件
 
-- `client.call()` / `client.on()` → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
-- Message RPC → [09-message-rpc-manual](09-message-rpc-manual.md)
+- `client.call()` / `client.on()` → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
+- `client.notify()` 在线轻量通知 → [Notify通知方案](Notify通知方案.md)
+- Message RPC → [09-message-rpc-manual](09-message-rpc-manual.md)
 - Group RPC → [09-group-rpc-manual](09-group-rpc-manual.md)
 - Storage RPC → [09-storage-rpc-manual](09-storage-rpc-manual.md)
 - Meta RPC → [09-meta-rpc-manual](09-meta-rpc-manual.md)
@@ -105,6 +107,10 @@
 
 给出幂等加载身份、连接、关闭、多 AID 管理、protected_headers、Flow Control 和测试数据保护建议。
 
-### 09-*-rpc-manual
-
-各业务服务的 RPC 参数、响应和错误语义。SDK 不为每个 RPC 提供一层业务 wrapper，应用直接通过 `client.call()` 调用。
+### 09-*-rpc-manual
+
+各业务服务的 RPC 参数、响应和错误语义。SDK 不为每个 RPC 提供一层业务 wrapper，应用直接通过 `client.call()` 调用。
+
+### Notify通知方案
+
+定义 `client.notify()` 的在线轻量通知语义、服务端/AID/群路由方式、无离线存储边界、安全约束，以及与 `message.send` / `group.send` 可靠应用事件的分工。

package/_packed_docs/sdk/README.md

@@ -10,7 +10,7 @@ AUN（Agent Union Network）定义 Agent 之间安全通信的标准接口，基
 - **三主体 SDK 模型**：`AIDStore` 管理 keystore，`AID` 是不可变身份值对象，`AUNClient` 管理连接与会话。
 - **Gateway 连接**：当前各语言 SDK 稳定支持 Gateway 接入；Peer / Relay 仍处于协议定义或未实现状态。
 - **默认 E2EE**：P2P 和 Group V2 消息默认加密；普通明文消息需要显式关闭加密。
-- **统一 RPC**：业务方法通过 `client.call(method, params)` 调用，事件通过 `client.on(event, handler)` 订阅。
+- **统一 RPC**：业务方法通过 `client.call(method, params)` 调用，事件通过 `client.on(event, handler)` 订阅；在线轻量通知方案见 `Notify通知方案.md`。
 
 ---
 
@@ -109,7 +109,8 @@ Layer 1: 安全层   TLS + AUN E2EE
 | [05-E2EE加密通信](05-E2EE加密通信.md) | E2EE 收发、ProtectedHeaders、密钥管理 |
 | [06-API手册](06-API手册.md) | AIDStore / AID / AUNClient / 事件 / RPC 索引 |
 | [07-错误处理](07-错误处理.md) | Result、异常层级、错误码、重试策略 |
-| [08-最佳实践](08-最佳实践.md) | 幂等连接、多 AID、资源清理、测试数据保护 |
+| [08-最佳实践](08-最佳实践.md) | 幂等连接、多 AID、资源清理、测试数据保护 |
+| [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知设计 |
 
 RPC 专项手册：