@stratusagent/cli 0.11.1 → 0.11.3

package/dist/parse.d.ts

@@ -0,0 +1,231 @@
+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' | '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;
+    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;
+    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;
+//# 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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"}