@morlay/dsh-session-mode 0.0.7 → 0.0.9

package/src/client/bundle-locales.ts

@@ -0,0 +1,216 @@
+// bundle 配置页的文案：命名空间 `session-mode-bundle`（与行内那半的 `session-mode` 分开——两者的面与生命周期都不同）。
+//
+// 模式自己的名字与说明是**数据**（行 config 里的 `name` / `description`），不在这里；这里只有页面的结构、控件，以及
+// 每个字段"到底管什么"的那句说明。
+
+// 本页字典的命名空间。
+export const BUNDLE_NS = "session-mode-bundle";
+
+export const bundleZh = {
+  "default.label": "新会话的默认模式",
+  "default.hint": "还没选过模式的会话从这里开始。",
+  "modes.label": "模式",
+  "modes.hint": "展开一个模式，改它的提示词、工具与技能、上游规则和注入内容。",
+  "add.label": "添加模式",
+  "add.placeholder": "模式 id",
+  "add.confirm": "添加",
+  "add.cancel": "取消",
+  "add.close": "关闭",
+  "add.hint": "给新模式一个 id（选择器与列表里也显示它，加好后可以再改名称）。",
+  removeNamed: "删除模式 {name}",
+  protected: "内置模式，不提供删除",
+  untitled: "（未命名）",
+  overridden: "已覆盖",
+  "group.identity": "基本信息",
+  "group.persona": "提示词",
+  "group.tools": "工具与技能",
+  "group.rules": "上游规则",
+  "group.injections": "请求里注入什么",
+  "group.model": "默认模型",
+  "role.main": "会话可选",
+  "role.subagent": "子代理可用",
+  "field.name": "名称",
+  "field.description": "一句话说明",
+  "field.role": "角色",
+  "field.presetsOnly": "允许挂的 preset",
+  "field.prefix": "提示词前缀",
+  "field.suffix": "提示词后缀",
+  "field.allowTools": "允许的工具",
+  "field.denyTools": "禁用的工具",
+  "field.allowSkills": "允许的技能",
+  "field.denySkills": "禁用的技能",
+  "field.allowPolicies": "生效的规则",
+  "field.denyPolicies": "禁用的规则",
+  "field.instructions": "工作区指令",
+  "field.skills": "技能目录",
+  "field.runtimeContext": "动态快照",
+  "field.defaultModel": "设默认模型",
+  "field.modelRoute": "用哪个模型",
+  "field.reasoningEffort": "思考档位",
+  "field.reset": "恢复默认",
+  "hint.name": "选择器和列表里显示的名字。",
+  "hint.description": "一句话说明这个模式做什么。",
+  "hint.role": "「会话可选」= 用户能在会话里选它；「子代理可用」= 可以把子代理跑在这个模式下。",
+  "hint.presetsOnly":
+    "只允许这个模式挂这些 preset（行清单由挂着的那份提供）；不填 = 允许全部（哪份 preset 都行，切模式也不动它）。有值时切到这个模式，会话当前那份不在名单里就换成名单第一个。",
+  "hint.prefix": "加在系统提示词开头的一段话。",
+  "hint.suffix": "加在系统提示词结尾的一段话。",
+  "hint.allowTools": "只允许这些工具；不填 = 不限制（用会话当前 preset 的全部工具）。",
+  "hint.denyTools": "从上面那份里去掉这些工具。",
+  "hint.allowSkills": "只允许这些技能；不填 = 不限制。",
+  "hint.denySkills": "这些技能不列进技能目录，`skill` 工具也加载不了。",
+  "hint.allowPolicies": "只让这些上游规则生效；不填 = 全部生效。",
+  "hint.denyPolicies": "禁用这些上游规则，它的判断连拒绝一起丢掉。",
+  "hint.instructions": "每步都把工作区指令（AGENTS.md 之类）发给模型；关掉就不发。",
+  "hint.skills": "每步都把技能目录发给模型；默认按这个模式的工具名单自动判断。",
+  "hint.runtimeContext": "每步都把沙箱与审批策略发给模型。",
+  "hint.defaultModel":
+    "开 = 这个模式自带一个默认模型（会话还没选过模型时用它）；关 = 跟随全局模型。",
+  "hint.modelRoute": "从部署里已设置的模型里挑一条：服务商与模型是一对，选它等于两个一起定。",
+  "hint.reasoningEffort": "思考档位；不填用服务商默认。",
+  "model.loading": "正在读部署里已设置的模型…",
+  "model.error": "读不出部署里已设置的模型。",
+  "model.empty": "部署里还没有已设置的模型。",
+  "tags.placeholder": "加一个后回车，或粘贴一串",
+  "tags.add": "添加",
+  "tags.remove": "移除 {name}",
+  "select.search": "搜索候选",
+  "select.noMatch": "没有匹配的候选",
+  "tri.unset": "默认",
+  "tri.on": "开",
+  "tri.off": "关",
+  "remove.title": "删除模式",
+  "remove.description": "删除 {name}？删除只在保存之后生效，保存之前还可以丢弃。",
+  "remove.confirm": "删除",
+  "remove.cancel": "取消",
+  "remove.close": "关闭",
+  "model.set": "设置默认模型",
+  "model.follow": "改为跟随全局",
+  save: "保存",
+  saving: "保存中…",
+  saveFailed: "保存没有生效，请重试。",
+  readOnly: "这份部署的配置是只读的。",
+  unavailable: "这一行当前不可写。",
+  notSaved: "没有保存：{message}",
+  "configured.loading": "正在读取这一行的配置…",
+  "configured.missing":
+    "设置面里没有 `session-mode` 这一行：没装、被禁用，或者还没装配成功（依赖没到齐时会一直 PENDING）。",
+  "configured.unreadable": "`session-mode` 这一行在跑，但这份配置读不出来（{problem}）。",
+  "violation.modesEmpty": "至少要有一种模式。",
+  "violation.defaultMissing": "默认模式不在模式清单里。",
+  "violation.modelPair": "默认模型要同时给出服务商与模型。",
+  "summary.allTools": "全部工具",
+  "summary.tools": "{n} 件工具",
+  "summary.denyTools": "禁 {n} 件",
+  "summary.globalModel": "跟随全局模型",
+};
+
+export const bundleEn: Record<keyof typeof bundleZh, string> = {
+  "default.label": "Mode for new sessions",
+  "default.hint": "Sessions that never picked a mode start here.",
+  "modes.label": "Modes",
+  "modes.hint":
+    "Expand a mode to edit its prompt, tools and skills, upstream rules, and injected content.",
+  "add.label": "Add a mode",
+  "add.placeholder": "mode id",
+  "add.confirm": "Add",
+  "add.cancel": "Cancel",
+  "add.close": "Close",
+  "add.hint":
+    "Give the new mode an id (it also shows in pickers and lists; rename it after adding).",
+  removeNamed: "Delete mode {name}",
+  protected: "Built-in mode: no delete",
+  untitled: "(untitled)",
+  overridden: "Overridden",
+  "group.identity": "Basics",
+  "group.persona": "Prompt",
+  "group.tools": "Tools and skills",
+  "group.rules": "Upstream rules",
+  "group.injections": "Injected into requests",
+  "group.model": "Default model",
+  "role.main": "Selectable in sessions",
+  "role.subagent": "Usable for subagents",
+  "field.name": "Name",
+  "field.description": "One-line description",
+  "field.role": "Roles",
+  "field.presetsOnly": "Presets it may ride on",
+  "field.prefix": "Prompt prefix",
+  "field.suffix": "Prompt suffix",
+  "field.allowTools": "Allowed tools",
+  "field.denyTools": "Denied tools",
+  "field.allowSkills": "Allowed skills",
+  "field.denySkills": "Denied skills",
+  "field.allowPolicies": "Rules in force",
+  "field.denyPolicies": "Rules disabled",
+  "field.instructions": "Workspace instructions",
+  "field.skills": "Skill catalog",
+  "field.runtimeContext": "Runtime snapshot",
+  "field.defaultModel": "Default model",
+  "field.modelRoute": "Which model",
+  "field.reasoningEffort": "Reasoning effort",
+  "field.reset": "Reset",
+  "hint.name": "Shown in the picker and in lists.",
+  "hint.description": "One line saying what this mode is for.",
+  "hint.role":
+    "Selectable in sessions = the user can pick it; usable for subagents = subagents may run in it.",
+  "hint.presetsOnly":
+    "Only these presets may back this mode (the one it rides on supplies the row list); empty = every preset is allowed (and selecting the mode switches nothing). When set, selecting the mode switches to the first entry if the session's current preset is not listed.",
+  "hint.prefix": "Text prepended to the system prompt.",
+  "hint.suffix": "Text appended to the system prompt.",
+  "hint.allowTools":
+    "Only these tools; empty = no restriction (every tool of the session's preset).",
+  "hint.denyTools": "Those tools are removed from the list above.",
+  "hint.allowSkills": "Only these skills; empty = no restriction.",
+  "hint.denySkills": "Those skills leave the catalog, and the `skill` tool cannot load them.",
+  "hint.allowPolicies": "Only these upstream rules stay in force; empty = all of them.",
+  "hint.denyPolicies": "Those upstream rules are disabled, rejection included.",
+  "hint.instructions":
+    "Sends the workspace instructions (AGENTS.md and friends) with every step; off means it is not sent.",
+  "hint.skills":
+    "Sends the skill catalog with every step; default decides from this mode's tool lists.",
+  "hint.runtimeContext": "Sends the sandbox and approval policies with every step.",
+  "hint.defaultModel":
+    "On = this mode carries a default model (used while a session has picked none); off = follow the global model.",
+  "hint.modelRoute":
+    "Pick one model already set up in this deployment: a provider and a model come as one route, so choosing it sets both.",
+  "hint.reasoningEffort": "Reasoning effort; empty uses the provider default.",
+  "model.loading": "Reading the models set up in this deployment…",
+  "model.error": "Could not read the models set up in this deployment.",
+  "model.empty": "No model is set up in this deployment yet.",
+  "tags.placeholder": "Add one and press Enter, or paste a list",
+  "tags.add": "Add",
+  "tags.remove": "Remove {name}",
+  "select.search": "Search candidates",
+  "select.noMatch": "No matching candidate",
+  "tri.unset": "Default",
+  "tri.on": "On",
+  "tri.off": "Off",
+  "remove.title": "Delete mode",
+  "remove.description":
+    "Delete {name}? The deletion applies on save; until then you can discard it.",
+  "remove.confirm": "Delete",
+  "remove.cancel": "Cancel",
+  "remove.close": "Close",
+  "model.set": "Set a default model",
+  "model.follow": "Follow the global model",
+  save: "Save",
+  saving: "Saving…",
+  saveFailed: "The save did not take effect; try again.",
+  readOnly: "This deployment stores settings read-only.",
+  unavailable: "This row is not writable right now.",
+  notSaved: "Not saved: {message}",
+  "configured.loading": "Reading this row's configuration…",
+  "configured.missing":
+    "The settings surface has no `session-mode` row: not installed, disabled, or not composed yet (it stays PENDING while a dependency is missing).",
+  "configured.unreadable":
+    "The `session-mode` row is running, but its configuration cannot be read ({problem}).",
+  "violation.modesEmpty": "At least one mode is required.",
+  "violation.defaultMissing": "The default mode is not in the mode list.",
+  "violation.modelPair": "A default model needs both a provider and a model.",
+  "summary.allTools": "every tool",
+  "summary.tools": "{n} tools",
+  "summary.denyTools": "{n} denied",
+  "summary.globalModel": "global model",
+};
+
+export type BundleLocaleKey = keyof typeof bundleZh;

package/src/client/index.ts

@@ -1,6 +1,6 @@
-// client 半：会话里那一个面（模式 chip，槽位 `conversation.input.left`，list + session scope）+ 配置页字段文案。
-// 官方 `@deepseek-ai/dsh-client-ui-agent-preset` 保留（官方管"挂哪套行"，我们管"会话级扩展"，两套入口并存）；
-// 本行的配置页由 `@morlay/dsh-client-ui-primitives` 按 schema 自动生成，key = `<bundle 包名>#<行 id>`。
+// client 半：会话里那一个面（模式 chip，槽位 `conversation.input.left`，list + session scope）+ 配置面两处——
+// 本行自己那页（由 `@morlay/dsh-client-ui-primitives` 按 schema 自动生成，key = `<bundle 包名>#<行 id>`）与
+// 装本行的 bundle 那一页（`plugins.bundle.config`，key = bundle 包名，见 `./BundleConfigPage.tsx`）。
 
 import type { Context } from "@deepseek-ai/cordis";
 // Type-only：`ctx.remote` 的合并面（选模型的候选来自 LLM 目录）。
@@ -9,15 +9,34 @@ import type {} from "@deepseek-ai/dsh-client-locale/client";
 import type {} from "@deepseek-ai/dsh-client-ui-slots";
 // Type-only：槽位声明与 standard props（session / session-maybe / global）。
 import type {} from "@deepseek-ai/dsh-client-ui-conversation/client";
-import { apply as installUiPrimitives } from "@morlay/dsh-client-ui-primitives/client";
+// Type-only：`plugins.bundle.config` 的槽位声明（bundle 详情页的配置座位）。
+import type {} from "@deepseek-ai/dsh-client-ui-plugin-manager/client";
+import {
+  CATALOG_NS,
+  SESSION_MODE_CATALOG_REMOTE,
+  type SessionModeCatalogRemote,
+} from "../catalog-remote.ts";
 import { POLICY_NAMES } from "../shared.ts";
+import {
+  BUNDLE_CONFIG_KEY,
+  createBundleConfigFace,
+  SESSION_MODE_NS,
+  unwrapService,
+  type HintsLike,
+  type HintsService,
+} from "./bundle-config.ts";
+import { BundleConfigPage } from "./BundleConfigPage.tsx";
+import { BUNDLE_NS, bundleEn, bundleZh, type BundleLocaleKey } from "./bundle-locales.ts";
+import { loadLlmProviders, remoteNamespace, type ProviderModels } from "./llm-directory.ts";
 import { SessionModeSeat } from "./SessionModeSeat.tsx";
 import { en, zh, type SessionModeLocaleKey } from "./locales.ts";
 
 declare module "@deepseek-ai/dsh-client-ui-slots" {
   interface LocaleNamespaceMap {
-    // 会话里两个面的文案（配置页文案在通用 schema 表单的字典里）。
+    // 会话里两个面的文案（本行配置页的文案在通用 schema 表单的字典里）。
     "session-mode": SessionModeLocaleKey;
+    // bundle 配置页（`plugins.bundle.config`）的文案。
+    "session-mode-bundle": BundleLocaleKey;
   }
 }
 
@@ -35,36 +54,33 @@ const POLICY_FIELDS = ["allowPolicies", "denyPolicies"] as const;
 // 动态键的占位段（与通用表单的字段树同一约定）。
 const DYNAMIC = "*";
 
-// 一个可配置 provider 的候选信息：显示名 + 它的配置在哪（模型清单从那份配置里读）。
-interface ProviderEntry {
-  value: string;
-  label: string;
-  settingsNs: string;
-  settingsPath: readonly string[];
+// 部署里的 agent preset 清单（`remote.agentPresets.list()`）：本包只用它的 id 与显示名做候选。
+interface PresetRosterReader {
+  list: () => Promise<
+    { ok: true; value: { presets: readonly { id: string; name?: string }[] } } | { ok: false }
+  >;
 }
 
 export type { SessionModeSeatProps } from "./SessionModeSeat.tsx";
 export type { SessionModeLocaleKey } from "./locales.ts";
+export type { BundleConfigPageProps } from "./BundleConfigPage.tsx";
 
-// 需要的服务：槽位与字典（会话列表经槽位的标准 props 到达组件，不必自己 inject）。
+// 需要的服务：槽位与字典（会话列表经槽位的标准 props 到达组件，不必自己 inject）；bundle 那页另要配置表单与
+// schema 服务，见下面那段注册自己的 `ctx.inject`。
 export const inject = ["slots", "locale"];
 
-// 本包 host 行 id：行配置页读的就是这个命名空间。
-export const SESSION_MODE_NS = "session-mode";
+// 本包 host 行 id：行配置页与 bundle 配置页读的都是这个命名空间。
+export { SESSION_MODE_NS };
 
-// 按路径读一段配置里的值（本包只读 provider 档案里的模型清单）。
-function readAt(root: unknown, path: readonly string[]): unknown {
-  return path.reduce<unknown>((node, segment) => {
-    if (Array.isArray(node)) return node[Number(segment)];
-    if (typeof node !== "object" || node === null) return undefined;
-    return Reflect.get(node, segment);
-  }, root);
+// 从 inject 的 scope 上取提示面服务并解包：cordis 把它包成追踪代理，而它的实现用的是 JS 私有字段，
+// 代理上的方法调用会以代理为 `this` 而抛（`Cannot read private member #texts …`）。
+function unwrapHintService(scope: Context): HintsService {
+  return unwrapService(scope.schemaFormHints as unknown as HintsService) as HintsService;
 }
 
-// 装上会话里的那一个面，以及本行配置页的字段文案。
+// 装上会话里的那一个面、本行配置页的字段文案，以及装本行的 bundle 那一页的表单。
 export function apply(ctx: Context): void {
   // 基础面随本包 inline（不再是装配行）：装上它提供的字典、字段槽与按行配置页；多份副本只装一次。
-  installUiPrimitives(ctx);
   const t = ctx.locale.bind(NS);
   ctx.effect(() => ctx.locale.register(NS, { zh, en }), "session-mode: dictionaries");
 
@@ -72,7 +88,8 @@ export function apply(ctx: Context): void {
   // 中文标签与说明。
   ctx.inject(["schemaFormHints"], (scope) =>
     scope.effect(() => {
-      const hints = scope.schemaFormHints;
+      // 提示面服务走 cordis 的追踪代理，而它的实现用 JS 私有字段：先解包成原实例再调（见 `./bundle-config.ts`）。
+      const hints = unwrapHintService(scope);
       const offs = FIELDS.map((key) =>
         hints.describe(SESSION_MODE_NS, ["modes", DYNAMIC, "defaultModel", key], () => ({
           label: t(key),
@@ -91,7 +108,7 @@ export function apply(ctx: Context): void {
   ctx.inject(["schemaFormHints"], (scope) =>
     scope.effect(() => {
       const offs = POLICY_FIELDS.map((key) =>
-        scope.schemaFormHints.select(SESSION_MODE_NS, ["modes", DYNAMIC, key, DYNAMIC], {
+        unwrapHintService(scope).select(SESSION_MODE_NS, ["modes", DYNAMIC, key, DYNAMIC], {
           options: () => POLICY_NAMES.map((value) => ({ value })),
         }),
       );
@@ -101,59 +118,18 @@ export function apply(ctx: Context): void {
     }, "session-mode: policy candidates"),
   );
 
-  // 选模型的候选不在本行的 schema 里：provider 是部署里的 LLM 目录（活着的路由 + 可配置声明），模型清单读那份声明
-  // 指向的配置（`settingsNs` / `settingsPath`）。目录异步取到后注册——注册本身就是一次变更通知。
+  // 选模型的候选不在本行的 schema 里：读的是部署里的 LLM 目录（活着的路由 + 可配置声明，模型清单在声明指向的
+  // 配置里，见 `./llm-directory.ts`）。目录异步取到后注册——注册本身就是一次变更通知。
   ctx.inject(["schemaFormHints"], (scope) =>
     scope.effect(() => {
-      const hints = scope.schemaFormHints;
+      const hints = unwrapHintService(scope);
       const remote = scope.get("remote");
-      const forms = scope.get("configForms");
-      if (remote === undefined || forms === undefined) return () => {};
-      let providers: ProviderEntry[] = [];
+      if (remote === undefined) return () => {};
+      let providers: readonly ProviderModels[] = [];
       const load = async (): Promise<void> => {
-        const [routes, directory] = await Promise.all([
-          remote.llm.listProviders(),
-          remote.llm.listConfigurableProviders(),
-        ]);
-        if (!routes.ok || !directory.ok) return;
-        const merged = new Map<string, ProviderEntry>();
-        for (const entry of directory.value) {
-          merged.set(entry.provider, {
-            value: entry.provider,
-            label: entry.displayName,
-            settingsNs: entry.settingsNs,
-            settingsPath: [...entry.settingsPath],
-          });
-        }
-        for (const route of routes.value) {
-          if (!merged.has(route.id)) {
-            merged.set(route.id, {
-              value: route.id,
-              label: route.name,
-              settingsNs: "",
-              settingsPath: [],
-            });
-          }
-        }
-        providers = [...merged.values()];
+        providers = await loadLlmProviders(scope);
         hints.refresh();
       };
-      const modelsOf = (provider: unknown): readonly { value: string }[] => {
-        if (typeof provider !== "string") return [];
-        const entry = providers.find((candidate) => candidate.value === provider);
-        if (entry === undefined || entry.settingsNs === "") return [];
-        const profile = readAt(forms.get(entry.settingsNs).getSnapshot().value, entry.settingsPath);
-        const models =
-          typeof profile === "object" && profile !== null
-            ? Reflect.get(profile, "models")
-            : undefined;
-        if (!Array.isArray(models)) return [];
-        return models.flatMap((model) => {
-          const id =
-            typeof model === "object" && model !== null ? Reflect.get(model, "id") : undefined;
-          return typeof id === "string" ? [{ value: id }] : [];
-        });
-      };
       const offs = [
         // 两个具名源：schema 上 `role('select', { source })` 认领它们，本包因此不必知道行 id 与字段路径。
         hints.source("llm-providers", {
@@ -162,13 +138,18 @@ export function apply(ctx: Context): void {
         // 换服务商就换模型清单：依赖声明让表单在投影时按当前 provider 重算候选。
         hints.source("llm-models", {
           dependsOn: [["provider"]],
-          options: (read) => modelsOf(read(["provider"])),
+          options: (read) => {
+            const provider = read(["provider"]);
+            return typeof provider === "string"
+              ? (providers.find((entry) => entry.value === provider)?.models ?? [])
+              : [];
+          },
         }),
         remote.$on("llm/adapters-updated", () => {
           void load();
         }),
         remote.$on("settings/document-updated", () => {
-          hints.refresh();
+          void load();
         }),
       ];
       void load();
@@ -178,6 +159,81 @@ export function apply(ctx: Context): void {
     }, "session-mode: model candidates"),
   );
 
+  // 模式"允许挂哪些 preset"的候选：部署里注册的 agent preset（`remote.agentPresets.list()`），登记成具名源
+  // `agent-presets`——schema 上 `presetsOnly` 声明 `role('select', { source })` 认领它，页面不必知道这些 preset
+  // 从哪来。装配组合变了（设置文档一次更新）就重取一次。
+  ctx.inject(["schemaFormHints"], (scope) =>
+    scope.effect(() => {
+      const hints = unwrapHintService(scope);
+      const remote = scope.get("remote");
+      if (remote === undefined) return () => {};
+      const roster = remoteNamespace<PresetRosterReader>(scope, "agentPresets");
+      if (roster === undefined) return () => {};
+      let presets: readonly { value: string; label: string }[] = [];
+      const load = async (): Promise<void> => {
+        const listed = await roster.list();
+        if (!listed.ok) return;
+        presets = listed.value.presets.map((preset) => ({
+          value: preset.id,
+          label: preset.name ?? preset.id,
+        }));
+        // 候选变了：注册本身就是一次变更通知（页面据此重投影）。
+        hints.refresh();
+      };
+      const offs = [
+        hints.source("agent-presets", { options: () => presets }),
+        remote.$on("settings/document-updated", () => {
+          void load();
+        }),
+      ];
+      void load();
+      return () => {
+        for (const off of offs) off();
+      };
+    }, "session-mode: preset candidates"),
+  );
+
+  // 配置页的名单候选（工具名 / 技能名 / 上游 policy 名）：前两个来自本包自己开的那条 Remote 面
+  // （`../catalog-remote.ts`——工具清单只在 host，技能面按会话，配置页都没有别的路可走），mount 由这里做；
+  // policy 名是一份封闭名单（`shared.ts`）。三个都是**具名源**，schema 上名单字段声明 `role('select', { source })`
+  // 认领——标签输入因此聚焦就有候选，而不是只能手输。
+  ctx.inject(["schemaFormHints", "remote"], (scope) =>
+    scope.effect(() => {
+      const hints = unwrapHintService(scope);
+      let tools: readonly string[] = [];
+      let skills: readonly string[] = [];
+      const offs = [
+        hints.source("catalog-tools", { options: () => tools.map((value) => ({ value })) }),
+        hints.source("catalog-skills", { options: () => skills.map((value) => ({ value })) }),
+        hints.source("policies", { options: () => POLICY_NAMES.map((value) => ({ value })) }),
+      ];
+      let disposeMount: (() => Promise<void>) | undefined;
+      // `$mount` 不是每个环境都有（测试替身、极简装配）：没有就只留 policy 那份候选。
+      if (typeof scope.remote.$mount !== "function") {
+        return () => {
+          for (const off of offs) off();
+        };
+      }
+      void scope.remote
+        .$mount(SESSION_MODE_CATALOG_REMOTE)
+        .then(async (dispose: () => Promise<void>) => {
+          disposeMount = dispose;
+          const listed = await remoteNamespace<SessionModeCatalogRemote>(scope, CATALOG_NS)?.list();
+          if (listed?.ok !== true) return;
+          tools = listed.value.tools;
+          skills = listed.value.skills;
+          hints.refresh();
+        })
+        .catch(() => {
+          // 这条面 mount 不上（旧 host）时不给候选：字段退回自由输入，不炸页面。
+        });
+      return () => {
+        for (const off of offs) off();
+        void disposeMount?.();
+      };
+    }, "session-mode: catalog candidates"),
+  );
+
   // chip 挂 **composer 工具行左侧**（`conversation.input.left`，list + session scope）：新会话屏也是一个
   // blank session 的 composer，所以那里也能选模式——头部槽位在新会话屏不存在。
   ctx.inject(["slots", "conversation"], (scope) => {
@@ -196,4 +252,52 @@ export function apply(ctx: Context): void {
       };
     }, "session-mode: composer chip");
   });
+
+  // 装本行的 bundle 那一页（`plugins.bundle.config`，key = bundle 包名）：本行是那份配置的 owner，页面摆的就是
+  // `modes` 与 `default` 这几项——按模式折叠分组而不是按 schema 平铺，所以它自带表单，不用自动生成那页。
+  // 提示面的候选（选服务商 / 选模型的两个具名源）可能比本页晚到，所以这一页自己重投影的入口留在外面：
+  // 提示面一到（或它的候选变了）就刷一次，模型那两个字段不会静默退回手输。
+  let refreshPage: (() => void) | undefined;
+  // 提示面按**属性访问**取（`ctx.get(name)` 给的是追踪代理，调带 JS 私有字段的方法会抛），存下来给下面那一页用。
+  let hints: HintsLike | undefined;
+  ctx.inject(["schemaFormHints"], (scope) =>
+    scope.effect(() => {
+      // 订阅也要用解包后的实例（服务实现用 JS 私有字段，代理上的调用会抛）。
+      const service = unwrapHintService(scope);
+      hints = service;
+      const off = service.subscribe(() => {
+        refreshPage?.();
+      });
+      return () => {
+        off();
+        hints = undefined;
+      };
+    }, "session-mode: bundle page candidates"),
+  );
+
+  ctx.inject(["slots", "locale", "configForms", "settingsSchema"], (scope) => {
+    scope.effect(() => {
+      const bundleT = scope.locale.bind(BUNDLE_NS);
+      const { face, refresh, dispose } = createBundleConfigFace(scope, bundleT, () => hints);
+      refreshPage = refresh;
+      const bundleDictionary = scope.locale.register(BUNDLE_NS, { zh: bundleZh, en: bundleEn });
+      const off = scope.slots.inject("plugins.bundle.config", () =>
+        scope.slots.register(
+          {
+            name: "plugins.bundle.config",
+            key: BUNDLE_CONFIG_KEY,
+            locale: BUNDLE_NS,
+            inject: () => face,
+          },
+          BundleConfigPage,
+        ),
+      );
+      return () => {
+        off();
+        bundleDictionary();
+        refreshPage = undefined;
+        dispose();
+      };
+    }, "session-mode: bundle configuration page");
+  });
 }