@chatcode/chatcode-cli 3.0.4-rc.1 → 3.0.4-rc.3

package/runtime/node_modules/@deepseek-ai/dsh-tianti/lib/index.js

@@ -121,15 +121,14 @@ function environmentSwitch(name) {
 	throw new Error(`${name} must be a boolean switch.`);
 }
 /** Get tianti runtime config for Tianti operations.
-* @returns The invocation's configured endpoints and current integration switches. */
-function getTiantiRuntimeConfig() {
-	const runtime = operation().runtime;
-	const settings = getInitialSettings().tianti;
-	const enabled = environmentSwitch("TIANTI_ENABLED") ?? settings?.enabled ?? runtime.config.enabled;
+* @param runtime Mounted Tianti runtime; defaults to the current invocation.
+* @returns The runtime's configured endpoints and effective integration switches. */
+function getTiantiRuntimeConfig(runtime = operation().runtime) {
+	const enabled = environmentSwitch("TIANTI_ENABLED") ?? runtime.switches.enabled ?? runtime.config.enabled;
 	return {
 		enabled,
 		enableModelTools: enabled && runtime.config.enableModelTools,
-		enableWriteActions: environmentSwitch("TIANTI_WRITE_ACTIONS_ENABLED") ?? settings?.enableWriteActions ?? false,
+		enableWriteActions: environmentSwitch("TIANTI_WRITE_ACTIONS_ENABLED") ?? runtime.switches.enableWriteActions ?? runtime.config.enableWriteActions,
 		environment: "prod",
 		baseUrl: runtime.config.baseUrl.replace(/\/+$/u, "")
 	};
@@ -2313,7 +2312,15 @@ async function handleList(flags) {
 async function call$1(args) {
 	const parsed = parseArgs(args);
 	const [command, subCommand, third] = parsed.positionals;
-	if (!command || command === "help" || command === "-h") return text$1(help$1());
+	if (!command) return text$1([
+		`天梯功能当前${getTiantiRuntimeConfig().enabled ? "已开启（on）" : "已关闭（off）"}，默认关闭。`,
+		"",
+		"  /tianti on   打开天梯功能",
+		"  /tianti off  关闭天梯功能",
+		"",
+		"开启后可使用天梯相关功能；运行 /tianti help 查看完整命令。"
+	].join("\n"));
+	if (command === "help" || command === "-h") return text$1(help$1());
 	if (command === "status") return handleStatus$1();
 	if (command === "on" || command === "enable") {
 		await updateTiantiSettings({
@@ -4922,7 +4929,7 @@ function getLatestRunMessage() {
 	return "没有找到本地研发流程记录。可以先运行 /tianti-deliver latest 或 /tianti-deliver workitem <id> --title <title>。";
 }
 function ensureTiantiEnabled() {
-	if (!getTiantiRuntimeConfig().enabled) return "Tianti integration is off. Run /tianti on before using /tianti-deliver latest.";
+	if (!getTiantiRuntimeConfig().enabled) return "Tianti integration is off. Run /tianti on before using /tianti-deliver.";
 }
 async function createAndSaveRun(workItem, scenario) {
 	return saveDevelopmentRun(createDevelopmentRun({
@@ -4931,8 +4938,6 @@ async function createAndSaveRun(workItem, scenario) {
 	}));
 }
 async function handleLatest(flags) {
-	const disabled = ensureTiantiEnabled();
-	if (disabled) return text(disabled);
 	const workItem = latestTaskToWorkItem(await createTiantiClient().getLatestDevelopmentTaskForCurrentUser({ includeDetail: true }));
 	if (!workItem) return text("没有读取到可交付的天梯开发任务。");
 	if (isCompletedWorkItemState(workItem.stateName)) return text(`最新开发任务 ${workItem.id} 当前状态为「${workItem.stateName}」，已完成任务不会进入研发交付流程。请指定一个新建或活动中的开发任务。`);
@@ -5182,6 +5187,8 @@ async function call(args) {
 	const parsed = parseArgs(args);
 	const [command] = parsed.positionals;
 	if (!command || command === "help" || command === "-h") return text(help());
+	const disabled = ensureTiantiEnabled();
+	if (disabled) return text(disabled);
 	if (command === "latest") return handleLatest(parsed.flags);
 	if (command === "workitem" || command === "task") return handleWorkItem(parsed);
 	if (command === "status") return handleStatus(void 0, parsed.positionals[1] ?? taskIdFlag(parsed));
@@ -5218,7 +5225,7 @@ async function call(args) {
 //#region lib/types/config.js
 /** Deployment configuration for the Tianti integration. */
 const Config = z.object({
-	enabled: z.boolean().default(true),
+	enabled: z.boolean().default(false),
 	enableWriteActions: z.boolean().default(false),
 	enableModelTools: z.boolean().default(true),
 	baseUrl: z.string().default("https://devops.chinaunicom.cn"),
@@ -5251,10 +5258,10 @@ const id = {
 	required: true,
 	description: "Tianti numeric id/globalId, rather than the internal Mongo _id."
 };
-/** Install reversible model tools with invocation-owned cancellation.
+/** Install model tools for one enabled Tianti activation; its owner unregisters them on off.
 * @param ctx Harness tool registry.
 * @param runtime Plugin-owned endpoint and switch state.
-* @param signal Plugin lifetime cancellation.
+* @param signal Cancellation for this activation, aborted on off or plugin disposal.
 * @param track Track active work until plugin disposal settles.
 * @returns Registration disposers, removed before active work is drained.
 */
@@ -5397,13 +5404,18 @@ function validateEndpoint(value) {
 /** Register migrated commands without changing the agent loop or existing model providers.
 * @param ctx Harness command and tool registries.
 * @param config Deployment endpoints, switches, and timeouts.
+* @returns Startup after persisted switches and command descriptions are ready.
 */
-function apply(ctx, config) {
+async function apply(ctx, config) {
 	validateEndpoint(config.baseUrl);
 	validateEndpoint(config.cvpApiBaseUrl);
 	const runtime = new TiantiRuntime(ctx, config);
+	await runtime.loadSwitches();
 	const lifetime = new AbortController();
 	const active = /* @__PURE__ */ new Set();
+	const switchCommands = [];
+	let disposeModelTools;
+	let appliedState;
 	const track = (task) => {
 		active.add(task);
 		task.then(() => active.delete(task), () => active.delete(task));
@@ -5416,56 +5428,94 @@ function apply(ctx, config) {
 		cwd: invocation.agent.session.header.cwd ?? process.cwd()
 	}, async () => {
 		await runtime.loadSwitches();
-		return {
-			kind: "success",
-			text: (await command(invocation.rawInput)).value
-		};
+		try {
+			return {
+				kind: "success",
+				text: (await command(invocation.rawInput)).value
+			};
+		} finally {
+			refreshIntegration();
+		}
 	}));
+	const disposeSwitchCommands = () => {
+		for (const dispose of switchCommands.splice(0)) dispose();
+	};
+	const unloadModelTools = () => {
+		const disposal = disposeModelTools?.();
+		disposeModelTools = void 0;
+		runtime.auth.clear();
+		return disposal;
+	};
+	const refreshIntegration = () => {
+		if (lifetime.signal.aborted) return;
+		const enabled = getTiantiRuntimeConfig(runtime).enabled;
+		if (enabled === appliedState) return;
+		const state = enabled ? "on" : "off";
+		unloadModelTools();
+		if (enabled && config.enableModelTools) {
+			const activation = new AbortController();
+			const signal = AbortSignal.any([lifetime.signal, activation.signal]);
+			disposeModelTools = ctx.effect(function* () {
+				yield ctx.on("tools/pre-execute", async (exec, next) => {
+					if (exec.name !== "TiantiProjectSwitch") return next();
+					const decision = await next();
+					if (decision.kind !== "allow") return decision;
+					return {
+						kind: "ask",
+						reason: "Switch the shared Tianti project context.",
+						displayReason: {
+							en: "Switch the Tianti project?",
+							zh: "切换当前天梯项目？"
+						}
+					};
+				});
+				yield* installTools(ctx, runtime, signal, track);
+				yield () => {
+					activation.abort();
+				};
+			}, "enabled tianti model tools");
+		}
+		disposeSwitchCommands();
+		for (const name of ["tianti", "tt"]) switchCommands.push(ctx.commands.register({
+			name,
+			description: `天梯功能（当前：${state}，默认关闭）：on 打开，off 关闭${name === "tt" ? "（/tianti 的别名）" : ""}`,
+			handler: handler(call$1),
+			input: {
+				hint: `当前：${state} | on 打开 | off 关闭（默认关闭）`,
+				suggestions: [{
+					value: "on",
+					description: `打开天梯功能${enabled ? "（当前：on）" : ""}`
+				}, {
+					value: "off",
+					description: `关闭天梯功能${enabled ? "" : "（当前：off）"}`
+				}]
+			}
+		}));
+		appliedState = enabled;
+	};
 	ctx.effect(function* () {
 		yield async () => {
 			lifetime.abort();
 			await Promise.allSettled(active);
 			runtime.auth.clear();
 		};
-		yield ctx.on("tools/pre-execute", async (exec, next) => {
-			if (exec.name !== "TiantiProjectSwitch") return next();
-			const decision = await next();
-			if (decision.kind !== "allow") return decision;
-			return {
-				kind: "ask",
-				reason: "Switch the shared Tianti project context.",
-				displayReason: {
-					en: "Switch the Tianti project?",
-					zh: "切换当前天梯项目？"
-				}
-			};
-		});
-		for (const command of [
-			{
-				name: "tianti",
-				description: "查询天梯任务、项目、SCM 和流水线，审核外部写操作",
-				handler: handler(call$1)
-			},
-			{
-				name: "tt",
-				description: "天梯工具箱（/tianti 的别名）",
-				handler: handler(call$1)
-			},
-			{
-				name: "tianti-deliver",
-				description: "引导天梯任务从需求、验证到研发交付",
-				handler: handler(call)
-			},
-			{
-				name: "td",
-				description: "天梯研发交付（/tianti-deliver 的别名）",
-				handler: handler(call)
-			}
-		]) yield ctx.commands.register({
-			...command,
+		yield disposeSwitchCommands;
+		yield unloadModelTools;
+		refreshIntegration();
+		for (const command of [{
+			name: "tianti-deliver",
+			description: "引导天梯任务从需求、验证到研发交付",
+			handler: handler(call),
 			input: { hint: "help | status | 子命令与参数" }
-		});
-		yield* installTools(ctx, runtime, lifetime.signal, track);
+		}, {
+			name: "td",
+			description: "天梯研发交付（/tianti-deliver 的别名）",
+			handler: handler(call),
+			input: { hint: "help | status | 子命令与参数" }
+		}]) yield ctx.commands.register(command);
+		yield () => {
+			lifetime.abort();
+		};
 	}, "tianti lifecycle");
 }
 //#endregion

package/runtime/node_modules/@deepseek-ai/dsh-tianti/lib/types/config.d.ts

@@ -2,11 +2,11 @@
 import z from '@deepseek-ai/schemastery';
 /** Tianti endpoints, switches, and bounded execution settings. */
 export interface Config {
-    /** Enable Tianti resource commands without contacting the platform at boot. */
+    /** Initially enable Tianti; defaults off until the user runs /tianti on. */
     enabled: boolean;
     /** Allow execution of human-approved external write reviews. */
     enableWriteActions: boolean;
-    /** Publish model-facing Tianti query and review-proposal tools. */
+    /** Register model-facing query and review-proposal tools only while Tianti is on. */
     enableModelTools: boolean;
     /** Tianti DevOps origin; HTTPS except for loopback test deployments. */
     baseUrl: string;

package/runtime/node_modules/@deepseek-ai/dsh-tianti/lib/types/index.d.ts

@@ -7,6 +7,7 @@ export declare const inject: string[];
 /** Register migrated commands without changing the agent loop or existing model providers.
  * @param ctx Harness command and tool registries.
  * @param config Deployment endpoints, switches, and timeouts.
+ * @returns Startup after persisted switches and command descriptions are ready.
  */
-export declare function apply(ctx: Context, config: Config): void;
+export declare function apply(ctx: Context, config: Config): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/runtime/node_modules/@deepseek-ai/dsh-tianti/lib/types/services/tianti/config.d.ts

@@ -1,3 +1,4 @@
+import type { TiantiRuntime } from '../../runtime.ts';
 import type { TiantiRuntimeConfig } from './types.ts';
 /** Tianti write actions disabled message for Tianti operations.
  */
@@ -6,8 +7,9 @@ export declare const TIANTI_WRITE_ACTIONS_DISABLED_MESSAGE = "\u7814\u53D1\u5E73
  */
 export declare const TIANTI_WRITE_ACTIONS_ENABLED_MESSAGE = "\u7814\u53D1\u5E73\u53F0\u5199\u64CD\u4F5C\u6267\u884C\u6743\u9650\u5DF2\u5F00\u542F\u3002\u6240\u6709\u5916\u90E8\u5199\u64CD\u4F5C\u4ECD\u5FC5\u987B\u5148\u751F\u6210\u5BA1\u6838\u9879\uFF0C\u5E76\u901A\u8FC7 /tianti approve <reviewId> --execute \u660E\u786E\u6279\u51C6\u540E\u624D\u4F1A\u6267\u884C\u3002";
 /** Get tianti runtime config for Tianti operations.
- * @returns The invocation's configured endpoints and current integration switches. */
-export declare function getTiantiRuntimeConfig(): TiantiRuntimeConfig;
+ * @param runtime Mounted Tianti runtime; defaults to the current invocation.
+ * @returns The runtime's configured endpoints and effective integration switches. */
+export declare function getTiantiRuntimeConfig(runtime?: TiantiRuntime): TiantiRuntimeConfig;
 /** Is tianti enabled for Tianti operations.
  * @returns Whether Tianti resource operations are enabled. */
 export declare function isTiantiEnabled(): boolean;

package/runtime/node_modules/@deepseek-ai/dsh-tianti/lib/types/tools.d.ts

@@ -1,10 +1,10 @@
 /** Model-facing Tianti queries and review proposals; human commands execute writes. */
 import type { Context } from '@deepseek-ai/cordis';
 import { TiantiRuntime } from './runtime.ts';
-/** Install reversible model tools with invocation-owned cancellation.
+/** Install model tools for one enabled Tianti activation; its owner unregisters them on off.
  * @param ctx Harness tool registry.
  * @param runtime Plugin-owned endpoint and switch state.
- * @param signal Plugin lifetime cancellation.
+ * @param signal Cancellation for this activation, aborted on off or plugin disposal.
  * @param track Track active work until plugin disposal settles.
  * @returns Registration disposers, removed before active work is drained.
  */

package/runtime/node_modules/@deepseek-ai/dsh-tianti/package.json

@@ -35,6 +35,8 @@
     "@deepseek-ai/dsh-home-paths": "workspace:*"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-agent-loop": "workspace:*",
+    "@deepseek-ai/dsh-session-projection": "workspace:*",
     "@deepseek-ai/dsh-bash-local": "workspace:*",
     "@deepseek-ai/dsh-subprocess-local": "workspace:*",
     "@deepseek-ai/cordis": "workspace:~",

package/runtime/node_modules/@deepseek-ai/dsh-tool-cordis/lib/types/api-catalog.js

@@ -20,20 +20,32 @@ export const SERVICE_API = [
         methods: [
             {
                 signature: 'currentSelection(): ModelSelection',
-                description: 'Read the current default model selection.',
+                description: 'Read the current default model selection. A first launch without a valid preference adopts the first complete Config default when it arrives; that process-local choice then stays cached.',
                 parameters: [],
                 returns: 'a detached provider, model, and optional reasoning selection.',
             },
+            {
+                signature: 'usesSharedPreference(): boolean',
+                description: 'Whether this product uses a process-local selection initialized from Home at startup.',
+                parameters: [],
+                returns: 'true for the integrated ChatCode CLI and Web profiles.',
+            },
+            {
+                signature: 'async resolveSelection(): Promise<ModelSelection>',
+                description: 'Resolve the cached route against the live catalog without reading or writing preferences. A first launch without a valid preference may adopt an advertised fallback until its first available default is resolved. Saved or initialized choices never switch implicitly. Catalog errors preserve the candidate for retry.',
+                parameters: [],
+                returns: 'the exact available selection, an unverified candidate, or an empty provider/model pair.',
+            },
             {
                 signature: 'sharedDisplayName(): { provider: string; model: string; name: string } | undefined',
-                description: 'Read the latest shared display name without changing this process\'s model selection.',
+                description: 'Read this process\'s cached display name without observing another process\'s saves.',
                 parameters: [],
                 returns: 'The saved provider/model/name tuple, or undefined for missing or invalid name metadata.',
             },
             {
-                signature: 'async saveSelection(next: ModelSelection): Promise<void>',
-                description: 'Save the complete default model selection to the shared ChatCode Home file, or the owning profile entry in other deployments. Saves commit in submission order; a failed save rejects its caller without blocking later saves. A shared save also retains an available catalog name; metadata failures do not reject the route save.',
-                parameters: [{ name: 'next', description: 'resolved selection accepted by an entry point.' }],
+                signature: 'async saveSelection(next: ModelSelection, name?: string): Promise<void>',
+                description: 'Save the complete default model selection to the shared ChatCode Home file, or the owning profile entry in other deployments. Saves commit in submission order; a failed save rejects its caller without blocking later saves. A shared save uses the caller\'s already resolved catalog name without an additional lookup.',
+                parameters: [{ name: 'next', description: 'resolved selection accepted by an entry point.' }, { name: 'name', description: 'optional display name from the entry point\'s catalog.' }],
                 returns: 'fulfillment after the preference or optional profile write settles.',
             },
         ],
@@ -1843,20 +1855,20 @@ export const SERVICE_API = [
                 returns: 'authorized bounded Session search results.',
             },
             {
-                signature: '@Remote(\'create\') create(request: SessionCreateRequest): Promise<SessionCreateValue>',
+                signature: '@Remote(\'create\') async create(request: SessionCreateRequest): Promise<SessionCreateValue>',
                 description: 'Create or idempotently adopt one ordinary Session.',
                 parameters: [{ name: 'request', description: 'requested identity, location, and Agent preset.' }],
                 returns: 'the Session identity and resolved preset when configured.',
             },
             {
                 signature: '@Remote(\'selectModel\') selectModel(request: SessionSelectModelRequest): Promise<SessionSelectModelValue>',
-                description: 'Select one Session-local model after explicitly resuming the Session; save the default in the background.',
+                description: 'Select a model after explicitly resuming the Session and awaiting default persistence.',
                 parameters: [{ name: 'request', description: 'Session identity and requested model selection.' }],
-                returns: 'the normalized selection installed for the Session, without waiting for default persistence.',
+                returns: 'the normalized selection after the shared save and Session selection succeed.',
             },
             {
                 signature: '@Remote async initializeDefaultModel(): Promise<void>',
-                description: 'Select the first available account model after login when no provider API key is configured.',
+                description: 'Initialize legacy account deployments without changing a product process\'s cached selection.',
                 parameters: [],
                 returns: 'after saving the first available model or retaining the existing default.',
             },
@@ -1935,7 +1947,7 @@ export const SERVICE_API = [
                 returns: 'one chronological page.',
             },
             {
-                signature: '@Remote({ mode: \'stream\' }) follow(request: SessionFollowRequest, signal: AbortSignal): AsyncIterable<SessionFollowFrame>',
+                signature: '@Remote({ mode: \'stream\' }) async *follow(request: SessionFollowRequest, signal: AbortSignal): AsyncIterable<SessionFollowFrame>',
                 description: 'Follow one Session log from its opening or resume cursor.',
                 parameters: [{ name: 'request', description: 'durable address and last committed sequence already held by the caller.' }, { name: 'signal', description: 'cancellation owned by the Remote stream carrier.' }],
                 returns: 'a complete opening snapshot followed by gap-free durable event frames and optional cursorless assistant-stream frames.',
@@ -2023,6 +2035,13 @@ export const SERVICE_API = [
                 parameters: [{ name: 'options', description: 'optional cancellation.' }],
                 returns: 'one snapshot per stored session.',
             },
+            {
+                signature: 'prepareDeletion(sessionIds: readonly SessionId[]): Promise<SessionDeletion>',
+                description: 'Reserve every target\'s write ownership before any deletion is committed. The caller persists its recovery journal while this reservation is held, calls commit, and always disposes it to release ownership. Backends must retain deletion identities so old generations cannot reappear or be recreated.',
+                parameters: [{ name: 'sessionIds', description: 'complete deletion scope, including owned descendants.' }],
+                returns: 'an exclusive deletion reservation; missing targets are idempotent.',
+                throws: ['when a writer holds any target, or the backend does not support deletion.'],
+            },
         ],
     },
     {
@@ -3526,6 +3545,18 @@ export const SERVICE_API = [
                 parameters: [{ name: 'request', description: 'Session identity to unarchive.' }],
                 returns: 'the complete resulting archive set.',
             },
+            {
+                signature: '@Remote(\'sessionDeletionScope\') sessionDeletionScope(request: WorkspaceSessionDeletionPreviewRequest): Promise<WorkspaceSessionDeletionValue>',
+                description: 'Preview the archived root and owned subagent Sessions covered by deletion.',
+                parameters: [{ name: 'request', description: 'archived root to preview.' }],
+                returns: 'complete deletion scope for confirmation.',
+            },
+            {
+                signature: '@Remote(\'deleteSession\') deleteSession(request: WorkspaceSessionDeletionRequest): Promise<WorkspaceSessionDeletionValue>',
+                description: 'Permanently remove an archived Session and its confirmed owned subagents.',
+                parameters: [{ name: 'request', description: 'archived root and confirmed scope.' }],
+                returns: 'identities permanently removed.',
+            },
             {
                 signature: '@Remote(\'pinSession\') pinSession(request: WorkspacePinSessionRequest): Promise<WorkspacePinValue>',
                 description: 'Surface one known unarchived Session ahead of unpinned Sessions.',
@@ -3630,6 +3661,18 @@ export const SERVICE_API = [
                 parameters: [{ name: 'id', description: 'Workspace to move.' }, { name: 'beforeId', description: 'Workspace anchor; omitted appends.' }],
                 returns: 'the complete committed workspace order.',
             },
+            {
+                signature: 'deleteSession(sessionId: SessionId, expectedIds?: readonly SessionId[]): Promise<readonly SessionId[]>',
+                description: 'Permanently delete an archived, inactive root and its owned subagent descendants. Independent forks are preserved. Reserve every writer before recording a recovery marker; a failure after that marker is retried on refresh or restart.',
+                parameters: [{ name: 'sessionId', description: 'archived root identity; repeated deletion is idempotent.' }, { name: 'expectedIds', description: 'identities confirmed by the user; a changed scope refuses deletion.' }],
+                returns: 'deleted root and descendant identities after durable cleanup.',
+            },
+            {
+                signature: 'sessionDeletionScope(sessionId: SessionId): Promise<readonly SessionId[]>',
+                description: 'Preview the root and owned descendants without opening their histories.',
+                parameters: [{ name: 'sessionId', description: 'archived root to preview.' }],
+                returns: 'identities to show in the deletion confirmation.',
+            },
             {
                 signature: 'archiveSession(sessionId: SessionId, options: ArchiveSessionOptions = {}): Promise<void>',
                 description: 'Archive one session durably. The session must exist (live or in session persistence); its workspace accounting — or lack of one — is irrelevant. Without `stopActivity` the session must also be inactive: the `workspace/session-activity` waterfall is asked once, and any reported activity rejects with WorkspaceActiveSessionError before anything is written. With `stopActivity` the archive is written without an activity check, and the `workspace/session-stop` providers are then asked to stop the session\'s work: the durable archive set is what a provider\'s `agent/pre-step` gate reads, so every wake the stops induce is already blocked. Archiving drops the session\'s pin in the same durable write (pinning and archival are mutually exclusive). An already archived id resolves without writing, asking, or stopping.',
@@ -3801,6 +3844,14 @@ export const EVENT_API = [
         description: 'One Agent failed outside a durable turn position.',
         parameters: [{ name: 'sessionId', description: 'Agent and Session identity.' }, { name: 'message', description: 'user-safe failure chain.' }],
     },
+    {
+        name: 'api-session/model-updated',
+        mode: 'emit',
+        signature: '\'api-session/model-updated\'(): void',
+        summary: 'The Host process committed a user-selected default; browser catalogs must reload from that process.',
+        description: 'The Host process committed a user-selected default; browser catalogs must reload from that process.',
+        parameters: [],
+    },
     {
         name: 'api-session/removed',
         mode: 'emit',
@@ -4097,6 +4148,30 @@ export const EVENT_API = [
         description: 'Creation announcement during session publication. A synchronous throw vetoes and rolls back with a paired disposal; detach requested during dispatch is deferred. A returned-promise rejection is logged but cannot retroactively veto this synchronous boundary. Scope-filtered dispatch (`@deepseek-ai/dsh-scope`): agent-scoped listeners receive only sessions entered through that agent\'s context.',
         parameters: [{ name: 'session', description: 'the session just entered and announced.' }],
     },
+    {
+        name: 'session/delete-release',
+        mode: 'parallel',
+        signature: '\'session/delete-release\'(request: { readonly sessionIds: readonly SessionId[] }): Promise<void> | void',
+        summary: 'Ask capability owners to release idle, archived Sessions before writer reservation.',
+        description: 'Ask capability owners to release idle, archived Sessions before writer reservation. Owners release only handles they own; foreign or running Sessions remain protected.',
+        parameters: [{ name: 'request', description: 'confirmed root and owned subagent identities.' }],
+    },
+    {
+        name: 'session/deleted',
+        mode: 'emit',
+        signature: '\'session/deleted\'(sessionIds: readonly SessionId[]): void',
+        summary: 'Permanent deletion observed locally or from shared storage.',
+        description: 'Permanent deletion observed locally or from shared storage.',
+        parameters: [{ name: 'sessionIds', description: 'removed identities, including owned descendants.' }],
+    },
+    {
+        name: 'session/deleting',
+        mode: 'parallel',
+        signature: '\'session/deleting\'(request: { readonly sessionIds: readonly SessionId[] }): Promise<void> | void',
+        summary: 'Permanently remove secondary Session records after stored payload deletion.',
+        description: 'Permanently remove secondary Session records after stored payload deletion. Listeners are idempotent; failures leave the deletion journal pending for recovery.',
+        parameters: [{ name: 'request', description: 'confirmed root and owned subagent identities.' }],
+    },
     {
         name: 'session/disposed',
         mode: 'emit',
@@ -4666,7 +4741,7 @@ export const TYPE_API = [
     },
     {
         name: 'CommandInputDescriptor',
-        declaration: 'export interface CommandInputDescriptor {\n    readonly hint: string;\n    readonly attachments?: boolean;\n}',
+        declaration: 'export interface CommandInputDescriptor {\n    readonly hint: string;\n    readonly suggestions?: readonly {\n        readonly value: string;\n        readonly description: string;\n    }[];\n    readonly attachments?: boolean;\n}',
     },
     {
         name: 'CommandInvocation',
@@ -5714,7 +5789,7 @@ export const TYPE_API = [
     },
     {
         name: 'ModelCatalog',
-        declaration: 'export interface ModelCatalog {\n    readonly default: ModelSelection;\n    readonly savedDisplayName?: {\n        readonly provider: string;\n        readonly model: string;\n        readonly name: string;\n    };\n    readonly routableProviders: readonly string[];\n    readonly groups: readonly ModelProviderGroup[];\n    readonly failures: readonly ModelCatalogFailure[];\n}',
+        declaration: 'export interface ModelCatalog {\n    readonly default: ModelSelection;\n    readonly selectionScope?: \'process\';\n    readonly savedDisplayName?: {\n        readonly provider: string;\n        readonly model: string;\n        readonly name: string;\n    };\n    readonly routableProviders: readonly string[];\n    readonly groups: readonly ModelProviderGroup[];\n    readonly failures: readonly ModelCatalogFailure[];\n}',
     },
     {
         name: 'ModelCatalogFailure',
@@ -6066,7 +6141,7 @@ export const TYPE_API = [
     },
     {
         name: 'RecordTable',
-        declaration: 'export type RecordTable<K extends string, V> = Pick<KvTable<K, V>, \'read\' | \'put\'>;',
+        declaration: 'export type RecordTable<K extends string, V> = Pick<KvTable<K, V>, \'read\' | \'put\' | \'delete\'>;',
     },
     {
         name: 'RecurringScheduleRecord',
@@ -6408,6 +6483,10 @@ export const TYPE_API = [
         name: 'SessionCreateValue',
         declaration: 'export interface SessionCreateValue {\n    readonly sessionId: SessionId;\n    readonly agentPreset?: string;\n}',
     },
+    {
+        name: 'SessionDeletion',
+        declaration: 'export interface SessionDeletion extends AsyncDisposable {\n    commit(): Promise<void>;\n}',
+    },
     {
         name: 'SessionEvent',
         declaration: 'export type SessionEvent<T extends SessionEventType = SessionEventType> = {\n    [K in SessionEventType]: {\n        type: K;\n        seq: SessionSeq;\n        time: number;\n        data: SessionEventMap[K];\n        ignorable?: true;\n    } & (K extends SurfaceEventType ? SurfaceIntent<K> : {\n        surfaceOp?: never;\n        sourceEventSeqs?: never;\n    });\n}[T];',
@@ -8028,6 +8107,18 @@ export const TYPE_API = [
         name: 'WorkspaceRenameRequest',
         declaration: 'export interface WorkspaceRenameRequest {\n    readonly workspaceId: WorkspaceId;\n    readonly title: string;\n}',
     },
+    {
+        name: 'WorkspaceSessionDeletionPreviewRequest',
+        declaration: 'export interface WorkspaceSessionDeletionPreviewRequest {\n    readonly sessionId: SessionId;\n}',
+    },
+    {
+        name: 'WorkspaceSessionDeletionRequest',
+        declaration: 'export interface WorkspaceSessionDeletionRequest extends WorkspaceSessionDeletionPreviewRequest {\n    readonly expectedSessionIds: readonly SessionId[];\n}',
+    },
+    {
+        name: 'WorkspaceSessionDeletionValue',
+        declaration: 'export interface WorkspaceSessionDeletionValue {\n    readonly sessionIds: readonly SessionId[];\n}',
+    },
     {
         name: 'WorkspaceUnarchiveSessionRequest',
         declaration: 'export interface WorkspaceUnarchiveSessionRequest {\n    readonly sessionId: SessionId;\n}',