@morlay/dsh-session-mode 0.0.1-alpha.4 → 0.0.1

package/dist/index.mjs

@@ -5,6 +5,11 @@ import { z } from "zod";
 import z$1 from "@deepseek-ai/schemastery";
 import { PERSONA_PREFIX_SECTION, PERSONA_SUFFIX_SECTION } from "@deepseek-ai/dsh-system-prompt";
 //#region src/modes.ts
+/**
+* 本地化说明：`description()` 的类型签名只声明 `string`，而 meta 本身接受 `Dict<string>`
+* （`vendor/schemastery/src/index.ts` 的 `mergeDesc` 就是按字典合并的），所以这里只做一次类型放行。
+*/
+const localized = (text) => text;
 const personaSchema = z$1.object({
 	prefix: z$1.string().default(""),
 	suffix: z$1.string().default("")
@@ -13,23 +18,72 @@ const personaSchema = z$1.object({
 const roleSchema = z$1.union([z$1.const("main"), z$1.const("subagent")]);
 /** 默认模型的形状与全局 `agent-default-model` 一致；省略 effort 就跟 provider 默认。 */
 const modelSchema = z$1.object({
-	provider: z$1.string().required(),
-	model: z$1.string().required(),
-	reasoningEffort: z$1.string()
+	provider: z$1.string().role("select", { source: "llm-providers" }).description(localized({
+		zh: "服务商 id（部署里注册的任意路由，不论哪个适配器插件注册的）。",
+		en: "Provider id (any route registered in this deployment, whichever adapter plugin supplies it)."
+	})),
+	model: z$1.string().role("select", { source: "llm-models" }).description(localized({
+		zh: "模型 id。",
+		en: "Model id."
+	})),
+	reasoningEffort: z$1.string().description(localized({
+		zh: "思考档位；省略就跟服务商自己的默认。",
+		en: "Reasoning effort; unset keeps the provider's own default."
+	}))
 });
 const modeSchema = z$1.object({
-	name: z$1.string().required(),
-	description: z$1.string().default(""),
-	role: z$1.array(roleSchema).default(["main"]),
+	preset: z$1.string().default("").description(localized({
+		zh: "这个模式挂哪个 agent preset（它的 id，官方或本部署自建的）：行清单由那个 preset 提供，几个模式可以共享同一个；空串表示不挂（只能由 applyTo / 继承使用）。",
+		en: "Which agent preset this mode rides on (its id, shipped or deployment-owned): that preset supplies the row list and several modes may share it; empty means none (usable only through applyTo / inheritance)."
+	})),
+	name: z$1.string().required().description(localized({
+		zh: "模式名（事实文案；选择面归官方 roster）。",
+		en: "Mode name (fact copy; the picker belongs to the official roster)."
+	})),
+	description: z$1.string().default("").description(localized({
+		zh: "一句话说明。",
+		en: "One-line description."
+	})),
+	role: z$1.array(roleSchema).default(["main"]).description(localized({
+		zh: "谁可以用这个模式：`main`（会话选择器里可选）或 `subagent`（子代理继承）。",
+		en: "Who may use this mode: `main` (selectable in sessions) or `subagent` (inherited by subagents)."
+	})),
 	persona: personaSchema.default({}),
-	allowTools: z$1.array(z$1.string()).default([]),
-	instructions: z$1.boolean().default(true),
-	runtimeContext: z$1.boolean().default(true)
+	allowTools: z$1.array(z$1.string()).default([]).description(localized({
+		zh: "这个会话能用的工具；其余既不进目录，调用也被拒。",
+		en: "Tools this session may use; everything else leaves the catalog and calls are refused."
+	})),
+	instructions: z$1.boolean().default(true).description(localized({
+		zh: "是否要 instruction 类注入（工作区指令、技能目录、用法正文）。",
+		en: "Whether instruction-class injections apply (workspace instructions, skill catalog, guidance)."
+	})),
+	runtimeContext: z$1.boolean().default(true).description(localized({
+		zh: "是否要动态快照（文件沙箱策略、审批策略）。",
+		en: "Whether the runtime snapshot applies (sandbox and approval policy)."
+	})),
+	/**
+	* 这个模式的默认模型。不标 `volatile`：`modes` 本身就是 volatile，整棵子树都在页面上——再标一层会被
+	* schemastery 拒（`validateVolatileSchema` 不许 volatile 套 volatile）。
+	*/
+	defaultModel: modelSchema.default(null).description(localized({
+		zh: "这个模式的默认模型；省略就跟全局默认模型。只在会话还没有模型事实时接管。",
+		en: "Default model for this mode; unset follows the global default. Applies only while a session has no model fact yet."
+	}))
 });
 const Config = z$1.object({
-	default: z$1.string().required(),
-	modes: z$1.dict(modeSchema).required(),
-	models: z$1.dict(modelSchema).default({}).volatile()
+	default: z$1.string().required().description(localized({
+		zh: "新会话（还没选过模式的会话）用哪个模式；必须是下面 `modes` 里的一个 id。",
+		en: "Mode a session starts in before anyone picks one; must be an id in `modes`."
+	})).volatile(),
+	modes: z$1.dict(modeSchema).required().description(localized({
+		zh: "模式清单：id → 定义（persona / 允许的工具 / 角色）。改它对**已运行会话**不自动生效——重挂后新建的会话、或重新应用模式的会话才用新定义。",
+		en: "Mode roster: id to definition (persona, allowed tools, role). Edits do not follow into already-running sessions; sessions created after the row is remounted use the new definition."
+	})).volatile(),
+	/**
+	* 退役字段：默认模型住在每个模式自己的 `defaultModel` 里。这里留着是为了**报错**（见 `configProblem`），
+	* 页面上不出现（`hidden()`）。
+	*/
+	models: z$1.dict(modelSchema).default({}).hidden()
 });
 /** 模式定义里不合法的地方（装配期 fail loud，而不是等到某个会话装配提示词时才发现）。 */
 function configProblem(config) {
@@ -43,10 +97,13 @@ function configProblem(config) {
 	if (!roles(config.default).includes("main")) return `session-mode: \`default\` names ${JSON.stringify(config.default)}, which does not declare role "main"; a session that can never be re-selected is a contradiction`;
 	const empty = ids.filter((id) => (config.modes[id]?.allowTools ?? []).length === 0);
 	if (empty.length > 0) return `session-mode: mode(s) ${empty.join(", ")} declare no \`allowTools\`; list the tools instead of leaving it empty`;
-	const unknown = Object.keys(config.models ?? {}).filter((id) => !ids.includes(id));
-	if (unknown.length > 0) return `session-mode: \`models\` names unknown mode(s) ${unknown.join(", ")}; available are ${ids.join(", ")}`;
-	const partial = Object.entries(config.models ?? {}).filter(([, model]) => model.provider === void 0 || model.model === void 0 || model.provider.length === 0 || model.model.length === 0).map(([id]) => id);
-	if (partial.length > 0) return `session-mode: mode(s) ${partial.join(", ")} declare \`models\` without both \`provider\` and \`model\``;
+	if (Object.keys(config.models ?? {}).length > 0) return "session-mode: `models` has moved into each mode's `defaultModel`; move the entries there and drop the top-level `models`";
+	const partial = Object.entries(config.modes).filter(([, mode]) => {
+		const model = mode.defaultModel;
+		if (model === void 0) return false;
+		return model.provider === void 0 || model.model === void 0 || model.provider.length === 0 || model.model.length === 0;
+	}).map(([id]) => id);
+	if (partial.length > 0) return `session-mode: mode(s) ${partial.join(", ")} declare \`defaultModel\` without both \`provider\` and \`model\``;
 }
 //#endregion
 //#region src/persona.ts
@@ -126,23 +183,54 @@ const sessionModeProjection = {
 	},
 	stateVersion: 1
 };
+const sessionModeEditableSchema = z.boolean();
+/**
+* 这个会话能不能换模式的投影：空白会话为 `true`，一旦 `turn/start` 落库就永远 `false`（换模式要的是**整段
+* 历史**的模式一致，所以"开过 turn"之后连正在跑的那个 turn 也算）。
+*
+* **判据只有这一处**：服务端 {@link SessionModes.select} 的拒绝与 client chip 的只读形态都读它——以前
+* client 只能等服务端报错，现在连入口都不给，而两边的结论来自同一份会话事实。
+*/
+const sessionModeEditableProjection = {
+	key: "sessionModeEditable",
+	stateSchema: sessionModeEditableSchema,
+	init: () => true,
+	apply: (state, event) => state && event.type !== "turn/start",
+	wire: {
+		viewSchema: sessionModeEditableSchema,
+		view: (state) => state
+	},
+	stateVersion: 1
+};
 /** 模式清单、默认模式、按会话读取与切换。 */
 var SessionModes = class extends Service {
-	config;
 	/** 每个 agent 已经装上的那一份（persona + 默认模型兜底；模式变了就换一份）。 */
 	installs = /* @__PURE__ */ new WeakMap();
+	/** 装配时的配置快照：`default` / `modes` 读它，改这两项靠 Loader 重挂这一行（已运行会话不自动换定义）。 */
+	config;
 	constructor(ctx, config) {
 		super(ctx, "sessionModes");
-		this.config = config;
+		this.config = {
+			default: config.default.get(),
+			modes: structuredClone(config.modes.get())
+		};
 		const problem = configProblem({
-			...config,
-			models: config.models.get()
+			...this.config,
+			models: config.models
 		});
 		if (problem !== void 0) throw new Error(problem);
 		ctx.sessionProjections.register(sessionModeProjection);
+		ctx.sessionProjections.register(sessionModeEditableProjection);
 		ctx.on("agent/created", ({ agent }) => {
 			this.installFor(agent);
 		});
+		ctx.on("agent-preset/selected", (sessionId, preset) => {
+			const mapped = this.modeForPreset(preset);
+			const agent = ctx.agents.get(sessionId);
+			if (mapped === void 0 || agent === void 0) return;
+			if (this.ctx.sessionProjections.stateOf(agent.session, "sessionMode") !== mapped) agent.session.append("session-mode/selected", { sessionMode: mapped });
+			this.installFor(agent, mapped);
+		});
 	}
 	/** 新会话用它：config 里的 `default`。 */
 	get defaultId() {
@@ -202,22 +290,59 @@ var SessionModes = class extends Service {
 	}
 	/**
 	* 把某个空白会话切到某个模式。
+	*
+	* 模式带着它的 preset（`preset` 决定行清单），所以这里**先把 agent preset 换成模式声明的那个**，再落我们的
+	* 会话事实：否则 preset realm 还是旧那一套的行，而它的注入在我们的开关之外（旧形态 `chat` 挂 `minimal`、
+	* 会话的 preset 却还是 `standard` 时，上游 `agent-instructions` 会照旧把工作区指令注进这个"不要注入"的会话）。
+	*
+	* 目标 preset 与当前挂着的**相同时不切**（本部署两个模式共享同一份 preset，所以切模式通常走不到这一步）：
+	* 换 preset 是一次重挂（卸旧行、装新行），没有变化就没有理由付出这个代价。
 	* @param sessionId - 目标会话（必须还没有开过 turn）。
 	* @param mode - 目标模式 id。
 	* @returns 提交后的模式 id。
 	*/
 	async select(sessionId, mode) {
-		if (!this.definition(mode).role.includes("main")) throw new Error(`模式 ${JSON.stringify(mode)} 不是用户可选的（它的 role 里没有 main）。`);
+		const definition = this.definition(mode);
+		if (!definition.role.includes("main")) throw new Error(`模式 ${JSON.stringify(mode)} 不是用户可选的（它的 role 里没有 main）。`);
 		const session = this.ctx.sessions.get(sessionId);
 		if (session === void 0) throw new Error(`未知的会话 ${sessionId}`);
-		const boundary = this.ctx.sessionProjections.stateOf(session, "turnBoundary");
-		if (boundary !== void 0 && (boundary.openTurnStartSeq !== null || boundary.lastTurn > 0)) throw new Error("这个会话已经开始，模式不能再改；要换模式请新开一个会话。");
-		session.append("session-mode/selected", { sessionMode: mode });
+		if (this.ctx.sessionProjections.stateOf(session, "sessionModeEditable") === false) throw new Error("这个会话已经开始，模式不能再改；要换模式请新开一个会话。");
 		const agent = this.ctx.agents.get(sessionId);
+		const registry = this.presetRegistry();
+		if (agent !== void 0 && registry !== void 0 && definition.preset.length > 0) {
+			if (this.presetOfAgent(registry, agent) !== definition.preset) await registry.select(agent, definition.preset);
+		}
+		if (this.ctx.sessionProjections.stateOf(session, "sessionMode") !== mode) session.append("session-mode/selected", { sessionMode: mode });
 		if (agent !== void 0) this.installFor(agent);
 		return mode;
 	}
 	/**
+	* 某个 agent 当前挂着的 preset（registry 的 `composedPreset`）。
+	*
+	* 读不到时返回 `undefined`（按"未知"处理 → 该切就切）：`composedPreset` 是 registry 较新的读面，替身与老
+	* 版本可能没有它；而"没挂任何 preset"（返回值 `undefined`）与"读不到"在这里是同一个结论。
+	*/
+	presetOfAgent(registry, agent) {
+		const read = registry.composedPreset;
+		if (typeof read !== "function") return void 0;
+		try {
+			return read.call(registry, agent.ctx);
+		} catch {
+			return;
+		}
+	}
+	/**
+	* 官方 preset registry：行清单与它的选择面住在那一行。不在 `inject` 里点名（headless 部署没有它，
+	* 点名会让本行永不激活），所以按"可能拿不到"读——`ctx.get` 在当前 ctx 没声明那个服务时会抛。
+	*/
+	presetRegistry() {
+		try {
+			return this.ctx.get("agentPresets");
+		} catch {
+			return;
+		}
+	}
+	/**
 	* 把某个活着的 agent 切到某个模式。与 {@link select} 的差别：它不要求空白会话——子代理创建时的继承
 	* 走这里，**未来的"指定 mode"入口（模型侧或配置侧）也走这里**（那条接缝还没做）。
 	* @param agent - 目标 agent。
@@ -237,11 +362,40 @@ var SessionModes = class extends Service {
 	resolveModeId(agent) {
 		const selected = this.ctx.sessionProjections.stateOf(agent.session, "sessionMode");
 		if (typeof selected === "string") return selected;
+		const mapped = this.modeForPreset(this.presetOf(agent.session));
+		if (mapped !== void 0) {
+			agent.session.append("session-mode/selected", { sessionMode: mapped });
+			return mapped;
+		}
 		const inherited = this.inheritedModeId(agent);
 		if (inherited === void 0) return this.defaultId;
 		agent.session.append("session-mode/selected", { sessionMode: inherited });
 		return inherited;
 	}
+	/** 官方 roster 选定的 preset（没选过、或 registry 没装时为 `undefined`）。 */
+	presetOf(session) {
+		try {
+			const state = this.ctx.sessionProjections.stateOf(session, "agentPreset");
+			return typeof state === "string" ? state : void 0;
+		} catch {
+			return;
+		}
+	}
+	/**
+	* 某个 agent preset 对应的模式 id——**只在映射唯一时**回答（几个模式挂同一份 preset 时返回
+	* `undefined`，不反查）。
+	*
+	* 本部署的两个模式共享同一个 preset（`MODE_PRESET_ID`），差异全在会话级收口，所以 preset → 模式的反查在
+	* 这里无意义：模式由**会话事实**决定（`session-mode/selected` 投影 → 子代理继承 → 部署默认），
+	* 官方 roster 选了什么 preset 不改变这个会话是哪个模式。这条反查留给"一对一映射"的部署形态。
+	* @param preset - preset id（`undefined` 表示没选过、或 registry 没装）。
+	* @returns 该 preset 唯一对应的模式 id；没配扩展、或由多个模式共享时 `undefined`。
+	*/
+	modeForPreset(preset) {
+		if (preset === void 0) return void 0;
+		const owners = Object.keys(this.config.modes).filter((id) => this.config.modes[id]?.preset === preset);
+		return owners.length === 1 ? owners[0] : void 0;
+	}
 	/** 子代理（有 durable 父会话）继承父当前模式；父不在场、或不是子代理时没有可继承的。 */
 	inheritedModeId(agent) {
 		const parentId = agent.session.header.parentSession;
@@ -265,18 +419,16 @@ var SessionModes = class extends Service {
 		this.toolScope()?.apply(agent, mode);
 	}
 	/**
-	* 模式的默认模型（config 顶层 `models.<模式 id>`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
+	* 模式的默认模型（`modes.<模式 id>.defaultModel`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
 	* 还没跑过请求）时接管这一请求的路由；一旦用户选过（投影 `pending`）或会话已经落过 header，就不再插手。
 	*
-	* 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。
-	*
-	* 模型取自 `config.models`：那是个 volatile 引用，设置页保存时只有**引用里的值**变，这一行不重挂，
-	* 所以每次请求都现场 `.get()`（与 `llm-openai-compatible` 读 `config.providers` 同一种读法）。
+	* 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。读的是构造
+	* 时那份模式清单快照：设置页保存会让这一行重挂（`reconcileProfilePatches`），新定义随重挂生效。
 	*/
 	installDefaultModel(agent, modeId) {
 		return agent.ctx.on("agent/request", async (_payload, next) => {
 			const resolved = await next();
-			const model = this.config.models.get()[modeId];
+			const model = this.config.modes[modeId]?.defaultModel;
 			if (model === void 0) return resolved;
 			const pending = this.ctx.sessionProjections.stateOf(agent.session, "modelSelection")?.pending;
 			if (pending !== void 0 && pending !== null) return resolved;
@@ -365,4 +517,4 @@ function registerHttpRoutes(ctx, modes) {
 	});
 }
 //#endregion
-export { Config, SESSION_MODE_PATH, SessionModes, apply, inject, name, sessionModeProjection };
+export { Config, SESSION_MODE_PATH, SessionModes, apply, inject, name, sessionModeEditableProjection, sessionModeProjection };

package/dist/rows.d.cts

@@ -0,0 +1,38 @@
+//#region src/mode-sources.d.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` / 两个开关）。
+ */
+declare const MODE_PRESET_ID = "mode-switch";
+//#endregion
+//#region src/rows.d.ts
+/** 一行装配条目：与 `cordis.patch.yml` 的顶层结构同形。 */
+interface PatchRow {
+  readonly insert?: readonly RowEntry[];
+}
+/** `insert` 里的一个条目。 */
+interface RowEntry {
+  readonly id: string;
+  readonly name: string;
+  readonly config?: Readonly<Record<string, unknown>>;
+}
+/** `session-mode` 行的装配：默认模式与各模式的扩展定义。 */
+declare function sessionModeRows(): readonly PatchRow[];
+//#endregion
+export { MODE_PRESET_ID, PatchRow, RowEntry, sessionModeRows };

package/dist/rows.d.mts

@@ -0,0 +1,38 @@
+//#region src/mode-sources.d.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` / 两个开关）。
+ */
+declare const MODE_PRESET_ID = "mode-switch";
+//#endregion
+//#region src/rows.d.ts
+/** 一行装配条目：与 `cordis.patch.yml` 的顶层结构同形。 */
+interface PatchRow {
+  readonly insert?: readonly RowEntry[];
+}
+/** `insert` 里的一个条目。 */
+interface RowEntry {
+  readonly id: string;
+  readonly name: string;
+  readonly config?: Readonly<Record<string, unknown>>;
+}
+/** `session-mode` 行的装配：默认模式与各模式的扩展定义。 */
+declare function sessionModeRows(): readonly PatchRow[];
+//#endregion
+export { MODE_PRESET_ID, PatchRow, RowEntry, sessionModeRows };