@morlay/dsh-session-mode 0.0.1 → 0.0.3

package/dist/index.d.cts

@@ -4,134 +4,60 @@ 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 denyTools: string[];
+  readonly allowPolicies: string[];
+  readonly denyPolicies: string[];
   readonly instructions: boolean;
-  /**
-   * 是否要 runtime context（文件沙箱策略、审批策略那两条动态快照）。缺省要；`false` 表示这个模式不要它们
-   * ——对话模式没有文件与 shell 工具，"能改工作区哪些文件、要不要走审批"对它全是噪音。
-   */
+  readonly skills?: boolean;
   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";
-/** 一个模式对外的那部分：选择器要的名字与说明。 */
+declare const POLICY_NAMES: readonly ["fs/write-intent", "fs/edit-intent"];
+type PolicyName = (typeof POLICY_NAMES)[number];
 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";
-/**
- * 依赖：投影服务（登记 `sessionMode`、读 `turnBoundary`）、读会话与 agent 的两个注册表，以及提示词注册表
- * （persona 的 section 注册在它上面）。
- *
- * 这些名字必须在 `inject` 里点名：cordis 的**属性访问**（`this.ctx.sessions`）要求本 fiber 声明过那个服务，
- * 未声明会抛 `cannot get property "sessions" without inject`（`ctx.get(name)` 才不需要声明）。
- */
 declare const inject: string[];
 declare module "@deepseek-ai/cordis" {
   interface Context {
@@ -140,10 +66,6 @@ declare module "@deepseek-ai/cordis" {
 }
 declare module "@deepseek-ai/dsh-session/types" {
   interface SessionEventMap {
-    /**
-     * 会话在空白窗口里换了模式。**log-only**：它记录此后每一步实际运行的模式，恢复与 fork 时据此重建
-     * （模式决定模型看到的工具与提示词，所以它必须进日志）。
-     */
     "session-mode/selected": {
       sessionMode: string;
     };
@@ -155,13 +77,10 @@ declare module "@deepseek-ai/dsh-session-projection/types" {
     sessionModeEditable: boolean;
   }
   interface SessionProjectionMap {
-    /** 会话当前模式；`null` 表示没选过（用部署默认）。 */
     sessionMode: string | null;
-    /** 会话还能不能换模式：`true` 是选择器，`false` 是只读标签（client 那个 chip 据此变形）。 */
     sessionModeEditable: boolean;
   }
 }
-/** 会话模式的投影：初值来自空日志（没选过就是 `null`），只被选择事件推进。 */
 declare const sessionModeProjection: {
   key: "sessionMode";
   stateSchema: z.ZodType<string | null, unknown, z.core.$ZodTypeInternals<string | null, unknown>>;
@@ -173,13 +92,6 @@ 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>>;
@@ -191,113 +103,40 @@ declare const sessionModeEditableProjection: {
   };
   stateVersion: number;
 };
-/** 模式清单、默认模式、按会话读取与切换。 */
 declare class SessionModes extends Service {
-  /** 每个 agent 已经装上的那一份（persona + 默认模型兜底；模式变了就换一份）。 */
   private readonly installs;
-  /** 装配时的配置快照：`default` / `modes` 读它，改这两项靠 Loader 重挂这一行（已运行会话不自动换定义）。 */
+  private readonly scope;
   readonly config: {
     default: string;
     modes: Record<string, SessionMode>;
   };
   constructor(ctx: Context, config: ResolvedConfig);
-  /** 新会话用它：config 里的 `default`。 */
   get defaultId(): string;
-  /** 选择器要的清单：只列 `main` 角色的模式（id、展示名、说明，顺序即 config 里 `modes` 的插入序）。 */
   list(): SessionModeRow[];
-  /**
-   * 声明了某个角色的模式 id（顺序即 config 的插入序）：`main` 给用户选择器，`subagent` 给子代理候选。
-   * @param role - 目标角色。
-   * @returns 该角色下的模式 id。
-   */
   idsFor(role: SessionModeRole): string[];
-  /**
-   * 同 {@link idsFor}，给的是定义——"指定 mode" 那条接缝要拿候选集。
-   * @param role - 目标角色。
-   * @returns 该角色下的模式与其定义。
-   */
   modesFor(role: SessionModeRole): {
     id: string;
     mode: SessionMode;
   }[];
-  /** 页面用的清单 + 默认模式。 */
   roster(): SessionModeRoster;
-  /** 按 id 取定义；未知 id 直接抛（切换路径上它就是用户的错）。 */
   definition(id?: string): SessionMode;
-  /** 会话当前模式：投影上有就用它，否则是部署默认。 */
   modeOf(session: Session): string;
-  /** 会话当前模式的定义。 */
   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。
-   */
+  private policyInForce;
+  private decidePolicy;
   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"入口（模型侧或配置侧）也走这里**（那条接缝还没做）。
-   * @param agent - 目标 agent。
-   * @param mode - 目标模式 id。
-   * @param options.record - 是否把这次切换写进会话日志（缺省写；只想改当前进程时给 `false`）。
-   */
   applyTo(agent: Agent, mode: string, options?: {
     record?: boolean;
   }): void;
-  /**
-   * 该 agent 用哪个模式：会话选过（投影上有）优先，子代理继承父，其余用部署默认。
-   *
-   * 继承要**写进子会话日志**：它是一条会话事实，冷恢复与 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;
-  /**
-   * 模式的默认模型（`modes.<模式 id>.defaultModel`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
-   * 还没跑过请求）时接管这一请求的路由；一旦用户选过（投影 `pending`）或会话已经落过 header，就不再插手。
-   *
-   * 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。读的是构造
-   * 时那份模式清单快照：设置页保存会让这一行重挂（`reconcileProfilePatches`），新定义随重挂生效。
-   */
   private installDefaultModel;
-  /** 收口服务由 `@morlay/dsh-context-assembler/scope` 那一行发布；没装它就只有 persona。 */
-  private toolScope;
 }
 declare function apply(ctx: Context, config: ResolvedConfig): void;
 //#endregion
-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 };
+export { Config, POLICY_NAMES, type PolicyName, 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

@@ -4,134 +4,60 @@ 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 denyTools: string[];
+  readonly allowPolicies: string[];
+  readonly denyPolicies: string[];
   readonly instructions: boolean;
-  /**
-   * 是否要 runtime context（文件沙箱策略、审批策略那两条动态快照）。缺省要；`false` 表示这个模式不要它们
-   * ——对话模式没有文件与 shell 工具，"能改工作区哪些文件、要不要走审批"对它全是噪音。
-   */
+  readonly skills?: boolean;
   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";
-/** 一个模式对外的那部分：选择器要的名字与说明。 */
+declare const POLICY_NAMES: readonly ["fs/write-intent", "fs/edit-intent"];
+type PolicyName = (typeof POLICY_NAMES)[number];
 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";
-/**
- * 依赖：投影服务（登记 `sessionMode`、读 `turnBoundary`）、读会话与 agent 的两个注册表，以及提示词注册表
- * （persona 的 section 注册在它上面）。
- *
- * 这些名字必须在 `inject` 里点名：cordis 的**属性访问**（`this.ctx.sessions`）要求本 fiber 声明过那个服务，
- * 未声明会抛 `cannot get property "sessions" without inject`（`ctx.get(name)` 才不需要声明）。
- */
 declare const inject: string[];
 declare module "@deepseek-ai/cordis" {
   interface Context {
@@ -140,10 +66,6 @@ declare module "@deepseek-ai/cordis" {
 }
 declare module "@deepseek-ai/dsh-session/types" {
   interface SessionEventMap {
-    /**
-     * 会话在空白窗口里换了模式。**log-only**：它记录此后每一步实际运行的模式，恢复与 fork 时据此重建
-     * （模式决定模型看到的工具与提示词，所以它必须进日志）。
-     */
     "session-mode/selected": {
       sessionMode: string;
     };
@@ -155,13 +77,10 @@ declare module "@deepseek-ai/dsh-session-projection/types" {
     sessionModeEditable: boolean;
   }
   interface SessionProjectionMap {
-    /** 会话当前模式；`null` 表示没选过（用部署默认）。 */
     sessionMode: string | null;
-    /** 会话还能不能换模式：`true` 是选择器，`false` 是只读标签（client 那个 chip 据此变形）。 */
     sessionModeEditable: boolean;
   }
 }
-/** 会话模式的投影：初值来自空日志（没选过就是 `null`），只被选择事件推进。 */
 declare const sessionModeProjection: {
   key: "sessionMode";
   stateSchema: z.ZodType<string | null, unknown, z.core.$ZodTypeInternals<string | null, unknown>>;
@@ -173,13 +92,6 @@ 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>>;
@@ -191,113 +103,40 @@ declare const sessionModeEditableProjection: {
   };
   stateVersion: number;
 };
-/** 模式清单、默认模式、按会话读取与切换。 */
 declare class SessionModes extends Service {
-  /** 每个 agent 已经装上的那一份（persona + 默认模型兜底；模式变了就换一份）。 */
   private readonly installs;
-  /** 装配时的配置快照：`default` / `modes` 读它，改这两项靠 Loader 重挂这一行（已运行会话不自动换定义）。 */
+  private readonly scope;
   readonly config: {
     default: string;
     modes: Record<string, SessionMode>;
   };
   constructor(ctx: Context, config: ResolvedConfig);
-  /** 新会话用它：config 里的 `default`。 */
   get defaultId(): string;
-  /** 选择器要的清单：只列 `main` 角色的模式（id、展示名、说明，顺序即 config 里 `modes` 的插入序）。 */
   list(): SessionModeRow[];
-  /**
-   * 声明了某个角色的模式 id（顺序即 config 的插入序）：`main` 给用户选择器，`subagent` 给子代理候选。
-   * @param role - 目标角色。
-   * @returns 该角色下的模式 id。
-   */
   idsFor(role: SessionModeRole): string[];
-  /**
-   * 同 {@link idsFor}，给的是定义——"指定 mode" 那条接缝要拿候选集。
-   * @param role - 目标角色。
-   * @returns 该角色下的模式与其定义。
-   */
   modesFor(role: SessionModeRole): {
     id: string;
     mode: SessionMode;
   }[];
-  /** 页面用的清单 + 默认模式。 */
   roster(): SessionModeRoster;
-  /** 按 id 取定义；未知 id 直接抛（切换路径上它就是用户的错）。 */
   definition(id?: string): SessionMode;
-  /** 会话当前模式：投影上有就用它，否则是部署默认。 */
   modeOf(session: Session): string;
-  /** 会话当前模式的定义。 */
   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。
-   */
+  private policyInForce;
+  private decidePolicy;
   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"入口（模型侧或配置侧）也走这里**（那条接缝还没做）。
-   * @param agent - 目标 agent。
-   * @param mode - 目标模式 id。
-   * @param options.record - 是否把这次切换写进会话日志（缺省写；只想改当前进程时给 `false`）。
-   */
   applyTo(agent: Agent, mode: string, options?: {
     record?: boolean;
   }): void;
-  /**
-   * 该 agent 用哪个模式：会话选过（投影上有）优先，子代理继承父，其余用部署默认。
-   *
-   * 继承要**写进子会话日志**：它是一条会话事实，冷恢复与 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;
-  /**
-   * 模式的默认模型（`modes.<模式 id>.defaultModel`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
-   * 还没跑过请求）时接管这一请求的路由；一旦用户选过（投影 `pending`）或会话已经落过 header，就不再插手。
-   *
-   * 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。读的是构造
-   * 时那份模式清单快照：设置页保存会让这一行重挂（`reconcileProfilePatches`），新定义随重挂生效。
-   */
   private installDefaultModel;
-  /** 收口服务由 `@morlay/dsh-context-assembler/scope` 那一行发布；没装它就只有 persona。 */
-  private toolScope;
 }
 declare function apply(ctx: Context, config: ResolvedConfig): void;
 //#endregion
-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 };
+export { Config, POLICY_NAMES, type PolicyName, type ResolvedConfig, SESSION_MODE_PATH, type SessionMode, type SessionModeModel, type SessionModePersona, type SessionModeRole, type SessionModeRoster, type SessionModeRow, SessionModes, apply, inject, name, sessionModeEditableProjection, sessionModeProjection };