@ai-zen/cli 1.0.0-alpha.8 → 1.0.0

package/dist/mode.js

@@ -5,8 +5,15 @@
  *
  * | 模式        | 触发条件                                   | 面向对象               |
  * |-------------|--------------------------------------------|------------------------|
- * | 纯 stdio    | 带位置参数，或 stdin/stdout 非 TTY          | 脚本、管道、shell 钩子 |
- * | TUI         | 无参数且 stdin/stdout 均为 TTY              | 人类用户               |
+ * | 纯 stdio    | 带位置参数，或 stdin/stdout 非 TTY          | 脚本、管道             |
+ * | TUI         | 无参数且 stdin/stdout 均为 TTY；或 `--tui` | 人类用户               |
+ *
+ * `--new` 是 TUI 路径上的修饰项，不改变模式判定：它只表示「跳过续接、开一条新会话」。
+ * 出现在 stdio 路径上时被忽略（stdio 本就是一次性会话，不存在续接）。
+ *
+ * 注意：**shell 钩子不属于纯 stdio**。钩子的发起场景是「人坐在交互终端前敲错了命令」，
+ * 因此它走 `ai --tui --new "$@"` 进 TUI，并把原命令作为首条消息自动发送。
+ * （早期版本写成 `ai "$@"`，于是钩子会话被当成脚本调用落到管道模式——那是实现错误。）
  *
  * 本模块为纯函数与纯数据，不触碰 stdin/stdout、不 import chalk 等 UI 依赖，
  * 便于单测（模式判定与路由是改造中风险最高的逻辑，必须被测覆盖）。
@@ -19,6 +26,8 @@ const HOOK_ACTIONS = new Set(["install", "uninstall"]);
  * - 有位置参数 → stdio（脚本/管道优先，绝不进 TUI）
  * - 无参数但 stdin 或 stdout 非 TTY → stdio（管道、重定向、CI）
  * - 无参数且 stdin/stdout 均为 TTY → TUI
+ *
+ * `--tui` 不经过本函数：它是显式覆盖，在 `resolveInvocation()` 里优先处理。
  */
 export function decideMode(tty, hasArgs) {
     if (hasArgs)
@@ -38,6 +47,8 @@ export function resolveInvocation(argv, tty) {
     let save = false;
     let wantHelp = false;
     let wantVersion = false;
+    let wantTui = false;
+    let wantNew = false;
     let passthrough = false;
     for (const arg of argv) {
         if (passthrough) {
@@ -52,6 +63,14 @@ export function resolveInvocation(argv, tty) {
             save = true;
             continue;
         }
+        if (arg === "--tui") {
+            wantTui = true;
+            continue;
+        }
+        if (arg === "--new") {
+            wantNew = true;
+            continue;
+        }
         if (arg === "--help" || arg === "-h") {
             wantHelp = true;
             continue;
@@ -65,19 +84,35 @@ export function resolveInvocation(argv, tty) {
     // 子命令短路（与运行模式无关的管理动作）
     if (positional[0] === "hook") {
         const action = positional[1];
-        return {
-            kind: "hook",
-            action: action && HOOK_ACTIONS.has(action) ? action : "usage",
-        };
+        if (action && HOOK_ACTIONS.has(action))
+            return { kind: "hook", action: action };
+        // 没给子动作（含 `ai hook --help`，`--help` 已被当选项吃掉）：只是要看用法
+        if (action === undefined)
+            return { kind: "hook", action: "usage" };
+        return { kind: "hook", action: "usage", invalidAction: action };
     }
     if (wantHelp)
         return { kind: "help" };
     if (wantVersion)
         return { kind: "version" };
+    // `ai help` / `ai version`：单词形式与 `--help` / `--version` 等价。
+    // 只在它是**唯一**参数时判定 —— `ai help me refactor this` 仍然是在提问。
+    if (positional.length === 1 && positional[0] === "help")
+        return { kind: "help" };
+    if (positional.length === 1 && positional[0] === "version")
+        return { kind: "version" };
     const instruction = positional.join(" ").trim();
+    // 显式要求 TUI（shell 钩子走这条）：参数不再是「脚本提问」，而是待发送的首条消息。
+    // 非 TTY 时宁可报错，也不能默默降级成 stdio—— 否则界面内容会写进管道。
+    if (wantTui) {
+        if (!tty.stdinIsTTY || !tty.stdoutIsTTY)
+            return { kind: "tui-rejected" };
+        return { kind: "tui", initialPrompt: instruction || undefined, newSession: wantNew || undefined };
+    }
     const mode = decideMode(tty, positional.length > 0);
+    // `--new` 只在 TUI 路径有意义；走到 stdio（脚本 / 管道）时静默忽略
     if (mode === "tui")
-        return { kind: "tui" };
+        return { kind: "tui", newSession: wantNew || undefined };
     return { kind: "stdio", instruction, save };
 }
 //# sourceMappingURL=mode.js.map

package/dist/mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwBH,qBAAqB;AACrB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,GAAa,EAAE,OAAgB;IACxD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC;IACxD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc,EAAE,GAAa;IAC7D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,IAAI,GAAG,IAAI,CAAC;YACZ,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACxC,WAAW,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,sBAAsB;IACtB,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,MAAM,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAkC,CAAC,CAAC,CAAC,OAAO;SAC3F,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACtC,IAAI,WAAW;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAE5C,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"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"}

package/dist/model-switch.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 模型切换 —— `/model` 的写配置策略（纯逻辑，可单测）
+ *
+ * ## 唯一真相源
+ *
+ * 模型只写在 **`AgentDefinition.modelId`** 上：
+ *
+ *   - 配置层没有 `defaultModel`（`AppConfig` 已无此字段）；
+ *   - 会话存档不记模型（`Conversation` 已无 `modelId`）；
+ *   - 运行期 `createAgent` 只读 `definition.modelId`，缺了直接报错。
+ *
+ * 于是「切换模型」只有一种写法和一种读法，不存在两层分歧导致的
+ * 「状态栏显示 A、实际请求发 B」。
+ *
+ * ## 切换即重置思考强度
+ *
+ * `AgentDefinition.modelParams` 里的思考参数（`thinking` / `reasoning_effort` 等）是
+ * **模型相关**的：DeepSeek 的 `off` 档是 `thinking: { type: "disabled" }`，而智谱 GLM-5.3
+ * 根本不接受关闭思考。把旧模型的档位带到新模型上，轻则无意义，重则直接报错。
+ *
+ * 所以换模型时**直接清空 `modelParams`**（不保留、不迁移、不逐键剔除），让 Agent
+ * 回到「不填思考强度」的状态，由目标模型自己的 `defaultParams` 决定。用户想调就
+ * 再用 `/think` 选一次。
+ *
+ * ## 注意
+ *
+ * **Agent 定义的其它字段不可丢**：SDK 初始化时只同步出厂提示词，
+ * 其余字段（权限、`custom` 等）以用户文件为准，因此写入是「读 → 改字段 → 写回」。
+ */
+import type { AgentDefinition } from "@ai-zen/agents-sdk";
+export interface SwitchModelDeps {
+    /** 读 Agent 定义（默认：`~/.ai-zen/agents/<id>.json`） */
+    readAgent?: (agentId: string) => Promise<AgentDefinition | null>;
+    /** 写 Agent 定义 */
+    writeAgent?: (definition: AgentDefinition) => Promise<void>;
+    /** 当前时间（测试可固定） */
+    now?: Date;
+}
+export interface SwitchModelOptions extends SwitchModelDeps {
+    config: import("@ai-zen/agents-sdk").AppConfig;
+    /** 当前会话的 Agent（缺省视为 default） */
+    agentId?: string;
+    /** 目标模型 id */
+    modelId: string;
+}
+export interface SwitchModelResult {
+    /** 面向用户的一句话结果 */
+    summary: string;
+    /** 变更后的 Agent 定义 */
+    definition: AgentDefinition;
+}
+/**
+ * 切换模型：把目标模型写进 Agent 定义的 `modelId`，并把思考强度重置为模型默认。
+ *
+ * 抛错场景：模型不存在、Agent 定义缺失。
+ */
+export declare function switchModel(options: SwitchModelOptions): Promise<SwitchModelResult>;
+//# sourceMappingURL=model-switch.d.ts.map

package/dist/model-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-switch.d.ts","sourceRoot":"","sources":["../src/model-switch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACjE,iBAAiB;IACjB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,kBAAkB;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,MAAM,EAAE,OAAO,oBAAoB,EAAE,SAAS,CAAC;IAC/C,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4BzF"}

package/dist/model-switch.js

@@ -0,0 +1,62 @@
+/**
+ * 模型切换 —— `/model` 的写配置策略（纯逻辑，可单测）
+ *
+ * ## 唯一真相源
+ *
+ * 模型只写在 **`AgentDefinition.modelId`** 上：
+ *
+ *   - 配置层没有 `defaultModel`（`AppConfig` 已无此字段）；
+ *   - 会话存档不记模型（`Conversation` 已无 `modelId`）；
+ *   - 运行期 `createAgent` 只读 `definition.modelId`，缺了直接报错。
+ *
+ * 于是「切换模型」只有一种写法和一种读法，不存在两层分歧导致的
+ * 「状态栏显示 A、实际请求发 B」。
+ *
+ * ## 切换即重置思考强度
+ *
+ * `AgentDefinition.modelParams` 里的思考参数（`thinking` / `reasoning_effort` 等）是
+ * **模型相关**的：DeepSeek 的 `off` 档是 `thinking: { type: "disabled" }`，而智谱 GLM-5.3
+ * 根本不接受关闭思考。把旧模型的档位带到新模型上，轻则无意义，重则直接报错。
+ *
+ * 所以换模型时**直接清空 `modelParams`**（不保留、不迁移、不逐键剔除），让 Agent
+ * 回到「不填思考强度」的状态，由目标模型自己的 `defaultParams` 决定。用户想调就
+ * 再用 `/think` 选一次。
+ *
+ * ## 注意
+ *
+ * **Agent 定义的其它字段不可丢**：SDK 初始化时只同步出厂提示词，
+ * 其余字段（权限、`custom` 等）以用户文件为准，因此写入是「读 → 改字段 → 写回」。
+ */
+import { AgentRepository } from "@ai-zen/agents-sdk";
+import { AGENTS_DIR } from "./config.js";
+import { t } from "./i18n/index.js";
+/**
+ * 切换模型：把目标模型写进 Agent 定义的 `modelId`，并把思考强度重置为模型默认。
+ *
+ * 抛错场景：模型不存在、Agent 定义缺失。
+ */
+export async function switchModel(options) {
+    const { config, modelId } = options;
+    const agentId = options.agentId || "default";
+    const now = options.now ?? new Date();
+    const model = (config.models ?? []).find((item) => item.id === modelId);
+    if (!model)
+        throw new Error(t("modelSwitch.err.modelMissing", { id: modelId }));
+    const readAgent = options.readAgent ?? ((id) => new AgentRepository(AGENTS_DIR).read(id));
+    const writeAgent = options.writeAgent ??
+        ((definition) => new AgentRepository(AGENTS_DIR).write(definition));
+    const definition = await readAgent(agentId);
+    if (!definition)
+        throw new Error(t("modelSwitch.err.agentMissing", { id: agentId }));
+    const next = { ...definition, modelId, updatedAt: now.toISOString() };
+    // 换模型 = 重置思考强度：旧模型的档位参数对新模型可能非法（如 GLM-5.3 不接受
+    // `thinking.disabled`），所以直接清空，让目标模型走自己的 defaultParams。
+    delete next.modelParams;
+    await writeAgent(next);
+    const resetHint = definition.modelParams ? t("modelSwitch.resetHint") : "";
+    return {
+        summary: t("modelSwitch.summary", { name: model.name, id: model.id, agent: agentId, hint: resetHint }),
+        definition: next,
+    };
+}
+//# sourceMappingURL=model-switch.js.map

package/dist/model-switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-switch.js","sourceRoot":"","sources":["../src/model-switch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AA0BpC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAEtC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACxE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,8BAA8B,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAEhF,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,UAAU,GACd,OAAO,CAAC,UAAU;QAClB,CAAC,CAAC,UAA2B,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAEvF,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,8BAA8B,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAErF,MAAM,IAAI,GAAoB,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;IACvF,8CAA8C;IAC9C,uDAAuD;IACvD,OAAO,IAAI,CAAC,WAAW,CAAC;IACxB,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IAEvB,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,OAAO;QACL,OAAO,EAAE,CAAC,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACtG,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC"}

package/dist/reasoning-effort.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 思考档位（reasoning level）—— CLI 侧读写
+ *
+ * ## 三层，边界很硬
+ *
+ *   - **协议差异在策略表**（`~/.ai-zen/reasoning-presets.json`）：档位名 → 请求参数补丁，
+ *     由这张 CLI 自有的表声明，模型用 `reasoningPreset` 引用它。
+ *   - **档位值存在 Agent 定义**（`AgentDefinition.modelParams`）：**存的是展开后的参数**，
+ *     不是档位名。于是「配置即事实」——运行期 SDK 只做一次浅合并，不查表、不推导。
+ *   - **本模块只管 UI 语义**：列可选档位、把参数反查成档位名、写回 Agent 定义。
+ *
+ * 代价（刻意接受）：改了策略表**不会追溯**已配置的 Agent —— 它们存的是当时的参数。
+ * 这正是「配置即事实」的含义：表只是写配置那一刻的模板。
+ */
+import type { AgentDefinition, AppConfig, Model } from "@ai-zen/agents-sdk";
+import { type ReasoningPreset, type ReasoningPresets } from "./reasoning-presets.js";
+/**
+ * 已知档位名清单。
+ *
+ * 不设成穷举映射：档位名由策略表定义（用户可自建策略、自定档位名），
+ * 未收录的名字直接显示原文，比显示「?」有用得多。
+ * 文案本身在 i18n 词典的 `effort.<档位名>` 里（中 / 英各一份）。
+ */
+export declare const KNOWN_EFFORT_LEVELS: readonly string[];
+/** 档位 → 显示文案（未收录的档位名原样显示） */
+export declare function effortLabel(level: string): string;
+/** 模型关联的策略 */
+export declare function presetOf(model: Model | null | undefined, presets: ReasoningPresets): ReasoningPreset | undefined;
+/** 模型可选档位（空数组 = 不可调档） */
+export declare function effortChoices(model?: Model | null, presets?: ReasoningPresets | null): string[];
+/** 一档都用不了的模型 */
+export declare function isAdjustable(model?: Model | null, presets?: ReasoningPresets | null): boolean;
+/**
+ * 生效中的模型参数 = 模型默认参数 + Agent 级覆盖（与 SDK 的合并语义一致，浅合并）。
+ *
+ * 注意这里复刻的是**同一份事实**，不是另一套推导：状态栏显示的就是真正会发给 API 的
+ * 那几个参数里匹配到的那一档。
+ */
+export declare function effectiveParams(model?: Model | null, definition?: Pick<AgentDefinition, "modelParams"> | null): Record<string, unknown>;
+/**
+ * 状态栏文案。
+ *
+ * - 模型不可调档 → `—`
+ * - 生效参数命中某档 → 「低」「中」「高」…（按 `EFFORT_LABELS`）
+ * - 有 Agent 级覆盖但不匹配任何档位 → 「自定义」（用户手改过参数）
+ * - 没有任何声明 → 「默认」（跟随模型 `defaultParams`，如 DeepSeek 出厂只开思考不指定档位）
+ */
+export declare function describeEffort(model?: Model | null, presets?: ReasoningPresets | null, definition?: Pick<AgentDefinition, "modelParams"> | null): string;
+/**
+ * 状态栏用的思考强度视图：文案 + 是否置灰。
+ *
+ * 合成一个对象返回，是为了让调用方**一次取全**——分成两个函数调用容易出现
+ * 「文案更新了、置灰没跟上」这种漂移。
+ */
+export declare function describeEffortView(model?: Model | null, presets?: ReasoningPresets | null, definition?: Pick<AgentDefinition, "modelParams"> | null): {
+    text: string;
+    dimmed: boolean;
+};
+/**
+ * 状态栏里思考强度是否该置灰 —— **不靠文案判断**。
+ *
+ * 旧实现是 `effort === "关" || effort === "—"`，而那两个字本身就是显示文案：
+ * 一切语言，判断就失效（英文界面下 `"off"` 永远不等于 `"关"`）。
+ * 这里改成基于档位值的语义判断：不可调档，或档位是 off / none。
+ */
+export declare function effortDimmed(model?: Model | null, presets?: ReasoningPresets | null, definition?: Pick<AgentDefinition, "modelParams"> | null): boolean;
+export interface SetAgentEffortOptions {
+    config: AppConfig;
+    /** 思考策略表（`readReasoningPresets()` 的结果） */
+    presets: ReasoningPresets;
+    /** 目标 Agent（缺省 default） */
+    agentId?: string;
+    /** 目标档位；`null` 表示清除思考参数、恢复跟随模型默认 */
+    effort: string | null;
+    /** 注入用（测试） */
+    readAgent?: (agentId: string) => Promise<AgentDefinition | null>;
+    writeAgent?: (definition: AgentDefinition) => Promise<void>;
+    now?: Date;
+}
+export interface SetAgentEffortResult {
+    definition: AgentDefinition;
+    /** 生效模型 */
+    model: Model;
+    summary: string;
+}
+/**
+ * 设置某 Agent 的思考档位：查表拿补丁 → 写进 `definition.modelParams`。
+ *
+ * 写入前先剔除「整张表出现过的键」，所以 `max` → `off` 不会残留上一档的
+ * `reasoning_effort`；`effort: null` 就是剔除后若为空则删掉整个 `modelParams`。
+ *
+ * 抛错场景：Agent 不存在、未绑定可用模型、模型未关联策略、策略里没有该档位。
+ * 这些都属于「用户明确要求了一件做不到的事」，宁可报错也不要静默降级。
+ */
+export declare function setAgentEffort(options: SetAgentEffortOptions): Promise<SetAgentEffortResult>;
+//# sourceMappingURL=reasoning-effort.d.ts.map

package/dist/reasoning-effort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-effort.d.ts","sourceRoot":"","sources":["../src/reasoning-effort.ts"],"names":[],"mappings":"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"}

package/dist/reasoning-effort.js

@@ -0,0 +1,164 @@
+/**
+ * 思考档位（reasoning level）—— CLI 侧读写
+ *
+ * ## 三层，边界很硬
+ *
+ *   - **协议差异在策略表**（`~/.ai-zen/reasoning-presets.json`）：档位名 → 请求参数补丁，
+ *     由这张 CLI 自有的表声明，模型用 `reasoningPreset` 引用它。
+ *   - **档位值存在 Agent 定义**（`AgentDefinition.modelParams`）：**存的是展开后的参数**，
+ *     不是档位名。于是「配置即事实」——运行期 SDK 只做一次浅合并，不查表、不推导。
+ *   - **本模块只管 UI 语义**：列可选档位、把参数反查成档位名、写回 Agent 定义。
+ *
+ * 代价（刻意接受）：改了策略表**不会追溯**已配置的 Agent —— 它们存的是当时的参数。
+ * 这正是「配置即事实」的含义：表只是写配置那一刻的模板。
+ */
+import { AgentRepository } from "@ai-zen/agents-sdk";
+import { AGENTS_DIR } from "./config.js";
+import { t } from "./i18n/index.js";
+import { levelsOf, matchLevel, ownedKeys, patchOf, presetFor, } from "./reasoning-presets.js";
+/**
+ * 已知档位名清单。
+ *
+ * 不设成穷举映射：档位名由策略表定义（用户可自建策略、自定档位名），
+ * 未收录的名字直接显示原文，比显示「?」有用得多。
+ * 文案本身在 i18n 词典的 `effort.<档位名>` 里（中 / 英各一份）。
+ */
+export const KNOWN_EFFORT_LEVELS = [
+    "off",
+    "none",
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max",
+];
+/** 档位 → 显示文案（未收录的档位名原样显示） */
+export function effortLabel(level) {
+    return KNOWN_EFFORT_LEVELS.includes(level) ? t(`effort.${level}`) : level;
+}
+/** 模型关联的策略 */
+export function presetOf(model, presets) {
+    return presetFor(model?.id, model?.reasoningPreset, presets);
+}
+/** 模型可选档位（空数组 = 不可调档） */
+export function effortChoices(model, presets) {
+    if (!presets)
+        return [];
+    return levelsOf(presetOf(model, presets));
+}
+/** 一档都用不了的模型 */
+export function isAdjustable(model, presets) {
+    return effortChoices(model, presets).length > 0;
+}
+/**
+ * 生效中的模型参数 = 模型默认参数 + Agent 级覆盖（与 SDK 的合并语义一致，浅合并）。
+ *
+ * 注意这里复刻的是**同一份事实**，不是另一套推导：状态栏显示的就是真正会发给 API 的
+ * 那几个参数里匹配到的那一档。
+ */
+export function effectiveParams(model, definition) {
+    return { ...(model?.defaultParams ?? {}), ...(definition?.modelParams ?? {}) };
+}
+/**
+ * 状态栏文案。
+ *
+ * - 模型不可调档 → `—`
+ * - 生效参数命中某档 → 「低」「中」「高」…（按 `EFFORT_LABELS`）
+ * - 有 Agent 级覆盖但不匹配任何档位 → 「自定义」（用户手改过参数）
+ * - 没有任何声明 → 「默认」（跟随模型 `defaultParams`，如 DeepSeek 出厂只开思考不指定档位）
+ */
+export function describeEffort(model, presets, definition) {
+    if (!presets || !isAdjustable(model, presets))
+        return t("effort.unsupported");
+    const params = effectiveParams(model, definition);
+    const matched = matchLevel(presetOf(model, presets), params);
+    if (matched)
+        return effortLabel(matched);
+    return definition?.modelParams && Object.keys(definition.modelParams).length > 0
+        ? t("effort.custom")
+        : t("effort.default");
+}
+/**
+ * 状态栏用的思考强度视图：文案 + 是否置灰。
+ *
+ * 合成一个对象返回，是为了让调用方**一次取全**——分成两个函数调用容易出现
+ * 「文案更新了、置灰没跟上」这种漂移。
+ */
+export function describeEffortView(model, presets, definition) {
+    return {
+        text: describeEffort(model, presets, definition),
+        dimmed: effortDimmed(model, presets, definition),
+    };
+}
+/**
+ * 状态栏里思考强度是否该置灰 —— **不靠文案判断**。
+ *
+ * 旧实现是 `effort === "关" || effort === "—"`，而那两个字本身就是显示文案：
+ * 一切语言，判断就失效（英文界面下 `"off"` 永远不等于 `"关"`）。
+ * 这里改成基于档位值的语义判断：不可调档，或档位是 off / none。
+ */
+export function effortDimmed(model, presets, definition) {
+    if (!presets || !isAdjustable(model, presets))
+        return true;
+    const level = matchLevel(presetOf(model, presets), effectiveParams(model, definition));
+    return level === "off" || level === "none";
+}
+/**
+ * 设置某 Agent 的思考档位：查表拿补丁 → 写进 `definition.modelParams`。
+ *
+ * 写入前先剔除「整张表出现过的键」，所以 `max` → `off` 不会残留上一档的
+ * `reasoning_effort`；`effort: null` 就是剔除后若为空则删掉整个 `modelParams`。
+ *
+ * 抛错场景：Agent 不存在、未绑定可用模型、模型未关联策略、策略里没有该档位。
+ * 这些都属于「用户明确要求了一件做不到的事」，宁可报错也不要静默降级。
+ */
+export async function setAgentEffort(options) {
+    const { config, presets, effort } = options;
+    const agentId = options.agentId || "default";
+    const now = options.now ?? new Date();
+    const readAgent = options.readAgent ?? ((id) => new AgentRepository(AGENTS_DIR).read(id));
+    const writeAgent = options.writeAgent ??
+        ((definition) => new AgentRepository(AGENTS_DIR).write(definition));
+    const definition = await readAgent(agentId);
+    if (!definition)
+        throw new Error(t("effort.err.agentMissing", { id: agentId }));
+    const modelId = definition.modelId;
+    if (!modelId) {
+        throw new Error(t("effort.err.noModel", { id: agentId }));
+    }
+    const model = (config.models ?? []).find((item) => item.id === modelId);
+    if (!model)
+        throw new Error(t("effort.err.modelMissing", { id: modelId }));
+    const preset = presetOf(model, presets);
+    const allowed = levelsOf(preset);
+    if (allowed.length === 0) {
+        throw new Error(t("effort.err.noPreset", { id: model.id }));
+    }
+    const patch = effort === null ? undefined : patchOf(preset, effort);
+    if (effort !== null && !patch) {
+        throw new Error(t("effort.err.unknownLevel", { preset: model.reasoningPreset ?? "", level: effort, options: allowed.join(" / ") }));
+    }
+    // 先剔除思考相关键，再合并新补丁（`null` 即只剔除）
+    const owned = ownedKeys(presets);
+    const params = {};
+    for (const [key, value] of Object.entries(definition.modelParams ?? {})) {
+        if (!owned.has(key))
+            params[key] = value;
+    }
+    if (patch)
+        Object.assign(params, patch);
+    const next = { ...definition, updatedAt: now.toISOString() };
+    if (Object.keys(params).length > 0)
+        next.modelParams = params;
+    else
+        delete next.modelParams;
+    await writeAgent(next);
+    const label = effort === null ? t("effort.followDefault") : t("effort.quoted", { label: effortLabel(effort) });
+    return {
+        definition: next,
+        model,
+        summary: t("effort.summary", { label, id: agentId, model: model.id }),
+    };
+}
+//# sourceMappingURL=reasoning-effort.js.map

package/dist/reasoning-effort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-effort.js","sourceRoot":"","sources":["../src/reasoning-effort.ts"],"names":[],"mappings":"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"}

package/dist/reasoning-presets.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 思考预设 —— CLI 侧的表操作（纯函数）
+ *
+ * 表的**定义、出厂内容、读写**都在 SDK（`@ai-zen/agents-sdk` 的 `ReasoningPresets` /
+ * `FACTORY_REASONING_PRESETS` / `ConfigManager.readReasoningPresets()`），因为桌面端等
+ * 其它客户端也要用同一套档位知识。
+ *
+ * 本模块只负责「**利用**这张表」：CLI 用它限制 `/think` 的可选档位、把选中的档位展开成
+ * 请求参数写进 `AgentDefinition.modelParams`、以及把现有参数反查成档位名做展示。
+ *
+ * 全部是纯函数、不碰文件——SDK 不替我们决定这些，客户端自己掌握「怎么用表」。
+ */
+import type { ReasoningPreset, ReasoningPresets } from "@ai-zen/agents-sdk";
+export type { ReasoningPatch, ReasoningPreset, ReasoningPresets } from "@ai-zen/agents-sdk";
+/** 模型关联的策略（未声明 `reasoningPreset` 或名字不存在 → `undefined`） */
+export declare function presetFor(modelId: string | undefined, presetName: string | undefined, presets: ReasoningPresets): ReasoningPreset | undefined;
+/** 某策略的全部档位（= `levels` 的键，顺序即声明顺序） */
+export declare function levelsOf(preset: ReasoningPreset | undefined): string[];
+/** 某策略某档的参数补丁 */
+export declare function patchOf(preset: ReasoningPreset | undefined, level: string): Record<string, unknown> | undefined;
+/**
+ * 整张表出现过的参数键。
+ *
+ * 换档时按此剔除旧值 —— 这样 `max` → `off` 不会残留上一个档位的 `reasoning_effort`，
+ * 而「哪些键属于思考」由表自己声明，代码零硬编码。「表里没有的键」一律当普通参数保留。
+ */
+export declare function ownedKeys(presets: ReasoningPresets): Set<string>;
+/**
+ * 反查：现有参数命中哪个档位（多张补丁同时命中取最具体的）。
+ *
+ * 纯展示用途 —— 状态栏要显示「当前是第几档」。命中不了返回 `undefined`。
+ */
+export declare function matchLevel(preset: ReasoningPreset | undefined, params: Record<string, unknown> | undefined | null): string | undefined;
+//# sourceMappingURL=reasoning-presets.d.ts.map

package/dist/reasoning-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-presets.d.ts","sourceRoot":"","sources":["../src/reasoning-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQ5F,0DAA0D;AAC1D,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,gBAAgB,GACxB,eAAe,GAAG,SAAS,CAG7B;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,EAAE,CAEtE;AAED,iBAAiB;AACjB,wBAAgB,OAAO,CACrB,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,CAQhE;AAgBD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACjD,MAAM,GAAG,SAAS,CAYpB"}

package/dist/reasoning-presets.js

@@ -0,0 +1,85 @@
+/**
+ * 思考预设 —— CLI 侧的表操作（纯函数）
+ *
+ * 表的**定义、出厂内容、读写**都在 SDK（`@ai-zen/agents-sdk` 的 `ReasoningPresets` /
+ * `FACTORY_REASONING_PRESETS` / `ConfigManager.readReasoningPresets()`），因为桌面端等
+ * 其它客户端也要用同一套档位知识。
+ *
+ * 本模块只负责「**利用**这张表」：CLI 用它限制 `/think` 的可选档位、把选中的档位展开成
+ * 请求参数写进 `AgentDefinition.modelParams`、以及把现有参数反查成档位名做展示。
+ *
+ * 全部是纯函数、不碰文件——SDK 不替我们决定这些，客户端自己掌握「怎么用表」。
+ */
+/** 安全取自有属性（策略名来自用户配置，可能是 `constructor` / `__proto__`） */
+function own(bag, key) {
+    if (!bag || !Object.prototype.hasOwnProperty.call(bag, key))
+        return undefined;
+    return bag[key];
+}
+/** 模型关联的策略（未声明 `reasoningPreset` 或名字不存在 → `undefined`） */
+export function presetFor(modelId, presetName, presets) {
+    if (!modelId || !presetName)
+        return undefined;
+    return own(presets, presetName);
+}
+/** 某策略的全部档位（= `levels` 的键，顺序即声明顺序） */
+export function levelsOf(preset) {
+    return preset ? Object.keys(preset.levels ?? {}) : [];
+}
+/** 某策略某档的参数补丁 */
+export function patchOf(preset, level) {
+    return own(preset?.levels, level);
+}
+/**
+ * 整张表出现过的参数键。
+ *
+ * 换档时按此剔除旧值 —— 这样 `max` → `off` 不会残留上一个档位的 `reasoning_effort`，
+ * 而「哪些键属于思考」由表自己声明，代码零硬编码。「表里没有的键」一律当普通参数保留。
+ */
+export function ownedKeys(presets) {
+    const keys = new Set();
+    for (const preset of Object.values(presets ?? {})) {
+        for (const patch of Object.values(preset?.levels ?? {})) {
+            for (const key of Object.keys(patch ?? {}))
+                keys.add(key);
+        }
+    }
+    return keys;
+}
+/** 结构化相等 —— 补丁是纯 JSON，逐层比对即可 */
+function sameValue(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== "object" || typeof b !== "object" || a === null || b === null)
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    const left = a;
+    const right = b;
+    const leftKeys = Object.keys(left);
+    if (leftKeys.length !== Object.keys(right).length)
+        return false;
+    return leftKeys.every((k) => Object.prototype.hasOwnProperty.call(right, k) && sameValue(left[k], right[k]));
+}
+/**
+ * 反查：现有参数命中哪个档位（多张补丁同时命中取最具体的）。
+ *
+ * 纯展示用途 —— 状态栏要显示「当前是第几档」。命中不了返回 `undefined`。
+ */
+export function matchLevel(preset, params) {
+    if (!preset || !params)
+        return undefined;
+    let best;
+    let bestSize = 0;
+    for (const [level, patch] of Object.entries(preset.levels ?? {})) {
+        const keys = Object.keys(patch ?? {});
+        if (keys.length === 0 || keys.length <= bestSize)
+            continue;
+        if (!keys.every((k) => sameValue(params[k], patch[k])))
+            continue;
+        best = level;
+        bestSize = keys.length;
+    }
+    return best;
+}
+//# sourceMappingURL=reasoning-presets.js.map

package/dist/reasoning-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-presets.js","sourceRoot":"","sources":["../src/reasoning-presets.ts"],"names":[],"mappings":"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"}