@orbit-intelligence/orbit-agent 0.3.13 → 0.3.15

package/dist/src/tui/app.js

@@ -4,6 +4,10 @@ import { providerNames } from '../config/config-schema.js';
 import { makeTheme, THEME_NAMES } from './themes/index.js';
 import { AppStore, ASK_OPTIONS } from './store.js';
 import { InkApp } from './InkApp.js';
+import { findPickerIndex, isPickerHeader, resolveModelRows, resolveProviderRows, } from './picker.js';
+import { saveNamedKey } from '../core/llm/secrets.js';
+import { saveEndpoint, rememberEndpointModel } from '../core/llm/endpoints.js';
+import { isImportableDirectly } from '../core/llm/secrets.js';
 export class TuiApp {
     store = new AppStore();
     theme;
@@ -13,6 +17,7 @@ export class TuiApp {
     config;
     bus;
     models;
+    pickBuilder = null;
     instance = null;
     done = false;
     /** Last dispatched key (sig + timestamp) for de-duping keyboard repeats. */
@@ -26,6 +31,7 @@ export class TuiApp {
         this.onCommand = opts.onCommand ?? (async () => null);
         this.version = opts.version;
         this.models = opts.models ?? [];
+        this.pickBuilder = opts.pickRows ?? null;
         this.theme = makeTheme(opts.config.theme);
         this.store.version = opts.version;
         this.store.cwd = process.cwd();
@@ -79,6 +85,65 @@ export class TuiApp {
     getMessages() {
         return this.store.messages;
     }
+    /** Push the current routed model list (after rebuild) into the app/UI. */
+    setModels(list) {
+        this.models = [...list];
+        this.store.models = [...list];
+    }
+    /**
+     * Rebuild the current picker stage's rows (providers, or models for the
+     * selected provider). The orbitx model list uses the LIVE routed models so
+     * offered == routable — this is the fix for "No model matches".
+     */
+    async refreshModelPicker() {
+        const store = this.store;
+        const stage = store.pickStage;
+        const provider = store.pickProviderProviderId;
+        try {
+            const rows = await (this.pickBuilder
+                ? this.pickBuilder(stage, provider, this.models)
+                : this.defaultRows(stage, provider));
+            store.pickRows = rows;
+            if (rows.length === 0)
+                store.modelPicker.index = 0;
+            else if (store.modelPicker.index >= rows.length)
+                store.modelPicker.index = rows.length - 1;
+            if (stage === 'providers') {
+                const cur = store.route?.provider;
+                const firstItem = rows.findIndex((r) => r.kind === 'item' && r.providerId === cur);
+                store.modelPicker.index = firstItem >= 0 ? firstItem : rows.findIndex((r) => r.kind === 'item');
+            }
+        }
+        catch {
+            store.pickRows = [];
+        }
+    }
+    defaultRows(stage, provider) {
+        if (stage === 'providers')
+            return Promise.resolve(resolveProviderRows());
+        return resolveModelRows(provider ?? '', this.models);
+    }
+    /** Open the /model overlay, starting at the provider (stage 1) list. */
+    async openModelPicker() {
+        const store = this.store;
+        store.pickStage = 'providers';
+        store.pickProviderProviderId = null;
+        store.keyEntry = null;
+        await this.refreshModelPicker();
+        const rows = store.pickRows;
+        if (rows.length === 0) {
+            const seen = new Set();
+            for (const m of store.models) {
+                const provider = m.split('/')[0] ?? 'orbitx';
+                if (seen.has(m))
+                    continue;
+                seen.add(m);
+                store.pickRows.push({ kind: 'item', label: m, id: m, provider });
+            }
+        }
+        store.modelPicker.open = true;
+        store.refresh();
+    }
     ask(prompt) {
         return new Promise((resolve) => {
             this.store.pendingAsk = { prompt, index: 0, resolve };
@@ -476,38 +541,297 @@ export class TuiApp {
     }
     handleModelPickerKey(input, key) {
         const store = this.store;
-        const list = store.models;
-        if (list.length === 0) {
+        // Inline key/custom-endpoint entry box: capture text, Enter advances.
+        if (store.keyEntry) {
+            this.handleKeyEntryKey(input, key);
+            return;
+        }
+        const rows = store.pickRows;
+        if (rows.length === 0) {
             store.modelPicker.open = false;
             store.refresh();
             return;
         }
         if (key.escape) {
+            if (store.pickStage === 'models') {
+                // Back to provider list (stage 1), re-enter the source-of-truth rows.
+                store.pickStage = 'providers';
+                store.pickProviderProviderId = null;
+                void this.refreshModelPicker().then(() => store.refresh());
+                return;
+            }
             store.modelPicker.open = false;
             store.refresh();
             return;
         }
         if (key.upArrow || (key.tab && key.shift)) {
-            store.modelPicker.index = (store.modelPicker.index - 1 + list.length) % list.length;
+            store.modelPicker.index = this.movePickerIndex(store.modelPicker.index, -1);
             store.refresh();
             return;
         }
         if (key.downArrow || key.tab) {
-            store.modelPicker.index = (store.modelPicker.index + 1) % list.length;
+            store.modelPicker.index = this.movePickerIndex(store.modelPicker.index, 1);
             store.refresh();
             return;
         }
         if (key.return) {
-            const chosen = list[store.modelPicker.index];
+            const row = rows[store.modelPicker.index];
+            if (!row || isPickerHeader(row)) {
+                store.modelPicker.open = false;
+                store.refresh();
+                return;
+            }
+            if (store.pickStage === 'providers') {
+                void this.enterProviderScope(row);
+                return;
+            }
             store.modelPicker.open = false;
             store.refresh();
-            if (chosen)
-                void this.switchModel(chosen);
+            void this.selectPickerModel(row);
             return;
         }
         if (input && !key.ctrl && !key.meta)
             store.refresh();
     }
+    /**
+     * Stage 1 Enter: open the chosen provider's key-entry (if missing a required
+     * key) or advance to its model list (stage 2).
+     */
+    async enterProviderScope(row) {
+        const store = this.store;
+        const providerRow = row;
+        const providerId = providerRow.providerId;
+        // Add-a-custom-endpoint flow.
+        if (providerId === '__add_custom__') {
+            store.keyEntry = { kind: 'endpoint-name', provider: '', value: '', cursorPos: 0, hint: 'name for this endpoint (e.g. lmstudio)' };
+            store.refresh();
+            return;
+        }
+        // Named key flows: provider needs a key and none is configured.
+        if (providerRow.needsKey) {
+            const p = providerId;
+            if (!isImportableDirectly(p)) {
+                this.note(`Provider "${providerId}" needs a key. Run \`orbit setup\` or set the env var.`);
+                return;
+            }
+            store.keyEntry = { kind: 'key-label', provider: p, value: '', cursorPos: 0, hint: `label for this ${p} key (e.g. "work")` };
+            store.refresh();
+            return;
+        }
+        await this.enterModelStage(providerId);
+    }
+    /** Advance to stage 2 (model list) for a provider, rebuilding rows live. */
+    async enterModelStage(providerId) {
+        const store = this.store;
+        store.pickStage = 'models';
+        store.pickProviderProviderId = providerId;
+        const rows = await (this.pickBuilder
+            ? this.pickBuilder('models', providerId, this.models)
+            : resolveModelRows(providerId, this.models));
+        // Custom endpoint with no discoverable models: let the user type the id.
+        if (providerId.startsWith('custom:') &&
+            rows.length === 1 &&
+            rows[0]?.kind === 'header' &&
+            /no models found/.test(rows[0].label)) {
+            const name = providerId.slice('custom:'.length);
+            store.keyEntry = {
+                kind: 'endpoint-fallback-model',
+                provider: name,
+                value: '',
+                cursorPos: 0,
+                hint: `model id served by ${name} (no live /v1/models response)`,
+            };
+            store.pickRows = rows;
+            store.refresh();
+            return;
+        }
+        store.pickRows = rows;
+        store.modelPicker.index = findPickerIndex(rows, store.route?.model, this.config.model.primary);
+        store.refresh();
+    }
+    /** Inline text boxes (key label/value, endpoint name/url/key, fallback model). */
+    handleKeyEntryKey(input, key) {
+        const store = this.store;
+        const e = store.keyEntry;
+        if (!e)
+            return;
+        const max = e.kind === 'key-value' ? 256 : 128;
+        if (key.escape) {
+            store.keyEntry = null;
+            store.refresh();
+            return;
+        }
+        if (key.return) {
+            void this.commitKeyEntry(e);
+            return;
+        }
+        if (key.backspace && e.value.length > 0) {
+            const pos = Math.max(0, e.cursorPos - 1);
+            e.value = e.value.slice(0, pos) + e.value.slice(e.cursorPos);
+            e.cursorPos = pos;
+            store.refresh();
+            return;
+        }
+        if (key.delete && e.cursorPos < e.value.length) {
+            e.value = e.value.slice(0, e.cursorPos) + e.value.slice(e.cursorPos + 1);
+            store.refresh();
+            return;
+        }
+        if (key.leftArrow) {
+            e.cursorPos = Math.max(0, e.cursorPos - 1);
+            store.refresh();
+            return;
+        }
+        if (key.rightArrow) {
+            e.cursorPos = Math.min(e.value.length, e.cursorPos + 1);
+            store.refresh();
+            return;
+        }
+        if (key.home) {
+            e.cursorPos = 0;
+            store.refresh();
+            return;
+        }
+        if (key.end) {
+            e.cursorPos = e.value.length;
+            store.refresh();
+            return;
+        }
+        if (key.ctrl && input === 'u') {
+            e.value = '';
+            e.cursorPos = 0;
+            store.refresh();
+            return;
+        }
+        if (input && !key.ctrl && !key.meta) {
+            if (e.value.length >= max) {
+                store.refresh();
+                return;
+            }
+            e.value = e.value.slice(0, e.cursorPos) + input + e.value.slice(e.cursorPos);
+            e.cursorPos += input.length;
+            store.refresh();
+        }
+    }
+    async commitKeyEntry(e) {
+        const store = this.store;
+        const val = e.value.trim();
+        switch (e.kind) {
+            case 'key-label':
+                if (!val) {
+                    store.keyEntry = null;
+                    store.refresh();
+                    return;
+                }
+                store.keyEntry = {
+                    kind: 'key-value',
+                    provider: e.provider,
+                    value: '',
+                    cursorPos: 0,
+                    hint: `paste the ${e.provider} API key (${val})`,
+                    keyLabel: val,
+                };
+                store.refresh();
+                return;
+            case 'key-value': {
+                const p = e.provider;
+                const err = await saveNamedKey(p, e.keyLabel ?? '', val);
+                if (err) {
+                    this.note(`Could not save key: ${err}`);
+                    store.keyEntry = null;
+                    store.refresh();
+                    return;
+                }
+                store.keyEntry = null;
+                await this.enterModelStage(p);
+                return;
+            }
+            case 'endpoint-name':
+                if (!val) {
+                    store.keyEntry = null;
+                    store.refresh();
+                    return;
+                }
+                store.keyEntry = { kind: 'endpoint-url', provider: val, value: '', cursorPos: 0, hint: 'OpenAI-compatible base URL, e.g. http://127.0.0.1:1234/v1' };
+                store.refresh();
+                return;
+            case 'endpoint-url':
+                if (!val.startsWith('http')) {
+                    this.note('Endpoint base URL must start with http:// or https://');
+                    store.refresh();
+                    return;
+                }
+                store.keyEntry = { kind: 'endpoint-key', provider: e.provider, value: '', cursorPos: 0, hint: 'optional API key (Enter to skip)', baseUrl: val };
+                store.refresh();
+                return;
+            case 'endpoint-key': {
+                const name = e.provider;
+                const err = await saveEndpoint({ name, baseUrl: e.baseUrl ?? '', key: val || undefined });
+                if (err) {
+                    this.note(`Could not save endpoint: ${err}`);
+                    store.keyEntry = null;
+                    store.refresh();
+                    return;
+                }
+                store.keyEntry = null;
+                // Refresh provider rows so the new endpoint appears, then jump to its models.
+                store.pickStage = 'providers';
+                await this.refreshModelPicker();
+                await this.enterModelStage(`custom:${name}`);
+                return;
+            }
+            case 'endpoint-fallback-model': {
+                store.keyEntry = null;
+                const name = e.provider;
+                if (val) {
+                    rememberEndpointModel(name, val);
+                }
+                store.modelPicker.open = false;
+                store.refresh();
+                void this.selectEndpointModel(name, val);
+                return;
+            }
+        }
+    }
+    async selectEndpointModel(name, model) {
+        if (!model)
+            return;
+        const full = `${name}/${model}`;
+        rememberEndpointModel(name, model);
+        const result = await this.onCommand({ type: 'model', value: full });
+        if (result === null)
+            this.note(`Model → ${full}`);
+    }
+    /** Step over the row list, skipping non-selectable header rows. */
+    movePickerIndex(index, delta) {
+        const rows = this.store.pickRows;
+        if (rows.length === 0)
+            return 0;
+        let i = index;
+        for (let steps = 0; steps < rows.length; steps++) {
+            i = (i + delta + rows.length) % rows.length;
+            const row = rows[i];
+            if (row && !isPickerHeader(row))
+                return i;
+        }
+        return index;
+    }
+    async selectPickerModel(item) {
+        // Custom endpoints: id is `<name>/<model>`; just switch the model (the
+        // endpoint's provider is registered by name). No provider switch needed.
+        if (item.provider.startsWith('custom:')) {
+            const name = item.provider.slice('custom:'.length);
+            await this.selectEndpointModel(name, item.id.slice(name.length + 1));
+            return;
+        }
+        // Switching provider first lets the same Enter pick a model from a
+        // provider that isn't active (e.g. gemini model while on openrouter).
+        const currentProvider = this.store.route?.provider;
+        if (item.provider !== currentProvider) {
+            await this.switchProvider(item.provider);
+        }
+        await this.switchModel(item.id);
+    }
     handleTabAutocomplete() {
         const buf = this.store.input.currentBuffer();
         const token = buf.split(/\s+/)[0] ?? '';
@@ -578,7 +902,7 @@ export class TuiApp {
                         `/clear           clear the conversation`,
                         `/help            show this help`,
                         `/model [id]      pick a model (bare: interactive selector)`,
-                        `/provider <id>   switch provider (orbitx · groq · gemini · openrouter)`,
+                        `/provider <id>   switch provider (orbitx · groq · gemini · openrouter · openai · anthropic · grok · deepseek · ollama)`,
                         `/plan <task>     plan first: propose a plan, approve with /run`,
                         `/run             execute the proposed plan`,
                         `/reject          discard the proposed plan`,
@@ -670,9 +994,7 @@ export class TuiApp {
             }
             case 'model':
                 if (!arg) {
-                    this.store.modelPicker.open = true;
-                    this.store.modelPicker.index = Math.max(0, this.models.findIndex((m) => m === this.store.route?.model || m.endsWith(`/${this.config.model.primary}`)));
-                    this.store.refresh();
+                    void this.openModelPicker();
                     return;
                 }
                 await this.switchModel(arg);

package/dist/src/tui/components/ModelPicker.js

@@ -1,23 +1,36 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { useStore } from '../context.js';
 import { themeColor } from '../colors.js';
-const MAX_VISIBLE = 8;
-/** Interactive model selector shown above the composer (opened by /model). */
-export function ModelPicker({ width }) {
+import { isPickerHeader } from '../picker.js';
+/** Model/provider selector overlay (opened by /model). Height includes border. */
+export function ModelPicker({ height }) {
     const store = useStore();
-    const list = store.models;
     const accent = store.theme ? themeColor(store.theme, 'accent') : '#7aa2f7';
     const dim = store.theme ? themeColor(store.theme, 'dim') : '#565f89';
     const muted = store.theme ? themeColor(store.theme, 'muted') : '#969cbc';
-    if (list.length === 0) {
-        return (_jsx(Box, { width: width, children: _jsx(Text, { color: dim, children: "no models available \u2014 configure a provider key first" }) }));
+    const attention = store.theme ? themeColor(store.theme, 'attention') : '#c3a332';
+    const rows = store.pickRows;
+    const idx = rows.length === 0 ? 0 : Math.min(Math.max(store.modelPicker.index, 0), rows.length - 1);
+    const innerH = Math.max(1, height - 3); // border(2) + footer(1)
+    const stageLabel = store.pickStage === 'models' ? 'model' : 'provider';
+    // Inline key / custom-endpoint entry: show one prompt + the typed value.
+    if (store.keyEntry) {
+        const ke = store.keyEntry;
+        const display = ke.kind === 'key-value' ? (ke.value ? '••••••••'.slice(0, 8) : '') : ke.value;
+        return (_jsxs(Box, { borderStyle: "round", borderColor: accent, width: "100%", height: height, flexDirection: "column", paddingX: 1, children: [_jsx(Box, { children: _jsxs(Text, { color: attention, bold: true, wrap: "truncate-end", children: [ke.kind === 'key-label' && `${ke.provider} key — label`, ke.kind === 'key-value' && `${ke.provider} key — value`, ke.kind === 'endpoint-name' && 'custom endpoint — name', ke.kind === 'endpoint-url' && `custom endpoint — base URL`, ke.kind === 'endpoint-key' && `custom endpoint — optional key`, ke.kind === 'endpoint-fallback-model' && `custom endpoint — model id`] }) }), _jsx(Text, { color: muted, wrap: "truncate-end", children: ke.hint }), _jsxs(Box, { children: [_jsx(Text, { color: dim, children: "\u276F " }), _jsx(Text, { color: accent, children: display || ' ' }), _jsx(Text, { color: muted, children: "\u258F" })] }), _jsx(Text, { color: muted, children: "Enter accept \u00B7 Esc cancel" })] }));
     }
-    const idx = Math.min(Math.max(store.modelPicker.index, 0), list.length - 1);
-    const start = Math.max(0, Math.min(idx, list.length - MAX_VISIBLE));
-    const window = list.slice(start, start + MAX_VISIBLE);
-    return (_jsxs(Box, { width: width, flexDirection: "column", children: [start > 0 && _jsxs(Text, { color: muted, children: ["\u25B2 ", (start).toLocaleString(), " more\u2026"] }), window.map((m, i) => {
+    if (rows.length === 0) {
+        return (_jsxs(Box, { borderStyle: "round", borderColor: dim, width: "100%", height: height, flexDirection: "column", paddingX: 1, children: [_jsxs(Text, { color: dim, children: ["no ", stageLabel, "s available \u2014 configure a provider key first"] }), _jsx(Text, { color: muted, children: "Esc back \u00B7 Esc close" })] }));
+    }
+    const start = Math.max(0, Math.min(idx, rows.length - innerH));
+    const windowRows = rows.slice(start, start + innerH);
+    return (_jsxs(Box, { borderStyle: "round", borderColor: accent, width: "100%", height: height, flexDirection: "column", paddingX: 1, children: [start > 0 && (_jsxs(Text, { color: muted, children: ["\u25B2 ", start, " more\u2026"] })), windowRows.map((r, i) => {
                 const at = start + i;
-                return (_jsxs(Box, { children: [_jsx(Text, { color: at === idx ? accent : dim, children: at === idx ? '❯ ' : '  ' }), _jsx(Text, { color: at === idx ? accent : dim, children: m })] }, m));
-            }), start + MAX_VISIBLE < list.length && _jsx(Text, { color: muted, children: "\u25BC more\u2026" }), _jsx(Text, { color: muted, children: "\u2191\u2193 select \u00B7 Enter choose \u00B7 Esc close" })] }));
+                if (isPickerHeader(r)) {
+                    return (_jsx(Box, { children: _jsx(Text, { color: attention, bold: true, wrap: "truncate-end", children: r.label }) }, `h-${at}`));
+                }
+                const hint = r.hint;
+                return (_jsxs(Box, { children: [_jsx(Text, { color: at === idx ? accent : dim, children: at === idx ? '❯ ' : '  ' }), _jsx(Text, { color: at === idx ? accent : dim, wrap: "truncate-end", children: r.label }), hint && _jsxs(Text, { color: muted, children: ["  ", hint] })] }, r.id ?? `p-${at}`));
+            }), start + innerH < rows.length && (_jsxs(Text, { color: muted, children: ["\u25BC ", rows.length - start - innerH, " more\u2026"] })), _jsx(Text, { color: muted, children: store.pickStage === 'models' ? '↑↓ select · Enter switch · Esc back' : '↑↓ select · Enter next · Esc close' })] }));
 }

package/dist/src/tui/picker.js

@@ -0,0 +1,162 @@
+import { PROVIDER_SPECS, ORBITX_SERVE } from '../core/llm/index.js';
+import { describeProviderKey } from '../core/llm/secrets.js';
+import { createOllamaProvider } from '../core/llm/providers/ollama.js';
+import { loadEndpoints, listEndpointModels } from '../core/llm/endpoints.js';
+export function isPickerHeader(row) {
+    return row.kind === 'header';
+}
+function specLabel(id) {
+    return PROVIDER_SPECS.find((p) => p.id === id)?.label ?? id;
+}
+/** Stage 1 — provider rows (sync; no probing here). */
+export function resolveProviderRows() {
+    const rows = [];
+    for (const spec of PROVIDER_SPECS) {
+        if (spec.id === 'ollama') {
+            const keyInfo = describeProviderKey('ollama');
+            rows.push({
+                kind: 'item',
+                providerId: 'ollama',
+                label: 'Ollama (local)',
+                hint: 'auto-detects a local server · no key required',
+                keyInfo: keyInfo === null ? { provider: 'ollama', available: false } : keyInfo,
+            });
+            continue;
+        }
+        if (spec.id === 'orbitx') {
+            const keyInfo = describeProviderKey('orbitx');
+            rows.push({
+                kind: 'item',
+                providerId: 'orbitx',
+                label: 'Orbit X (auto-routes Groq · Gemini · OpenRouter)',
+                hint: keyInfo?.available ? `token ${keyInfo.masked} · ${keyInfo.source}` : 'token optional — gateway auto-routes',
+                keyInfo: keyInfo === null ? { provider: 'orbitx', available: false } : keyInfo,
+            });
+            continue;
+        }
+        const keyInfo = describeProviderKey(spec.id);
+        const needsKey = spec.requiresSecret && !keyInfo?.available;
+        rows.push({
+            kind: 'item',
+            providerId: spec.id,
+            label: spec.label,
+            hint: needsKey
+                ? 'no key — press Enter to add'
+                : keyInfo
+                    ? `key ${keyInfo.masked} · ${keyInfo.source}${keyInfo.label ? ` · ${keyInfo.label}` : ''}`
+                    : 'no key required',
+            needsKey,
+            keyInfo: keyInfo ?? null,
+        });
+    }
+    // Named custom OpenAI-compatible endpoints.
+    const endpoints = loadEndpoints();
+    rows.push({ kind: 'header', label: 'Custom endpoints (OpenAI-compatible)' });
+    for (const ep of endpoints) {
+        rows.push({
+            kind: 'item',
+            providerId: `custom:${ep.name}`,
+            label: ep.name,
+            hint: `${ep.baseUrl}${ep.key ? ' · key set' : ' · no key'}`,
+            keyInfo: { provider: ep.name, available: true, source: 'file' },
+        });
+    }
+    rows.push({
+        kind: 'item',
+        providerId: '__add_custom__',
+        label: '＋ add a custom endpoint',
+        hint: 'LM Studio · vLLM · any OpenAI-compatible server',
+        keyInfo: null,
+    });
+    return rows;
+}
+/** Stage 2 — model rows for a provider. */
+export async function resolveModelRows(providerId, liveModels) {
+    const rows = [];
+    if (providerId.startsWith('custom:')) {
+        const name = providerId.slice('custom:'.length);
+        const ep = loadEndpoints().find((e) => e.name === name);
+        if (!ep) {
+            rows.push({ kind: 'header', label: 'unknown custom endpoint' });
+            return rows;
+        }
+        rows.push({ kind: 'header', label: `${name} — ${ep.baseUrl}` });
+        const live = await listEndpointModels(name);
+        const saved = (ep.models ?? []).filter(Boolean);
+        const merged = [...new Set([...live, ...saved])];
+        if (merged.length === 0) {
+            rows.push({
+                kind: 'header',
+                label: 'no models found — type a model id below (or start the server)',
+            });
+        }
+        else {
+            for (const m of merged) {
+                rows.push({ kind: 'item', label: m, id: `${name}/${m}`, provider: `custom:${name}` });
+            }
+        }
+        return rows;
+    }
+    if (providerId === 'ollama') {
+        const local = await createOllamaProvider().listModels();
+        if (local.length === 0) {
+            rows.push({ kind: 'header', label: 'Ollama server offline — run `ollama serve`' });
+            return rows;
+        }
+        rows.push({ kind: 'header', label: `Ollama (local) — ${local.length} installed` });
+        for (const full of local) {
+            rows.push({ kind: 'item', label: full.slice('ollama/'.length), id: full, provider: 'ollama' });
+        }
+        return rows;
+    }
+    if (providerId === 'orbitx') {
+        rows.push({ kind: 'header', label: 'Orbit X (auto-routes Groq · Gemini · OpenRouter)' });
+        // Prefer the LIVE routable list so offered == routable (kills "No model
+        // matches"); fall back to the serve table only when no orbitx candidates.
+        const live = liveModels.filter((m) => m.startsWith('orbitx/'));
+        const serve = live.length > 0 ? live : ORBITX_SERVE.map((b) => `orbitx/${b}`);
+        const seen = new Set();
+        for (const full of serve) {
+            if (seen.has(full))
+                continue;
+            seen.add(full);
+            const bare = full.slice('orbitx/'.length);
+            rows.push({
+                kind: 'item',
+                label: bare === 'auto' ? 'auto (backend routes across providers)' : bare,
+                id: full,
+                provider: 'orbitx',
+            });
+        }
+        return rows;
+    }
+    // Catalog provider.
+    const spec = PROVIDER_SPECS.find((p) => p.id === providerId);
+    if (!spec) {
+        rows.push({ kind: 'header', label: `unknown provider ${providerId}` });
+        return rows;
+    }
+    rows.push({ kind: 'header', label: spec.label });
+    for (const m of spec.models) {
+        rows.push({ kind: 'item', label: m.label ?? m.id, id: `${spec.id}/${m.id}`, provider: spec.id });
+    }
+    if (spec.supportsCustom) {
+        rows.push({ kind: 'header', label: '— or type a custom model id below' });
+    }
+    return rows;
+}
+/** Row index whose item matches the current route/model, else the first item. */
+export function findPickerIndex(rows, routeModel, configPrimary) {
+    if (rows.length === 0)
+        return 0;
+    const cur = routeModel || configPrimary || '';
+    for (let i = 0; i < rows.length; i++) {
+        const r = rows[i];
+        if (r && r.kind === 'item' && (r.id === cur || (configPrimary && r.id?.endsWith(`/${configPrimary.split('/').pop()}`)))) {
+            return i;
+        }
+    }
+    // Fall back to the first item row.
+    const firstItem = rows.findIndex((r) => r.kind === 'item');
+    return firstItem >= 0 ? firstItem : 0;
+}

package/dist/src/tui/store.js

@@ -39,6 +39,14 @@ export class AppStore {
     cwd = '';
     models = [];
     modelPicker = { open: false, index: 0 };
+    /** Which stage of the /model overlay is showing rows: providers or models. */
+    pickStage = 'providers';
+    /** Provider whose model list is showing in the model stage. */
+    pickProviderProviderId = null;
+    /** Inline key/custom-endpoint entry overlay (two-stage picker). */
+    keyEntry = null;
+    /** Grouped rows for the /model overlay (see picker.ts). */
+    pickRows = [];
     agents = new Map();
     dockOpen = false;
     yolo = false;

package/dist/src/utils/platform.js

@@ -42,6 +42,9 @@ export function configPath() {
 export function keysPath() {
     return join(configDir(), 'keys.json');
 }
+export function endpointsPath() {
+    return join(configDir(), 'endpoints.json');
+}
 export function historyPath() {
     return join(dataDir(), 'history.json');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbit-intelligence/orbit-agent",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "orbit — a premium pure-TypeScript coding agent for Termux and desktop terminals, powered by Orbit X.",
   "type": "module",
   "license": "UNLICENSED",