@armadra/agent 0.6.0 → 0.6.2

package/dist/i18n/messages/settings.js

@@ -125,6 +125,9 @@ export const en = {
     setDone: (key, value, scope) => `${key} = ${value} (${scope})`,
     unsetDone: (key, value, scope) => `${key} reset (${scope}); now ${value}`,
     stillOverridden: (key, source) => `${key} is still overridden by ${source}; the saved value applies once that is removed`,
+    /** `ama config set` when a higher layer hides the write: first line = what was written. */
+    writtenTo: (key, value, scope) => `${key} = ${value} (written to ${scope})`,
+    overriddenNow: (source, effective) => `Still overridden by ${source} (${effective}); the effective value is ${effective}`,
     slashUsage: "Usage: /config [key=value | key value]",
     errors: {
         unknownKey: (key) => `${key} isn't a /config setting. Run /config to see what's available.`,
@@ -153,6 +156,7 @@ export const en = {
         agents: "agents.<id>: ama config edit",
         hooks: "hooks.json · /hooks",
         auth: "ama auth",
+        modelsEnabled: "/model (Space) · ama models enable / disable",
     },
     cli: {
         usage: `Usage: ama config get <key> [--json]
@@ -289,6 +293,8 @@ export const zh = {
     setDone: (key, value, scope) => `${key} = ${value}（${scope}）`,
     unsetDone: (key, value, scope) => `已恢复 ${key}（${scope}），现为 ${value}`,
     stillOverridden: (key, source) => `${key} 仍被 ${source} 覆盖，撤掉后写入的值才生效`,
+    writtenTo: (key, value, scope) => `${key} = ${value}（已写入${scope}）`,
+    overriddenNow: (source, effective) => `当前仍被 ${source}（${effective}）覆盖，生效值为 ${effective}`,
     slashUsage: "用法：/config [key=value | key value]",
     errors: {
         unknownKey: (key) => `${key} 不是可设置项，用 /config 查看`,
@@ -317,6 +323,7 @@ export const zh = {
         agents: "agents.<id>：ama config edit",
         hooks: "hooks.json · /hooks",
         auth: "ama auth",
+        modelsEnabled: "/model（Space）· ama models enable / disable",
     },
     cli: {
         usage: `用法：ama config get <key> [--json]

package/dist/i18n/messages/subcommands-config.d.ts

@@ -55,6 +55,7 @@ export declare const en: {
         probeHeader: (count: number, order: string, requests: number, extra: number, limit: number) => string;
         unavailable: string;
         probeStopped: (reason: string) => string;
+        cached: (path: string) => string;
     };
 };
 export declare const zh: {
@@ -107,5 +108,6 @@ export declare const zh: {
         probeHeader: (count: number, order: string, requests: number, extra: number, limit: number) => string;
         unavailable: string;
         probeStopped: (reason: string) => string;
+        cached: (path: string) => string;
     };
 };

package/dist/i18n/messages/subcommands-config.js

@@ -64,6 +64,7 @@ export const en = {
             `${extra > 0 ? `; ${extra} more over --limit ${limit} are not probed` : ""}\n`,
         unavailable: "unavailable (all three protocols failed)",
         probeStopped: (reason) => `ama: probing stopped early (${reason})\n`,
+        cached: (path) => `Model list cached at ${path}; /model shows these models\n`,
     },
 };
 export const zh = {
@@ -123,5 +124,6 @@ export const zh = {
             `${extra > 0 ? `；另有 ${extra} 个超出 --limit ${limit}，未探测` : ""}\n`,
         unavailable: "不可用（三种协议均失败）",
         probeStopped: (reason) => `ama: 探测提前停止（${reason}）\n`,
+        cached: (path) => `模型列表已缓存到 ${path}，/model 里会列出这些模型\n`,
     },
 };

package/dist/i18n/messages/subcommands-models.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 消息目录：subcommands 里 `ama models enable | disable | list --enabled`（`modelsEnabled`）。由
+ * messages/subcommands.ts 引用。
+ */
+export declare const en: {
+    modelsEnabled: {
+        badRef: (ref: string) => string;
+        unknownModel: (ref: string) => string;
+        added: (refs: string, path: string) => string;
+        alreadyListed: (refs: string) => string;
+        removed: (refs: string, path: string) => string;
+        notListed: (refs: string) => string;
+        cleared: (path: string) => string;
+        listHeader: (path: string) => string;
+        listUnset: string;
+        notInTable: string;
+        nothing: string;
+    };
+};
+export declare const zh: {
+    modelsEnabled: {
+        badRef: (ref: string) => string;
+        unknownModel: (ref: string) => string;
+        added: (refs: string, path: string) => string;
+        alreadyListed: (refs: string) => string;
+        removed: (refs: string, path: string) => string;
+        notListed: (refs: string) => string;
+        cleared: (path: string) => string;
+        listHeader: (path: string) => string;
+        listUnset: string;
+        notInTable: string;
+        nothing: string;
+    };
+};

package/dist/i18n/messages/subcommands-models.js

@@ -0,0 +1,34 @@
+/**
+ * 消息目录：subcommands 里 `ama models enable | disable | list --enabled`（`modelsEnabled`）。由
+ * messages/subcommands.ts 引用。
+ */
+export const en = {
+    modelsEnabled: {
+        badRef: (ref) => `ama: ${ref} is not provider/model[@channel] or provider/*\n`,
+        unknownModel: (ref) => `ama: warning: ${ref} is not in the model table; written anyway (relays accept any id)\n`,
+        added: (refs, path) => `Added to models.enabled: ${refs} → ${path}\n`,
+        alreadyListed: (refs) => `Already in models.enabled: ${refs}\n`,
+        removed: (refs, path) => `Removed from models.enabled: ${refs} → ${path}\n`,
+        notListed: (refs) => `Not in models.enabled: ${refs}\n`,
+        cleared: (path) => `models.enabled is empty and was removed; /model shows every configured model again → ${path}\n`,
+        listHeader: (path) => `models.enabled (${path}):\n`,
+        listUnset: "models.enabled is not set; /model shows the models of configured providers:\n",
+        notInTable: "not in the model table",
+        nothing: "  (none)\n",
+    },
+};
+export const zh = {
+    modelsEnabled: {
+        badRef: (ref) => `ama: ${ref} 不是 provider/model[@channel] 或 provider/*\n`,
+        unknownModel: (ref) => `ama: 警告：${ref} 不在模型表里，照样写入（中转站接受任意 id）\n`,
+        added: (refs, path) => `已加入 models.enabled：${refs} → ${path}\n`,
+        alreadyListed: (refs) => `已在 models.enabled 里：${refs}\n`,
+        removed: (refs, path) => `已移出 models.enabled：${refs} → ${path}\n`,
+        notListed: (refs) => `不在 models.enabled 里：${refs}\n`,
+        cleared: (path) => `models.enabled 已清空并删除，/model 恢复显示全部已配置的模型 → ${path}\n`,
+        listHeader: (path) => `models.enabled（${path}）：\n`,
+        listUnset: "未设置 models.enabled；/model 显示已配置供应商的模型：\n",
+        notInTable: "不在模型表里",
+        nothing: "  （无）\n",
+    },
+};

package/dist/i18n/messages/subcommands.d.ts

@@ -225,6 +225,19 @@ export declare const en: {
         noHits: (all: boolean) => "No matches\n" | "No matches (only sessions of this directory; --all searches all)\n";
         truncated: (limit: number) => string;
     };
+    modelsEnabled: {
+        badRef: (ref: string) => string;
+        unknownModel: (ref: string) => string;
+        added: (refs: string, path: string) => string;
+        alreadyListed: (refs: string) => string;
+        removed: (refs: string, path: string) => string;
+        notListed: (refs: string) => string;
+        cleared: (path: string) => string;
+        listHeader: (path: string) => string;
+        listUnset: string;
+        notInTable: string;
+        nothing: string;
+    };
     configShow: {
         usage: string;
         unknownAction: (action: string) => string;
@@ -274,6 +287,7 @@ export declare const en: {
         probeHeader: (count: number, order: string, requests: number, extra: number, limit: number) => string;
         unavailable: string;
         probeStopped: (reason: string) => string;
+        cached: (path: string) => string;
     };
 };
 export declare const zh: {
@@ -495,6 +509,19 @@ export declare const zh: {
         noHits: (all: boolean) => "没有命中\n" | "没有命中（只搜了当前目录的会话，--all 搜全部）\n";
         truncated: (limit: number) => string;
     };
+    modelsEnabled: {
+        badRef: (ref: string) => string;
+        unknownModel: (ref: string) => string;
+        added: (refs: string, path: string) => string;
+        alreadyListed: (refs: string) => string;
+        removed: (refs: string, path: string) => string;
+        notListed: (refs: string) => string;
+        cleared: (path: string) => string;
+        listHeader: (path: string) => string;
+        listUnset: string;
+        notInTable: string;
+        nothing: string;
+    };
     configShow: {
         usage: string;
         unknownAction: (action: string) => string;
@@ -544,5 +571,6 @@ export declare const zh: {
         probeHeader: (count: number, order: string, requests: number, extra: number, limit: number) => string;
         unavailable: string;
         probeStopped: (reason: string) => string;
+        cached: (path: string) => string;
     };
 };

package/dist/i18n/messages/subcommands.js

@@ -7,8 +7,10 @@
  */
 import { plural } from "../format.js";
 import * as configShow from "./subcommands-config.js";
+import * as modelsEnabled from "./subcommands-models.js";
 export const en = {
     ...configShow.en,
+    ...modelsEnabled.en,
     /** 多个子命令共用。 */
     common: {
         warning: (text) => `ama: warning: ${text}\n`,
@@ -242,6 +244,7 @@ export const en = {
 };
 export const zh = {
     ...configShow.zh,
+    ...modelsEnabled.zh,
     common: {
         warning: (text) => `ama: 警告：${text}\n`,
         cancelled: "ama: 已取消\n",

package/dist/modes/interactive/commands.d.ts

@@ -15,6 +15,7 @@
  *   直接进子 Agent 视图（W6-A）。钩子没装时回落 commands-core（line 模式同一套文本）。
  */
 import type { AgentSession, RewindDraftText } from "../../agent/types.js";
+import type { ProviderRegistryApi } from "../../ai/types.js";
 import type { SwitchRequest } from "../../cli/compose-session.js";
 import type { Runtime } from "../../cli/runtime.js";
 import type { PermissionMode } from "../../permissions/types.js";
@@ -67,6 +68,8 @@ export interface CommandUi {
     memoryPanel?(args: string): void | Promise<void>;
     /** [W6-C0] 设置面板（W6-S；`/config`，`/config key=value` 直接设一项）。 */
     configPanel?(args: string): void | Promise<void>;
+    /** `/model` 选择器（model-picker.ts：Tab 视图、Space 清单）；没有时回落为 `pick` + `modelItems`。 */
+    pickModel?(providers: ProviderRegistryApi, current: string | undefined): Promise<string | undefined>;
 }
 /**
  * [W6-C0] 面板类命令 → `CommandUi` 钩子。钩子存在就调用并返回 true；不存在返回 false（回落 commands-core）。

package/dist/modes/interactive/commands.js

@@ -156,19 +156,26 @@ async function handlePick(what, ui) {
         case "model": {
             const current = session.state.model;
             const ref = current === undefined ? undefined : `${current.provider}/${current.id}`;
-            const picked = await ui.pick({
-                title: m.modelTitle,
-                items: await modelItems(ui.env === undefined
-                    ? ui.runtime.providers
-                    : hideFakeProvider(ui.runtime.providers, ui.env)),
-                filterable: true,
-                showCount: true,
-                ...(ref !== undefined ? { selected: ref, currentValue: ref } : {}),
-            });
+            const providers = ui.env === undefined
+                ? ui.runtime.providers
+                : hideFakeProvider(ui.runtime.providers, ui.env);
+            const picked = ui.pickModel !== undefined
+                ? await ui.pickModel(providers, ref)
+                : (await ui.pick({
+                    title: m.modelTitle,
+                    items: await modelItems(providers, {
+                        current: ref,
+                        enabled: ui.runtime.config.models?.enabled,
+                        hints: false,
+                    }),
+                    filterable: true,
+                    showCount: true,
+                    ...(ref !== undefined ? { selected: ref, currentValue: ref } : {}),
+                }))?.value;
             if (picked === undefined)
                 return;
-            await session.setModel(picked.value);
-            ui.notice("info", m.modelSet(picked.value));
+            await session.setModel(picked);
+            ui.notice("info", m.modelSet(picked));
             return;
         }
         case "session": {

package/dist/modes/interactive/config-ui.js

@@ -232,7 +232,7 @@ export class ConfigUi {
             items = thinkingItems(true);
         else if (spec.kind === "model")
             items = [
-                ...(await modelItems(hideFakeProvider(this.deps.runtime.providers, this.deps.context.io.env))),
+                ...(await modelItems(hideFakeProvider(this.deps.runtime.providers, this.deps.context.io.env), { current, enabled: this.deps.runtime.config.models?.enabled, hints: false })),
                 { value: "", label: s.defaultChoice },
             ];
         else

package/dist/modes/interactive/interactive-mode.js

@@ -41,6 +41,7 @@ import { configUiFor } from "./config-ui.js";
 import { createKeyDispatch } from "./key-dispatch.js";
 import { MessageView, exitSummaryLines } from "./message-view.js";
 import { openPicker } from "./pickers.js";
+import { modelPickerFor } from "./model-picker.js";
 import { createRewindFlow } from "./rewind-flow.js";
 import { openTraceView } from "./trace-view.js";
 import { StartupHeader } from "./startup-header.js";
@@ -285,6 +286,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
             return next;
         },
         pick: (spec) => openPicker(pickerHost, spec),
+        pickModel: modelPickerFor(pickerHost, runtime, context),
         confirmMode,
         rewind: () => rewind.open(),
         setDraft,

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 {};