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

package/dist/index.d.cts

@@ -1,8 +1,127 @@
-import { a as ResolvedConfig, c as SessionModeModels, i as Config, l as SessionModePersona, n as SessionModeRoster, o as SessionMode, r as SessionModeRow, s as SessionModeModel, t as SESSION_MODE_PATH, u as SessionModeRole } from "./shared-FNWe-_rS.cjs";
-import { Context, Service } from "@deepseek-ai/cordis";
+import { Context, Service, Volatile } from "@deepseek-ai/cordis";
 import { Agent } from "@deepseek-ai/dsh-agent";
 import { Session, SessionEvent, SessionId } from "@deepseek-ai/dsh-session";
 import { z } from "zod";
+import z$1 from "@deepseek-ai/schemastery";
+//#region src/modes.d.ts
+/** 一个模式的提示词：两段文本，注册成 agent 作用域的 `deployment:persona-prefix` / `-suffix` section。 */
+interface SessionModePersona {
+  /** 系统提示词最前的一段；空串表示不遮蔽部署级那层。 */
+  readonly prefix: string;
+  /** 系统提示词最后的一段；空串表示不写。 */
+  readonly suffix: string;
+}
+/**
+ * 一个模式对谁可见：`main` 进用户选择器（会话级选择），`subagent` 表示它**可以**作为子代理的 mode。
+ * 两个角色可以同时声明；不写默认 `["main"]`——没写角色的模式不该悄悄变成子代理候选。
+ *
+ * `subagent` 目前只是候选集的声明：子代理默认继承父 mode（不看角色），"按角色指派 mode" 还没做。
+ */
+type SessionModeRole = "main" | "subagent";
+/** 一个模式的默认模型；省略的字段跟着 provider 默认走（与全局 `agent-default-model` 同形状）。 */
+interface SessionModeModel {
+  readonly provider: string;
+  readonly model: string;
+  readonly reasoningEffort?: string;
+}
+/** 退役的顶层形状：模式 id → 模型（默认模型现在住在各自的模式里）。 */
+type SessionModeModels = Readonly<Record<string, SessionModeModel>>;
+/**
+ * 一个模式：提示词 + 能力开关。
+ *
+ * 这份形状是 **schema 归一化之后**的：每个字段都有值（写配置时可以不写，schema 用默认补上——`description`
+ * 补空串、`persona` 补两段空文本、两个布尔开关补 `true`）。配置里能省略哪些字段看 `modeSchema` 的 default，
+ * 不看这里。
+ */
+interface SessionMode {
+  /**
+   * 这个模式挂在哪个 **agent preset** 上（官方 `standard` / `ptc` / `minimal` / `cordis`，或本部署自己
+   * 注册的那一份的 `id`，见 `mode-sources.ts` 的 `MODE_PRESET_ID`）。
+   *
+   * preset 决定这个 agent 有哪些行（工具 / 命令 / 压缩 / 委派…），模式只决定"这些行怎么被用"：
+   * `allowTools` 里 preset 没有的工具自动跳过，其余扩展（persona / 注入开关 / 默认模型）照常应用。
+   * **可以共享**（本部署就是两个模式挂同一份 preset，差异全在会话级收口）；共享时 preset → 模式的反查无从下手，
+   * 见 `SessionModes.modeForPreset`。空串表示不挂（只能由 applyTo / 继承使用）。
+   */
+  readonly preset: string;
+  /** 模式的展示名（选择面归官方 roster；这里留着做事实文案）。 */
+  readonly name: string;
+  /** 一句话说明这个模式干什么；空串表示没写。 */
+  readonly description: string;
+  /** 这个模式归谁用：`main`（用户选择器）/ `subagent`（可作子代理 mode）。至少一个。 */
+  readonly role: SessionModeRole[];
+  /** 该模式的提示词。 */
+  readonly persona: SessionModePersona;
+  /**
+   * 这个模式能用哪些工具；其余工具既不进模型目录、调用也被执行层拒绝，它们自己的说明 section
+   * （`tool:<工具名>`）也不留在提示词里。**至少给一个**——想要"全都要"就列出全部，别留空。
+   */
+  readonly allowTools: string[];
+  /**
+   * 是否要 instruction 类注入（工作区指令、技能目录、用法正文）。缺省要；`false` 表示这个模式一条都不要
+   * ——对话模式就是它。开关由 `@morlay/dsh-context-assembler/scope` 落到通道上。
+   */
+  readonly instructions: boolean;
+  /**
+   * 是否要 runtime context（文件沙箱策略、审批策略那两条动态快照）。缺省要；`false` 表示这个模式不要它们
+   * ——对话模式没有文件与 shell 工具，"能改工作区哪些文件、要不要走审批"对它全是噪音。
+   */
+  readonly runtimeContext: boolean;
+  /**
+   * 这个模式的默认模型；省略就跟全局 `agent-default-model`。**可选**：没配的模式在页面上不出现在这一行
+   * （`defaultModel` 是它所在模式的一个可加字段）。
+   */
+  readonly defaultModel?: SessionModeModel;
+}
+/** 本包 config 的**源码形状**：装配层与设置页写的那个形状。 */
+interface Config {
+  /** 新会话（还没选过模式的会话）用哪个模式。必须是 `modes` 里的一个 id。 */
+  readonly default: string;
+  /** 模式清单：id → 定义（含各自的 `defaultModel`）。顺序即选择器里的顺序（`Object.entries` 的插入序）。 */
+  readonly modes: Record<string, SessionMode>;
+  /**
+   * 各模式默认模型曾经住在这里（模式 id → 模型）。现在住在**每个模式自己的 `defaultModel`** 里，这个字段
+   * 只剩一件事：装配期看见它还配着值就报错，提醒把它挪进对应的模式——否则它会静静地失效。
+   */
+  readonly models?: SessionModeModels;
+}
+/**
+ * schema 解析之后的形状：volatile 字段被换成**稳定引用**，读它要过 `.get()`（设置页改的就是同一份）。
+ *
+ * `default` 与 `modes` 都是 volatile：默认模式与整份模式清单（含各自的 `defaultModel`）都在行配置页上。
+ */
+interface ResolvedConfig {
+  readonly default: Volatile<string>;
+  readonly modes: Volatile<Record<string, SessionMode>>;
+  /** 退役的顶层字段：解析后仍在这儿（普通值，不 volatile），装配期据此发现"还配着值"并报错。 */
+  readonly models: SessionModeModels;
+}
+declare const Config: z$1<Config, ResolvedConfig>;
+//#endregion
+//#region src/shared.d.ts
+/**
+ * host 半与 client 半共用的接口面：一条 HTTP 路径、模式行的对外形状、请求与响应体。
+ *
+ * 为什么不是 Typert Remote：客户端的 remote 清单（`@deepseek-ai/dsh-api-remotes/client`）由上游硬编码，
+ * 我们的服务不在里面，`ctx.remote.sessionModes` 解析不到。仓库既有的跨半通路是 HTTP 路由
+ * （见 `@morlay/ui-conversation-message-actions` 的 `/session-editor`），这里沿用同一种。
+ *
+ * 会话当前模式不走这条通路：它是一条 session 投影（`sessionMode`），随会话列表一起到页面。
+ */
+/** 模式清单与切换的路由路径：宿主（web 与桌面）在同一张路由表上服务它。 */
+declare const SESSION_MODE_PATH = "/session-mode";
+/** 一个模式对外的那部分：选择器要的名字与说明。 */
+interface SessionModeRow {
+  readonly id: string;
+  readonly name: string;
+  readonly description?: string;
+}
+/** `GET` 的响应体：清单与默认模式。 */
+interface SessionModeRoster {
+  readonly default: string;
+  readonly modes: readonly SessionModeRow[];
+}
+//#endregion
 //#region src/index.d.ts
 /** Cordis 插件名：与行 id 一致。 */
 declare const name = "session-mode";
@@ -33,10 +152,13 @@ declare module "@deepseek-ai/dsh-session/types" {
 declare module "@deepseek-ai/dsh-session-projection/types" {
   interface SessionProjectionStateMap {
     sessionMode: string | null;
+    sessionModeEditable: boolean;
   }
   interface SessionProjectionMap {
     /** 会话当前模式；`null` 表示没选过（用部署默认）。 */
     sessionMode: string | null;
+    /** 会话还能不能换模式：`true` 是选择器，`false` 是只读标签（client 那个 chip 据此变形）。 */
+    sessionModeEditable: boolean;
   }
 }
 /** 会话模式的投影：初值来自空日志（没选过就是 `null`），只被选择事件推进。 */
@@ -51,11 +173,33 @@ declare const sessionModeProjection: {
   };
   stateVersion: number;
 };
+/**
+ * 这个会话能不能换模式的投影：空白会话为 `true`，一旦 `turn/start` 落库就永远 `false`（换模式要的是**整段
+ * 历史**的模式一致，所以"开过 turn"之后连正在跑的那个 turn 也算）。
+ *
+ * **判据只有这一处**：服务端 {@link SessionModes.select} 的拒绝与 client chip 的只读形态都读它——以前
+ * client 只能等服务端报错，现在连入口都不给，而两边的结论来自同一份会话事实。
+ */
+declare const sessionModeEditableProjection: {
+  key: "sessionModeEditable";
+  stateSchema: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+  init: () => true;
+  apply: (state: boolean, event: SessionEvent) => boolean;
+  wire: {
+    viewSchema: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    view: (state: boolean) => boolean;
+  };
+  stateVersion: number;
+};
 /** 模式清单、默认模式、按会话读取与切换。 */
 declare class SessionModes extends Service {
-  config: ResolvedConfig;
   /** 每个 agent 已经装上的那一份（persona + 默认模型兜底；模式变了就换一份）。 */
   private readonly installs;
+  /** 装配时的配置快照：`default` / `modes` 读它，改这两项靠 Loader 重挂这一行（已运行会话不自动换定义）。 */
+  readonly config: {
+    default: string;
+    modes: Record<string, SessionMode>;
+  };
   constructor(ctx: Context, config: ResolvedConfig);
   /** 新会话用它：config 里的 `default`。 */
   get defaultId(): string;
@@ -86,11 +230,30 @@ declare class SessionModes extends Service {
   modeOfSession(session: Session): SessionMode;
   /**
    * 把某个空白会话切到某个模式。
+   *
+   * 模式带着它的 preset（`preset` 决定行清单），所以这里**先把 agent preset 换成模式声明的那个**，再落我们的
+   * 会话事实：否则 preset realm 还是旧那一套的行，而它的注入在我们的开关之外（旧形态 `chat` 挂 `minimal`、
+   * 会话的 preset 却还是 `standard` 时，上游 `agent-instructions` 会照旧把工作区指令注进这个"不要注入"的会话）。
+   *
+   * 目标 preset 与当前挂着的**相同时不切**（本部署两个模式共享同一份 preset，所以切模式通常走不到这一步）：
+   * 换 preset 是一次重挂（卸旧行、装新行），没有变化就没有理由付出这个代价。
    * @param sessionId - 目标会话（必须还没有开过 turn）。
    * @param mode - 目标模式 id。
    * @returns 提交后的模式 id。
    */
   select(sessionId: SessionId, mode: string): Promise<string>;
+  /**
+   * 某个 agent 当前挂着的 preset（registry 的 `composedPreset`）。
+   *
+   * 读不到时返回 `undefined`（按"未知"处理 → 该切就切）：`composedPreset` 是 registry 较新的读面，替身与老
+   * 版本可能没有它；而"没挂任何 preset"（返回值 `undefined`）与"读不到"在这里是同一个结论。
+   */
+  private presetOfAgent;
+  /**
+   * 官方 preset registry：行清单与它的选择面住在那一行。不在 `inject` 里点名（headless 部署没有它，
+   * 点名会让本行永不激活），所以按"可能拿不到"读——`ctx.get` 在当前 ctx 没声明那个服务时会抛。
+   */
+  private presetRegistry;
   /**
    * 把某个活着的 agent 切到某个模式。与 {@link select} 的差别：它不要求空白会话——子代理创建时的继承
    * 走这里，**未来的"指定 mode"入口（模型侧或配置侧）也走这里**（那条接缝还没做）。
@@ -107,18 +270,29 @@ declare class SessionModes extends Service {
    * 继承要**写进子会话日志**：它是一条会话事实，冷恢复与 fork 都要靠它重建（{@link modeOf} 只读投影）。
    */
   private resolveModeId;
+  /** 官方 roster 选定的 preset（没选过、或 registry 没装时为 `undefined`）。 */
+  private presetOf;
+  /**
+   * 某个 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: string | undefined): string | undefined;
   /** 子代理（有 durable 父会话）继承父当前模式；父不在场、或不是子代理时没有可继承的。 */
   private inheritedModeId;
   /** 装或换该 agent 的那一份（幂等：同一模式不重复注册）。 */
   private installFor;
   /**
-   * 模式的默认模型（config 顶层 `models.<模式 id>`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
+   * 模式的默认模型（`modes.<模式 id>.defaultModel`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
    * 还没跑过请求）时接管这一请求的路由；一旦用户选过（投影 `pending`）或会话已经落过 header，就不再插手。
    *
-   * 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。
-   *
-   * 模型取自 `config.models`：那是个 volatile 引用，设置页保存时只有**引用里的值**变，这一行不重挂，
-   * 所以每次请求都现场 `.get()`（与 `llm-openai-compatible` 读 `config.providers` 同一种读法）。
+   * 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。读的是构造
+   * 时那份模式清单快照：设置页保存会让这一行重挂（`reconcileProfilePatches`），新定义随重挂生效。
    */
   private installDefaultModel;
   /** 收口服务由 `@morlay/dsh-context-assembler/scope` 那一行发布；没装它就只有 persona。 */
@@ -126,4 +300,4 @@ declare class SessionModes extends Service {
 }
 declare function apply(ctx: Context, config: ResolvedConfig): void;
 //#endregion
-export { Config, type ResolvedConfig, SESSION_MODE_PATH, type SessionMode, type SessionModeModel, type SessionModeModels, type SessionModePersona, type SessionModeRole, type SessionModeRoster, type SessionModeRow, SessionModes, apply, inject, name, sessionModeProjection };
+export { Config, type ResolvedConfig, SESSION_MODE_PATH, type SessionMode, type SessionModeModel, type SessionModePersona, type SessionModeRole, type SessionModeRoster, type SessionModeRow, SessionModes, apply, inject, name, sessionModeEditableProjection, sessionModeProjection };

package/dist/index.d.mts

@@ -1,8 +1,127 @@
-import { a as ResolvedConfig, c as SessionModeModels, i as Config, l as SessionModePersona, n as SessionModeRoster, o as SessionMode, r as SessionModeRow, s as SessionModeModel, t as SESSION_MODE_PATH, u as SessionModeRole } from "./shared-FNWe-_rS.mjs";
-import { Context, Service } from "@deepseek-ai/cordis";
+import { Context, Service, Volatile } from "@deepseek-ai/cordis";
 import { z } from "zod";
+import z$1 from "@deepseek-ai/schemastery";
 import { Agent } from "@deepseek-ai/dsh-agent";
 import { Session, SessionEvent, SessionId } from "@deepseek-ai/dsh-session";
+//#region src/modes.d.ts
+/** 一个模式的提示词：两段文本，注册成 agent 作用域的 `deployment:persona-prefix` / `-suffix` section。 */
+interface SessionModePersona {
+  /** 系统提示词最前的一段；空串表示不遮蔽部署级那层。 */
+  readonly prefix: string;
+  /** 系统提示词最后的一段；空串表示不写。 */
+  readonly suffix: string;
+}
+/**
+ * 一个模式对谁可见：`main` 进用户选择器（会话级选择），`subagent` 表示它**可以**作为子代理的 mode。
+ * 两个角色可以同时声明；不写默认 `["main"]`——没写角色的模式不该悄悄变成子代理候选。
+ *
+ * `subagent` 目前只是候选集的声明：子代理默认继承父 mode（不看角色），"按角色指派 mode" 还没做。
+ */
+type SessionModeRole = "main" | "subagent";
+/** 一个模式的默认模型；省略的字段跟着 provider 默认走（与全局 `agent-default-model` 同形状）。 */
+interface SessionModeModel {
+  readonly provider: string;
+  readonly model: string;
+  readonly reasoningEffort?: string;
+}
+/** 退役的顶层形状：模式 id → 模型（默认模型现在住在各自的模式里）。 */
+type SessionModeModels = Readonly<Record<string, SessionModeModel>>;
+/**
+ * 一个模式：提示词 + 能力开关。
+ *
+ * 这份形状是 **schema 归一化之后**的：每个字段都有值（写配置时可以不写，schema 用默认补上——`description`
+ * 补空串、`persona` 补两段空文本、两个布尔开关补 `true`）。配置里能省略哪些字段看 `modeSchema` 的 default，
+ * 不看这里。
+ */
+interface SessionMode {
+  /**
+   * 这个模式挂在哪个 **agent preset** 上（官方 `standard` / `ptc` / `minimal` / `cordis`，或本部署自己
+   * 注册的那一份的 `id`，见 `mode-sources.ts` 的 `MODE_PRESET_ID`）。
+   *
+   * preset 决定这个 agent 有哪些行（工具 / 命令 / 压缩 / 委派…），模式只决定"这些行怎么被用"：
+   * `allowTools` 里 preset 没有的工具自动跳过，其余扩展（persona / 注入开关 / 默认模型）照常应用。
+   * **可以共享**（本部署就是两个模式挂同一份 preset，差异全在会话级收口）；共享时 preset → 模式的反查无从下手，
+   * 见 `SessionModes.modeForPreset`。空串表示不挂（只能由 applyTo / 继承使用）。
+   */
+  readonly preset: string;
+  /** 模式的展示名（选择面归官方 roster；这里留着做事实文案）。 */
+  readonly name: string;
+  /** 一句话说明这个模式干什么；空串表示没写。 */
+  readonly description: string;
+  /** 这个模式归谁用：`main`（用户选择器）/ `subagent`（可作子代理 mode）。至少一个。 */
+  readonly role: SessionModeRole[];
+  /** 该模式的提示词。 */
+  readonly persona: SessionModePersona;
+  /**
+   * 这个模式能用哪些工具；其余工具既不进模型目录、调用也被执行层拒绝，它们自己的说明 section
+   * （`tool:<工具名>`）也不留在提示词里。**至少给一个**——想要"全都要"就列出全部，别留空。
+   */
+  readonly allowTools: string[];
+  /**
+   * 是否要 instruction 类注入（工作区指令、技能目录、用法正文）。缺省要；`false` 表示这个模式一条都不要
+   * ——对话模式就是它。开关由 `@morlay/dsh-context-assembler/scope` 落到通道上。
+   */
+  readonly instructions: boolean;
+  /**
+   * 是否要 runtime context（文件沙箱策略、审批策略那两条动态快照）。缺省要；`false` 表示这个模式不要它们
+   * ——对话模式没有文件与 shell 工具，"能改工作区哪些文件、要不要走审批"对它全是噪音。
+   */
+  readonly runtimeContext: boolean;
+  /**
+   * 这个模式的默认模型；省略就跟全局 `agent-default-model`。**可选**：没配的模式在页面上不出现在这一行
+   * （`defaultModel` 是它所在模式的一个可加字段）。
+   */
+  readonly defaultModel?: SessionModeModel;
+}
+/** 本包 config 的**源码形状**：装配层与设置页写的那个形状。 */
+interface Config {
+  /** 新会话（还没选过模式的会话）用哪个模式。必须是 `modes` 里的一个 id。 */
+  readonly default: string;
+  /** 模式清单：id → 定义（含各自的 `defaultModel`）。顺序即选择器里的顺序（`Object.entries` 的插入序）。 */
+  readonly modes: Record<string, SessionMode>;
+  /**
+   * 各模式默认模型曾经住在这里（模式 id → 模型）。现在住在**每个模式自己的 `defaultModel`** 里，这个字段
+   * 只剩一件事：装配期看见它还配着值就报错，提醒把它挪进对应的模式——否则它会静静地失效。
+   */
+  readonly models?: SessionModeModels;
+}
+/**
+ * schema 解析之后的形状：volatile 字段被换成**稳定引用**，读它要过 `.get()`（设置页改的就是同一份）。
+ *
+ * `default` 与 `modes` 都是 volatile：默认模式与整份模式清单（含各自的 `defaultModel`）都在行配置页上。
+ */
+interface ResolvedConfig {
+  readonly default: Volatile<string>;
+  readonly modes: Volatile<Record<string, SessionMode>>;
+  /** 退役的顶层字段：解析后仍在这儿（普通值，不 volatile），装配期据此发现"还配着值"并报错。 */
+  readonly models: SessionModeModels;
+}
+declare const Config: z$1<Config, ResolvedConfig>;
+//#endregion
+//#region src/shared.d.ts
+/**
+ * host 半与 client 半共用的接口面：一条 HTTP 路径、模式行的对外形状、请求与响应体。
+ *
+ * 为什么不是 Typert Remote：客户端的 remote 清单（`@deepseek-ai/dsh-api-remotes/client`）由上游硬编码，
+ * 我们的服务不在里面，`ctx.remote.sessionModes` 解析不到。仓库既有的跨半通路是 HTTP 路由
+ * （见 `@morlay/ui-conversation-message-actions` 的 `/session-editor`），这里沿用同一种。
+ *
+ * 会话当前模式不走这条通路：它是一条 session 投影（`sessionMode`），随会话列表一起到页面。
+ */
+/** 模式清单与切换的路由路径：宿主（web 与桌面）在同一张路由表上服务它。 */
+declare const SESSION_MODE_PATH = "/session-mode";
+/** 一个模式对外的那部分：选择器要的名字与说明。 */
+interface SessionModeRow {
+  readonly id: string;
+  readonly name: string;
+  readonly description?: string;
+}
+/** `GET` 的响应体：清单与默认模式。 */
+interface SessionModeRoster {
+  readonly default: string;
+  readonly modes: readonly SessionModeRow[];
+}
+//#endregion
 //#region src/index.d.ts
 /** Cordis 插件名：与行 id 一致。 */
 declare const name = "session-mode";
@@ -33,10 +152,13 @@ declare module "@deepseek-ai/dsh-session/types" {
 declare module "@deepseek-ai/dsh-session-projection/types" {
   interface SessionProjectionStateMap {
     sessionMode: string | null;
+    sessionModeEditable: boolean;
   }
   interface SessionProjectionMap {
     /** 会话当前模式；`null` 表示没选过（用部署默认）。 */
     sessionMode: string | null;
+    /** 会话还能不能换模式：`true` 是选择器，`false` 是只读标签（client 那个 chip 据此变形）。 */
+    sessionModeEditable: boolean;
   }
 }
 /** 会话模式的投影：初值来自空日志（没选过就是 `null`），只被选择事件推进。 */
@@ -51,11 +173,33 @@ declare const sessionModeProjection: {
   };
   stateVersion: number;
 };
+/**
+ * 这个会话能不能换模式的投影：空白会话为 `true`，一旦 `turn/start` 落库就永远 `false`（换模式要的是**整段
+ * 历史**的模式一致，所以"开过 turn"之后连正在跑的那个 turn 也算）。
+ *
+ * **判据只有这一处**：服务端 {@link SessionModes.select} 的拒绝与 client chip 的只读形态都读它——以前
+ * client 只能等服务端报错，现在连入口都不给，而两边的结论来自同一份会话事实。
+ */
+declare const sessionModeEditableProjection: {
+  key: "sessionModeEditable";
+  stateSchema: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+  init: () => true;
+  apply: (state: boolean, event: SessionEvent) => boolean;
+  wire: {
+    viewSchema: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    view: (state: boolean) => boolean;
+  };
+  stateVersion: number;
+};
 /** 模式清单、默认模式、按会话读取与切换。 */
 declare class SessionModes extends Service {
-  config: ResolvedConfig;
   /** 每个 agent 已经装上的那一份（persona + 默认模型兜底；模式变了就换一份）。 */
   private readonly installs;
+  /** 装配时的配置快照：`default` / `modes` 读它，改这两项靠 Loader 重挂这一行（已运行会话不自动换定义）。 */
+  readonly config: {
+    default: string;
+    modes: Record<string, SessionMode>;
+  };
   constructor(ctx: Context, config: ResolvedConfig);
   /** 新会话用它：config 里的 `default`。 */
   get defaultId(): string;
@@ -86,11 +230,30 @@ declare class SessionModes extends Service {
   modeOfSession(session: Session): SessionMode;
   /**
    * 把某个空白会话切到某个模式。
+   *
+   * 模式带着它的 preset（`preset` 决定行清单），所以这里**先把 agent preset 换成模式声明的那个**，再落我们的
+   * 会话事实：否则 preset realm 还是旧那一套的行，而它的注入在我们的开关之外（旧形态 `chat` 挂 `minimal`、
+   * 会话的 preset 却还是 `standard` 时，上游 `agent-instructions` 会照旧把工作区指令注进这个"不要注入"的会话）。
+   *
+   * 目标 preset 与当前挂着的**相同时不切**（本部署两个模式共享同一份 preset，所以切模式通常走不到这一步）：
+   * 换 preset 是一次重挂（卸旧行、装新行），没有变化就没有理由付出这个代价。
    * @param sessionId - 目标会话（必须还没有开过 turn）。
    * @param mode - 目标模式 id。
    * @returns 提交后的模式 id。
    */
   select(sessionId: SessionId, mode: string): Promise<string>;
+  /**
+   * 某个 agent 当前挂着的 preset（registry 的 `composedPreset`）。
+   *
+   * 读不到时返回 `undefined`（按"未知"处理 → 该切就切）：`composedPreset` 是 registry 较新的读面，替身与老
+   * 版本可能没有它；而"没挂任何 preset"（返回值 `undefined`）与"读不到"在这里是同一个结论。
+   */
+  private presetOfAgent;
+  /**
+   * 官方 preset registry：行清单与它的选择面住在那一行。不在 `inject` 里点名（headless 部署没有它，
+   * 点名会让本行永不激活），所以按"可能拿不到"读——`ctx.get` 在当前 ctx 没声明那个服务时会抛。
+   */
+  private presetRegistry;
   /**
    * 把某个活着的 agent 切到某个模式。与 {@link select} 的差别：它不要求空白会话——子代理创建时的继承
    * 走这里，**未来的"指定 mode"入口（模型侧或配置侧）也走这里**（那条接缝还没做）。
@@ -107,18 +270,29 @@ declare class SessionModes extends Service {
    * 继承要**写进子会话日志**：它是一条会话事实，冷恢复与 fork 都要靠它重建（{@link modeOf} 只读投影）。
    */
   private resolveModeId;
+  /** 官方 roster 选定的 preset（没选过、或 registry 没装时为 `undefined`）。 */
+  private presetOf;
+  /**
+   * 某个 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: string | undefined): string | undefined;
   /** 子代理（有 durable 父会话）继承父当前模式；父不在场、或不是子代理时没有可继承的。 */
   private inheritedModeId;
   /** 装或换该 agent 的那一份（幂等：同一模式不重复注册）。 */
   private installFor;
   /**
-   * 模式的默认模型（config 顶层 `models.<模式 id>`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
+   * 模式的默认模型（`modes.<模式 id>.defaultModel`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
    * 还没跑过请求）时接管这一请求的路由；一旦用户选过（投影 `pending`）或会话已经落过 header，就不再插手。
    *
-   * 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。
-   *
-   * 模型取自 `config.models`：那是个 volatile 引用，设置页保存时只有**引用里的值**变，这一行不重挂，
-   * 所以每次请求都现场 `.get()`（与 `llm-openai-compatible` 读 `config.providers` 同一种读法）。
+   * 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。读的是构造
+   * 时那份模式清单快照：设置页保存会让这一行重挂（`reconcileProfilePatches`），新定义随重挂生效。
    */
   private installDefaultModel;
   /** 收口服务由 `@morlay/dsh-context-assembler/scope` 那一行发布；没装它就只有 persona。 */
@@ -126,4 +300,4 @@ declare class SessionModes extends Service {
 }
 declare function apply(ctx: Context, config: ResolvedConfig): void;
 //#endregion
-export { Config, type ResolvedConfig, SESSION_MODE_PATH, type SessionMode, type SessionModeModel, type SessionModeModels, type SessionModePersona, type SessionModeRole, type SessionModeRoster, type SessionModeRow, SessionModes, apply, inject, name, sessionModeProjection };
+export { Config, type ResolvedConfig, SESSION_MODE_PATH, type SessionMode, type SessionModeModel, type SessionModePersona, type SessionModeRole, type SessionModeRoster, type SessionModeRow, SessionModes, apply, inject, name, sessionModeEditableProjection, sessionModeProjection };