@songtonyli/dsh-cli 0.1.12 → 0.1.13

package/node_modules/@deepseek-ai/dsh-tui-app/cordis.patch.yml

@@ -36,6 +36,12 @@
     - id: present
       name: '@deepseek-ai/dsh-tool-present'
 
+    # Records each top-level turn's changed files from git working-tree
+    # snapshots and announces them with `workspace/changes`; `/changes`
+    # browses the files and their comparisons as the browser's card does.
+    - id: workspace-changes
+      name: '@deepseek-ai/dsh-workspace-changes'
+
     # Whole-log turn outline for `/outline` (the turnOutline projection key)
     # over the base session-projection registry.
     - id: session-turn-outline
@@ -58,3 +64,6 @@
         resume: !!js ctx.tuiStartup.resume
         openBrowser: !!js ctx.tuiStartup.openBrowser
         toolPreviewLines: 8
+
+- id: hmr
+  disabled: true

package/node_modules/@deepseek-ai/dsh-tui-app/lib/index.js

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-import { CURSOR_MARKER, Container, Editor, Input, Loader, Markdown, ProcessTerminal, SelectList, Text, TuiMainScreen, decodeKittyPrintable, fuzzyFilter, matchesKey, sliceByColumn, stripTerminalSequences, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import { CURSOR_MARKER, Container, Editor, Input, Loader, Markdown, ProcessTerminal, SelectList, Text, TuiMainScreen, decodeKittyPrintable, fuzzyFilter, matchesKey, sliceByColumn, stripTerminalSequences, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import z from "@deepseek-ai/schemastery";
 import { brandString } from "@deepseek-ai/dsh-brand";
 import { installModelSelection } from "@deepseek-ai/dsh-agent";
@@ -444,9 +444,11 @@ function previewLines(lines, previewLines, expanded) {
 //#region lib/types/catalog.js
 /**
 * Terminal rows for the browser's settings, plugins, subagents, deliverables,
-* and turn-outline pages. Each reader resolves its service through `ctx.get`
-* and throws an `Error` naming the absent service; the app prints the message.
-* `subagentDetail` is the exception: it returns that message as a row.
+* changed-files, and turn-outline pages, and the plugin-management verbs the
+* browser's Plugins page offers. Each reader resolves its service through
+* `ctx.get` and throws an `Error` naming the absent service; the app prints
+* the message. `subagentDetail` is the exception: it returns that message as a
+* row.
 * @module @deepseek-ai/dsh-tui-app/catalog
 */
 var __addDisposableResource$1 = function(env, value, async) {
@@ -797,6 +799,191 @@ function sessionOutline(ctx, session) {
 	if (outline === void 0) throw new Error("the turnOutline projection is not registered in this profile");
 	return outline.flatMap(outlineRows);
 }
+/** The workspace-changes service, or a printable error naming its absence. */
+function requireWorkspaceChanges(ctx) {
+	const changes = ctx.get("workspaceChanges");
+	if (changes === void 0) throw new Error("workspace changes are not recorded in this profile");
+	return changes;
+}
+/** `N file` or `N files`. */
+function fileCount(total) {
+	return `${String(total)} file${total === 1 ? "" : "s"}`;
+}
+/**
+* The files one turn changed, as `/changes` picker rows: the latest
+* `workspace/changes` announcement of `turn`, or of the newest announced turn
+* when `turn` is undefined, resolved through the Host's summary.
+* @param ctx - plugin context carrying the optional workspace-changes service and session query engine.
+* @param sessionId - the session whose log is read.
+* @param turn - the turn to list, or undefined for the latest announced one.
+* @param signal - cancels a cold log read.
+* @returns the rows under the turn's totals, or undefined when no such turn was announced.
+* @throws {Error} when either service is not mounted, or when the Host no longer holds the announced summary.
+*/
+async function listTurnChanges(ctx, sessionId, turn, signal) {
+	const env_3 = {
+		stack: [],
+		error: void 0,
+		hasError: false
+	};
+	try {
+		const changes = requireWorkspaceChanges(ctx);
+		const query = ctx.get("sessionQuery");
+		if (query === void 0) throw new Error("the session query engine is not mounted in this profile");
+		const observation = __addDisposableResource$1(env_3, await query.observeSession(sessionId, {
+			signal,
+			projectionMode: "none"
+		}), false);
+		let announced;
+		for (const event of observation.events) {
+			if (event.type !== "workspace/changes") continue;
+			if (turn !== void 0 && event.data.turn !== turn) continue;
+			announced = {
+				seq: event.seq,
+				turn: event.data.turn
+			};
+		}
+		if (announced === void 0) return void 0;
+		const summary = changes.summary(sessionId, announced.seq);
+		if (summary === void 0) throw new Error(`the changed files of turn ${String(announced.turn)} are no longer held by this host`);
+		const listed = summary.files.length === summary.total ? "" : ` (${String(summary.files.length)} listed)`;
+		return {
+			heading: `turn ${String(summary.turn)} · ${fileCount(summary.total)}${listed} · +${String(summary.added)} −${String(summary.deleted)}`,
+			choices: summary.files.map((file, index) => ({
+				index,
+				seq: announced.seq,
+				label: file.display,
+				description: file.binary === true ? "binary" : file.oversized === true ? "oversized" : `+${String(file.added)} −${String(file.deleted)}`
+			}))
+		};
+	} catch (e_3) {
+		env_3.error = e_3;
+		env_3.hasError = true;
+	} finally {
+		__disposeResources$1(env_3);
+	}
+}
+/**
+* The one-row notice a `workspace/changes` event prints once its summary is read.
+* @param summary - the announced turn's summary.
+* @returns the turn's file and line totals, naming `/changes` for the files.
+*/
+function changesNotice(summary) {
+	return `turn ${String(summary.turn)} changed ${fileCount(summary.total)} (+${String(summary.added)} −${String(summary.deleted)}) · /changes`;
+}
+/**
+* The comparison one `/changes` row opens: the file's turn-start and turn-end
+* contents as unified hunks in the tool cards' diff row form, `@@` headers
+* between them and `…` where hunks are apart.
+* @param ctx - plugin context carrying the optional workspace-changes service.
+* @param sessionId - the session the summary belongs to.
+* @param choice - the entered picker row.
+* @param signal - cancels the snapshot reads.
+* @returns the rows; explanatory rows when no lines can be shown.
+* @throws {Error} when the service is not mounted or a snapshot read fails.
+*/
+async function changeDiffRows(ctx, sessionId, choice, signal) {
+	const diff = await requireWorkspaceChanges(ctx).diff(sessionId, choice.seq, choice.index, signal);
+	if (diff === void 0) return [`${choice.label}: the comparison is no longer held by this host`];
+	switch (diff.kind) {
+		case "binary": return [`${diff.display}: binary content, no line comparison`];
+		case "oversized": return [`${diff.display}: larger than the comparison limit, no line comparison`];
+		case "text": {
+			const rows = [];
+			if (!diff.before) rows.push("new file");
+			if (!diff.after) rows.push("deleted");
+			if (diff.coarse) rows.push("comparison timed out: every line is shown as replaced");
+			if (diff.hunks.length === 0) rows.push("no line changes");
+			diff.hunks.forEach((hunk, index) => {
+				if (index > 0) rows.push("  …");
+				rows.push(`@@ -${String(hunk.oldStart)},${String(hunk.oldLines)} +${String(hunk.newStart)},${String(hunk.newLines)} @@`);
+				for (const line of hunk.lines) rows.push(`${line.slice(0, 1)} ${line.slice(1)}`);
+			});
+			return rows;
+		}
+		/* v8 ignore next -- closed-union exhaustiveness guard */
+		default: return assertNever(diff, "tui workspace file diff");
+	}
+}
+/** The plugin manager, or a printable error naming its absence. */
+function requirePluginManager(ctx) {
+	const manager = ctx.get("pluginManager");
+	if (manager === void 0) throw new Error("plugin management is not mounted in this profile");
+	return manager;
+}
+/**
+* One row per bundle the profile can manage: name, version, enablement, how
+* the profile holds it, whether it can be removed, and its management error.
+* @param ctx - plugin context carrying the optional plugin manager.
+* @returns the rows in the manager's order.
+* @throws {Error} when no plugin manager is mounted.
+*/
+async function listBundles(ctx) {
+	return (await requirePluginManager(ctx).listBundles()).map(bundleRow);
+}
+/** One bundle's facts, two spaces apart. */
+function bundleRow(bundle) {
+	const held = bundle.installed ? "installed" : bundle.optional ? "optional" : "shipped";
+	const facts = [
+		bundle.name,
+		bundle.version ?? "-",
+		bundle.enabled ? "enabled" : "disabled",
+		held
+	];
+	if (bundle.removable) facts.push("removable");
+	if (bundle.readOnlyReason !== void 0) facts.push(`read-only (${bundle.readOnlyReason})`);
+	if (bundle.error !== void 0) facts.push(`error ${bundle.error.code}`);
+	return facts.join("  ");
+}
+/**
+* Switch one plugin entry or one bundle on or off in the profile's persistent
+* composition. A target naming a plugin entry id changes that entry;
+* otherwise it names a bundle.
+* @param ctx - plugin context carrying the optional plugin manager.
+* @param target - a plugin entry id or a bundle name.
+* @param enabled - the wanted state.
+* @returns a confirmation row: the persisted change and how it applied.
+* @throws {Error} when no plugin manager is mounted, when `target` names neither, or when the change failed.
+*/
+async function setPluginEnabled(ctx, target, enabled) {
+	const manager = requirePluginManager(ctx);
+	const plugin = (await manager.listPlugins()).find((candidate) => candidate.entryId === target);
+	if (plugin !== void 0) return reportChange(await manager.setPluginEnabled(plugin.entryId, enabled));
+	const bundle = (await manager.listBundles()).find((candidate) => candidate.name === target);
+	if (bundle !== void 0) return reportChange(await manager.setBundleEnabled(bundle.name, enabled));
+	throw new Error(`"${target}" is neither a plugin entry nor a bundle of this profile`);
+}
+/**
+* Install one bundle into the profile and enable it.
+* @param ctx - plugin context carrying the optional plugin manager.
+* @param spec - what pnpm should add: a registry name, a path, a git address, or a tarball.
+* @returns a confirmation row: the installation and how it applied.
+* @throws {Error} when no plugin manager is mounted or the installation failed.
+*/
+async function installBundle(ctx, spec) {
+	return reportChange(await requirePluginManager(ctx).installBundle(spec));
+}
+/**
+* Remove one installed bundle from the profile.
+* @param ctx - plugin context carrying the optional plugin manager.
+* @param name - the bundle's package name.
+* @returns a confirmation row: the removal and how it applied.
+* @throws {Error} when no plugin manager is mounted or the removal failed.
+*/
+async function removeBundle(ctx, name) {
+	return reportChange(await requirePluginManager(ctx).removeBundle(name));
+}
+/** One row over a change result; a failed change is thrown so the surface prints the row as an error. */
+function reportChange(result) {
+	const facts = [`${result.stage} ${result.target}: ${result.changed ? result.application : `unchanged, ${result.application}`}`];
+	if (result.bundle !== void 0 && result.bundle !== result.target) facts.push(`bundle ${result.bundle}`);
+	if (result.error !== void 0) facts.push(result.error.diagnostic === void 0 ? result.error.code : `${result.error.code}: ${result.error.diagnostic}`);
+	if (result.pendingBuilds !== void 0 && result.pendingBuilds.length > 0) facts.push(`scripts awaiting approval: ${result.pendingBuilds.join(", ")}`);
+	if (result.warnings !== void 0) facts.push(...result.warnings);
+	const text = facts.join(" · ");
+	if (result.application === "failed") throw new Error(text);
+	return text;
+}
 /** Control Sequence Introducer. */
 const CSI = "\x1B[";
 /**
@@ -2116,22 +2303,40 @@ const STRIP_ENDS = ["‹ ", " ›"];
 const OFF_SCREEN = " · off screen";
 /** The keys the inspector answers, drawn dim under its rows. */
 const HINT = "↑ ↓ blocks · ← → parts · Enter page · Esc back";
+/** What ends a line the width cut short; one column, so the mark itself fits. */
+const ELLIPSIS = "…";
 /**
 * Draw the focused section.
 * @param view - the section to show.
 * @param render - the palette, the row budget, and the width.
-* @returns the inspector's lines: a blank separator, the heading, the parts
-* strip when the block has more than one part, the folded rows, and the hints.
+* @returns the inspector's lines, none wider than `width`: a blank separator,
+* the heading, the parts strip when the block has more than one part, the
+* folded rows, and the hints.
 */
 function renderInspector(view, render) {
-	const { palette, width } = render;
-	const suffix = view.highlighted ? "" : palette.dim(OFF_SCREEN);
-	const lines = ["", `${palette.bold(palette.accent(view.heading))}${suffix}`];
+	const { palette } = render;
+	const width = Math.max(1, render.width);
+	const lines = ["", heading(view, palette, width)];
 	if (view.parts.length > 1) lines.push(partsStrip(view.parts, palette));
-	const wrapped = view.rows.flatMap((row) => wrapTextWithAnsi(row, Math.max(1, width)));
+	const wrapped = view.rows.flatMap((row) => wrapTextWithAnsi(row, width));
 	lines.push(...foldRows(wrapped, render.previewLines, (hidden) => palette.dim(`… ${String(hidden)} more row${hidden === 1 ? "" : "s"} · Enter opens the page`)));
 	lines.push(palette.dim(HINT));
-	return lines;
+	return lines.map((line) => truncateToWidth(line, width, ELLIPSIS));
+}
+/**
+* The heading line. A tool title can run past any terminal, so the subject is
+* cut first and the off-screen mark stays whole: where the marked block went
+* must never be what the width hides.
+* @param view - the section to show.
+* @param palette - the palette the heading is styled with.
+* @param width - the width the line must fit; at least 1.
+* @returns the heading, with the mark when the block is not on screen.
+*/
+function heading(view, palette, width) {
+	const subject = palette.bold(palette.accent(view.heading));
+	if (view.highlighted) return subject;
+	const suffix = palette.dim(OFF_SCREEN);
+	return `${truncateToWidth(subject, Math.max(1, width - visibleWidth(suffix)), ELLIPSIS)}${suffix}`;
 }
 /**
 * Draw the parts of the focused block as one row of choices.
@@ -3797,6 +4002,10 @@ const LOCAL_COMMANDS = [
 		name: "deliverables",
 		description: "List the files the agent presented in this session"
 	},
+	{
+		name: "changes",
+		description: "Browse the files the last turn changed (/changes <turn> for an earlier one; Enter shows a file's diff)"
+	},
 	{
 		name: "subagents",
 		description: "Browse the subagent sessions under this session (Enter shows one session's details)"
@@ -3807,7 +4016,7 @@ const LOCAL_COMMANDS = [
 	},
 	{
 		name: "plugins",
-		description: "List the composed plugins and their state"
+		description: "List the composed plugins (/plugins bundles, /plugins enable|disable <id>, /plugins add <spec>, /plugins remove <name>)"
 	},
 	{
 		name: "tools",
@@ -4464,6 +4673,67 @@ var TuiApp = class {
 		})), TODO_ROW_LAYOUT);
 	}
 	/**
+	* Walk the files one turn changed: one row per file with its line counts,
+	* and entering a row shows the file's turn-start to turn-end comparison.
+	* @param turn - the turn to browse; the latest announced one when undefined.
+	*/
+	async browseChanges(turn) {
+		const sessionId = this.agent.session.id;
+		const signal = new AbortController().signal;
+		const changes = await listTurnChanges(this.deps.ctx, sessionId, turn, signal);
+		if (changes === void 0) {
+			this.notice(turn === void 0 ? "no changed files recorded yet" : `no changed files recorded for turn ${String(turn)}`);
+			return;
+		}
+		if (changes.choices.length === 0) {
+			this.notice(`${changes.heading}: no file listed`);
+			return;
+		}
+		await this.browse(changes.heading, changes.choices.map((choice) => ({
+			item: {
+				value: String(choice.index),
+				label: choice.label,
+				description: choice.description
+			},
+			heading: choice.label,
+			detail: () => changeDiffRows(this.deps.ctx, sessionId, choice, signal)
+		})));
+	}
+	/**
+	* `/plugins` and its management verbs over the profile's plugin manager:
+	* the composed plugins alone, the bundles, a switch of one entry or bundle,
+	* an installation, or a removal.
+	* @param argument - the verb and its operand; empty lists the composed plugins.
+	*/
+	async plugins(argument) {
+		const [verb = "", ...rest] = argument.split(/\s+/).filter((word) => word !== "");
+		const operand = rest.join(" ");
+		switch (verb) {
+			case "":
+				this.showRows(listPlugins(this.deps.ctx), "no plugins are listed");
+				return;
+			case "bundles":
+				this.showRows(await listBundles(this.deps.ctx), "no bundles are listed");
+				return;
+			case "enable":
+			case "disable":
+				if (operand === "") break;
+				this.notice(await setPluginEnabled(this.deps.ctx, operand, verb === "enable"), "success");
+				return;
+			case "add":
+				if (operand === "") break;
+				this.notice(`installing ${operand}…`);
+				this.notice(await installBundle(this.deps.ctx, operand), "success");
+				return;
+			case "remove":
+				if (operand === "") break;
+				this.notice(await removeBundle(this.deps.ctx, operand), "success");
+				return;
+			default: break;
+		}
+		this.notice("usage: /plugins · /plugins bundles · /plugins enable|disable <entry id or bundle> · /plugins add <spec> · /plugins remove <bundle>", "error");
+	}
+	/**
 	* The browsable entry behind one subagent row: the same detail page the
 	* `/subagents` list and the live panel open.
 	* @param choice - the listing row.
@@ -4990,6 +5260,15 @@ var TuiApp = class {
 			case "deliverables":
 				this.showRows(await listDeliverables(this.deps.ctx, this.agent.session.id, new AbortController().signal), "nothing presented yet");
 				return;
+			case "changes": {
+				const turn = argument === "" ? void 0 : Number(argument);
+				if (turn !== void 0 && !(Number.isSafeInteger(turn) && turn > 0)) {
+					this.notice("usage: /changes · /changes <turn>", "error");
+					return;
+				}
+				await this.browseChanges(turn);
+				return;
+			}
 			case "subagents": {
 				const choices = await listSubagentChoices(this.deps.ctx, this.agent.session.id, new AbortController().signal);
 				if (choices.length === 0) {
@@ -5003,7 +5282,7 @@ var TuiApp = class {
 				await this.settings(argument);
 				return;
 			case "plugins":
-				this.showRows(listPlugins(this.deps.ctx), "no plugins are listed");
+				await this.plugins(argument);
 				return;
 			default: await this.runSharedCommand(line, name);
 		}
@@ -5760,6 +6039,12 @@ var TuiApp = class {
 			case "compaction/summary":
 				this.notice(compactionNotice(event.data));
 				break;
+			case "workspace/changes": {
+				const summary = this.deps.ctx.get("workspaceChanges")?.summary(session.id, event.seq);
+				if (summary === void 0) return;
+				this.notice(changesNotice(summary));
+				break;
+			}
 			case "llm/retry":
 				this.loader.setMessage(retryMessage(event.data));
 				break;

package/node_modules/@deepseek-ai/dsh-tui-app/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tui-app",
   "description": "The dsh terminal-surface bundle: an interactive terminal UI over dsh-base with streaming replies, tool cards, approvals, questions, and slash commands in one process",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -39,20 +39,26 @@
     }
   },
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-cmdline": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-file-reference": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-file-reference-local": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-host-plugin-inventory": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-launch-environment": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-native-command": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-log-export": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-reference": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-stats": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-turn-outline": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-tool-ask-user": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-tool-present": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-util-values": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-brand": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-cmdline": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-file-reference": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-file-reference-local": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-host-plugin-inventory": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-launch-environment": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-native-command": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-plugin-manager": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-log-export": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-reference": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-stats": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-turn-outline": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tool-ask-user": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tool-present": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-questions": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-workspace-changes": "0.1.6-alpha.2",
     "@deepseek-ai/schemastery": "3.18.2",
     "@earendil-works/pi-tui": "^0.85.1",
     "commander": "^15.0.0"
@@ -60,57 +66,57 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
     "@deepseek-ai/cordis-plugin-loader": "1.0.3",
-    "@deepseek-ai/dsh-agent": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-agent-default-model": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-attachment": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-commands": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-compaction": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-goal": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-llm-retry": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-permission-presets": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-plan-mode": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-query": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-stats": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-title": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-settings": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-subagent": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-token-meter": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-tool-todo": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-tools": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-user-approval": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-user-questions": "0.1.6-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-attachment": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-commands": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-compaction": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-goal": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm-retry": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-permission-presets": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-plan-mode": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-query": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-stats": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-title": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-subagent": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-token-meter": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tool-todo": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-approval": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-questions": "0.1.6-alpha.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
     "@deepseek-ai/cordis-plugin-include": "1.0.7",
     "@deepseek-ai/cordis-plugin-loader": "1.0.3",
-    "@deepseek-ai/dsh-agent": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-agent-default-model": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-attachment": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-commands": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-compaction": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-goal": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-llm-retry": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-permission-presets": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-plan-mode": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-query": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-stats": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-title": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-settings": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-subagent": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-system-prompt": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-token-meter": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-tool-todo": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-tools": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-user-approval": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-user-questions": "0.1.6-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-attachment": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-commands": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-compaction": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-goal": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm-retry": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-permission-presets": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-plan-mode": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-query": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-stats": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-title": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-subagent": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-token-meter": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tool-todo": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-approval": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-questions": "0.1.6-alpha.2"
   }
 }

package/node_modules/@deepseek-ai/dsh-typert-loader/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-typert-loader",
   "description": "Loader integration for generated Typert package contributions",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -28,16 +28,16 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "1.0.3",
-    "@deepseek-ai/dsh-typert-registry": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "0.1.6-alpha.2",
     "@deepseek-ai/cordis": "4.0.2"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "3.18.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-app-boot": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-app-boot": "0.1.6-alpha.2",
     "@deepseek-ai/cordis-plugin-loader": "1.0.3",
-    "@deepseek-ai/dsh-typert-registry": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "0.1.6-alpha.2",
     "@deepseek-ai/cordis": "4.0.2",
     "zod": "^4.4.3"
   }

package/node_modules/@deepseek-ai/dsh-typert-protocol/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/typert/protocol/README.md
-README.md: 99883e322bf6e528f8fd4effe9c4fc1e418abbdb
-README.zh.md: 429c08587a5297e254ac4c0f3fb9d82fc680a455
+README.md: e41fa9fa305d8f55ce55d3eace647ad5afcea0e3
+README.zh.md: e784e771016ebec0913e0ea847258fe653ae3bd0

package/node_modules/@deepseek-ai/dsh-typert-protocol/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-With `dsh-typert-protocol`, business packages can expose Host methods to Remote clients: mark a method with `@Remote` (or `@RemoteScope` for scoped receivers), bind the service to a wire namespace, and associate Host objects and scoped Contexts with wire identities through the merge-extensible protocol maps. Generated artifacts, the Host Gateway, and the Client API consume the same invocation descriptors, codecs, and provider contracts, so one declaration set stays in sync across every face. The package registers no Cordis service and runs no TypeScript analysis; it declares types and decorator markers only.
+With `dsh-typert-protocol`, business packages can expose Host methods to Remote clients: mark a method with `@Remote` (or `@RemoteScope` for scoped receivers), bind the service to a wire namespace, and associate Host objects and scoped Contexts with wire identities through the merge-extensible protocol maps. Generated artifacts, the Host Gateway, and the Client API consume the same invocation descriptors, codecs, and provider contracts. Invocation-owned values transfer cleanup to Gateway without adding a reference count. The package registers no Cordis service and runs no TypeScript analysis.
 
 ## Table of Contents
 
@@ -48,6 +48,8 @@ Generation turns the method into a wire endpoint under the service's namespace;
 
 Complex Host objects cannot cross the wire directly. A business package declares the association through the merge-extensible `TypertLookupMap` and `TypertContextMap`. A Host Context adapter owns the stable wire declaration and resolves wire identities to live Contexts. A Client Context adapter maps in both directions because scoped calls originate from a Client Context and forwarded Host events resolve their explicit wire identity there. Host composition may override its synchronous or asynchronous resolver. A resolver that refuses on policy grounds throws `RemoteError` with its own code, which reaches the caller unchanged.
 
+Client Context resolution is synchronous. `typertOwnedValue(value, release)` transfers a non-throwing, idempotent cleanup to the invocation owner; Gateway calls it after handler and reply settlement. A borrowed Context requires no cleanup wrapper. The shared `TYPERT_OWNED_VALUE` symbol and `isTypertOwnedValue` recognizer work across independently bundled providers and Gateway; the wrapper itself does not retain a resource.
+
 ### Reporting and reading a Remote failure
 
 One class carries every Remote failure: `RemoteError`, holding a stable `<domain>/<reason>` code and the details typed for that code. This package declares the universal carrier codes (`gateway/bad-request`, `gateway/cancelled`, `gateway/internal`) and owns `RemoteErrorDetailsMap`, the merge-extensible table every other package extends beside its own throwing code:

package/node_modules/@deepseek-ai/dsh-typert-protocol/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-library"
 
 ## 概述
 
-借助 `dsh-typert-protocol`，业务包可以向 Remote 客户端暴露 Host 方法：用 `@Remote`（作用域接收者用 `@RemoteScope`）标记方法，把服务绑定到 wire 命名空间，并通过可合并扩展的协议映射把 Host 对象与作用域 Context 关联到 wire identity。生成产物、Host Gateway 与 Client API 消费同一套调用描述符、编解码器与提供方约定，因此一套声明在每个 face 上保持一致。本包不注册任何 Cordis 服务，也不运行 TypeScript 分析；它只声明类型与装饰器标记。
+借助 `dsh-typert-protocol`，业务包可以向 Remote 客户端暴露 Host 方法：用 `@Remote`（作用域接收者用 `@RemoteScope`）标记方法，把服务绑定到 wire 命名空间，并通过可合并扩展的协议映射把 Host 对象与作用域 Context 关联到 wire identity。生成产物、Host Gateway 与 Client API 消费同一套调用描述符、编解码器与提供方约定。调用持有的值把清理责任交给 Gateway，不另增引用计数。本包不注册任何 Cordis 服务，也不运行 TypeScript 分析。
 
 ## 目录
 
@@ -48,6 +48,8 @@ export class GoalService extends TypertRemoteService {
 
 复杂的 Host 对象不能直接跨 wire 传输。业务包通过可合并扩展的 `TypertLookupMap` 与 `TypertContextMap` 声明关联。Host Context 适配器拥有稳定 wire 声明，并把 wire identity 解析为活跃 Context。Client Context 适配器需要双向映射，因为作用域调用从 Client Context 发起，而转发的 Host 事件要在 Client 侧解析其显式 wire identity。Host 组合可以覆盖其同步或异步解析器。因策略原因拒绝解析的解析器会抛出带有自身错误码的 `RemoteError`，该码原样到达调用方。
 
+Client Context 解析保持同步。`typertOwnedValue(value, release)` 把不抛异常、幂等的清理交给调用 owner；Gateway 在处理器和回复均结束后调用它。借用的 Context 不需要清理包装层。共享的 `TYPERT_OWNED_VALUE` symbol 与 `isTypertOwnedValue` 识别函数可跨独立打包的提供方与 Gateway 使用；包装层自身不会 retain 资源。
+
 ### 报告与读取 Remote 失败
 
 所有 Remote 失败都由一个类承载：`RemoteError`，携带稳定的 `<domain>/<reason>` 码，以及按该码定型的 details。本包声明通用载体码（`gateway/bad-request`、`gateway/cancelled`、`gateway/internal`），并拥有 `RemoteErrorDetailsMap`——可合并扩展的码表，其他每个包都在自己的抛出点旁扩展它：