@aiwayds/dsh-tui-pi 2.26.0 → 2.27.1

package/lib/model-list.d.ts

@@ -30,7 +30,12 @@ export type ModelRow = {
     kind: 'hiddenHeader';
     count: number;
 };
-/** Case-insensitive substring match of `query` against name/id/provider. */
+/**
+ * Keyword match of `query` against name/id/provider: whitespace-separated
+ * tokens, case-insensitive, AND across tokens (each token substring-matches
+ * at least one field). A single token degrades to the plain substring match;
+ * an empty/whitespace-only query matches everything.
+ */
 export declare function matchesModelFilter(model: ListedModel, query: string): boolean;
 /**
  * Display order of every picker section: providers aggregate alphabetically,

package/lib/model-list.js

@@ -11,14 +11,18 @@
 export function modelKey(model) {
     return `${model.provider}/${model.id}`;
 }
-/** Case-insensitive substring match of `query` against name/id/provider. */
+/**
+ * Keyword match of `query` against name/id/provider: whitespace-separated
+ * tokens, case-insensitive, AND across tokens (each token substring-matches
+ * at least one field). A single token degrades to the plain substring match;
+ * an empty/whitespace-only query matches everything.
+ */
 export function matchesModelFilter(model, query) {
-    const needle = query.trim().toLowerCase();
-    if (needle === '')
+    const tokens = query.trim().toLowerCase().split(/\s+/).filter(token => token !== '');
+    if (tokens.length === 0)
         return true;
-    return (model.name.toLowerCase().includes(needle)
-        || model.id.toLowerCase().includes(needle)
-        || model.provider.toLowerCase().includes(needle));
+    const fields = [model.name, model.id, model.provider].map(field => field.toLowerCase());
+    return tokens.every(token => fields.some(field => field.includes(token)));
 }
 /**
  * Display order of every picker section: providers aggregate alphabetically,

package/lib/model-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-list.js","sourceRoot":"","sources":["../src/model-list.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model-list.js","sourceRoot":"","sources":["../src/model-list.ts"],"names":[],"mappings":"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"}

package/lib/plugins.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The /plugins manager — the terminal counterpart of the web profile's
+ * plugin-management page, over the SAME base service (`ctx.pluginManager`,
+ * dsh-plugin-manager): bundles from `listBundles()`, Enter toggles
+ * `setBundleEnabled`, `d` uninstalls through `removeBundle` behind a
+ * confirm, `i` installs a spec (`inspect` preview → `installBundle`).
+ * `/` engages the shared TablePanel filter; every mutation reloads the
+ * list and the ChangeResult surfaces on the in-panel status line
+ * (`applied` / `restart-required` / `overridden` / `failed`…).
+ *
+ * Pure row/notice builders live at the top (unit-testable); the panel is
+ * the PanelHost glue, exercised on a terminal (same split as btw-overlay).
+ */
+import { type TUI } from '@earendil-works/pi-tui';
+import { type TuiTheme } from './theme/index.ts';
+/**
+ * Structural face of one bundle from `pluginManager.listBundles()` — the
+ * fields this panel renders. Kept local so the plugin never hard-depends on
+ * the `@deepseek-ai/dsh-plugin-manager` package at typecheck time.
+ */
+export interface PluginBundleInfo {
+    name: string;
+    version?: string;
+    description?: string;
+    enabled: boolean;
+    /** Profile-owned dependency (`true`) vs installation-supplied optional. */
+    installed: boolean;
+    optional: boolean;
+    removable: boolean;
+    readOnlyReason?: 'management-required' | 'unaddressable';
+    error?: {
+        message?: string;
+    } & Record<string, unknown>;
+}
+/** Structural face of `pluginManager`'s ChangeResult. */
+export interface PluginChangeResult {
+    changed: boolean;
+    application: 'applied' | 'restart-required' | 'overridden' | 'failed' | 'cancelled';
+    target: string;
+    error?: {
+        message?: string;
+    } & Record<string, unknown>;
+}
+/** Structural face of `pluginManager.inspect()`'s answer. */
+export type PluginInspection = {
+    status: 'accepted';
+    name?: string;
+    version?: string;
+    description?: string;
+    bundle: boolean | null;
+} | {
+    status: 'refused';
+    problem: string;
+    reason: string;
+};
+/** The service surface the panel drives (base bundle, keyed `pluginManager`). */
+export interface PluginManagerSeam {
+    listBundles(): Promise<readonly PluginBundleInfo[]>;
+    setBundleEnabled(name: string, enabled: boolean): Promise<PluginChangeResult>;
+    removeBundle(name: string): Promise<PluginChangeResult>;
+    installBundle(spec: string, options?: {
+        enabled?: boolean;
+    }): Promise<PluginChangeResult>;
+    inspect(spec: string): Promise<PluginInspection>;
+}
+/** One rendered row of the plugin table. */
+export interface PluginRowView {
+    name: string;
+    /** Name + @version (the PLUGIN column). */
+    label: string;
+    /** STATE column text (on/off/not installed + badges). */
+    state: string;
+    /** Enter may toggle (not read-only, no load error). */
+    toggleable: boolean;
+    removable: boolean;
+}
+/** STATE text of one bundle: on/off/not-installed plus error/readonly badges. */
+export declare function bundleStateText(bundle: PluginBundleInfo): string;
+/**
+ * Bundle rows for the table: alphabetical by name (the web page groups
+ * Official/Installed cards; a flat sorted table reads better in a terminal
+ * and the `/` filter narrows it anyway).
+ */
+export declare function pluginRowViews(bundles: readonly PluginBundleInfo[]): PluginRowView[];
+/**
+ * Status-line wording of one ChangeResult — the application outcome the
+ * web page toasts, phrased for the TUI status row.
+ */
+export declare function pluginChangeNotice(result: PluginChangeResult): string;
+/** Options for the /plugins manager entry point. */
+export interface OpenPluginsPanelOptions {
+    tui: TUI;
+    theme: TuiTheme;
+    /** The pluginManager service (already narrowed to the seam); undefined = unavailable. */
+    manager?: PluginManagerSeam;
+    restoreFocus: () => void;
+    /** Esc exit — closes the hosting overlay (wired by openPluginsPanel). */
+    onExit?: () => void;
+    /** Error sink for failures that outlive the panel (transcript). */
+    onError: (message: string) => void;
+}
+/**
+ * Open the /plugins manager. Returns `undefined` once the panel closed
+ * normally, or an error string when plugin management is unavailable in
+ * this profile (no pluginManager service) or the first listing failed —
+ * the caller turns that into the command's error reply.
+ */
+export declare function openPluginsPanel(options: OpenPluginsPanelOptions): Promise<string | undefined>;

package/lib/plugins.js

@@ -0,0 +1,367 @@
+/**
+ * The /plugins manager — the terminal counterpart of the web profile's
+ * plugin-management page, over the SAME base service (`ctx.pluginManager`,
+ * dsh-plugin-manager): bundles from `listBundles()`, Enter toggles
+ * `setBundleEnabled`, `d` uninstalls through `removeBundle` behind a
+ * confirm, `i` installs a spec (`inspect` preview → `installBundle`).
+ * `/` engages the shared TablePanel filter; every mutation reloads the
+ * list and the ChangeResult surfaces on the in-panel status line
+ * (`applied` / `restart-required` / `overridden` / `failed`…).
+ *
+ * Pure row/notice builders live at the top (unit-testable); the panel is
+ * the PanelHost glue, exercised on a terminal (same split as btw-overlay).
+ */
+import { getKeybindings } from '@earendil-works/pi-tui';
+import { t } from "./i18n/index.js";
+import { EditField } from "./settings.js";
+import { autoColumns, panelThemeFns, PanelHost, TablePanel } from "./panels.js";
+import { BOLD, RESET } from "./theme/index.js";
+import { clipToWidth } from "./text.js";
+/** STATE text of one bundle: on/off/not-installed plus error/readonly badges. */
+export function bundleStateText(bundle) {
+    const base = !bundle.installed && bundle.optional
+        ? t('plugins.state.available')
+        : bundle.enabled
+            ? t('plugins.state.on')
+            : t('plugins.state.off');
+    if (bundle.error !== undefined)
+        return `${base} ${t('plugins.state.error')}`;
+    if (bundle.readOnlyReason !== undefined)
+        return `${base} ${t('plugins.state.readOnly')}`;
+    return base;
+}
+/**
+ * Bundle rows for the table: alphabetical by name (the web page groups
+ * Official/Installed cards; a flat sorted table reads better in a terminal
+ * and the `/` filter narrows it anyway).
+ */
+export function pluginRowViews(bundles) {
+    return [...bundles]
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map(bundle => ({
+        name: bundle.name,
+        label: bundle.version !== undefined && bundle.version !== '' ? `${bundle.name}@${bundle.version}` : bundle.name,
+        state: bundleStateText(bundle),
+        toggleable: bundle.readOnlyReason === undefined && bundle.error === undefined,
+        removable: bundle.removable,
+    }));
+}
+/**
+ * Status-line wording of one ChangeResult — the application outcome the
+ * web page toasts, phrased for the TUI status row.
+ */
+export function pluginChangeNotice(result) {
+    const suffix = result.error?.message !== undefined && result.error.message !== ''
+        ? `: ${result.error.message}`
+        : '';
+    switch (result.application) {
+        case 'applied': return t('plugins.notice.applied', { target: result.target });
+        case 'restart-required': return t('plugins.notice.restartRequired', { target: result.target });
+        case 'overridden': return t('plugins.notice.overridden', { target: result.target });
+        case 'failed': return t('plugins.notice.failed', { target: result.target }) + suffix;
+        case 'cancelled': return t('plugins.notice.cancelled');
+    }
+}
+/**
+ * One-line confirm (Enter/Esc) for destructive plugin actions — the
+ * ConfirmReset shape with plugin copy.
+ */
+class PluginConfirm {
+    theme;
+    label;
+    body;
+    onConfirm;
+    onCancel;
+    constructor(theme, label, body, onConfirm, onCancel) {
+        this.theme = theme;
+        this.label = label;
+        this.body = body;
+        this.onConfirm = onConfirm;
+        this.onCancel = onCancel;
+    }
+    invalidate() { }
+    render(width) {
+        const fns = panelThemeFns(this.theme);
+        const lines = [fns.accent(BOLD + clipToWidth(this.label, width) + RESET)];
+        lines.push('');
+        for (const line of this.body)
+            lines.push(fns.muted(clipToWidth(`  ${line}`, width)));
+        lines.push('');
+        lines.push(fns.subtle(clipToWidth(t('plugins.confirm.hints'), width)));
+        return lines;
+    }
+    handleInput(data) {
+        const kb = getKeybindings();
+        if (kb.matches(data, 'tui.select.confirm'))
+            this.onConfirm();
+        else if (kb.matches(data, 'tui.select.cancel'))
+            this.onCancel();
+    }
+}
+/**
+ * The manager panel: a filterable bundle table plus in-place swap modes
+ * (install editor, install preview, uninstall confirm) and a status line
+ * carrying busy state and ChangeResult notices.
+ */
+class PluginsPanel {
+    tui;
+    theme;
+    manager;
+    onExit;
+    onError;
+    bundles = [];
+    query = '';
+    /** The active table; rebuilt on every reload/keep-focus path. */
+    table;
+    tableOptions;
+    /** In-place swap mode (install editor / preview / uninstall confirm). */
+    mode;
+    /** Status line: busy text or a change notice (auto-clearing). */
+    status;
+    statusTimer;
+    busy = false;
+    rerender = () => { this.tui.requestRender(); };
+    constructor(options) {
+        if (options.manager === undefined)
+            throw new Error('pluginManager service is required');
+        this.tui = options.tui;
+        this.theme = options.theme;
+        this.manager = options.manager;
+        this.onExit = options.onExit ?? (() => { });
+        this.onError = options.onError;
+        this.tableOptions = {
+            title: t('plugins.title'),
+            columns: [],
+            rows: [],
+            renderCell: (row, column) => (column.key === 'state' ? row.state : row.label),
+            isSelectable: () => true,
+            onSelect: row => { void this.toggle(row); },
+            onCancel: () => this.onExit(),
+            footer: t('plugins.footer'),
+            status: () => this.status,
+            emptyHint: t('plugins.empty'),
+            filter: {
+                getQuery: () => this.query,
+                onQueryChange: next => {
+                    this.query = next;
+                    this.rebuild();
+                },
+            },
+            shortcuts: {
+                i: () => { void this.beginInstall(); },
+                d: () => { void this.confirmRemove(this.table.selectedRow()); },
+            },
+        };
+        this.table = new TablePanel(this.theme, this.tableOptions);
+    }
+    invalidate() {
+        this.mode?.invalidate();
+        this.table.invalidate();
+    }
+    /** PanelHost teardown hook: drop any pending status-clear timer. */
+    dispose() {
+        clearTimeout(this.statusTimer);
+    }
+    render(width) {
+        return (this.mode ?? this.table).render(width);
+    }
+    handleInput(data) {
+        // A running mutation already holds the write path — extra keys must not
+        // stack a second one (the notice would lie about the first).
+        if (this.busy)
+            return;
+        const target = this.mode ?? this.table;
+        target.handleInput?.(data);
+    }
+    /** Initial load; returns an error string when the listing fails. */
+    async load() {
+        try {
+            this.bundles = await this.manager.listBundles();
+        }
+        catch (cause) {
+            return t('plugins.listFailed', { message: cause instanceof Error ? cause.message : String(cause) });
+        }
+        this.rebuild();
+        return undefined;
+    }
+    /** Rebuild the table rows from the current bundles + filter. */
+    rebuild(keepName) {
+        const rows = pluginRowViews(this.bundles).filter(row => row.label.toLowerCase().includes(this.query.trim().toLowerCase())
+            || row.name.toLowerCase().includes(this.query.trim().toLowerCase()));
+        this.tableOptions.columns = autoColumns([
+            { key: 'plugin', title: t('plugins.col.plugin'), cap: 36 },
+            { key: 'state', title: t('plugins.col.state') },
+        ], rows, (row, key) => (key === 'state' ? row.state : row.label));
+        this.tableOptions.rows = rows;
+        const followed = keepName !== undefined && this.table.focusRow(row => row.name === keepName);
+        if (!followed && this.query.trim() !== '')
+            this.table.focusRow(() => true);
+        else if (!followed)
+            this.table.resyncCursor();
+    }
+    /** Show one status line; busy text persists, notices auto-clear. */
+    flash(message, autoClearMs) {
+        this.status = message;
+        clearTimeout(this.statusTimer);
+        if (autoClearMs !== undefined) {
+            this.statusTimer = setTimeout(() => {
+                this.status = undefined;
+                this.rerender();
+            }, autoClearMs);
+        }
+        this.rerender();
+    }
+    /** Reload the bundle list, keeping the cursor on `keepName` when present. */
+    async reload(keepName) {
+        try {
+            this.bundles = await this.manager.listBundles();
+        }
+        catch (cause) {
+            this.onError(t('plugins.listFailed', { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+        this.rebuild(keepName);
+        this.rerender();
+    }
+    /** Enter: toggle the bundle on/off (guarded), then reload + notice. */
+    async toggle(row) {
+        if (row === undefined || !row.toggleable) {
+            if (row !== undefined)
+                this.flash(t('plugins.notice.readOnly', { name: row.name }), 4000);
+            return;
+        }
+        const bundle = this.bundles.find(entry => entry.name === row.name);
+        if (bundle === undefined)
+            return;
+        this.busy = true;
+        this.flash(t('plugins.busy.toggling', { name: row.name }));
+        try {
+            const result = await this.manager.setBundleEnabled(row.name, !bundle.enabled);
+            this.flash(pluginChangeNotice(result), 6000);
+        }
+        catch (cause) {
+            this.flash(t('plugins.notice.failed', {
+                target: row.name,
+            }) + `: ${cause instanceof Error ? cause.message : String(cause)}`, 6000);
+        }
+        this.busy = false;
+        await this.reload(row.name);
+    }
+    /** `d`: uninstall behind a one-line confirm. */
+    async confirmRemove(row) {
+        if (row === undefined)
+            return;
+        if (!row.removable) {
+            this.flash(t('plugins.notice.notRemovable', { name: row.name }), 4000);
+            return;
+        }
+        const name = row.name;
+        this.mode = new PluginConfirm(this.theme, t('plugins.confirm.removeTitle', { name }), [t('plugins.confirm.removeBody')], () => { void this.remove(name); }, () => { this.mode = undefined; this.rerender(); });
+        this.rerender();
+    }
+    async remove(name) {
+        this.mode = undefined;
+        this.busy = true;
+        this.flash(t('plugins.busy.removing', { name }));
+        try {
+            const result = await this.manager.removeBundle(name);
+            this.flash(pluginChangeNotice(result), 6000);
+        }
+        catch (cause) {
+            this.flash(t('plugins.notice.failed', { target: name }) + `: ${cause instanceof Error ? cause.message : String(cause)}`, 6000);
+        }
+        this.busy = false;
+        await this.reload();
+    }
+    /** `i`: spec editor → inspect preview → confirm → install. */
+    async beginInstall() {
+        this.mode = new EditField(this.tui, {
+            title: t('plugins.install.title'),
+            subtitle: t('plugins.install.hint'),
+            initial: '',
+            parse: text => (text.trim() === ''
+                ? { kind: 'error', error: t('plugins.install.empty') }
+                : { kind: 'value', value: text.trim() }),
+            onCommit: async (outcome) => {
+                if (outcome.kind !== 'value')
+                    return undefined;
+                // Fire-and-forget: closing the editor immediately hands the screen
+                // back to the table, whose status line carries the install phases.
+                void this.runInstall(String(outcome.value));
+                return undefined;
+            },
+            // Enter and Esc both return to the table; the install (when started)
+            // continues on the status line.
+            onDone: () => { this.mode = undefined; this.rerender(); },
+            onError: message => this.onError(message),
+        }, this.theme);
+        this.rerender();
+    }
+    async runInstall(spec) {
+        this.mode = undefined;
+        this.busy = true;
+        this.flash(t('plugins.busy.inspecting', { spec }));
+        let inspection;
+        try {
+            inspection = await this.manager.inspect(spec);
+        }
+        catch (cause) {
+            this.busy = false;
+            this.flash(t('plugins.install.inspectFailed', {
+                message: cause instanceof Error ? cause.message : String(cause),
+            }), 6000);
+            return;
+        }
+        if (inspection.status === 'refused') {
+            this.busy = false;
+            this.flash(t('plugins.install.refused', {
+                problem: inspection.problem,
+                reason: inspection.reason,
+            }), 8000);
+            return;
+        }
+        this.flash(t('plugins.busy.installing', { spec }));
+        try {
+            const result = await this.manager.installBundle(spec, { enabled: true });
+            this.flash(pluginChangeNotice(result), 8000);
+        }
+        catch (cause) {
+            this.flash(t('plugins.notice.failed', { target: spec }) + `: ${cause instanceof Error ? cause.message : String(cause)}`, 8000);
+        }
+        this.busy = false;
+        await this.reload();
+    }
+}
+/**
+ * Open the /plugins manager. Returns `undefined` once the panel closed
+ * normally, or an error string when plugin management is unavailable in
+ * this profile (no pluginManager service) or the first listing failed —
+ * the caller turns that into the command's error reply.
+ */
+export async function openPluginsPanel(options) {
+    if (options.manager === undefined)
+        return t('plugins.unavailable');
+    const restoreFocus = options.restoreFocus;
+    // The panel's Esc exit closes the host BEFORE refocusing — the shared
+    // overlay contract (a half-torn-down overlay must not strand focus).
+    const exit = () => {
+        host.close();
+        restoreFocus();
+    };
+    // A half-mounted overlay must not strand the keyboard (PanelHost calls
+    // onError first, then we settle through the same exit path).
+    const host = new PanelHost(options.tui, options.theme, () => {
+        restoreFocus();
+    });
+    const panel = new PluginsPanel({
+        ...options,
+        onExit: exit,
+    });
+    const loadError = await panel.load();
+    if (loadError !== undefined) {
+        restoreFocus();
+        return loadError;
+    }
+    host.open(panel, '75%', '80%');
+    return undefined;
+}
+//# sourceMappingURL=plugins.js.map

package/lib/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"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"}

package/lib/provider-catalog.d.ts

@@ -91,6 +91,36 @@ export declare function resolveCatalogHint(hint: string): string;
  * @returns the derived reference (e.g. `ANTHROPIC_API_KEY`, `OPENCODE_GO_API_KEY`).
  */
 export declare function deriveKeyRef(provider: string): string;
+/**
+ * The editable form state of a hand-declared route — the shape the
+ * custom-provider form works on, in both create and edit mode. Lives here
+ * (not in custom-provider.ts) so settings.ts can read a live profile into
+ * one without touching the custom-provider ↔ settings import cycle.
+ */
+export interface CustomProviderDraft {
+    id: string;
+    /** Empty string = no display name (the route id shows instead). */
+    displayName: string;
+    api: string;
+    baseURL: string;
+    /** Comma-joined model ids (parsed form of the models field). */
+    models: string;
+}
+/**
+ * Read a live `providers.<id>` profile into an editable draft: unknown or
+ * malformed fields fall back to their form defaults rather than failing —
+ * an edit must always be openable, even for a route the web page wrote
+ * with fields this form does not know.
+ */
+export declare function customDraftFromProfile(id: string, profile: unknown): CustomProviderDraft;
+/**
+ * Whether a live profile row is a hand-declared route (editable in full)
+ * rather than a catalog-served one (only its key is editable — endpoint,
+ * protocol and models come from the installed pi-ai catalog). A profile
+ * that carries its own `api`/`baseURL`/`models` overrides the catalog, so
+ * it reads as hand-declared even when the directory disagrees.
+ */
+export declare function isHandDeclaredProfile(profile: unknown): boolean;
 /**
  * The llm-pi-ai providers.<id> value an entry writes as: a catalog route
  * stores only the derived credential reference (endpoint, protocol, and

package/lib/provider-catalog.js

@@ -113,6 +113,44 @@ export function resolveCatalogHint(hint) {
 export function deriveKeyRef(provider) {
     return `${provider.toUpperCase().replace(/[^A-Z0-9]+/g, '_')}_API_KEY`;
 }
+/**
+ * Read a live `providers.<id>` profile into an editable draft: unknown or
+ * malformed fields fall back to their form defaults rather than failing —
+ * an edit must always be openable, even for a route the web page wrote
+ * with fields this form does not know.
+ */
+export function customDraftFromProfile(id, profile) {
+    const p = (typeof profile === 'object' && profile !== null ? profile : {});
+    const models = Array.isArray(p.models)
+        ? p.models
+            .map(model => (typeof model === 'object' && model !== null
+            ? model.id
+            : undefined))
+            .filter((modelId) => typeof modelId === 'string' && modelId !== '')
+        : [];
+    return {
+        id,
+        displayName: typeof p.displayName === 'string' ? p.displayName : '',
+        api: typeof p.api === 'string' ? p.api : '',
+        baseURL: typeof p.baseURL === 'string' ? p.baseURL : '',
+        models: models.join(','),
+    };
+}
+/**
+ * Whether a live profile row is a hand-declared route (editable in full)
+ * rather than a catalog-served one (only its key is editable — endpoint,
+ * protocol and models come from the installed pi-ai catalog). A profile
+ * that carries its own `api`/`baseURL`/`models` overrides the catalog, so
+ * it reads as hand-declared even when the directory disagrees.
+ */
+export function isHandDeclaredProfile(profile) {
+    if (typeof profile !== 'object' || profile === null)
+        return false;
+    const p = profile;
+    return typeof p.api === 'string'
+        || typeof p.baseURL === 'string'
+        || Array.isArray(p.models);
+}
 /**
  * The llm-pi-ai providers.<id> value an entry writes as: a catalog route
  * stores only the derived credential reference (endpoint, protocol, and