@elizaos/plugin-cli 2.0.0-alpha.3

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @elizaos/plugin-cli
+ *
+ * CLI framework plugin for ElizaOS agents
+ *
+ * Provides:
+ * - CLI command registration and management
+ * - Progress reporting utilities
+ * - Duration/timeout parsing
+ * - Common CLI dependencies
+ */
+import type { IAgentRuntime, Plugin } from "@elizaos/core";
+import { Command } from "commander";
+export { addSubcommand, clearCliCommands, defineCliCommand, getCliCommand, listCliCommands, registerAllCommands, registerCliCommand, unregisterCliCommand, } from "./registry.js";
+export * from "./types.js";
+export { createDefaultDeps, createProgressReporter, DEFAULT_CLI_NAME, DEFAULT_CLI_VERSION, formatBytes, formatCliCommand, formatDuration, isInteractive, parseDurationMs, parseTimeoutMs, resolveCliName, withProgress, } from "./utils.js";
+/**
+ * Build the Commander program with all registered commands
+ */
+export declare function buildProgram(options?: {
+    name?: string;
+    version?: string;
+    getRuntime?: () => IAgentRuntime | null;
+}): Command;
+/**
+ * Run the CLI with the given arguments
+ */
+export declare function runCli(argv?: string[], options?: {
+    name?: string;
+    version?: string;
+    getRuntime?: () => IAgentRuntime | null;
+}): Promise<void>;
+/**
+ * CLI Plugin for ElizaOS
+ *
+ * Provides CLI command infrastructure for the agent runtime.
+ *
+ * Configuration:
+ * - CLI_NAME: CLI command name (default: "elizaos")
+ * - CLI_VERSION: CLI version string
+ *
+ * @example
+ * ```typescript
+ * import { cliPlugin, buildProgram, registerCliCommand, defineCliCommand } from '@elizaos/plugin-cli';
+ *
+ * // Register a custom command
+ * registerCliCommand(defineCliCommand(
+ *   'mycommand',
+ *   'My custom command',
+ *   (ctx) => {
+ *     ctx.program.command('mycommand')
+ *       .description('My custom command')
+ *       .action(() => console.log('Hello!'));
+ *   }
+ * ));
+ *
+ * // Build and run
+ * const program = buildProgram();
+ * await program.parseAsync(process.argv);
+ * ```
+ */
+export declare const cliPlugin: Plugin;
+export default cliPlugin;
+export { Command } from "commander";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CACzC,GAAG,OAAO,CAoBV;AAED;;GAEG;AACH,wBAAsB,MAAM,CAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CACzC,GACA,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,SAAS,EAAE,MAiCvB,CAAC;AAEF,eAAe,SAAS,CAAC;AAGzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,169 @@
+/**
+ * @elizaos/plugin-cli
+ *
+ * CLI framework plugin for ElizaOS agents
+ *
+ * Provides:
+ * - CLI command registration and management
+ * - Progress reporting utilities
+ * - Duration/timeout parsing
+ * - Common CLI dependencies
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { logger } from "@elizaos/core";
+import { Command } from "commander";
+// Registry
+export { addSubcommand, clearCliCommands, defineCliCommand, getCliCommand, listCliCommands, registerAllCommands, registerCliCommand, unregisterCliCommand, } from "./registry.js";
+// Types
+export * from "./types.js";
+// Utils
+export { createDefaultDeps, createProgressReporter, DEFAULT_CLI_NAME, DEFAULT_CLI_VERSION, formatBytes, formatCliCommand, formatDuration, isInteractive, parseDurationMs, parseTimeoutMs, resolveCliName, withProgress, } from "./utils.js";
+import { listCliCommands, registerAllCommands } from "./registry.js";
+import { DEFAULT_CLI_NAME, DEFAULT_CLI_VERSION, resolveCliName, } from "./utils.js";
+/**
+ * Build the Commander program with all registered commands
+ */
+export function buildProgram(options) {
+    var _a, _b;
+    var cliName = (_a = options === null || options === void 0 ? void 0 : options.name) !== null && _a !== void 0 ? _a : resolveCliName();
+    var version = (_b = options === null || options === void 0 ? void 0 : options.version) !== null && _b !== void 0 ? _b : DEFAULT_CLI_VERSION;
+    var program = new Command()
+        .name(cliName)
+        .version(version)
+        .description("".concat(cliName, " - ElizaOS agent CLI"));
+    var ctx = {
+        program: program,
+        getRuntime: options === null || options === void 0 ? void 0 : options.getRuntime,
+        cliName: cliName,
+        version: version,
+    };
+    // Register all commands
+    registerAllCommands(ctx);
+    return program;
+}
+/**
+ * Run the CLI with the given arguments
+ */
+export function runCli(argv, options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var program, error_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    program = buildProgram(options);
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, program.parseAsync(argv !== null && argv !== void 0 ? argv : process.argv)];
+                case 2:
+                    _a.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    error_1 = _a.sent();
+                    if (error_1 instanceof Error) {
+                        // Commander throws an error for --help and --version
+                        if (error_1.message.includes("outputHelp")) {
+                            return [2 /*return*/];
+                        }
+                    }
+                    throw error_1;
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * CLI Plugin for ElizaOS
+ *
+ * Provides CLI command infrastructure for the agent runtime.
+ *
+ * Configuration:
+ * - CLI_NAME: CLI command name (default: "elizaos")
+ * - CLI_VERSION: CLI version string
+ *
+ * @example
+ * ```typescript
+ * import { cliPlugin, buildProgram, registerCliCommand, defineCliCommand } from '@elizaos/plugin-cli';
+ *
+ * // Register a custom command
+ * registerCliCommand(defineCliCommand(
+ *   'mycommand',
+ *   'My custom command',
+ *   (ctx) => {
+ *     ctx.program.command('mycommand')
+ *       .description('My custom command')
+ *       .action(() => console.log('Hello!'));
+ *   }
+ * ));
+ *
+ * // Build and run
+ * const program = buildProgram();
+ * await program.parseAsync(process.argv);
+ * ```
+ */
+export var cliPlugin = {
+    name: "cli",
+    description: "CLI framework plugin for command registration and execution",
+    providers: [],
+    actions: [],
+    services: [],
+    routes: [],
+    config: {
+        CLI_NAME: DEFAULT_CLI_NAME,
+        CLI_VERSION: DEFAULT_CLI_VERSION,
+    },
+    init: function (_config, _runtime) {
+        return __awaiter(this, void 0, void 0, function () {
+            var commands;
+            return __generator(this, function (_a) {
+                try {
+                    commands = listCliCommands();
+                    logger.info({ commandCount: commands.length }, "[CLIPlugin] Plugin initialized");
+                }
+                catch (error) {
+                    logger.error("[CLIPlugin] Error initializing:", error instanceof Error ? error.message : String(error));
+                    throw error;
+                }
+                return [2 /*return*/];
+            });
+        });
+    },
+};
+export default cliPlugin;
+// Re-export Command for convenience
+export { Command } from "commander";

package/dist/registry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CLI command registry
+ *
+ * Provides command registration and management for the CLI plugin.
+ */
+import type { Command } from "commander";
+import type { CliCommand, CliContext, CliRegistrationFn } from "./types.js";
+/**
+ * Register a CLI command
+ */
+export declare function registerCliCommand(command: CliCommand): void;
+/**
+ * Unregister a CLI command
+ */
+export declare function unregisterCliCommand(name: string): boolean;
+/**
+ * Get a CLI command by name
+ */
+export declare function getCliCommand(name: string): CliCommand | undefined;
+/**
+ * List all registered CLI commands
+ */
+export declare function listCliCommands(): CliCommand[];
+/**
+ * Register all commands with the program
+ */
+export declare function registerAllCommands(ctx: CliContext): void;
+/**
+ * Clear all registered commands (for testing)
+ */
+export declare function clearCliCommands(): void;
+/**
+ * Helper to create a CLI command definition
+ */
+export declare function defineCliCommand(name: string, description: string, register: CliRegistrationFn, options?: {
+    aliases?: string[];
+    priority?: number;
+}): CliCommand;
+/**
+ * Helper to create a subcommand on an existing command
+ */
+export declare function addSubcommand(parent: Command, name: string, description: string): Command;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAO5E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAO5D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,UAAU,EAAE,CAI9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAazD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,UAAU,CAQZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAET"}

package/dist/registry.js

@@ -0,0 +1,77 @@
+/**
+ * CLI command registry
+ *
+ * Provides command registration and management for the CLI plugin.
+ */
+import { logger } from "@elizaos/core";
+/**
+ * Internal registry of CLI commands
+ */
+var commands = new Map();
+/**
+ * Register a CLI command
+ */
+export function registerCliCommand(command) {
+    if (commands.has(command.name)) {
+        logger.warn("[CLI] Command \"".concat(command.name, "\" already registered, replacing"));
+    }
+    commands.set(command.name, command);
+}
+/**
+ * Unregister a CLI command
+ */
+export function unregisterCliCommand(name) {
+    return commands.delete(name);
+}
+/**
+ * Get a CLI command by name
+ */
+export function getCliCommand(name) {
+    return commands.get(name);
+}
+/**
+ * List all registered CLI commands
+ */
+export function listCliCommands() {
+    return Array.from(commands.values()).sort(function (a, b) { var _a, _b; return ((_a = a.priority) !== null && _a !== void 0 ? _a : 100) - ((_b = b.priority) !== null && _b !== void 0 ? _b : 100); });
+}
+/**
+ * Register all commands with the program
+ */
+export function registerAllCommands(ctx) {
+    var sorted = listCliCommands();
+    for (var _i = 0, sorted_1 = sorted; _i < sorted_1.length; _i++) {
+        var command = sorted_1[_i];
+        try {
+            command.register(ctx);
+            logger.debug("[CLI] Registered command: ".concat(command.name));
+        }
+        catch (error) {
+            logger.error("[CLI] Failed to register command \"".concat(command.name, "\":"), error instanceof Error ? error.message : String(error));
+        }
+    }
+}
+/**
+ * Clear all registered commands (for testing)
+ */
+export function clearCliCommands() {
+    commands.clear();
+}
+/**
+ * Helper to create a CLI command definition
+ */
+export function defineCliCommand(name, description, register, options) {
+    return {
+        name: name,
+        description: description,
+        register: register,
+        aliases: options === null || options === void 0 ? void 0 : options.aliases,
+        priority: options === null || options === void 0 ? void 0 : options.priority,
+    };
+}
+/**
+ * Helper to create a subcommand on an existing command
+ */
+export function addSubcommand(parent, name, description) {
+    return parent.command(name).description(description);
+}

package/dist/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * CLI plugin types
+ *
+ * Core types for CLI command registration and execution.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { Command } from "commander";
+/**
+ * Logger interface for CLI context
+ */
+export interface CliLogger {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    debug?: (msg: string) => void;
+}
+/**
+ * CLI context provided to command handlers
+ */
+export interface CliContext {
+    /** Commander program instance */
+    program: Command;
+    /** Optional runtime getter for plugins that need it */
+    getRuntime?: () => IAgentRuntime | null;
+    /** CLI name (e.g., "elizaos", "otto") */
+    cliName: string;
+    /** CLI version */
+    version: string;
+    /** Optional configuration object */
+    config?: Record<string, unknown>;
+    /** Optional workspace directory */
+    workspaceDir?: string;
+    /** Optional logger for CLI output */
+    logger?: CliLogger;
+}
+/**
+ * CLI command registration function signature
+ */
+export type CliRegistrationFn = (ctx: CliContext) => void;
+/**
+ * CLI command definition
+ */
+export interface CliCommand {
+    /** Command name (e.g., "run", "config") */
+    name: string;
+    /** Command description */
+    description: string;
+    /** Command aliases */
+    aliases?: string[];
+    /** Registration function */
+    register: CliRegistrationFn;
+    /** Priority for registration order (lower = earlier) */
+    priority?: number;
+}
+/**
+ * CLI plugin configuration
+ */
+export interface CliPluginConfig {
+    /** CLI name */
+    name?: string;
+    /** CLI version */
+    version?: string;
+    /** Commands to register */
+    commands?: CliCommand[];
+}
+/**
+ * Progress reporter interface
+ */
+export interface ProgressReporter {
+    /** Start progress reporting */
+    start(message: string): void;
+    /** Update progress message */
+    update(message: string): void;
+    /** Complete with success */
+    success(message: string): void;
+    /** Complete with failure */
+    fail(message: string): void;
+    /** Stop progress reporting */
+    stop(): void;
+}
+/**
+ * Progress options
+ */
+export interface ProgressOptions {
+    /** Initial message */
+    message?: string;
+    /** Whether to show spinner */
+    spinner?: boolean;
+}
+/**
+ * CLI dependencies for command execution
+ */
+export interface CliDeps {
+    /** Log function */
+    log: (message: string) => void;
+    /** Error function */
+    error: (message: string) => void;
+    /** Exit function */
+    exit: (code: number) => void;
+}
+/**
+ * Duration parsing result
+ */
+export interface ParsedDuration {
+    /** Duration in milliseconds */
+    ms: number;
+    /** Original string */
+    original: string;
+    /** Whether parsing was successful */
+    valid: boolean;
+}
+/**
+ * Command options commonly used across CLI commands
+ */
+export interface CommonCommandOptions {
+    /** JSON output format */
+    json?: boolean;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Quiet mode (minimal output) */
+    quiet?: boolean;
+    /** Force action without confirmation */
+    force?: boolean;
+    /** Dry run (show what would happen) */
+    dryRun?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * CLI plugin types
+ *
+ * Core types for CLI command registration and execution.
+ */
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,66 @@
+/**
+ * CLI utilities
+ *
+ * Common utilities for CLI operations.
+ */
+import type { CliDeps, ParsedDuration, ProgressOptions, ProgressReporter } from "./types.js";
+/**
+ * Default CLI name
+ */
+export declare const DEFAULT_CLI_NAME = "elizaos";
+/**
+ * Default CLI version
+ */
+export declare const DEFAULT_CLI_VERSION = "1.0.0";
+/**
+ * Create default CLI dependencies
+ */
+export declare function createDefaultDeps(): CliDeps;
+/**
+ * Create a progress reporter
+ */
+export declare function createProgressReporter(deps: CliDeps, options?: ProgressOptions): ProgressReporter;
+/**
+ * Execute with progress reporting
+ */
+export declare function withProgress<T>(deps: CliDeps, message: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Parse a duration string to milliseconds
+ *
+ * Supports formats like:
+ * - "1s", "30s" (seconds)
+ * - "1m", "5m" (minutes)
+ * - "1h", "2h" (hours)
+ * - "1d", "7d" (days)
+ * - "1000" (milliseconds)
+ */
+export declare function parseDurationMs(input: string): ParsedDuration;
+/**
+ * Parse a timeout string with defaults
+ */
+export declare function parseTimeoutMs(input: string | undefined, defaultMs: number): number;
+/**
+ * Format a CLI command with profile/env context
+ */
+export declare function formatCliCommand(command: string, options?: {
+    cliName?: string;
+    profile?: string;
+    env?: string;
+}): string;
+/**
+ * Resolve CLI name from argv
+ */
+export declare function resolveCliName(argv?: string[]): string;
+/**
+ * Check if running interactively
+ */
+export declare function isInteractive(): boolean;
+/**
+ * Format bytes to human readable string
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format duration to human readable string
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,gBAAgB,CA+DlB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAuD7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAStD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/utils.js

@@ -0,0 +1,281 @@
+/**
+ * CLI utilities
+ *
+ * Common utilities for CLI operations.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+/**
+ * Default CLI name
+ */
+export var DEFAULT_CLI_NAME = "elizaos";
+/**
+ * Default CLI version
+ */
+export var DEFAULT_CLI_VERSION = "1.0.0";
+/**
+ * Create default CLI dependencies
+ */
+export function createDefaultDeps() {
+    return {
+        log: function (message) { return console.log(message); },
+        error: function (message) { return console.error(message); },
+        exit: function (code) { return process.exit(code); },
+    };
+}
+/**
+ * Create a progress reporter
+ */
+export function createProgressReporter(deps, options) {
+    var _a;
+    var running = false;
+    var intervalId = null;
+    var spinnerFrames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    var frameIndex = 0;
+    var currentMessage = (_a = options === null || options === void 0 ? void 0 : options.message) !== null && _a !== void 0 ? _a : "";
+    var clearLine = function () {
+        if (process.stdout.isTTY) {
+            process.stdout.write("\r\x1b[K");
+        }
+    };
+    var writeSpinner = function () {
+        if (process.stdout.isTTY && (options === null || options === void 0 ? void 0 : options.spinner) !== false) {
+            clearLine();
+            process.stdout.write("".concat(spinnerFrames[frameIndex], " ").concat(currentMessage));
+            frameIndex = (frameIndex + 1) % spinnerFrames.length;
+        }
+    };
+    return {
+        start: function (message) {
+            currentMessage = message;
+            running = true;
+            if ((options === null || options === void 0 ? void 0 : options.spinner) !== false && process.stdout.isTTY) {
+                writeSpinner();
+                intervalId = setInterval(writeSpinner, 80);
+            }
+            else {
+                deps.log(message);
+            }
+        },
+        update: function (message) {
+            currentMessage = message;
+            if (!running && !process.stdout.isTTY) {
+                deps.log(message);
+            }
+        },
+        success: function (message) {
+            this.stop();
+            if (process.stdout.isTTY) {
+                clearLine();
+            }
+            deps.log("\u2713 ".concat(message));
+        },
+        fail: function (message) {
+            this.stop();
+            if (process.stdout.isTTY) {
+                clearLine();
+            }
+            deps.error("\u2717 ".concat(message));
+        },
+        stop: function () {
+            running = false;
+            if (intervalId) {
+                clearInterval(intervalId);
+                intervalId = null;
+            }
+            if (process.stdout.isTTY) {
+                clearLine();
+            }
+        },
+    };
+}
+/**
+ * Execute with progress reporting
+ */
+export function withProgress(deps, message, fn) {
+    return __awaiter(this, void 0, void 0, function () {
+        var progress, result, error_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    progress = createProgressReporter(deps, { message: message, spinner: true });
+                    progress.start(message);
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, fn()];
+                case 2:
+                    result = _a.sent();
+                    progress.success(message);
+                    return [2 /*return*/, result];
+                case 3:
+                    error_1 = _a.sent();
+                    progress.fail(error_1 instanceof Error ? error_1.message : String(error_1));
+                    throw error_1;
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Parse a duration string to milliseconds
+ *
+ * Supports formats like:
+ * - "1s", "30s" (seconds)
+ * - "1m", "5m" (minutes)
+ * - "1h", "2h" (hours)
+ * - "1d", "7d" (days)
+ * - "1000" (milliseconds)
+ */
+export function parseDurationMs(input) {
+    var _a;
+    var trimmed = input.trim().toLowerCase();
+    // Check for number only (milliseconds)
+    var numOnly = parseInt(trimmed, 10);
+    if (!Number.isNaN(numOnly) && String(numOnly) === trimmed) {
+        return { ms: numOnly, original: input, valid: true };
+    }
+    // Parse with unit
+    var match = trimmed.match(/^(\d+(?:\.\d+)?)\s*(s|sec|second|seconds|m|min|minute|minutes|h|hr|hour|hours|d|day|days|ms|millisecond|milliseconds)?$/);
+    if (!match) {
+        return { ms: 0, original: input, valid: false };
+    }
+    var value = parseFloat(match[1]);
+    var unit = (_a = match[2]) !== null && _a !== void 0 ? _a : "ms";
+    var multiplier;
+    switch (unit) {
+        case "ms":
+        case "millisecond":
+        case "milliseconds":
+            multiplier = 1;
+            break;
+        case "s":
+        case "sec":
+        case "second":
+        case "seconds":
+            multiplier = 1000;
+            break;
+        case "m":
+        case "min":
+        case "minute":
+        case "minutes":
+            multiplier = 60 * 1000;
+            break;
+        case "h":
+        case "hr":
+        case "hour":
+        case "hours":
+            multiplier = 60 * 60 * 1000;
+            break;
+        case "d":
+        case "day":
+        case "days":
+            multiplier = 24 * 60 * 60 * 1000;
+            break;
+        default:
+            return { ms: 0, original: input, valid: false };
+    }
+    return { ms: Math.round(value * multiplier), original: input, valid: true };
+}
+/**
+ * Parse a timeout string with defaults
+ */
+export function parseTimeoutMs(input, defaultMs) {
+    if (!input)
+        return defaultMs;
+    var parsed = parseDurationMs(input);
+    return parsed.valid ? parsed.ms : defaultMs;
+}
+/**
+ * Format a CLI command with profile/env context
+ */
+export function formatCliCommand(command, options) {
+    var _a;
+    var parts = [(_a = options === null || options === void 0 ? void 0 : options.cliName) !== null && _a !== void 0 ? _a : DEFAULT_CLI_NAME];
+    if (options === null || options === void 0 ? void 0 : options.profile) {
+        parts.push("--profile ".concat(options.profile));
+    }
+    if (options === null || options === void 0 ? void 0 : options.env) {
+        parts.push("--env ".concat(options.env));
+    }
+    parts.push(command);
+    return parts.join(" ");
+}
+/**
+ * Resolve CLI name from argv
+ */
+export function resolveCliName(argv) {
+    var _a;
+    var args = argv !== null && argv !== void 0 ? argv : process.argv;
+    if (args.length < 2)
+        return DEFAULT_CLI_NAME;
+    var scriptPath = args[1];
+    var scriptName = (_a = scriptPath.split("/").pop()) !== null && _a !== void 0 ? _a : DEFAULT_CLI_NAME;
+    // Remove common extensions
+    return scriptName.replace(/\.(js|ts|mjs|cjs)$/, "");
+}
+/**
+ * Check if running interactively
+ */
+export function isInteractive() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+/**
+ * Format bytes to human readable string
+ */
+export function formatBytes(bytes) {
+    var units = ["B", "KB", "MB", "GB", "TB"];
+    var unitIndex = 0;
+    var value = bytes;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex++;
+    }
+    return "".concat(value.toFixed(unitIndex === 0 ? 0 : 1), " ").concat(units[unitIndex]);
+}
+/**
+ * Format duration to human readable string
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return "".concat(ms, "ms");
+    if (ms < 60000)
+        return "".concat((ms / 1000).toFixed(1), "s");
+    if (ms < 3600000)
+        return "".concat((ms / 60000).toFixed(1), "m");
+    return "".concat((ms / 3600000).toFixed(1), "h");
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@elizaos/plugin-cli",
+  "version": "2.0.0-alpha.3",
+  "description": "CLI framework plugin for ElizaOS agents - provides command registration, execution, and utilities",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "lint": "bunx @biomejs/biome check --write --unsafe .",
+    "lint:check": "bunx @biomejs/biome check .",
+    "format": "bunx @biomejs/biome format --write .",
+    "format:check": "bunx @biomejs/biome format .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@elizaos/core": "2.0.0-alpha.3",
+    "commander": "^12.1.0"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "2.0.0-alpha.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5",
+    "@biomejs/biome": "^2.3.11"
+  },
+  "keywords": [
+    "elizaos",
+    "plugin",
+    "cli",
+    "command-line",
+    "terminal"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {
+      "CLI_NAME": {
+        "type": "string",
+        "description": "CLI command name",
+        "required": false,
+        "sensitive": false
+      },
+      "CLI_VERSION": {
+        "type": "string",
+        "description": "CLI version string",
+        "required": false,
+        "sensitive": false
+      }
+    }
+  }
+}