@getpaseo/cli 0.1.2

package/bin/paseo

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js'

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createCli(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA2BnC,wBAAgB,SAAS,IAAI,OAAO,CAkJnC"}

package/dist/cli.js

@@ -0,0 +1,150 @@
+import { Command } from 'commander';
+import { createAgentCommand } from './commands/agent/index.js';
+import { createDaemonCommand } from './commands/daemon/index.js';
+import { createPermitCommand } from './commands/permit/index.js';
+import { createProviderCommand } from './commands/provider/index.js';
+import { createSpeechCommand } from './commands/speech/index.js';
+import { createWorktreeCommand } from './commands/worktree/index.js';
+import { startCommand as daemonStartCommand } from './commands/daemon/start.js';
+import { runStatusCommand as runDaemonStatusCommand } from './commands/daemon/status.js';
+import { runRestartCommand as runDaemonRestartCommand } from './commands/daemon/restart.js';
+import { runLsCommand } from './commands/agent/ls.js';
+import { runRunCommand } from './commands/agent/run.js';
+import { runLogsCommand } from './commands/agent/logs.js';
+import { runStopCommand } from './commands/agent/stop.js';
+import { runSendCommand } from './commands/agent/send.js';
+import { runInspectCommand } from './commands/agent/inspect.js';
+import { runWaitCommand } from './commands/agent/wait.js';
+import { runAttachCommand } from './commands/agent/attach.js';
+import { withOutput } from './output/index.js';
+const VERSION = '0.1.0';
+// Helper function to collect multiple option values into an array
+function collectMultiple(value, previous) {
+    return previous.concat([value]);
+}
+export function createCli() {
+    const program = new Command();
+    program
+        .name('paseo')
+        .description('Paseo CLI - control your AI coding agents from the command line')
+        .version(VERSION, '-v, --version', 'output the version number')
+        // Global output options
+        .option('-o, --format <format>', 'output format: table, json, yaml', 'table')
+        .option('--json', 'output in JSON format (alias for --format json)')
+        .option('-q, --quiet', 'minimal output (IDs only)')
+        .option('--no-headers', 'omit table headers')
+        .option('--no-color', 'disable colored output');
+    // Primary agent commands (top-level)
+    program
+        .command('ls')
+        .description('List agents. By default excludes archived agents.')
+        .option('-a, --all', 'Include archived agents')
+        .option('-g, --global', 'Legacy no-op (kept for compatibility)')
+        .option('--label <key=value>', 'Filter by label (can be used multiple times)', collectMultiple, [])
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runLsCommand));
+    program
+        .command('run')
+        .description('Create and start an agent with a task')
+        .argument('<prompt>', 'The task/prompt for the agent')
+        .option('-d, --detach', 'Run in background (detached)')
+        .option('--name <name>', 'Assign a name/title to the agent')
+        .option('--provider <provider>', 'Agent provider: claude | codex | opencode', 'claude')
+        .option('--model <model>', 'Model to use (e.g., claude-sonnet-4-20250514, claude-3-5-haiku-20241022)')
+        .option('--mode <mode>', 'Provider-specific mode (e.g., plan, default, bypass)')
+        .option('--worktree <name>', 'Create agent in a new git worktree')
+        .option('--base <branch>', 'Base branch for worktree (default: current branch)')
+        .option('--image <path>', 'Attach image(s) to the initial prompt (can be used multiple times)', collectMultiple, [])
+        .option('--cwd <path>', 'Working directory (default: current)')
+        .option('--label <key=value>', 'Add label(s) to the agent (can be used multiple times)', collectMultiple, [])
+        .option('--ui', 'Mark as UI agent (equivalent to --label ui=true)')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runRunCommand));
+    program
+        .command('attach')
+        .description("Attach to a running agent's output stream")
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(runAttachCommand);
+    program
+        .command('logs')
+        .description('View agent activity/timeline')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('-f, --follow', 'Follow log output (streaming)')
+        .option('--tail <n>', 'Show last n entries')
+        .option('--filter <type>', 'Filter by event type (tools, text, errors, permissions)')
+        .option('--since <time>', 'Show logs since timestamp')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(runLogsCommand);
+    program
+        .command('stop')
+        .description('Stop an agent (cancel if running, then terminate)')
+        .argument('[id]', 'Agent ID (or prefix) - optional if --all or --cwd specified')
+        .option('--all', 'Stop all agents')
+        .option('--cwd <path>', 'Stop all agents in directory')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runStopCommand));
+    program
+        .command('send')
+        .description('Send a message/task to an existing agent')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .argument('<prompt>', 'The message to send')
+        .option('--no-wait', 'Return immediately without waiting for completion')
+        .option('--image <path>', 'Attach image(s) to the message', collectMultiple, [])
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runSendCommand));
+    program
+        .command('inspect')
+        .description('Show detailed information about an agent')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runInspectCommand));
+    program
+        .command('wait')
+        .description('Wait for an agent to become idle')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('--timeout <seconds>', 'Maximum wait time (default: 600)')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runWaitCommand));
+    // Top-level local daemon shortcuts
+    program.addCommand(daemonStartCommand());
+    program
+        .command('status')
+        .description('Show local daemon status (alias for "paseo daemon status")')
+        .option('--json', 'Output in JSON format')
+        .option('--home <path>', 'Paseo home directory (default: ~/.paseo)')
+        .action(withOutput(runDaemonStatusCommand));
+    program
+        .command('restart')
+        .description('Restart local daemon (alias for "paseo daemon restart")')
+        .option('--json', 'Output in JSON format')
+        .option('--home <path>', 'Paseo home directory (default: ~/.paseo)')
+        .option('--timeout <seconds>', 'Wait timeout before force step (default: 15)')
+        .option('--force', 'Send SIGKILL if graceful stop times out')
+        .option('--listen <listen>', 'Listen target for restarted daemon (host:port, port, or unix socket)')
+        .option('--port <port>', 'Port for restarted daemon listen target')
+        .option('--no-relay', 'Disable relay on restarted daemon')
+        .option('--no-mcp', 'Disable Agent MCP on restarted daemon')
+        .option('--allowed-hosts <hosts>', 'Comma-separated Host allowlist values (example: "localhost,.example.com" or "true")')
+        .action(withOutput(runDaemonRestartCommand));
+    // Advanced agent commands (less common operations)
+    program.addCommand(createAgentCommand());
+    // Daemon commands
+    program.addCommand(createDaemonCommand());
+    // Permission commands
+    program.addCommand(createPermitCommand());
+    // Provider commands
+    program.addCommand(createProviderCommand());
+    // Speech model commands
+    program.addCommand(createSpeechCommand());
+    // Worktree commands
+    program.addCommand(createWorktreeCommand());
+    return program;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/agent/archive.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from 'commander';
+import type { CommandOptions, SingleResult, OutputSchema } from '../../output/index.js';
+/** Result type for agent archive command */
+export interface AgentArchiveResult {
+    agentId: string;
+    status: 'archived';
+    archivedAt: string;
+}
+/** Schema for archive command output */
+export declare const archiveSchema: OutputSchema<AgentArchiveResult>;
+export interface AgentArchiveOptions extends CommandOptions {
+    force?: boolean;
+    host?: string;
+}
+export type AgentArchiveCommandResult = SingleResult<AgentArchiveResult>;
+export declare function runArchiveCommand(agentIdArg: string, options: AgentArchiveOptions, _command: Command): Promise<AgentArchiveCommandResult>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/commands/agent/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/archive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAgB,MAAM,uBAAuB,CAAA;AAErG,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,UAAU,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wCAAwC;AACxC,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,kBAAkB,CAO1D,CAAA;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,yBAAyB,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAA;AAExE,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,yBAAyB,CAAC,CAuFpC"}

package/dist/commands/agent/archive.js

@@ -0,0 +1,91 @@
+import { connectToDaemon, getDaemonHost } from '../../utils/client.js';
+/** Schema for archive command output */
+export const archiveSchema = {
+    idField: 'agentId',
+    columns: [
+        { header: 'AGENT ID', field: 'agentId' },
+        { header: 'STATUS', field: 'status' },
+        { header: 'ARCHIVED AT', field: 'archivedAt' },
+    ],
+};
+export async function runArchiveCommand(agentIdArg, options, _command) {
+    const host = getDaemonHost({ host: options.host });
+    // Validate arguments
+    if (!agentIdArg || agentIdArg.trim().length === 0) {
+        const error = {
+            code: 'MISSING_AGENT_ID',
+            message: 'Agent ID is required',
+            details: 'Usage: paseo agent archive <id>',
+        };
+        throw error;
+    }
+    let client;
+    try {
+        client = await connectToDaemon({ host: options.host });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const error = {
+            code: 'DAEMON_NOT_RUNNING',
+            message: `Cannot connect to daemon at ${host}: ${message}`,
+            details: 'Start the daemon with: paseo daemon start',
+        };
+        throw error;
+    }
+    try {
+        const agent = await client.fetchAgent(agentIdArg);
+        if (!agent) {
+            const error = {
+                code: 'AGENT_NOT_FOUND',
+                message: `Agent not found: ${agentIdArg}`,
+                details: 'Use "paseo ls" to list available agents',
+            };
+            throw error;
+        }
+        const agentId = agent.id;
+        // Check if agent is already archived
+        if (agent.archivedAt) {
+            const error = {
+                code: 'AGENT_ALREADY_ARCHIVED',
+                message: `Agent ${agentId.slice(0, 7)} is already archived`,
+                details: `Archived at: ${agent.archivedAt}`,
+            };
+            throw error;
+        }
+        // Check if agent is running and reject unless --force is set
+        if (agent.status === 'running' && !options.force) {
+            const error = {
+                code: 'AGENT_RUNNING',
+                message: `Agent ${agentId.slice(0, 7)} is currently running`,
+                details: 'Use --force to archive a running agent, or stop it first with: paseo agent stop',
+            };
+            throw error;
+        }
+        // Archive the agent
+        const result = await client.archiveAgent(agentId);
+        await client.close();
+        return {
+            type: 'single',
+            data: {
+                agentId,
+                status: 'archived',
+                archivedAt: result.archivedAt,
+            },
+            schema: archiveSchema,
+        };
+    }
+    catch (err) {
+        await client.close().catch(() => { });
+        // Re-throw CommandError as-is
+        if (err && typeof err === 'object' && 'code' in err) {
+            throw err;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        const error = {
+            code: 'ARCHIVE_FAILED',
+            message: `Failed to archive agent: ${message}`,
+        };
+        throw error;
+    }
+}
+//# sourceMappingURL=archive.js.map

package/dist/commands/agent/archive.js.map

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

package/dist/commands/agent/attach.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from 'commander';
+export interface AgentAttachOptions {
+    host?: string;
+    [key: string]: unknown;
+}
+/**
+ * Attach to a running agent's output stream
+ */
+export declare function runAttachCommand(id: string, options: AgentAttachOptions, _command: Command): Promise<void>;
+//# sourceMappingURL=attach.d.ts.map

package/dist/commands/agent/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/attach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUxC,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAgFD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAwGf"}

package/dist/commands/agent/attach.js

@@ -0,0 +1,166 @@
+import { connectToDaemon, getDaemonHost } from '../../utils/client.js';
+/**
+ * Format and print a timeline item to the terminal
+ */
+function printTimelineItem(item) {
+    switch (item.type) {
+        case 'assistant_message':
+            // Print assistant text directly
+            process.stdout.write(item.text);
+            break;
+        case 'reasoning':
+            // Print reasoning in a muted color if available
+            console.log(`\n[Reasoning] ${item.text}`);
+            break;
+        case 'tool_call': {
+            const toolName = item.name;
+            const status = item.status ?? 'started';
+            console.log(`\n[Tool: ${toolName}] ${status}`);
+            break;
+        }
+        case 'todo': {
+            const completed = item.items.filter((i) => i.completed).length;
+            const total = item.items.length;
+            console.log(`\n[Todo] ${completed}/${total} completed`);
+            break;
+        }
+        case 'error':
+            console.error(`\n[Error] ${item.message}`);
+            break;
+        case 'user_message':
+            console.log(`\n[User] ${item.text}`);
+            break;
+        default:
+            // Unknown item type, skip
+            break;
+    }
+}
+/**
+ * Format and print a stream event to the terminal
+ */
+function printStreamEvent(event) {
+    switch (event.type) {
+        case 'timeline':
+            // Print the timeline item
+            printTimelineItem(event.item);
+            break;
+        case 'permission_requested':
+            console.log(`\n[Permission Required] ${event.request.name}`);
+            if (event.request.description) {
+                console.log(`  ${event.request.description}`);
+            }
+            break;
+        case 'permission_resolved':
+            console.log(`\n[Permission ${event.resolution.behavior}]`);
+            break;
+        case 'turn_failed':
+            console.error(`\n[Turn Failed] ${event.error}`);
+            break;
+        case 'attention_required':
+            console.log(`\n[Attention Required: ${event.reason}]`);
+            break;
+        default:
+            // Other event types are internal
+            break;
+    }
+}
+/**
+ * Attach to a running agent's output stream
+ */
+export async function runAttachCommand(id, options, _command) {
+    const host = getDaemonHost({ host: options.host });
+    if (!id) {
+        console.error('Error: Agent ID required');
+        console.error('Usage: paseo attach <id>');
+        process.exit(1);
+    }
+    let client;
+    try {
+        client = await connectToDaemon({ host: options.host });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: Cannot connect to daemon at ${host}: ${message}`);
+        console.error('Start the daemon with: paseo daemon start');
+        process.exit(1);
+    }
+    try {
+        const agent = await client.fetchAgent(id);
+        if (!agent) {
+            console.error(`Error: No agent found matching: ${id}`);
+            console.error('Use `paseo ls` to list available agents');
+            await client.close();
+            process.exit(1);
+        }
+        const resolvedId = agent.id;
+        // Print header
+        console.log(`Attaching to agent ${resolvedId.substring(0, 7)}...`);
+        console.log(`(Press Ctrl+C to detach)\n`);
+        // Get existing output from snapshot
+        const snapshotPromise = new Promise((resolve) => {
+            const timeout = setTimeout(() => resolve(), 5000);
+            const unsubscribe = client.on('agent_stream_snapshot', (msg) => {
+                const message = msg;
+                if (message.type !== 'agent_stream_snapshot')
+                    return;
+                if (message.payload.agentId !== resolvedId)
+                    return;
+                clearTimeout(timeout);
+                unsubscribe();
+                // Print recent events from snapshot
+                for (const e of message.payload.events) {
+                    printStreamEvent(e.event);
+                }
+                resolve();
+            });
+        });
+        // Initialize agent to trigger snapshot
+        try {
+            await client.initializeAgent(resolvedId);
+        }
+        catch {
+            // Agent might already be initialized, continue
+        }
+        // Wait for snapshot
+        await snapshotPromise;
+        // Subscribe to new events
+        const unsubscribe = client.on('agent_stream', (msg) => {
+            const message = msg;
+            if (message.type !== 'agent_stream')
+                return;
+            if (message.payload.agentId !== resolvedId)
+                return;
+            printStreamEvent(message.payload.event);
+        });
+        // Handle Ctrl+C to detach gracefully
+        let detached = false;
+        const detach = () => {
+            if (detached)
+                return;
+            detached = true;
+            console.log('\n\nDetaching from agent...');
+            unsubscribe();
+            client
+                .close()
+                .then(() => {
+                process.exit(0);
+            })
+                .catch(() => {
+                process.exit(1);
+            });
+        };
+        process.on('SIGINT', detach);
+        process.on('SIGTERM', detach);
+        // Keep the process alive
+        await new Promise(() => {
+            // Wait indefinitely until interrupted
+        });
+    }
+    catch (err) {
+        await client.close().catch(() => { });
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: Failed to attach to agent: ${message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=attach.js.map

package/dist/commands/agent/attach.js.map

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

package/dist/commands/agent/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createAgentCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAanC,wBAAgB,kBAAkB,IAAI,OAAO,CA8G5C"}

package/dist/commands/agent/index.js

@@ -0,0 +1,112 @@
+import { Command } from 'commander';
+import { runModeCommand } from './mode.js';
+import { runArchiveCommand } from './archive.js';
+import { runLsCommand } from './ls.js';
+import { runRunCommand } from './run.js';
+import { runLogsCommand } from './logs.js';
+import { runStopCommand } from './stop.js';
+import { runSendCommand } from './send.js';
+import { runInspectCommand } from './inspect.js';
+import { runWaitCommand } from './wait.js';
+import { runAttachCommand } from './attach.js';
+import { withOutput } from '../../output/index.js';
+export function createAgentCommand() {
+    const agent = new Command('agent').description('Manage agents (advanced operations)');
+    // Helper function to collect multiple option values into an array
+    const collectMultiple = (value, previous) => {
+        return previous.concat([value]);
+    };
+    // Primary agent commands (same as top-level)
+    agent
+        .command('ls')
+        .description('List agents. By default excludes archived agents.')
+        .option('-a, --all', 'Include archived agents')
+        .option('-g, --global', 'Legacy no-op (kept for compatibility)')
+        .option('--label <key=value>', 'Filter by label (can be used multiple times)', collectMultiple, [])
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runLsCommand));
+    agent
+        .command('run')
+        .description('Create and start an agent with a task')
+        .argument('<prompt>', 'The task/prompt for the agent')
+        .option('-d, --detach', 'Run in background (detached)')
+        .option('--name <name>', 'Assign a name/title to the agent')
+        .option('--provider <provider>', 'Agent provider: claude | codex | opencode', 'claude')
+        .option('--model <model>', 'Model to use (e.g., claude-sonnet-4-20250514, claude-3-5-haiku-20241022)')
+        .option('--mode <mode>', 'Provider-specific mode (e.g., plan, default, bypass)')
+        .option('--cwd <path>', 'Working directory (default: current)')
+        .option('--label <key=value>', 'Add label(s) to the agent (can be used multiple times)', collectMultiple, [])
+        .option('--ui', 'Mark as UI agent (equivalent to --label ui=true)')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runRunCommand));
+    agent
+        .command('attach')
+        .description("Attach to a running agent's output stream")
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(runAttachCommand);
+    agent
+        .command('logs')
+        .description('View agent activity/timeline')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('-f, --follow', 'Follow log output (streaming)')
+        .option('--tail <n>', 'Show last n entries')
+        .option('--filter <type>', 'Filter by event type (tools, text, errors, permissions)')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(runLogsCommand);
+    agent
+        .command('stop')
+        .description('Stop an agent (cancel if running, then terminate)')
+        .argument('[id]', 'Agent ID (or prefix) - optional if --all or --cwd specified')
+        .option('--all', 'Stop all agents')
+        .option('--cwd <path>', 'Stop all agents in directory')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runStopCommand));
+    agent
+        .command('send')
+        .description('Send a message/task to an existing agent')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .argument('<prompt>', 'The message to send')
+        .option('--no-wait', 'Return immediately without waiting for completion')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runSendCommand));
+    agent
+        .command('inspect')
+        .description('Show detailed information about an agent')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runInspectCommand));
+    agent
+        .command('wait')
+        .description('Wait for an agent to become idle')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('--timeout <seconds>', 'Maximum wait time (default: 600)')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runWaitCommand));
+    // Advanced agent commands (less common operations)
+    agent
+        .command('mode')
+        .description("Change an agent's operational mode")
+        .argument('<id>', 'Agent ID (or prefix)')
+        .argument('[mode]', 'Mode to set (required unless --list)')
+        .option('--list', 'List available modes for this agent')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runModeCommand));
+    agent
+        .command('archive')
+        .description('Archive an agent (soft-delete)')
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('--force', 'Force archive running agent')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runArchiveCommand));
+    return agent;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/agent/index.js.map

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

package/dist/commands/agent/inspect.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from 'commander';
+import type { CommandOptions, ListResult } from '../../output/index.js';
+/** Key-value row for table display */
+interface InspectRow {
+    key: string;
+    value: string;
+}
+export type AgentInspectResult = ListResult<InspectRow>;
+export interface AgentInspectOptions extends CommandOptions {
+    host?: string;
+}
+export declare function runInspectCommand(agentIdArg: string, options: AgentInspectOptions, _command: Command): Promise<AgentInspectResult>;
+export {};
+//# sourceMappingURL=inspect.d.ts.map

package/dist/commands/agent/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAA8B,MAAM,uBAAuB,CAAA;AAqCnG,sCAAsC;AACtC,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AA0ID,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;AAEvD,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,kBAAkB,CAAC,CA6D7B"}