@elizaos/plugin-cli 2.0.0-alpha.9 → 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# @elizaos/plugin-cli
+
+CLI framework plugin for elizaOS agents. Provides a Commander-based command registry, TTY-aware progress reporting, and common helpers (duration parsing, byte formatting) for building agent-driven CLI tools.
+
+## What it does
+
+- Maintains a module-level registry of `CliCommand` objects that other plugins or host code populate.
+- Assembles a Commander `Command` tree from the registry via `buildProgram` / `runCli`.
+- Offers a TTY-aware spinner (`createProgressReporter`, `withProgress`) that degrades to plain log lines in non-interactive environments.
+- Ships parsing and formatting helpers for durations (`parseDurationMs`, `formatDuration`) and byte sizes (`formatBytes`).
+
+The plugin object (`cliPlugin`) registers no actions, providers, services, or routes. Its value is the exported API that other code calls.
+
+## Capabilities
+
+| Export | Description |
+|--------|-------------|
+| `buildProgram(options?)` | Builds a Commander program from all registered commands |
+| `runCli(argv?, options?)` | Builds and runs the program against `argv` (defaults to `process.argv`) |
+| `registerCliCommand(cmd)` | Register a `CliCommand` in the shared registry |
+| `defineCliCommand(...)` | Factory to construct a `CliCommand` |
+| `unregisterCliCommand(name)` | Remove a command from the registry |
+| `listCliCommands()` | Returns all registered commands sorted by `priority` |
+| `addSubcommand(parent, name, desc)` | Attach a subcommand to an existing Commander command |
+| `createProgressReporter(deps, options?)` | TTY-aware spinner / progress reporter |
+| `withProgress(deps, message, fn)` | Run an async function wrapped with start/success/fail reporting |
+| `parseDurationMs(input)` | Parse `"1s"`, `"5m"`, `"2h"`, `"7d"`, bare ms strings |
+| `parseTimeoutMs(input?, defaultMs)` | `parseDurationMs` with a default fallback |
+| `formatDuration(ms)` | Milliseconds → human-readable string |
+| `formatBytes(bytes)` | Bytes → human-readable string |
+| `isInteractive()` | Returns `true` when both stdin and stdout are TTYs |
+
+## Installation
+
+```bash
+bun add @elizaos/plugin-cli
+```
+
+Add to your agent's plugin list:
+
+```typescript
+import { cliPlugin } from "@elizaos/plugin-cli";
+
+export const character = {
+  plugins: [cliPlugin],
+  // ...
+};
+```
+
+## Registering commands
+
+```typescript
+import { defineCliCommand, registerCliCommand, runCli } from "@elizaos/plugin-cli";
+
+registerCliCommand(
+  defineCliCommand(
+    "greet",
+    "Print a greeting",
+    (ctx) => {
+      ctx.program
+        .command("greet")
+        .description("Print a greeting")
+        .argument("<name>", "Name to greet")
+        .action((name) => {
+          console.log(`Hello, ${name}!`);
+        });
+    },
+  ),
+);
+
+await runCli(process.argv, { name: "myapp", version: "1.0.0" });
+```
+
+## Configuration
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `CLI_NAME` | No | `"elizaos"` | CLI binary name in help output |
+| `CLI_VERSION` | No | `"1.0.0"` | Version string shown by `--version` |
+
+Pass directly to `buildProgram` / `runCli` as options (`{ name, version }`). These values are declared in `agentConfig.pluginParameters` but are not read from `process.env` — the `init` function does not use its config parameter.
+
+## Using the progress reporter
+
+```typescript
+import { createDefaultDeps, withProgress } from "@elizaos/plugin-cli";
+
+const deps = createDefaultDeps();
+
+await withProgress(deps, "Fetching data", async () => {
+  await fetchSomething();
+});
+// Prints spinner while running, then "✓ Fetching data" or "✗ <error message>"
+```
+
+## Duration parsing
+
+```typescript
+import { parseDurationMs } from "@elizaos/plugin-cli";
+
+parseDurationMs("5m");   // { ms: 300000, valid: true, original: "5m" }
+parseDurationMs("30s");  // { ms: 30000,  valid: true, original: "30s" }
+parseDurationMs("bad");  // { ms: 0,      valid: false, original: "bad" }
+```
+
+Supported units: `ms`, `s`/`sec`/`second(s)`, `m`/`min`/`minute(s)`, `h`/`hr`/`hour(s)`, `d`/`day(s)`. Plain integers are treated as milliseconds.
+
+## Notes
+
+- The command registry is module-level state shared across all imports in the same process. In tests, call `clearCliCommands()` in `beforeEach` / `afterEach`.
+- All commands must be registered before `buildProgram` / `runCli` is called.
+- The progress spinner writes ANSI escape sequences directly to `process.stdout` when running in a TTY; it degrades gracefully in CI and piped output.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-cli",
-  "version": "2.0.0-alpha.9",
+  "version": "2.0.3-beta.2",
   "description": "CLI framework plugin for ElizaOS agents - provides command registration, execution, and utilities",
   "type": "module",
   "main": "dist/index.js",
@@ -8,8 +8,24 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
@@ -19,24 +35,21 @@
     "build": "tsc",
     "build:watch": "tsc --watch",
     "dev": "tsc --watch",
-    "test": "vitest run --passWithNoTests",
+    "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"
+    "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-alpha.3",
-    "commander": "^12.1.0"
-  },
-  "peerDependencies": {
-    "@elizaos/core": "2.0.0-alpha.3"
+    "@elizaos/core": "2.0.3-beta.2",
+    "commander": "^15.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.11",
+    "@biomejs/biome": "^2.4.14",
     "strip-literal": "^3.1.0",
-    "typescript": "^5.7.3",
+    "typescript": "^6.0.3",
     "vitest": "^4.0.18"
   },
   "keywords": [
@@ -66,5 +79,6 @@
         "sensitive": false
       }
     }
-  }
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
 }

package/dist/index.d.ts

@@ -1,90 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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,EACN,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,eAAe,CAAC;AAEvB,cAAc,YAAY,CAAC;AAG3B,OAAO,EACN,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,GACZ,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CACxC,GAAG,OAAO,CAoBV;AAED;;GAEG;AACH,wBAAsB,MAAM,CAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CACxC,GACC,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

@@ -1,113 +0,0 @@
-/**
- * @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 { 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) {
-    const cliName = options?.name ?? resolveCliName();
-    const version = options?.version ?? DEFAULT_CLI_VERSION;
-    const program = new Command()
-        .name(cliName)
-        .version(version)
-        .description(`${cliName} - ElizaOS agent CLI`);
-    const ctx = {
-        program,
-        getRuntime: options?.getRuntime,
-        cliName,
-        version,
-    };
-    // Register all commands
-    registerAllCommands(ctx);
-    return program;
-}
-/**
- * Run the CLI with the given arguments
- */
-export async function runCli(argv, options) {
-    const program = buildProgram(options);
-    try {
-        await program.parseAsync(argv ?? process.argv);
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            // Commander throws an error for --help and --version
-            if (error.message.includes("outputHelp")) {
-                return;
-            }
-        }
-        throw error;
-    }
-}
-/**
- * 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 const 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,
-    },
-    async init(_config, _runtime) {
-        try {
-            const 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;
-        }
-    },
-};
-export default cliPlugin;
-// Re-export Command for convenience
-export { Command } from "commander";

package/dist/registry.d.ts

@@ -1,52 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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,CAC/B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE;IACT,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,GACC,UAAU,CAQZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GACjB,OAAO,CAET"}

package/dist/registry.js

@@ -1,76 +0,0 @@
-/**
- * CLI command registry
- *
- * Provides command registration and management for the CLI plugin.
- */
-import { logger } from "@elizaos/core";
-/**
- * Internal registry of CLI commands
- */
-const commands = new Map();
-/**
- * Register a CLI command
- */
-export function registerCliCommand(command) {
-    if (commands.has(command.name)) {
-        logger.warn(`[CLI] Command "${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((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
-}
-/**
- * Register all commands with the program
- */
-export function registerAllCommands(ctx) {
-    const sorted = listCliCommands();
-    for (const command of sorted) {
-        try {
-            command.register(ctx);
-            logger.debug(`[CLI] Registered command: ${command.name}`);
-        }
-        catch (error) {
-            logger.error(`[CLI] Failed to register command "${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,
-        description,
-        register,
-        aliases: options?.aliases,
-        priority: 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

@@ -1,127 +0,0 @@
-/**
- * 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

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

package/dist/types.js

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

package/dist/utils.d.ts

@@ -1,84 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,OAAO,EACP,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,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,CACrC,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,eAAe,GACvB,gBAAgB,CA+DlB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EACnC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAuD7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,GACf,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,GACC,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

@@ -1,229 +0,0 @@
-/**
- * CLI utilities
- *
- * Common utilities for CLI operations.
- */
-/**
- * Default CLI name
- */
-export const DEFAULT_CLI_NAME = "elizaos";
-/**
- * Default CLI version
- */
-export const DEFAULT_CLI_VERSION = "1.0.0";
-/**
- * Create default CLI dependencies
- */
-export function createDefaultDeps() {
-    return {
-        log: (message) => console.log(message),
-        error: (message) => console.error(message),
-        exit: (code) => process.exit(code),
-    };
-}
-/**
- * Create a progress reporter
- */
-export function createProgressReporter(deps, options) {
-    let running = false;
-    let intervalId = null;
-    const spinnerFrames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-    let frameIndex = 0;
-    let currentMessage = options?.message ?? "";
-    const clearLine = () => {
-        if (process.stdout.isTTY) {
-            process.stdout.write("\r\x1b[K");
-        }
-    };
-    const writeSpinner = () => {
-        if (process.stdout.isTTY && options?.spinner !== false) {
-            clearLine();
-            process.stdout.write(`${spinnerFrames[frameIndex]} ${currentMessage}`);
-            frameIndex = (frameIndex + 1) % spinnerFrames.length;
-        }
-    };
-    return {
-        start(message) {
-            currentMessage = message;
-            running = true;
-            if (options?.spinner !== false && process.stdout.isTTY) {
-                writeSpinner();
-                intervalId = setInterval(writeSpinner, 80);
-            }
-            else {
-                deps.log(message);
-            }
-        },
-        update(message) {
-            currentMessage = message;
-            if (!running && !process.stdout.isTTY) {
-                deps.log(message);
-            }
-        },
-        success(message) {
-            this.stop();
-            if (process.stdout.isTTY) {
-                clearLine();
-            }
-            deps.log(`✓ ${message}`);
-        },
-        fail(message) {
-            this.stop();
-            if (process.stdout.isTTY) {
-                clearLine();
-            }
-            deps.error(`✗ ${message}`);
-        },
-        stop() {
-            running = false;
-            if (intervalId) {
-                clearInterval(intervalId);
-                intervalId = null;
-            }
-            if (process.stdout.isTTY) {
-                clearLine();
-            }
-        },
-    };
-}
-/**
- * Execute with progress reporting
- */
-export async function withProgress(deps, message, fn) {
-    const progress = createProgressReporter(deps, { message, spinner: true });
-    progress.start(message);
-    try {
-        const result = await fn();
-        progress.success(message);
-        return result;
-    }
-    catch (error) {
-        progress.fail(error instanceof Error ? error.message : String(error));
-        throw error;
-    }
-}
-/**
- * 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) {
-    const trimmed = input.trim().toLowerCase();
-    // Check for number only (milliseconds)
-    const numOnly = parseInt(trimmed, 10);
-    if (!Number.isNaN(numOnly) && String(numOnly) === trimmed) {
-        return { ms: numOnly, original: input, valid: true };
-    }
-    // Parse with unit
-    const 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 };
-    }
-    const value = parseFloat(match[1]);
-    const unit = match[2] ?? "ms";
-    let 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;
-    const parsed = parseDurationMs(input);
-    return parsed.valid ? parsed.ms : defaultMs;
-}
-/**
- * Format a CLI command with profile/env context
- */
-export function formatCliCommand(command, options) {
-    const parts = [options?.cliName ?? DEFAULT_CLI_NAME];
-    if (options?.profile) {
-        parts.push(`--profile ${options.profile}`);
-    }
-    if (options?.env) {
-        parts.push(`--env ${options.env}`);
-    }
-    parts.push(command);
-    return parts.join(" ");
-}
-/**
- * Resolve CLI name from argv
- */
-export function resolveCliName(argv) {
-    const args = argv ?? process.argv;
-    if (args.length < 2)
-        return DEFAULT_CLI_NAME;
-    const scriptPath = args[1];
-    const scriptName = scriptPath.split("/").pop() ?? 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) {
-    const units = ["B", "KB", "MB", "GB", "TB"];
-    let unitIndex = 0;
-    let value = bytes;
-    while (value >= 1024 && unitIndex < units.length - 1) {
-        value /= 1024;
-        unitIndex++;
-    }
-    return `${value.toFixed(unitIndex === 0 ? 0 : 1)} ${units[unitIndex]}`;
-}
-/**
- * Format duration to human readable string
- */
-export function formatDuration(ms) {
-    if (ms < 1000)
-        return `${ms}ms`;
-    if (ms < 60000)
-        return `${(ms / 1000).toFixed(1)}s`;
-    if (ms < 3600000)
-        return `${(ms / 60000).toFixed(1)}m`;
-    return `${(ms / 3600000).toFixed(1)}h`;
-}