@elaraai/e3-ui-cli 1.0.71 → 1.0.73

package/dist/tui/data/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/tui/data/logs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAA4B,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,iCAAiC;AACjC,eAAO,MAAM,SAAS,QAAY,CAAC;AACnC,qCAAqC;AACrC,eAAO,MAAM,OAAO,QAAmB,CAAC;AAIxC,qBAAqB;AACrB,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5C,8BAA8B;AAC9B,wBAAgB,SAAS,IAAI,QAAQ,CAEpC;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC9C;AAED,uBAAuB;AACvB,MAAM,WAAW,UAAU;IACvB,mFAAmF;IACnF,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,uCAAuC;IACvC,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAiDjE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9E"}

package/dist/tui/data/logs.js

@@ -0,0 +1,134 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Task logs — `taskLogs` in 64 KB chunks (`offset += size`) up to a 10 MB
+ * cap, polled every second for the stream on screen (and every five for
+ * stderr on every task tab, for the Stderr tab's line count). A stream that has
+ * no run yet reads as empty with `execution_not_found` noted; a chunk
+ * failure keeps what was fetched and notes the error.
+ *
+ * @packageDocumentation
+ */
+import { describeError, isApiCode } from '../api.js';
+/** Bytes fetched per request. */
+export const LOG_CHUNK = 64 * 1024;
+/** Bytes kept per stream at most. */
+export const LOG_CAP = 10 * 1024 * 1024;
+/** Chunks fetched per tick at most (a 5 MB backlog arrives over a few ticks, never in one). */
+const CHUNKS_PER_TICK = 16;
+/** An empty stream record. */
+export function emptyLogs() {
+    return { text: '', offset: 0, totalSize: 0, complete: false, capped: false, error: null };
+}
+/**
+ * Creates the loader.
+ *
+ * @param deps - The store, the API accessor, the log
+ * @returns The loader
+ */
+export function createLogsLoader(deps) {
+    const { store } = deps;
+    const inflight = new Set();
+    const current = (ws, task, stream) => store.getState().data.logs[ws]?.[task]?.[stream] ?? emptyLogs();
+    return {
+        async tick(ws, task, stream) {
+            const api = deps.api();
+            if (api === null)
+                return;
+            const key = `${ws}\n${task}\n${stream}`;
+            if (inflight.has(key))
+                return;
+            inflight.add(key);
+            try {
+                for (let i = 0; i < CHUNKS_PER_TICK; i++) {
+                    const before = current(ws, task, stream);
+                    if (before.capped)
+                        return;
+                    let chunk;
+                    try {
+                        chunk = await api.taskLogs(ws, task, { stream, offset: before.offset, limit: LOG_CHUNK });
+                    }
+                    catch (err) {
+                        if (isApiCode(err, 'execution_not_found')) {
+                            if (before.error !== 'no run yet' || before.totalSize !== 0)
+                                store.dispatch({ type: 'data/logs', ws, task, stream, logs: { ...before, complete: true, error: 'no run yet' } });
+                            return;
+                        }
+                        deps.log?.(`logs ${ws}/${task}/${stream} failed: ${describeError(err)}`);
+                        store.dispatch({ type: 'data/logs', ws, task, stream, logs: { ...before, error: describeError(err) } });
+                        return;
+                    }
+                    const size = Number(chunk.size);
+                    const totalSize = Number(chunk.totalSize);
+                    const offset = Number(chunk.offset) + size;
+                    // A shorter total than what we hold means the log was truncated (a new run): start over from zero.
+                    if (totalSize < before.offset) {
+                        store.dispatch({ type: 'data/logs', ws, task, stream, logs: { ...emptyLogs(), totalSize } });
+                        continue;
+                    }
+                    const capped = offset >= LOG_CAP;
+                    const next = { text: before.text + chunk.data, offset, totalSize, complete: chunk.complete, capped, error: null };
+                    const unchanged = size === 0 && before.totalSize === totalSize && before.complete === chunk.complete && before.error === null;
+                    if (!unchanged)
+                        store.dispatch({ type: 'data/logs', ws, task, stream, logs: next });
+                    if (chunk.complete || size === 0 || capped)
+                        return;
+                }
+            }
+            finally {
+                inflight.delete(key);
+            }
+        },
+        reset() {
+            inflight.clear();
+        },
+    };
+}
+/**
+ * The lines of a stream's text (a trailing newline does not add an empty line).
+ *
+ * @param text - The text
+ * @returns The lines
+ */
+export function logLines(text) {
+    if (text === '')
+        return [];
+    const lines = text.split('\n');
+    if (lines[lines.length - 1] === '')
+        lines.pop();
+    return lines;
+}
+/**
+ * The number of lines in a stream's text, as {@link logLines} counts them,
+ * without splitting it (the Stderr tab's badge, every frame).
+ *
+ * @param text - The text
+ * @returns The line count
+ */
+export function countLines(text) {
+    if (text === '')
+        return 0;
+    let n = 0;
+    for (let i = text.indexOf('\n'); i !== -1; i = text.indexOf('\n', i + 1))
+        n++;
+    return text.endsWith('\n') ? n : n + 1;
+}
+/**
+ * The line indices containing `needle` (case-insensitive).
+ *
+ * @param lines - The lines
+ * @param needle - The search text
+ * @returns The matching line indices
+ */
+export function findInLines(lines, needle) {
+    const q = needle.toLowerCase();
+    if (q === '')
+        return [];
+    const out = [];
+    lines.forEach((line, i) => { if (line.toLowerCase().includes(q))
+        out.push(i); });
+    return out;
+}
+//# sourceMappingURL=logs.js.map

package/dist/tui/data/logs.js.map

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

package/dist/tui/input/commands.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The command grammar — `parseCommand(text)` for everything the command
+ * box accepts, `describe(cmd, ctx)` for the consequence line the box shows
+ * before Enter, and `hotkeyToCommand` for the keys that prefill a command.
+ *
+ * @packageDocumentation
+ */
+/** A parsed command. */
+export type ParsedCommand = {
+    name: 'task';
+    target: string;
+} | {
+    name: 'input';
+    target: string;
+} | {
+    name: 'dataset';
+    target: string;
+} | {
+    name: 'workspace';
+    target: string;
+} | {
+    name: 'workspaces';
+} | {
+    name: 'repos';
+} | {
+    name: 'repo';
+    target: string;
+} | {
+    name: 'login';
+    url: string;
+} | {
+    name: 'run';
+    force: boolean;
+    filter: string | undefined;
+    concurrency: number | undefined;
+} | {
+    name: 'stop';
+} | {
+    name: 'logs';
+    task: string;
+    stream: 'stdout' | 'stderr' | undefined;
+} | {
+    name: 'runs';
+    task: string;
+} | {
+    name: 'find';
+    query: string;
+} | {
+    name: 'goto';
+    target: {
+        kind: 'row';
+        row: number;
+    } | {
+        kind: 'percent';
+        percent: number;
+    };
+} | {
+    name: 'save';
+    file: string | undefined;
+    force: boolean;
+} | {
+    name: 'refresh';
+} | {
+    name: 'help';
+} | {
+    name: 'about';
+} | {
+    name: 'quit';
+    force: boolean;
+} | {
+    name: 'tag';
+    tag: string;
+} | {
+    name: 'add';
+    key: string | undefined;
+} | {
+    name: 'remove';
+    force: boolean;
+} | {
+    name: 'apply';
+} | {
+    name: 'discard';
+    then: string | undefined;
+} | {
+    name: 'reload';
+};
+export type CommandName = ParsedCommand['name'];
+/** A parse failure. */
+export interface ParseError {
+    error: string;
+}
+/** The result of {@link parseCommand}. */
+export type ParseResult = {
+    ok: true;
+    command: ParsedCommand;
+} | {
+    ok: false;
+    error: string;
+};
+/** Every command name, with its argument summary and one-line effect (the help view and completion). */
+export declare const COMMANDS: readonly {
+    name: CommandName;
+    usage: string;
+    effect: string;
+}[];
+/** Splits a command line into words, honouring double quotes. */
+export declare function splitWords(text: string): string[];
+/** Whether a word is one of the command names. */
+export declare function isCommandName(word: string): word is CommandName;
+/**
+ * Parses a command line (with or without the leading `/`).
+ *
+ * @param text - The text in the command box
+ * @returns The parsed command, or the error to show
+ */
+export declare function parseCommand(text: string): ParseResult;
+/** What {@link describe} needs to spell a consequence. */
+export interface DescribeContext {
+    /** The open workspace. */
+    workspace: string | null;
+    /** Tasks in the workspace. */
+    taskCount: number;
+    /** Whether a run is in progress. */
+    running: boolean;
+    /** The default concurrency. */
+    concurrency: number;
+    /** Pending edits. */
+    dirty: number;
+}
+/**
+ * The consequence line the command box shows for a parsed command
+ * (`run 6 tasks in main, ignoring the cache · concurrency 4`).
+ *
+ * @param command - The parsed command
+ * @param ctx - The context
+ * @returns The line, and the key hint (`⏎ run · esc`)
+ */
+export declare function describe(command: ParsedCommand, ctx: DescribeContext): {
+    text: string;
+    keys: string;
+};
+/**
+ * The command a single-key hotkey prefills (`r` → `/run `, `x` → `/stop`,
+ * `w` → `/workspaces`, `s` → `/save`, `t` → `/tag `).
+ *
+ * @param key - The key
+ * @returns The command text, or undefined
+ */
+export declare function hotkeyToCommand(key: string): string | undefined;
+/** The flags `/run` accepts and their one-line hints, for the hint bar. */
+export declare const RUN_FLAGS: readonly {
+    flag: string;
+    hint: string;
+}[];
+//# sourceMappingURL=commands.d.ts.map

package/dist/tui/input/commands.d.ts.map

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

package/dist/tui/input/commands.js

@@ -0,0 +1,259 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Every command name, with its argument summary and one-line effect (the help view and completion). */
+export const COMMANDS = [
+    { name: 'task', usage: '/task <name>', effect: 'open a task' },
+    { name: 'input', usage: '/input <name>', effect: 'open an input' },
+    { name: 'dataset', usage: '/dataset <path>', effect: 'open a dataset by path' },
+    { name: 'workspace', usage: '/workspace <name>', effect: 'switch workspace' },
+    { name: 'workspaces', usage: '/workspaces', effect: 'list the workspaces' },
+    { name: 'repos', usage: '/repos', effect: 'list the repositories' },
+    { name: 'repo', usage: '/repo <path|url>', effect: 'open another repo' },
+    { name: 'login', usage: '/login <url>', effect: 'device-flow login' },
+    { name: 'run', usage: '/run [--force] [--filter g]', effect: 'run the dataflow' },
+    { name: 'stop', usage: '/stop', effect: 'cancel the dataflow' },
+    { name: 'logs', usage: '/logs <task> [stderr]', effect: 'open a task\'s stdout / stderr' },
+    { name: 'runs', usage: '/runs <task>', effect: 'open a task\'s runs' },
+    { name: 'find', usage: '/find <key|prefix|f1|f2>', effect: 'jump to key' },
+    { name: 'goto', usage: '/goto <row|N%>', effect: 'jump to row' },
+    { name: 'save', usage: '/save [file]', effect: 'write .beast2 / .log' },
+    { name: 'tag', usage: '/tag <name>', effect: 'switch a variant tag' },
+    { name: 'add', usage: '/add [key]', effect: 'add an item / entry' },
+    { name: 'remove', usage: '/remove', effect: 'remove the item' },
+    { name: 'apply', usage: '/apply', effect: 'apply pending edits' },
+    { name: 'discard', usage: '/discard', effect: 'discard pending edits' },
+    { name: 'refresh', usage: '/refresh', effect: 'poll everything now' },
+    { name: 'help', usage: '/help', effect: 'this help' },
+    { name: 'about', usage: '/about', effect: 'version · server · logo' },
+    { name: 'quit', usage: '/quit', effect: 'exit' },
+];
+/** Splits a command line into words, honouring double quotes. */
+export function splitWords(text) {
+    const words = [];
+    let current = '';
+    let quoted = false;
+    let had = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '"') {
+            quoted = !quoted;
+            had = true;
+            continue;
+        }
+        if (!quoted && /\s/.test(ch)) {
+            if (current !== '' || had)
+                words.push(current);
+            current = '';
+            had = false;
+            continue;
+        }
+        current += ch;
+    }
+    if (current !== '' || had)
+        words.push(current);
+    return words;
+}
+/** Whether a word is one of the command names. */
+export function isCommandName(word) {
+    return COMMANDS.some(c => c.name === word);
+}
+/**
+ * Parses a command line (with or without the leading `/`).
+ *
+ * @param text - The text in the command box
+ * @returns The parsed command, or the error to show
+ */
+export function parseCommand(text) {
+    const trimmed = text.trim();
+    const body = trimmed.startsWith('/') ? trimmed.slice(1) : trimmed;
+    const words = splitWords(body);
+    const name = words[0] ?? '';
+    const args = words.slice(1);
+    const fail = (error) => ({ ok: false, error });
+    const need = (what) => fail(`${what} required — ${COMMANDS.find(c => c.name === name)?.usage ?? `/${name}`}`);
+    switch (name) {
+        case '':
+            return fail('type a command after /');
+        case 'task':
+        case 'input':
+        case 'dataset':
+        case 'workspace':
+        case 'repo': {
+            const target = args[0];
+            if (target === undefined)
+                return need(name === 'dataset' ? 'a path' : name === 'repo' ? 'a path or url' : 'a name');
+            return { ok: true, command: { name, target } };
+        }
+        case 'workspaces':
+        case 'repos':
+        case 'stop':
+        case 'refresh':
+        case 'help':
+        case 'about':
+        case 'apply':
+        case 'reload':
+            return { ok: true, command: { name } };
+        case 'discard':
+            return { ok: true, command: { name, then: args[0] === '--then' ? args.slice(1).join(' ') : undefined } };
+        case 'quit':
+            return { ok: true, command: { name, force: args.includes('--force') } };
+        case 'login': {
+            const url = args[0];
+            if (url === undefined)
+                return need('a server url');
+            if (!/^https?:\/\//.test(url))
+                return fail(`/login needs an http(s) url, got ${url}`);
+            return { ok: true, command: { name, url } };
+        }
+        case 'run': {
+            let force = false;
+            let filter;
+            let concurrency;
+            for (let i = 0; i < args.length; i++) {
+                const a = args[i];
+                if (a === '--force')
+                    force = true;
+                else if (a === '--filter') {
+                    filter = args[++i];
+                    if (filter === undefined)
+                        return fail('--filter needs a glob');
+                }
+                else if (a.startsWith('--filter='))
+                    filter = a.slice('--filter='.length);
+                else if (a === '--concurrency' || a.startsWith('--concurrency=')) {
+                    const raw = a === '--concurrency' ? args[++i] : a.slice('--concurrency='.length);
+                    const n = Number(raw);
+                    if (raw === undefined || !Number.isInteger(n) || n < 1)
+                        return fail(`--concurrency must be a positive integer, got ${raw ?? '(nothing)'}`);
+                    concurrency = n;
+                }
+                else
+                    return fail(`unknown /run flag ${a} — /run [--force] [--filter <glob>] [--concurrency <n>]`);
+            }
+            return { ok: true, command: { name, force, filter, concurrency } };
+        }
+        case 'logs': {
+            const task = args[0];
+            if (task === undefined)
+                return need('a task');
+            const stream = args[1];
+            if (stream !== undefined && stream !== 'stdout' && stream !== 'stderr')
+                return fail(`stream must be stdout or stderr, got ${stream}`);
+            return { ok: true, command: { name, task, stream } };
+        }
+        case 'runs': {
+            const task = args[0];
+            if (task === undefined)
+                return need('a task');
+            return { ok: true, command: { name, task } };
+        }
+        case 'find': {
+            const query = body.slice(body.indexOf('find') + 4).trim();
+            if (query === '')
+                return need('a key, prefix or f1|f2 fields');
+            return { ok: true, command: { name, query } };
+        }
+        case 'goto': {
+            const target = args[0];
+            if (target === undefined)
+                return need('a row or N%');
+            if (target.endsWith('%')) {
+                const percent = Number(target.slice(0, -1));
+                if (!Number.isFinite(percent) || percent < 0 || percent > 100)
+                    return fail(`/goto percent must be 0–100, got ${target}`);
+                return { ok: true, command: { name, target: { kind: 'percent', percent } } };
+            }
+            const row = Number(target.replace(/[,_]/g, ''));
+            if (!Number.isInteger(row) || row < 1)
+                return fail(`/goto needs a row number (1-based) or N%, got ${target}`);
+            return { ok: true, command: { name, target: { kind: 'row', row } } };
+        }
+        case 'save': {
+            const force = args.includes('--force');
+            const file = args.find(a => a !== '--force');
+            return { ok: true, command: { name, file, force } };
+        }
+        case 'tag': {
+            const tag = args[0];
+            if (tag === undefined)
+                return need('a tag');
+            return { ok: true, command: { name, tag } };
+        }
+        case 'add':
+            return { ok: true, command: { name, key: args[0] } };
+        case 'remove':
+            return { ok: true, command: { name, force: args.includes('--force') } };
+        default:
+            return fail(`unknown command /${name} — ? for help`);
+    }
+}
+/**
+ * The consequence line the command box shows for a parsed command
+ * (`run 6 tasks in main, ignoring the cache · concurrency 4`).
+ *
+ * @param command - The parsed command
+ * @param ctx - The context
+ * @returns The line, and the key hint (`⏎ run · esc`)
+ */
+export function describe(command, ctx) {
+    const ws = ctx.workspace ?? '?';
+    switch (command.name) {
+        case 'run': {
+            const scope = command.filter !== undefined ? `tasks matching ${command.filter}` : `${ctx.taskCount} task${ctx.taskCount === 1 ? '' : 's'}`;
+            const cache = command.force ? ', ignoring the cache' : '';
+            const conc = command.concurrency ?? ctx.concurrency;
+            return { text: ctx.running ? 'a run is already in progress' : `run ${scope} in ${ws}${cache} · concurrency ${conc}`, keys: ctx.running ? 'esc' : '⏎ run · esc' };
+        }
+        case 'stop':
+            return { text: ctx.running ? `cancel the run in ${ws}` : 'no run in progress', keys: ctx.running ? '⏎ stop · esc' : 'esc' };
+        case 'task': return { text: `open task ${command.target}`, keys: '⏎ open · esc' };
+        case 'input': return { text: `open input ${command.target}`, keys: '⏎ open · esc' };
+        case 'dataset': return { text: `open dataset ${command.target}`, keys: '⏎ open · esc' };
+        case 'workspace': return { text: `switch to workspace ${command.target}`, keys: '⏎ switch · esc' };
+        case 'workspaces': return { text: 'list the workspaces', keys: '⏎ · esc' };
+        case 'repos': return { text: 'list the repositories', keys: '⏎ · esc' };
+        case 'repo': return { text: `open ${command.target}${ctx.dirty > 0 ? ` · ${ctx.dirty} unsaved edits are discarded` : ''}`, keys: '⏎ open · esc' };
+        case 'login': return { text: 'run the device-flow login', keys: '⏎ login · esc' };
+        case 'logs': return { text: `open ${command.task} ${command.stream ?? 'stdout'}`, keys: '⏎ open · esc' };
+        case 'runs': return { text: `open ${command.task} runs`, keys: '⏎ open · esc' };
+        case 'find': return { text: `find ${command.query}`, keys: '⏎ jump · esc' };
+        case 'goto': return { text: command.target.kind === 'row' ? `go to row ${command.target.row.toLocaleString()}` : `go to ${command.target.percent}%`, keys: '⏎ jump · esc' };
+        case 'save': return { text: `save${command.file !== undefined ? ` to ${command.file}` : ''}${command.force ? ' (overwrite)' : ''}`, keys: '⏎ save · esc' };
+        case 'refresh': return { text: 'poll every feed now', keys: '⏎ · esc' };
+        case 'help': return { text: 'open help', keys: '⏎ · esc' };
+        case 'about': return { text: 'about e3-ui', keys: '⏎ · esc' };
+        case 'quit': return { text: ctx.dirty > 0 && !command.force ? `quit with ${ctx.dirty} unsaved edit${ctx.dirty === 1 ? '' : 's'}` : 'quit', keys: '⏎ quit · esc' };
+        case 'tag': return { text: `switch to ${command.tag}`, keys: '⏎ · esc' };
+        case 'add': return { text: command.key !== undefined ? `add entry ${command.key}` : 'add an item', keys: '⏎ add · esc' };
+        case 'remove': return { text: 'remove the selected item', keys: '⏎ remove · esc' };
+        case 'apply': return { text: `apply ${ctx.dirty} pending edit${ctx.dirty === 1 ? '' : 's'}`, keys: '⏎ apply · esc' };
+        case 'discard': return { text: `discard ${ctx.dirty} pending edit${ctx.dirty === 1 ? '' : 's'}${command.then !== undefined ? ` then ${command.then}` : ''}`, keys: '⏎ discard · esc' };
+        case 'reload': return { text: 'reload the value and re-apply your edits', keys: '⏎ reload · esc' };
+    }
+}
+/**
+ * The command a single-key hotkey prefills (`r` → `/run `, `x` → `/stop`,
+ * `w` → `/workspaces`, `s` → `/save`, `t` → `/tag `).
+ *
+ * @param key - The key
+ * @returns The command text, or undefined
+ */
+export function hotkeyToCommand(key) {
+    switch (key) {
+        case 'r': return '/run ';
+        case 'x': return '/stop';
+        case 'w': return '/workspaces';
+        case 's': return '/save';
+        case 't': return '/tag ';
+        default: return undefined;
+    }
+}
+/** The flags `/run` accepts and their one-line hints, for the hint bar. */
+export const RUN_FLAGS = [
+    { flag: '--force', hint: 're-run everything' },
+    { flag: '--filter <glob>', hint: 'only matching tasks' },
+    { flag: '--concurrency <n>', hint: '' },
+];
+//# sourceMappingURL=commands.js.map

package/dist/tui/input/commands.js.map

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

package/dist/tui/input/completion.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Completion — `complete(text, catalogue)` turns what is typed in the
+ * command box into at most eight fuzzy-ranked candidates, each carrying its
+ * status, type and size so the list doubles as a status line. A leading `/`
+ * completes command names, then that command's arguments; anything else is
+ * a fuzzy jump across every workspace, task, input and dataset of the open
+ * repository.
+ *
+ * @packageDocumentation
+ */
+import type { Candidate } from '../state/actions.js';
+/** Candidates shown at most. */
+export declare const MAX_CANDIDATES = 8;
+/** One thing that can be jumped to or named in a command. */
+export interface CatalogueItem {
+    kind: 'task' | 'input' | 'dataset' | 'workspace' | 'repo';
+    name: string;
+    /** The workspace the item belongs to (tasks, inputs, datasets). */
+    workspace: string | null;
+    /** The status column (`● up-to-date`). */
+    status: string;
+    /** The type column (`Dict<String, Struct>`). */
+    type: string;
+    /** The detail column (`84.2 MB · 38.4s`). */
+    detail: string;
+}
+/** What completion draws from. */
+export interface Catalogue {
+    items: CatalogueItem[];
+    /** Variant tags offered by `/tag` on the selected row, if any. */
+    tags?: string[] | undefined;
+}
+/**
+ * Fuzzy match score — higher is better, `null` when `pattern` is not a
+ * subsequence of `text`. Prefix and word-start matches rank first, then
+ * contiguous runs; shorter texts win ties.
+ *
+ * @param pattern - What was typed (case-insensitive)
+ * @param text - The candidate
+ * @returns The score, or null
+ */
+export declare function fuzzyScore(pattern: string, text: string): number | null;
+/**
+ * Completes the command box.
+ *
+ * @param text - The text in the box
+ * @param catalogue - The workspace catalogue
+ * @returns At most {@link MAX_CANDIDATES} candidates, best first (empty when nothing applies)
+ */
+export declare function complete(text: string, catalogue: Catalogue): Candidate[];
+/**
+ * The fuzzy jump across everything in the catalogue.
+ *
+ * @param text - What was typed (no leading `/`)
+ * @param catalogue - The workspace catalogue
+ * @returns At most {@link MAX_CANDIDATES} candidates
+ */
+export declare function jump(text: string, catalogue: Catalogue): Candidate[];
+//# sourceMappingURL=completion.d.ts.map