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

package/dist/client.d.cts

@@ -0,0 +1,210 @@
+import { c as SessionModeModels, n as SessionModeRoster, s as SessionModeModel } from "./shared-FNWe-_rS.cjs";
+import { Context } from "@deepseek-ai/cordis";
+import { SettingsFormScope, SettingsFormShell } from "@morlay/dsh-client-ui-primitives/client";
+import { InjectFace, PropsLocale, PropsRuntime, TranslateNS } from "@deepseek-ai/dsh-client-ui-slots";
+import { ModelProviderGroup } from "@deepseek-ai/dsh-api-remotes/client";
+import { SnapshotStore } from "@deepseek-ai/dsh-client-store";
+//#region src/client/locales.d.ts
+declare const zh: {
+  seatHint: string;
+  headerHint: string;
+  noDescription: string;
+  switchRefused: string;
+  loadFailed: string;
+  cardTitle: string;
+  cardDescription: string;
+  defaultsTitle: string;
+  defaultsHint: string;
+  providerLabel: string;
+  modelLabel: string;
+  effortLabel: string;
+  inheritOption: string;
+  chooseModel: string;
+  effortDefaultOption: string;
+  staleOption: string;
+  overridden: string;
+  reset: string;
+  modelRequired: string;
+  readOnly: string;
+  unavailable: string;
+  save: string;
+  saving: string;
+  saveFailed: string;
+  rosterFailed: string;
+  directoryFailed: string;
+  directoryPartial: string;
+};
+type SessionModeLocaleKey = keyof typeof zh;
+//#endregion
+//#region src/client/model-defaults-card-controller.d.ts
+/** 本包 host 行 id：settings 的命名空间名与 `config` 的 volatile 字段都在它下面。 */
+declare const SESSION_MODE_NS = "session-mode";
+/** settings 里这一段的可编辑形状（`volatileForm` 从 schema 上挑出来的那几个字段）。 */
+interface SessionModeSettings {
+  /** 各模式的默认模型；省略或空对象＝一个都没配。 */
+  readonly models?: SessionModeModels;
+}
+/** 卡片要的那部分模型目录：可以选的 provider / model 分组，以及读失败的 provider 显示名。 */
+interface ModelDirectory {
+  /** 目录里有模型的 provider（`ctx.remote.session.modelCatalog()` 的成功分组）。 */
+  readonly groups: readonly ModelProviderGroup[];
+  /** 目录里读失败的 provider 显示名（部分失败：其余分组照常可用）。 */
+  readonly failures: readonly string[];
+}
+/** 卡片的两条外部读取（都注入进来，测试给假的即可，不需要真的 ctx / HTTP）。 */
+interface ModelDefaultsSources {
+  /** 模式清单：`GET /session-mode`（列哪些模式各一行）。 */
+  roster(): Promise<SessionModeRoster>;
+  /** 模型目录：`ctx.remote.session.modelCatalog()`；拒绝与抛错对卡片是同一件事——读不到目录。 */
+  directory(): Promise<ModelDirectory>;
+}
+/** 一个模式一行：清单里的展示信息 + 当前值 + 草稿状态。 */
+interface ModelDefaultsRow {
+  readonly id: string;
+  readonly name: string;
+  readonly description?: string;
+  /** 这一行当前显示的模型（草稿优先；草稿是"回到默认"时显示装配层那份）；`undefined` = 跟全局默认。 */
+  readonly value?: SessionModeModel;
+  /** 保存之后这一行会不会留下用户层那一条（有就得给"恢复默认"）。 */
+  readonly overridden: boolean;
+  /** 这一行有未保存的编辑。 */
+  readonly dirty: boolean;
+  /** 草稿不完整（选了 provider 没选 model）：它阻止保存。 */
+  readonly invalid: boolean;
+}
+/** 卡片呈现的状态：表单壳 + 行 + 两条读取的落点。 */
+interface ModelDefaultsCardState extends SettingsFormShell {
+  readonly rows: readonly ModelDefaultsRow[];
+  /** 目录里的 provider 分组（选择器的选项来源）。 */
+  readonly directory: readonly ModelProviderGroup[];
+  readonly rosterStatus: "loading" | "ready" | "error";
+  readonly directoryStatus: "loading" | "ready" | "error";
+  /** 部分失败：这些 provider 的目录没读到。 */
+  readonly directoryFailures: readonly string[];
+}
+/** 槽位渲染器绑定的状态与动作。 */
+interface ModelDefaultsCardFace {
+  hooks: {
+    modelDefaultsCard: SnapshotStore<ModelDefaultsCardState>;
+  };
+  /** 给某个模式换 provider；换 provider 会连 model 与档位一起清掉（档位是模型自带的）。 */
+  setProvider(modeId: string, provider: string): void;
+  /** 给某个模式选 model；新模型不认识旧档位时档位被清掉。 */
+  setModel(modeId: string, model: string): void;
+  /** 给某个模式选档位；空串＝跟模型（provider）默认。 */
+  setEffort(modeId: string, effort: string): void;
+  /** 这一行回到装配层的值（清掉用户层那一条）。 */
+  resetMode(modeId: string): void;
+  /** 把全部草稿写成一次 `mutate`。 */
+  save(): void;
+  /** 丢掉全部草稿。 */
+  discard(): void;
+}
+/** 把一张动态映射编辑成一次设置的写。 */
+declare class ModelDefaultsCardController {
+  private readonly scope;
+  private readonly sources;
+  private readonly store;
+  private readonly unsubscribe;
+  private readonly drafts;
+  private roster;
+  private rosterStatus;
+  private directory;
+  private directoryFailures;
+  private directoryStatus;
+  private saving;
+  private failed;
+  private disposed;
+  private saveGeneration;
+  /**
+   * @param scope - 本包 host 行（`session-mode`）的共享配置表单。
+   * @param sources - 模式清单与模型目录的两条读取。
+   */
+  constructor(scope: SettingsFormScope<SessionModeSettings>, sources: ModelDefaultsSources);
+  /** 停止观察设置，并让晚到的写入结果不再落到状态上。 */
+  dispose(): void;
+  /**
+   * 把状态与动作绑到槽位渲染器上。
+   * @returns 快照与编辑、保存动作。
+   */
+  inject(): ModelDefaultsCardFace;
+  /** 用户层有没有这一条。 */
+  private overridden;
+  /** 生效值（用户层叠在装配层上）。 */
+  private current;
+  /** 装配层那份（用户层清掉之后剩下的）。 */
+  private base;
+  /**
+   * 这一行现在的值：草稿优先，否则是生效值；草稿是"回到默认"时看装配层那份（它清掉的就是用户层）。
+   * 同一个值既是选择器显示的东西，也是下一次编辑的起点。
+   * @param modeId - 模式 id。
+   * @returns 这一行呈现的模型；`undefined` = 跟全局默认。
+   */
+  private shown;
+  /**
+   * 这一行的草稿算不算一次真的编辑。
+   * @param modeId - 模式 id。
+   * @returns 保存会不会改变什么。
+   */
+  private dirty;
+  /** 保存之后这一行会不会留下用户层那一条（"已覆盖"与"恢复默认"都看它）。 */
+  private leavesOverride;
+  private setProvider;
+  private setModel;
+  private setEffort;
+  private stage;
+  private discard;
+  /** 可以编辑：这一行被服务到（`status: ready`）且文档接受写入。 */
+  private writable;
+  /** 这一次保存要写的 path op（按编辑顺序；没变的行不写）。 */
+  private plannedOps;
+  private save;
+  private loadRoster;
+  private loadDirectory;
+  /** 某个 provider 在目录里的模型。 */
+  private modelsOf;
+  /** 某个 provider + model 声明的档位（模型自带；没声明就是没有）。 */
+  private efforts;
+  private projection;
+  private publish;
+}
+//#endregion
+//#region src/client/ModelDefaultsCard.d.ts
+/** 槽位渲染器给卡片的 props：运行时面 + 卡片自己的注入面（`t` 由本包的 `inject` 面带进来）。 */
+type ModelDefaultsCardProps = PropsRuntime<"plugins.row.config"> & InjectFace<ModelDefaultsCardFace & {
+  t: Translate;
+}>;
+/** 本页字典的读取器（命名空间的 key 由 `LocaleNamespaceMap` 合并声明给）。 */
+type Translate = TranslateNS<"session-mode">;
+//#endregion
+//#region src/client/SessionModeLabel.d.ts
+/** 完整 props：头部动作槽位的运行时 props + 本包的字典。 */
+type SessionModeLabelProps = PropsRuntime<"conversation.session.header.actions"> & PropsLocale<"session-mode">;
+//#endregion
+//#region src/client/SessionModeSeat.d.ts
+/** 完整 props：hero 槽位的运行时 props + 本包的字典。 */
+type SessionModeSeatProps = PropsRuntime<"conversation.hero.agentPreset"> & PropsLocale<"session-mode">;
+//#endregion
+//#region src/client/index.d.ts
+declare module "@deepseek-ai/dsh-client-ui-slots" {
+  interface LocaleNamespaceMap {
+    /** 模式选择面与设置卡片的文案。 */
+    "session-mode": SessionModeLocaleKey;
+  }
+}
+/**
+ * 本行的配置入口 key：`<bundle 包名>#<行 id>`。
+ *
+ * 页面侧由 `ui-plugin-manager` 的 `rowConfigKey(bundle, rowId)` 生成同一个串——bundle 是本包
+ * （`dsh.profile.bundles` 里那一项），行 id 是本包 patch 里插的 `session-mode`。
+ */
+declare const SESSION_MODE_ROW_CONFIG_KEY = "@morlay/dsh-session-mode#session-mode";
+/** 需要的服务：槽位与字典（会话列表经槽位的标准 props 到达组件，不必自己 inject）。 */
+declare const inject: string[];
+/**
+ * 装上三个面。
+ * @param ctx - 浏览器插件上下文。
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { ModelDefaultsCardController, type ModelDefaultsCardFace, type ModelDefaultsCardProps, type ModelDefaultsCardState, type ModelDefaultsRow, type ModelDefaultsSources, type ModelDirectory, SESSION_MODE_NS, SESSION_MODE_ROW_CONFIG_KEY, type SessionModeLabelProps, type SessionModeLocaleKey, type SessionModeSeatProps, type SessionModeSettings, apply, inject };

package/dist/client.d.mts

@@ -0,0 +1,210 @@
+import { c as SessionModeModels, n as SessionModeRoster, s as SessionModeModel } from "./shared-FNWe-_rS.mjs";
+import { Context } from "@deepseek-ai/cordis";
+import { SettingsFormScope, SettingsFormShell } from "@morlay/dsh-client-ui-primitives/client";
+import { SnapshotStore } from "@deepseek-ai/dsh-client-store";
+import { InjectFace, PropsLocale, PropsRuntime, TranslateNS } from "@deepseek-ai/dsh-client-ui-slots";
+import { ModelProviderGroup } from "@deepseek-ai/dsh-api-remotes/client";
+//#region src/client/locales.d.ts
+declare const zh: {
+  seatHint: string;
+  headerHint: string;
+  noDescription: string;
+  switchRefused: string;
+  loadFailed: string;
+  cardTitle: string;
+  cardDescription: string;
+  defaultsTitle: string;
+  defaultsHint: string;
+  providerLabel: string;
+  modelLabel: string;
+  effortLabel: string;
+  inheritOption: string;
+  chooseModel: string;
+  effortDefaultOption: string;
+  staleOption: string;
+  overridden: string;
+  reset: string;
+  modelRequired: string;
+  readOnly: string;
+  unavailable: string;
+  save: string;
+  saving: string;
+  saveFailed: string;
+  rosterFailed: string;
+  directoryFailed: string;
+  directoryPartial: string;
+};
+type SessionModeLocaleKey = keyof typeof zh;
+//#endregion
+//#region src/client/model-defaults-card-controller.d.ts
+/** 本包 host 行 id：settings 的命名空间名与 `config` 的 volatile 字段都在它下面。 */
+declare const SESSION_MODE_NS = "session-mode";
+/** settings 里这一段的可编辑形状（`volatileForm` 从 schema 上挑出来的那几个字段）。 */
+interface SessionModeSettings {
+  /** 各模式的默认模型；省略或空对象＝一个都没配。 */
+  readonly models?: SessionModeModels;
+}
+/** 卡片要的那部分模型目录：可以选的 provider / model 分组，以及读失败的 provider 显示名。 */
+interface ModelDirectory {
+  /** 目录里有模型的 provider（`ctx.remote.session.modelCatalog()` 的成功分组）。 */
+  readonly groups: readonly ModelProviderGroup[];
+  /** 目录里读失败的 provider 显示名（部分失败：其余分组照常可用）。 */
+  readonly failures: readonly string[];
+}
+/** 卡片的两条外部读取（都注入进来，测试给假的即可，不需要真的 ctx / HTTP）。 */
+interface ModelDefaultsSources {
+  /** 模式清单：`GET /session-mode`（列哪些模式各一行）。 */
+  roster(): Promise<SessionModeRoster>;
+  /** 模型目录：`ctx.remote.session.modelCatalog()`；拒绝与抛错对卡片是同一件事——读不到目录。 */
+  directory(): Promise<ModelDirectory>;
+}
+/** 一个模式一行：清单里的展示信息 + 当前值 + 草稿状态。 */
+interface ModelDefaultsRow {
+  readonly id: string;
+  readonly name: string;
+  readonly description?: string;
+  /** 这一行当前显示的模型（草稿优先；草稿是"回到默认"时显示装配层那份）；`undefined` = 跟全局默认。 */
+  readonly value?: SessionModeModel;
+  /** 保存之后这一行会不会留下用户层那一条（有就得给"恢复默认"）。 */
+  readonly overridden: boolean;
+  /** 这一行有未保存的编辑。 */
+  readonly dirty: boolean;
+  /** 草稿不完整（选了 provider 没选 model）：它阻止保存。 */
+  readonly invalid: boolean;
+}
+/** 卡片呈现的状态：表单壳 + 行 + 两条读取的落点。 */
+interface ModelDefaultsCardState extends SettingsFormShell {
+  readonly rows: readonly ModelDefaultsRow[];
+  /** 目录里的 provider 分组（选择器的选项来源）。 */
+  readonly directory: readonly ModelProviderGroup[];
+  readonly rosterStatus: "loading" | "ready" | "error";
+  readonly directoryStatus: "loading" | "ready" | "error";
+  /** 部分失败：这些 provider 的目录没读到。 */
+  readonly directoryFailures: readonly string[];
+}
+/** 槽位渲染器绑定的状态与动作。 */
+interface ModelDefaultsCardFace {
+  hooks: {
+    modelDefaultsCard: SnapshotStore<ModelDefaultsCardState>;
+  };
+  /** 给某个模式换 provider；换 provider 会连 model 与档位一起清掉（档位是模型自带的）。 */
+  setProvider(modeId: string, provider: string): void;
+  /** 给某个模式选 model；新模型不认识旧档位时档位被清掉。 */
+  setModel(modeId: string, model: string): void;
+  /** 给某个模式选档位；空串＝跟模型（provider）默认。 */
+  setEffort(modeId: string, effort: string): void;
+  /** 这一行回到装配层的值（清掉用户层那一条）。 */
+  resetMode(modeId: string): void;
+  /** 把全部草稿写成一次 `mutate`。 */
+  save(): void;
+  /** 丢掉全部草稿。 */
+  discard(): void;
+}
+/** 把一张动态映射编辑成一次设置的写。 */
+declare class ModelDefaultsCardController {
+  private readonly scope;
+  private readonly sources;
+  private readonly store;
+  private readonly unsubscribe;
+  private readonly drafts;
+  private roster;
+  private rosterStatus;
+  private directory;
+  private directoryFailures;
+  private directoryStatus;
+  private saving;
+  private failed;
+  private disposed;
+  private saveGeneration;
+  /**
+   * @param scope - 本包 host 行（`session-mode`）的共享配置表单。
+   * @param sources - 模式清单与模型目录的两条读取。
+   */
+  constructor(scope: SettingsFormScope<SessionModeSettings>, sources: ModelDefaultsSources);
+  /** 停止观察设置，并让晚到的写入结果不再落到状态上。 */
+  dispose(): void;
+  /**
+   * 把状态与动作绑到槽位渲染器上。
+   * @returns 快照与编辑、保存动作。
+   */
+  inject(): ModelDefaultsCardFace;
+  /** 用户层有没有这一条。 */
+  private overridden;
+  /** 生效值（用户层叠在装配层上）。 */
+  private current;
+  /** 装配层那份（用户层清掉之后剩下的）。 */
+  private base;
+  /**
+   * 这一行现在的值：草稿优先，否则是生效值；草稿是"回到默认"时看装配层那份（它清掉的就是用户层）。
+   * 同一个值既是选择器显示的东西，也是下一次编辑的起点。
+   * @param modeId - 模式 id。
+   * @returns 这一行呈现的模型；`undefined` = 跟全局默认。
+   */
+  private shown;
+  /**
+   * 这一行的草稿算不算一次真的编辑。
+   * @param modeId - 模式 id。
+   * @returns 保存会不会改变什么。
+   */
+  private dirty;
+  /** 保存之后这一行会不会留下用户层那一条（"已覆盖"与"恢复默认"都看它）。 */
+  private leavesOverride;
+  private setProvider;
+  private setModel;
+  private setEffort;
+  private stage;
+  private discard;
+  /** 可以编辑：这一行被服务到（`status: ready`）且文档接受写入。 */
+  private writable;
+  /** 这一次保存要写的 path op（按编辑顺序；没变的行不写）。 */
+  private plannedOps;
+  private save;
+  private loadRoster;
+  private loadDirectory;
+  /** 某个 provider 在目录里的模型。 */
+  private modelsOf;
+  /** 某个 provider + model 声明的档位（模型自带；没声明就是没有）。 */
+  private efforts;
+  private projection;
+  private publish;
+}
+//#endregion
+//#region src/client/ModelDefaultsCard.d.ts
+/** 槽位渲染器给卡片的 props：运行时面 + 卡片自己的注入面（`t` 由本包的 `inject` 面带进来）。 */
+type ModelDefaultsCardProps = PropsRuntime<"plugins.row.config"> & InjectFace<ModelDefaultsCardFace & {
+  t: Translate;
+}>;
+/** 本页字典的读取器（命名空间的 key 由 `LocaleNamespaceMap` 合并声明给）。 */
+type Translate = TranslateNS<"session-mode">;
+//#endregion
+//#region src/client/SessionModeLabel.d.ts
+/** 完整 props：头部动作槽位的运行时 props + 本包的字典。 */
+type SessionModeLabelProps = PropsRuntime<"conversation.session.header.actions"> & PropsLocale<"session-mode">;
+//#endregion
+//#region src/client/SessionModeSeat.d.ts
+/** 完整 props：hero 槽位的运行时 props + 本包的字典。 */
+type SessionModeSeatProps = PropsRuntime<"conversation.hero.agentPreset"> & PropsLocale<"session-mode">;
+//#endregion
+//#region src/client/index.d.ts
+declare module "@deepseek-ai/dsh-client-ui-slots" {
+  interface LocaleNamespaceMap {
+    /** 模式选择面与设置卡片的文案。 */
+    "session-mode": SessionModeLocaleKey;
+  }
+}
+/**
+ * 本行的配置入口 key：`<bundle 包名>#<行 id>`。
+ *
+ * 页面侧由 `ui-plugin-manager` 的 `rowConfigKey(bundle, rowId)` 生成同一个串——bundle 是本包
+ * （`dsh.profile.bundles` 里那一项），行 id 是本包 patch 里插的 `session-mode`。
+ */
+declare const SESSION_MODE_ROW_CONFIG_KEY = "@morlay/dsh-session-mode#session-mode";
+/** 需要的服务：槽位与字典（会话列表经槽位的标准 props 到达组件，不必自己 inject）。 */
+declare const inject: string[];
+/**
+ * 装上三个面。
+ * @param ctx - 浏览器插件上下文。
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { ModelDefaultsCardController, type ModelDefaultsCardFace, type ModelDefaultsCardProps, type ModelDefaultsCardState, type ModelDefaultsRow, type ModelDefaultsSources, type ModelDirectory, SESSION_MODE_NS, SESSION_MODE_ROW_CONFIG_KEY, type SessionModeLabelProps, type SessionModeLocaleKey, type SessionModeSeatProps, type SessionModeSettings, apply, inject };

package/dist/index.d.cts

@@ -0,0 +1,129 @@
+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 { Agent } from "@deepseek-ai/dsh-agent";
+import { Session, SessionEvent, SessionId } from "@deepseek-ai/dsh-session";
+import { z } from "zod";
+//#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 {
+    sessionModes: SessionModes;
+  }
+}
+declare module "@deepseek-ai/dsh-session/types" {
+  interface SessionEventMap {
+    /**
+     * 会话在空白窗口里换了模式。**log-only**：它记录此后每一步实际运行的模式，恢复与 fork 时据此重建
+     * （模式决定模型看到的工具与提示词，所以它必须进日志）。
+     */
+    "session-mode/selected": {
+      sessionMode: string;
+    };
+  }
+}
+declare module "@deepseek-ai/dsh-session-projection/types" {
+  interface SessionProjectionStateMap {
+    sessionMode: string | null;
+  }
+  interface SessionProjectionMap {
+    /** 会话当前模式；`null` 表示没选过（用部署默认）。 */
+    sessionMode: string | null;
+  }
+}
+/** 会话模式的投影：初值来自空日志（没选过就是 `null`），只被选择事件推进。 */
+declare const sessionModeProjection: {
+  key: "sessionMode";
+  stateSchema: z.ZodType<string | null, unknown, z.core.$ZodTypeInternals<string | null, unknown>>;
+  init: () => null;
+  apply: (state: string | null, event: SessionEvent) => string | null;
+  wire: {
+    viewSchema: z.ZodType<string | null, unknown, z.core.$ZodTypeInternals<string | null, unknown>>;
+    view: (state: string | null) => string | null;
+  };
+  stateVersion: number;
+};
+/** 模式清单、默认模式、按会话读取与切换。 */
+declare class SessionModes extends Service {
+  config: ResolvedConfig;
+  /** 每个 agent 已经装上的那一份（persona + 默认模型兜底；模式变了就换一份）。 */
+  private readonly installs;
+  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;
+  /**
+   * 把某个空白会话切到某个模式。
+   * @param sessionId - 目标会话（必须还没有开过 turn）。
+   * @param mode - 目标模式 id。
+   * @returns 提交后的模式 id。
+   */
+  select(sessionId: SessionId, mode: string): Promise<string>;
+  /**
+   * 把某个活着的 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;
+  /** 子代理（有 durable 父会话）继承父当前模式；父不在场、或不是子代理时没有可继承的。 */
+  private inheritedModeId;
+  /** 装或换该 agent 的那一份（幂等：同一模式不重复注册）。 */
+  private installFor;
+  /**
+   * 模式的默认模型（config 顶层 `models.<模式 id>`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
+   * 还没跑过请求）时接管这一请求的路由；一旦用户选过（投影 `pending`）或会话已经落过 header，就不再插手。
+   *
+   * 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。
+   *
+   * 模型取自 `config.models`：那是个 volatile 引用，设置页保存时只有**引用里的值**变，这一行不重挂，
+   * 所以每次请求都现场 `.get()`（与 `llm-openai-compatible` 读 `config.providers` 同一种读法）。
+   */
+  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 SessionModeModels, type SessionModePersona, type SessionModeRole, type SessionModeRoster, type SessionModeRow, SessionModes, apply, inject, name, sessionModeProjection };

package/dist/index.d.mts

@@ -0,0 +1,129 @@
+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 { z } from "zod";
+import { Agent } from "@deepseek-ai/dsh-agent";
+import { Session, SessionEvent, SessionId } from "@deepseek-ai/dsh-session";
+//#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 {
+    sessionModes: SessionModes;
+  }
+}
+declare module "@deepseek-ai/dsh-session/types" {
+  interface SessionEventMap {
+    /**
+     * 会话在空白窗口里换了模式。**log-only**：它记录此后每一步实际运行的模式，恢复与 fork 时据此重建
+     * （模式决定模型看到的工具与提示词，所以它必须进日志）。
+     */
+    "session-mode/selected": {
+      sessionMode: string;
+    };
+  }
+}
+declare module "@deepseek-ai/dsh-session-projection/types" {
+  interface SessionProjectionStateMap {
+    sessionMode: string | null;
+  }
+  interface SessionProjectionMap {
+    /** 会话当前模式；`null` 表示没选过（用部署默认）。 */
+    sessionMode: string | null;
+  }
+}
+/** 会话模式的投影：初值来自空日志（没选过就是 `null`），只被选择事件推进。 */
+declare const sessionModeProjection: {
+  key: "sessionMode";
+  stateSchema: z.ZodType<string | null, unknown, z.core.$ZodTypeInternals<string | null, unknown>>;
+  init: () => null;
+  apply: (state: string | null, event: SessionEvent) => string | null;
+  wire: {
+    viewSchema: z.ZodType<string | null, unknown, z.core.$ZodTypeInternals<string | null, unknown>>;
+    view: (state: string | null) => string | null;
+  };
+  stateVersion: number;
+};
+/** 模式清单、默认模式、按会话读取与切换。 */
+declare class SessionModes extends Service {
+  config: ResolvedConfig;
+  /** 每个 agent 已经装上的那一份（persona + 默认模型兜底；模式变了就换一份）。 */
+  private readonly installs;
+  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;
+  /**
+   * 把某个空白会话切到某个模式。
+   * @param sessionId - 目标会话（必须还没有开过 turn）。
+   * @param mode - 目标模式 id。
+   * @returns 提交后的模式 id。
+   */
+  select(sessionId: SessionId, mode: string): Promise<string>;
+  /**
+   * 把某个活着的 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;
+  /** 子代理（有 durable 父会话）继承父当前模式；父不在场、或不是子代理时没有可继承的。 */
+  private inheritedModeId;
+  /** 装或换该 agent 的那一份（幂等：同一模式不重复注册）。 */
+  private installFor;
+  /**
+   * 模式的默认模型（config 顶层 `models.<模式 id>`）兜底：只在会话**尚无任何模型事实**（没选过模型、也
+   * 还没跑过请求）时接管这一请求的路由；一旦用户选过（投影 `pending`）或会话已经落过 header，就不再插手。
+   *
+   * 它是**配置事实**，不写会话事件——重启后仍由 config 决定；设置页里那条会话级选择才是会话事实。
+   *
+   * 模型取自 `config.models`：那是个 volatile 引用，设置页保存时只有**引用里的值**变，这一行不重挂，
+   * 所以每次请求都现场 `.get()`（与 `llm-openai-compatible` 读 `config.providers` 同一种读法）。
+   */
+  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 SessionModeModels, type SessionModePersona, type SessionModeRole, type SessionModeRoster, type SessionModeRow, SessionModes, apply, inject, name, sessionModeProjection };