@orbit-intelligence/orbit-agent 0.3.14 → 0.3.16

package/dist/src/core/project-context.js

@@ -1,4 +1,4 @@
-import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { readFileSync, readdirSync, statSync, mkdirSync, writeFileSync } from 'node:fs';
 import { resolve, dirname, join, basename } from 'node:path';
 /**
  * Project-scoped instruction loading, modeled on Agent Build / Claude Code:
@@ -14,6 +14,10 @@ import { resolve, dirname, join, basename } from 'node:path';
  */
 const CONVENTION_FILES = ['AGENTS.md', '.orbit/AGENTS.md', '.agents/AGENTS.md', 'CLAUDE.md'];
 const MAX_TOTAL_BYTES = 120_000;
+/** Files holding long-term memory (read once at startup, editable via /remember). */
+const MEMORY_FILES = ['MEMORY.md', '.orbit/MEMORY.md'];
+/** Cap for injected memory, ~25KB; /remember bounds appends to this. */
+const MAX_MEMORY_BYTES = 25_000;
 export function loadProjectContext(cwd) {
     const files = [];
     const bodies = [];
@@ -34,6 +38,7 @@ export function loadProjectContext(cwd) {
         }
         return total > MAX_TOTAL_BYTES;
     });
+    const { memory, memoryFile } = loadMemory(cwd);
     const skillsDir = findSkillsDir(cwd);
     const skillBodies = {};
     const skills = [];
@@ -52,7 +57,62 @@ export function loadProjectContext(cwd) {
         }
         skills.sort((a, b) => a.name.localeCompare(b.name));
     }
-    return { files, conventions: bodies.join('\n'), skills, skillBodies };
+    return { files, conventions: bodies.join('\n'), memory, memoryFile, skills, skillBodies };
+}
+/**
+ * Locate memory files walking up from cwd (lowest dir wins), concatenating in
+ * order. Capped at MAX_MEMORY_BYTES like conventions but separately, so a blob
+ * of memory never eats the AGENTS.md budget.
+ */
+function loadMemory(cwd) {
+    const found = [];
+    collectUpward(cwd, (dir) => {
+        for (const name of MEMORY_FILES) {
+            const p = join(dir, name);
+            if (found.some((f) => f.p === p))
+                continue;
+            const raw = readSafe(p);
+            if (raw === null)
+                continue;
+            found.push({ p, raw });
+        }
+        return false;
+    });
+    if (found.length === 0)
+        return { memory: '', memoryFile: null };
+    let memory = '';
+    for (const { p, raw } of found) {
+        memory += `## ${relLabel(p, cwd)}\n${raw.trim()}\n\n`;
+        if (memory.length > MAX_MEMORY_BYTES)
+            break;
+    }
+    return { memory: memory.slice(0, MAX_MEMORY_BYTES), memoryFile: found[0].p };
+}
+/**
+ * Append a note to the project's memory file (/remember). Creates MEMORY.md in
+ * cwd when none exists. Returns the file path written, or null on failure.
+ */
+export function appendProjectMemory(cwd, note) {
+    const target = resolve(cwd, 'MEMORY.md');
+    const existing = readSafe(target) ?? '';
+    const header = existing.trim().length > 0 ? '' : '# orbit memory\n';
+    let body = existing + (existing.endsWith('\n') ? '' : '\n') + `- ${new Date().toISOString().slice(0, 10)}: ${note.trim()}\n`;
+    if (body.length > MAX_MEMORY_BYTES) {
+        // Keep the newest notes: drop the oldest lines until under cap.
+        const lines = body.split('\n');
+        while (body.length > MAX_MEMORY_BYTES && lines.length > 4) {
+            lines.shift();
+            body = lines.join('\n');
+        }
+    }
+    try {
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, header + body, 'utf8');
+        return target;
+    }
+    catch {
+        return null;
+    }
 }
 function collectUpward(start, visit) {
     let dir = resolve(start);

package/dist/src/core/tools/registry.js

@@ -15,12 +15,16 @@ export class ToolRegistry {
     ctx;
     constructor(init) {
         this.ctx = { cwd: init.cwd, canWrite: init.canWrite ?? true };
-        this.register(readFileTool);
-        this.register(editFileTool);
-        this.register(writeFileTool);
-        this.register(listDirTool);
-        this.register(globTool);
-        this.register(grepTool);
+        if (init.filesystem ?? true) {
+            this.register(readFileTool);
+            this.register(editFileTool);
+            this.register(writeFileTool);
+            this.register(listDirTool);
+            this.register(globTool);
+        }
+        if (init.search ?? true) {
+            this.register(grepTool);
+        }
         if (init.withGit ?? true) {
             for (const t of gitTools)
                 this.register(t);

package/dist/src/tui/InkApp.js

@@ -33,7 +33,11 @@ export function InkApp({ controller }) {
     const theme = store.theme ?? buildTheme('tokyonight');
     const menuing = store.input.currentBuffer().startsWith('/');
     const menuLines = menuing ? store.slashMatches().length + 1 : 0;
-    const modelLines = store.modelPicker.open ? Math.min(store.pickRows.length, 12) + 3 : 0;
+    const modelLines = store.modelPicker.open
+        ? store.keyEntry
+            ? 8
+            : Math.min(store.pickRows.length, 12) + 3
+        : 0;
     const dockLines = store.dockOpen
         ? store.agents.size === 0
             ? 2

package/dist/src/tui/app.js

@@ -4,7 +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 } from './picker.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;
@@ -87,28 +90,48 @@ export class TuiApp {
         this.models = [...list];
         this.store.models = [...list];
     }
-    /** Rebuild the grouped picker rows (e.g. after a provider/model switch). */
+    /**
+     * 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() {
-        if (!this.pickBuilder)
-            return;
+        const store = this.store;
+        const stage = store.pickStage;
+        const provider = store.pickProviderProviderId;
         try {
-            const rows = await this.pickBuilder();
-            this.store.pickRows = rows;
+            const rows = await (this.pickBuilder
+                ? this.pickBuilder(stage, provider, this.models)
+                : this.defaultRows(stage, provider));
+            store.pickRows = rows;
             if (rows.length === 0)
-                this.store.modelPicker.index = 0;
-            else if (this.store.modelPicker.index >= rows.length)
-                this.store.modelPicker.index = rows.length - 1;
+                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 {
-            this.store.pickRows = [];
+            store.pickRows = [];
         }
     }
-    /** Open the /model overlay, refreshing rows first so the list is current. */
+    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() {
-        await this.refreshModelPicker();
         const store = this.store;
-        if (store.pickRows.length === 0 && store.models.length > 0) {
-            // Fallback when no builder: derive item rows from the routed models.
+        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';
@@ -118,7 +141,6 @@ export class TuiApp {
                 store.pickRows.push({ kind: 'item', label: m, id: m, provider });
             }
         }
-        store.modelPicker.index = findPickerIndex(store.pickRows, store.route?.model, this.config.model.primary);
         store.modelPicker.open = true;
         store.refresh();
     }
@@ -225,6 +247,18 @@ export class TuiApp {
             }
             this.store.refresh();
         });
+        // Automatic context compaction happened (agent loop) — surface it.
+        this.bus.on('onContextSummary', ({ droppedPairs, tokensBefore, tokensAfter }) => {
+            this.store.contextTokens = tokensAfter;
+            this.pushMessage({
+                id: `ctx-${Date.now()}`,
+                role: 'system',
+                content: droppedPairs > 0
+                    ? `Context compacted: dropped ${droppedPairs} older turns (${tokensBefore} → ${tokensAfter} tokens).`
+                    : `Context within budget (${tokensAfter} tokens).`,
+                createdAt: Date.now(),
+            });
+        });
         // Plan mode lifecycle.
         this.bus.on('onPlanProposed', ({ text }) => {
             const plan = this.store.plan;
@@ -519,6 +553,11 @@ export class TuiApp {
     }
     handleModelPickerKey(input, key) {
         const store = this.store;
+        // 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;
@@ -526,6 +565,13 @@ export class TuiApp {
             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;
@@ -547,6 +593,10 @@ export class TuiApp {
                 store.refresh();
                 return;
             }
+            if (store.pickStage === 'providers') {
+                void this.enterProviderScope(row);
+                return;
+            }
             store.modelPicker.open = false;
             store.refresh();
             void this.selectPickerModel(row);
@@ -555,6 +605,215 @@ export class TuiApp {
         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;
@@ -570,6 +829,13 @@ export class TuiApp {
         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;
@@ -655,6 +921,8 @@ export class TuiApp {
                         `/diff            toggle unified diff view (or press d)`,
                         `/skills          list project skills (AGENTS.md / .orbit/skills)`,
                         `/theme <name>    change theme (${THEME_NAMES.join(' · ')})`,
+                        `/compact         summarize old context to free budget`,
+                        `/remember <note>  save a fact to MEMORY.md`,
                         `/yolo            auto-approve tools`,
                         `/yes             answer a permission prompt`,
                         `/agents          toggle agent dock (orchestrate mode)`,
@@ -753,6 +1021,30 @@ export class TuiApp {
                 store.yolo = true;
                 this.note('Permission mode → allow (yolo).');
                 return;
+            case 'compact': {
+                if (store.streaming) {
+                    this.note('Wait for the current turn to finish.');
+                    return;
+                }
+                this.note('Compacting context…');
+                const result = await this.onCommand({ type: 'compact' });
+                if (result) {
+                    store.contextTokens = parseTokenCount(result);
+                    this.note(result);
+                }
+                else
+                    this.note('Nothing to compact.');
+                return;
+            }
+            case 'remember': {
+                if (!arg) {
+                    this.note('Usage: /remember <note> — save a durable fact to MEMORY.md.');
+                    return;
+                }
+                const result = await this.onCommand({ type: 'remember', value: arg });
+                this.note(result ?? 'Saved to memory.');
+                return;
+            }
             case 'yes':
                 if (store.pendingAsk) {
                     const { resolve } = store.pendingAsk;
@@ -841,3 +1133,8 @@ function truncateForNote(text, max = 60) {
     const t = text.replace(/\s+/g, ' ').trim();
     return t.length <= max ? t : `${t.slice(0, max)}…`;
 }
+/** Pull the trailing "N tokens" value out of a /compact result message. */
+function parseTokenCount(result) {
+    const m = result.match(/(\d+) tokens?\.?$/);
+    return m ? Number(m[1]) : null;
+}

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

@@ -19,5 +19,5 @@ export function Header({ width }) {
     const border = store.theme ? themeColor(store.theme, 'border') : '#565f89';
     const model = store.route ? `${store.route.provider}/${store.route.model}` : 'no route';
     const dir = shortPath(store.cwd || process.cwd());
-    return (_jsxs(Box, { width: width, borderStyle: "single", borderColor: border, flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { height: 1, children: [_jsx(Text, { color: accent, bold: true, wrap: "truncate-end", children: '>_ orbit' }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: ` (v${store.version})` }), _jsx(Text, { color: muted, wrap: "truncate-end", children: `   model: ${model}` }), _jsx(Text, { color: dim, wrap: "truncate-end", children: '   /model' })] }), _jsx(Box, { height: 1, children: _jsx(Text, { color: dim, wrap: "truncate-end", children: `directory: ${dir}` }) })] }));
+    return (_jsxs(Box, { width: width, borderStyle: "single", borderColor: border, flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { height: 1, children: [_jsx(Text, { color: accent, bold: true, wrap: "truncate-end", children: '>_ orbit' }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: ` (v${store.version})` }), _jsx(Text, { color: muted, wrap: "truncate-end", children: `   model: ${model}` }), _jsx(Text, { color: dim, wrap: "truncate-end", children: '   /model' })] }), _jsxs(Box, { height: 1, children: [_jsx(Text, { color: dim, wrap: "truncate-end", children: `directory: ${dir}` }), store.contextTokens !== null && (_jsx(Text, { color: muted, wrap: "truncate-end", children: `   context: ${store.contextTokens} tok` }))] })] }));
 }

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

@@ -1,9 +1,9 @@
-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';
 import { isPickerHeader } from '../picker.js';
-/** Model selector overlay (opened by /model). Height includes the border. */
+/** Model/provider selector overlay (opened by /model). Height includes border. */
 export function ModelPicker({ height }) {
     const store = useStore();
     const accent = store.theme ? themeColor(store.theme, 'accent') : '#7aa2f7';
@@ -13,8 +13,15 @@ export function ModelPicker({ height }) {
     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" })] }));
+    }
     if (rows.length === 0) {
-        return (_jsxs(Box, { borderStyle: "round", borderColor: dim, width: "100%", height: height, flexDirection: "column", paddingX: 1, children: [_jsx(Text, { color: dim, children: "no models available \u2014 configure a provider key first" }), _jsx(Text, { color: muted, children: "Esc close" })] }));
+        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);
@@ -23,6 +30,7 @@ export function ModelPicker({ height }) {
                 if (isPickerHeader(r)) {
                     return (_jsx(Box, { children: _jsx(Text, { color: attention, bold: true, wrap: "truncate-end", children: r.label }) }, `h-${at}`));
                 }
-                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 })] }, r.id));
-            }), start + innerH < rows.length && (_jsxs(Text, { color: muted, children: ["\u25BC ", rows.length - start - innerH, " more\u2026"] })), _jsx(Text, { color: muted, children: "\u2191\u2193 select \u00B7 Enter switch \u00B7 Esc close" })] }));
+                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' })] }));
 }