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

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # 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:
 #   pnpm run verify-translation-pairing --write packages/experimental/agent-team/README.md
-README.md: 1dba55aaef5c2f061de85de3b38cf5c644fa90b7
-README.zh.md: 749f5b9d27ed863639a6dabad80254c9a19727dd
+README.md: 6ae7d82214ca9e041324e353057ba6850675c043
+README.zh.md: 89176c285a8bd9d5a1875618dffb0b2eb4890a3e

package/README.md

@@ -60,7 +60,7 @@ The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-a
 
 Ask the Lead to create a teammate: give it a unique lowercase name such as `reviewer` and describe its job. A teammate starts fresh with no memory of the Lead's conversation, or as a fork that inherits the Lead's completed turns; the creation request chooses which. Teammate names are permanent — even a teammate whose creation failed keeps its name, and no name is ever reused.
 
-The roster shows every member with its role (`lead` or `teammate`) and current status: `running`, `idle`, `inactive` (a member that exists but is not loaded), `provisioning`, or `failed`. A member that is not loaded receives its messages when it wakes.
+The roster shows every member with its role (`lead` or `teammate`) and current status: `running`, `inactive` (no turn is executing, whether loaded or stored), `provisioning`, or `failed`. A member that is not loaded receives its messages when it wakes.
 
 Only the Lead can create teammates or interrupt them.
 
@@ -68,7 +68,7 @@ Only the Lead can create teammates or interrupt them.
 
 Any member can send a message to any other member or to the Lead. A live member receives it immediately; an offline member's messages queue and arrive when it resumes. Messages are never lost and never delivered twice.
 
-Every message uses Steer: a running target receives it at the nearest step boundary, an idle target starts a turn, and an inactive teammate cold-resumes. The sender always sees the outcome — accepted by the target inbox, or retained as queued when delivery is temporarily unavailable. A queued message is already safely stored, so it must not be resent.
+Every message uses Steer: a running target receives it at the nearest step boundary; an inactive target starts a turn if loaded or cold-resumes otherwise. The sender always sees the outcome — accepted by the target inbox, or retained as queued when delivery is temporarily unavailable. A queued message is already safely stored, so it must not be resent.
 
 ### Shared task board
 
@@ -145,6 +145,10 @@ Tasks are complete versioned snapshots; every mutation carries `expectedRevision
 
 Team events are appended to the exact live Lead Session and flushed before the operation reports success or wakes waiters. `team/member`, `team/task`, `team/message/queued`, and `team/message/delivered` are log-only: they never enter the conversation surface, so derived model history is untouched by coordination records. Session event `seq` and `time` own ordering and timing; snapshots do not duplicate them. The `./invariant` companion replays each candidate Team event against its committed prefix and rejects invalid transitions before append.
 
+Native V4 Team event and checkpoint admission reject retired `tool-result` content before it can enter mailbox state. Historical conversion belongs to the Session-format migration; the Team projection does not convert old wrappers.
+
+Mailbox projection and checkpoint admission preserve every decoded JSON field of accepted content outside the locally declared validators, including an own `__proto__` key. Local field checks cover `text`, `reasoning`, `image`, and `tool-call`; accepted unknown tags remain opaque. Team projection cache version 4 rebuilds checkpoints from earlier cache versions from the Session log; the Session format version is unchanged.
+
 ### Disposal
 
 Disposal closes admission, aborts and awaits admitted creation and mailbox-dispatch transactions, then asks the continuation owner to release the roster's exact live direct children and their descendants; non-Team continuable children of the Lead remain untouched. Cleanup failures make disposal fail visibly, bounded by `disposalTimeoutMs`.
@@ -169,7 +173,7 @@ Read these pages when the package-level contract is not enough. They move from t
 
 ### Browser Remote
 
-`TeamService` owns the generated `agentTeams/view`, `agentTeams/createTask`, and `agentTeams/updateTask` Remote methods beside the roster, mailbox, task, and lifecycle operations. The `./remote` export supplies the Client contribution mounted by the Web UI, while `./client` re-exports the request, view, and task-mutation result types that are safe in a browser compilation face. Typert retains transport failures in its outer `RemoteResult`; create and update rejections remain explicit domain results inside a successful transport response, with stale update revisions distinguished as task conflicts.
+`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.
 
 ## Model Experience
 
@@ -198,7 +202,7 @@ These limits describe what a team cannot do yet or what needs special operationa
 - **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.
 - **Flat immutable roster** — only the Lead creates direct teammates; there is no nested Team, rename, deletion, or name reuse.
-- **No automatic ownership release** — idle, interruption, process exit, and failed work do not release a task owner.
+- **No automatic ownership release** — inactivity, interruption, process exit, and failed work do not release a task owner.
 - **Mailbox is not cross-process exactly-once** — concurrent harness processes over one Team are unsupported.
 
 <a id="dev-note"></a>

package/README.zh.md

@@ -60,7 +60,7 @@ kind: "package-reference"
 
 请 Lead 创建 teammate：给它一个唯一的小写名字（例如 `reviewer`）并描述其职责。teammate 可以 fresh 启动（不携带 Lead 对话的任何记忆），也可以作为 fork 启动（继承 Lead 已完成的轮次）；创建请求决定用哪种。teammate 名字是永久的——即使创建失败的 teammate 也保留其名字，任何名字都不会被复用。
 
-roster 显示每个成员的职责（`lead` 或 `teammate`）与当前状态：`running`、`idle`、`inactive`（存在但未加载的成员）、`provisioning` 或 `failed`。未加载的成员会在唤醒后收到其消息。
+roster 显示每个成员的职责（`lead` 或 `teammate`）与当前状态：`running`、`inactive`（当前没有执行轮次，包括已加载和仅存储的成员）、`provisioning` 或 `failed`。未加载的成员会在唤醒后收到其消息。
 
 只有 Lead 可以创建 teammate 或中断它们。
 
@@ -68,7 +68,7 @@ roster 显示每个成员的职责（`lead` 或 `teammate`）与当前状态：`
 
 任何成员都可以向任何其他成员或 Lead 发送消息。live 成员会立即收到；离线成员的消息会排队，并在其恢复后到达。消息不会丢失，也不会重复投递。
 
-每条消息都使用 Steer：running target 在最近的步骤边界收到消息，idle target 启动一个轮次，inactive teammate 则冷恢复。发送方始终能看到结果——target inbox 已接受，或在投递暂时不可用时保留为 queued。排队的消息已经安全存储，因此绝不能重发。
+每条消息都使用 Steer：running target 在最近的步骤边界收到消息，inactive target 在已加载时启动一个轮次，否则冷恢复。发送方始终能看到结果——target inbox 已接受，或在投递暂时不可用时保留为 queued。排队的消息已经安全存储，因此绝不能重发。
 
 ### 共享任务板
 
@@ -145,6 +145,10 @@ Lead 可以停止 teammate 的当前轮次，而不会删除其排队的消息
 
 Team 事件追加到精确的 live Lead 会话，并在操作报告成功或唤醒等待者之前 flush。`team/member`、`team/task`、`team/message/queued` 与 `team/message/delivered` 仅存在于日志：它们从不进入会话表面，因此派生模型历史不受协作记录影响。顺序与时间由会话事件的 `seq` 与 `time` 负责，快照不重复保存。`./invariant` 伴生插件把每条候选 Team 事件对照已提交前缀回放，并在 append 前拒绝非法转换。
 
+原生 V4 的 Team 事件及检查点准入会拒绝退役的 `tool-result` 内容，防止它进入邮箱状态。历史转换由 Session 格式迁移负责，Team 投影不转换旧包装。
+
+Mailbox 投影与 checkpoint 准入保留本地声明的校验器之外获准内容中全部已解码 JSON 字段，包括自有 `__proto__` 键。本地字段检查覆盖 `text`、`reasoning`、`image` 和 `tool-call`；获准的未知标签保持不透明。Team 投影缓存版本 4 从 Session 日志重建较早缓存版本的 checkpoint；Session 格式版本保持不变。
+
 ### Dispose
 
 dispose 会关闭准入、中止并等待已获准的创建与 mailbox dispatch 事务，再让 continuation owner 释放 roster 中确切的 live direct child 及其后代；Lead 的非 Team continuable child 不受影响。cleanup 失败会让 dispose 明确失败，并以 `disposalTimeoutMs` 为上限。
@@ -169,7 +173,7 @@ dispose 会关闭准入、中止并等待已获准的创建与 mailbox dispatch
 
 ### 浏览器 Remote
 
-`TeamService` 除了 roster、mailbox、task 与 lifecycle operation，还拥有生成的 `agentTeams/view`、`agentTeams/createTask` 与 `agentTeams/updateTask` Remote method。`./remote` 导出由 Web UI 挂载的 Client contribution，`./client` 则重新导出可在浏览器 compilation face 中安全使用的 request、view 与 task mutation result type。Typert 在外层 `RemoteResult` 中保留 transport failure；create 与 update rejection 则作为 transport 成功响应中的显式 domain result，其中过期的 update revision 会区分为 task conflict。
+`TeamService` 向浏览器客户端公开只读的 `agentTeams/view` Remote method。任务创建与更新由 Team agent 通过服务和模型工具执行。`./remote` 导出由 Web UI 挂载的 Client contribution，`./client` 导出可供浏览器使用的成员与任务视图。
 
 ## 模型体验
 
@@ -198,7 +202,7 @@ Peer 消息追加在 target 可复用历史前缀之后。冷恢复会先复用
 - **单进程、共享 checkout**——成员共享 cwd，修改立即可见；本包不提供 worktree、远端成员、merge 或文件锁。
 - **write scope 仅作提示**——Bash、formatter、代码生成器与直接外部写入可以绕过文件版本检查；Lead 必须协调 owner 并检查最终 diff。
 - **扁平且不可变的 roster**——只有 Lead 可以创建直接 teammate；不支持嵌套 Team、重命名、删除或名字复用。
-- **不会自动释放 owner**——idle、interrupt、进程退出与工作失败都不会释放任务 owner。
+- **不会自动释放 owner**——成员不活动、interrupt、进程退出与工作失败都不会释放任务 owner。
 - **mailbox 不保证跨进程 exactly-once**——不支持多个 harness 进程并发操作同一 Team。
 
 <a id="dev-note"></a>

package/lib/index.js

@@ -440,7 +440,7 @@ var TeamRoster = class {
 			id: root.id,
 			name: "lead",
 			role: "lead",
-			status: root.status,
+			status: availability(root),
 			...root.options.model === void 0 ? {} : { model: root.options.model },
 			diagnostics: []
 		}];
@@ -451,7 +451,7 @@ var TeamRoster = class {
 				id: member.id,
 				name: member.name,
 				role: "teammate",
-				status: member.phase === "failed" ? "failed" : member.phase === "provisioning" ? "provisioning" : live?.status ?? "inactive",
+				status: member.phase === "failed" ? "failed" : member.phase === "provisioning" ? "provisioning" : availability(live),
 				description: member.description,
 				provider: member.provider,
 				context: member.context,
@@ -508,7 +508,7 @@ var TeamRoster = class {
 		if (target.id === membership.root.id) throw new TeamError("the Team Lead cannot interrupt itself", "TEAM_INVALID_TARGET");
 		const live = this.ctx.agents.get(target.id);
 		if (live === void 0) return { previousStatus: "inactive" };
-		const previousStatus = live.status;
+		const previousStatus = availability(live);
 		this.ctx.subagents.interrupt(target.id, {
 			kind: "ancestor",
 			agent: caller
@@ -691,7 +691,7 @@ var TeamRoster = class {
 			id: member.id,
 			name: member.name,
 			role: "teammate",
-			status: live?.status ?? "inactive",
+			status: availability(live),
 			description: member.description,
 			provider: member.provider,
 			context: member.context,
@@ -724,6 +724,10 @@ var TeamRoster = class {
 		return foldSubagentDescriptor(agent.session.snapshotEvents(agent.session.inheritedEventCount)) !== void 0;
 	}
 };
+/** Turn availability is independent of whether the Agent is loaded. */
+function availability(agent) {
+	return agent?.status === "running" ? "running" : "inactive";
+}
 //#endregion
 //#region lib/types/mailbox.js
 /** Durable Team mailbox admission, target-local dispatch, acknowledgement, and recovery. */
@@ -1083,13 +1087,11 @@ const contentBlockSchema = z$1.lazy(() => z$1.union([
 		name: z$1.string(),
 		arguments: z$1.string()
 	}).strict(),
-	z$1.object({
-		type: z$1.literal("tool-result"),
-		toolCallId: z$1.string().min(1),
-		content: z$1.array(contentBlockSchema),
-		isError: z$1.boolean().optional()
-	}).strict(),
-	z$1.object({ type: z$1.string().min(1) }).loose().refine((block) => !coreContentBlockTypes.has(block.type), { message: "known content block types must match their declared fields" })
+	z$1.custom((value) => {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+		const type = value.type;
+		return typeof type === "string" && type.length > 0 && !coreContentBlockTypes.has(type);
+	})
 ]));
 const teamMemberSnapshotSchema = z$1.object({
 	id: sessionIdSchema,
@@ -1282,7 +1284,7 @@ function applyCurrentTeamEvent(state, event) {
 /** Host-only Team projection selected by the projected Session identity. */
 const teamProjectionDefinition = {
 	key: "agentTeam",
-	stateVersion: 3,
+	stateVersion: 4,
 	stateSchema: teamProjectionEntrySchema,
 	init: (header) => emptyTeamState(header.id),
 	apply: (state, event) => {
@@ -1606,14 +1608,10 @@ let TeamService = (() => {
 	let _classSuper = TypertRemoteService;
 	let _instanceExtraInitializers = [];
 	let _remoteView_decorators;
-	let _remoteCreateTask_decorators;
-	let _remoteUpdateTask_decorators;
 	return class TeamService extends _classSuper {
 		static {
 			const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
 			_remoteView_decorators = [Remote("view")];
-			_remoteCreateTask_decorators = [Remote("createTask")];
-			_remoteUpdateTask_decorators = [Remote("updateTask")];
 			__esDecorate(this, null, _remoteView_decorators, {
 				kind: "method",
 				name: "remoteView",
@@ -1625,28 +1623,6 @@ let TeamService = (() => {
 				},
 				metadata: _metadata
 			}, null, _instanceExtraInitializers);
-			__esDecorate(this, null, _remoteCreateTask_decorators, {
-				kind: "method",
-				name: "remoteCreateTask",
-				static: false,
-				private: false,
-				access: {
-					has: (obj) => "remoteCreateTask" in obj,
-					get: (obj) => obj.remoteCreateTask
-				},
-				metadata: _metadata
-			}, null, _instanceExtraInitializers);
-			__esDecorate(this, null, _remoteUpdateTask_decorators, {
-				kind: "method",
-				name: "remoteUpdateTask",
-				static: false,
-				private: false,
-				access: {
-					has: (obj) => "remoteUpdateTask" in obj,
-					get: (obj) => obj.remoteUpdateTask
-				},
-				metadata: _metadata
-			}, null, _instanceExtraInitializers);
 			if (_metadata) Object.defineProperty(this, Symbol.metadata, {
 				enumerable: true,
 				configurable: true,
@@ -1823,42 +1799,6 @@ let TeamService = (() => {
 				tasks: this.listTasks(agent)
 			};
 		}
-		/**
-		* Create one shared task through the generated Remote API.
-		* @param agent - exact live Team member creating the task.
-		* @param request - task text, blockers, and advisory write scopes.
-		* @returns the revision-one task or a typed Team rejection.
-		*/
-		remoteCreateTask(agent, request) {
-			return this.taskMutationResult(this.createTask(agent, request));
-		}
-		/**
-		* Apply one task mutation and preserve Team rejections as business results.
-		* @param agent - exact live Team member authorizing the mutation.
-		* @param request - task identity, expected revision, action, and action fields.
-		* @returns the committed task or a typed Team rejection.
-		*/
-		remoteUpdateTask(agent, request) {
-			return this.taskMutationResult(this.updateTask(agent, request));
-		}
-		/** Preserve Team task rejections while allowing unexpected failures to reject the Remote call. */
-		async taskMutationResult(operation) {
-			try {
-				return {
-					ok: true,
-					value: await operation
-				};
-			} catch (error) {
-				if (!(error instanceof TeamError)) throw error;
-				return {
-					ok: false,
-					error: {
-						code: error.code === "TEAM_TASK_STALE_REVISION" ? "team-task-conflict" : "team-rejected",
-						message: error.message
-					}
-				};
-			}
-		}
 		/** Queue one contained recovery pass after publication has unwound. */
 		scheduleRecovery(agent) {
 			queueMicrotask(() => {

package/lib/invariant.js

@@ -128,13 +128,11 @@ const contentBlockSchema = z.lazy(() => z.union([
 		name: z.string(),
 		arguments: z.string()
 	}).strict(),
-	z.object({
-		type: z.literal("tool-result"),
-		toolCallId: z.string().min(1),
-		content: z.array(contentBlockSchema),
-		isError: z.boolean().optional()
-	}).strict(),
-	z.object({ type: z.string().min(1) }).loose().refine((block) => !coreContentBlockTypes.has(block.type), { message: "known content block types must match their declared fields" })
+	z.custom((value) => {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+		const type = value.type;
+		return typeof type === "string" && type.length > 0 && !coreContentBlockTypes.has(type);
+	})
 ]));
 const teamMemberSnapshotSchema = z.object({
 	id: sessionIdSchema,
@@ -327,7 +325,7 @@ function applyCurrentTeamEvent(state, event) {
 /** Host-only Team projection selected by the projected Session identity. */
 const teamProjectionDefinition = {
 	key: "agentTeam",
-	stateVersion: 3,
+	stateVersion: 4,
 	stateSchema: teamProjectionEntrySchema,
 	init: (header) => emptyTeamState(header.id),
 	apply: (state, event) => {