@stratusagent/cli 0.11.2 → 0.11.4

package/dist/prompter.js

@@ -0,0 +1,347 @@
+import { createInterface } from 'node:readline';
+import { writeLine } from "./io.js";
+import { CLI_VERSION } from "./npm.js";
+/**
+ * Whether a string is a specifier npm would install — and therefore one
+ * safe to hand a shell.
+ *
+ * npm's own name grammar, which is far narrower than anything a shell
+ * treats as special: an optional `@scope/`, then lowercase alphanumerics
+ * with `-`, `_` and `.`, no leading `.` or `_`, 214 characters at most,
+ * and an optional `@version` of the same restricted alphabet. Nothing that
+ * matches contains a space, a quote, or a metacharacter — not `&`, not
+ * `|`, not `` ` ``, and not cmd.exe's `^` — so the fence and the
+ * correctness check are one check.
+ *
+ * The version half is deliberately not npm's full range syntax: `^1.0.0`
+ * is a valid range and `^` is cmd.exe's escape character. Only the plain
+ * forms this CLI actually passes are accepted, and a range that needs more
+ * is a thing to install by hand.
+ *
+ * A config key that fails this was never installable, so refusing costs no
+ * capability: `npm install -g 'pkg & whoami'` is not a thing that works
+ * and quietly becomes a thing that runs.
+ */
+/**
+ * The columns `selectInteractive` spends before an option's own text.
+ *
+ * Two for the selection marker, then `${n}) ` — so it grows with the option
+ * *count*, since every row is fitted to the widest prefix any row will
+ * have. A menu whose length a config decides therefore cannot reserve a
+ * constant: five first-party plugins plus five from a `plugins` block is
+ * ten rows, and `  10) ` is a column wider than `  1) `.
+ *
+ * The extra column is a deliberate spare. `fitMenuRow` trims to exactly its
+ * budget, and a row that fills the last column wraps on terminals that
+ * advance the cursor eagerly — which costs a whole redraw, since the rewind
+ * counts options rather than rendered rows.
+ */
+export const menuPrefixWidth = (optionCount) => `  ${optionCount}) `.length + 1;
+// Printed commands must survive copy-paste into a shell, so anything outside
+// the safe character set gets single-quoted.
+export const quoteShellArg = (value) => /^[A-Za-z0-9_@%+=:,./-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`;
+// The fixed header drawn at the top of every interactive screen.
+export const stratusHeaderLines = () => {
+    const title = 'Stratus Agent';
+    const version = `v${CLI_VERSION}`;
+    const gap = '   ';
+    const content = `  ${title}${gap}${version}  `;
+    return [
+        `\u001b[2m╭${'─'.repeat(content.length)}╮\u001b[0m`,
+        `\u001b[2m│\u001b[0m  \u001b[1m${title}\u001b[0m${gap}\u001b[2m${version}\u001b[0m  \u001b[2m│\u001b[0m`,
+        `\u001b[2m╰${'─'.repeat(content.length)}╯\u001b[0m`,
+    ];
+};
+export const createSetupPrompter = (streams, env, view) => {
+    // On a real TTY, menus are arrow-key driven and secrets are read without
+    // echo; with piped input (tests, scripts) everything is plain lines.
+    const interactive = env.setupInput === undefined && process.stdin.isTTY === true;
+    if (interactive) {
+        let closed = false;
+        process.stdin.once('end', () => {
+            closed = true;
+        });
+        const question = (prompt, secret, prefill) => {
+            const readline = createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+            if (secret) {
+                const internal = readline;
+                const original = internal._writeToOutput?.bind(readline);
+                internal._writeToOutput = (chunk) => {
+                    // Echo the prompt itself, swallow the typed secret.
+                    if (chunk.startsWith(prompt)) {
+                        original?.(prompt);
+                    }
+                };
+            }
+            return new Promise((resolve) => {
+                readline.on('SIGINT', () => {
+                    readline.close();
+                    streams.stdout.write('\n');
+                    process.exit(130);
+                });
+                readline.question(prompt, (answer) => {
+                    readline.close();
+                    if (secret) {
+                        streams.stdout.write('\n');
+                    }
+                    resolve(answer.trim());
+                });
+                if (prefill) {
+                    // Pre-typed and editable: backspace over it or press Enter to keep.
+                    readline.write(prefill);
+                }
+            });
+        };
+        // Each menu replaces the screen: clear, draw the header, carry over the
+        // most recent status lines, then the menu itself.
+        const drawScreen = (out) => {
+            out.write('\u001b[2J\u001b[H');
+            for (const line of view?.header() ?? []) {
+                out.write(`${line}\n`);
+            }
+            const notices = view?.consumeNotices() ?? [];
+            if (notices.length > 0) {
+                for (const line of notices) {
+                    out.write(`\u001b[2m${line}\u001b[0m\n`);
+                }
+                out.write('\n');
+            }
+        };
+        const selectInteractive = (heading, options, opts) => new Promise((resolve) => {
+            const stdin = process.stdin;
+            const out = streams.stdout;
+            let index = Math.min(Math.max(opts.defaultIndex ?? 0, 0), options.length - 1);
+            const wasRaw = stdin.isRaw === true;
+            stdin.setRawMode?.(true);
+            stdin.resume();
+            const render = (redraw) => {
+                if (redraw) {
+                    out.write(`\u001b[${options.length}A`);
+                }
+                else {
+                    drawScreen(out);
+                    if (heading.length > 0) {
+                        out.write(`${heading}\n`);
+                    }
+                    if (opts.footnote) {
+                        out.write(`${opts.footnote}\n`);
+                    }
+                }
+                options.forEach((option, i) => {
+                    const active = i === index;
+                    out.write(`\u001b[2K\r${active ? '\u001b[36m\u276f ' : '  '}${i + 1}) ${option}${active ? '\u001b[0m' : ''}\n`);
+                });
+            };
+            const finish = (answer) => {
+                if (pendingTimer !== undefined) {
+                    clearTimeout(pendingTimer);
+                    pendingTimer = undefined;
+                }
+                stdin.off('data', onData);
+                if (!wasRaw) {
+                    stdin.setRawMode?.(false);
+                }
+                // Pause so keys typed between menus buffer for the next consumer
+                // instead of being dropped by a flowing stream with no listener.
+                stdin.pause();
+                if (pendingEscape.length > 0) {
+                    stdin.unshift(Buffer.from(pendingEscape, 'utf8'));
+                    pendingEscape = '';
+                }
+                resolve(answer);
+            };
+            const handleKey = (key) => {
+                if (key === '\u0003') {
+                    // Ctrl-C: restore the terminal and leave setup entirely.
+                    stdin.setRawMode?.(false);
+                    out.write('\n');
+                    process.exit(130);
+                }
+                if (key === '\u001b[A' || key === '\u001bOA' || key === 'k') {
+                    index = (index - 1 + options.length) % options.length;
+                    render(true);
+                    return false;
+                }
+                if (key === '\u001b[B' || key === '\u001bOB' || key === 'j' || key === '\t') {
+                    index = (index + 1) % options.length;
+                    render(true);
+                    return false;
+                }
+                if (key === '\r' || key === '\n') {
+                    finish({ kind: 'index', index });
+                    return true;
+                }
+                if (key === '\u001b' || key === 'q') {
+                    finish({ kind: 'back' });
+                    return true;
+                }
+                if (/^[1-9]$/.test(key)) {
+                    const jump = Number(key) - 1;
+                    if (jump < options.length) {
+                        index = jump;
+                        render(true);
+                        finish({ kind: 'index', index });
+                        return true;
+                    }
+                }
+                return false;
+            };
+            // Key repeat and pasted input arrive as one chunk containing several
+            // sequences — split it into individual keys before handling. Bytes
+            // that follow the selecting key (e.g. a pasted "2sk-ant-…") are
+            // pushed back onto stdin for whatever prompt comes next. Terminals
+            // and SSH can also split an escape sequence ACROSS chunks (ESC, then
+            // "[A"), so an incomplete escape tail is held briefly: completed by
+            // the next chunk, or treated as a real Esc press after a beat.
+            let pendingEscape = '';
+            let pendingTimer;
+            const processText = (text) => {
+                let position = 0;
+                while (position < text.length) {
+                    const remaining = text.length - position;
+                    if (text[position] === '\u001b' && remaining < 3
+                        && (remaining === 1 || text[position + 1] === '[' || text[position + 1] === 'O')) {
+                        pendingEscape = text.slice(position);
+                        pendingTimer = setTimeout(() => {
+                            // No continuation arrived: it was a genuine Esc press.
+                            pendingEscape = '';
+                            pendingTimer = undefined;
+                            handleKey('\u001b');
+                        }, 75);
+                        return;
+                    }
+                    let key;
+                    if (text[position] === '\u001b' && (text[position + 1] === '[' || text[position + 1] === 'O')) {
+                        key = text.slice(position, position + 3);
+                        position += 3;
+                    }
+                    else {
+                        key = text[position];
+                        position += 1;
+                    }
+                    if (handleKey(key)) {
+                        const rest = text.slice(position);
+                        if (rest.length > 0) {
+                            stdin.unshift(Buffer.from(rest, 'utf8'));
+                        }
+                        return;
+                    }
+                }
+            };
+            const onData = (chunk) => {
+                if (pendingTimer !== undefined) {
+                    clearTimeout(pendingTimer);
+                    pendingTimer = undefined;
+                }
+                const text = pendingEscape + chunk.toString('utf8');
+                pendingEscape = '';
+                processText(text);
+            };
+            render(false);
+            stdin.on('data', onData);
+        });
+        return {
+            ask: (q, opts) => question(q, false, opts?.prefill),
+            askSecret: (q) => question(q, true),
+            isInteractive: () => true,
+            async select(heading, options, opts = {}) {
+                if (options.length === 0) {
+                    return { kind: 'back' };
+                }
+                return selectInteractive(heading, options, opts);
+            },
+            isClosed: () => closed,
+            close: () => {
+                // A resumed raw-mode stdin keeps the event loop alive; release it
+                // so the process can exit once setup returns.
+                process.stdin.setRawMode?.(false);
+                process.stdin.pause();
+            },
+        };
+    }
+    const input = env.setupInput ?? process.stdin;
+    const readline = createInterface({ input, terminal: false });
+    const pendingLines = [];
+    let closed = false;
+    readline.on('line', (line) => {
+        pendingLines.push(line);
+    });
+    readline.once('close', () => {
+        closed = true;
+    });
+    const nextLine = async () => {
+        while (pendingLines.length === 0) {
+            if (closed) {
+                return '';
+            }
+            await new Promise((resolve) => {
+                readline.once('line', () => resolve());
+                readline.once('close', () => resolve());
+            });
+        }
+        return (pendingLines.shift() ?? '').trim();
+    };
+    const selectPlain = async (heading, options, opts) => {
+        const defaultIndex = Math.min(Math.max(opts.defaultIndex ?? 0, 0), options.length - 1);
+        while (true) {
+            streams.stdout.write(`${heading}\n`);
+            if (opts.footnote) {
+                streams.stdout.write(`${opts.footnote}\n`);
+            }
+            for (const [i, option] of options.entries()) {
+                streams.stdout.write(`  ${i + 1}) ${option}\n`);
+            }
+            streams.stdout.write(`Choose [${defaultIndex + 1}]: `);
+            const line = await nextLine();
+            if (line === '') {
+                if (closed && pendingLines.length === 0) {
+                    return { kind: 'back' };
+                }
+                return { kind: 'index', index: defaultIndex };
+            }
+            if (/^\d+$/.test(line)) {
+                const picked = Number(line) - 1;
+                if (picked >= 0 && picked < options.length) {
+                    return { kind: 'index', index: picked };
+                }
+                writeLine(streams.stdout, `Pick a number between 1 and ${options.length}.`);
+                continue;
+            }
+            if (/^(back|b|q(uit)?)$/i.test(line)) {
+                return { kind: 'back' };
+            }
+            if (opts.allowText) {
+                return { kind: 'text', text: line };
+            }
+            const matched = options.findIndex((option) => option.toLowerCase().includes(line.toLowerCase()));
+            if (matched !== -1) {
+                return { kind: 'index', index: matched };
+            }
+            writeLine(streams.stdout, `Pick a number between 1 and ${options.length}.`);
+        }
+    };
+    return {
+        async ask(q, opts) {
+            streams.stdout.write(q);
+            const line = await nextLine();
+            return line || (opts?.prefill ?? '');
+        },
+        async askSecret(q) {
+            // Piped input never echoes, so plain reads are safe here.
+            streams.stdout.write(q);
+            return nextLine();
+        },
+        isInteractive: () => false,
+        async select(heading, options, opts = {}) {
+            if (options.length === 0) {
+                return { kind: 'back' };
+            }
+            return selectPlain(heading, options, opts);
+        },
+        isClosed: () => closed && pendingLines.length === 0,
+        close: () => {
+            readline.close();
+        },
+    };
+};
+//# sourceMappingURL=prompter.js.map

package/dist/prompter.js.map

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

package/dist/roster.d.ts

@@ -0,0 +1,57 @@
+import { loadRosterSouls } from '@stratusagent/state';
+import type { CliEnvironment } from './environment.ts';
+/**
+ * npm's package-name grammar, and nothing else: an optional `@scope/`, then
+ * lowercase alphanumerics with `-`, `_` and `.`, no leading `.` or `_`, 214
+ * characters at most.
+ *
+ * This is what a `plugins` config key has to be, because that key is *also*
+ * the module specifier the loader hands `import.meta.resolve`. A version
+ * suffix is a thing npm installs and Node cannot resolve, so a key carrying
+ * one names a plugin that is permanently absent however many times it is
+ * installed.
+ */
+/**
+ * Whether one soul's allowlist reaches a tool a plugin contributes.
+ *
+ * The second gate, in the form both surfaces need it: `stratus plugins`
+ * asks it per tool to build the who-can-call-what table, and the setup
+ * menu asks it per agent to say what enabling just granted. An omitted
+ * list is every registered tool; a *declared namespace* is matched by
+ * overlap rather than by prefix, since `mcp.linear.*` sits under a granted
+ * `mcp.*` and neither is the other's prefix.
+ *
+ * Shared rather than written twice, and this is the fifth time on this
+ * change that mattered: a menu that answers "who can call it" differently
+ * from the command that reports it is two answers to one question.
+ */
+export declare const soulGrantsTool: (tools: readonly string[] | undefined, name: string, discovered: boolean) => boolean;
+/**
+ * The souls skill enablement is judged against: the agents directory plus
+ * the configured default soul (config `soul:` / STRATUS_SOUL), which may
+ * live outside it and is served all the same. The daemon's roster and
+ * `stratus agents` both include it, so `skill add --agent` and `stratus
+ * skills` must not answer from a narrower set.
+ */
+export declare const rosterSoulsWithConfigured: (env: CliEnvironment, warn: (line: string) => void, options?: {
+    /**
+     * The config whose `soul` key names the configured agent. A caller
+     * reading everything else from `--config` and this from the default
+     * file would answer for a roster the daemon it describes does not
+     * serve.
+     */
+    configPath?: string;
+    /**
+     * Seed the reserved built-in agent, the way `loadRoster` does. It has
+     * no `tools:` key, so it is granted every registered tool — and on a
+     * fresh install it is the only agent there is, which made "granted to
+     * nobody" exactly backwards for the most common configuration of all.
+     * Off by default: a caller reporting on souls should not have one
+     * appear that has no file.
+     */
+    includeBuiltIn?: boolean;
+}) => Promise<{
+    entries: Awaited<ReturnType<typeof loadRosterSouls>>;
+    complete: boolean;
+}>;
+//# sourceMappingURL=roster.d.ts.map

package/dist/roster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,eAAe,EAAyB,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,SAAS,MAAM,EAAE,GAAG,SAAS,EACpC,MAAM,MAAM,EACZ,YAAY,OAAO,KAClB,OAOF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,KAAK,cAAc,EACnB,MAAM,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC5B,UAAS;IACP;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACrB,KACL,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAgCrF,CAAC"}

package/dist/roster.js

@@ -0,0 +1,78 @@
+import { matchesToolAllowlist, toolScopesOverlap } from '@stratusagent/core';
+import { DEFAULT_STRATUS_AGENT, loadRosterSouls, resolveConfiguredSoul } from '@stratusagent/state';
+/**
+ * npm's package-name grammar, and nothing else: an optional `@scope/`, then
+ * lowercase alphanumerics with `-`, `_` and `.`, no leading `.` or `_`, 214
+ * characters at most.
+ *
+ * This is what a `plugins` config key has to be, because that key is *also*
+ * the module specifier the loader hands `import.meta.resolve`. A version
+ * suffix is a thing npm installs and Node cannot resolve, so a key carrying
+ * one names a plugin that is permanently absent however many times it is
+ * installed.
+ */
+/**
+ * Whether one soul's allowlist reaches a tool a plugin contributes.
+ *
+ * The second gate, in the form both surfaces need it: `stratus plugins`
+ * asks it per tool to build the who-can-call-what table, and the setup
+ * menu asks it per agent to say what enabling just granted. An omitted
+ * list is every registered tool; a *declared namespace* is matched by
+ * overlap rather than by prefix, since `mcp.linear.*` sits under a granted
+ * `mcp.*` and neither is the other's prefix.
+ *
+ * Shared rather than written twice, and this is the fifth time on this
+ * change that mattered: a menu that answers "who can call it" differently
+ * from the command that reports it is two answers to one question.
+ */
+export const soulGrantsTool = (tools, name, discovered) => {
+    if (tools === undefined) {
+        return true;
+    }
+    return discovered
+        ? tools.some((granted) => toolScopesOverlap(granted, name))
+        : matchesToolAllowlist(name, tools);
+};
+/**
+ * The souls skill enablement is judged against: the agents directory plus
+ * the configured default soul (config `soul:` / STRATUS_SOUL), which may
+ * live outside it and is served all the same. The daemon's roster and
+ * `stratus agents` both include it, so `skill add --agent` and `stratus
+ * skills` must not answer from a narrower set.
+ */
+export const rosterSoulsWithConfigured = async (env, warn, options = {}) => {
+    const { configPath, includeBuiltIn = false } = options;
+    // Before the roster, exactly as the gateway registers it: a roster file
+    // claiming the reserved id is dropped by `loadRosterSouls`, and only the
+    // configured default soul may take it over — which the replace below
+    // does on id, so nothing extra is needed for that case.
+    const entries = includeBuiltIn
+        ? [{ soul: { agent: { ...DEFAULT_STRATUS_AGENT } } },
+            ...await loadRosterSouls(env, warn)]
+        : await loadRosterSouls(env, warn);
+    let complete = true;
+    try {
+        const configured = await resolveConfiguredSoul(configPath !== undefined ? { configPath } : {}, env);
+        if (configured) {
+            const entry = { soul: configured.soul, path: configured.path };
+            const clash = entries.findIndex((candidate) => candidate.soul.agent.id === configured.soul.agent.id);
+            // Replaced, not skipped: a roster file claiming the configured
+            // soul's id is the one the gateway stops serving — both commands
+            // must answer for the soul a dispatch actually runs.
+            if (clash >= 0) {
+                entries[clash] = entry;
+            }
+            else {
+                entries.push(entry);
+            }
+        }
+    }
+    catch (error) {
+        // The configured agent's allowlist was not read, so the set is not
+        // the roster — callers making enablement claims must withhold them.
+        complete = false;
+        warn(`could not read the configured soul: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return { entries, complete };
+};
+//# sourceMappingURL=roster.js.map

package/dist/roster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster.js","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGpG;;;;;;;;;;GAUG;AACH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAoC,EACpC,IAAY,EACZ,UAAmB,EACV,EAAE;IACX,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,UAAU;QACf,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAC5C,GAAmB,EACnB,IAA4B,EAC5B,UAiBI,EAAE,EACgF,EAAE;IACxF,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACvD,wEAAwE;IACxE,yEAAyE;IACzE,qEAAqE;IACrE,wDAAwD;IACxD,MAAM,OAAO,GAAG,cAAc;QAC5B,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,qBAAqB,EAAE,EAAE,EAAyD;YACzG,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACpG,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrG,+DAA+D;YAC/D,iEAAiE;YACjE,qDAAqD;YACrD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mEAAmE;QACnE,oEAAoE;QACpE,QAAQ,GAAG,KAAK,CAAC;QACjB,IAAI,CAAC,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,76 @@
+import { AgentRunner, type AgentDefinition, type JsonObject, type Session, type StratusEvent } from '@stratusagent/core';
+import { type RuntimeSelection, type RuntimeConfig, type IgnoredUntrustedConfig } from '@stratusagent/state';
+import type { CliStreams, CliEnvironment } from './environment.ts';
+import type { CliApprovalMode, ParsedRunCommand } from './parse.ts';
+/**
+ * Kept with its historical CLI signature: a parsed run command is a
+ * RuntimeSelection plus CLI-only fields the resolver ignores.
+ *
+ * Those fields are *permitted*, not required. Demanding a whole
+ * `ParsedRunCommand` made the type claim the resolver cared about
+ * `approvals`, `format`, and `events` — it reads none of them — so every
+ * caller with a selection in hand had to invent values to get past it.
+ */
+export declare const resolveRuntimeConfig: (command: RuntimeSelection & Partial<Omit<ParsedRunCommand, keyof RuntimeSelection>>, env?: CliEnvironment) => Promise<RuntimeConfig>;
+/**
+ * Says, once the run is up, what an auto-discovered project config asked
+ * for and did not get. The resolver only records it — nothing is logging
+ * while a run resolves — and a persona that silently failed to apply would
+ * read as the agent ignoring its instructions rather than as the trust
+ * decision it is.
+ */
+export declare const warnOnUntrustedConfig: (runtime: RuntimeConfig, streams: CliStreams, soulFlag?: boolean) => void;
+/**
+ * The way out of a refused persona, as one sentence. `--config` trusts the
+ * file; the other way is the operator's own channel for the key — the
+ * `--soul` flag where the command takes one (`run` and `chat`; `serve` and
+ * `doctor` do not, and a notice sending the operator to a flag the daemon
+ * refuses is a notice that cost a restart), the environment otherwise.
+ * Never "move the key to ~/.stratus/config.json": the project file that
+ * caused this shadows the global one in discovery, so a key moved there
+ * would go on being unset for every run started here.
+ */
+export declare const ignoredConfigRemedy: (ignored: IgnoredUntrustedConfig, soulFlag: boolean) => string;
+/** `soulFlag`: whether the command printing this takes `--soul` — see {@link ignoredConfigRemedy}. */
+export declare const warnOnIgnoredConfig: (ignored: IgnoredUntrustedConfig | undefined, streams: CliStreams, soulFlag?: boolean) => void;
+/**
+ * A saved subscription sign-in silently demoted to per-token billing is the
+ * one config surprise that costs money — an API key in the environment
+ * outranks the stored credential, and the run otherwise looks identical.
+ * Detected from the resolved config: an apiKey where the stored credential
+ * is a subscription token means the environment won.
+ */
+export declare const warnOnCredentialOverride: (runtime: RuntimeConfig, streams: CliStreams, env?: CliEnvironment) => Promise<void>;
+export declare const createAgentRuntime: (streams: CliStreams, options: {
+    events?: boolean;
+    /** Replaces the default event printer when provided. */
+    onEvent?: (event: StratusEvent) => void;
+    /** Answers --approvals ask questions when the caller owns stdin. */
+    askApproval?: (prompt: string) => Promise<string>;
+    runtime: RuntimeConfig;
+    approvals?: CliApprovalMode;
+    /** The mode came from `defaultApprovalMode`, not from a flag. */
+    approvalsDefaulted?: boolean;
+    maxTurns?: number;
+    env?: CliEnvironment;
+    /** The config this command was pinned to, for reading its `plugins` block. */
+    configPath?: string;
+}) => Promise<{
+    runner: AgentRunner;
+    agent: AgentDefinition;
+    metadata: JsonObject;
+    disposePlugins: () => Promise<void>;
+}>;
+export declare const runSingleLoop: (prompt: string, streams: CliStreams, options: {
+    events?: boolean;
+    runtime: RuntimeConfig;
+    approvals?: CliApprovalMode;
+    /** The mode came from `defaultApprovalMode`, not from a flag. */
+    approvalsDefaulted?: boolean;
+    maxTurns?: number;
+    env?: CliEnvironment;
+    configPath?: string;
+}) => Promise<Session>;
+export declare const printSessionSummary: (session: Session, streams: CliStreams) => void;
+export declare const formatRuntimeBanner: (runtime: RuntimeConfig) => string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EASX,KAAK,eAAe,EAIpB,KAAK,UAAU,EAIf,KAAK,OAAO,EACZ,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAmBL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAInE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGpE;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,gBAAgB,CAAC,CAAC,EACnF,MAAK,cAAmB,KACvB,OAAO,CAAC,aAAa,CAA4C,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,aAAa,EAAE,SAAS,UAAU,EAAE,kBAAe,KAAG,IAEpG,CAAC;AAQF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,sBAAsB,EAAE,UAAU,OAAO,KAAG,MAUxF,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,mBAAmB,GAC9B,SAAS,sBAAsB,GAAG,SAAS,EAC3C,SAAS,UAAU,EACnB,kBAAe,KACd,IAUF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,aAAa,EACtB,SAAS,UAAU,EACnB,MAAK,cAAmB,KACvB,OAAO,CAAC,IAAI,CA2Cd,CAAC;AAMF,eAAO,MAAM,kBAAkB,GAC7B,SAAS,UAAU,EACnB,SAAS;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,oEAAoE;IACpE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;;;;0BA2FgC,OAAO,CAAC,IAAI,CAAC;EA6J/C,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,SAAS,UAAU,EACnB,SAAS;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,KACA,OAAO,CAAC,OAAO,CAcjB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,SAAS,OAAO,EAAE,SAAS,UAAU,KAAG,IAsB3E,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,SAAS,aAAa,KAAG,MAS5D,CAAC"}