@ai-zen/cli 0.9.0 → 1.0.0-alpha.1

package/dist/agents-store.js

@@ -0,0 +1,50 @@
+/**
+ * Agent / Sub-agent 定义仓储 —— CLI 层
+ *
+ * 管理两处定义目录（均为「每实体一个 JSON，文件名 = `<id>.json`」）：
+ *   - 顶层 Agent：`~/.ai-zen/agents/*.json`（`/config`「默认 Agent」可选的那些）
+ *   - 子 Agent：  `~/.ai-zen/sub-agents/*.json`（可被委派，额外带 `function` 定义）
+ *
+ * 单文件读写委托 SDK 的 `AgentRepository`（`EntityRepository`），本模块只做「按 kind 分派」
+ * 与「快照 + 写操作」的组装，便于 TUI 与单测共用。
+ */
+import { AgentRepository } from "@ai-zen/agents-sdk";
+import { AGENTS_DIR, SUB_AGENTS_DIR } from "./config.js";
+/** 某个 kind 对应的定义目录 */
+export function agentDir(kind) {
+    return kind === "agent" ? AGENTS_DIR : SUB_AGENTS_DIR;
+}
+/** kind 的中文名 */
+export function agentKindLabel(kind) {
+    return kind === "agent" ? "Agent" : "Sub-agent";
+}
+/** 取某 kind 的定义列表 */
+export function agentList(store, kind) {
+    return kind === "agent" ? store.agents : store.subAgents;
+}
+/** 按 id 查找某 kind 的定义 */
+export function findAgentDefinition(store, kind, id) {
+    if (!id)
+        return undefined;
+    return agentList(store, kind).find((def) => def.id === id);
+}
+/** 用给定快照 + 真实文件读写构造仓储 */
+export function createAgentStore(agents, subAgents) {
+    return {
+        agents,
+        subAgents,
+        save: async (kind, def) => {
+            await new AgentRepository(agentDir(kind)).write(def);
+        },
+        remove: async (kind, id) => {
+            await new AgentRepository(agentDir(kind)).delete(id);
+        },
+    };
+}
+/** 从磁盘读取 Agent / Sub-agent 快照，并附带真实读写能力 */
+export async function readAgentStore() {
+    const agents = await new AgentRepository(AGENTS_DIR).list();
+    const subAgents = await new AgentRepository(SUB_AGENTS_DIR).list();
+    return createAgentStore(agents, subAgents);
+}
+//# sourceMappingURL=agents-store.js.map

package/dist/agents-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-store.js","sourceRoot":"","sources":["../src/agents-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKzD,sBAAsB;AACtB,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;AACxD,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,cAAc,CAAC,IAAe;IAC5C,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;AAClD,CAAC;AAUD,oBAAoB;AACpB,MAAM,UAAU,SAAS,CAAC,KAAiB,EAAE,IAAe;IAC1D,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,mBAAmB,CACjC,KAAiB,EACjB,IAAe,EACf,EAAsB;IAEtB,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAC1B,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,SAA4B;IACtF,OAAO;QACL,MAAM;QACN,SAAS;QACT,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACxB,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;YACzB,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,MAAM,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,OAAO,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC"}

package/dist/auto-migrate-confirm-plugin.d.ts

@@ -34,16 +34,16 @@ export interface AutoMigrateConfirmOptions {
     maxTokens: number;
     /** 是否需要向用户确认；默认「stdin 与 stdout 均为 TTY」。可注入，便于单测 */
     shouldConfirm?: () => boolean;
-    /** 确认实现；默认为 inquirer 确认框。可注入，便于单测 */
-    confirm?: (info: AutoMigrateTriggerInfo) => Promise<boolean>;
+    /**
+     * 确认实现，由调用方注入（例如 TUI 的 Ink 确认框）。本模块不再内置任何交互 UI；
+     * 仅当 `shouldConfirm()` 为真时才会被调用。
+     */
+    confirm: (info: AutoMigrateTriggerInfo) => Promise<boolean>;
+    /** 输出信息（如「已跳过本次迁移」）；由调用方注入（TUI 走 Ink notice），默认丢弃 */
+    log?: (text: string) => void;
 }
 /** 默认交互判定：仅当 stdin 与 stdout 均为 TTY 时才具备确认通道 */
 export declare function canPromptUser(): boolean;
-/**
- * 默认确认实现：inquirer 确认框。
- * 默认「是」——回车即迁移，保持自动迁移的既有默认行为不被阻塞。
- */
-export declare function confirmAutoMigrate(info: AutoMigrateTriggerInfo): Promise<boolean>;
 /**
  * 自动迁移二次确认插件。
  *

package/dist/auto-migrate-confirm-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-migrate-confirm-plugin.d.ts","sourceRoot":"","sources":["../src/auto-migrate-confirm-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;gBAE/C,OAAO,EAAE,yBAAyB;IAKxC,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAmCnD"}
+{"version":3,"file":"auto-migrate-confirm-plugin.d.ts","sourceRoot":"","sources":["../src/auto-migrate-confirm-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,qDAAqD;IACrD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;gBAE/C,OAAO,EAAE,yBAAyB;IAKxC,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BnD"}

package/dist/auto-migrate-confirm-plugin.js

@@ -18,29 +18,11 @@
  *   - 用户拒绝时仅跳过**本次**迁移，不记录任何隐式状态：只要仍处于超限状态，下次发送后
  *     会再次询问；跳过不影响当前对话（历史未被剔除，语义与迁移前一致）。
  */
-import chalk from "chalk";
-import inquirer from "inquirer";
 import { AutoMigratePlugin } from "@ai-zen/agents-sdk";
 /** 默认交互判定：仅当 stdin 与 stdout 均为 TTY 时才具备确认通道 */
 export function canPromptUser() {
     return Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
-/**
- * 默认确认实现：inquirer 确认框。
- * 默认「是」——回车即迁移，保持自动迁移的既有默认行为不被阻塞。
- */
-export async function confirmAutoMigrate(info) {
-    const { confirmed } = await inquirer.prompt([
-        {
-            type: "confirm",
-            name: "confirmed",
-            message: `检测到上下文即将超限（${info.promptTokens}/${info.maxTokens} tokens），是否立即执行任务迁移？\n` +
-                "迁移将：生成交接文档 → 保存当前对话 → 开启新会话继续。",
-            default: true,
-        },
-    ]);
-    return Boolean(confirmed);
-}
 /**
  * 自动迁移二次确认插件。
  *
@@ -54,7 +36,7 @@ export class AutoMigrateConfirmPlugin extends AutoMigratePlugin {
         this.confirmOptions = options;
     }
     async onAfterSend(ctx) {
-        const { maxTokens, shouldConfirm = canPromptUser, confirm = confirmAutoMigrate, } = this.confirmOptions;
+        const { maxTokens, shouldConfirm = canPromptUser, confirm, log = () => { } } = this.confirmOptions;
         const promptTokens = ctx.agent.lastUsage?.prompt_tokens;
         // 未超阈值（或无用量信息）：无需询问，交由基类按原语义处理
         if (promptTokens == null || promptTokens <= maxTokens) {
@@ -68,8 +50,8 @@ export class AutoMigrateConfirmPlugin extends AutoMigratePlugin {
         }
         const confirmed = await confirm({ promptTokens, maxTokens });
         if (!confirmed) {
-            console.log(chalk.yellow("\n⏭️ 已跳过本次任务迁移，继续当前对话。\n"));
-            console.log(chalk.gray("💡 上下文仍接近上限：可随时输入 /migrate 手动迁移；若继续增长至严重超限，对话会被安全护栏中断。\n"));
+            log("⏭️ 已跳过本次任务迁移，继续当前对话。");
+            log("💡 上下文仍接近上限：可随时输入 /migrate 手动迁移；若继续增长至严重超限，对话会被安全护栏中断。");
             return;
         }
         // 用户已确认：交由基类完成「触发 + 委托共享迁移服务」的原逻辑

package/dist/auto-migrate-confirm-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-migrate-confirm-plugin.js","sourceRoot":"","sources":["../src/auto-migrate-confirm-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAsBvD,+CAA+C;AAC/C,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAA4B;IAE5B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAyB;QAClE;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,WAAW;YACjB,OAAO,EACL,cAAc,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,SAAS,wBAAwB;gBACzE,gCAAgC;YAClC,OAAO,EAAE,IAAI;SACd;KACF,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAC5C,cAAc,CAA4B;IAE3D,YAAY,OAAkC;QAC5C,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAgB;QAChC,MAAM,EACJ,SAAS,EACT,aAAa,GAAG,aAAa,EAC7B,OAAO,GAAG,kBAAkB,GAC7B,GAAG,IAAI,CAAC,cAAc,CAAC;QAExB,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC;QAExD,+BAA+B;QAC/B,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;YACtD,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACrB,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CACR,0DAA0D,CAC3D,CACF,CAAC;YACF,OAAO;QACT,CAAC;QAED,kCAAkC;QAClC,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"auto-migrate-confirm-plugin.js","sourceRoot":"","sources":["../src/auto-migrate-confirm-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA2BvD,+CAA+C;AAC/C,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAC5C,cAAc,CAA4B;IAE3D,YAAY,OAAkC;QAC5C,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAgB;QAChC,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,aAAa,EAAE,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,GAAE,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC;QAElG,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC;QAExD,+BAA+B;QAC/B,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;YACtD,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACrB,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,sBAAsB,CAAC,CAAC;YAC5B,GAAG,CAAC,wDAAwD,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,kCAAkC;QAClC,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/config-editor.d.ts

@@ -0,0 +1,201 @@
+/**
+ * 配置编辑 —— 纯函数层
+ *
+ * TUI 的「凭据设置屏」与「配置中心」只做渲染与键盘分发，所有对 `AppConfig` 的
+ * 读取与不可变改写集中在本模块，以便脱离 Ink 单测。
+ *
+ * 设计原则：
+ *   - 每个改写函数都返回**新对象**，调用方负责持久化（`saveConfig()`）；
+ *   - 不抛异常、不写盘、不读盘，纯输入 → 输出。
+ */
+import type { AgentDefinition, AgentPermissions, AppConfig, Endpoint, ImageModel, Model, PermissionPolicy } from "@ai-zen/agents-sdk";
+import type { AgentNS } from "@ai-zen/agents-core";
+import type { McpConfig, McpServerEntry } from "./config.js";
+/** 按 id 查找模型 */
+export declare function findModel(config: AppConfig, modelId: string | undefined): Model | undefined;
+/** 按 id 查找端点 */
+export declare function findEndpoint(config: AppConfig, endpointId: string | undefined): Endpoint | undefined;
+/** 引用某端点的模型清单（用于提示改动波及范围） */
+export declare function modelsUsingEndpoint(config: AppConfig, endpointId: string): Model[];
+/** API Key 是否已设置（空白视为未设置） */
+export declare function isApiKeySet(apiKey: string | undefined): boolean;
+/** 一次「凭据检查」的结果：某模型绑定的端点及其密钥状态 */
+export interface CredentialInfo {
+    modelId: string;
+    modelName: string;
+    endpointId: string;
+    endpointName: string;
+    baseUrl: string;
+    apiKey: string;
+    /** 密钥是否已设置 */
+    configured: boolean;
+}
+/**
+ * 解析某模型对应的端点凭据。
+ *
+ * 模型缺失或端点缺失时返回 `undefined`（此时无法给出「输入 Key」的引导，
+ * 属于配置本身残缺，交由调用方报错）。
+ */
+export declare function resolveCredential(config: AppConfig, modelId: string | undefined): CredentialInfo | undefined;
+/** 端点清单的一行摘要，如 `OpenAI ✗ · DeepSeek ✓` */
+export declare function summarizeEndpoints(config: AppConfig): string;
+/**
+ * 密钥掩码：保留首 4 / 末 4 位，中间省略。未设置时返回 `未设置`。
+ * 已知密钥（如 `sk-` 开头）同样按此规则裁剪，避免整串回显到屏幕。
+ */
+export declare function maskApiKey(apiKey: string | undefined): string;
+/** 凭据申请指引：按 baseUrl 识别厂商 */
+export interface ApiKeyGuide {
+    vendor: string;
+    /** 申请页面（未识别厂商时为 undefined，只给通用提示） */
+    url?: string;
+}
+export declare function apiKeyGuide(baseUrl: string | undefined): ApiKeyGuide;
+/** 写入某端点的 API Key（去除首尾空白） */
+export declare function setEndpointApiKey(config: AppConfig, endpointId: string, apiKey: string): AppConfig;
+/** 写入某端点的 Base URL（去除首尾空白） */
+export declare function setEndpointBaseUrl(config: AppConfig, endpointId: string, baseUrl: string): AppConfig;
+/** 设置默认模型（传 `undefined` 表示清空，交由 SDK 回退出厂默认） */
+export declare function setDefaultModel(config: AppConfig, modelId: string | undefined): AppConfig;
+/** 由端点名派生唯一的端点 id */
+export declare function uniqueEndpointId(config: AppConfig, name: string): string;
+/** 由模型名派生唯一的模型 id */
+export declare function uniqueModelId(config: AppConfig, name: string): string;
+/** 由图片模型名派生唯一的图片模型 id */
+export declare function uniqueImageModelId(config: AppConfig, name: string): string;
+/** 新增端点（id 由名称派生） */
+export declare function addEndpoint(config: AppConfig, input: {
+    name: string;
+    baseUrl: string;
+    apiKey: string;
+}): {
+    config: AppConfig;
+    endpoint: Endpoint;
+};
+/** 通用端点字段改写（不可变） */
+export declare function updateEndpoint(config: AppConfig, endpointId: string, patch: Partial<Endpoint>): AppConfig;
+/** 删除端点（调用方负责确认它不再被任何模型引用） */
+export declare function removeEndpoint(config: AppConfig, endpointId: string): AppConfig;
+/** 通用模型字段改写（不可变） */
+export declare function updateModel(config: AppConfig, modelId: string, patch: Partial<Model>): AppConfig;
+/**
+ * 删除模型；若 `defaultModel` / `defaultMigrationModel` 指向它，
+ * 则改指剩余的第一个模型（无剩余模型则清空）。
+ */
+export declare function removeModel(config: AppConfig, modelId: string): AppConfig;
+/** 新增模型（id 由名称派生；默认 `custom: true`，避免被 SDK 出厂清单托管覆盖） */
+export declare function addModel(config: AppConfig, input: {
+    name: string;
+    endpointId: string;
+    modelName?: string;
+}): {
+    config: AppConfig;
+    model: Model;
+};
+/** 通用图片模型字段改写（不可变） */
+export declare function updateImageModel(config: AppConfig, modelId: string, patch: Partial<ImageModel>): AppConfig;
+/** 删除图片模型；若 `defaultImageModel` 指向它，则改指剩余的第一个（无剩余则清空） */
+export declare function removeImageModel(config: AppConfig, modelId: string): AppConfig;
+/** 新增图片模型（id 由名称派生；默认 `custom: true`） */
+export declare function addImageModel(config: AppConfig, input: {
+    name: string;
+    endpointId: string;
+}): {
+    config: AppConfig;
+    model: ImageModel;
+};
+/** 设置默认图片模型（传 `undefined` 表示清空） */
+export declare function setDefaultImageModel(config: AppConfig, modelId: string | undefined): AppConfig;
+/** 设置默认 Agent（传 `undefined` 表示清空，交给 SDK 选第一个 Agent） */
+export declare function setDefaultAgent(config: AppConfig, agentId: string | undefined): AppConfig;
+/** 设置默认迁移模型（传 `undefined` 表示清空，交由 SDK 回退出厂默认） */
+export declare function setDefaultMigrationModel(config: AppConfig, modelId: string | undefined): AppConfig;
+/** 设置工具输出上限（字符数） */
+export declare function setMaxToolOutput(config: AppConfig, value: number): AppConfig;
+/**
+ * 解析参数串为 argv：支持单 / 双引号包裹，以及反斜杠转义空白。
+ * 例如 `-y chrome-devtools-mcp@latest` → `["-y", "chrome-devtools-mcp@latest"]`。
+ */
+export declare function parseArgs(raw: string): string[];
+/** argv → 单行文本（含空白 / 引号 / 反斜杠的参数用双引号包裹并转义） */
+export declare function formatArgs(args: string[] | undefined): string;
+/** 解析 `KEY=VALUE`（以首个 `=` 分割；KEY 去空白，VALUE 原样保留）；不含 `=` 或 KEY 为空返回 null */
+export declare function parseKvInput(raw: string): {
+    key: string;
+    value: string;
+} | null;
+/** 键值映射 → 有序数组（保持插入顺序） */
+export declare function kvEntries(map: Record<string, string> | undefined): {
+    key: string;
+    value: string;
+}[];
+/** 键值映射的展示摘要，如 `2 项（PATH, HOME）` / `（空）` */
+export declare function kvSummary(map: Record<string, string> | undefined): string;
+/** 按 id 查找 MCP 服务器 */
+export declare function findMcpServer(mcp: McpConfig, id: string | undefined): McpServerEntry | undefined;
+/** id 是否已被占用（`except` 用于重命名时排除自身） */
+export declare function mcpServerIdTaken(mcp: McpConfig, id: string, except?: string): boolean;
+/** 由名称派生唯一的 MCP 服务器 id */
+export declare function uniqueMcpServerId(mcp: McpConfig, name: string): string;
+/** 新增 MCP 服务器（id 由名称派生；默认 stdio、启用） */
+export declare function addMcpServer(mcp: McpConfig, name: string): {
+    mcp: McpConfig;
+    id: string;
+};
+/** 改写某 MCP 服务器的字段（不可变；未列出的字段原样保留） */
+export declare function updateMcpServer(mcp: McpConfig, id: string, patch: Partial<McpServerEntry>): McpConfig;
+/** 删除 MCP 服务器 */
+export declare function removeMcpServer(mcp: McpConfig, id: string): McpConfig;
+/** 重命名 MCP 服务器（改 key；保持原有顺序；假定新名已通过唯一性校验） */
+export declare function renameMcpServer(mcp: McpConfig, oldId: string, newId: string): McpConfig;
+/** Agent 四维权限的维度顺序 */
+export declare const PERMISSION_DIMENSIONS: readonly ["tools", "skills", "mcps", "subagents"];
+export type PermissionDimension = (typeof PERMISSION_DIMENSIONS)[number];
+/** 由名称派生唯一的 Agent id（在既有 id 集合内避让） */
+export declare function uniqueAgentId(taken: Iterable<string>, name: string, fallback?: string): string;
+/** 提示词 = 首条 system 消息的文本内容（无则空串） */
+export declare function getAgentPrompt(def: AgentDefinition): string;
+/** 写入提示词：替换首条 system 消息；不存在则前插一条 */
+export declare function setAgentPrompt(def: AgentDefinition, text: string): AgentDefinition;
+/** 权限策略 → 紧凑文本（`allow: a, b` / `deny: *`）；未设置 → 空串 */
+export declare function formatPermission(policy: PermissionPolicy | undefined): string;
+/**
+ * 紧凑文本 → 权限策略：
+ *   - 空串 → `null`（未设置）
+ *   - 非法 → 返回错误文本（string）
+ *   - 合法 → 返回 `PermissionPolicy`
+ */
+export declare function parsePermission(raw: string): PermissionPolicy | null | string;
+/** 读某维权限的紧凑文本 */
+export declare function formatAgentPermission(permissions: AgentPermissions | undefined, dim: PermissionDimension): string;
+/** 权限总览：列出已配置的维度（如 `4 维（tools, skills, mcps, subagents）`） */
+export declare function summarizePermissions(permissions: AgentPermissions | undefined): string;
+/** 写入某一维权限（`policy` 为 null 时删除该维） */
+export declare function setAgentPermission(def: AgentDefinition, dim: PermissionDimension, policy: PermissionPolicy | null): AgentDefinition;
+/** 通用 Agent 字段改写（纯合并；`updatedAt` 由写盘侧统一刷新） */
+export declare function updateAgentDefinition(def: AgentDefinition, patch: Partial<AgentDefinition>): AgentDefinition;
+/** 函数参数 schema → 紧凑 JSON 文本 */
+export declare function formatFunctionParameters(fn: AgentNS.FunctionDefine | undefined): string;
+/** 解析函数参数 JSON；合法返回对象，非法返回错误文本 */
+export declare function parseFunctionParameters(raw: string): Record<string, unknown> | string;
+/** 改写 Sub-agent 的 `function`（缺省时补一个骨架） */
+export declare function updateAgentFunction(def: AgentDefinition, patch: {
+    name?: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+}): AgentDefinition;
+/** 新建顶层 Agent 定义 */
+export declare function createAgentDefinition(input: {
+    id: string;
+    name: string;
+    prompt?: string;
+    now?: string;
+}): AgentDefinition;
+/** 新建 Sub-agent 定义（带 function 骨架，尾部保留 `{{task}}` 用户消息） */
+export declare function createSubAgentDefinition(input: {
+    id: string;
+    name: string;
+    prompt?: string;
+    now?: string;
+}): AgentDefinition;
+//# sourceMappingURL=config-editor.d.ts.map

package/dist/config-editor.d.ts.map

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