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

package/dist/tui/token-rate.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 生成过程的 token 速率统计 —— 纯逻辑，不依赖 React / Ink / SDK
+ *
+ * 需求是「每秒接收多少 token」，而 SDK 只在**每个请求的最后一个 chunk** 才给出
+ * `usage`（`stream_options.include_usage`），拿不到逐 token 的用量。所以这里分两路：
+ *
+ *   - **实时速率**：按增量字符估算 token，用 2 秒滑动窗口算（`live`）。它必须靠估算，
+ *     否则要等一整轮结束才有数字，就谈不上「实时」；
+ *   - **本轮平均**：一轮结束时优先用真实 `completion_tokens`（累加多轮工具调用），
+ *     除以「首字 → 末字」的时间跨度（`average`）。这段时间不含开头的等待首字。
+ *
+ * 两者口径不同，展示上也分开（生成中显示实时，结束后显示本轮平均）——把估算值
+ * 和精确值混成一个数字才是真的误导。
+ */
+/** 实时速率的滑动窗口：取值越小越「跳」，越大越迟钝 */
+export declare const LIVE_WINDOW_MS = 2000;
+/** 计算速率的最小时间跨度：太短会把「首包爆发」放大成离谱的高速率 */
+export declare const MIN_SPAN_MS = 400;
+/**
+ * 按字符估算 token 数（浮点，调用方决定何时取整）。
+ *
+ * 权重取值依据：中文/全角约 0.7 token 一个字（DeepSeek / GLM 系分词器实测区间
+ * 0.6~0.8），其余非空白字符约 0.25（≈4 字符一个 token），空白约 0.1（多半与前词
+ * 合并，但不为零）。这是**估算**，用于实时速率；精确值一律以 `usage` 为准。
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * 从流式 chunk 里取出「本次新增的输出文本」：正文 + 思考 + 工具参数。
+ *
+ * 三者都是模型实打实吐出来的 token，只统计正文会低估（尤其推理模型的思考段）。
+ */
+export declare function deltaText(chunk: any): string;
+/** 一次快照：生成中看 `live`，结束后看 `average` */
+export interface RateSample {
+    /** 实时速率（token/秒，最近窗口估算）；无数据时为 null */
+    live: number | null;
+    /** 本轮平均速率（token/秒，优先真实 usage）；一轮未结束时为 null */
+    average: number | null;
+    /** 本轮是否仍在生成 */
+    running: boolean;
+}
+/** 无数据的快照（状态栏据此不显示速率段） */
+export declare const IDLE_RATE: RateSample;
+/**
+ * 速率统计器。
+ *
+ * 生命周期由调用方驱动：`begin()`（一轮开始）→ 若干个 `addDelta()` / `addExact()`
+ * → `finish()`（一轮结束）。时间一律可注入，便于单测不依赖真实时钟。
+ */
+export declare class TokenRateMeter {
+    private samples;
+    /** 估算的累计输出 token */
+    private estimated;
+    /** 真实 `completion_tokens` 累加（多轮工具调用逐轮相加） */
+    private exact;
+    private startedAt;
+    private firstOutputAt;
+    private lastOutputAt;
+    private finished;
+    private averageValue;
+    /** 一轮开始：清空上一轮的所有状态 */
+    begin(now?: number): void;
+    /** 收到一段增量文本：累加估算 token 并打点 */
+    addDelta(text: string, now?: number): void;
+    /** 收到真实用量（流末 chunk 的 `usage.completion_tokens`），多轮累加 */
+    addExact(completionTokens: number | undefined | null): void;
+    /**
+     * 一轮结束：算本轮平均速率。
+     *
+     * 分子优先用真实 `completion_tokens`；分母是「首字 → 末字」的跨度，即真正在接收
+     * 内容的那段时间 —— 不含开头的排队等首字，也避免把整轮的思考停顿算成慢。
+     */
+    finish(now?: number): void;
+    /** 当前快照（供状态栏直接渲染） */
+    snapshot(now?: number): RateSample;
+    /** 清空（退出 / 重建会话时调用） */
+    reset(): void;
+    /** 最近窗口的估算速率；窗口内没动静时返回 0（停顿本来就该显示 0，而不是上一秒的高值） */
+    private liveRate;
+    /** 丢掉窗口外的采样（保留一个窗口起点之前的锚点，用于算基准值） */
+    private trim;
+}
+//# sourceMappingURL=token-rate.d.ts.map

package/dist/tui/token-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-rate.d.ts","sourceRoot":"","sources":["../../src/tui/token-rate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,+BAA+B;AAC/B,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,sCAAsC;AACtC,eAAO,MAAM,WAAW,MAAM,CAAC;AAK/B;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAqB5C;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,0BAA0B;AAC1B,eAAO,MAAM,SAAS,EAAE,UAA0D,CAAC;AASnF;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,oBAAoB;IACpB,OAAO,CAAC,SAAS,CAAK;IACtB,4CAA4C;IAC5C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAuB;IAE3C,sBAAsB;IACtB,KAAK,CAAC,GAAG,GAAE,MAAmB,GAAG,IAAI,CASpC;IAED,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CASrD;IAED,wDAAwD;IACxD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAI1D;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG,GAAE,MAAmB,GAAG,IAAI,CAWrC;IAED,qBAAqB;IACrB,QAAQ,CAAC,GAAG,GAAE,MAAmB,GAAG,UAAU,CAI7C;IAED,uBAAuB;IACvB,KAAK,IAAI,IAAI,CASZ;IAED,kDAAkD;IAClD,OAAO,CAAC,QAAQ;IAkBhB,qCAAqC;IACrC,OAAO,CAAC,IAAI;CASb"}

package/dist/tui/token-rate.js

@@ -0,0 +1,195 @@
+/**
+ * 生成过程的 token 速率统计 —— 纯逻辑，不依赖 React / Ink / SDK
+ *
+ * 需求是「每秒接收多少 token」，而 SDK 只在**每个请求的最后一个 chunk** 才给出
+ * `usage`（`stream_options.include_usage`），拿不到逐 token 的用量。所以这里分两路：
+ *
+ *   - **实时速率**：按增量字符估算 token，用 2 秒滑动窗口算（`live`）。它必须靠估算，
+ *     否则要等一整轮结束才有数字，就谈不上「实时」；
+ *   - **本轮平均**：一轮结束时优先用真实 `completion_tokens`（累加多轮工具调用），
+ *     除以「首字 → 末字」的时间跨度（`average`）。这段时间不含开头的等待首字。
+ *
+ * 两者口径不同，展示上也分开（生成中显示实时，结束后显示本轮平均）——把估算值
+ * 和精确值混成一个数字才是真的误导。
+ */
+/** 实时速率的滑动窗口：取值越小越「跳」，越大越迟钝 */
+export const LIVE_WINDOW_MS = 2000;
+/** 计算速率的最小时间跨度：太短会把「首包爆发」放大成离谱的高速率 */
+export const MIN_SPAN_MS = 400;
+/** 全角 / CJK 字符范围（这些字符在主流分词器里约占 0.7 个 token） */
+const CJK = /[\u2e80-\u9fff\u3000-\u303f\uff00-\uffef\uac00-\ud7af]/;
+/**
+ * 按字符估算 token 数（浮点，调用方决定何时取整）。
+ *
+ * 权重取值依据：中文/全角约 0.7 token 一个字（DeepSeek / GLM 系分词器实测区间
+ * 0.6~0.8），其余非空白字符约 0.25（≈4 字符一个 token），空白约 0.1（多半与前词
+ * 合并，但不为零）。这是**估算**，用于实时速率；精确值一律以 `usage` 为准。
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    let tokens = 0;
+    for (const char of text) {
+        if (/\s/.test(char))
+            tokens += 0.1;
+        else
+            tokens += CJK.test(char) ? 0.7 : 0.25;
+    }
+    return tokens;
+}
+/**
+ * 从流式 chunk 里取出「本次新增的输出文本」：正文 + 思考 + 工具参数。
+ *
+ * 三者都是模型实打实吐出来的 token，只统计正文会低估（尤其推理模型的思考段）。
+ */
+export function deltaText(chunk) {
+    const delta = chunk?.choices?.[0]?.delta;
+    if (!delta)
+        return "";
+    let text = "";
+    const content = delta.content;
+    if (typeof content === "string") {
+        text += content;
+    }
+    else if (Array.isArray(content)) {
+        for (const section of content) {
+            if (section && typeof section.text === "string")
+                text += section.text;
+        }
+    }
+    if (typeof delta.reasoning_content === "string")
+        text += delta.reasoning_content;
+    if (Array.isArray(delta.tool_calls)) {
+        for (const call of delta.tool_calls) {
+            if (typeof call?.function?.name === "string")
+                text += call.function.name;
+            if (typeof call?.function?.arguments === "string")
+                text += call.function.arguments;
+        }
+    }
+    return text;
+}
+/** 无数据的快照（状态栏据此不显示速率段） */
+export const IDLE_RATE = { live: null, average: null, running: false };
+/**
+ * 速率统计器。
+ *
+ * 生命周期由调用方驱动：`begin()`（一轮开始）→ 若干个 `addDelta()` / `addExact()`
+ * → `finish()`（一轮结束）。时间一律可注入，便于单测不依赖真实时钟。
+ */
+export class TokenRateMeter {
+    samples = [];
+    /** 估算的累计输出 token */
+    estimated = 0;
+    /** 真实 `completion_tokens` 累加（多轮工具调用逐轮相加） */
+    exact = 0;
+    startedAt = null;
+    firstOutputAt = null;
+    lastOutputAt = null;
+    finished = false;
+    averageValue = null;
+    /** 一轮开始：清空上一轮的所有状态 */
+    begin(now = Date.now()) {
+        this.samples = [];
+        this.estimated = 0;
+        this.exact = 0;
+        this.startedAt = now;
+        this.firstOutputAt = null;
+        this.lastOutputAt = null;
+        this.finished = false;
+        this.averageValue = null;
+    }
+    /** 收到一段增量文本：累加估算 token 并打点 */
+    addDelta(text, now = Date.now()) {
+        const tokens = estimateTokens(text);
+        if (tokens <= 0)
+            return;
+        if (this.startedAt == null)
+            this.begin(now);
+        this.estimated += tokens;
+        this.firstOutputAt ??= now;
+        this.lastOutputAt = now;
+        this.samples.push({ t: now, tokens: this.estimated });
+        this.trim(now);
+    }
+    /** 收到真实用量（流末 chunk 的 `usage.completion_tokens`），多轮累加 */
+    addExact(completionTokens) {
+        if (typeof completionTokens !== "number" || !Number.isFinite(completionTokens))
+            return;
+        if (completionTokens <= 0)
+            return;
+        this.exact += completionTokens;
+    }
+    /**
+     * 一轮结束：算本轮平均速率。
+     *
+     * 分子优先用真实 `completion_tokens`；分母是「首字 → 末字」的跨度，即真正在接收
+     * 内容的那段时间 —— 不含开头的排队等首字，也避免把整轮的思考停顿算成慢。
+     */
+    finish(now = Date.now()) {
+        this.finished = true;
+        const tokens = this.exact > 0 ? this.exact : this.estimated;
+        const from = this.firstOutputAt ?? this.startedAt;
+        const to = this.lastOutputAt ?? now;
+        if (tokens <= 0 || from == null) {
+            this.averageValue = null;
+            return;
+        }
+        const spanMs = to - from;
+        this.averageValue = spanMs >= MIN_SPAN_MS ? tokens / (spanMs / 1000) : null;
+    }
+    /** 当前快照（供状态栏直接渲染） */
+    snapshot(now = Date.now()) {
+        if (this.startedAt == null)
+            return IDLE_RATE;
+        if (this.finished)
+            return { live: null, average: this.averageValue, running: false };
+        return { live: this.liveRate(now), average: null, running: true };
+    }
+    /** 清空（退出 / 重建会话时调用） */
+    reset() {
+        this.samples = [];
+        this.estimated = 0;
+        this.exact = 0;
+        this.startedAt = null;
+        this.firstOutputAt = null;
+        this.lastOutputAt = null;
+        this.finished = false;
+        this.averageValue = null;
+    }
+    /** 最近窗口的估算速率；窗口内没动静时返回 0（停顿本来就该显示 0，而不是上一秒的高值） */
+    liveRate(now) {
+        if (this.samples.length === 0)
+            return null;
+        // 跨度从**首字**算起：把等首字的排队时间算进来会把速率稀释成端到端吞吐，
+        // 首字之后才开始计时间，同时也顺手挡掉了「首包爆发」被放大成离谱高值的问题。
+        const from = this.firstOutputAt ?? this.startedAt;
+        const windowStart = Math.max(from, now - LIVE_WINDOW_MS);
+        const spanMs = now - windowStart;
+        if (spanMs < MIN_SPAN_MS)
+            return null;
+        // 窗口起点对应的累计值：取最后一个不晚于窗口起点的采样
+        let base = 0;
+        for (const sample of this.samples) {
+            if (sample.t <= windowStart)
+                base = sample.tokens;
+            else
+                break;
+        }
+        return Math.max(0, this.estimated - base) / (spanMs / 1000);
+    }
+    /** 丢掉窗口外的采样（保留一个窗口起点之前的锚点，用于算基准值） */
+    trim(now) {
+        const cutoff = now - LIVE_WINDOW_MS;
+        let keepFrom = 0;
+        for (let i = 0; i < this.samples.length; i += 1) {
+            if (this.samples[i].t <= cutoff)
+                keepFrom = i;
+            else
+                break;
+        }
+        if (keepFrom > 0)
+            this.samples = this.samples.slice(keepFrom);
+    }
+}
+//# sourceMappingURL=token-rate.js.map

package/dist/tui/token-rate.js.map

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

package/dist/types.d.ts

@@ -6,18 +6,17 @@
  */
 export type { AppConfig, Endpoint, Model, ImageModel, AgentDefinition, AgentPermissions, McpServerConfig, McpServerManifest, } from "@ai-zen/agents-sdk";
 export type { Conversation } from "./conversation-repository.js";
-import type { SdkAgent, TaskMigrationService } from "@ai-zen/agents-sdk";
+import type { SdkAgent, HandoffService } from "@ai-zen/agents-sdk";
 export interface ConversationContext {
     agent: SdkAgent;
-    input: string;
     currentName: string;
-    modelId: string;
-    currentId: string | undefined;
+    currentId: string;
     agentId: string | undefined;
-    running: boolean;
-    shouldSend?: boolean;
-    /** 迁移服务实例：自动迁移（AutoMigratePlugin）与手动迁移（/migrate 命令）共用同一实例。先建 ctx 再回填（migrate 前必已赋值） */
-    migrationService?: TaskMigrationService;
+    /**
+     * 交接服务实例：自动迁移、`/migrate`、`/handoff` 共用同一实例。
+     * 先建 ctx 再回填（交接前必已赋值）。
+     */
+    handoffService?: HandoffService;
 }
 export type CommandHandler = (ctx: ConversationContext) => Promise<void>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,SAAS,EACT,QAAQ,EACR,KAAK,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,SAAS,EACT,QAAQ,EACR,KAAK,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/user-content.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 「用户输入 + 粘贴的图片」→ 发给 core 的消息内容（`MessageContent`）。
+ *
+ * ## 为什么单独一个文件
+ *
+ * 这里是 `Ctrl+V` 粘贴图片链路的**唯一决策点**：几张图、走 Files API 还是内联、
+ * 模型不支持视觉时怎么办、转换失败要不要放弃 —— 全是纯逻辑（IO 由 SDK 的
+ * `fileToContentSection()` 负责，且可注入），因此可以脱离终端与网络单测。
+ *
+ * ## 三态输出，绝不「假成功」
+ *
+ *   · 一张图都没转成功 → **退回纯文本**（用户至少把话说出去了，不会静默丢消息）；
+ *   · 部分成功 → 发成功的那几张，失败原因进 `warnings`；
+ *   · 传输降级（上传失败转内联、模型不支持视觉转文本提示）→ 照发，SDK 的
+ *     `warning` 透传给通知栏。
+ *
+ * 文本段永远排在**第一个**：`formatHistory()` 原样把内容块发给 API，而多数端点
+ * 对「图在文前」的处理是把提示词放到图片之后，指令容易被图片切断。
+ */
+import type { AgentNS } from "@ai-zen/agents-core";
+import { fileToContentSection } from "@ai-zen/agents-sdk";
+import type { AppConfig } from "@ai-zen/agents-sdk";
+import type { ClipboardImage } from "./clipboard.js";
+export interface BuildUserContentInput {
+    text: string;
+    images?: readonly ClipboardImage[];
+    /** 当前配置（用于按模型反查端点与视觉能力） */
+    config: AppConfig;
+    /** 发给 API 的模型名（core 的 `agent.model`）——`file_id` 是端点维度资源，必须按实发模型定位 */
+    apiModelName?: string;
+    /** 依赖注入（测试用）；默认走 SDK 的统一转换入口 */
+    convert?: typeof fileToContentSection;
+}
+export interface BuildUserContentResult {
+    content: AgentNS.MessageContent;
+    /** 降级 / 失败说明（供通知栏），无问题时为空数组 */
+    warnings: string[];
+}
+/** 粘贴的图片 → 内容块；失败的那张跳过并记一条说明 */
+export declare function buildUserContent(input: BuildUserContentInput): Promise<BuildUserContentResult>;
+//# sourceMappingURL=user-content.d.ts.map

package/dist/user-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-content.d.ts","sourceRoot":"","sources":["../src/user-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA2B,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,2BAA2B;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC;IAChC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAQD,gCAAgC;AAChC,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2BpG"}

package/dist/user-content.js

@@ -0,0 +1,37 @@
+import { fileToContentSection, resolveModelAndEndpoint } from "@ai-zen/agents-sdk";
+/** `image/png` → `png`（文件名后缀，部分端点按扩展名判类型） */
+function extOf(mime) {
+    const slash = mime.indexOf("/");
+    return slash < 0 ? "png" : mime.slice(slash + 1);
+}
+/** 粘贴的图片 → 内容块；失败的那张跳过并记一条说明 */
+export async function buildUserContent(input) {
+    const images = input.images ?? [];
+    if (images.length === 0)
+        return { content: input.text, warnings: [] };
+    const convert = input.convert ?? fileToContentSection;
+    const { model, endpoint } = resolveModelAndEndpoint(input.config, input.apiModelName);
+    const sections = [];
+    const warnings = [];
+    for (const [index, image] of images.entries()) {
+        const source = {
+            base64: image.base64,
+            mime: image.mime,
+            filename: `pasted-${index + 1}.${extOf(image.mime)}`,
+        };
+        try {
+            const result = await convert({ source, endpoint, model });
+            sections.push(result.section);
+            if (result.warning)
+                warnings.push(result.warning);
+        }
+        catch (error) {
+            // 单张失败不影响其他张：体积超内联上限、端点拒绝上传等都在这里收敛
+            warnings.push(error?.message ? String(error.message) : String(error));
+        }
+    }
+    if (sections.length === 0)
+        return { content: input.text, warnings };
+    return { content: [{ type: "text", text: input.text }, ...sections], warnings };
+}
+//# sourceMappingURL=user-content.js.map

package/dist/user-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-content.js","sourceRoot":"","sources":["../src/user-content.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAqBnF,6CAA6C;AAC7C,SAAS,KAAK,CAAC,IAAY;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA4B;IACjE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;IAClC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAEtE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,oBAAoB,CAAC;IACtD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,uBAAuB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAEtF,MAAM,QAAQ,GAAoC,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAe;YACzB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,UAAU,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;SACrD,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,IAAI,MAAM,CAAC,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,mCAAmC;YACnC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;AAClF,CAAC"}

package/dist/version-compare.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 版本号比较 —— 只回答「谁更新」这一个问题。
+ *
+ * 语义照 semver 2.0 的比较规则（`X.Y.Z[-pre][+build]`）：
+ *   - 核心段按数字比，缺省补 0；
+ *   - **有预发布标识的更小**（`1.0.0-alpha.23 < 1.0.0`）；
+ *   - 预发布标识逐个比：纯数字比数值、数字**小于**非数字、非数字按 ASCII 比；
+ *     前缀全相同则标识少的更小（`1.0.0-alpha < 1.0.0-alpha.1`）；
+ *   - 构建元数据（`+xxx`）不参与比较。
+ *
+ * 为什么不引 `semver` 包：CLI 只在这一处比版本号（`/update` 从 registry 的多个
+ * dist-tag 里挑最新的那个），为它多挂一份依赖不划算；而这段规则稳定、可穷举测试。
+ *
+ * 无法解析的版本号一律返回 `null`（调用方跳过），绝不抛错——版本号来自网络，
+ * 不该因为 registry 上有个畸形 tag 就让命令崩掉。
+ */
+export interface ParsedVersion {
+    /** 核心段（数字数组，通常是 3 段） */
+    core: number[];
+    /** 预发布标识（`alpha.23` → `["alpha", "23"]`）；无预发布为空数组 */
+    pre: string[];
+}
+/** 解析版本号；畸形返回 `null` */
+export declare function parseVersion(version: string): ParsedVersion | null;
+/**
+ * 比较两个版本号：`a` 更新返回正数、`b` 更新返回负数、相同返回 0。
+ * 任一方无法解析时返回 `null`。
+ */
+export declare function compareVersions(a: string, b: string): number | null;
+/**
+ * 从一组版本号里挑最新的（忽略无法解析的条目）；全都不合法时返回 `undefined`。
+ *
+ * `/update` 用它把 registry 上**所有** dist-tag 折叠成一个目标版本：只认 `latest`
+ * 会漏掉「alpha 比正式版更新」的实际发布状态，只认 `alpha` 又会在正式版追上后装旧版。
+ */
+export declare function pickNewest(versions: Iterable<string>): string | undefined;
+//# sourceMappingURL=version-compare.d.ts.map

package/dist/version-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.d.ts","sourceRoot":"","sources":["../src/version-compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAID,wBAAwB;AACxB,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgBlE;AAaD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BnE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAOzE"}

package/dist/version-compare.js

@@ -0,0 +1,105 @@
+/**
+ * 版本号比较 —— 只回答「谁更新」这一个问题。
+ *
+ * 语义照 semver 2.0 的比较规则（`X.Y.Z[-pre][+build]`）：
+ *   - 核心段按数字比，缺省补 0；
+ *   - **有预发布标识的更小**（`1.0.0-alpha.23 < 1.0.0`）；
+ *   - 预发布标识逐个比：纯数字比数值、数字**小于**非数字、非数字按 ASCII 比；
+ *     前缀全相同则标识少的更小（`1.0.0-alpha < 1.0.0-alpha.1`）；
+ *   - 构建元数据（`+xxx`）不参与比较。
+ *
+ * 为什么不引 `semver` 包：CLI 只在这一处比版本号（`/update` 从 registry 的多个
+ * dist-tag 里挑最新的那个），为它多挂一份依赖不划算；而这段规则稳定、可穷举测试。
+ *
+ * 无法解析的版本号一律返回 `null`（调用方跳过），绝不抛错——版本号来自网络，
+ * 不该因为 registry 上有个畸形 tag 就让命令崩掉。
+ */
+const NUMERIC = /^\d+$/;
+/** 解析版本号；畸形返回 `null` */
+export function parseVersion(version) {
+    if (typeof version !== "string")
+        return null;
+    // 容忍 `v1.2.3` 写法与首尾空白
+    const trimmed = version.trim().replace(/^v/i, "");
+    if (!trimmed)
+        return null;
+    // 构建元数据不参与比较
+    const plus = trimmed.indexOf("+");
+    const noBuild = plus >= 0 ? trimmed.slice(0, plus) : trimmed;
+    // 预发布段从**第一个** `-` 开始（`1.0.0-alpha-beta` 的预发布标识是 `alpha-beta`）
+    const dash = noBuild.indexOf("-");
+    const coreText = dash >= 0 ? noBuild.slice(0, dash) : noBuild;
+    const preText = dash >= 0 ? noBuild.slice(dash + 1) : "";
+    const parts = coreText.split(".");
+    if (!parts.every((part) => NUMERIC.test(part)))
+        return null;
+    return { core: parts.map(Number), pre: preText ? preText.split(".") : [] };
+}
+/** 单个预发布标识比较：数字按数值，数字 < 非数字，非数字按 ASCII */
+function compareIdentifier(a, b) {
+    const aNumeric = NUMERIC.test(a);
+    const bNumeric = NUMERIC.test(b);
+    if (aNumeric && bNumeric)
+        return Number(a) - Number(b);
+    if (aNumeric)
+        return -1;
+    if (bNumeric)
+        return 1;
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+/**
+ * 比较两个版本号：`a` 更新返回正数、`b` 更新返回负数、相同返回 0。
+ * 任一方无法解析时返回 `null`。
+ */
+export function compareVersions(a, b) {
+    const pa = parseVersion(a);
+    const pb = parseVersion(b);
+    if (!pa || !pb)
+        return null;
+    const coreLength = Math.max(pa.core.length, pb.core.length);
+    for (let i = 0; i < coreLength; i += 1) {
+        const diff = (pa.core[i] ?? 0) - (pb.core[i] ?? 0);
+        if (diff !== 0)
+            return diff > 0 ? 1 : -1;
+    }
+    // 核心段相同：有预发布标识的更小（1.0.0-alpha < 1.0.0）
+    if (pa.pre.length === 0 && pb.pre.length === 0)
+        return 0;
+    if (pa.pre.length === 0)
+        return 1;
+    if (pb.pre.length === 0)
+        return -1;
+    const preLength = Math.max(pa.pre.length, pb.pre.length);
+    for (let i = 0; i < preLength; i += 1) {
+        const left = pa.pre[i];
+        const right = pb.pre[i];
+        // 前缀相同 → 标识少的更小（1.0.0-alpha < 1.0.0-alpha.1）
+        if (left === undefined)
+            return -1;
+        if (right === undefined)
+            return 1;
+        const diff = compareIdentifier(left, right);
+        if (diff !== 0)
+            return diff > 0 ? 1 : -1;
+    }
+    return 0;
+}
+/**
+ * 从一组版本号里挑最新的（忽略无法解析的条目）；全都不合法时返回 `undefined`。
+ *
+ * `/update` 用它把 registry 上**所有** dist-tag 折叠成一个目标版本：只认 `latest`
+ * 会漏掉「alpha 比正式版更新」的实际发布状态，只认 `alpha` 又会在正式版追上后装旧版。
+ */
+export function pickNewest(versions) {
+    let newest;
+    for (const version of versions) {
+        if (!parseVersion(version))
+            continue;
+        if (newest === undefined || (compareVersions(version, newest) ?? 0) > 0)
+            newest = version;
+    }
+    return newest;
+}
+//# sourceMappingURL=version-compare.js.map

package/dist/version-compare.js.map

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

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAM/C,mCAAmC;AACnC,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAY,CAAC;QACrC,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;AAE7D,gCAAgC;AAChC,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC,iCAAiC,CAAC,CAAC;AAE7E,iCAAiC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC,kCAAkC,CAAC,CAAC;AAQ/E,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACpE,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAM/C,mCAAmC;AACnC,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAY,CAAC;QACrC,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;AAE7D,gCAAgC;AAChC,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC,iCAAiC,CAAC,CAAC;AAE7E,iCAAiC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC,kCAAkC,CAAC,CAAC;AAQ/E,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-zen/cli",
-  "version": "1.0.0-alpha.8",
+  "version": "1.0.0",
   "description": "AI-ZEN CLI - dual-mode AI terminal: pure stdio pipelines and an interactive TUI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,14 +21,15 @@
   "author": "LZQCN",
   "license": "MIT",
   "dependencies": {
-    "@ai-zen/agents-core": "^4.5.1",
-    "@ai-zen/agents-sdk": "1.0.0-alpha.9",
+    "@ai-zen/agents-core": "^4.5.4",
+    "@ai-zen/agents-sdk": "1.0.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dayjs": "^1.11.21",
     "highlight.js": "^11.12.0",
     "ink": "^7.1.1",
     "lowlight": "^3.3.0",
     "react": "^19.3.0",
+    "string-width": "^8.3.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
@@ -38,8 +39,9 @@
     "dotenv": "^17.4.2",
     "ink-testing-library": "^4.0.0",
     "rimraf": "^6.0.0",
-    "typescript": "^5.3.3",
-    "vitest": "^4.1.9"
+    "typescript": "^7.0.2",
+    "vite": "^8.3.5",
+    "vitest": "^5.1.0"
   },
   "files": [
     "dist",