@armadra/agent 0.5.1 → 0.6.1

package/dist/modes/interactive/message-view.js

@@ -14,27 +14,28 @@
  *
  * 滚动交给终端回滚：消息区只追加，切换会话时整体清空重画。
  */
+import { msg } from "../../i18n/index.js";
 import { Card, Container, Markdown, Spacer, Text, visibleWidth, wrapTextWithAnsi, } from "../../tui.js";
 import { formatCost, formatTokens } from "./status-bar.js";
 import { notificationSummary } from "./subagent-view.js";
 import { PLAN_APPROVED_PROMPT } from "../../plan/prompts.js";
 /** 退出摘要的时长：不足 1 分钟按秒，否则按分钟。 */
 function sessionDuration(ms) {
-    const seconds = Math.max(0, Math.round(ms / 1000));
-    return seconds < 60 ? `${seconds} 秒` : `${Math.round(seconds / 60)} 分钟`;
+    return msg().interactive.view.message.duration(Math.max(0, Math.round(ms / 1000)));
 }
 /**
  * 退出摘要（§3.14）：`─ 会话 <id> · 时长 · N 回合 · ↑in ↓out · cache x% · $y（重计费 $z）` 与
  * `  恢复：ama --resume <id>`。整体 dim，会话 id 与恢复命令正文色；0 回合只到「回合」；会话没落盘不给恢复行。
  */
 export function exitSummaryLines(stats, elapsedMs, theme) {
+    const m = msg().interactive.view.message;
     const g = theme.glyphs;
     const dim = (s) => theme.fg("dim", s);
     const id = stats.sessionId.slice(0, 8);
     const parts = [
-        dim(`${g.rule} 会话 `) + theme.fg("text", id),
+        dim(m.sessionPrefix(g.rule)) + theme.fg("text", id),
         dim(sessionDuration(elapsedMs)),
-        dim(`${stats.userMessages} 回合`),
+        dim(m.turns(stats.userMessages)),
     ];
     const t = stats.tokens;
     const prompt = t.input + t.cacheRead + t.cacheWrite;
@@ -45,28 +46,23 @@ export function exitSummaryLines(stats, elapsedMs, theme) {
             parts.push(dim(`cache ${Math.round(rate * 100)}%`));
         if (stats.cost !== undefined && stats.cost > 0) {
             const rebill = stats.cache?.reBilledUsd;
-            const extra = rebill !== undefined && rebill > 0 ? `（重计费 ${formatCost(rebill)}）` : "";
+            const extra = rebill !== undefined && rebill > 0 ? m.rebill(formatCost(rebill)) : "";
             parts.push(dim(formatCost(stats.cost) + extra));
         }
     }
     const lines = [parts.join(dim(" · "))];
     if (stats.userMessages > 0 && stats.sessionFile !== undefined) {
-        lines.push(dim("  恢复：") + theme.fg("text", `ama --resume ${id}`));
+        lines.push(dim(m.resume) + theme.fg("text", `ama --resume ${id}`));
     }
     return lines;
 }
 /** 思考块展开时的正文行数上限（`full` 不限）。 */
 export const THINKING_EXPANDED_LINES = 60;
-/** origin → 中文标签（未知 origin 原样显示）。 */
-export const ORIGIN_LABELS = {
-    steer: "插话",
-    followUp: "之后",
-    host: "宿主",
-    task: "子 Agent 通知",
-    plan: "计划",
-};
-/** [W5-U] origin 为 plan 的交接消息（给模型的英文开场）在消息区的说法。 */
-const PLAN_HANDOFF_TEXT = "按批准的计划开始执行";
+/** origin → 界面语言的标签（未知 origin 原样显示）。 */
+export function originLabel(origin) {
+    const labels = msg().interactive.view.message.origin;
+    return labels[origin] ?? origin;
+}
 /** 首行带前缀、续行按 `indent` 缩进的文本（用户消息、排队消息）。 */
 export class PrefixedText {
     prefix;
@@ -135,9 +131,10 @@ class ThinkingView {
         const t = this.theme;
         const g = t.glyphs;
         const style = (s) => t.fg("dim", t.italic(s));
+        const m = msg().interactive.view.message;
         const title = this.streaming
-            ? `${g.thinking} 思考中${g.ellipsis}`
-            : `${g.thinking} 思考 · ${formatTokens(this.tokens)} token`;
+            ? m.thinkingStreaming(g.thinking, g.ellipsis)
+            : m.thinking(g.thinking, formatTokens(this.tokens));
         const lines = [
             style(title) + (this.open && !this.streaming ? "  " + t.fg("dim", g.collapse) : ""),
         ];
@@ -150,7 +147,7 @@ class ThinkingView {
             for (const line of all.slice(0, limit))
                 lines.push("  " + t.fg("muted", t.italic(line)));
             if (all.length > limit) {
-                lines.push("  " + t.fg("dim", `${g.ellipsis} 另 ${all.length - limit} 行`));
+                lines.push("  " + t.fg("dim", m.moreLines(g.ellipsis, all.length - limit)));
             }
         }
         this.cache = { width, lines };
@@ -173,7 +170,11 @@ export function contentText(content) {
     if (typeof content === "string")
         return content;
     return content
-        .map((block) => (block.type === "text" ? block.text : block.type === "image" ? "[图片]" : ""))
+        .map((block) => block.type === "text"
+        ? block.text
+        : block.type === "image"
+            ? msg().interactive.view.message.image
+            : "")
         .join("");
 }
 /** 一条助手消息：按内容块（思考 / 文本）同步子组件；工具调用块由 tool-view 单独显示。 */
@@ -247,14 +248,15 @@ export class AssistantView extends Container {
     finish(message) {
         this.streaming = false;
         const { theme } = this.options;
+        const m = msg().interactive.view.message;
         if (message.stopReason === "error") {
-            this.status.setText(theme.fg("error", `${theme.glyphs.fail} ${message.errorMessage ?? "模型调用失败"}`));
+            this.status.setText(theme.fg("error", `${theme.glyphs.fail} ${message.errorMessage ?? m.modelError}`));
         }
         else if (message.stopReason === "aborted") {
-            this.status.setText(theme.fg("dim", "已中断"));
+            this.status.setText(theme.fg("dim", m.interrupted));
         }
         else if (message.stopReason === "length") {
-            this.status.setText(theme.fg("warning", "输出达到长度上限"));
+            this.status.setText(theme.fg("warning", m.lengthLimit));
         }
         this.update(message);
     }
@@ -285,6 +287,10 @@ export class MessageView extends Container {
     get theme() {
         return this.options.theme;
     }
+    /** [W6-S] `/config` 热应用：之后渲染的块按新选项（共享同一个 options 对象）。 */
+    setOptions(options) {
+        Object.assign(this.options, options);
+    }
     /** 追加一块（与上一块之间空一行；`compact` 不空行）。 */
     add(component) {
         this.push(component, this.options.compact !== true);
@@ -350,12 +356,12 @@ export class MessageView extends Container {
             this.add(new PrefixedText(t.fg("user", t.bold(t.glyphs.prompt)) + " ", text));
             return;
         }
-        const label = ORIGIN_LABELS[origin] ?? origin;
+        const label = originLabel(origin);
         // [W5-U] 后台子 Agent 的 <task-notification> 是给模型的全文，消息区只留一行
         const summary = origin === "task"
             ? notificationSummary(text)
             : origin === "plan" && text === PLAN_APPROVED_PROMPT
-                ? PLAN_HANDOFF_TEXT
+                ? msg().interactive.view.message.planHandoff
                 : undefined;
         if (summary !== undefined) {
             this.add(new PrefixedText(t.fg("dim", t.glyphs.queued) + " " + t.fg("muted", `${label}  `), t.fg("muted", summary)));
@@ -398,23 +404,24 @@ export class MessageView extends Container {
     }
     addHookBlocked(reason) {
         const glyph = this.theme.glyphs.blocked;
-        this.add(new Text(this.theme.fg("warning", `${glyph} Hook 阻止：${reason}`)));
+        this.add(new Text(this.theme.fg("warning", msg().interactive.view.message.hookBlocked(glyph, reason))));
     }
     addRetry(attempt, maxAttempts, delayMs, error) {
         const seconds = Math.max(1, Math.round(delayMs / 1000));
         const glyph = this.theme.glyphs.retry;
-        this.add(new Text(this.theme.fg("warning", `${glyph} 重试 ${attempt}/${maxAttempts}（${seconds}s 后）：${error}`)));
+        this.add(new Text(this.theme.fg("warning", msg().interactive.view.message.retry(glyph, attempt, maxAttempts, seconds, error))));
     }
     /** 退出前追加的会话摘要（留在终端回滚里）。 */
     addExitSummary(lines) {
         this.add(new Text(lines.join("\n")));
     }
     addRetryFailed(error) {
-        this.addNotice("error", `重试失败${error !== undefined ? `：${error}` : ""}`);
+        this.addNotice("error", msg().interactive.view.message.retryFailed(error));
     }
     /** 压缩 / 分支摘要卡（左竖条）：标题 + token 变化（有则显示）+ 摘要前 3 行。 */
     addSummaryCard(summary, options = {}) {
         const t = this.theme;
+        const m = msg().interactive.view.message;
         const lines = summary
             .trim()
             .split("\n")
@@ -422,16 +429,16 @@ export class MessageView extends Container {
         const head = lines.slice(0, 3);
         const body = head.map((l) => t.fg("muted", l));
         if (lines.length > head.length) {
-            body.push(t.fg("dim", `${t.glyphs.ellipsis} 另 ${lines.length - head.length} 行`));
+            body.push(t.fg("dim", m.moreLines(t.glyphs.ellipsis, lines.length - head.length)));
         }
         let subtitle;
         if (options.tokensBefore !== undefined) {
-            const after = options.tokensAfter !== undefined ? ` → ${formatTokens(options.tokensAfter)}` : "";
-            subtitle = `${formatTokens(options.tokensBefore)}${after} token`;
+            const after = options.tokensAfter !== undefined ? formatTokens(options.tokensAfter) : undefined;
+            subtitle = m.summaryTokens(formatTokens(options.tokensBefore), after);
         }
         this.add(new Card(new Text(body.join("\n")), {
             theme: t,
-            title: options.title ?? "上下文已压缩",
+            title: options.title ?? m.compacted,
             ...(subtitle !== undefined ? { subtitle } : {}),
         }));
     }
@@ -471,7 +478,9 @@ export class MessageView extends Container {
                     this.addSummaryCard(message.summary, { tokensBefore: message.tokensBefore });
                     break;
                 case "branchSummary":
-                    this.addSummaryCard(message.summary, { title: "分支摘要" });
+                    this.addSummaryCard(message.summary, {
+                        title: msg().interactive.view.message.branchSummary,
+                    });
                     break;
                 case "custom":
                     if (message.display)

package/dist/modes/interactive/model-items.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 模型选择器的列表项（`/model`、启动选择器、`/config` 的模型项共用）。
+ *
+ * - 缺省视图「已配置」：只列有 key、OAuth 已登录或本地的供应商；设置了 `models.enabled` 时只列清单内的
+ *   （`provider/*` 整个供应商）。「全部」视图（`/model` 里 Tab）另列没配置的供应商，组标题标「未配置 key」。
+ * - 当前会话的模型不在视图里时置顶一行，组标题「当前」。
+ * - 多渠道供应商每个模型一行（首选渠道），说明里列出其它渠道；`channels`（筛选文本含 `@`）时再列出
+ *   `model@渠道` 行。清单里逐字写了 `provider/model@渠道` 的渠道行总是列出。
+ * - 模型表为空的供应商（ChatGPT 订阅，未缓存发现结果）给一行提示（value 以 `HINT_PREFIX` 开头，不是模型）。
+ *
+ * 先 `loadModelCatalog`（解析 key，异步）再 `catalogItems`（同步）：选择器切视图、改清单时不必重查 key。
+ */
+import type { Model, ProviderData, ProviderRegistryApi } from "../../ai/types.js";
+import { type ProviderAccess } from "../../ai/providers/model-visibility.js";
+import type { SelectItem } from "../../tui.js";
+/** 提示行的 value 前缀（`ama:hint:<供应商>`）；选中时不是模型。 */
+export declare const HINT_PREFIX = "ama:hint:";
+export declare function isHintValue(value: string): boolean;
+export interface CatalogProvider {
+    provider: ProviderData;
+    access: ProviderAccess;
+}
+export interface ModelCatalog {
+    providers: readonly CatalogProvider[];
+}
+export interface ModelItemOptions {
+    /** `configured`（缺省）或 `all`。 */
+    view?: "configured" | "all";
+    /** `models.enabled`；undefined / 空表示不限。 */
+    enabled?: readonly string[] | undefined;
+    /** 当前模型 `provider/model[@channel]`。 */
+    current?: string | undefined;
+    /** 列出 `model@渠道` 行。 */
+    channels?: boolean;
+    /** 列提示行（缺省 true；启动选择器与 `/config` 关掉）。 */
+    hints?: boolean;
+}
+/** 选择器里模型的说明：名称（与 id 不同时）、上下文、`img`（收图片）。 */
+export declare function modelDescription(model: Model): string | undefined;
+export declare function loadModelCatalog(registry: ProviderRegistryApi): Promise<ModelCatalog>;
+export declare function accessLabel(access: ProviderAccess): string;
+/** 目录 → 列表项（规则见文件头）。 */
+export declare function catalogItems(catalog: ModelCatalog, options?: ModelItemOptions): SelectItem[];
+/** 一步到位：解析 key 再生成列表项。 */
+export declare function modelItems(registry: ProviderRegistryApi, options?: ModelItemOptions): Promise<SelectItem[]>;

package/dist/modes/interactive/model-items.js

@@ -0,0 +1,134 @@
+/**
+ * 模型选择器的列表项（`/model`、启动选择器、`/config` 的模型项共用）。
+ *
+ * - 缺省视图「已配置」：只列有 key、OAuth 已登录或本地的供应商；设置了 `models.enabled` 时只列清单内的
+ *   （`provider/*` 整个供应商）。「全部」视图（`/model` 里 Tab）另列没配置的供应商，组标题标「未配置 key」。
+ * - 当前会话的模型不在视图里时置顶一行，组标题「当前」。
+ * - 多渠道供应商每个模型一行（首选渠道），说明里列出其它渠道；`channels`（筛选文本含 `@`）时再列出
+ *   `model@渠道` 行。清单里逐字写了 `provider/model@渠道` 的渠道行总是列出。
+ * - 模型表为空的供应商（ChatGPT 订阅，未缓存发现结果）给一行提示（value 以 `HINT_PREFIX` 开头，不是模型）。
+ *
+ * 先 `loadModelCatalog`（解析 key，异步）再 `catalogItems`（同步）：选择器切视图、改清单时不必重查 key。
+ */
+import { accessReady, enabledMatch, providerAccess, } from "../../ai/providers/model-visibility.js";
+import { CHATGPT_PROVIDER_ID } from "../../auth/chatgpt/presets.js";
+import { msg } from "../../i18n/index.js";
+/** 提示行的 value 前缀（`ama:hint:<供应商>`）；选中时不是模型。 */
+export const HINT_PREFIX = "ama:hint:";
+export function isHintValue(value) {
+    return value.startsWith(HINT_PREFIX);
+}
+/** 选择器里模型的说明：名称（与 id 不同时）、上下文、`img`（收图片）。 */
+export function modelDescription(model) {
+    const ctx = model.contextWindow;
+    const parts = [
+        model.name !== "" && model.name !== model.id ? model.name : undefined,
+        ctx === undefined
+            ? undefined
+            : ctx >= 1_000_000
+                ? `${Math.round(ctx / 100_000) / 10}M`
+                : `${Math.round(ctx / 1000)}k`,
+        model.input.includes("image") ? "img" : undefined,
+    ].filter((x) => x !== undefined);
+    return parts.length > 0 ? parts.join(" · ") : undefined;
+}
+export async function loadModelCatalog(registry) {
+    const providers = [];
+    for (const provider of registry.list())
+        providers.push({ provider, access: await providerAccess(registry, provider) });
+    return { providers };
+}
+export function accessLabel(access) {
+    const m = msg().panels.model;
+    return access === "none" ? m.noKey : m[access];
+}
+/** 模型的其它渠道（首选渠道之外）。 */
+function otherChannels(model) {
+    return (model.channels ?? []).filter((c) => c !== "" && c !== model.channel);
+}
+function row(model, group, channel) {
+    const suffix = channel === undefined ? "" : `@${channel}`;
+    const item = {
+        value: `${model.provider}/${model.id}${suffix}`,
+        label: `${model.id}${suffix}`,
+        group,
+    };
+    const others = channel === undefined ? otherChannels(model) : [];
+    const parts = [
+        modelDescription(model),
+        others.length > 0
+            ? msg().panels.model.otherChannels(others.map((c) => `@${c}`).join(" "))
+            : undefined,
+    ].filter((x) => x !== undefined);
+    if (parts.length > 0)
+        item.description = parts.join(" · ");
+    return item;
+}
+function hintRow(entry, group) {
+    const { provider, access } = entry;
+    if (provider.models.length > 0 || !provider.requiresApiKey)
+        return undefined;
+    const m = msg().panels.model;
+    if (access === "key" || access === "oauth")
+        return { value: `${HINT_PREFIX}${provider.id}`, label: m.discoverHint(provider.id), group };
+    if (provider.id === CHATGPT_PROVIDER_ID)
+        return { value: `${HINT_PREFIX}${provider.id}`, label: m.loginHint(provider.id), group };
+    return undefined;
+}
+/** 目录 → 列表项（规则见文件头）。 */
+export function catalogItems(catalog, options = {}) {
+    const all = options.view === "all";
+    const list = options.enabled !== undefined && options.enabled.length > 0 ? options.enabled : undefined;
+    const ready = [];
+    const rest = [];
+    for (const entry of catalog.providers) {
+        const { provider, access } = entry;
+        const isReady = accessReady(access);
+        const group = `${provider.id} · ${accessLabel(access)}`;
+        const items = [];
+        const listedProvider = list?.includes(`${provider.id}/*`) === true;
+        for (const model of provider.models) {
+            const main = row(model, group);
+            const listed = list !== undefined && enabledMatch(list, main.value) !== undefined;
+            const shown = all || (list !== undefined ? listed : isReady);
+            if (shown) {
+                if (all && listed)
+                    main.badge = msg().panels.model.listed;
+                if (all && listed)
+                    main.badgeColor = "dim";
+                items.push(main);
+            }
+            for (const channel of otherChannels(model)) {
+                const extra = row(model, group, channel);
+                const exact = list?.includes(extra.value) === true;
+                if (exact || (shown && options.channels === true))
+                    items.push(extra);
+            }
+        }
+        const hint = options.hints === false ? undefined : hintRow(entry, group);
+        if (hint !== undefined && (all || (list !== undefined ? listedProvider : isReady)))
+            items.push(hint);
+        (isReady ? ready : rest).push(...items);
+    }
+    return pinCurrent(catalog, [...ready, ...rest], options.current);
+}
+/** 当前模型不在列表里时置顶一行。 */
+function pinCurrent(catalog, items, current) {
+    if (current === undefined || current === "" || items.some((i) => i.value === current))
+        return items;
+    const slash = current.indexOf("/");
+    const at = current.lastIndexOf("@");
+    const base = at > slash ? current.slice(0, at) : current;
+    const model = catalog.providers
+        .find((p) => p.provider.id === current.slice(0, slash))
+        ?.provider.models.find((m) => `${m.provider}/${m.id}` === base);
+    const item = { value: current, label: current, group: msg().panels.model.current };
+    const description = model === undefined ? undefined : modelDescription(model);
+    if (description !== undefined)
+        item.description = description;
+    return [item, ...items];
+}
+/** 一步到位：解析 key 再生成列表项。 */
+export async function modelItems(registry, options = {}) {
+    return catalogItems(await loadModelCatalog(registry), options);
+}

package/dist/modes/interactive/model-picker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 交互模式的 `/model` 选择器：居中覆盖层，列表项见 model-items.ts。
+ *
+ * - `Tab` 在「已配置 / 全部」两个视图间切换（过滤文本保留）；全部视图里没配置的供应商标「未配置 key」，
+ *   选中它的模型不切换，选择器底部提示 `ama auth set` / `ama providers add`；
+ * - `Space` 把高亮的模型加入 / 移出用户级 `models.enabled`（经 config/edit.ts 写回）；只经 `provider/*`
+ *   列入的不能单独移出，提示改用 `ama models disable`；
+ * - 筛选文本含 `@` 时列出各模型的 `@渠道` 行；
+ * - 已在用清单时，从全部视图选中清单外的模型会先把它加入清单再切换；
+ * - 提示行（模型表为空的供应商）选中时只在底部显示命令。
+ */
+import type { ProviderRegistryApi } from "../../ai/types.js";
+import type { ModeContext } from "../../cli/deps.js";
+import type { Runtime } from "../../cli/runtime.js";
+import { SelectList, type Component, type Focusable } from "../../tui.js";
+import { type ModelCatalog } from "./model-items.js";
+import type { PickerHost } from "./pickers.js";
+export interface ModelPickerOptions {
+    title: string;
+    providers: ProviderRegistryApi;
+    /** 当前模型 `provider/model[@channel]`。 */
+    current?: string | undefined;
+    /** 打开时的 `models.enabled`。 */
+    enabled?: readonly string[] | undefined;
+    /** 写回用户级 `models.enabled`（undefined 删除该键）；抛错时错误显示在选择器底部。 */
+    saveEnabled(next: string[] | undefined): void;
+}
+type View = "configured" | "all";
+/** 选择器本体（可单独测试）：`done` 收到选中的模型引用或 undefined（取消）。 */
+export declare class ModelPickerView implements Component, Focusable {
+    private readonly host;
+    private readonly catalog;
+    private readonly options;
+    private readonly done;
+    private view;
+    private enabled;
+    private notice;
+    private channels;
+    readonly list: SelectList;
+    constructor(host: PickerHost, catalog: ModelCatalog, options: ModelPickerOptions, done: (ref: string | undefined) => void);
+    get focused(): boolean;
+    set focused(value: boolean);
+    get currentView(): View;
+    private rebuild;
+    handleInput(data: string): void;
+    private providerOf;
+    private save;
+    private toggle;
+    private select;
+    render(width: number): string[];
+    invalidate(): void;
+}
+/** 打开 `/model` 选择器；返回选中的模型引用，取消返回 undefined。 */
+export declare function openModelPicker(host: PickerHost, options: ModelPickerOptions): Promise<string | undefined>;
+/** 交互模式装配：清单读 `runtime.config`，写用户级 config.json 并换上新配置。 */
+export declare function modelPickerFor(host: PickerHost, runtime: Runtime, context: ModeContext): (providers: ProviderRegistryApi, current: string | undefined) => Promise<string | undefined>;
+export {};

package/dist/modes/interactive/model-picker.js

@@ -0,0 +1,191 @@
+/**
+ * 交互模式的 `/model` 选择器：居中覆盖层，列表项见 model-items.ts。
+ *
+ * - `Tab` 在「已配置 / 全部」两个视图间切换（过滤文本保留）；全部视图里没配置的供应商标「未配置 key」，
+ *   选中它的模型不切换，选择器底部提示 `ama auth set` / `ama providers add`；
+ * - `Space` 把高亮的模型加入 / 移出用户级 `models.enabled`（经 config/edit.ts 写回）；只经 `provider/*`
+ *   列入的不能单独移出，提示改用 `ama models disable`；
+ * - 筛选文本含 `@` 时列出各模型的 `@渠道` 行；
+ * - 已在用清单时，从全部视图选中清单外的模型会先把它加入清单再切换；
+ * - 提示行（模型表为空的供应商）选中时只在底部显示命令。
+ */
+import { accessReady, addEnabled, enabledList, enabledMatch, removeEnabled, } from "../../ai/providers/model-visibility.js";
+import { setConfigValue } from "../../config/edit.js";
+import { msg } from "../../i18n/index.js";
+import { Box, SelectList, matchesKey, wrapTextWithAnsi, } from "../../tui.js";
+import { layerInputFor } from "./config-ui.js";
+import { catalogItems, isHintValue, loadModelCatalog } from "./model-items.js";
+/** 选择器本体（可单独测试）：`done` 收到选中的模型引用或 undefined（取消）。 */
+export class ModelPickerView {
+    host;
+    catalog;
+    options;
+    done;
+    view = "configured";
+    enabled;
+    notice;
+    channels = false;
+    list;
+    constructor(host, catalog, options, done) {
+        this.host = host;
+        this.catalog = catalog;
+        this.options = options;
+        this.done = done;
+        this.enabled = enabledList(options.enabled);
+        this.list = new SelectList([], {
+            theme: host.theme,
+            maxVisible: 12,
+            filterable: true,
+            showCount: true,
+            ...(host.keybindings !== undefined ? { keybindings: host.keybindings } : {}),
+            ...(options.current !== undefined ? { currentValue: options.current } : {}),
+            emptyText: msg().panels.model.emptyConfigured,
+            onSelect: (item) => this.select(item),
+            onCancel: () => this.done(undefined),
+        });
+        this.rebuild();
+        if (options.current !== undefined)
+            this.list.selectValue(options.current);
+    }
+    get focused() {
+        return this.list.focused;
+    }
+    set focused(value) {
+        this.list.focused = value;
+    }
+    get currentView() {
+        return this.view;
+    }
+    rebuild() {
+        const m = msg().panels.model;
+        this.list.setFooter(this.view === "all" ? m.footerAll : m.footerConfigured);
+        this.list.setItems(catalogItems(this.catalog, {
+            view: this.view,
+            enabled: this.enabled,
+            current: this.options.current,
+            channels: this.channels,
+        }));
+    }
+    handleInput(data) {
+        if (matchesKey(data, "tab")) {
+            this.view = this.view === "all" ? "configured" : "all";
+            this.notice = undefined;
+            this.rebuild();
+            return;
+        }
+        if (data === " ") {
+            this.toggle();
+            return;
+        }
+        this.list.handleInput(data);
+        const channels = this.list.getFilter().includes("@");
+        if (channels !== this.channels) {
+            this.channels = channels;
+            this.rebuild();
+        }
+    }
+    providerOf(value) {
+        const id = value.slice(0, value.indexOf("/"));
+        return this.catalog.providers.find((p) => p.provider.id === id);
+    }
+    save(next) {
+        try {
+            this.options.saveEnabled(next);
+            this.enabled = next;
+            return true;
+        }
+        catch (error) {
+            this.notice = {
+                text: error instanceof Error ? error.message : String(error),
+                level: "error",
+            };
+            return false;
+        }
+    }
+    toggle() {
+        const item = this.list.getSelected();
+        if (item === undefined || isHintValue(item.value))
+            return;
+        const m = msg().panels.model;
+        const ref = item.value;
+        const match = this.enabled === undefined ? undefined : enabledMatch(this.enabled, ref);
+        if (match?.kind === "wildcard") {
+            this.notice = { text: m.wildcard(ref, match.pattern), level: "warning" };
+        }
+        else if (match !== undefined) {
+            if (this.save(removeEnabled(this.enabled, [ref])))
+                this.notice = { text: m.removed(ref), level: "info" };
+        }
+        else {
+            const first = this.enabled === undefined;
+            if (this.save(addEnabled(this.enabled, [ref])))
+                this.notice = { text: first ? m.addedFirst(ref) : m.added(ref), level: "info" };
+        }
+        this.rebuild();
+    }
+    select(item) {
+        const m = msg().panels.model;
+        const id = item.value.slice(0, item.value.indexOf("/"));
+        if (isHintValue(item.value)) {
+            this.notice = { text: item.label, level: "info" };
+            return;
+        }
+        const entry = this.providerOf(item.value);
+        if (item.value !== this.options.current && entry !== undefined && !accessReady(entry.access)) {
+            const text = entry.access === "needsLogin" ? m.needsLoginHint(id) : m.noKeyHint(id);
+            this.notice = { text, level: "warning" };
+            return;
+        }
+        if (this.enabled !== undefined &&
+            item.value !== this.options.current &&
+            enabledMatch(this.enabled, item.value) === undefined &&
+            !this.save(addEnabled(this.enabled, [item.value])))
+            return;
+        this.done(item.value);
+    }
+    render(width) {
+        const lines = this.list.render(width);
+        if (this.notice === undefined)
+            return lines;
+        const theme = this.host.theme;
+        const color = this.notice.level === "info" ? "dim" : this.notice.level;
+        return [...lines, ...wrapTextWithAnsi(theme.fg(color, this.notice.text), width)];
+    }
+    invalidate() {
+        this.list.invalidate();
+    }
+}
+/** 打开 `/model` 选择器；返回选中的模型引用，取消返回 undefined。 */
+export async function openModelPicker(host, options) {
+    const catalog = await loadModelCatalog(options.providers);
+    return new Promise((resolve) => {
+        let handle;
+        const view = new ModelPickerView(host, catalog, options, (ref) => {
+            handle?.hide();
+            resolve(ref);
+        });
+        const width = Math.max(20, Math.min(host.columns() - 2, 72));
+        handle = host.showOverlay(new Box(view, { title: options.title, theme: host.theme }), {
+            anchor: "center",
+            width,
+        });
+    });
+}
+/** 交互模式装配：清单读 `runtime.config`，写用户级 config.json 并换上新配置。 */
+export function modelPickerFor(host, runtime, context) {
+    return (providers, current) => openModelPicker(host, {
+        title: msg().interactive.commands.modelTitle,
+        providers,
+        current,
+        enabled: runtime.config.models?.enabled,
+        saveEnabled: (next) => {
+            const result = setConfigValue({
+                ...layerInputFor(runtime, context),
+                scope: "user",
+                key: "models.enabled",
+                value: next,
+            });
+            runtime.replaceConfig?.(result.snapshot.config);
+        },
+    });
+}