@armadra/agent 0.6.0 → 0.6.1

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);
+        },
+    });
+}

package/dist/modes/interactive/startup-ui.d.ts

@@ -5,12 +5,13 @@
  * 选择列表 / 输入框的 `TUI`；答完把问答收成一行再 `stop()`——不清屏，问答留在回滚里。
  * 取消（Esc / Ctrl+C）按各回调的约定返回 undefined（bootstrap 据此给退出码）。
  *
- * `modelItems` / `sessionItems` 同时供交互模式里的选择器（pickers.ts）使用。
+ * `modelItems`（model-items.ts）/ `sessionItems` 同时供交互模式里的选择器（pickers.ts）使用。启动选择器只列
+ * 已配置的模型，一个都没有时列全部。
  */
-import type { Model, ProviderRegistryApi } from "../../ai/types.js";
 import type { InteractiveUi } from "../../cli/deps.js";
 import type { SessionListItem } from "../../session/types.js";
 import { type Keybindings, type SelectItem, type Terminal, type Theme } from "../../tui.js";
+export { modelDescription, modelItems } from "./model-items.js";
 export interface StartupUiOptions {
     /** 每次问答新建的终端；缺省 `new ProcessTerminal()`。 */
     terminal?: () => Terminal;
@@ -19,13 +20,6 @@ export interface StartupUiOptions {
     /** 会话列表的相对时间基准（测试注入）。 */
     now?: () => number;
 }
-/** 选择器里模型的说明：名称（与 id 不同时）、上下文、`img`（收图片）。 */
-export declare function modelDescription(model: Model): string | undefined;
-/**
- * 模型按「供应商 · 渠道」分组；有 key（或本地）的供应商排前，组标题标 key 状态。多渠道供应商的模型在
- * 每个挂载的渠道下各出现一次，非首选渠道的值带 `@渠道`。
- */
-export declare function modelItems(providers: ProviderRegistryApi): Promise<SelectItem[]>;
 /** `刚刚 / 5 分钟前 / 3 小时前 / 2 天前 / 2026-09-01`。 */
 export declare function relativeTime(iso: string, now: number): string;
 /** 会话：标签 = 名字或首条提示，描述 = 相对时间 · 消息数。 */

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

@@ -5,12 +5,15 @@
  * 选择列表 / 输入框的 `TUI`；答完把问答收成一行再 `stop()`——不清屏，问答留在回滚里。
  * 取消（Esc / Ctrl+C）按各回调的约定返回 undefined（bootstrap 据此给退出码）。
  *
- * `modelItems` / `sessionItems` 同时供交互模式里的选择器（pickers.ts）使用。
+ * `modelItems`（model-items.ts）/ `sessionItems` 同时供交互模式里的选择器（pickers.ts）使用。启动选择器只列
+ * 已配置的模型，一个都没有时列全部。
  */
 import { msg } from "../../i18n/index.js";
 import { existsSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 import { Container, Editor, ProcessTerminal, SelectList, TUI, Text, createTheme, defaultKeybindings, detectCapabilities, } from "../../tui.js";
+import { loadModelCatalog, catalogItems } from "./model-items.js";
+export { modelDescription, modelItems } from "./model-items.js";
 function resolveOptions(options) {
     return {
         terminal: options.terminal ?? (() => new ProcessTerminal()),
@@ -106,64 +109,6 @@ function askText(r, prompt) {
 // ---------------------------------------------------------------------------
 // 列表项（选择器共用）
 // ---------------------------------------------------------------------------
-/** 选择器里模型的说明：名称（与 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;
-}
-/**
- * 模型按「供应商 · 渠道」分组；有 key（或本地）的供应商排前，组标题标 key 状态。多渠道供应商的模型在
- * 每个挂载的渠道下各出现一次，非首选渠道的值带 `@渠道`。
- */
-export async function modelItems(providers) {
-    const groups = [];
-    for (const provider of providers.list()) {
-        if (provider.models.length === 0)
-            continue;
-        let status;
-        let ready = true;
-        if (!provider.requiresApiKey)
-            status = msg().interactive.startup.ui.local;
-        else {
-            const key = await providers.resolveApiKey(provider.id).catch(() => ({ apiKey: undefined }));
-            ready = key.apiKey !== undefined;
-            status = ready ? "key ✓" : msg().interactive.startup.ui.noKey;
-        }
-        const item = (model, group, channel) => {
-            const suffix = channel !== undefined && channel !== model.channel ? `@${channel}` : "";
-            const out = {
-                value: `${provider.id}/${model.id}${suffix}`,
-                label: `${model.id}${suffix}`,
-                group,
-            };
-            const description = modelDescription(model);
-            if (description !== undefined)
-                out.description = description;
-            return out;
-        };
-        if (provider.channels === undefined) {
-            const group = `${provider.id} · ${status}`;
-            groups.push({ ready, items: provider.models.map((model) => item(model, group)) });
-            continue;
-        }
-        for (const channel of provider.channels) {
-            const group = `${provider.id} · ${channel.name} · ${status}`;
-            const models = provider.models.filter((m) => m.channels?.includes(channel.name));
-            if (models.length > 0)
-                groups.push({ ready, items: models.map((model) => item(model, group, channel.name)) });
-        }
-    }
-    return [...groups.filter((g) => g.ready), ...groups.filter((g) => !g.ready)].flatMap((g) => g.items);
-}
 /** `刚刚 / 5 分钟前 / 3 小时前 / 2 天前 / 2026-09-01`。 */
 export function relativeTime(iso, now) {
     const at = Date.parse(iso);
@@ -247,7 +192,10 @@ export function createStartupUi(options = {}) {
             return picked?.value;
         },
         async pickModel(providers, reason) {
-            const items = await modelItems(providers);
+            const catalog = await loadModelCatalog(providers);
+            let items = catalogItems(catalog, { hints: false });
+            if (items.length === 0)
+                items = catalogItems(catalog, { view: "all", hints: false });
             if (items.length === 0)
                 return undefined;
             const picked = await askSelect(r, {

package/dist/tui/components/select-list.d.ts

@@ -60,6 +60,8 @@ export declare class SelectList implements Component, Focusable {
     private get maxVisible();
     setItems(items: readonly SelectItem[]): void;
     getItems(): readonly SelectItem[];
+    /** 换列表下的按键提示（选择器切视图时）。 */
+    setFooter(footer: string | undefined): void;
     getFilter(): string;
     setFilter(filter: string): void;
     getSelected(): SelectItem | undefined;

package/dist/tui/components/select-list.js

@@ -52,6 +52,13 @@ export class SelectList {
     getItems() {
         return this.filtered;
     }
+    /** 换列表下的按键提示（选择器切视图时）。 */
+    setFooter(footer) {
+        if (footer === undefined)
+            delete this.options.footer;
+        else
+            this.options.footer = footer;
+    }
     getFilter() {
         return this.filter;
     }

package/docs/en/providers.md

@@ -170,6 +170,8 @@ ama auth logout chatgpt                # siwc revokes the refresh token first, t
 | Quota              | only known when exceeded (429); set a weekly cap for ama under ChatGPT → Settings → Usage → App limits                                                                                                                  | response headers, `codex.rate_limits` events, `ama auth status` queries `wham/usage`                                                                                            |
 | Logout             | calls `revocation_endpoint`, then deletes locally                                                                                                                                                                       | deletes locally only                                                                                                                                                            |
 
+**Model list**: `chatgpt` has no built-in model table (`chatgpt/<slug>` accepts any slug). After a successful `ama auth login chatgpt`, ama calls the model list endpoint once (siwc `GET /v1/models`, codex `GET /models`; read-only, no usage consumed; failures are silent and the output suggests `ama models discover chatgpt` instead) and caches the slugs and display names available to the account, with the flavor and a timestamp, in `<dataDir>/models/discovered/chatgpt.json`; `ama models discover chatgpt` rewrites the cache and `ama auth logout chatgpt` deletes it. When the registry is assembled the cache is merged into providers whose model table is empty, with metadata filled from the models.dev snapshot, so the `/model` picker and `ama models list` show the models; slugs missing from the cache still work with `--model chatgpt/<slug>`.
+
 The default channel of `chatgpt` is chosen at assembly time from the flavor of the auth.json entry; `provider/model@siwc|codex` can name it explicitly but must match the signed-in flavor (otherwise `chatgpt_flavor_mismatch`).
 
 **Credentials**: a `{ "type": "oauth", … }` entry in auth.json (file mode 0600); `ama auth list` only shows `oauth · <flavor> · <plan>`. The access token is refreshed automatically when less than 5 minutes remain or a request returns 401; several ama processes (several nodes on the canvas) share one auth.json, and refreshes are serialized through `auth.json.lock` (re-read after taking the lock; if another process already refreshed, its token is used), so refresh-token rotation never knocks another process out. When refreshing fails permanently the entry is marked `needsLogin` (tokens are not deleted), requests report `auth_expired`, and you sign in again with `ama auth login chatgpt` as prompted. Raw tokens, codes and id_tokens never reach logs, sessions, events or errors. Logins of other applications (Codex CLI and others) are never read or imported.

package/docs/en/tui.md

@@ -188,7 +188,14 @@ Design in [rewind-plan.md](../rewind-plan.md) (Chinese). Every user message that
 - `/fork` (no arguments): also picks a user message, then copies a new session up to before it.
 - `/model`, `/resume`, `/permission` and `/thinking` without arguments open pickers; `/permissions` shows the permission decision order, loaded rules and the latest 20 auto decisions (tier, result, reason).
 - The `/permission` picker, titled permission mode: Manual / Accept edits / Plan / Auto / Bypass permissions / Allowlist only, each with a one-line explanation and number keys 1–6 on the right for direct selection; the current mode is checked `✓`, the default mode from config is marked `Default`, Auto is marked `Recommended`, with a key hint line at the bottom. `/permission auto` and `/permission Accept edits` switch directly. The far left of the status bar is the mode's display name. When auto mode needs confirmation, the approval dialog has an extra line naming the auto rule tier / classifier and the reason. Details in [permissions.md](permissions.md).
-- Pickers have a key hint line at the bottom (`↑↓ select · Enter confirm · Esc cancel`) and a background on the selected row (≥ 256 colors; accent bold with fewer). The `/model` picker checks the current model with `✓` and shows an `(i/n)` count; it groups by "provider · channel" (multi-channel models get one item per channel, non-preferred channels marked `@channel`), and descriptions include context size and `img` (accepts images); `/model packy/kimi-k2.5@messages` switches to a specific channel directly.
+- Pickers have a key hint line at the bottom (`↑↓ select · Enter confirm · Esc cancel`) and a background on the selected row (≥ 256 colors; accent bold with fewer).
+- The `/model` picker (also `Ctrl+L`) checks the current model with `✓`, shows an `(i/n)` count, and descriptions include context size and `img` (accepts images):
+  - **Only configured providers by default**: a key, a valid OAuth sign-in (not one that needs signing in again) or a local server; group titles are "provider · status". When the current model is not in the list it is pinned at the top (group "current").
+  - **`Tab` switches to "all"** (press again to go back; the filter text is kept): providers without configuration are listed too, marked "no key configured"; picking one of their models does not switch and the bottom line suggests `ama auth set <provider>` (custom providers: `ama providers add`). `Tab` was chosen over an "add model" item at the end of the list: it takes no list row, never shows up in filter results, and works in the middle of filtering.
+  - **`Space` adds / removes the highlighted model to / from the list** (user-level `models.enabled`, written back to config.json): once the list is set, the "configured" view shows only listed models (plus the current one); removing the last entry deletes the key. Models listed through `provider/*` cannot be removed one by one; the hint points to `ama models disable`. While a list is in use, picking an unlisted model from "all" adds it to the list and then switches. Because of this `Space` no longer splits filter terms (the filter matches one term; `provider/model` works as a filter).
+  - **Multi-channel providers get one row per model** (the preferred channel); the description says "also @channel". With an `@` in the filter text (such as `@messages`) the `model@channel` rows are listed and picking one uses that channel. `@` was chosen over expanding with `→`: it matches the `provider/model@channel` syntax and works the same way in the startup picker. `/model packy/kimi-k2.5@messages` still switches to a specific channel directly.
+  - **ChatGPT subscription**: after `ama auth login chatgpt` the models available to the account are fetched (the read-only model list endpoint, no usage consumed) and cached in `<dataDir>/models/discovered/chatgpt.json`; the picker lists them like any other model. Without the cache the chatgpt group has a row "Run ama models discover chatgpt to list its models" (see [providers.md](providers.md#chatgpt-login)).
+  - The same list from the command line: `ama models enable <provider/model[@channel]|provider/*>…`, `ama models disable …`, `ama models list --enabled` (without a list it prints what the picker shows by default).
 - An `@image-path` in the input (quotes allowed, Tab completes the path), or a pasted / dropped image file path, is sent as an image attachment with the message; when the current model does not accept images an `@` attachment is an error and nothing is sent, while paths without `@` are ignored (see [providers.md](providers.md) "Image input").
 - `/statusline [full|compact]`: switch the bottom info line (without arguments it toggles, same as `Ctrl+G`), this session only; line mode has no bottom info line.
 - `/session`, `/cache`: session usage and cache stats panels (see "Cache and context" above); `/permissions` is a panel too, with allow in green, deny in red and the decision order wrapped and aligned. With sub-agent tasks `/session` gains a "Sub-agents" line (task count and states), and after using external agents an "External agents" section (runs and usage per agent, USD / tokens / requests each in its own unit, never converted).

package/docs/providers.md

@@ -185,6 +185,12 @@ ama auth logout chatgpt                # siwc 先撤销 refresh token 再删本
 | 配额     | 只在超限（429）时可知；在 ChatGPT → 设置 → Usage → App limits 给 ama 设周上限                                                                       | 响应头、`codex.rate_limits` 事件、`ama auth status` 查 `wham/usage`                                                                                   |
 | 登出     | 调 `revocation_endpoint` 撤销，再删本地                                                                                                             | 只删本地                                                                                                                                              |
 
+**模型列表**：`chatgpt` 没有内置模型表（`chatgpt/<slug>` 任意接受）。`ama auth login chatgpt` 成功后自动调一次模型
+列表接口（siwc `GET /v1/models`、codex `GET /models`，只读、不消耗额度；失败静默，改提示 `ama models discover chatgpt`），
+把账户可用的 slug 与显示名连同 flavor、时间戳缓存到 `<dataDir>/models/discovered/chatgpt.json`；`ama models discover
+chatgpt` 也重写这份缓存，`ama auth logout chatgpt` 删掉它。组装注册表时缓存并入模型表为空的供应商，元数据用 models.dev
+快照补全，`/model` 选择器、`ama models list` 照常列出；缓存里没有的 slug 仍可 `--model chatgpt/<slug>` 使用。
+
 `chatgpt` 的缺省渠道在组装时按 auth.json 条目的 flavor 决定；`provider/model@siwc|codex` 可显式指定，但必须与登录的
 flavor 一致（否则报 `chatgpt_flavor_mismatch`）。
 

package/docs/tui.md

@@ -182,7 +182,14 @@ Accept edits     claude-opus-5-5 medium | Ctx 3.0% | proj ⎇ main 5ae9e54 (+12,
 - `/fork`（无参数）：同样选一条用户消息，从它之前复制出新会话。
 - `/model`、`/resume`、`/permission`、`/thinking` 不带参数时打开选择器；`/permissions` 显示权限判定顺序、已加载规则与最近 20 条 auto 判定（层、结果、原因）。
 - `/permission` 选择器标题「权限模式」：Manual / Accept edits / Plan / Auto / Bypass permissions / Allowlist only，每项一行说明，右侧数字 1–6 直接选；当前模式打 `✓`，配置里的缺省模式标 `Default`，Auto 标 `Recommended`，底部一行按键提示。`/permission auto`、`/permission Accept edits` 直接切换。状态栏最左是模式的显示名。auto 模式下需要确认时，审批对话框多一行「Auto 规则层 / 分类器：原因」。详见 [permissions.md](permissions.md)。
-- 选择器底部一行按键提示（`↑↓ 选择 · Enter 确认 · Esc 取消`），选中行有底色（≥ 256 色；更少时强调色粗体）。`/model` 选择器给当前模型打 `✓`，并带 `(i/n)` 计数；按「供应商 · 渠道」分组（多渠道模型在每个渠道下各一项，非首选渠道带 `@渠道`），说明里有上下文与 `img`（收图片）；`/model packy/kimi-k2.5@messages` 直接切到指定渠道。
+- 选择器底部一行按键提示（`↑↓ 选择 · Enter 确认 · Esc 取消`），选中行有底色（≥ 256 色；更少时强调色粗体）。
+- `/model` 选择器（`Ctrl+L` 同）给当前模型打 `✓`，并带 `(i/n)` 计数，说明里有上下文与 `img`（收图片）：
+  - **缺省只列已配置的供应商**：有 key、OAuth 已登录（需重新登录的不算）或本地服务；组标题是「供应商 · 状态」。当前模型不在列表里时置顶一行（组「当前」）。
+  - **`Tab` 切到「全部」**（再按切回，筛选文本保留）：另列没配置的供应商，组标题标「未配置 key」；选中它们的模型不切换，底部提示 `ama auth set <供应商>`（自定义供应商用 `ama providers add`）。选 `Tab` 而不是列表底部的「添加模型」项：不占列表位置、不混进筛选结果，筛到一半也能切。
+  - **`Space` 把高亮的模型加入 / 移出清单**（用户级 `models.enabled`，写回 config.json）：设置了清单后「已配置」视图只列清单内的模型（加当前模型）；清单移空时删掉这个键。经 `provider/*` 列入的不能单独移出，按提示用 `ama models disable`。已在用清单时，从「全部」选中清单外的模型会先加入清单再切换。`Space` 因此不再用作筛选的分词（筛选按一个词匹配，`provider/model` 也能筛）。
+  - **多渠道供应商每个模型一行**（首选渠道），说明里写「另有 @渠道」；筛选文本里带 `@`（如 `@messages`）时列出 `模型@渠道` 行，直接选中即用该渠道。选 `@` 而不是 `→` 展开：与 `provider/model@channel` 的写法一致，启动选择器里也能用同一习惯。`/model packy/kimi-k2.5@messages` 仍可直接切到指定渠道。
+  - **ChatGPT 订阅**：`ama auth login chatgpt` 后自动拉取账户可用的模型（只读的模型列表接口，不消耗额度）缓存到 `<dataDir>/models/discovered/chatgpt.json`，选择器里按普通模型列出；没缓存时 chatgpt 组有一行「运行 ama models discover chatgpt 获取模型」（见 [providers.md](providers.md#chatgpt-登录)）。
+  - 命令行同一份清单：`ama models enable <provider/model[@channel]|provider/*>…`、`ama models disable …`、`ama models list --enabled`（没设清单时列出选择器缺省显示的模型）。
 - 输入里的 `@图片路径`（可加引号，Tab 补全路径）或粘贴 / 拖入的图片文件路径作为图片附件随消息发送；当前模型不收图片时 `@` 附件报错、不发送，未加 `@` 的路径忽略（见 [providers.md](providers.md)「图像输入」）。
 - `/statusline [full|compact]`：切换底部信息行（无参数时在两者间切换，同 `Ctrl+G`），只影响本会话；line 模式没有底部信息行。
 - `/session`、`/cache`：会话用量与缓存统计面板（见上文「缓存与上下文」）；`/permissions` 同样是面板，allow 绿、deny 红，判定顺序折行对齐。`/session` 有子 Agent 任务时多一行「子 Agent」（任务数与各状态），用过外部 Agent 时多一段「外部 Agent」（每个 Agent 的运行次数与用量，美元 / token / 请求数按各自单位，不换算）。