@morlay/dsh-session-mode 0.0.2 → 0.0.4

package/dist/rows.mjs

@@ -1,461 +1,19 @@
-//#endregion
-//#region ../dsh-agent-toolkit/src/guidance/packs/index.ts
-/** 全部工具族（顺序只影响报错信息里的排列）。 */
-const TOOL_PACKS = [
-	{
-		family: "ask",
-		tools: [{
-			tool: "ask_user_question",
-			short: "向用户提问并等待回答"
-		}]
-	},
-	{
-		family: "delegation",
-		tools: [
-			{
-				tool: "subagent",
-				short: "派发子代理执行任务"
-			},
-			{
-				tool: "subagent_fork",
-				short: "派发继承当前上下文的子代理"
-			},
-			{
-				tool: "list_subagent_models",
-				short: "查看子代理可用的模型"
-			},
-			{
-				tool: "workflow",
-				short: "用脚本编排多个子代理"
-			}
-		]
-	},
-	{
-		family: "flow",
-		tools: [
-			{
-				tool: "todo_write",
-				short: "维护多步任务的待办清单"
-			},
-			{
-				tool: "exit_plan_mode",
-				short: "提交计划并请求批准"
-			},
-			{
-				tool: "get_goal",
-				short: "查看当前会话目标"
-			},
-			{
-				tool: "create_goal",
-				short: "创建会话目标"
-			},
-			{
-				tool: "update_goal",
-				short: "更新会话目标状态"
-			},
-			{
-				tool: "present",
-				short: "声明交付给用户的产物"
-			}
-		]
-	},
-	{
-		family: "fs",
-		tools: [
-			{
-				tool: "read",
-				short: "读文件内容（可指定行范围）"
-			},
-			{
-				tool: "write",
-				short: "写入文件或整文件覆盖"
-			},
-			{
-				tool: "edit",
-				short: "按精确匹配替换文件片段"
-			},
-			{
-				tool: "glob",
-				short: "按模式查找文件路径"
-			},
-			{
-				tool: "grep",
-				short: "按正则搜索文件内容"
-			},
-			{
-				tool: "read_image",
-				short: "读取图片内容"
-			}
-		]
-	},
-	{
-		family: "shell",
-		tools: [
-			{
-				tool: "bash",
-				short: "执行 shell 命令"
-			},
-			{
-				tool: "pwsh",
-				short: "执行 PowerShell 命令"
-			},
-			{
-				tool: "job_output",
-				short: "读取后台任务的输出"
-			},
-			{
-				tool: "job_list",
-				short: "列出后台任务"
-			},
-			{
-				tool: "job_kill",
-				short: "终止后台任务"
-			}
-		]
-	},
-	{
-		family: "skill",
-		tools: [{
-			tool: "skill",
-			short: "按需加载技能说明"
-		}]
-	},
-	{
-		family: "team",
-		tools: [
-			{
-				tool: "spawn_teammate",
-				short: "招募一个队友"
-			},
-			{
-				tool: "send_message",
-				short: "给队友发消息"
-			},
-			{
-				tool: "list_agents",
-				short: "列出可协作的代理"
-			},
-			{
-				tool: "wait_agent",
-				short: "等待队友回复"
-			},
-			{
-				tool: "interrupt_agent",
-				short: "打断某个队友"
-			},
-			{
-				tool: "team_task_create",
-				short: "创建共享任务"
-			},
-			{
-				tool: "team_task_list",
-				short: "列出共享任务"
-			},
-			{
-				tool: "team_task_get",
-				short: "读取共享任务"
-			},
-			{
-				tool: "team_task_update",
-				short: "更新共享任务状态"
-			}
-		]
-	},
-	{
-		family: "web",
-		tools: [{
-			tool: "web_fetch",
-			short: "抓取指定 URL 的内容"
-		}, {
-			tool: "web_search",
-			short: "联网搜索"
-		}]
-	}
-];
-/**
-* 工具名的并集：**工具集与汉化同源**——需要"这套工具有哪些"的地方（例如模式的 `allowTools` 白名单）读它，
-* 而不是另写一份名单。
-* @param packs - 待合并的族，缺省全部。
-* @returns 去重后的工具名（按族出现顺序）。
-*/
-function toolNamesOf(packs = TOOL_PACKS) {
-	const names = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const pack of packs) for (const guidance of pack.tools) {
-		if (seen.has(guidance.tool)) continue;
-		seen.add(guidance.tool);
-		names.push(guidance.tool);
-	}
-	return names;
-}
-//#endregion
-//#region ../dsh-agent-toolkit/src/js-expr.ts
-/** 词字符：它的两侧不能不留空格地粘起来（`typeof x` 不是 `typeofx`）。 */
-const WORD = /[\w$]/u;
-/**
-* 压掉字符串字面量之外的空白，只在**两侧都是词字符**时留一个（`typeof x` 不能粘成 `typeofx`，
-* 而 `a === b` 可以压成 `a===b`）。
-*
-* 为什么非要压：函数体文本取自 `String(body)`，而它由**加载这段代码的那台转换器**给出——`tsdown` 读
-* `tsdown.config.ts` 的 loader 与 vitest 的 vite 转换器对同一个表达式给出的空白不同（`a === "1"` 对
-* `a==="1"`）。产物是要入库、又要与 `render()` 逐字符比对的文件，所以这里收口到一种形态。
-*
-* 只动空白、不补空白：无论输入是松是紧，结果一样（幂等），也就不必赌转换器站哪边。
-*/
-function compact(expression) {
-	let out = "";
-	let quote;
-	let pendingSpace = false;
-	for (const char of expression) {
-		if (quote !== void 0) {
-			out += char;
-			if (char === quote) quote = void 0;
-			continue;
-		}
-		if (char === "\"" || char === "'" || char === "`") quote = char;
-		else if (/\s/u.test(char)) {
-			pendingSpace = out.length > 0;
-			continue;
-		}
-		if (pendingSpace && WORD.test(out.at(-1) ?? "") && WORD.test(char)) out += " ";
-		pendingSpace = false;
-		out += char;
-	}
-	return out;
-}
-/**
-* 把一段 TS 表达式内联进产物：传一个**无参函数**，取它的函数体，于是表达式是编译器检查过的代码，
-* 而不是手拼的字符串（`process.platform` 这类运行期判断必须留给运行期——产物在构建机上生成）。
-*
-* 函数体写**单行表达式**：多行的那份原样留着（那时压缩会动到换行与注释的位置）。
-*/
-function jsExpr(body) {
-	const text = String(body).replace(/^\(\)\s*=>\s*/, "").replace(/;\s*$/, "");
-	return { __jsExpr: text.includes("\n") ? text : compact(text) };
-}
-//#endregion
-//#region ../dsh-agent-toolkit/src/rows.ts
-const UPSTREAM_SCOPE = "@deepseek-ai/dsh-";
-/** 行 id 默认取短名（可被 extra.id 覆盖）。 */
-function named(short, name, extra) {
-	const { id, ...rest } = extra;
-	return {
-		id: id ?? short,
-		name,
-		...rest
-	};
-}
-/**
-* 上游的一行：`row("tool-fs")` → 包 `@deepseek-ai/dsh-tool-fs`、行 id `tool-fs`。
-*
-* 包名按「scope + 短名」拼（目录名不可靠：`packages/compaction/tool-result-pruner` 的包名是
-* `@deepseek-ai/dsh-compaction-tool-result-pruner`）；id 由我们自己定，默认与短名一致。
-* 带 subpath 的行（`tool-subagent-control/list-agents`）与需要短 id 的行显式给 `id`。
-*/
-function row(short, extra = {}) {
-	return named(short, `${UPSTREAM_SCOPE}${short}`, extra);
-}
-/** 一个工具族：`group("toolkit-"+族名, 行)`——组名与 `guidance/packs/` 的族文件同名（前缀见 {@link TOOLKIT_ROWS}）。 */
-function group(id, config, extra = {}) {
-	return {
-		id,
-		name: "cordis:group",
-		group: true,
-		config,
-		...extra
-	};
-}
-/**
-* 这套工具集的工具名（从汉化数据派生：**工具集与汉化同源**）。
-*
-* 谁需要它：模式的 `allowTools` 白名单——模式只声明"我要哪些"，工具行本身在 profile 平面装一次。
-*/
-const TOOLKIT_TOOL_NAMES = toolNamesOf();
-/** agent-team 那几行默认关闭：不是 `DSH_AGENT_TEAM=1` 就不装。 */
-function agentTeamDisabled() {
-	return jsExpr(() => process.env.DSH_AGENT_TEAM !== "1");
-}
-/** 跨平台的一对 shell 工具：装哪一半由运行期平台决定。 */
-const SHELL_ROWS = [row("tool-bash", { disabled: jsExpr(() => process.platform === "win32") }), row("tool-pwsh", { disabled: jsExpr(() => process.platform !== "win32") })];
-row("experimental-agent-team", {
-	id: "agent-team",
-	disabled: agentTeamDisabled(),
-	config: {
-		maxMembers: 8,
-		maxTasks: 256,
-		maxPendingMessagesPerMember: 64,
-		maxMessageBytes: 65536,
-		disposalTimeoutMs: 5e3
-	}
-}), row("experimental-tool-agent-team", {
-	id: "tool-agent-team",
-	disabled: agentTeamDisabled(),
-	config: {
-		freshProvider: "spawn",
-		forkProvider: "fork"
-	}
-}), row("experimental-client-ui-agent-team", {
-	id: "ui-agent-team",
-	disabled: agentTeamDisabled()
-});
-/**
-* 完整一套功能行（coding 用），**按工具族分组**：族顺序与 `guidance/packs/index.ts` 的族索引一致。
-* 它们引用的都是上游包，行 id 由本仓库定（见 {@link row}）。
-*
-* 组 id 是 `toolkit-<族名>`（不是裸族名）：装配按 id 全局对应，上游已有行占用 `web` / `skill` 这类短名，
-* 撞上会让两行被当作同一行（后者覆盖前者的 config，组行拿到非数组 config 直接装配失败）。
-*
-* 不含 Agent Teams 那一族（{@link TEAM_ROWS}）：团队归上游 `agent-team-profile`，我们不单独配。
-*/
-const TOOLKIT_ROWS = [
-	group("toolkit-ask", [row("tool-ask-user")]),
-	group("toolkit-delegation", [
-		row("tool-subagent-control"),
-		row("tool-subagent-control/list-agents", { id: "tool-subagent-list-agents" }),
-		row("tool-subagent", { config: {
-			provider: "spawn",
-			toolName: "subagent",
-			backgroundMode: "continuable"
-		} }),
-		row("tool-subagent", {
-			id: "tool-subagent-fork",
-			config: {
-				provider: "fork",
-				toolName: "subagent_fork",
-				backgroundMode: "continuable"
-			}
-		}),
-		row("workflow-ptc", { config: { provider: "spawn" } }),
-		row("tool-workflow")
-	], { isolate: { workflowEngine: true } }),
-	group("toolkit-flow", [
-		row("tool-todo", { config: { allowParallelInProgress: true } }),
-		row("command-goal"),
-		row("tool-goal"),
-		row("tool-present", { id: "present" })
-	]),
-	group("toolkit-fs", [row("tool-fs"), row("tool-fs-search", { config: { sampleOverCapGlobResults: false } })]),
-	group("toolkit-shell", [...SHELL_ROWS, row("tool-jobs")]),
-	group("toolkit-skill", [row("skill-filesystem")]),
-	group("toolkit-web", [row("tool-web", { config: {
-		fetch: true,
-		searchTimeoutMs: 6e4
-	} })])
-];
-/**
-* 不属于任何工具族、但归 preset 平面的行：上下文压缩（引擎，不是模型侧工具）与计划模式。
-*/
-const TOOLKIT_COMPACTION_ROWS = [group("compaction", [
-	row("compaction-basic"),
-	row("command-compact"),
-	row("compaction-tool-result-pruner", {
-		id: "tool-result-pruner",
-		config: {
-			thresholdChars: 8192,
-			headChars: 4096,
-			tailChars: 1024
-		}
-	})
-], { isolate: {
-	compaction: true,
-	toolResultPruner: true
-} })];
-/**
-* 计划模式（`plan-mode` 行 + 它的 `exit_plan_mode` 工具）：组形照上游
-* （`bundle/web-app/presets/standard.patch.yml` 的 `planning` 组：`isolate: { planMode: true }`——preset realm
-* 里的服务必须隔离，否则 mount 直接失败）。
-*
-* **规则正文由我们自己维护**（{@link PLAN_MODE_SECTION}，中文）：`@deepseek-ai/dsh-plan-mode` 的 `section` 是
-* 部署自有的必填项（`vendor/deepseek-harness/packages/plan/plan-mode/src/index.ts` 的 `resolveConfig`：缺 / 空 /
-* 多键都抛），**没有默认文案**，所以这一行必须带上它。代价是上游改 `plan-mode` 的契约（`section` 的形状、
-* `exit_plan_mode` 的行为）时要人工核对这段中文的语义。
-*/
-const TOOLKIT_PLAN_ROWS = [group("planning", [row("plan-mode", { config: { section: [
-	"你处于计划模式。在 exit_plan_mode 成功、或用户切换会话模式之前，一直留在计划模式。",
-	"",
-	"先探索：用非破坏性的读、搜索、静态分析与检查，把计划落到真实仓库上。不要做任何写操作——不改文件、不改配置、不跑会重写被跟踪文件的格式化或代码生成、不提交，也不要把计划执行掉。优先用仓库里已有的函数与写法，不要新造机制。",
-	"",
-	"用户的对话式同意（包括对你自己提问的肯定回答）不构成批准，也不结束计划模式；把确认到的决定并进计划里。",
-	"",
-	"工具目录在模式之间保持一致（请求缓存稳定），所以这些规则压过任何后续工具说明或用法正文里“去改文件”的建议；那些工具仍列在目录里，只是这一步不能用。不要用 todo_write 跟踪规划阶段：它跟的是批准之后的实施，计划本身归 exit_plan_mode。",
-	"",
-	"能自己查清的事实自己查。只有用户拥有的选择、或检查无法回答的实质歧义才用 ask_user_question；不要问代码在哪、现在怎么跑这类自己能查明的问题。",
-	"",
-	"计划要决策完备：目标与成功判据；按子系统分组的改动；公共 API、schema 与数据流的变化；边界情况与失败模式；测试与验收判据；显式假设。可审即可，不必长到别人照它实现还要自己做设计决定。",
-	"",
-	"就绪时调 exit_plan_mode，正文是完整的计划 markdown（以 # 标题开头），并让它成为那一条回复里唯一且最后的工具调用：它把计划交出去等批准，实施只在批准之后的步骤里开始。不要把最终计划当普通回复贴出来，也不要用散文或 ask_user_question 问“要不要继续”。评审驳回就吸收反馈重新提交；评审通道不可用或被中断时留在计划模式、让用户手动切模式，不要自己往下做。"
-].join("\n") } })], { isolate: { planMode: true } })];
-[...TOOLKIT_COMPACTION_ROWS, toolGuidanceRow()];
-/**
-* 策略行（不属于工具族）：放宽 fs 的写 / 改 intent——**挂本 preset 的会话不吃上游「先读后改」**。
-*
-* 为什么是"抢 waterfall 抵消"而不是"禁用上游那一行"：`fs-observation-policy` 住在 host 平面、对所有 preset
-* 生效；preset realm 里禁用同 id 的行禁不掉它，而在 host 平面禁用又会连官方 shipped preset 的会话一起失去
-* 策略。判据与实现见 [`./relax-intent.ts`](./relax-intent.ts)。
-*/
-const TOOLKIT_POLICY_ROWS = [{
-	id: "fs-intent-relax",
-	name: "@morlay/dsh-agent-toolkit/relax-intent"
-}];
-[
-	...TOOLKIT_ROWS,
-	...TOOLKIT_COMPACTION_ROWS,
-	...TOOLKIT_PLAN_ROWS,
-	...TOOLKIT_POLICY_ROWS
-];
-/** 工具说明那一行（汉化精简 + 用法分组）：实现与数据在 `./guidance` 出口，行本身也归本包。 */
-function toolGuidanceRow(config) {
-	return {
-		id: "tool-guidance",
-		name: "@morlay/dsh-agent-toolkit/guidance",
-		...config === void 0 ? {} : { config }
-	};
-}
-row("tool-ask-user"), row("tool-web");
-//#endregion
 //#region src/mode-sources.ts
-/**
-* 模式定义的真源：`session-mode` 行的 `config` 由 `./rows.ts` 渲染（装配入口在 `packages/bundles/session-mode-profile`）。
-*
-* "自定义"就落在这份数据上——装配层（profile 的用户 patch 层）可以整体改写 `config.modes`，也可以只给
-* 某个模式换提示词或工具白名单，不需要任何插件行。
-*
-* `allowTools` 从 [`@morlay/dsh-agent-toolkit/rows`](../../../dsh-agent-toolkit/src/rows.ts) 的
-* `TOOLKIT_TOOL_NAMES` 派生（工具名与汉化同源）：**行清单由本部署自己注册的那份 preset 提供**
-* （{@link MODE_PRESET_ID}，两个模式共享它），白名单里那份 preset 没有的工具自动跳过。想改某一个模式的名单，
-* 直接在这条源数据里加/减。
-*/
-/**
-* 本部署自己注册的那份 agent preset 的 id：两个模式共享它（行清单见
-* `packages/bundles/session-mode-profile`，`config.plugins` 引用 `@morlay/dsh-agent-toolkit/rows` 的
-* `TOOLKIT_PRESET_ROWS`）。
-*
-* 为什么自己注册而不是复用官方 preset：官方 `minimal` 没有 `tool-web`，`chat` 的白名单（提问 + 联网三件）
-* 收口后一件都不剩；而且官方 preset 自带的上游注入要在我们的开关之外做"让位"，抢 `skill` 面还得把目录 kind
-* 换掉。行清单归我们之后，两个模式的**差异全在会话级收口**（persona / `allowTools` / 两个开关）。
-*/
-const MODE_PRESET_ID = "mode-switch";
-/** 编码模式：编程专家 + 语言与思考纪律 + 工作目录提醒。 */
 const CODING_PERSONA = {
 	prefix: ["你是一个经验丰富的编程专家，YAGNI 是你的编程哲学，PDCA 是你的行为规范。", "全程用中文（专有名词除外），包括但不限于思考，回答，工具描述，subagent 提示词；思考不要陷入重复循环，一旦循环立即退出；思考聚焦需求理解与方案设计，不预演具体代码实现，正确性由验证环节确认。"].join("\n"),
 	suffix: "你的工作目录在 `{{cwd}}`"
 };
-/** 对话模式：一个助手，保留语言与思考纪律，没有 suffix。 */
 const CHAT_PERSONA = { prefix: "你是一个助手。全程用中文（专有名词除外），包括但不限于思考，回答，工具描述；思考不要陷入重复循环，一旦循环立即退出。" };
-/** 新会话用哪个模式（`session-mode` 行的 `config.default`）。 */
 const DEFAULT_MODE = "coding";
-/** 两个模式：编码与对话。**同一个 preset，差异全在会话级收口**。 */
 const MODE_SOURCES = [{
 	id: "coding",
-	preset: MODE_PRESET_ID,
 	name: "编码模式",
 	description: "功能完整的编码 Agent：文件、Shell、检索、联网等工具常驻，其余用法说明按需加载。",
 	persona: CODING_PERSONA,
 	role: ["main", "subagent"],
-	allowTools: [...TOOLKIT_TOOL_NAMES]
+	denyPolicies: ["fs/edit-intent"]
 }, {
 	id: "chat",
-	preset: MODE_PRESET_ID,
 	name: "对话模式",
 	description: "只做对话：提问与联网（搜索、抓取）三件工具，不注入系统提示词、工作区指令与技能目录。",
 	persona: CHAT_PERSONA,
@@ -470,25 +28,30 @@ const MODE_SOURCES = [{
 }];
 //#endregion
 //#region src/rows.ts
-/**
-* 本包作为能力包发布的**装配数据**：`session-mode` 行的 config（各模式的会话级扩展）由这里渲染，
-* 装配入口在 `packages/bundles/session-mode-profile`（它同时装注入通道、工具说明与 subagent 那几行）。
-*/
-/** 一个模式的源定义 → 行 config（schema 的输入形状：可省的字段就省）。 */
+function list(values) {
+	return values === void 0 || values.length === 0 ? void 0 : [...values];
+}
 function modeConfig(source) {
+	const allowTools = list(source.allowTools);
+	const denyTools = list(source.denyTools);
+	const allowPolicies = list(source.allowPolicies);
+	const denyPolicies = list(source.denyPolicies);
 	return {
-		preset: source.preset,
+		...source.preset === void 0 ? {} : { preset: source.preset },
 		name: source.name,
 		description: source.description,
 		...source.role === void 0 ? {} : { role: [...source.role] },
 		...source.persona === void 0 ? {} : { persona: { ...source.persona } },
-		allowTools: [...source.allowTools],
+		...allowTools === void 0 ? {} : { allowTools },
+		...denyTools === void 0 ? {} : { denyTools },
+		...allowPolicies === void 0 ? {} : { allowPolicies },
+		...denyPolicies === void 0 ? {} : { denyPolicies },
 		...source.instructions === void 0 ? {} : { instructions: source.instructions },
+		...source.skills === void 0 ? {} : { skills: source.skills },
 		...source.runtimeContext === void 0 ? {} : { runtimeContext: source.runtimeContext },
 		...source.defaultModel === void 0 ? {} : { defaultModel: { ...source.defaultModel } }
 	};
 }
-/** `session-mode` 行的装配：默认模式与各模式的扩展定义。 */
 function sessionModeRows() {
 	return [{ insert: [{
 		id: "session-mode",
@@ -500,4 +63,4 @@ function sessionModeRows() {
 	}] }];
 }
 //#endregion
-export { MODE_PRESET_ID, sessionModeRows };
+export { sessionModeRows };

package/dist/shared-DX2Giyh3.mjs

@@ -0,0 +1,5 @@
+//#region src/shared.ts
+const SESSION_MODE_PATH = "/session-mode";
+const POLICY_NAMES = ["fs/write-intent", "fs/edit-intent"];
+//#endregion
+export { SESSION_MODE_PATH as n, POLICY_NAMES as t };

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "Session modes",
-    "description": "The coding / chat modes as one row of data (persona plus the allowed tools); the host applies the current one per session, and the chip in the composer replaces the official agent-preset surface."
+    "title": "Session Modes",
+    "description": "The coding / chat modes as one row of data (persona, tool lists, upstream policy lists, instruction / skill-catalog / runtime-context switches and an optional default model); the host applies the current one per session, and the chip in the composer sits beside the official agent-preset entry, which stays."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "会话模式",
-    "description": "coding / chat 两个模式：一行数据（提示词 + 工具白名单），host 按会话应用；composer 里的模式 chip 替代官方的 agent preset 面。"
+    "description": "coding / chat 两个模式：一行数据（提示词、工具名单、上游 policy 名单、instruction / 技能目录 / 动态快照开关与可选默认模型），host 按会话应用；composer 里的模式 chip 与官方 agent preset 入口并存。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morlay/dsh-session-mode",
-  "version": "0.0.2",
-  "description": "Personal dsh bundle: session modes (coding / chat) as data — a mode is a persona plus the tools it may use. The host applies the current mode to each session, and the chip in the composer replaces the official agent-preset surface.",
+  "version": "0.0.4",
+  "description": "Personal dsh bundle: session modes (coding / chat) as data — a mode is a persona plus its tool lists, its upstream policy lists, its instruction / skill-catalog / runtime-context switches and an optional default model. The host applies the current mode to each session, and the chip in the composer sits beside the official agent-preset entry, which stays.",
   "keywords": [
     "dsh",
     "dsh-bundle",
@@ -50,17 +50,18 @@
     "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
     "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
     "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-fs": "0.2.0-rc.1",
     "@deepseek-ai/dsh-fs-local": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-fs-observation-policy": "0.2.0-rc.1",
     "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
     "@deepseek-ai/dsh-session": "0.2.0-rc.1",
     "@deepseek-ai/dsh-session-projection": "0.2.0-rc.1",
     "@deepseek-ai/dsh-skill": "0.2.0-rc.1",
     "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.1",
     "@deepseek-ai/dsh-tools": "0.2.0-rc.1",
-    "@morlay/dsh-agent-toolkit": "0.0.2",
-    "@morlay/dsh-client-ui-conversation": "0.1.1",
-    "@morlay/dsh-client-ui-primitives": "0.0.4",
-    "@morlay/dsh-context-assembler": "0.0.2",
+    "@morlay/dsh-client-ui-conversation": "0.1.3",
+    "@morlay/dsh-client-ui-primitives": "0.0.6",
+    "@morlay/dsh-context-assembler": "0.0.4",
     "@testing-library/react": "^16.3.0",
     "@types/js-yaml": "^4.0.9",
     "@types/react": "~18.3.1",
@@ -77,13 +78,14 @@
     "@deepseek-ai/dsh-client-locale": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-client-ui-primitives": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-llm": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-session": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-session-projection": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-system-prompt": "^0.2.0-rc.1",
     "@deepseek-ai/schemastery": "^3.18.4",
-    "@morlay/dsh-client-ui-conversation": "0.1.1",
-    "@morlay/dsh-client-ui-primitives": "0.0.4"
+    "@morlay/dsh-client-ui-conversation": "0.1.3",
+    "@morlay/dsh-client-ui-primitives": "0.0.6"
   },
   "dsh": {
     "client": {

package/src/client/SessionModeSeat.tsx

@@ -1,14 +1,6 @@
-/**
- * composer 里的模式 chip：**本包在会话里唯一的面**（点开是 coding / chat 两项）。
- *
- * 选择只在会话开始**之前**有效——一旦跑过 turn，那段历史是在某个模式的工具与提示词下产生的。所以 chip 在
- * 会话里有两个形态：空白期是选择器，开过 turn 之后**只读**（只写当前模式，点不动）。判据是 host 的投影
- * `sessionModeEditable`（`turn/start` 一落库就为 `false`），与服务端拒绝切换读的是同一份事实。
- *
- * 它挂在 composer 上：新会话屏也是一个 blank session 的 composer，选择正好发生在那里；会话头部则没有它的
- * 位置——头部只在"跑起来之后"值得看，而那时的 chip 已经把当前模式写在脸上，再挂一个只读标签就是同一句话的
- * 复读。
- */
+// composer 里的模式 chip：本包在会话里唯一的面（点开是 coding / chat 两项）。
+// 选择只在会话开始**之前**有效（那段历史属于某个模式的工具与提示词），所以 chip 有两个形态：空白期是选择器，
+// 开过 turn 之后只读。判据是 host 的投影 `sessionModeEditable`，与服务端拒绝切换读的是同一份事实。
 
 import { useState } from "react";
 import {
@@ -25,20 +17,12 @@ import { selectMode } from "./api.ts";
 import { useRoster } from "./use-roster.ts";
 import css from "./SessionModeSeat.module.css";
 
-/** 完整 props：composer 工具行左侧槽位的运行时 props + 本包的字典。 */
+// 完整 props：composer 工具行左侧槽位的运行时 props + 本包的字典。
 export type SessionModeSeatProps = PropsRuntime<"conversation.input.left"> &
   PropsLocale<"session-mode">;
 
-/**
- * 渲染 composer 里的模式切换 chip。
- *
- * 为什么在 composer（`conversation.input.left`）：**新会话屏也是一个 blank session 的 composer**，选择正好
- * 发生在那里；会话头部槽位在新会话屏根本不存在，而会话跑起来之后头部也不该重复说一遍 chip 已经写着的事。
- * 官方 roster 那个座位（`conversation.hero.agentPreset`）是单注册槽位、已被官方占了，所以用自己的 list 槽位
- * 并存。
- * @param props - 槽位合成的 props。
- * @returns chip；清单没读到、或会话未知时返回 null。
- */
+// 渲染 composer 里的模式切换 chip：新会话屏也是 blank session 的 composer，选择正好发生在那里；官方 roster 占了
+// 单注册槽位 `conversation.hero.agentPreset`，所以这里用自己的 list 槽位并存。清单没读到时会话未知时返回 null。
 export function SessionModeSeat({ sessionId, useSessions, t }: SessionModeSeatProps) {
   const roster = useRoster();
   const selected = useSessions((state) => {
@@ -63,8 +47,7 @@ export function SessionModeSeat({ sessionId, useSessions, t }: SessionModeSeatPr
   const chosen = roster.modes.find((mode) => mode.id === current);
   const label = chosen?.name ?? current;
 
-  // 开过 turn 的会话**只读**：chip 只写当前模式，点不动也不给清单。判据与 host 拒绝切换读的是同一个投影
-  // （`sessionModeEditable`），所以不会出现"看起来能选、点了报错"。
+  // 开过 turn 的会话只读：chip 只写当前模式、点不动（判据与 host 拒绝切换读的是同一个投影）。
   if (editable === false) {
     return (
       <button type="button" className={css.seat} disabled title={t("lockedHint")}>

package/src/client/api.ts

@@ -1,9 +1,5 @@
-/**
- * client 半与 host 的**唯一**通路：模式清单（`GET`）与切换（`POST`）。
- *
- * 当前模式不走这里——它是一条会话投影（`sessionMode`），随会话列表一起到页面，组件用 `useSessions`
- * 读它。于是这里只剩两件事：拉清单、发一次切换。
- */
+// client 半与 host 的**唯一**通路：模式清单（`GET`）与切换（`POST`）。当前模式是会话投影（`sessionMode`），
+// 随会话列表一起到页面，不走这里。
 
 import {
   SESSION_MODE_PATH,
@@ -11,7 +7,7 @@ import {
   type SessionModeSelectResult,
 } from "../shared.ts";
 
-/** 读一次模式清单；清单在页面生命周期里是静态的（装配事实），调用方自己缓存。 */
+// 读一次模式清单；清单在页面生命周期里是静态的（装配事实），调用方自己缓存。
 export async function fetchRoster(): Promise<SessionModeRoster> {
   const response = await fetch(SESSION_MODE_PATH, {
     method: "GET",
@@ -21,13 +17,7 @@ export async function fetchRoster(): Promise<SessionModeRoster> {
   return (await response.json()) as SessionModeRoster;
 }
 
-/**
- * 把某个空白会话切到某个模式。
- * @param sessionId - 目标会话。
- * @param mode - 目标模式 id。
- * @returns 提交后的模式 id。
- * @throws 会话已开始、模式不存在、会话不存在——host 给的中文原因。
- */
+// 把某个空白会话切到某个模式；失败抛 host 给的中文原因（会话已开始 / 模式不存在 / 会话不存在）。
 export async function selectMode(sessionId: string, mode: string): Promise<string> {
   const response = await fetch(SESSION_MODE_PATH, {
     method: "POST",