@ai-zen/cli 1.0.0-alpha.3 → 1.0.0-alpha.31

package/dist/agent-creator.js

@@ -10,12 +10,45 @@ import { Scope, allInOne, createAgent as sdkCreateAgent, } from "@ai-zen/agents-
 import { AGENTS_DIR, SUB_AGENTS_DIR, SKILLS_DIR, TOOLS_DIR, AI_ZEN_DIR, PROJECT_SUB_AGENTS_DIR, PROJECT_SKILLS_DIR, PROJECT_TOOLS_DIR, USER_AGENTS_SKILLS_DIR, USER_AGENTS_MCP_CONFIG_FILE, PROJECT_AGENTS_SKILLS_DIR, PROJECT_AGENTS_MCP_CONFIG_FILE, } from "./config.js";
 import { readConfig } from "./config.js";
 // ==================== Scope 创建（单例）====================
-let _scope = null;
+/**
+ * Scope 单例缓存的是 **Promise** 而非实例。
+ *
+ * 缓存实例时，`if (_scope) return _scope` 之后到赋值之间有一段 `await`（读配置、初始化），
+ * 并发调用会一起穿透 → 建出两个 Scope（MCP 双连接、双份工具发现、双份子进程）。
+ * 缓存 Promise 让并发调用共享同一次初始化。
+ */
+let _scopePromise = null;
 /** existsSync 的别名，用于数组 .filter() 场景 */
 const exists = existsSync;
+/**
+ * Skill 目录列表（优先级从高到低）：
+ *   1. 项目/.ai-zen/skills/
+ *   2. 项目/.agents/skills/            ← 业界通用规范
+ *   3. ~/.ai-zen/skills/
+ *   4. ~/.agents/skills/               ← 业界通用规范
+ *
+ * 同时供 Scope 装配与交接服务（读取 `handoff` Skill 正文）使用，避免两处各算一遍。
+ * 只返回**当前真实存在**的目录，不存在的不参与发现。
+ */
+export function listSkillDirs() {
+    return [
+        PROJECT_SKILLS_DIR,
+        PROJECT_AGENTS_SKILLS_DIR,
+        SKILLS_DIR,
+        USER_AGENTS_SKILLS_DIR,
+    ].filter(exists);
+}
 export async function getScope() {
-    if (_scope)
-        return _scope;
+    if (!_scopePromise) {
+        _scopePromise = createScopeOnce().catch((error) => {
+            // 初始化失败不缓存：否则一次瞬时故障会让后续所有发送都拿到同一个已 reject 的 Promise
+            _scopePromise = null;
+            throw error;
+        });
+    }
+    return _scopePromise;
+}
+async function createScopeOnce() {
     const config = await readConfig();
     // MCP 配置合并优先级（从高到低）：
     //   1. 项目/.mcp.json
@@ -30,18 +63,9 @@ export async function getScope() {
         join(AI_ZEN_DIR, "mcp.json"),
         USER_AGENTS_MCP_CONFIG_FILE,
     ].filter(exists);
-    // Skills 目录优先级（从高到低）：
-    //   1. 项目/.ai-zen/skills/
-    //   2. 项目/.agents/skills/            ← 业界通用规范
-    //   3. ~/.ai-zen/skills/
-    //   4. ~/.agents/skills/               ← 业界通用规范
-    const skillsPaths = [
-        PROJECT_SKILLS_DIR,
-        PROJECT_AGENTS_SKILLS_DIR,
-        SKILLS_DIR,
-        USER_AGENTS_SKILLS_DIR,
-    ].filter(exists);
-    _scope = new Scope({
+    // Skills 目录优先级（从高到低）：见 listSkillDirs()
+    const skillsPaths = listSkillDirs();
+    const scope = new Scope({
         config,
         agentsDir: AGENTS_DIR,
     }).use(...allInOne({
@@ -50,8 +74,8 @@ export async function getScope() {
         toolsPaths: [PROJECT_TOOLS_DIR, TOOLS_DIR].filter(exists),
         mcpPaths,
     }));
-    await _scope.init();
-    return _scope;
+    await scope.init();
+    return scope;
 }
 /**
  * 重置 Scope 单例：释放当前 Scope（断开 MCP 连接等），下次 `getScope()` 按磁盘配置重建。
@@ -60,11 +84,13 @@ export async function getScope() {
  * 读取一次，不重建则新配置不生效。`_scope` 是同步置空的，便于并发调用方立刻拿到新实例。
  */
 export async function resetScope() {
-    const scope = _scope;
-    _scope = null;
-    if (!scope)
+    // 同步置空，便于并发调用方立刻拿到新实例；若初始化仍在进行，等它落地后再释放
+    const pending = _scopePromise;
+    _scopePromise = null;
+    if (!pending)
         return;
     try {
+        const scope = await pending;
         await scope.dispose();
     }
     catch {
@@ -75,6 +101,10 @@ export async function createAgent(options) {
     const { messages, agentId } = options;
     const scope = await getScope();
     // 始终从磁盘读取 Agent 定义（含 permissions、工具配置等）
+    //
+    // 中断策略（`abortedMessageStrategy` / `abortedToolRoundStrategy`）**故意不传**：
+    // SDK 的 `createAgent()` 在不传时取 `scope.config`（即 `config.json`），于是配置中心
+    // 改完 `/reload` 一下就是新策略。在这里写死值会盖掉用户的选择。
     const agent = await sdkCreateAgent(scope, agentId || "default");
     // 有历史消息时替换（恢复草稿/已保存对话）。
     // 拷贝而非直接引用：恢复的数组来自草稿/对话存档，直接引用会让后续 append 改写传入数组。

package/dist/agent-creator.js.map

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

package/dist/agent-switch.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 主 Agent 切换 —— `/agent` 的校验与写配置策略（纯逻辑，可单测）
+ *
+ * ## 「主 Agent」是哪一个
+ *
+ * 配置里只有一个主 Agent 概念：**`AppConfig.defaultAgent`**（缺省时 SDK 取
+ * `~/.ai-zen/agents/` 下的第一个）。`/agent` 就是把用户选中的那个写回这里，
+ * 与 `/config` →「默认 Agent」写的是同一个字段，不存在第二套状态。
+ *
+ * ## 切换前必须能跑起来
+ *
+ * Agent 定义里的 `modelId` 是运行期唯一真相源（`createAgent` 只认它）。所以切换
+ * 前先做完整链路校验：Agent 存在 → 绑定了模型 → 模型还在配置里 → 端点在 → 端点有 Key。
+ * 少任何一环都直接抛错并把原因说清楚，绝不「先切过去再看它崩不崩」——切完是要
+ * 重挂载对话屏的，崩了用户连 `/model` 都敲不进去。
+ *
+ * ## 不动 Agent 定义本身
+ *
+ * 切 Agent 只改「用哪个」，不改「那个 Agent 长什么样」：不写 `modelParams`、
+ * 不碰提示词、不碰权限。要改这些走 `/model`、`/think`、`/config`。
+ */
+import type { AgentDefinition, AppConfig } from "@ai-zen/agents-sdk";
+/** 选择器里的一行：一个可选的主 Agent */
+export interface AgentChoice {
+    id: string;
+    /** 展示名（`name` 缺失时回落 id） */
+    name: string;
+    /** 绑定的模型名（未绑定 / 模型已删时为 undefined） */
+    modelName?: string;
+    /** 是否可切换（模型与端点凭据齐备） */
+    selectable: boolean;
+    /** 不可切换的原因（可切换时为 undefined） */
+    reason?: string;
+}
+/**
+ * 列出全部主 Agent 及其可用性，供 `/agent` 选择器渲染。
+ *
+ * 不可用的也列出来（而不是隐藏）：用户能看到「那个 Agent 为什么切不过去」，
+ * 比列表里凭空少一个更容易排查。
+ */
+export declare function listAgentChoices(config: AppConfig, agents: readonly AgentDefinition[]): AgentChoice[];
+export interface SwitchAgentOptions {
+    config: AppConfig;
+    /** 可选的主 Agent 列表（`~/.ai-zen/agents/*.json` 快照） */
+    agents: readonly AgentDefinition[];
+    /** 目标 Agent id */
+    targetAgentId: string;
+}
+export interface SwitchAgentResult {
+    /** 已写入 `defaultAgent` 的新配置（调用方负责落盘） */
+    config: AppConfig;
+    /** 面向用户的一句话结果 */
+    summary: string;
+}
+/**
+ * 校验目标 Agent 能否切换，并返回「写好 `defaultAgent` 的新配置」。
+ *
+ * 抛错场景：Agent 不存在、未绑定模型、模型不在配置里、端点不存在、端点缺 Key。
+ */
+export declare function switchAgent(options: SwitchAgentOptions): SwitchAgentResult;
+//# sourceMappingURL=agent-switch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-switch.d.ts","sourceRoot":"","sources":["../src/agent-switch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIrE,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,eAAe,EAAE,GACjC,WAAW,EAAE,CAqBf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,MAAM,EAAE,SAAS,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA4B1E"}

package/dist/agent-switch.js

@@ -0,0 +1,83 @@
+/**
+ * 主 Agent 切换 —— `/agent` 的校验与写配置策略（纯逻辑，可单测）
+ *
+ * ## 「主 Agent」是哪一个
+ *
+ * 配置里只有一个主 Agent 概念：**`AppConfig.defaultAgent`**（缺省时 SDK 取
+ * `~/.ai-zen/agents/` 下的第一个）。`/agent` 就是把用户选中的那个写回这里，
+ * 与 `/config` →「默认 Agent」写的是同一个字段，不存在第二套状态。
+ *
+ * ## 切换前必须能跑起来
+ *
+ * Agent 定义里的 `modelId` 是运行期唯一真相源（`createAgent` 只认它）。所以切换
+ * 前先做完整链路校验：Agent 存在 → 绑定了模型 → 模型还在配置里 → 端点在 → 端点有 Key。
+ * 少任何一环都直接抛错并把原因说清楚，绝不「先切过去再看它崩不崩」——切完是要
+ * 重挂载对话屏的，崩了用户连 `/model` 都敲不进去。
+ *
+ * ## 不动 Agent 定义本身
+ *
+ * 切 Agent 只改「用哪个」，不改「那个 Agent 长什么样」：不写 `modelParams`、
+ * 不碰提示词、不碰权限。要改这些走 `/model`、`/think`、`/config`。
+ */
+import { resolveCredential } from "./config-editor.js";
+import { t } from "./i18n/index.js";
+/**
+ * 列出全部主 Agent 及其可用性，供 `/agent` 选择器渲染。
+ *
+ * 不可用的也列出来（而不是隐藏）：用户能看到「那个 Agent 为什么切不过去」，
+ * 比列表里凭空少一个更容易排查。
+ */
+export function listAgentChoices(config, agents) {
+    return agents.map((agent) => {
+        const name = agent.name || agent.id;
+        if (!agent.modelId) {
+            return { id: agent.id, name, selectable: false, reason: t("agentSwitch.err.noModel") };
+        }
+        const credential = resolveCredential(config, agent.modelId);
+        if (!credential) {
+            return { id: agent.id, name, selectable: false, reason: t("agentSwitch.err.modelMissing", { id: agent.modelId }) };
+        }
+        if (!credential.configured) {
+            return {
+                id: agent.id,
+                name,
+                modelName: credential.modelName,
+                selectable: false,
+                reason: t("agentSwitch.err.missingKey", { endpoint: credential.endpointName }),
+            };
+        }
+        return { id: agent.id, name, modelName: credential.modelName, selectable: true };
+    });
+}
+/**
+ * 校验目标 Agent 能否切换，并返回「写好 `defaultAgent` 的新配置」。
+ *
+ * 抛错场景：Agent 不存在、未绑定模型、模型不在配置里、端点不存在、端点缺 Key。
+ */
+export function switchAgent(options) {
+    const { config, agents, targetAgentId } = options;
+    const agent = agents.find((item) => item.id === targetAgentId);
+    if (!agent)
+        throw new Error(t("agentSwitch.err.agentMissing", { id: targetAgentId }));
+    const name = agent.name || agent.id;
+    if (!agent.modelId) {
+        throw new Error(t("agentSwitch.err.agentNoModel", { name }));
+    }
+    const credential = resolveCredential(config, agent.modelId);
+    if (!credential) {
+        throw new Error(t("agentSwitch.err.modelGone", { name, id: agent.modelId }));
+    }
+    if (!credential.configured) {
+        throw new Error(t("agentSwitch.err.noKey", { endpoint: credential.endpointName }));
+    }
+    return {
+        config: { ...config, defaultAgent: agent.id },
+        summary: t("agentSwitch.summary", {
+            name,
+            id: agent.id,
+            model: credential.modelName,
+            modelId: credential.modelId,
+        }),
+    };
+}
+//# sourceMappingURL=agent-switch.js.map

package/dist/agent-switch.js.map

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

package/dist/agents-store.d.ts

@@ -13,7 +13,12 @@ import type { AgentDefinition } from "@ai-zen/agents-sdk";
 export type AgentKind = "agent" | "subagent";
 /** 某个 kind 对应的定义目录 */
 export declare function agentDir(kind: AgentKind): string;
-/** kind 的中文名 */
+/**
+ * kind 的显示名（`Agent` / `Sub-agent`）。
+ *
+ * 刻意**不本地化**：这两个词在配置中心的英文界面与中文界面里是同一个行业惯用写法，
+ * 翻译成「代理 / 子代理」反而难认。真要本地化，应该走 `t()` 而不是在这里硬编码。
+ */
 export declare function agentKindLabel(kind: AgentKind): string;
 /** 「Agent 定义」管理用的仓储：快照 + 写 / 删操作 */
 export interface AgentStore {

package/dist/agents-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-store.d.ts","sourceRoot":"","sources":["../src/agents-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7C,sBAAsB;AACtB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEhD;AAED,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,oBAAoB;AACpB,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAE/E;AAED,wBAAwB;AACxB,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,MAAM,GAAG,SAAS,GACrB,eAAe,GAAG,SAAS,CAG7B;AAED,yBAAyB;AACzB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,UAAU,CAWpG;AAED,2CAA2C;AAC3C,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAI1D"}
+{"version":3,"file":"agents-store.d.ts","sourceRoot":"","sources":["../src/agents-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAA+B,MAAM,oBAAoB,CAAC;AAIvF,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7C,sBAAsB;AACtB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,oBAAoB;AACpB,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAE/E;AAED,wBAAwB;AACxB,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,MAAM,GAAG,SAAS,GACrB,eAAe,GAAG,SAAS,CAG7B;AAED,yBAAyB;AACzB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,UAAU,CAWpG;AAED,2CAA2C;AAC3C,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAiC1D"}

package/dist/agents-store.js

@@ -9,12 +9,18 @@
  * 与「快照 + 写操作」的组装，便于 TUI 与单测共用。
  */
 import { AgentRepository } from "@ai-zen/agents-sdk";
-import { AGENTS_DIR, SUB_AGENTS_DIR } from "./config.js";
+import { AGENTS_DIR, SUB_AGENTS_DIR, readConfig, readReasoningPresets } from "./config.js";
+import { patchOf, presetFor } from "./reasoning-presets.js";
 /** 某个 kind 对应的定义目录 */
 export function agentDir(kind) {
     return kind === "agent" ? AGENTS_DIR : SUB_AGENTS_DIR;
 }
-/** kind 的中文名 */
+/**
+ * kind 的显示名（`Agent` / `Sub-agent`）。
+ *
+ * 刻意**不本地化**：这两个词在配置中心的英文界面与中文界面里是同一个行业惯用写法，
+ * 翻译成「代理 / 子代理」反而难认。真要本地化，应该走 `t()` 而不是在这里硬编码。
+ */
 export function agentKindLabel(kind) {
     return kind === "agent" ? "Agent" : "Sub-agent";
 }
@@ -43,8 +49,44 @@ export function createAgentStore(agents, subAgents) {
 }
 /** 从磁盘读取 Agent / Sub-agent 快照，并附带真实读写能力 */
 export async function readAgentStore() {
-    const agents = await new AgentRepository(AGENTS_DIR).list();
-    const subAgents = await new AgentRepository(SUB_AGENTS_DIR).list();
+    const repoAgents = new AgentRepository(AGENTS_DIR);
+    const repoSubAgents = new AgentRepository(SUB_AGENTS_DIR);
+    const [rawAgents, rawSubAgents] = await Promise.all([repoAgents.list(), repoSubAgents.list()]);
+    // 旧版 `/think` 把档位名写在 `reasoningEffort` 上；现在档位在写入时就展开成参数。
+    // 这里做一次性迁移：能查到策略就展开进 `modelParams`，查不到就只删旧字段。
+    const isLegacy = (def) => "reasoningEffort" in def;
+    const legacy = (defs) => defs.filter(isLegacy);
+    const needsMigration = legacy(rawAgents).length + legacy(rawSubAgents).length > 0;
+    if (!needsMigration)
+        return createAgentStore(rawAgents, rawSubAgents);
+    const [config, presets] = await Promise.all([readConfig(), readReasoningPresets()]);
+    const migrate = async (repo, defs) => {
+        const out = [];
+        for (const def of defs) {
+            if (!isLegacy(def)) {
+                out.push(def);
+                continue;
+            }
+            out.push(await migrateDefinition(repo, def, config, presets));
+        }
+        return out;
+    };
+    const agents = await migrate(repoAgents, rawAgents);
+    const subAgents = await migrate(repoSubAgents, rawSubAgents);
     return createAgentStore(agents, subAgents);
 }
+/** 把旧 `reasoningEffort` 展开成 `modelParams` 并写回（只跑一次：写完旧字段就没了） */
+async function migrateDefinition(repo, def, config, presets) {
+    const { reasoningEffort, ...rest } = def;
+    // 模型只认 Agent 定义自身的 modelId（配置层已无 defaultModel）
+    const modelId = rest.modelId;
+    const model = (config.models ?? []).find((item) => item.id === modelId);
+    const preset = model ? presetFor(model.id, model.reasoningPreset, presets) : undefined;
+    const patch = reasoningEffort ? patchOf(preset, reasoningEffort) : undefined;
+    const next = patch
+        ? { ...rest, modelParams: { ...(rest.modelParams ?? {}), ...patch } }
+        : rest;
+    await repo.write(next);
+    return next;
+}
 //# sourceMappingURL=agents-store.js.map

package/dist/agents-store.js.map

@@ -1 +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"}
+{"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,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAK5D,sBAAsB;AACtB,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,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,UAAU,GAAG,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC;IAC1D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAE/F,yDAAyD;IACzD,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,CAAC,GAAoB,EAAE,EAAE,CACxC,iBAAiB,IAAK,GAA0C,CAAC;IACnE,MAAM,MAAM,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAElF,IAAI,CAAC,cAAc;QAAE,OAAO,gBAAgB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEtE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,KAAK,EACnB,IAAqB,EACrB,IAAuB,EACK,EAAE;QAC9B,MAAM,GAAG,GAAsB,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACd,SAAS;YACX,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,MAAM,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC7D,OAAO,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,gEAAgE;AAChE,KAAK,UAAU,iBAAiB,CAC9B,IAAqB,EACrB,GAAoB,EACpB,MAAiB,EACjB,OAAyB;IAEzB,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,GAAG,GAAqD,CAAC;IAC3F,+CAA+C;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,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,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,IAAI,GAAoB,KAAK;QACjC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE;QACrE,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * 自动迁移的「执行者选择」入口（CLI 层）。
+ *
+ * 背景：SDK 的 `AutoMigratePlugin` 在 `usage.prompt_tokens` 超过阈值时触发迁移，
+ * 但「谁来写交接文档」是产品决策——保真度高的**原 agent 自交接**，还是便宜的**独立摘要**。
+ * SDK 已把该决策抽象为 `resolveMode` 回调，CLI 在这里把它接到「用户三选一」上：
+ * 原 agent 自交接 / 独立摘要 / 跳过本次迁移。
+ *
+ * 边界（保持 SDK 的分工，不重复实现「何时迁移」的语义）：
+ *   - **何时迁移**：`AutoMigratePlugin`（阈值判断 + busy 让行）；
+ *   - **用什么执行者**：本模块的 `resolveMode`；
+ *   - **实际怎么交接**：共享的 `HandoffService`（与 `/migrate`、`/handoff` 同一条链路）。
+ *
+ * 交互约定：
+ *   - 仅在 stdin 与 stdout **均为 TTY**（人类交互终端）时询问；
+ *   - 非交互环境（管道、重定向、e2e 脚本）没有选择通道，直接按 `defaultMode` 迁移，
+ *     不阻塞等待输入、不额外输出，管道语义不变；
+ *   - 选择器默认高亮 `self`（保真），Esc/取消 = 跳过本次迁移，不影响当前对话
+ *     （历史未被剔除）；只要仍处于超限状态，下次发送后还会再问。
+ */
+import { AutoMigratePlugin, type AutoMigrateTriggerInfo, type HandoffMode, type HandoffService } from "@ai-zen/agents-sdk";
+export interface AutoMigrateModeOptions {
+    /** 交接服务实例（与 `/migrate`、`/handoff` 共用同一实例） */
+    service: HandoffService;
+    /** 交接阈值（`tokenThresholds.handoff`）：prompt_tokens 超过它即触发迁移 */
+    handoffTokens: number;
+    /**
+     * 用户的执行者选择（由调用方注入：TUI 用选择器浮层）。
+     * 返回 `null` 表示跳过本次迁移。
+     */
+    choose: (info: AutoMigrateTriggerInfo) => Promise<HandoffMode | null>;
+    /** 非交互环境下的执行者，默认 `self` */
+    defaultMode?: HandoffMode;
+    /** 是否需要向用户确认；默认「stdin 与 stdout 均为 TTY」。可注入，便于单测 */
+    shouldConfirm?: () => boolean;
+    /** 输出信息（如「已跳过本次迁移」）；由调用方注入（TUI 走 Ink notice），默认丢弃 */
+    log?: (text: string) => void;
+}
+/** 默认交互判定：仅当 stdin 与 stdout 均为 TTY 时才具备选择通道 */
+export declare function canPromptUser(): boolean;
+/** 构造带「执行者选择」的自动迁移插件 */
+export declare function createAutoMigratePlugin(options: AutoMigrateModeOptions): AutoMigratePlugin;
+//# sourceMappingURL=auto-migrate-confirm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-migrate-confirm.d.ts","sourceRoot":"","sources":["../src/auto-migrate-confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,OAAO,EAAE,cAAc,CAAC;IACxB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACtE,2BAA2B;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B,qDAAqD;IACrD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAwB;AACxB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,sBAAsB,GAAG,iBAAiB,CA0B1F"}

package/dist/auto-migrate-confirm.js

@@ -0,0 +1,47 @@
+/**
+ * 自动迁移的「执行者选择」入口（CLI 层）。
+ *
+ * 背景：SDK 的 `AutoMigratePlugin` 在 `usage.prompt_tokens` 超过阈值时触发迁移，
+ * 但「谁来写交接文档」是产品决策——保真度高的**原 agent 自交接**，还是便宜的**独立摘要**。
+ * SDK 已把该决策抽象为 `resolveMode` 回调，CLI 在这里把它接到「用户三选一」上：
+ * 原 agent 自交接 / 独立摘要 / 跳过本次迁移。
+ *
+ * 边界（保持 SDK 的分工，不重复实现「何时迁移」的语义）：
+ *   - **何时迁移**：`AutoMigratePlugin`（阈值判断 + busy 让行）；
+ *   - **用什么执行者**：本模块的 `resolveMode`；
+ *   - **实际怎么交接**：共享的 `HandoffService`（与 `/migrate`、`/handoff` 同一条链路）。
+ *
+ * 交互约定：
+ *   - 仅在 stdin 与 stdout **均为 TTY**（人类交互终端）时询问；
+ *   - 非交互环境（管道、重定向、e2e 脚本）没有选择通道，直接按 `defaultMode` 迁移，
+ *     不阻塞等待输入、不额外输出，管道语义不变；
+ *   - 选择器默认高亮 `self`（保真），Esc/取消 = 跳过本次迁移，不影响当前对话
+ *     （历史未被剔除）；只要仍处于超限状态，下次发送后还会再问。
+ */
+import { AutoMigratePlugin, } from "@ai-zen/agents-sdk";
+import { t } from "./i18n/index.js";
+/** 默认交互判定：仅当 stdin 与 stdout 均为 TTY 时才具备选择通道 */
+export function canPromptUser() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+/** 构造带「执行者选择」的自动迁移插件 */
+export function createAutoMigratePlugin(options) {
+    const { service, handoffTokens, choose, defaultMode = "self", shouldConfirm = canPromptUser, log = () => { }, } = options;
+    return new AutoMigratePlugin({
+        service,
+        handoffTokens,
+        resolveMode: async (info) => {
+            // 非交互环境：没有选择通道，按默认执行者迁移（不阻塞、不额外输出）
+            if (!shouldConfirm())
+                return defaultMode;
+            const mode = await choose(info);
+            if (mode == null) {
+                // 合并为单条：notice 通道只保留最新一条，拆成两行会被后者覆盖
+                log(t("migrate.skipped"));
+                return null;
+            }
+            return mode;
+        },
+    });
+}
+//# sourceMappingURL=auto-migrate-confirm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-migrate-confirm.js","sourceRoot":"","sources":["../src/auto-migrate-confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,iBAAiB,GAIlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAoBpC,+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,wBAAwB;AACxB,MAAM,UAAU,uBAAuB,CAAC,OAA+B;IACrE,MAAM,EACJ,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAW,GAAG,MAAM,EACpB,aAAa,GAAG,aAAa,EAC7B,GAAG,GAAG,GAAG,EAAE,GAAE,CAAC,GACf,GAAG,OAAO,CAAC;IAEZ,OAAO,IAAI,iBAAiB,CAAC;QAC3B,OAAO;QACP,aAAa;QACb,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC1B,mCAAmC;YACnC,IAAI,CAAC,aAAa,EAAE;gBAAE,OAAO,WAAW,CAAC;YAEzC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACjB,oCAAoC;gBACpC,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/clipboard.d.ts

@@ -0,0 +1,68 @@
+/** 一张剪贴板图片（已是 base64，未落盘） */
+export interface ClipboardImage {
+    base64: string;
+    mime: string;
+}
+/**
+ * 读取结果三态。
+ *
+ * 为什么要区分「没有」和「太大」：两者都要回退到粘贴文本，但提示不一样 ——
+ * 「剪贴板里没有图片」是正常情况（用户就是想贴文本），「图片太大」是真问题
+ * （用户以为贴上了，其实没有），不提示会让人莫名其妙。
+ */
+export type ClipboardImageResult = {
+    kind: "image";
+    image: ClipboardImage;
+} | {
+    kind: "too-large";
+    bytes: number;
+} | {
+    kind: "none";
+};
+/** 单张粘贴图片上限：与 SDK 默认内联上限（8MB）同量级，留出 base64 膨胀余量 */
+export declare const MAX_CLIPBOARD_IMAGE_BYTES: number;
+/**
+ * 单次粘贴文本上限 256KB。
+ *
+ * 超了**报错而不是截断**：半截代码 / 半截 JSON 粘进对话比不粘更坑（用户会以
+ * 为粘全了，基于残缺内容提问）。需要大段内容时让他存成文件用 `@` 引用。
+ */
+export declare const MAX_CLIPBOARD_TEXT_BYTES: number;
+export interface ClipboardDeps {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    /** 执行命令；不可用（不存在 / 非零退出 / 超时）返回 null，成功返回 stdout 原始字节 */
+    run?: (cmd: string, args: string[]) => Promise<Buffer | null>;
+}
+/**
+ * 解析 osascript 的输出 `«data PNGf89504E47…»`（PNGf 后面全是十六进制）。
+ *
+ * 格式不符（或没有图片时 osascript 直接非零退出）一律返回 null：
+ * 这条路径上「猜」比「放弃」危险得多 —— 猜错就会把半截字节当成图片发出去。
+ */
+export declare function parseAppleScriptPng(stdout: string): Buffer | null;
+/** 读剪贴板里的图片；没有图片时返回 `{ kind: "none" }`（调用方据此回退到文本） */
+export declare function readClipboardImage(deps?: ClipboardDeps): Promise<ClipboardImageResult>;
+/**
+ * 读剪贴板文本的结果。
+ *
+ * 三态分开是因为提示文案各不相同：`unavailable` = 环境缺剪贴板工具，
+ * `too-large` = 真问题（用户以为粘上了其实没有），空文本 = 剪贴板确实空着。
+ */
+export type ClipboardTextResult = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "too-large";
+    bytes: number;
+} | {
+    kind: "unavailable";
+};
+/**
+ * 读剪贴板里的文本。
+ *
+ * 返回 `unavailable` = 压根没有可用的剪贴板工具（区别于「剪贴板是空的」= 空文本），
+ * 两者在提示上要分开：一个是环境缺依赖，一个是用户剪贴板确实空着。
+ */
+export declare function readClipboardText(deps?: ClipboardDeps): Promise<ClipboardTextResult>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AA0BA,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAMnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,wDAAwD;IACxD,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC/D;AAaD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMjE;AA6FD,sDAAsD;AACtD,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAchG;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAe9F"}