@junctionpanel/cli 0.1.16

package/dist/commands/agent/index.js

@@ -0,0 +1,125 @@
+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 { runUpdateCommand } from './update.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('--thinking <id>', 'Filter by thinking option ID')
+        .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('--thinking <id>', 'Thinking option ID to use for this run')
+        .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('--output-schema <schema>', 'Output JSON matching the provided schema file path or inline JSON schema')
+        .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: no limit)')
+        .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 (interrupts active run first)')
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runArchiveCommand));
+    agent
+        .command('update')
+        .description("Update an agent's metadata")
+        .argument('<id>', 'Agent ID (or prefix)')
+        .option('--name <name>', "Update the agent's display name")
+        .option('--label <label>', 'Add/set label(s) on the agent (can be used multiple times or comma-separated)', collectMultiple, [])
+        .option('--json', 'Output in JSON format')
+        .option('--host <host>', 'Daemon host:port (default: localhost:6767)')
+        .action(withOutput(runUpdateCommand));
+    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;AAsCnG,sCAAsC;AACtC,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAuJD,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"}

package/dist/commands/agent/inspect.js

@@ -0,0 +1,198 @@
+import { connectToDaemon, getDaemonHost } from '../../utils/client.js';
+/** Schema for key-value display with custom serialization for JSON/YAML */
+function createInspectSchema(agent) {
+    return {
+        idField: 'key',
+        columns: [
+            { header: 'KEY', field: 'key' },
+            {
+                header: 'VALUE',
+                field: 'value',
+                color: (_, item) => {
+                    if (item.key === 'Status') {
+                        if (item.value === 'running')
+                            return 'green';
+                        if (item.value === 'idle')
+                            return 'yellow';
+                        if (item.value === 'error')
+                            return 'red';
+                    }
+                    return undefined;
+                },
+            },
+        ],
+        // For JSON/YAML, return the structured agent object
+        serialize: (_item) => agent,
+    };
+}
+/** Shorten home directory in path */
+function shortenPath(path) {
+    const home = process.env.HOME;
+    if (home && path.startsWith(home)) {
+        return '~' + path.slice(home.length);
+    }
+    return path;
+}
+/** Format cost in USD */
+function formatCost(costUsd) {
+    if (costUsd === 0)
+        return '$0.00';
+    if (costUsd < 0.01)
+        return `$${costUsd.toFixed(4)}`;
+    return `$${costUsd.toFixed(2)}`;
+}
+function normalizeModelId(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value.trim();
+    if (!normalized || normalized.toLowerCase() === 'default')
+        return null;
+    return normalized;
+}
+function resolveModel(snapshot) {
+    return normalizeModelId(snapshot.runtimeInfo?.model) ?? normalizeModelId(snapshot.model);
+}
+/** Convert agent snapshot to inspection data */
+function toInspectData(snapshot) {
+    const lastUsage = snapshot.lastUsage
+        ? {
+            InputTokens: snapshot.lastUsage.inputTokens ?? 0,
+            OutputTokens: snapshot.lastUsage.outputTokens ?? 0,
+            CachedTokens: snapshot.lastUsage.cachedInputTokens ?? 0,
+            CostUsd: snapshot.lastUsage.totalCostUsd ?? 0,
+        }
+        : null;
+    const capabilities = snapshot.capabilities
+        ? {
+            Streaming: snapshot.capabilities.supportsStreaming ?? false,
+            Persistence: snapshot.capabilities.supportsSessionPersistence ?? false,
+            DynamicModes: snapshot.capabilities.supportsDynamicModes ?? false,
+            McpServers: snapshot.capabilities.supportsMcpServers ?? false,
+        }
+        : null;
+    // Extract worktree and parentAgentId from labels if they exist
+    const worktree = snapshot.labels?.['junction.worktree'] ?? null;
+    const parentAgentId = snapshot.labels?.['junction.parent-agent-id'] ?? null;
+    return {
+        Id: snapshot.id,
+        Name: snapshot.title ?? '-',
+        Provider: snapshot.provider,
+        Model: resolveModel(snapshot) ?? '-',
+        Thinking: snapshot.effectiveThinkingOptionId ?? 'auto',
+        Status: snapshot.status,
+        Mode: snapshot.currentModeId ?? 'default',
+        Cwd: snapshot.cwd,
+        CreatedAt: snapshot.createdAt,
+        UpdatedAt: snapshot.updatedAt,
+        LastUsage: lastUsage,
+        Capabilities: capabilities,
+        AvailableModes: snapshot.availableModes
+            ? snapshot.availableModes.map((m) => ({ id: m.id, label: m.label }))
+            : null,
+        PendingPermissions: (snapshot.pendingPermissions ?? []).map((p) => ({
+            id: p.id,
+            tool: p.name ?? 'unknown',
+        })),
+        Worktree: worktree,
+        ParentAgentId: parentAgentId,
+    };
+}
+/** Convert agent to key-value rows for table display */
+function toInspectRows(agent) {
+    const rows = [
+        { key: 'Id', value: agent.Id },
+        { key: 'Name', value: agent.Name },
+        { key: 'Provider', value: agent.Provider },
+        { key: 'Model', value: agent.Model },
+        { key: 'Thinking', value: agent.Thinking },
+        { key: 'Status', value: agent.Status },
+        { key: 'Mode', value: agent.Mode },
+        { key: 'Cwd', value: shortenPath(agent.Cwd) },
+        { key: 'CreatedAt', value: agent.CreatedAt },
+        { key: 'UpdatedAt', value: agent.UpdatedAt },
+    ];
+    if (agent.LastUsage) {
+        rows.push({
+            key: 'LastUsage',
+            value: `InputTokens: ${agent.LastUsage.InputTokens}, OutputTokens: ${agent.LastUsage.OutputTokens}, CachedTokens: ${agent.LastUsage.CachedTokens}, CostUsd: ${formatCost(agent.LastUsage.CostUsd)}`,
+        });
+    }
+    if (agent.Capabilities) {
+        rows.push({
+            key: 'Capabilities',
+            value: `Streaming: ${agent.Capabilities.Streaming}, Persistence: ${agent.Capabilities.Persistence}, DynamicModes: ${agent.Capabilities.DynamicModes}, McpServers: ${agent.Capabilities.McpServers}`,
+        });
+    }
+    if (agent.AvailableModes && agent.AvailableModes.length > 0) {
+        rows.push({
+            key: 'AvailableModes',
+            value: agent.AvailableModes.map((m) => `${m.id} (${m.label})`).join(', '),
+        });
+    }
+    rows.push({
+        key: 'PendingPermissions',
+        value: agent.PendingPermissions.length > 0
+            ? agent.PendingPermissions.map(p => `${p.id} (${p.tool})`).join(', ')
+            : '[]'
+    });
+    rows.push({ key: 'Worktree', value: agent.Worktree ?? 'null' });
+    rows.push({ key: 'ParentAgentId', value: agent.ParentAgentId ?? 'null' });
+    return rows;
+}
+export async function runInspectCommand(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: junction agent inspect <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: junction daemon start',
+        };
+        throw error;
+    }
+    try {
+        const fetchResult = await client.fetchAgent(agentIdArg);
+        if (!fetchResult) {
+            const error = {
+                code: 'AGENT_NOT_FOUND',
+                message: `Agent not found: ${agentIdArg}`,
+                details: 'Use "junction ls" to list available agents',
+            };
+            throw error;
+        }
+        await client.close();
+        const inspectData = toInspectData(fetchResult.agent);
+        return {
+            type: 'list',
+            data: toInspectRows(inspectData),
+            schema: createInspectSchema(inspectData),
+        };
+    }
+    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: 'INSPECT_FAILED',
+            message: `Failed to inspect agent: ${message}`,
+        };
+        throw error;
+    }
+}
+//# sourceMappingURL=inspect.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { Command } from 'commander';
+import type { CommandOptions } from '../../output/index.js';
+import type { DaemonClient, AgentTimelineItem } from '@junctionpanel/server';
+export interface AgentLogsOptions extends CommandOptions {
+    follow?: boolean;
+    tail?: string;
+    filter?: string;
+    since?: string;
+}
+export type AgentLogsResult = void;
+export declare const NO_ACTIVITY_MESSAGE = "No activity to display.";
+export declare function fetchAgentTimelineItems(client: DaemonClient, agentId: string): Promise<AgentTimelineItem[]>;
+export declare function formatAgentActivityTranscript(timelineItems: AgentTimelineItem[], tailCount?: number): string;
+export declare function runLogsCommand(id: string, options: AgentLogsOptions, _command: Command): Promise<AgentLogsResult>;
+//# sourceMappingURL=logs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,KAAK,EACV,YAAY,EAEZ,iBAAiB,EAClB,MAAM,uBAAuB,CAAA;AAG9B,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAGD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAA;AAElC,eAAO,MAAM,mBAAmB,4BAA4B,CAAA;AAE5D,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAE9B;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,iBAAiB,EAAE,EAClC,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAQR;AAoCD,wBAAsB,cAAc,CAClC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,eAAe,CAAC,CAwE1B"}

package/dist/commands/agent/logs.js

@@ -0,0 +1,163 @@
+import { connectToDaemon, getDaemonHost } from '../../utils/client.js';
+import { fetchProjectedTimelineItems } from '../../utils/timeline.js';
+import { curateAgentActivity } from '@junctionpanel/server';
+export const NO_ACTIVITY_MESSAGE = 'No activity to display.';
+export async function fetchAgentTimelineItems(client, agentId) {
+    return fetchProjectedTimelineItems({ client, agentId });
+}
+export function formatAgentActivityTranscript(timelineItems, tailCount) {
+    if (tailCount === 0) {
+        return '';
+    }
+    return curateAgentActivity(timelineItems, tailCount !== undefined ? { maxItems: tailCount } : undefined);
+}
+function parseTailCount(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number.parseInt(raw, 10);
+    if (Number.isNaN(parsed) || parsed < 0) {
+        return undefined;
+    }
+    return parsed;
+}
+/**
+ * Check if a timeline item matches the filter type
+ */
+function matchesFilter(item, filter) {
+    if (!filter)
+        return true;
+    const filterLower = filter.toLowerCase();
+    const type = item.type.toLowerCase();
+    switch (filterLower) {
+        case 'tools':
+            return type === 'tool_call';
+        case 'text':
+            return type === 'user_message' || type === 'assistant_message' || type === 'reasoning';
+        case 'errors':
+            return type === 'error';
+        case 'permissions':
+            // Permissions might be in tool_call status or a separate event type
+            return type.includes('permission');
+        default:
+            // If filter doesn't match predefined types, match against the actual type
+            return type.includes(filterLower);
+    }
+}
+export async function runLogsCommand(id, options, _command) {
+    const host = getDaemonHost({ host: options.host });
+    if (!id) {
+        console.error('Error: Agent ID required');
+        console.error('Usage: junction agent logs <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: junction daemon start');
+        process.exit(1);
+    }
+    try {
+        const fetchResult = await client.fetchAgent(id);
+        if (!fetchResult) {
+            console.error(`Error: No agent found matching: ${id}`);
+            console.error('Use `junction ls` to list available agents');
+            await client.close();
+            process.exit(1);
+        }
+        const resolvedId = fetchResult.agent.id;
+        // For follow mode, we stream events continuously
+        if (options.follow) {
+            if (options.tail !== undefined && parseTailCount(options.tail) === undefined) {
+                console.error(`Error: Invalid --tail value: ${options.tail}`);
+                console.error('Usage: --tail <n> (where n is >= 0)');
+                await client.close().catch(() => { });
+                process.exit(1);
+            }
+            await runFollowMode(client, resolvedId, options);
+            return;
+        }
+        // Fetch timeline directly via cursor RPC.
+        let timelineItems = await fetchAgentTimelineItems(client, resolvedId);
+        // Apply filter
+        if (options.filter) {
+            timelineItems = timelineItems.filter((item) => matchesFilter(item, options.filter));
+        }
+        const tailCount = parseTailCount(options.tail);
+        if (options.tail !== undefined && tailCount === undefined) {
+            console.error(`Error: Invalid --tail value: ${options.tail}`);
+            console.error('Usage: --tail <n> (where n is >= 0)');
+            await client.close().catch(() => { });
+            process.exit(1);
+        }
+        await client.close();
+        // Use curateAgentActivity to format the transcript
+        if (tailCount === 0) {
+            return;
+        }
+        const transcript = formatAgentActivityTranscript(timelineItems, tailCount);
+        console.log(transcript);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: Failed to get logs: ${message}`);
+        await client.close().catch(() => { });
+        process.exit(1);
+    }
+}
+/**
+ * Follow mode: stream logs in real-time until interrupted
+ */
+async function runFollowMode(client, agentId, options) {
+    const DEFAULT_FOLLOW_TAIL = 10;
+    const tailCount = parseTailCount(options.tail) ?? DEFAULT_FOLLOW_TAIL;
+    // First, get existing timeline.
+    let existingItems = await fetchAgentTimelineItems(client, agentId);
+    // Apply filter to existing items
+    if (options.filter) {
+        existingItems = existingItems.filter((item) => matchesFilter(item, options.filter));
+    }
+    // Print existing transcript (tail-like behavior)
+    if (tailCount > 0) {
+        const existingTranscript = formatAgentActivityTranscript(existingItems, tailCount);
+        if (existingTranscript !== NO_ACTIVITY_MESSAGE) {
+            console.log(existingTranscript);
+        }
+    }
+    // Subscribe to new events
+    const tailLabel = tailCount === 0 ? 'no history' : `last ${tailCount} entr${tailCount === 1 ? 'y' : 'ies'}`;
+    console.log(`\n--- Following logs (${tailLabel}; Ctrl+C to stop) ---\n`);
+    const unsubscribe = client.on('agent_stream', (msg) => {
+        const message = msg;
+        if (message.type !== 'agent_stream')
+            return;
+        if (message.payload.agentId !== agentId)
+            return;
+        if (message.payload.event.type === 'timeline') {
+            const item = message.payload.event.item;
+            // Apply filter
+            if (options.filter && !matchesFilter(item, options.filter)) {
+                return;
+            }
+            // Print each timeline item as it arrives using the curator format
+            const transcript = formatAgentActivityTranscript([item]);
+            if (transcript !== NO_ACTIVITY_MESSAGE) {
+                console.log(transcript);
+            }
+        }
+    });
+    // Wait for interrupt
+    await new Promise((resolve) => {
+        const cleanup = () => {
+            unsubscribe();
+            resolve();
+        };
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+    });
+    await client.close();
+}
+//# sourceMappingURL=logs.js.map

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

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

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

@@ -0,0 +1,37 @@
+import type { Command } from 'commander';
+import type { CommandOptions, ListResult, OutputSchema } from '../../output/index.js';
+/** Agent list item for display */
+export interface AgentListItem {
+    id: string;
+    shortId: string;
+    name: string;
+    provider: string;
+    thinking: string;
+    status: string;
+    cwd: string;
+    created: string;
+}
+/** Schema for agent ls output */
+export declare const agentLsSchema: OutputSchema<AgentListItem>;
+export type AgentLsResult = ListResult<AgentListItem>;
+export interface AgentLsOptions extends CommandOptions {
+    /** -a: Include archived agents */
+    all?: boolean;
+    /** Legacy flag retained for CLI compatibility */
+    global?: boolean;
+    /** Filter by specific status */
+    status?: string;
+    /** Filter by specific cwd */
+    cwd?: string;
+    /** Filter by labels (key=value format) */
+    label?: string[];
+    /** Filter by thinking option ID */
+    thinking?: string;
+}
+/**
+ * Agent ls command semantics:
+ * - `junction agent ls`    → all non-archived agents
+ * - `junction agent ls -a` → include archived agents
+ */
+export declare function runLsCommand(options: AgentLsOptions, _command: Command): Promise<AgentLsResult>;
+//# sourceMappingURL=ls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/ls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAgB,MAAM,uBAAuB,CAAA;AAEnG,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;CAChB;AA8BD,iCAAiC;AACjC,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,aAAa,CAqBrD,CAAA;AAiBD,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;AAErD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,kCAAkC;IAClC,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,aAAa,CAAC,CA2HxB"}