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

package/src/shared.ts

@@ -0,0 +1,36 @@
+/**
+ * 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 与桌面）在同一张路由表上服务它。 */
+export const SESSION_MODE_PATH = "/session-mode";
+
+/** 一个模式对外的那部分：选择器要的名字与说明。 */
+export interface SessionModeRow {
+  readonly id: string;
+  readonly name: string;
+  readonly description?: string;
+}
+
+/** `GET` 的响应体：清单与默认模式。 */
+export interface SessionModeRoster {
+  readonly default: string;
+  readonly modes: readonly SessionModeRow[];
+}
+
+/** `POST` 的请求体：把某个空白会话切到某个模式。 */
+export interface SessionModeSelectRequest {
+  readonly sessionId: string;
+  readonly mode: string;
+}
+
+/** `POST` 的响应体：切换后提交的模式 id。 */
+export interface SessionModeSelectResult {
+  readonly mode: string;
+}

package/tool/modes.ts

@@ -0,0 +1,85 @@
+/**
+ * 模式定义的真源：`cordis.patch.yml` 里 `session-mode` 行的 `config` 由这里渲染。
+ *
+ * "自定义"就落在这份数据上——装配层（profile 的用户 patch 层）可以整体改写 `config.modes`，也可以只给
+ * 某个模式换提示词或工具白名单，不需要任何插件行。
+ *
+ * `allowTools` 从 [`@morlay/dsh-agent-toolkit/rows`](../../../dsh-agent-toolkit/src/rows.ts) 的
+ * `TOOLKIT_TOOL_NAMES` 派生（工具集与汉化同源）：toolkit 的 bundle 在 profile 平面把工具行装一次，模式
+ * 只声明"我这些会话能用哪些"。想改某一个模式的名单，直接在这条源数据里加/减。
+ */
+
+import { TOOLKIT_TOOL_NAMES } from "@morlay/dsh-agent-toolkit/rows";
+
+/** 一个模式的源定义：就是 `session-mode` 行 `config.modes` 里的一项。 */
+export interface ModeSource {
+  readonly id: string;
+  readonly name: string;
+  readonly description: string;
+  /** 归谁用：`main`（用户选择器，缺省）、`subagent`（可作子代理 mode 的候选）。 */
+  readonly role?: readonly ("main" | "subagent")[];
+  readonly persona?: { readonly prefix?: string; readonly suffix?: string };
+  readonly allowTools: readonly string[];
+  readonly instructions?: boolean;
+  readonly runtimeContext?: boolean;
+}
+
+/** 一个模式的默认模型源定义：就是 `session-mode` 行 `config.models[<模式 id>]`。 */
+export interface ModeModelSource {
+  readonly provider: string;
+  readonly model: string;
+  readonly reasoningEffort?: string;
+}
+
+/** 编码模式：编程专家 + 语言与思考纪律 + 工作目录提醒。 */
+const CODING_PERSONA = {
+  prefix: [
+    "你是一个经验丰富的编程专家，YAGNI 是你的编程哲学，PDCA 是你的行为规范。",
+    "全程用中文（专有名词除外），包括但不限于思考，回答，工具描述，subagent 提示词；思考不要陷入重复循环，一旦循环立即退出；思考聚焦需求理解与方案设计，不预演具体代码实现，正确性由验证环节确认。",
+  ].join("\n"),
+  suffix: "你的工作目录在 `{{cwd}}`",
+};
+
+/** 对话模式：一个助手，保留语言与思考纪律，没有 suffix。 */
+const CHAT_PERSONA = {
+  prefix:
+    "你是一个助手。全程用中文（专有名词除外），包括但不限于思考，回答，工具描述；思考不要陷入重复循环，一旦循环立即退出。",
+};
+
+/** 新会话用哪个模式（`session-mode` 行的 `config.default`）。 */
+export const DEFAULT_MODE = "coding";
+
+/**
+ * 各模式的默认模型（`session-mode` 行 `config.models`：模式 id → 模型）。
+ *
+ * 当前为空——两个模式都跟着全局 `agent-default-model`。要改某个模式的默认模型就写在这里（键必须是
+ * `MODE_SOURCES` 里的 id，装配期校验会拒绝孤儿键）；用户在设置页写的那份由 settings 的用户层叠在它上面。
+ */
+export const MODE_MODELS: Readonly<Record<string, ModeModelSource>> = {};
+
+/** 两个模式：编码与对话。 */
+export const MODE_SOURCES: readonly ModeSource[] = [
+  {
+    id: "coding",
+    name: "编码模式",
+    description: "功能完整的编码 Agent：文件、Shell、检索、联网等工具常驻，其余用法说明按需加载。",
+    persona: CODING_PERSONA,
+    // 用户可选，也允许作为子代理的 mode（子代理默认继承父 mode，不看角色；这里是"可被指定"的候选集）。
+    role: ["main", "subagent"],
+    allowTools: [...TOOLKIT_TOOL_NAMES],
+  },
+  {
+    id: "chat",
+    name: "对话模式",
+    description:
+      "只做对话：提问与联网（搜索、抓取）三件工具，不注入系统提示词、工作区指令与技能目录。",
+    persona: CHAT_PERSONA,
+    // 只做用户侧对话：不做子代理的候选（父在 chat 里派发的子代理仍继承 chat，见 README 的"角色"一节）。
+    role: ["main"],
+    // 提问与联网三件：工具行由 toolkit 的 bundle 装，这里只收口。
+    allowTools: ["ask_user_question", "web_search", "web_fetch"],
+    // 没有文件与 shell 工具，"能改工作区哪些文件、要不要走审批"对它全是噪音。
+    instructions: false,
+    runtimeContext: false,
+  },
+];

package/tool/patch.ts

@@ -0,0 +1,91 @@
+import { writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { entryListSchema } from "@deepseek-ai/cordis-plugin-include";
+import { scopeRow } from "@morlay/dsh-context-assembler/rows";
+import yaml from "js-yaml";
+import { DEFAULT_MODE, MODE_MODELS, MODE_SOURCES, type ModeSource } from "./modes.ts";
+
+/**
+ * bundle patch 的行清单：**两行**——模式本身，与模式的工具收口。
+ *
+ * | 行                        | 是什么                                                                                     |
+ * | ------------------------- | ------------------------------------------------------------------------------------------ |
+ * | `session-mode`            | 模式清单、默认模式与各模式的默认模型（`config.modes` / `config.default` / `config.models`）+ 按会话应用 persona + 页面用的路由 |
+ * | `context-assembler-scope` | `@morlay/dsh-context-assembler/scope`：读模式定义，按会话收口工具、instruction 与动态快照    |
+ *
+ * 工具行与注入通道**都不在这里**——它们由各自的 bundle 在 profile 平面装一次
+ * （`dsh.profile.bundles` 里的 [`@morlay/dsh-agent-toolkit`](../dsh-agent-toolkit/README.md) 与
+ * [`@morlay/dsh-context-assembler`](../../context/dsh-context-assembler/README.md)）。模式只声明"我要哪些"。
+ *
+ * 这里是生成物的真源：`cordis.patch.yml` 由 `renderPatch()` 写出，改动请改这份 TS，
+ * 一致性由 `patch.spec.ts` 的断言兜住。
+ */
+
+function modeConfig(source: ModeSource): Record<string, unknown> {
+  return {
+    name: source.name,
+    description: source.description,
+    ...(source.role === undefined ? {} : { role: [...source.role] }),
+    ...(source.persona === undefined ? {} : { persona: { ...source.persona } }),
+    allowTools: [...source.allowTools],
+    ...(source.instructions === undefined ? {} : { instructions: source.instructions }),
+    ...(source.runtimeContext === undefined ? {} : { runtimeContext: source.runtimeContext }),
+  };
+}
+
+export const PATCH_ROWS: readonly Record<string, unknown>[] = [
+  {
+    insert: [
+      {
+        id: "session-mode",
+        name: "@morlay/dsh-session-mode",
+        config: {
+          default: DEFAULT_MODE,
+          modes: Object.fromEntries(MODE_SOURCES.map((source) => [source.id, modeConfig(source)])),
+          // 各模式的默认模型（volatile：设置页那张卡片写的就是这个路径）。当前没有配任何一条，
+          // 仍显式渲染成空对象——这份 patch 是装配层的真源，字段在不在要看得见。
+          models: Object.fromEntries(
+            Object.entries(MODE_MODELS).map(([id, model]) => [id, { ...model }]),
+          ),
+        },
+      },
+      // 行 id 与 name 的真源在 `@morlay/dsh-context-assembler/rows` 的 `scopeRow()`：模式的收口是那个包的
+      // 出口，这里只是把它装进装配（与模式定义同一份 patch，行序上服务在前）。
+      scopeRow(),
+    ],
+  },
+];
+
+export const PATCH_FILE = "cordis.patch.yml";
+
+const HEADER = `# 本文件由 packages/profile/dsh-session-mode/tool/patch.ts 生成，请勿手工编辑
+`;
+
+export function renderPatch(): string {
+  const body = yaml.dump([...PATCH_ROWS], {
+    schema: entryListSchema,
+    lineWidth: -1,
+    quotingType: '"',
+  });
+  return `${HEADER}${body}`;
+}
+
+/** 把 bundle patch 落到包根：它是发布产物的一部分（`files` 里有它，装配按出口解析）。 */
+export async function generatePatch(): Promise<string> {
+  const path = join(resolve(dirname(fileURLToPath(import.meta.url)), ".."), PATCH_FILE);
+  await writeFile(path, renderPatch());
+  return path;
+}
+
+/**
+ * tsdown 的 `build:done` 钩子：每次构建重写 `cordis.patch.yml`，入库的那份因此永远等于
+ * `PATCH_ROWS`（`patch.spec.ts` 比对文件与 `renderPatch()`）。
+ */
+export function patchHooks(): { "build:done": () => Promise<void> } {
+  return {
+    "build:done": async () => {
+      process.stdout.write(`generated ${await generatePatch()}\n`);
+    },
+  };
+}