@agentuity/cli 3.0.0-alpha.7 → 3.0.0-beta.0

package/dist/main.js

@@ -0,0 +1,396 @@
+// Main CLI entry point. Side-effect import — just running this module
+// boots the CLI and parses argv. The published binary lives at
+// `bin/cli.js` (a hand-written shim) and re-imports this file from
+// `dist/`. See bin/cli.js and packages/cli/AGENTS.md for the
+// surrounding architecture.
+import { ConsoleLogger, getAppBaseURL } from '@agentuity/server';
+import { isStructuredError } from '@agentuity/core';
+import { createCLI, registerCommands } from "./cli.js";
+import { validateRuntime } from "./runtime.js";
+import { loadConfig } from "./config.js";
+import { discoverCommands } from "./cmd/index.js";
+import { detectColorScheme } from "./terminal.js";
+import { setColorScheme } from "./tui.js";
+import { getVersion, getPackageName } from "./version.js";
+import { generateCLISchema } from "./schema-generator.js";
+import { generateAIHelp } from "./ai-help.js";
+import { setOutputOptions } from "./output.js";
+import { ensureBunOnPath } from "./bun-path.js";
+import { checkForUpdates } from "./version-check.js";
+import { closeDatabase } from "./cache/index.js";
+import { ErrorCode, createError, formatErrorJSON } from "./errors.js";
+import { createInternalLogger } from "./internal-logger.js";
+import { createCompositeLogger } from "./composite-logger.js";
+import { getAuth } from "./config.js";
+import { getExecutingAgent } from "./agent-detection.js";
+/**
+ * Extract --dir flag from process.argv before command parsing
+ * Handles both --dir=<path> and --dir <path> formats
+ * Returns undefined if not present
+ */
+function getProjectDirFromArgs() {
+    const args = process.argv;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        // Handle --dir=<path>
+        if (arg.startsWith('--dir=')) {
+            return arg.slice(6);
+        }
+        // Handle --dir <path>
+        if (arg === '--dir' && i + 1 < args.length) {
+            const nextArg = args[i + 1];
+            // Make sure next arg isn't another flag
+            if (nextArg !== undefined && !nextArg.startsWith('-')) {
+                return nextArg;
+            }
+        }
+    }
+    return undefined;
+}
+// Cleanup TTY state before exit
+function cleanupTTY() {
+    // Skip in CI - terminals don't support cursor control sequences
+    if (process.env.CI) {
+        return;
+    }
+    if (process.stdin.isTTY) {
+        try {
+            process.stdin.setRawMode(false);
+        }
+        catch {
+            // Ignore errors if stdin is already closed
+        }
+        process.stdout.write('\x1B[?25h'); // Restore cursor
+    }
+}
+// Handle Ctrl+C gracefully - only cleanup TTY, let command handlers run
+// Commands like 'dev' register their own SIGINT handlers for cleanup
+process.on('SIGINT', () => {
+    process.stdout.write('\b \b'); // erase the ctrl+c display
+    cleanupTTY();
+    closeDatabase();
+});
+process.on('SIGTERM', () => {
+    cleanupTTY();
+    closeDatabase();
+});
+validateRuntime();
+await ensureBunOnPath();
+// Preprocess arguments to convert --help=json to --help json
+// Commander.js doesn't support --option=value syntax for optional values
+const preprocessedArgs = process.argv.slice(2).flatMap((arg) => {
+    if (arg === '--help=json') {
+        return ['--help', 'json'];
+    }
+    return arg;
+});
+// Preserve the original process.argv[0] (runtime) and process.argv[1] (script path)
+// This is important for Bun, Node, and bundled executables.
+// argv[0] and argv[1] are guaranteed-present in any Node/Bun process,
+// so the non-null assertions are safe.
+process.argv = [process.argv[0], process.argv[1], ...preprocessedArgs];
+const helpFlags = ['--help', '-h', 'help'];
+const hasHelp = helpFlags.some((flag) => preprocessedArgs.includes(flag));
+// Check for --help=json early (needs to exit before full initialization)
+// After preprocessing, --help=json becomes ['--help', 'json'] (length 2)
+if (preprocessedArgs.length === 2 &&
+    preprocessedArgs[0] === '--help' &&
+    preprocessedArgs[1] === 'json') {
+    const version = getVersion();
+    const program = await createCLI(version);
+    const commands = await discoverCommands();
+    const cliSchema = generateCLISchema(program, commands, version);
+    console.log(JSON.stringify(cliSchema, null, 2));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const exit = globalThis.AGENTUITY_PROCESS_EXIT || process.exit;
+    closeDatabase();
+    exit(0);
+}
+// Check for --ai-help early (dashdash format for AI agents)
+// This runs before auth/validation per dashdash spec "eager" requirement
+if (preprocessedArgs.includes('--ai-help')) {
+    const version = getVersion();
+    const program = await createCLI(version);
+    const commands = await discoverCommands();
+    const cliSchema = generateCLISchema(program, commands, version);
+    const aiHelp = generateAIHelp(cliSchema);
+    console.log(aiHelp);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const exit = globalThis.AGENTUITY_PROCESS_EXIT || process.exit;
+    closeDatabase();
+    exit(0);
+}
+const version = getVersion();
+const program = await createCLI(version);
+// Parse options early to check for color scheme override and extract operands
+// Skip parseOptions if we have help flags to avoid "unknown option" error
+// parseOptions returns { operands, unknown } where operands are positional args (command names)
+// Pass only user args (slice(2) to skip node path and script path) per Commander v14 expectations
+let parsedOperands = [];
+if (!hasHelp) {
+    const parsed = program.parseOptions(process.argv.slice(2));
+    parsedOperands = parsed.operands;
+}
+const earlyOpts = program.opts();
+// Normalize --org alias → orgId (agents prefer --org over --org-id)
+if (earlyOpts.org !== undefined && earlyOpts.orgId === undefined) {
+    earlyOpts.orgId = earlyOpts.org;
+}
+// Set JSON error format early, BEFORE any code that might throw,
+// so that startup failures also use the JSON error formatter.
+// Note: --error-format defaults to 'text', so we must check !== 'json'
+// rather than !earlyOpts.errorFormat (which would always be false).
+if (earlyOpts.json && earlyOpts.errorFormat !== 'json') {
+    earlyOpts.errorFormat = 'json';
+}
+setOutputOptions(earlyOpts);
+// Variables that may or may not be initialized by the time an error occurs.
+// Hoisted here so the centralized error handler can reference them.
+let config;
+let logger;
+/**
+ * Main startup and command execution.
+ *
+ * Wrapped in a function so that the entire boot sequence (config loading,
+ * command discovery, update checks, command registration, and execution)
+ * is enclosed in a single try/catch whose error handler respects --json.
+ */
+async function main() {
+    // Detect or override terminal color scheme
+    let colorScheme = await detectColorScheme();
+    if (earlyOpts.colorScheme === 'light' || earlyOpts.colorScheme === 'dark') {
+        colorScheme = earlyOpts.colorScheme;
+        if (process.env.DEBUG_COLORS) {
+            console.log(`[DEBUG] Using --color-scheme=${colorScheme} flag`);
+        }
+    }
+    setColorScheme(colorScheme);
+    // Debug: show detected color scheme
+    if (process.env.DEBUG_COLORS) {
+        console.log(`[DEBUG] Color scheme: ${colorScheme}`);
+    }
+    // Create logger instance with global options
+    // In quiet or JSON mode, suppress most logging
+    const effectiveLogLevel = earlyOpts.quiet || earlyOpts.json ? 'error' : earlyOpts.logLevel || 'info';
+    const consoleLogger = new ConsoleLogger(effectiveLogLevel, earlyOpts.logTimestamp || false, colorScheme);
+    consoleLogger.setShowPrefix(earlyOpts.logPrefix !== false);
+    // Use the parsed operands from Commander.js parseOptions() which correctly
+    // separates command names from option values. parsedOperands contains only
+    // positional arguments (command/subcommand names), not flag values.
+    // For help mode, parsedOperands is empty so we fall back to extracting from preprocessedArgs.
+    const commandArgs = hasHelp
+        ? preprocessedArgs.filter((arg) => !arg.startsWith('-'))
+        : parsedOperands;
+    // Check if we should skip internal logging based on command or help flags
+    // We need to check the commands first to see if skipInternalLogging is set
+    const earlyCommandName = commandArgs[0];
+    const earlySubcommandName = commandArgs[1];
+    const commands = await discoverCommands();
+    const earlyCommandDef = commands.find((cmd) => cmd.name === earlyCommandName);
+    const earlySubcommandDef = earlySubcommandName
+        ? earlyCommandDef?.subcommands?.find((sub) => sub.name === earlySubcommandName)
+        : undefined;
+    // Skip internal logging if:
+    // 1. Help flag is present
+    // 2. No command provided (shows help)
+    // 3. Command has skipInternalLogging set
+    // 4. Subcommand has skipInternalLogging set
+    const shouldSkipInternalLogging = hasHelp ||
+        commandArgs.length === 0 ||
+        earlyCommandDef?.skipInternalLogging ||
+        earlySubcommandDef?.skipInternalLogging;
+    // Create internal logger for trace/debug logging (always at trace level)
+    const internalLogger = createInternalLogger(version, getPackageName());
+    // Disable or initialize the internal logger based on command flags
+    if (shouldSkipInternalLogging) {
+        internalLogger.disable();
+    }
+    else {
+        const command = commandArgs.length > 0 ? commandArgs.join(' ') : 'help';
+        // Extract --dir from argv if present (for project context in logs)
+        const projectDirArg = getProjectDirFromArgs();
+        // Filter out command/subcommand names from args by position, not by value.
+        // The first N entries of preprocessedArgs that are not flags are the command tokens.
+        // Skip the leading command tokens to get only the actual arguments.
+        let commandTokensToSkip = commandArgs.length;
+        const filteredArgs = [];
+        for (const arg of preprocessedArgs) {
+            if (commandTokensToSkip > 0 && !arg.startsWith('-') && commandArgs.includes(arg)) {
+                commandTokensToSkip--;
+            }
+            else {
+                filteredArgs.push(arg);
+            }
+        }
+        internalLogger.init(command, filteredArgs, undefined, projectDirArg);
+        // Set session ID in environment so forked child processes can share the same log file
+        process.env.AGENTUITY_INTERNAL_SESSION_ID = internalLogger.getSessionId();
+        // Set detected agent in session logs
+        const detectedAgent = getExecutingAgent();
+        if (detectedAgent) {
+            internalLogger.setDetectedAgent(detectedAgent);
+        }
+    }
+    // Create composite logger that writes to both console and internal log
+    logger = createCompositeLogger(consoleLogger, internalLogger);
+    // Set version check skip flag from CLI option
+    if (earlyOpts.skipVersionCheck) {
+        process.env.AGENTUITY_SKIP_VERSION_CHECK = '1';
+    }
+    config = await loadConfig(earlyOpts.config, false, earlyOpts.profile);
+    // Update internal logger with userId if available from auth (keychain or config)
+    try {
+        const auth = await getAuth();
+        if (auth?.userId) {
+            internalLogger.setUserId(auth.userId);
+        }
+    }
+    catch {
+        // Ignore auth errors - user might not be logged in
+    }
+    const ctx = {
+        config,
+        logger,
+        options: earlyOpts,
+        getExecutingAgent,
+    };
+    // Check for updates before running commands (may upgrade and re-exec)
+    // Find the command being run to check if it opts out of upgrade check
+    // Use parsedOperands from Commander's parseOptions which correctly separates
+    // command names from option values (e.g., "--file myfile" won't treat "myfile" as a command)
+    // Also find the subcommand if present (e.g., "auth whoami" -> command="auth", subcommand="whoami")
+    const commandName = parsedOperands[0];
+    const subcommandName = parsedOperands[1];
+    const commandDef = commands.find((cmd) => cmd.name === commandName);
+    const subcommandDef = subcommandName
+        ? commandDef?.subcommands?.find((sub) => sub.name === subcommandName)
+        : undefined;
+    await checkForUpdates(config, logger, earlyOpts, commandDef, subcommandDef, preprocessedArgs);
+    // Generate and store CLI schema globally for the schema command
+    const cliSchema = generateCLISchema(program, commands, version);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    global.__CLI_SCHEMA__ = cliSchema;
+    await registerCommands(program, commands, ctx);
+    await program.parseAsync(process.argv);
+    // Ensure clean exit after successful command execution.
+    // In TTY environments, process.stdin may keep the event loop alive
+    // (e.g., after confirm() calls resume()/setRawMode()), and Bun does not
+    // support process.stdin.unref(), so we must explicitly exit.
+    closeDatabase();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const exit = globalThis.AGENTUITY_PROCESS_EXIT || process.exit;
+    // Preserve process.exitCode set by command handlers (e.g., sandbox run/exec
+    // propagate the sandbox process's exit code). Default to 0 for success.
+    exit(process.exitCode ?? 0);
+}
+try {
+    await main();
+}
+catch (error) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const exit = globalThis.AGENTUITY_PROCESS_EXIT || process.exit;
+    // Don't log error if it's from Ctrl+C, user cancellation, or signal termination
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        if (msg.includes('sigint') ||
+            msg.includes('sigterm') ||
+            msg.includes('user force closed') ||
+            msg.includes('cancelled') || // UK
+            msg.includes('canceled') || // US
+            msg === '') {
+            closeDatabase();
+            exit(0);
+        }
+        if ('name' in error && error.name === 'AbortError') {
+            closeDatabase();
+            exit(0);
+        }
+    }
+    // Also exit cleanly if error is empty/undefined (user cancellation)
+    if (!error) {
+        closeDatabase();
+        exit(0);
+    }
+    const errorWithMessage = error;
+    // Handle payment required (402) errors with a friendly TUI message
+    if (isStructuredError(error) &&
+        ((errorWithMessage._tag === 'ServiceException' && errorWithMessage.statusCode === 402) ||
+            errorWithMessage._tag === 'PaymentRequiredError')) {
+        if (earlyOpts.errorFormat === 'json') {
+            console.error(formatErrorJSON(createError(ErrorCode.PAYMENT_REQUIRED, 'Your organization is out of credit. Please visit your billing page to add credit.')));
+        }
+        else {
+            const { errorBox, link, newline } = await import("../src/tui.js");
+            const overrides = config?.overrides;
+            const appBaseUrl = getAppBaseURL(undefined, overrides);
+            const billingUrl = `${appBaseUrl}/billing`;
+            newline();
+            errorBox('Out of Credit', `Your organization is out of credit.\n\nPlease add more here:\n${link(billingUrl)}`, false // standalone box, not connected to a guide
+            );
+        }
+        closeDatabase();
+        exit(1);
+    }
+    if (earlyOpts.errorFormat === 'json') {
+        let message = errorWithMessage?.message ?? String(error);
+        // Classify the error: treat as API_ERROR if it's a structured error
+        // OR if the error carries a numeric status/statusCode (e.g. ServiceException)
+        const hasStatus = typeof error === 'object' &&
+            error !== null &&
+            (('status' in error && typeof error.status === 'number') ||
+                ('statusCode' in error && typeof error.statusCode === 'number'));
+        const code = isStructuredError(error) || hasStatus ? ErrorCode.API_ERROR : ErrorCode.INTERNAL_ERROR;
+        const details = {};
+        if (isStructuredError(error) && errorWithMessage._tag) {
+            details.tag = errorWithMessage._tag;
+        }
+        if (typeof error === 'object' && error !== null) {
+            // Support both error.status (APIErrorResponse) and error.statusCode (ServiceException)
+            if ('status' in error && typeof error.status === 'number') {
+                details.status = error.status;
+            }
+            else if ('statusCode' in error && typeof error.statusCode === 'number') {
+                details.status = error.statusCode;
+            }
+            if ('sessionId' in error && error.sessionId) {
+                details.sessionId = error.sessionId;
+            }
+        }
+        // Try to parse embedded JSON in API error messages
+        // API errors often have messages like: '{"success":false,"message":"not found: ..."}'
+        try {
+            const parsed = JSON.parse(message);
+            if (parsed && typeof parsed === 'object' && typeof parsed.message === 'string') {
+                message = parsed.message;
+            }
+        }
+        catch {
+            // Not JSON, use message as-is
+        }
+        console.error(formatErrorJSON(createError(code, message, Object.keys(details).length > 0 ? details : undefined)));
+    }
+    else if (isStructuredError(error)) {
+        // Use the composite logger if available; fall back to console.error
+        // if the error occurred before logger initialization completed
+        if (logger) {
+            logger.error(error);
+        }
+        else {
+            console.error(String(error));
+        }
+    }
+    else {
+        const msg = errorWithMessage?.message ? errorWithMessage.message : String(error);
+        if (logger) {
+            logger.error('CLI error: %s %s', msg, error);
+        }
+        else {
+            console.error(`CLI error: ${msg}`);
+        }
+    }
+    closeDatabase();
+    exit(1);
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/node-compat/ansi.d.ts

@@ -0,0 +1,134 @@
+/**
+ * ANSI / terminal-styling helpers.
+ *
+ * Replacements for the Bun-specific `Bun.color`, `Bun.stringWidth`,
+ * and `Bun.stripANSI` APIs used by `tui.ts` and `banner.ts`.
+ *
+ * - `color(spec, mode)` returns the SGR (Select Graphic Rendition)
+ *   escape that selects the given foreground color. Mirrors Bun's
+ *   `Bun.color('cyan', 'ansi-16m')` /
+ *   `Bun.color('#5C9CFF', 'ansi')` shape:
+ *   - `mode: 'ansi-16m'` -> 24-bit truecolor (`\\x1b[38;2;R;G;Bm`).
+ *     Wide compatibility on modern terminals.
+ *   - `mode: 'ansi'`    -> 16-color palette
+ *     (`\\x1b[3{0-7}m` / `\\x1b[9{0-7}m`). Use when the consumer
+ *     needs to land on dumb terminals.
+ *
+ * - `stringWidth(s)` is re-exported from the `string-width` npm
+ *   package. Inlining a correct implementation that handles emoji,
+ *   CJK, ZWJ sequences, and ANSI escapes is ~150 lines of edge
+ *   cases that the npm package already gets right.
+ *
+ * - `stripAnsi(s)` removes SGR (color/style) escape sequences. The
+ *   CLI only feeds this with logger output, so SGR-only stripping
+ *   suffices; we don't try to handle cursor or OSC codes.
+ */
+import stringWidthLib from 'string-width';
+/** Re-export of the `string-width` npm package's default export. */
+export declare const stringWidth: typeof stringWidthLib;
+/** Color rendering modes accepted by `color()`. Mirrors `Bun.color`. */
+export type ColorMode = 'ansi' | 'ansi-16m';
+/**
+ * Color spec: either a CSS named color (a small subset that the CLI
+ * actually uses) or a `#RRGGBB` hex string.
+ */
+export type ColorSpec = NamedColor | `#${string}`;
+/**
+ * Return the SGR escape sequence that sets the foreground color to
+ * `spec` in the requested rendering `mode`. Returns an empty string
+ * if the spec cannot be resolved (rather than throwing) so callers
+ * can use the result inline without nesting null checks.
+ */
+export declare function color(spec: ColorSpec, mode?: ColorMode): string;
+/**
+ * Strip SGR (color/style) escape sequences from `s`. Cursor /
+ * OSC / DCS sequences are left in place; the CLI doesn't generate
+ * them in places that flow through `stripAnsi`.
+ */
+export declare function stripAnsi(s: string): string;
+/**
+ * Subset of CSS named colors actually used by the CLI today. Each
+ * carries both its RGB triple (for 24-bit mode) and its 16-color
+ * SGR code (for `ansi` mode).
+ *
+ * If a future call site needs a color not listed here, add it to
+ * this map rather than falling back to a hex literal at the call
+ * site. Keeping the named-color list short is intentional.
+ */
+declare const NAMED_COLORS: {
+    black: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+    red: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+    green: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+    yellow: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+    blue: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+    magenta: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+    cyan: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+    white: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+    gray: {
+        rgb: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        ansi: number;
+    };
+};
+type NamedColor = keyof typeof NAMED_COLORS;
+export {};
+//# sourceMappingURL=ansi.d.ts.map

package/dist/node-compat/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/node-compat/ansi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,cAAc,MAAM,cAAc,CAAC;AAE1C,oEAAoE;AACpE,eAAO,MAAM,WAAW,uBAAiB,CAAC;AAE1C,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,IAAI,MAAM,EAAE,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,SAAsB,GAAG,MAAM,CAe3E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3C;AAYD;;;;;;;;GAQG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAU0C,CAAC;AAE7D,KAAK,UAAU,GAAG,MAAM,OAAO,YAAY,CAAC"}