@stratusagent/cli 0.11.2 → 0.11.4

package/dist/npm.js

@@ -0,0 +1,201 @@
+/** How long `stratus update` waits for npm to answer a version lookup. */
+export const VERSION_LOOKUP_TIMEOUT_MS = 15_000;
+export const defaultPackageVersionFetcher = async (packageName) => {
+    const { spawn } = await import('node:child_process');
+    return new Promise((resolve) => {
+        const child = spawn('npm', ['view', packageName, 'version'], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: npmNeedsShell(process.platform),
+        });
+        let stdout = '';
+        let settled = false;
+        const finish = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            resolve(value);
+        };
+        // An unreachable registry must degrade to "unknown", never hang the
+        // update on someone's terminal.
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            finish(undefined);
+        }, VERSION_LOOKUP_TIMEOUT_MS);
+        timer.unref?.();
+        child.stdout?.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
+        child.once('error', () => finish(undefined));
+        child.once('close', (code) => finish(code === 0 && stdout.trim().length > 0 ? stdout.trim() : undefined));
+    });
+};
+/**
+ * Dotted-numeric comparison with SemVer's prerelease precedence, enough for
+ * this package's own versions: positive when `a` is newer than `b`.
+ * Anything unparseable in a segment counts as zero rather than throwing — a
+ * weird registry answer must not crash the update that would fix things.
+ *
+ * The prerelease half is not decoration. Split on dots alone, `0.11.2-beta.1`
+ * parses as a *fourth* numeric segment and so reads as newer than the stable
+ * `0.11.2` that supersedes it — which left a prerelease companion behind and
+ * stopped a prerelease CLI from ever seeing the stable release as an upgrade.
+ * SemVer's rule is the opposite and is the one applied here: a version
+ * carrying a prerelease is lower than the same version without one, and two
+ * prereleases compare identifier by identifier, numeric ones numerically and
+ * below alphanumeric ones.
+ */
+export const compareVersions = (a, b) => {
+    const numeric = (part) => {
+        const value = Number.parseInt(part, 10);
+        return Number.isInteger(value) ? value : 0;
+    };
+    const split = (value) => {
+        // Build metadata never affects precedence, and is dropped before the
+        // prerelease is found so a `+` cannot be mistaken for part of one.
+        const plain = (value.trim().replace(/^v/, '').split('+', 1)[0] ?? '');
+        const dash = plain.indexOf('-');
+        return {
+            core: (dash === -1 ? plain : plain.slice(0, dash)).split('.').map(numeric),
+            pre: dash === -1 ? [] : plain.slice(dash + 1).split('.').filter((part) => part.length > 0),
+        };
+    };
+    const left = split(a);
+    const right = split(b);
+    for (let index = 0; index < Math.max(left.core.length, right.core.length); index += 1) {
+        const difference = (left.core[index] ?? 0) - (right.core[index] ?? 0);
+        if (difference !== 0) {
+            return difference;
+        }
+    }
+    // Same release: the one without a prerelease is the released one.
+    if (left.pre.length === 0 || right.pre.length === 0) {
+        return right.pre.length - left.pre.length;
+    }
+    for (let index = 0; index < Math.max(left.pre.length, right.pre.length); index += 1) {
+        const one = left.pre[index];
+        const other = right.pre[index];
+        // A prerelease that runs out of identifiers first is the lower one:
+        // `1.0.0-beta` precedes `1.0.0-beta.1`.
+        if (one === undefined || other === undefined) {
+            return (one === undefined ? 0 : 1) - (other === undefined ? 0 : 1);
+        }
+        const oneNumeric = /^\d+$/.test(one);
+        const otherNumeric = /^\d+$/.test(other);
+        if (oneNumeric && otherNumeric) {
+            const difference = numeric(one) - numeric(other);
+            if (difference !== 0) {
+                return difference;
+            }
+            continue;
+        }
+        // Numeric identifiers always rank below alphanumeric ones.
+        if (oneNumeric !== otherNumeric) {
+            return oneNumeric ? -1 : 1;
+        }
+        const difference = one < other ? -1 : one > other ? 1 : 0;
+        if (difference !== 0) {
+            return difference;
+        }
+    }
+    return 0;
+};
+/**
+ * Whether spawning npm needs a shell on this platform.
+ *
+ * On Windows npm is `npm.cmd`, a batch file: a bare `npm` does not exist as
+ * an executable there (PATHEXT is a shell's job, not spawn's), and naming
+ * the `.cmd` directly has thrown EINVAL since the fix for CVE-2024-27980 —
+ * both land in the caller's error handler, so a Windows setup would report
+ * that it could not install and leave Slack and the dashboard missing.
+ *
+ * `shell: true` concatenates the arguments without escaping — Node 24
+ * deprecates the pattern as DEP0190 for exactly that reason — so what may
+ * reach it is fenced by `isInstallablePackageName` below rather than by an
+ * argument about where the names come from. That argument used to be
+ * "every name here is a constant in the CLI's own source", and it stopped
+ * being true
+ * the moment the Plugins menu started listing package names read from a
+ * config.
+ */
+export const npmNeedsShell = (platform) => platform === 'win32';
+export const isPackageName = (name) => name.length <= 214 && /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/.test(name);
+/**
+ * A package name, optionally with a plain version — what npm may be handed.
+ *
+ * A wider question than `isPackageName` and a different one: the updater
+ * installs `@stratusagent/cli@latest`, which is a valid thing to install and
+ * an invalid thing to import. Using one predicate for both let a versioned
+ * `plugins` key through the menu's install offer.
+ *
+ * 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.
+ */
+export const isInstallableSpecifier = (specifier) => {
+    const scoped = specifier.startsWith('@');
+    // Split on the `@` that introduces a version, never the one that opens a
+    // scope — `@scope/pkg` has both and only the first is part of the name.
+    const at = specifier.indexOf('@', scoped ? 1 : 0);
+    const name = at === -1 ? specifier : specifier.slice(0, at);
+    const version = at === -1 ? undefined : specifier.slice(at + 1);
+    if (!isPackageName(name)) {
+        return false;
+    }
+    return version === undefined || /^[a-z0-9][a-z0-9.-]*$/.test(version);
+};
+export const defaultPackageInstaller = async (packages) => {
+    const { spawn } = await import('node:child_process');
+    // The fence, at the one place that touches a shell, so every caller is
+    // behind it — including ones added later, which is how the old invariant
+    // was lost.
+    const rejected = packages.filter((entry) => !isInstallableSpecifier(entry));
+    if (rejected.length > 0) {
+        return {
+            ok: false,
+            message: `${rejected.join(', ')} ${rejected.length === 1 ? 'is not a package name' : 'are not package names'} npm can install. `
+                + 'Fix the key in your config, or install it yourself.',
+        };
+    }
+    return new Promise((resolve) => {
+        // npm's own output is inherited rather than captured: a global install
+        // runs for tens of seconds, and a silent one is indistinguishable from
+        // a setup that has hung. stdin is NOT inherited — the setup prompter
+        // owns it, and two readers on one stream race for the same bytes.
+        const child = spawn('npm', ['install', '-g', ...packages], {
+            stdio: ['ignore', 'inherit', 'inherit'],
+            shell: npmNeedsShell(process.platform),
+        });
+        // `error` and `close` can both fire — a spawn that fails still closes.
+        let settled = false;
+        const finish = (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            resolve(result);
+        };
+        child.once('error', (error) => {
+            finish({ ok: false, message: error.message });
+        });
+        child.once('close', (code) => {
+            finish(code === 0
+                ? { ok: true, message: '' }
+                : { ok: false, message: `npm exited with code ${code ?? 'unknown'}` });
+        });
+    });
+};
+/**
+ * What `stratus update` reads to learn which version of a companion this
+ * machine actually has. Through `@stratusagent/plugins`, which already owns
+ * the bounded walk from a resolved specifier to its package.json — a second
+ * copy here would drift from it, and this one would be the copy that
+ * decides whether somebody's Slack adapter gets upgraded.
+ */
+export const defaultInstalledVersionReader = async (specifier) => {
+    const { installedPackageVersion } = await import('@stratusagent/plugins');
+    return installedPackageVersion(specifier, { resolve: (target) => import.meta.resolve(target) });
+};
+export const CLI_VERSION = '0.11.4';
+export const CLI_PACKAGE_NAME = '@stratusagent/cli';
+//# sourceMappingURL=npm.js.map

package/dist/npm.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,245 @@
+import { type TrustLevel } from '@stratusagent/core';
+import { type StratusProviderName } from '@stratusagent/state';
+import type { CliEnvironment } from './environment.ts';
+export type CliProviderName = StratusProviderName;
+export type CliApprovalMode = 'always' | 'ask' | 'gated' | 'never';
+export interface ParsedRunCommand {
+    command: 'run';
+    prompt: string;
+    provider?: CliProviderName;
+    model?: string;
+    baseUrl?: string;
+    configPath?: string;
+    /** Path to a soul file defining the agent to run as. */
+    soul?: string;
+    format: 'text' | 'json';
+    events: boolean;
+    /** Absent when `--approvals` was not given: see `defaultApprovalMode`. */
+    approvals?: CliApprovalMode;
+    maxTurns?: number;
+}
+export interface ParsedDashboardCommand {
+    command: 'dashboard';
+    port?: number;
+    /**
+     * Present only when `--host` was actually given.
+     *
+     * A defaulted string here would be indistinguishable from an explicit
+     * `--host 127.0.0.1`, and the two mean opposite things when a trusted
+     * config says `api.host: "0.0.0.0"`: absent means "let the config decide",
+     * while explicit means "bind loopback, whatever the config says". Collapsing
+     * them exposed the API on every interface to an operator who had just asked
+     * for the opposite.
+     */
+    host?: string;
+    openBrowser: boolean;
+}
+export interface ParsedSetupCommand {
+    command: 'setup';
+    configPath?: string;
+}
+export interface ParsedAgentNewCommand {
+    command: 'agent-new';
+    name?: string;
+    instructions?: string;
+    format: 'text' | 'json' | 'soul';
+}
+export interface ParsedChatCommand {
+    command: 'chat';
+    provider?: CliProviderName;
+    model?: string;
+    baseUrl?: string;
+    configPath?: string;
+    /** Path to a soul file defining the agent to chat with. */
+    soul?: string;
+    events: boolean;
+    /** Absent when `--approvals` was not given: see `defaultApprovalMode`. */
+    approvals?: CliApprovalMode;
+    maxTurns?: number;
+}
+export interface ParsedTemplateAddCommand {
+    command: 'template-add';
+    /** A GitHub `owner/repo`, a git URL, or a local path. */
+    source: string;
+    /** Skip the review and install straight away. */
+    yes?: boolean;
+    /** Replace an agent or skill already installed under the same name. */
+    force?: boolean;
+}
+export interface ParsedSkillAddCommand {
+    command: 'skill-add';
+    /** A GitHub `owner/repo`, a git URL, or a local path. */
+    source: string;
+    /** Install only these ids (repeatable --skill). */
+    skillIds?: string[];
+    /** Replace an already-installed id instead of refusing it. */
+    force?: boolean;
+    /** Enable the installed skills in this agent's soul afterwards. */
+    agentId?: string;
+    /** Tell a running daemon to reload its skills afterwards. Default true; `--no-reload` sets false. */
+    reload?: boolean;
+}
+export interface ParsedSkillValidateCommand {
+    command: 'skill-validate';
+    /** A skill directory, a directory of skills, or an installed skill's id. */
+    target: string;
+}
+export interface ParsedPluginsCommand {
+    command: 'plugins';
+    format: 'text' | 'json';
+    /** The config whose plugins block to read, when not the default. */
+    configPath?: string;
+}
+export interface ParsedSkillsCommand {
+    command: 'skills';
+}
+/**
+ * What a credential name may be: the two conventions in use, and nothing
+ * that would be awkward in a soul's `credentials:` list — `search.apiKey`
+ * and environment-style `SLACK_TOKEN`. Leading letter required, which also
+ * happens to exclude `__proto__`; the store does not *rely* on that (it
+ * keys prototype-free maps), because a credentials file can be written by
+ * something other than this command.
+ */
+export declare const CREDENTIAL_NAME_PATTERN: RegExp;
+export interface ParsedCredentialCommand {
+    command: 'credential';
+    action: 'set' | 'list' | 'remove';
+    /** The credential name — `search.apiKey` and whatever the ecosystem asks for next. */
+    name?: string;
+    /** Store or remove this agent's own entry rather than the fleet's shared one. */
+    agentId?: string;
+}
+export interface ParsedSkillReloadCommand {
+    command: 'skill-reload';
+    /** A daemon's control API URL; default: the one `~/.stratus/gateway.json` names. */
+    gateway?: string;
+    token?: string;
+}
+export interface ParsedRestartCommand {
+    command: 'restart';
+    /** For the daemon's log. */
+    reason?: string;
+    /** How long the daemon lets in-flight turns finish, in milliseconds. */
+    drainTimeoutMs?: number;
+    gateway?: string;
+    token?: string;
+}
+export interface ParsedAgentsCommand {
+    command: 'agents';
+    format: 'text' | 'json';
+    /**
+     * Ask a running gateway instead of resolving locally. The first
+     * remote-consuming command: the same listing, rendered from the control
+     * API's answer rather than from this machine's files.
+     */
+    gateway?: string;
+    /** Bearer token override, for a gateway whose token file is not local. */
+    token?: string;
+}
+export interface ParsedSchedulesCommand {
+    command: 'schedules';
+    action: 'list' | 'cancel';
+    /** cancel only: which schedule. */
+    scheduleId?: string;
+    format: 'text' | 'json';
+}
+export interface ParsedGrantsCommand {
+    command: 'grants';
+    action: 'list' | 'revoke';
+    agentId: string;
+    /** revoke: exactly one of the three names what goes. */
+    tool?: string;
+    /** The scope as `stratus grants` lists it — `git push`. */
+    scope?: string;
+    origin?: string;
+    format: 'text' | 'json';
+    gateway?: string;
+    token?: string;
+}
+export interface ParsedMemoryCommand {
+    command: 'memory';
+    action: 'list' | 'reassert';
+    agentId: string;
+    /** list: show only entries at this label. reassert: the label to record. */
+    trust?: TrustLevel;
+    /** reassert: the entries to re-label, by id. */
+    ids: string[];
+    /** reassert: every live entry currently reading `unknown` — the upgrade case. */
+    allUnknown: boolean;
+    format: 'text' | 'json';
+}
+export interface ParsedSessionCommand {
+    command: 'session';
+    action: 'rollover';
+    sessionId: string;
+    gateway?: string;
+    token?: string;
+}
+export interface ParsedDoctorCommand {
+    command: 'doctor';
+    format: 'text' | 'json';
+    configPath?: string;
+}
+export interface ParsedUpdateCommand {
+    command: 'update';
+    /** Report what an update would do — version, migrations, unit health — without doing any of it. */
+    check: boolean;
+}
+export interface ParsedServiceCommand {
+    command: 'service';
+    action: 'install' | 'uninstall' | 'status' | 'start' | 'stop';
+    /** install only: start automatically at login. Defaults to true. */
+    runAtLogin?: boolean;
+    /** install only: the config the managed daemon should load. */
+    configPath?: string;
+}
+export interface ParsedLogsCommand {
+    command: 'logs';
+    /** Keep streaming new records instead of exiting after the backlog. */
+    follow: boolean;
+    /** How many recent records to show before following. */
+    limit: number;
+    agentId?: string;
+    sessionId?: string;
+    format: 'text' | 'json';
+}
+export type ServeApprovalMode = 'headless' | 'remote';
+export interface ParsedServeCommand {
+    command: 'serve';
+    configPath?: string;
+    /** Overrides `approvals.mode` in the config file. */
+    approvals?: ServeApprovalMode;
+    /** Watchdog idle timeout in milliseconds. 0 disables. */
+    idleTimeoutMs?: number;
+    events: boolean;
+    /** Write the structured log to ~/.stratus/logs. Defaults to true. */
+    logToFile?: boolean;
+    /** Serve the control API. Defaults to true when the package is installed. */
+    api?: boolean;
+    /** Overrides `api.port` in the config file. */
+    apiPort?: number;
+    /** Overrides `api.host` in the config file. */
+    apiHost?: string;
+}
+export interface ParsedHelpCommand {
+    command: 'help';
+}
+export interface ParsedVersionCommand {
+    command: 'version';
+}
+export type ParsedCommand = ParsedRunCommand | ParsedChatCommand | ParsedDashboardCommand | ParsedSetupCommand | ParsedAgentNewCommand | ParsedAgentsCommand | ParsedSkillAddCommand | ParsedTemplateAddCommand | ParsedSkillValidateCommand | ParsedPluginsCommand | ParsedSkillsCommand | ParsedSkillReloadCommand | ParsedCredentialCommand | ParsedRestartCommand | ParsedSchedulesCommand | ParsedGrantsCommand | ParsedMemoryCommand | ParsedSessionCommand | ParsedDoctorCommand | ParsedLogsCommand | ParsedUpdateCommand | ParsedServiceCommand | ParsedServeCommand | ParsedHelpCommand | ParsedVersionCommand;
+export declare const parseCommand: (argv: string[], env?: CliEnvironment) => ParsedCommand;
+/**
+ * The approval mode a run or chat uses when `--approvals` was not given.
+ *
+ * At a terminal the person is right there, so a gated call asks and a
+ * safe one runs, which is `gated` — the old default of `always` ran
+ * `shell.run` on whatever a page or a soul talked the model into, with
+ * nobody told. Anywhere else — a pipe, a script, `--stdin`, where the
+ * prompt already consumed the terminal — nobody can answer a y/N, and the
+ * run keeps its unattended behavior, saying so once on stderr when a
+ * gated call runs (see `createApprovalPolicy`).
+ */
+export declare const defaultApprovalMode: (env: CliEnvironment, promptFromStdin?: boolean) => CliApprovalMode;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

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