@deepseek-ai/dsh-experimental-agent-team 0.1.7-alpha.2 → 0.1.7-rc.2

package/README.i18n.yaml

@@ -1,6 +1,100 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/experimental/agent-team/README.md
-README.md: 6ae7d82214ca9e041324e353057ba6850675c043
-README.zh.md: 89176c285a8bd9d5a1875618dffb0b2eb4890a3e
+/:
+  en: 6dbca19f6b32549f
+  zh: dae9c49eab8f6fee
+/deepseek-ai-dsh-experimental-agent-team:
+  en: b28084855adcdabd
+  zh: 59e3d49c3d63baf9
+/deepseek-ai-dsh-experimental-agent-team/summary:
+  en: 5b981abe3a308e53
+  zh: 7116e552a40dc79f
+/deepseek-ai-dsh-experimental-agent-team/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/deepseek-ai-dsh-experimental-agent-team/use-this-package:
+  en: 4cafc368a3abea63
+  zh: 396189cbdc47b1f5
+/deepseek-ai-dsh-experimental-agent-team/use-this-package/when-to-choose-it:
+  en: 8da318ac2f4343d7
+  zh: b31a399d6e3fd64e
+/deepseek-ai-dsh-experimental-agent-team/use-this-package/smallest-working-setup:
+  en: 4fccad6758905210
+  zh: 9037ddb1dc4b2666
+/deepseek-ai-dsh-experimental-agent-team/use-this-package/teammates:
+  en: 5a314d1f80ecd31b
+  zh: c34e6a93dd1e2045
+/deepseek-ai-dsh-experimental-agent-team/use-this-package/messages-between-teammates:
+  en: 2c45b2c18c8317e7
+  zh: d4ab2259f976b19d
+/deepseek-ai-dsh-experimental-agent-team/use-this-package/shared-task-board:
+  en: 73682f0d2001b517
+  zh: 3744d82eb3b7fcb9
+/deepseek-ai-dsh-experimental-agent-team/use-this-package/waiting-and-interruption:
+  en: f8e38ccf6295b375
+  zh: 44f008e23613c0af
+/deepseek-ai-dsh-experimental-agent-team/use-this-package/what-success-and-failure-look-like:
+  en: 0d523eb8ffe0a928
+  zh: 270b2502db285ed8
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation:
+  en: 6a18034f1ccc247a
+  zh: e08b0eb0ccb41ea8
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation/design-philosophy:
+  en: c08e8eb5bbac71ae
+  zh: d6fb32f1243a28d6
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation/source-map:
+  en: 53e2dda7c2adb34c
+  zh: 562590e3d42c029e
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation/team-identity-and-roster:
+  en: 85f97723e45e43de
+  zh: def66721e21339cc
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation/durable-mailbox:
+  en: 26041ce90cc48a35
+  zh: 677d85f22969f941
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation/shared-task-board:
+  en: 2dc37ba97a8a7178
+  zh: 96bd24033030e19d
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation/waiting-and-interruption:
+  en: 3becd36b407aac95
+  zh: c9e4895ee59696bb
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation/durability-model:
+  en: 66dcbc543f2d3576
+  zh: cd8de23c555696df
+/deepseek-ai-dsh-experimental-agent-team/understand-the-implementation/disposal:
+  en: 3ae69e3b7905cffe
+  zh: 0fb159101f6d646b
+/deepseek-ai-dsh-experimental-agent-team/further-exploration:
+  en: 2bbfd4ffbaeedd00
+  zh: d1afb5d320b469a1
+/deepseek-ai-dsh-experimental-agent-team/further-exploration/browser-projection:
+  en: 4b3033806e6db528
+  zh: 53e0dfef7309840e
+/deepseek-ai-dsh-experimental-agent-team/model-experience:
+  en: 215e7ba838619b7b
+  zh: a311da3843709f90
+/deepseek-ai-dsh-experimental-agent-team/model-experience/peer-messages:
+  en: 7a72088145dd45ec
+  zh: 6763071c604c2edd
+/deepseek-ai-dsh-experimental-agent-team/model-experience/peer-messages/what-the-model-sees:
+  en: 4f9110ba058f25cd
+  zh: cf820293929ea993
+/deepseek-ai-dsh-experimental-agent-team/model-experience/peer-messages/token-effect:
+  en: 37ec43beac34a6ad
+  zh: 6cdcd89ccceea815
+/deepseek-ai-dsh-experimental-agent-team/model-experience/peer-messages/kv-cache-effect:
+  en: ff845d434b857afe
+  zh: 04479bddf7650ede
+/deepseek-ai-dsh-experimental-agent-team/known-limitations-and-deferred-work:
+  en: 777abba6e3b496eb
+  zh: 2b8cd95e73f5e369
+/deepseek-ai-dsh-experimental-agent-team/known-limitations-and-deferred-work/dev-note:
+  en: 498e4cf9fe5741a7
+  zh: 9d2bab630e655c99
+/deepseek-ai-dsh-experimental-agent-team/known-limitations-and-deferred-work/dev-note/promotion:
+  en: 3d126e3b1015e4ce
+  zh: 22f0d18e2ce5c30f
+/deepseek-ai-dsh-experimental-agent-team/known-limitations-and-deferred-work/dev-note/future-directions:
+  en: 38eadeacd73b9c02
+  zh: 05c5b55022e0b8d9

package/README.md

@@ -118,7 +118,8 @@ The [Agent Teams Agent Note](../../../.agents/notes/implemented/feature/2026-08-
 | [`src/mailbox.ts`](src/mailbox.ts) | Durable queue, target-local dispatch, acknowledgement, and recovery |
 | [`src/task-board.ts`](src/task-board.ts) | Task CAS commands, DAG validation, and derived views |
 | [`src/journal.ts`](src/journal.ts) | Serialized Lead-log transactions and commit notification |
-| [`src/projection.ts`](src/projection.ts) | Strict replay projection that decodes and validates Team events |
+| [`src/projection.ts`](src/projection.ts) | Strict replay projection that decodes and validates Team events and publishes the `agentTeam` client view |
+| [`src/task-view.ts`](src/task-view.ts) | Pure task readiness, owner-name, and write-overlap derivation shared by the task board and the client view |
 | [`src/activity.ts`](src/activity.ts) | One-shot change waiters and disposal release |
 | [`src/lifecycle.ts`](src/lifecycle.ts) | Shared admission cutoff and bounded settlement |
 | [`src/invariant.ts`](src/invariant.ts) | Invariant companion that replays candidate events before append |
@@ -171,9 +172,11 @@ Read these pages when the package-level contract is not enough. They move from t
 
 <a id="model-experience"></a>
 
-### Browser Remote
+### Browser projection
 
-`TeamService` exposes the read-only `agentTeams/view` Remote method for browser clients. Task creation and updates belong to Team agents through the service and model tools. The `./remote` export supplies the Client contribution mounted by the Web UI, while `./client` exports browser-safe roster and task views.
+The `agentTeam` Session projection publishes the Lead Session's durable roster identities and phases, member errors, non-deleted task views, and any `failure` beside the last valid state. Its `apply` replaces only the touched collection; mailbox-only changes retain the client view reference and produce no frame. The [subsystem reference](../../../docs/subsystems/agent-team.md#web-projection) defines the wire types.
+
+The [Web UI](../client-ui-agent-team/README.md) reads the shared Session projections and overlays activity from Session status. Task creation and updates belong to Team agents through the service and model tools. The `./client` export supplies browser-safe roster, task, and projection types.
 
 ## Model Experience
 
@@ -198,6 +201,7 @@ Peer messages append after the target's reusable history prefix. Cold resume reu
 
 These limits describe what a team cannot do yet or what needs special operational care. They are current package constraints, not a comparison with other coordination mechanisms.
 
+- **Whole-view broadcasts** — each roster or task change sends the complete roster and non-deleted task board, including descriptions, to every connected browser, even when it is viewing another Session.
 - **Experimental prototype with no stability promise** — the package is public, but its contracts can change freely while it incubates.
 - **One process and one shared checkout** — members share cwd and observe edits immediately; this package provides no worktree, remote member, merge, or filesystem lock.
 - **Advisory write scopes** — Bash, formatters, code generators, and direct external writers can bypass filesystem version checks; Leads must coordinate ownership and review the final diff.

package/README.zh.md

@@ -118,7 +118,8 @@ Lead 可以停止 teammate 的当前轮次，而不会删除其排队的消息
 | [`src/mailbox.ts`](src/mailbox.ts) | 持久队列、目标本地投递、确认与恢复 |
 | [`src/task-board.ts`](src/task-board.ts) | 任务 CAS 命令、DAG 校验与派生视图 |
 | [`src/journal.ts`](src/journal.ts) | 串行化的 Lead 日志事务与提交通知 |
-| [`src/projection.ts`](src/projection.ts) | 解码并校验 Team 事件的严格回放投影 |
+| [`src/projection.ts`](src/projection.ts) | 解码并校验 Team 事件、发布 `agentTeam` 客户端视图的严格回放投影 |
+| [`src/task-view.ts`](src/task-view.ts) | 任务板与客户端视图共用的纯任务派生：就绪状态、owner 名称与写入范围重叠 |
 | [`src/activity.ts`](src/activity.ts) | 一次性变更等待者与 dispose（资源释放）时的等待解除 |
 | [`src/lifecycle.ts`](src/lifecycle.ts) | 共享准入截止与有界结算 |
 | [`src/invariant.ts`](src/invariant.ts) | 在 append 前回放候选事件的不变式伴生插件 |
@@ -171,9 +172,11 @@ dispose 会关闭准入、中止并等待已获准的创建与 mailbox dispatch
 
 <a id="model-experience"></a>
 
-### 浏览器 Remote
+### 浏览器投影
 
-`TeamService` 向浏览器客户端公开只读的 `agentTeams/view` Remote method。任务创建与更新由 Team agent 通过服务和模型工具执行。`./remote` 导出由 Web UI 挂载的 Client contribution，`./client` 导出可供浏览器使用的成员与任务视图。
+`agentTeam` Session 投影发布 Lead Session 的持久成员身份与阶段、成员错误、未删除任务视图，以及最后有效状态旁的 `failure`。其 `apply` 只替换被触及的集合；仅邮箱的变化保留客户端视图引用，不产生 frame。[子系统参考](../../../docs/subsystems/agent-team.zh.md#web-projection) 定义传输类型。
+
+[Web UI](../client-ui-agent-team/README.zh.md) 读取共享 Session 投影，并从 Session 状态叠加活动信息。任务创建与更新由 Team agent 通过服务和模型工具完成。`./client` 导出可供浏览器使用的 roster、任务与投影类型。
 
 ## 模型体验
 
@@ -198,6 +201,7 @@ Peer 消息追加在 target 可复用历史前缀之后。冷恢复会先复用
 
 这些限制说明一支团队目前不能做什么、或哪些方面需要特别的运维关注。它们是当前包约束，不是与其他协作机制的对比。
 
+- **完整视图广播** — 每次 roster 或任务变化都会把完整 roster 和未删除任务板（含描述）发给所有已连接浏览器，即使它正在查看其他 Session。
 - **实验原型，无稳定性承诺**——本包公开发布，但孵化期间约定仍可自由变更。
 - **单进程、共享 checkout**——成员共享 cwd，修改立即可见；本包不提供 worktree、远端成员、merge 或文件锁。
 - **write scope 仅作提示**——Bash、formatter、代码生成器与直接外部写入可以绕过文件版本检查；Lead 必须协调 owner 并检查最终 diff。