@khorsheed/dsh-local-agent 0.2.0-rc.3 → 0.2.0

package/lib/member-bridge.js

@@ -21,15 +21,22 @@ const MEMBER_BRIDGE_TOKEN_ENV = "DSH_MEMBER_TOKEN";
 * it bare: `node <this file>`, with the socket path and token in its
 * environment (written into the CLI's scoped MCP config by the provider).
 * Covers the MCP handshake subset a client needs: `initialize`,
-* `notifications/initialized`, `ping`, `tools/list`, `tools/call`.
+* `notifications/initialized`, `ping`, `tools/list`, `tools/call`. A member
+* with a mode also gets that preset's plugin tools: `tools/list` asks the
+* host for them and any other tool name is forwarded as a mode-tool call.
 * @module @khorsheed/dsh-local-agent/member-bridge
 */
 /** The one tool this server exposes. */
 const MEMBER_MESSAGE_TOOL = "member_message";
 const TOOL_DESCRIPTION = [
-	"Notify another CLI member of this room/session group (member-to-member message).",
-	"`to` is the target member's dsh child session id (or a member name when a room manages the group).",
-	"The delivery receipt is returned verbatim: sent / pending-confirm / busy / an error reason."
+	"Send a message to another member of this room/session group.",
+	"`to` is the member name (or its dsh child session id).",
+	"kind \"task\" (default) hands it work: in a room, its final reply is reported back to you automatically, citing the message id — do not poll.",
+	"kind \"notify\" is an FYI and is never reported back. Pass inReplyTo (e.g. m12) when answering a message.",
+	"Never sleep or poll for the result (room_read included): end your turn, the report arrives on its own.",
+	"Writing \"@name\" in a reply reaches nobody; only this tool does.",
+	"Optional note: what you will wait for before acting on the result; optional task: \"new\" or a task number from room_read.",
+	"The receipt is returned verbatim: sent #m<id> … / pending-confirm … / busy / an error reason."
 ].join(" ");
 const TOOL_SCHEMA = {
 	type: "object",
@@ -40,7 +47,24 @@ const TOOL_SCHEMA = {
 		},
 		text: {
 			type: "string",
-			description: "The notification text, delivered with your provenance."
+			description: "The message text, delivered with your provenance."
+		},
+		kind: {
+			type: "string",
+			enum: ["task", "notify"],
+			description: "task (default): the reply is reported back to you; notify: FYI only."
+		},
+		inReplyTo: {
+			type: "string",
+			description: "Optional id of the message this answers, e.g. m12."
+		},
+		note: {
+			type: "string",
+			description: "Optional: what you will wait for before acting on the result (the room uses it to decide when to hand you the report)."
+		},
+		task: {
+			type: "string",
+			description: "Optional: \"new\" or a task number from room_read; omit to stay in the task you are working on."
 		}
 	},
 	required: ["to", "text"],
@@ -62,7 +86,7 @@ const ROOM_TOOLS = [
 	},
 	{
 		name: "room_read",
-		description: "Read your room roster, coordinator, deliveries, recent outcomes and available harness providers. Identity comes from the host.",
+		description: "Read your room: roster with roles, coordinator, tasks with their numbers, deliveries, recent outcomes and available harness providers. Identity comes from the host. Use it to look around, not to wait for a result.",
 		inputSchema: {
 			type: "object",
 			properties: {},
@@ -77,27 +101,128 @@ const ROOM_TOOLS = [
 			properties: {
 				provider: { type: "string" },
 				name: { type: "string" },
-				instructions: { type: "string" },
+				note: {
+					type: "string",
+					description: "What you will wait for before acting on the first task result."
+				},
+				role: {
+					type: "string",
+					description: "Short public role (≤30 chars) the other members see, e.g. 代码审查."
+				},
+				instructions: {
+					type: "string",
+					description: "Private instructions only this member reads."
+				},
 				cwd: { type: "string" },
 				model: { type: "string" },
-				firstTask: { type: "string" }
+				firstTask: { type: "string" },
+				mode: {
+					type: "string",
+					description: "The member's dsh mode (a host preset id, e.g. dsh-gamedev). Omit to keep this room's own mode; \"none\" for only its own CLI tools."
+				}
 			},
 			required: ["provider", "name"],
 			additionalProperties: false
 		}
 	},
+	{
+		name: "ask_user_question",
+		description: "Ask the human questions they answer by picking options (or typing), instead of writing the questions into your reply. Use it whenever you need the human to decide or fill in something before you go on: give each question 2-4 short options with a one-line description each. The call waits for the answer and returns {answers:[{id, selected:[labels], custom?}]}; if nobody answers it fails — then go on with your best judgement and say what you assumed.",
+		inputSchema: {
+			type: "object",
+			properties: { questions: {
+				type: "array",
+				description: "At most 4 questions.",
+				items: {
+					type: "object",
+					properties: {
+						id: {
+							type: "string",
+							description: "Short unique id, echoed in the answer."
+						},
+						question: {
+							type: "string",
+							description: "The full question."
+						},
+						header: {
+							type: "string",
+							description: "Optional 2-6 word topic chip."
+						},
+						options: {
+							type: "array",
+							items: {
+								type: "object",
+								properties: {
+									label: { type: "string" },
+									description: { type: "string" }
+								},
+								required: ["label"]
+							}
+						},
+						multi_select: {
+							type: "boolean",
+							description: "True when several options may be picked."
+						}
+					},
+					required: ["id", "question"]
+				}
+			} },
+			required: ["questions"],
+			additionalProperties: false
+		}
+	},
 	{
 		name: "room_message",
-		description: "Coordinator only: dispatch background work to a room member by name. Returns acceptance immediately; completion arrives as a correlated report. Do not poll.",
+		description: "Send a room member a message by name (same as member_message). kind \"task\" (default): its reply comes back to you as a report citing the message id; kind \"notify\": FYI only. Do not poll.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				member: { type: "string" },
-				text: { type: "string" }
+				text: { type: "string" },
+				kind: {
+					type: "string",
+					enum: ["task", "notify"]
+				},
+				inReplyTo: { type: "string" },
+				note: {
+					type: "string",
+					description: "What you will wait for before acting on the result."
+				},
+				task: {
+					type: "string",
+					description: "\"new\" or a task number; omit to stay in your current task."
+				}
 			},
 			required: ["member", "text"],
 			additionalProperties: false
 		}
+	},
+	{
+		name: "room_help",
+		description: "Ask another session outside this room for help — typically the one that built what you are stuck on. It works in its own session (a busy one queues you); its final answer plus a short handoff comes back to you on its own, so end your turn after asking and do not poll. Name the session by title, id or the @ mention the human wrote; a session that is another room goes to its coordinator, or to the member you name. The first ask of a session the human did not @ in the room waits for their approval. To answer its question or ask more, call again with the help id and no session.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				session: {
+					type: "string",
+					description: "The session to ask (title, id, or @ mention). Omit when continuing a thread."
+				},
+				member: {
+					type: "string",
+					description: "When the session is another room: the member to ask. Omit to let its coordinator decide."
+				},
+				help: {
+					type: "string",
+					description: "The help id of an existing thread."
+				},
+				text: {
+					type: "string",
+					description: "What you need, self-contained: the helper does not see this room."
+				}
+			},
+			required: ["text"],
+			additionalProperties: false
+		}
 	}
 ];
 async function callRoomCommand(env, name, args) {
@@ -116,6 +241,35 @@ async function callRoomCommand(env, name, args) {
 		return toolText(`Room command unavailable: ${String(error)}`, true);
 	}
 }
+/** The member's mode tools (the preset's plugin tools), empty when it has none or the host is unreachable. */
+async function listModeTools(env) {
+	if (env.socket === void 0 || env.token === void 0) return [];
+	try {
+		const outcome = await callHost(env.socket, {
+			token: env.token,
+			modeTools: { list: true }
+		});
+		return outcome.ok && Array.isArray(outcome.tools) ? outcome.tools : [];
+	} catch {
+		return [];
+	}
+}
+/** Run one mode tool on the host; the host's MCP result passes through. */
+async function callModeTool(env, name, args) {
+	if (env.socket === void 0 || env.token === void 0) return toolText("member channel is not configured for this run", true);
+	try {
+		const outcome = await callHost(env.socket, {
+			token: env.token,
+			modeTools: { call: {
+				name,
+				arguments: args
+			} }
+		});
+		return outcome.ok && outcome.result !== void 0 ? outcome.result : toolText(outcome.error ?? `Tool ${name} failed`, true);
+	} catch (error) {
+		return toolText(`Mode tool unavailable: ${String(error)}`, true);
+	}
+}
 /** One socket round trip: send the request line, read the one-line response. */
 function callHost(socket, payload) {
 	return new Promise((resolve, reject) => {
@@ -163,7 +317,11 @@ async function callMemberMessage(env, args) {
 		const outcome = await callHost(env.socket, {
 			token: env.token,
 			to: args.to,
-			text: args.text
+			text: args.text,
+			...args.kind === "task" || args.kind === "notify" ? { kind: args.kind } : {},
+			...typeof args.inReplyTo === "string" ? { inReplyTo: args.inReplyTo } : {},
+			...typeof args.note === "string" ? { note: args.note } : {},
+			...typeof args.task === "string" ? { task: args.task } : {}
 		});
 		if (outcome.ok) return toolText(outcome.receipt ?? "sent");
 		return toolText(outcome.error ?? "member channel rejected the message", true);
@@ -229,15 +387,19 @@ function serveMemberBridge(env, input, output) {
 				});
 				return;
 			case "tools/list":
-				write({
+				listModeTools(env).then((modeTools) => write({
 					jsonrpc: "2.0",
 					id: id ?? null,
-					result: { tools: [{
-						name: MEMBER_MESSAGE_TOOL,
-						description: TOOL_DESCRIPTION,
-						inputSchema: TOOL_SCHEMA
-					}, ...ROOM_TOOLS] }
-				});
+					result: { tools: [
+						{
+							name: MEMBER_MESSAGE_TOOL,
+							description: TOOL_DESCRIPTION,
+							inputSchema: TOOL_SCHEMA
+						},
+						...ROOM_TOOLS,
+						...modeTools.filter((tool) => tool["name"] !== "member_message" && !ROOM_TOOLS.some((room) => room.name === tool["name"]))
+					] }
+				}));
 				return;
 			case "tools/call": {
 				const params = request.params;
@@ -250,14 +412,22 @@ function serveMemberBridge(env, input, output) {
 					return;
 				}
 				if (params?.name !== "member_message") {
-					write({
+					if (typeof params?.name !== "string") {
+						write({
+							jsonrpc: "2.0",
+							id: id ?? null,
+							error: {
+								code: -32602,
+								message: "tools/call requires a tool name"
+							}
+						});
+						return;
+					}
+					callModeTool(env, params.name, params.arguments ?? {}).then((result) => write({
 						jsonrpc: "2.0",
 						id: id ?? null,
-						error: {
-							code: -32602,
-							message: `unknown tool ${String(params?.name)}`
-						}
-					});
+						result
+					}));
 					return;
 				}
 				callMemberMessage(env, params.arguments ?? {}).then((result) => {
@@ -295,4 +465,4 @@ if (isMain()) serveMemberBridge({
 	token: process.env[MEMBER_BRIDGE_TOKEN_ENV]
 }, process.stdin, process.stdout);
 //#endregion
-export { MEMBER_MESSAGE_TOOL, callMemberMessage, callRoomCommand, serveMemberBridge };
+export { MEMBER_MESSAGE_TOOL, callMemberMessage, callModeTool, callRoomCommand, listModeTools, serveMemberBridge };

package/lib/typert.host.js

@@ -15,7 +15,7 @@ let _khorsheed_dsh_local_agent_localAgentGateway_cancelMemberConfiguration_resul
 const _khorsheed_dsh_local_agent_localAgentGateway_cancelMemberConfiguration_result$schema = () => (_khorsheed_dsh_local_agent_localAgentGateway_cancelMemberConfiguration_result$schema$value ??= z.object({
   'requestId': z.string(),
   'revision': z.number(),
-  'status': z.union([z.literal("cancelled"), z.literal("failed"), z.literal("pending"), z.literal("applied"), z.literal("locked"), z.literal("applying"), z.literal("unsupported"), z.literal("conflict")]),
+  'status': z.union([z.literal("cancelled"), z.literal("failed"), z.literal("pending"), z.literal("applied"), z.literal("conflict"), z.literal("unsupported"), z.literal("locked"), z.literal("applying")]),
   'error': z.string().optional(),
 }))
 let _khorsheed_dsh_local_agent_localAgentGateway_checkEndpoint_parameter_0$schema$value
@@ -1106,7 +1106,7 @@ let _khorsheed_dsh_local_agent_localAgentGateway_selectMemberConfiguration_resul
 const _khorsheed_dsh_local_agent_localAgentGateway_selectMemberConfiguration_result$schema = () => (_khorsheed_dsh_local_agent_localAgentGateway_selectMemberConfiguration_result$schema$value ??= z.object({
   'requestId': z.string(),
   'revision': z.number(),
-  'status': z.union([z.literal("cancelled"), z.literal("failed"), z.literal("pending"), z.literal("applied"), z.literal("locked"), z.literal("applying"), z.literal("unsupported"), z.literal("conflict")]),
+  'status': z.union([z.literal("cancelled"), z.literal("failed"), z.literal("pending"), z.literal("applied"), z.literal("conflict"), z.literal("unsupported"), z.literal("locked"), z.literal("applying")]),
   'error': z.string().optional(),
 }))
 let _khorsheed_dsh_local_agent_localAgentGateway_sessions_parameter_0$schema$value
@@ -1363,7 +1363,7 @@ const $remote = createTypertRemoteInfo({
         typeSymbol: '@khorsheed/dsh-local-agent/types#LocalAgentControlReceipt',
         create: _khorsheed_dsh_local_agent_localAgentGateway_cancelMemberConfiguration_result$schema,
         schema: _khorsheed_dsh_local_agent_localAgentGateway_cancelMemberConfiguration_result$schema(),
-        jsonSchema: {"type":"object","properties":{"requestId":{"type":"string"},"revision":{"type":"number"},"status":{"type":"string","enum":["cancelled","failed","pending","applied","locked","applying","unsupported","conflict"]},"error":{"type":"string"}},"required":["requestId","revision","status"],"additionalProperties":true},
+        jsonSchema: {"type":"object","properties":{"requestId":{"type":"string"},"revision":{"type":"number"},"status":{"type":"string","enum":["cancelled","failed","pending","applied","conflict","unsupported","locked","applying"]},"error":{"type":"string"}},"required":["requestId","revision","status"],"additionalProperties":true},
       },
       sourceLocation: {"file":"packages/local-agent/src/gateway.ts","line":414,"column":9},
     },
@@ -2399,7 +2399,7 @@ const $remote = createTypertRemoteInfo({
         typeSymbol: '@khorsheed/dsh-local-agent/types#LocalAgentControlReceipt',
         create: _khorsheed_dsh_local_agent_localAgentGateway_selectMemberConfiguration_result$schema,
         schema: _khorsheed_dsh_local_agent_localAgentGateway_selectMemberConfiguration_result$schema(),
-        jsonSchema: {"type":"object","properties":{"requestId":{"type":"string"},"revision":{"type":"number"},"status":{"type":"string","enum":["cancelled","failed","pending","applied","locked","applying","unsupported","conflict"]},"error":{"type":"string"}},"required":["requestId","revision","status"],"additionalProperties":true},
+        jsonSchema: {"type":"object","properties":{"requestId":{"type":"string"},"revision":{"type":"number"},"status":{"type":"string","enum":["cancelled","failed","pending","applied","conflict","unsupported","locked","applying"]},"error":{"type":"string"}},"required":["requestId","revision","status"],"additionalProperties":true},
       },
       sourceLocation: {"file":"packages/local-agent/src/gateway.ts","line":409,"column":9},
     },
@@ -2970,7 +2970,7 @@ export const TYPERT = {
             "name": "resume",
             "signature": "async resume( parentSessionId: string, provider: string, childSessionId: string, prompt: ContentBlock[], options?: DelegationCallOptions, ): Promise<SubagentRun>",
             "summary": "Resume a recorded delegation: continue the SAME CLI session inside the SAME dsh child session.",
-            "jsDoc": "/**\n * Resume a recorded delegation: continue the SAME CLI session inside the\n * SAME dsh child session. One call performs, in order:\n *\n * 1. provider pre-check (`ctx.subagents.getProvider`) — fails loud WITHOUT\n *    staging, so an unknown provider never leaves an orphan intent;\n * 2. `resolveDelegation` ownership check (unchanged semantics): the handle\n *    must name a delegation THIS parent session recorded through THIS\n *    provider;\n * 3. read-only resume-lock probe ({@link isResumeLocked}) — fails fast\n *    without staging; the provider still takes the authoritative lock inside\n *    its `start()`;\n * 4. live parent agent resolution (`ctx.agents.get`) — a harness hard\n *    constraint, since `ctx.subagents.startActivation` requires a live parent;\n * 5. child-session REATTACH when `ctx.sessions.get(childSessionId)` is\n *    undefined (recipe below; `opts.reattach === false` disables this step\n *    and fails loud on a non-live child instead);\n * 6. stage `{ kind: 'resume', childSessionId, cliSessionId }` and, in the\n *    same synchronous flow, `await ctx.subagents.startActivation({…})`;\n * 7. on start failure, roll the intent back via\n *    {@link unstageDelegationIntent} (no-op once consumed);\n * 8. on success, track the run under `childSessionId` for {@link cancel}\n *    until `run.result` settles.\n *\n * **Reattach recipe** (callers replicating this flow — e.g. room — copy\n * exactly this sequence):\n *\n * ```ts\n * const handle = await ctx.sessionPersistence.open(SessionId(childSessionId), 'write')\n * try {\n *   const cold = await handle.read(0)\n *   const session = ctx.sessions.prepare(SessionId(childSessionId), {\n *     seed: [...cold.events],\n *     meta: structuredClone(handle.header),\n *     inheritedEventCount: handle.inheritedEventCount,\n *     eventState: cold.eventState,\n *   })\n *   // The seeded constructor's session/end-seed marker lands before enter()\n *   // installs publication hooks — push the unstored suffix through the\n *   // handle directly, or the writer's contiguous cursor diverges.\n *   const unstored = session.snapshotEvents().slice(cold.events.length)\n *   if (unstored.length > 0) await handle.append(unstored)\n *   const detach = ctx.sessions.enter(session)\n *   try { ctx.sessions.announce(session) }\n *   catch (error) { detach(); throw error }\n *   // Hold BOTH for the reattached lifetime: the backend routes live\n *   // session/event appends into the per-id writer only while the write\n *   // handle is open; closing it ends persistence for the session.\n * } catch (error) {\n *   await handle.close().catch(() => {})\n *   throw error\n * }\n * ```\n *\n * Hold `detach` and `handle` for the plugin lifetime. Announce the restored\n * live session after entering it, rolling back detach if announcement fails.\n * History followers need this lifecycle edge to replay the constructor's\n * end-seed suffix before the provider publishes subsequent events.\n * @param parentSessionId - the delegating parent session id; must match the\n *   recorded one and have a live agent.\n * @param provider - the `ctx.subagents` provider that owns the CLI session.\n * @param childSessionId - the dsh child session id from the first round (the\n *   resume handle).\n * @param prompt - the follow-up user message content blocks.\n * @param options - optional label and caller-owned abort signal.\n * @returns the published subagent run.\n * @throws on unknown provider, unknown/foreign-parent/wrong-provider handle,\n *   an in-flight resume of the same child, or a missing live parent agent —\n *   all BEFORE anything is staged.\n */"
+            "jsDoc": "/**\n * Resume a recorded delegation: continue the SAME CLI session inside the\n * SAME dsh child session. One call performs, in order:\n *\n * 1. provider pre-check (`ctx.subagents.getProvider`) — fails loud WITHOUT\n *    staging, so an unknown provider never leaves an orphan intent;\n * 2. `resolveDelegation` ownership check (unchanged semantics): the handle\n *    must name a delegation THIS parent session recorded through THIS\n *    provider;\n * 3. read-only resume-lock probe ({@link isResumeLocked}) — fails fast\n *    without staging; the provider still takes the authoritative lock inside\n *    its `start()`;\n * 4. live parent agent resolution (`ctx.agents.get`) — a harness hard\n *    constraint, since `ctx.subagents.startActivation` requires a live parent;\n * 5. child-session REATTACH when `ctx.sessions.get(childSessionId)` is\n *    undefined (recipe below; `opts.reattach === false` disables this step\n *    and fails loud on a non-live child instead);\n * 6. stage `{ kind: 'resume', childSessionId, cliSessionId }` and, in the\n *    same synchronous flow, `await ctx.subagents.startActivation({…})`;\n * 7. on start failure, roll the intent back via\n *    {@link unstageDelegationIntent} (no-op once consumed);\n * 8. on success, track the run under `childSessionId` for {@link cancel}\n *    until `run.result` settles.\n *\n * **Reattach recipe** (callers replicating this flow — e.g. room — copy\n * exactly this sequence):\n *\n * ```ts\n * const handle = await ctx.sessionPersistence.open(SessionId(childSessionId), 'write')\n * try {\n *   const cold = await handle.read(0)\n *   // Close a turn a restart interrupted, or the next round's turn/start\n *   // makes the stored log unreadable.\n *   const closers = interruptedTurnClosers(cold.events)\n *   if (closers.length > 0) await handle.append(closers)\n *   const session = ctx.sessions.prepare(SessionId(childSessionId), {\n *     seed: [...cold.events, ...closers],\n *     meta: structuredClone(handle.header),\n *     inheritedEventCount: handle.inheritedEventCount,\n *     eventState: cold.eventState,\n *   })\n *   // The seeded constructor's session/end-seed marker lands before enter()\n *   // installs publication hooks — push the unstored suffix through the\n *   // handle directly, or the writer's contiguous cursor diverges.\n *   const unstored = session.snapshotEvents().slice(cold.events.length + closers.length)\n *   if (unstored.length > 0) await handle.append(unstored)\n *   const detach = ctx.sessions.enter(session)\n *   try { ctx.sessions.announce(session) }\n *   catch (error) { detach(); throw error }\n *   // Hold BOTH for the reattached lifetime: the backend routes live\n *   // session/event appends into the per-id writer only while the write\n *   // handle is open; closing it ends persistence for the session.\n * } catch (error) {\n *   await handle.close().catch(() => {})\n *   throw error\n * }\n * ```\n *\n * Hold `detach` and `handle` for the plugin lifetime. Announce the restored\n * live session after entering it, rolling back detach if announcement fails.\n * History followers need this lifecycle edge to replay the constructor's\n * end-seed suffix before the provider publishes subsequent events.\n * @param parentSessionId - the delegating parent session id; must match the\n *   recorded one and have a live agent.\n * @param provider - the `ctx.subagents` provider that owns the CLI session.\n * @param childSessionId - the dsh child session id from the first round (the\n *   resume handle).\n * @param prompt - the follow-up user message content blocks.\n * @param options - optional label and caller-owned abort signal.\n * @returns the published subagent run.\n * @throws on unknown provider, unknown/foreign-parent/wrong-provider handle,\n *   an in-flight resume of the same child, or a missing live parent agent —\n *   all BEFORE anything is staged.\n */"
           },
           {
             "kind": "method",
@@ -3559,7 +3559,7 @@ export const TYPERT = {
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'runtime-context': { kind: 'runtime-context'; } & ContextFormed;\n    'working-directory': { kind: 'working-directory'; };\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; principal?: Principal; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    'team-message': TeamMessageSource;\n    'user-question-reply': { kind: 'user-question-reply'; callId: ToolCallId; outcome: 'answered'; };\n    goal: GoalMessageSource;\n    'plan-mode': { kind: 'plan-mode'; } & ContextFormed;\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'session-reference': SessionReferenceSource;\n    webhook: { readonly kind: 'webhook'; readonly provider: string; readonly source: WebhookSourceId; readonly deliveryId: WebhookDeliveryId; readonly ruleId: WebhookRuleId; readonly form: 'notice'; readonly summary: string; };\n    'message-tools': { kind: 'message-tools'; readonly op?: MessageToolsOp; } & ContextFormed;\n    'dsh-game': { kind: 'dsh-game'; plugin: '@khorsheed/dsh-game'; } & ContextFormed & Partial<GameMessageOp>;\n    room: { kind: 'room'; } & ContextFormed;\n    sidechat: { kind: 'sidechat'; } & ContextFormed;\n    worktrees: { kind: 'worktrees'; } & ContextFormed;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'runtime-context': { kind: 'runtime-context'; } & ContextFormed;\n    'working-directory': { kind: 'working-directory'; };\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; principal?: Principal; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    'team-message': TeamMessageSource;\n    'user-question-reply': { kind: 'user-question-reply'; callId: ToolCallId; outcome: 'answered'; };\n    goal: GoalMessageSource;\n    'plan-mode': { kind: 'plan-mode'; } & ContextFormed;\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'session-reference': SessionReferenceSource;\n    webhook: { readonly kind: 'webhook'; readonly provider: string; readonly source: WebhookSourceId; readonly deliveryId: WebhookDeliveryId; readonly ruleId: WebhookRuleId; readonly form: 'notice'; readonly summary: string; };\n    'message-tools': { kind: 'message-tools'; readonly op?: MessageToolsOp; } & ContextFormed;\n    'dsh-game': { kind: 'dsh-game'; plugin: '@khorsheed/dsh-game'; } & ContextFormed & Partial<GameMessageOp>;\n    room: { kind: 'room'; } & ContextFormed;\n    'room-help': { kind: 'room-help'; plugin: '@khorsheed/dsh-room'; help: string; room: string; roomTitle: string; from: string; op: 'request' | 'message'; text: string; } & ContextFormed;\n    sidechat: { kind: 'sidechat'; } & ContextFormed;\n    worktrees: { kind: 'worktrees'; } & ContextFormed;\n}"
           },
           {
             "name": "MessageToolsOp",
@@ -3645,6 +3645,14 @@ export const TYPERT = {
             "name": "RetryId",
             "declaration": "export type RetryId = Branded<'RetryId'>;"
           },
+          {
+            "name": "RoomApprovalEvent",
+            "declaration": "export interface RoomApprovalEvent {\n    readonly id: string;\n    readonly member: string;\n    readonly memberId: string;\n    readonly tool: string;\n    readonly reason?: string;\n}"
+          },
+          {
+            "name": "RoomApprovalResolvedEvent",
+            "declaration": "export interface RoomApprovalResolvedEvent {\n    readonly id: string;\n    readonly outcome: 'allowed-once' | 'rejected' | 'cancelled';\n}"
+          },
           {
             "name": "RoomCoordinatorEvent",
             "declaration": "export interface RoomCoordinatorEvent {\n    readonly version: 1;\n    readonly memberId: string;\n    readonly revision: number;\n    readonly previousMemberId: string;\n    readonly handoff: string;\n}"
@@ -3653,29 +3661,77 @@ export const TYPERT = {
             "name": "RoomCreatedEvent",
             "declaration": "export interface RoomCreatedEvent {\n    readonly version: 1;\n}"
           },
+          {
+            "name": "RoomDecisionCall",
+            "declaration": "export interface RoomDecisionCall {\n    readonly model: string;\n    readonly latencyMs?: number;\n    readonly cached?: boolean;\n    readonly inputTokens?: number;\n    readonly outputTokens?: number;\n    readonly request: { readonly state: RoomJsonValue; readonly questions: RoomJsonValue; };\n    readonly response?: RoomJsonValue;\n    readonly failure?: { readonly reason: string; readonly detail?: string; };\n}"
+          },
+          {
+            "name": "RoomDecisionEvent",
+            "declaration": "export interface RoomDecisionEvent {\n    readonly id: string;\n    readonly scenario: RoomDecisionScenario;\n    readonly outcome: string;\n    readonly rule?: string;\n    readonly probability?: number;\n    readonly call?: RoomDecisionCall;\n    readonly about: { readonly message?: string; readonly task?: { readonly number: number; readonly title: string; }; readonly from?: string; readonly to?: string; };\n}"
+          },
+          {
+            "name": "RoomDecisionScenario",
+            "declaration": "export type RoomDecisionScenario = 'task-filing' | 'report-timing';"
+          },
           {
             "name": "RoomDeliveryStateEvent",
             "declaration": "export interface RoomDeliveryStateEvent {\n    readonly id: string;\n    readonly dispatchSeq: number;\n    readonly memberId: string;\n    readonly state: 'running' | 'done' | 'cancelled' | 'failed' | 'uncertain';\n    readonly text?: string;\n    readonly error?: string;\n}"
           },
           {
             "name": "RoomDispatchEvent",
-            "declaration": "export interface RoomDispatchEvent {\n    readonly plan?: { readonly goalId: string; readonly taskId?: string; readonly attemptId?: string; };\n    readonly requestSignature?: string;\n    readonly id?: string;\n    readonly targetIds?: readonly string[];\n    readonly origin?: 'human' | 'coordinator' | 'report' | 'relay';\n    readonly replyTo?: string;\n    readonly reportFor?: string;\n    readonly targets: readonly string[];\n    readonly text: string;\n}"
+            "declaration": "export interface RoomDispatchEvent {\n    readonly plan?: { readonly goalId: string; readonly taskId?: string; readonly attemptId?: string; };\n    readonly requestSignature?: string;\n    readonly id?: string;\n    readonly targetIds?: readonly string[];\n    readonly origin?: 'human' | 'coordinator' | 'member' | 'report' | 'relay' | 'help';\n    readonly help?: RoomHelpOrigin;\n    readonly from?: string;\n    readonly kind?: 'task' | 'notify';\n    readonly hop?: number;\n    readonly inReplyTo?: number;\n    readonly note?: string;\n    readonly held?: true;\n    readonly releases?: readonly number[];\n    readonly task?: string;\n    readonly parent?: string;\n    readonly replyTo?: string;\n    readonly reportFor?: string;\n    readonly targets: readonly string[];\n    readonly text: string;\n}"
           },
           {
             "name": "RoomExecutionMetadataEvent",
-            "declaration": "export interface RoomExecutionMetadataEvent {\n    readonly runId: string;\n    readonly model?: string;\n    readonly effort?: string;\n    readonly tokens?: number;\n}"
+            "declaration": "export interface RoomExecutionMetadataEvent {\n    readonly runId: string;\n    readonly model?: string;\n    readonly effort?: string;\n    readonly tokens?: number;\n    readonly usage?: RoomRunUsage;\n}"
           },
           {
             "name": "RoomGoalEvent",
             "declaration": "export interface RoomGoalEvent {\n    readonly text: string;\n}"
           },
+          {
+            "name": "RoomHeldDispatch",
+            "declaration": "export interface RoomHeldDispatch {\n    readonly origin: 'coordinator' | 'member' | 'report' | 'help';\n    readonly help?: RoomHelpOrigin;\n    readonly from?: string;\n    readonly kind?: 'task' | 'notify';\n    readonly hop: number;\n    readonly inReplyTo?: number;\n    readonly replyTo?: string;\n    readonly reportFor?: string;\n    readonly plan?: { readonly goalId: string; };\n    readonly note?: string;\n    readonly task?: string;\n    readonly parent?: string;\n}"
+          },
+          {
+            "name": "RoomHelpEvent",
+            "declaration": "export interface RoomHelpEvent {\n    readonly id: string;\n    readonly from: string;\n    readonly fromName: string;\n    readonly target: { readonly sessionId: string; readonly title: string; readonly room?: true; readonly member?: string; };\n    readonly text: string;\n}"
+          },
+          {
+            "name": "RoomHelpInEvent",
+            "declaration": "export interface RoomHelpInEvent extends RoomHelpOrigin {\n    readonly member: string;\n    readonly text: string;\n    readonly op: 'request' | 'message';\n    readonly held?: true;\n}"
+          },
+          {
+            "name": "RoomHelpMessageEvent",
+            "declaration": "export interface RoomHelpMessageEvent {\n    readonly help: string;\n    readonly kind: 'question' | 'reply' | 'message';\n    readonly text: string;\n    readonly handoff?: string;\n    readonly fallback?: true;\n}"
+          },
+          {
+            "name": "RoomHelpOrigin",
+            "declaration": "export interface RoomHelpOrigin {\n    readonly id: string;\n    readonly room: string;\n    readonly roomTitle: string;\n    readonly from: string;\n}"
+          },
+          {
+            "name": "RoomHelpStateEvent",
+            "declaration": "export interface RoomHelpStateEvent {\n    readonly help: string;\n    readonly state: RoomHelpStatus;\n    readonly error?: string;\n}"
+          },
+          {
+            "name": "RoomHelpStatus",
+            "declaration": "export type RoomHelpStatus = 'queued' | 'running' | 'asking' | 'replied' | 'failed';"
+          },
+          {
+            "name": "RoomHoldReason",
+            "declaration": "export type RoomHoldReason = 'confirm' | 'hop-limit' | 'paused';"
+          },
+          {
+            "name": "RoomJobStoppedEvent",
+            "declaration": "export interface RoomJobStoppedEvent {\n    readonly task: string;\n}"
+          },
           {
             "name": "RoomJsonValue",
             "declaration": "export type RoomJsonValue = null | boolean | number | string | RoomJsonValue[] | { [key: string]: RoomJsonValue; };"
           },
           {
             "name": "RoomMemberAddedEvent",
-            "declaration": "export interface RoomMemberAddedEvent {\n    readonly id?: string;\n    readonly name: string;\n    readonly kind: 'main-agent' | 'cli';\n    readonly provider?: string;\n    readonly instructions?: string;\n    readonly invitedBy: 'human' | 'agent';\n    readonly cwd?: string;\n    readonly model?: string;\n    readonly childSessionId?: SessionId;\n}"
+            "declaration": "export interface RoomMemberAddedEvent {\n    readonly id?: string;\n    readonly name: string;\n    readonly kind: 'main-agent' | 'cli' | 'native';\n    readonly provider?: string;\n    readonly preset?: string;\n    readonly instructions?: string;\n    readonly role?: string;\n    readonly invitedBy: 'human' | 'agent';\n    readonly cwd?: string;\n    readonly model?: string;\n    readonly effort?: string;\n    readonly childSessionId?: SessionId;\n}"
           },
           {
             "name": "RoomMemberRemovedEvent",
@@ -3683,27 +3739,59 @@ export const TYPERT = {
           },
           {
             "name": "RoomMemberUpdatedEvent",
-            "declaration": "export interface RoomMemberUpdatedEvent {\n    readonly name: string;\n    readonly rename?: string;\n    readonly instructions?: string | null;\n    readonly cwd?: string | null;\n    readonly model?: string | null;\n    readonly childSessionId?: SessionId;\n}"
+            "declaration": "export interface RoomMemberUpdatedEvent {\n    readonly name: string;\n    readonly rename?: string;\n    readonly instructions?: string | null;\n    readonly role?: string | null;\n    readonly cwd?: string | null;\n    readonly model?: string | null;\n    readonly effort?: string | null;\n    readonly childSessionId?: SessionId;\n}"
           },
           {
             "name": "RoomPlan",
             "declaration": "export interface RoomPlan {\n    version: 1;\n    id: string;\n    revision: number;\n    objective: string;\n    status: 'draft' | 'running' | 'paused' | 'completed' | 'cancelled';\n    reason?: string;\n    budget: PlanBudget;\n    activeMs: number;\n    resumedAt?: number;\n    stages: { id: string; title: string; }[];\n    tasks: PlanTask[];\n    completion?: PlanEvidence;\n    requests: { id: string; signature: string; }[];\n}"
           },
+          {
+            "name": "RoomQuestionAnswer",
+            "declaration": "export interface RoomQuestionAnswer {\n    readonly id: string;\n    readonly selected: readonly string[];\n    readonly custom?: string;\n}"
+          },
+          {
+            "name": "RoomQuestionEvent",
+            "declaration": "export interface RoomQuestionEvent {\n    readonly id: string;\n    readonly member: string;\n    readonly memberId: string;\n    readonly questions: readonly RoomQuestionItem[];\n}"
+          },
+          {
+            "name": "RoomQuestionItem",
+            "declaration": "export interface RoomQuestionItem {\n    readonly id: string;\n    readonly question: string;\n    readonly header?: string;\n    readonly options?: readonly RoomQuestionOption[];\n    readonly multiSelect?: boolean;\n}"
+          },
+          {
+            "name": "RoomQuestionOption",
+            "declaration": "export interface RoomQuestionOption {\n    readonly label: string;\n    readonly description?: string;\n}"
+          },
+          {
+            "name": "RoomQuestionResolvedEvent",
+            "declaration": "export interface RoomQuestionResolvedEvent {\n    readonly id: string;\n    readonly outcome: 'answered' | 'cancelled';\n    readonly answers?: readonly RoomQuestionAnswer[];\n}"
+          },
           {
             "name": "RoomRelayEvent",
-            "declaration": "export interface RoomRelayEvent {\n    readonly id: string;\n    readonly from: string;\n    readonly to: string;\n    readonly content: string;\n    readonly provenance?: Record<string, RoomJsonValue>;\n}"
+            "declaration": "export interface RoomRelayEvent {\n    readonly id: string;\n    readonly from: string;\n    readonly to: string;\n    readonly content: string;\n    readonly provenance?: Record<string, RoomJsonValue>;\n    readonly reason?: RoomHoldReason;\n    readonly intent?: RoomHeldDispatch;\n}"
           },
           {
             "name": "RoomRelayResolvedEvent",
             "declaration": "export interface RoomRelayResolvedEvent {\n    readonly id: string;\n    readonly state: 'confirmed' | 'dismissed' | 'sent';\n}"
           },
+          {
+            "name": "RoomReportGateEvent",
+            "declaration": "export interface RoomReportGateEvent {\n    readonly dispatchSeq: number;\n    readonly memberId: string;\n    readonly member: string;\n    readonly verdict: 'deliver' | 'hold' | 'release';\n    readonly reason: string;\n    readonly probability?: number;\n}"
+          },
           {
             "name": "RoomRunStateEvent",
-            "declaration": "export interface RoomRunStateEvent {\n    readonly childSessionId?: SessionId;\n    readonly model?: string;\n    readonly effort?: string;\n    readonly tokens?: number;\n    readonly runId?: string;\n    readonly member: string;\n    readonly state: 'running' | 'done' | 'cancelled' | 'failed';\n    readonly startedAt: number;\n    readonly elapsedMs?: number;\n    readonly error?: string;\n}"
+            "declaration": "export interface RoomRunStateEvent {\n    readonly childSessionId?: SessionId;\n    readonly childTurn?: number;\n    readonly model?: string;\n    readonly effort?: string;\n    readonly tokens?: number;\n    readonly runId?: string;\n    readonly member: string;\n    readonly state: 'running' | 'done' | 'cancelled' | 'failed';\n    readonly startedAt: number;\n    readonly elapsedMs?: number;\n    readonly error?: string;\n}"
+          },
+          {
+            "name": "RoomRunUsage",
+            "declaration": "export interface RoomRunUsage {\n    readonly inputTokens: number;\n    readonly outputTokens: number;\n    readonly cacheReadTokens?: number;\n    readonly cacheWriteTokens?: number;\n    readonly reasoningTokens?: number;\n}"
+          },
+          {
+            "name": "RoomSettingsEvent",
+            "declaration": "export interface RoomSettingsEvent {\n    readonly memberMessages?: 'free' | 'confirm';\n    readonly hopLimit?: number;\n    readonly paused?: boolean;\n    readonly reportTiming?: 'judge' | 'each';\n    readonly autoTaskFiling?: boolean;\n    readonly reportThreshold?: number;\n    readonly reportWaitMinutes?: number;\n    readonly helpReminderMinutes?: number;\n}"
           },
           {
             "name": "RoomSpeechEvent",
-            "declaration": "export interface RoomSpeechEvent {\n    readonly interrupted?: 'cancelled' | 'failed';\n    readonly member: string;\n    readonly text: string;\n    readonly childSessionId?: SessionId;\n    readonly durationMs?: number;\n}"
+            "declaration": "export interface RoomSpeechEvent {\n    readonly interrupted?: 'cancelled' | 'failed';\n    readonly reportedTo?: string;\n    readonly member: string;\n    readonly text: string;\n    readonly childSessionId?: SessionId;\n    readonly durationMs?: number;\n    readonly runId?: string;\n    readonly messageId?: string;\n}"
           },
           {
             "name": "RoomTaskAddedEvent",
@@ -3711,7 +3799,11 @@ export const TYPERT = {
           },
           {
             "name": "RoomTaskEditedEvent",
-            "declaration": "export interface RoomTaskEditedEvent {\n    readonly id: string;\n    readonly title?: string;\n    readonly blockedBy?: string | null;\n}"
+            "declaration": "export interface RoomTaskEditedEvent {\n    readonly id: string;\n    readonly title?: string;\n    readonly blockedBy?: string | null;\n    readonly member?: string;\n}"
+          },
+          {
+            "name": "RoomTaskLinkEvent",
+            "declaration": "export interface RoomTaskLinkEvent {\n    readonly message: string;\n    readonly task: string;\n    readonly by: 'human' | 'coordinator' | 'model';\n    readonly probability?: number;\n}"
           },
           {
             "name": "RoomTaskUpdatedEvent",
@@ -3751,7 +3843,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'working-directory/change': { cwd: string; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'job/registered': JobRegisteredData;\n    'job/settled': JobSettledData;\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'permission/preset': { preset: string; };\n    'subagent/descriptor': SubagentDescriptorData;\n    'subagent/catalog': SubagentCatalogEvent;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n    'feedback/record': FeedbackRecord;\n    'llm/retry': LlmRetryEventData;\n    'llm/retry-started': LlmRetryStartedEventData;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'plan/mode': { active: boolean; };\n    'schedule/change': ScheduleChange;\n    'subagent/model-selection-policy': { allowedModels: AllowedModelRoute[]; };\n    'workspace/changes': { turn: number; };\n    'local-agent/stream': LocalAgentStreamCheckpoint;\n    'room/created': RoomCreatedEvent;\n    'room/member-added': RoomMemberAddedEvent;\n    'room/member-updated': RoomMemberUpdatedEvent;\n    'room/member-removed': RoomMemberRemovedEvent;\n    'room/dispatch': RoomDispatchEvent;\n    'room/speech': RoomSpeechEvent;\n    'room/run-state': RoomRunStateEvent;\n    'room/execution-metadata': RoomExecutionMetadataEvent;\n    'room/relay': RoomRelayEvent;\n    'room/relay-resolved': RoomRelayResolvedEvent;\n    'room/task-added': RoomTaskAddedEvent;\n    'room/task-updated': RoomTaskUpdatedEvent;\n    'room/task-edited': RoomTaskEditedEvent;\n    'room/goal': RoomGoalEvent;\n    'room/plan-state': RoomPlan;\n    'room/coordinator': RoomCoordinatorEvent;\n    'room/delivery-state': RoomDeliveryStateEvent;\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'working-directory/change': { cwd: string; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'job/registered': JobRegisteredData;\n    'job/settled': JobSettledData;\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'permission/preset': { preset: string; };\n    'subagent/descriptor': SubagentDescriptorData;\n    'subagent/catalog': SubagentCatalogEvent;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n    'feedback/record': FeedbackRecord;\n    'llm/retry': LlmRetryEventData;\n    'llm/retry-started': LlmRetryStartedEventData;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'plan/mode': { active: boolean; };\n    'schedule/change': ScheduleChange;\n    'subagent/model-selection-policy': { allowedModels: AllowedModelRoute[]; };\n    'workspace/changes': { turn: number; };\n    'local-agent/stream': LocalAgentStreamCheckpoint;\n    'room/created': RoomCreatedEvent;\n    'room/member-added': RoomMemberAddedEvent;\n    'room/member-updated': RoomMemberUpdatedEvent;\n    'room/member-removed': RoomMemberRemovedEvent;\n    'room/dispatch': RoomDispatchEvent;\n    'room/speech': RoomSpeechEvent;\n    'room/run-state': RoomRunStateEvent;\n    'room/execution-metadata': RoomExecutionMetadataEvent;\n    'room/relay': RoomRelayEvent;\n    'room/relay-resolved': RoomRelayResolvedEvent;\n    'room/approval': RoomApprovalEvent;\n    'room/approval-resolved': RoomApprovalResolvedEvent;\n    'room/question': RoomQuestionEvent;\n    'room/question-resolved': RoomQuestionResolvedEvent;\n    'room/task-added': RoomTaskAddedEvent;\n    'room/task-updated': RoomTaskUpdatedEvent;\n    'room/task-edited': RoomTaskEditedEvent;\n    'room/goal': RoomGoalEvent;\n    'room/settings': RoomSettingsEvent;\n    'room/report-gate': RoomReportGateEvent;\n    'room/decision': RoomDecisionEvent;\n    'room/task-link': RoomTaskLinkEvent;\n    'room/job-stopped': RoomJobStoppedEvent;\n    'room/help': RoomHelpEvent;\n    'room/help-message': RoomHelpMessageEvent;\n    'room/help-state': RoomHelpStateEvent;\n    'room/help-in': RoomHelpInEvent;\n    'room/help-link': { readonly sessionId: string; readonly title: string; };\n    'room/help-unlink': { readonly sessionId: string; };\n    'room/help-nudge-dismissed': { readonly sessionId: string; };\n    'room/plan-state': RoomPlan;\n    'room/coordinator': RoomCoordinatorEvent;\n    'room/delivery-state': RoomDeliveryStateEvent;\n}"
           },
           {
             "name": "SessionEventType",