swarm-engine 1.0.0

package/dist/cli/commands/watch.js

@@ -0,0 +1,179 @@
+import { Command } from 'commander';
+import { Dashboard } from '../../tui/dashboard.js';
+import { EventBus } from '../../core/event-bus.js';
+export const watchCommand = new Command('watch')
+    .description('Live monitoring dashboard for orchestrations')
+    .option('--demo', 'Run a demo orchestration to preview the dashboard', false)
+    .action(async (options) => {
+    const bus = new EventBus();
+    const dashboard = new Dashboard(bus);
+    dashboard.start();
+    // Clean exit on Ctrl+C
+    const cleanup = () => {
+        dashboard.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    if (options.demo) {
+        runDemo(bus);
+    }
+    else {
+        // In real usage, the bus would be shared with the engine.
+        // For now, keep the dashboard alive until Ctrl+C.
+    }
+    // Keep process alive
+    await new Promise(() => { });
+});
+/**
+ * Run a simulated orchestration to demonstrate the dashboard.
+ */
+function runDemo(bus) {
+    const delay = (ms) => new Promise(r => setTimeout(r, ms));
+    (async () => {
+        bus.emit('orchestration:start', {
+            id: 'demo-001',
+            name: 'hybrid: Refactor auth module',
+            pattern: 'hybrid',
+            phaseCount: 3,
+        }, 'engine');
+        await delay(800);
+        // Phase 1
+        bus.emit('orchestration:phase-start', {
+            orchestrationId: 'demo-001',
+            phase: 'research',
+            agentCount: 2,
+            parallel: true,
+        }, 'engine');
+        await delay(300);
+        bus.emit('agent:running', {
+            agentId: 'agent-r1',
+            agentType: 'researcher-auth',
+            backend: 'claude',
+            task: 'Analyze auth module dependencies and patterns',
+        }, 'agent-r1');
+        bus.emit('agent:running', {
+            agentId: 'agent-r2',
+            agentType: 'researcher-tests',
+            backend: 'claude',
+            task: 'Review existing test coverage for auth',
+        }, 'agent-r2');
+        await delay(2500);
+        bus.emit('agent:idle', {
+            agentId: 'agent-r1',
+            agentType: 'researcher-auth',
+            backend: 'claude',
+            result: { filesTouched: ['src/auth/index.ts', 'src/auth/oauth.ts'] },
+            usage: { totalTokens: 4231, costUsd: 0.012, turns: 3, toolCalls: 8, durationMs: 2400 },
+        }, 'agent-r1');
+        await delay(1200);
+        bus.emit('agent:idle', {
+            agentId: 'agent-r2',
+            agentType: 'researcher-tests',
+            backend: 'claude',
+            result: { filesTouched: ['tests/auth.test.ts'] },
+            usage: { totalTokens: 3102, costUsd: 0.009, turns: 2, toolCalls: 5, durationMs: 3500 },
+        }, 'agent-r2');
+        bus.emit('orchestration:phase-complete', {
+            orchestrationId: 'demo-001',
+            phase: 'research',
+            status: 'completed',
+            usage: { totalTokens: 7333, costUsd: 0.021, turns: 5, toolCalls: 13, durationMs: 3500 },
+        }, 'engine');
+        await delay(500);
+        // Phase 2
+        bus.emit('orchestration:phase-start', {
+            orchestrationId: 'demo-001',
+            phase: 'implementation',
+            agentCount: 3,
+            parallel: true,
+        }, 'engine');
+        await delay(300);
+        bus.emit('agent:running', {
+            agentId: 'agent-i1',
+            agentType: 'implementer-core',
+            backend: 'claude',
+            task: 'Refactor core auth logic',
+        }, 'agent-i1');
+        bus.emit('agent:running', {
+            agentId: 'agent-i2',
+            agentType: 'implementer-oauth',
+            backend: 'codex',
+            task: 'Update OAuth2 flow',
+        }, 'agent-i2');
+        bus.emit('agent:running', {
+            agentId: 'agent-i3',
+            agentType: 'test-writer',
+            backend: 'claude',
+            task: 'Write unit tests for new auth',
+        }, 'agent-i3');
+        await delay(3000);
+        bus.emit('agent:idle', {
+            agentId: 'agent-i3',
+            agentType: 'test-writer',
+            backend: 'claude',
+            result: { filesTouched: ['tests/auth-new.test.ts', 'tests/oauth.test.ts'] },
+            usage: { totalTokens: 5100, costUsd: 0.015, turns: 4, toolCalls: 12, durationMs: 2800 },
+        }, 'agent-i3');
+        await delay(2000);
+        bus.emit('agent:idle', {
+            agentId: 'agent-i1',
+            agentType: 'implementer-core',
+            backend: 'claude',
+            result: { filesTouched: ['src/auth/index.ts', 'src/auth/session.ts', 'src/auth/types.ts'] },
+            usage: { totalTokens: 8430, costUsd: 0.025, turns: 6, toolCalls: 18, durationMs: 4900 },
+        }, 'agent-i1');
+        await delay(1500);
+        bus.emit('agent:idle', {
+            agentId: 'agent-i2',
+            agentType: 'implementer-oauth',
+            backend: 'codex',
+            result: { filesTouched: ['src/auth/oauth.ts'] },
+            usage: { totalTokens: 3200, costUsd: 0.008, turns: 3, toolCalls: 7, durationMs: 6300 },
+        }, 'agent-i2');
+        bus.emit('orchestration:phase-complete', {
+            orchestrationId: 'demo-001',
+            phase: 'implementation',
+            status: 'completed',
+            usage: { totalTokens: 16730, costUsd: 0.048, turns: 13, toolCalls: 37, durationMs: 6300 },
+        }, 'engine');
+        await delay(500);
+        // Phase 3
+        bus.emit('orchestration:phase-start', {
+            orchestrationId: 'demo-001',
+            phase: 'review',
+            agentCount: 1,
+            parallel: false,
+        }, 'engine');
+        await delay(300);
+        bus.emit('agent:running', {
+            agentId: 'agent-rev',
+            agentType: 'reviewer',
+            backend: 'claude',
+            task: 'Review all changes for quality and correctness',
+        }, 'agent-rev');
+        await delay(4000);
+        bus.emit('agent:idle', {
+            agentId: 'agent-rev',
+            agentType: 'reviewer',
+            backend: 'claude',
+            result: { filesTouched: [] },
+            usage: { totalTokens: 6200, costUsd: 0.018, turns: 4, toolCalls: 10, durationMs: 3800 },
+        }, 'agent-rev');
+        bus.emit('orchestration:phase-complete', {
+            orchestrationId: 'demo-001',
+            phase: 'review',
+            status: 'completed',
+            usage: { totalTokens: 6200, costUsd: 0.018, turns: 4, toolCalls: 10, durationMs: 3800 },
+        }, 'engine');
+        await delay(300);
+        bus.emit('orchestration:complete', {
+            id: 'demo-001',
+            name: 'hybrid: Refactor auth module',
+            status: 'completed',
+            usage: { totalTokens: 30263, costUsd: 0.087, turns: 22, toolCalls: 60, durationMs: 13600 },
+            durationMs: 13600,
+        }, 'engine');
+    })();
+}
+//# sourceMappingURL=watch.js.map

package/dist/cli/commands/watch.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+// Global error handling
+process.on('unhandledRejection', (error) => {
+    if (error instanceof Error) {
+        if (error.message.includes('API') || error.message.includes('auth')) {
+            console.error('\n❌ Authentication error. Make sure Claude Code is configured:');
+            console.error('   Run: claude auth login\n');
+        }
+        else {
+            console.error(`\n❌ ${error.message}\n`);
+        }
+    }
+    else {
+        console.error(`\n❌ Unexpected error: ${error}\n`);
+    }
+    process.exit(1);
+});
+process.on('uncaughtException', (error) => {
+    console.error(`\n❌ Fatal: ${error.message}\n`);
+    process.exit(1);
+});
+import { Command } from 'commander';
+import { existsSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import chalk from 'chalk';
+import { formatError, didYouMean } from '../utils/errors.js';
+import { setOutputMode } from '../utils/output.js';
+import { initCommand } from './commands/init.js';
+import { runCommand } from './commands/run.js';
+import { statusCommand } from './commands/status.js';
+import { memoryCommand } from './commands/memory.js';
+import { orchestrateCommand } from './commands/orchestrate.js';
+import { pluginCommand } from './commands/plugin.js';
+import { resumeCommand } from './commands/resume.js';
+import { configureCommand } from './commands/configure.js';
+import { shareCommand } from './commands/share.js';
+import { acpCommand } from './commands/acp.js';
+import { watchCommand } from './commands/watch.js';
+import { doctorCommand } from './commands/doctor.js';
+import { agentsCommand } from './commands/agents.js';
+import { mcpCommand } from './commands/mcp.js';
+import { planCommand } from './commands/plan.js';
+import { verifyCommand } from './commands/verify.js';
+import { templateCommand } from './commands/template.js';
+import { vaultCommand } from './commands/vault.js';
+import { learnCommand } from './commands/learn.js';
+import { convertCommand } from './commands/convert.js';
+import { compoundCommand } from './commands/compound.js';
+import { completionsCommand } from './commands/completions.js';
+// First-run onboarding check
+const onboardedPath = join(homedir(), '.swarm', 'onboarded');
+const command = process.argv[2];
+if (!existsSync(onboardedPath) && command && !['doctor', 'setup', 'configure', '--version', '-V', '--help', '-h'].includes(command)) {
+    console.log('\n  Welcome to Swarm Engine! Run "swarm doctor" to check your setup.\n');
+    const dir = join(homedir(), '.swarm');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(onboardedPath, new Date().toISOString());
+}
+const program = new Command();
+program
+    .name('swarm')
+    .description('The orchestration engine for Claude Code')
+    .version('1.0.0')
+    .option('--json', 'Output as JSON (machine-readable)')
+    .option('--quiet', 'Suppress non-essential output');
+program.hook('preAction', (thisCommand) => {
+    const opts = thisCommand.optsWithGlobals();
+    setOutputMode(opts.json ?? false, opts.quiet ?? false);
+});
+// Core commands (visible in --help)
+program.addCommand(initCommand);
+program.addCommand(orchestrateCommand);
+program.addCommand(planCommand);
+program.addCommand(runCommand);
+program.addCommand(templateCommand);
+program.addCommand(agentsCommand);
+program.addCommand(statusCommand);
+program.addCommand(memoryCommand);
+program.addCommand(mcpCommand);
+program.addCommand(verifyCommand);
+program.addCommand(resumeCommand);
+program.addCommand(doctorCommand);
+program.addCommand(learnCommand);
+program.addCommand(convertCommand);
+program.addCommand(compoundCommand);
+program.addCommand(completionsCommand);
+// Hidden commands (still work, not shown in --help)
+// configure/setup — use `swarm setup` or `swarm configure`
+program.addCommand(configureCommand, { hidden: true });
+// vault — merged into memory; vault still works for backward compat
+program.addCommand(vaultCommand, { hidden: true });
+// niche / dev-only commands
+program.addCommand(shareCommand, { hidden: true });
+program.addCommand(acpCommand, { hidden: true });
+program.addCommand(watchCommand, { hidden: true });
+program.addCommand(pluginCommand, { hidden: true });
+// Smart error handling for unknown commands
+program.on('command:*', (operands) => {
+    const unknown = operands[0];
+    const commands = program.commands.map(c => c.name());
+    const suggestion = didYouMean(unknown, commands);
+    console.error(chalk.red(`\n  Unknown command: ${unknown}`));
+    if (suggestion) {
+        console.error(chalk.dim(`  Did you mean: ${chalk.bold(suggestion)}?`));
+    }
+    console.error(chalk.dim(`  Run: swarm --help\n`));
+    process.exitCode = 1;
+});
+try {
+    program.parse();
+}
+catch (error) {
+    console.error(formatError(error instanceof Error ? error : new Error(String(error))));
+    process.exitCode = 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,wBAAwB;AACxB,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAChF,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,yBAAyB,KAAK,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,6BAA6B;AAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IACpI,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IACtF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,aAAa,CAAC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,0CAA0C,CAAC;KACvD,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,QAAQ,EAAE,mCAAmC,CAAC;KACrD,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC;AAEtD,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;IACxC,MAAM,IAAI,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;IAC3C,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,oCAAoC;AACpC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAEvC,oDAAoD;AACpD,2DAA2D;AAC3D,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,oEAAoE;AACpE,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,4BAA4B;AAC5B,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAEpD,4CAA4C;AAC5C,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE;IACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC,CAAC;IAC5D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC;IACH,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/core/checkpoint.d.ts

@@ -0,0 +1,35 @@
+import { OrchestrationInstance, OrchestrationConfig } from './types.js';
+export interface Checkpoint {
+    orchestrationId: string;
+    config: OrchestrationConfig;
+    currentPhase: number;
+    phaseResults: Array<{
+        name: string;
+        status: string;
+        agentCount: number;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+            costUsd: number;
+            durationMs: number;
+        };
+    }>;
+    savedAt: string;
+}
+/**
+ * Save an orchestration checkpoint for resume.
+ */
+export declare function saveCheckpoint(orchestration: OrchestrationInstance): string;
+/**
+ * Load a checkpoint by orchestration ID.
+ */
+export declare function loadCheckpoint(orchestrationId: string): Checkpoint | null;
+/**
+ * List all saved checkpoints.
+ */
+export declare function listCheckpoints(): Checkpoint[];
+/**
+ * Delete a checkpoint.
+ */
+export declare function deleteCheckpoint(orchestrationId: string): boolean;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/core/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/core/checkpoint.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3F,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,qBAAqB,GAAG,MAAM,CAwB3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAazE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,UAAU,EAAE,CAa9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CASjE"}

package/dist/core/checkpoint.js

@@ -0,0 +1,80 @@
+import { writeFileSync, readFileSync, existsSync, mkdirSync, readdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CHECKPOINT_DIR = join(homedir(), '.swarm', 'data', 'checkpoints');
+/**
+ * Save an orchestration checkpoint for resume.
+ */
+export function saveCheckpoint(orchestration) {
+    mkdirSync(CHECKPOINT_DIR, { recursive: true, mode: 0o700 });
+    const checkpoint = {
+        orchestrationId: orchestration.config.id,
+        config: orchestration.config,
+        currentPhase: orchestration.currentPhase,
+        phaseResults: orchestration.phases.map(p => ({
+            name: p.config.name,
+            status: p.status,
+            agentCount: p.agents.length,
+            usage: {
+                inputTokens: p.usage.inputTokens,
+                outputTokens: p.usage.outputTokens,
+                costUsd: p.usage.costUsd,
+                durationMs: p.usage.durationMs,
+            },
+        })),
+        savedAt: new Date().toISOString(),
+    };
+    const filePath = join(CHECKPOINT_DIR, `${orchestration.config.id}.json`);
+    writeFileSync(filePath, JSON.stringify(checkpoint, null, 2), { mode: 0o600 });
+    return filePath;
+}
+/**
+ * Load a checkpoint by orchestration ID.
+ */
+export function loadCheckpoint(orchestrationId) {
+    // Validate ID format to prevent path traversal
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(orchestrationId)) {
+        return null;
+    }
+    const filePath = join(CHECKPOINT_DIR, `${orchestrationId}.json`);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all saved checkpoints.
+ */
+export function listCheckpoints() {
+    if (!existsSync(CHECKPOINT_DIR))
+        return [];
+    return readdirSync(CHECKPOINT_DIR)
+        .filter((f) => f.endsWith('.json'))
+        .map((f) => {
+        try {
+            return JSON.parse(readFileSync(join(CHECKPOINT_DIR, f), 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((c) => c !== null);
+}
+/**
+ * Delete a checkpoint.
+ */
+export function deleteCheckpoint(orchestrationId) {
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(orchestrationId)) {
+        return false;
+    }
+    const filePath = join(CHECKPOINT_DIR, `${orchestrationId}.json`);
+    if (!existsSync(filePath))
+        return false;
+    unlinkSync(filePath);
+    return true;
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/core/checkpoint.js.map

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

package/dist/core/event-bus.d.ts

@@ -0,0 +1,41 @@
+import { SwarmEvent, EventType } from './types.js';
+type EventHandler<T = unknown> = (event: SwarmEvent<T>) => void;
+export declare class EventBus {
+    private emitter;
+    private logFile;
+    private eventCount;
+    constructor(options?: {
+        logFile?: string;
+        maxListeners?: number;
+    });
+    /**
+     * Emit a typed event. Auto-logs to JSONL if configured.
+     */
+    emit<T = unknown>(type: EventType, data: T, source?: string): SwarmEvent<T>;
+    /**
+     * Listen for a specific event type.
+     */
+    on<T = unknown>(type: EventType | '*', handler: EventHandler<T>): void;
+    /**
+     * Listen for a specific event type, once only.
+     */
+    once<T = unknown>(type: EventType | '*', handler: EventHandler<T>): void;
+    /**
+     * Remove a listener.
+     */
+    off<T = unknown>(type: EventType | '*', handler: EventHandler<T>): void;
+    /**
+     * Wait for a specific event type. Returns a promise that resolves with the event.
+     */
+    waitFor<T = unknown>(type: EventType, timeout?: number): Promise<SwarmEvent<T>>;
+    /**
+     * Get event count.
+     */
+    get count(): number;
+    /**
+     * Remove all listeners.
+     */
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AAG/D,KAAK,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAEhE,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAoBjE;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,SAAW,GAAG,UAAU,CAAC,CAAC,CAAC;IA6B7E;;OAEG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAItE;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAIxE;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvE;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAkB/E;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/event-bus.js

@@ -0,0 +1,115 @@
+import { EventEmitter } from 'events';
+import { appendFileSync, mkdirSync, existsSync, statSync, renameSync } from 'fs';
+import { dirname } from 'path';
+import { generateId } from './types.js';
+import { redactSecrets } from '../utils/redact.js';
+export class EventBus {
+    emitter = new EventEmitter();
+    logFile = null;
+    eventCount = 0;
+    constructor(options) {
+        if (options?.logFile) {
+            this.logFile = options.logFile;
+            const dir = dirname(this.logFile);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true, mode: 0o700 });
+            }
+            // Rotate if existing log exceeds 10MB
+            if (existsSync(this.logFile)) {
+                try {
+                    const stats = statSync(this.logFile);
+                    if (stats.size > 10 * 1024 * 1024) {
+                        renameSync(this.logFile, `${this.logFile}.1`);
+                    }
+                }
+                catch { /* ignore rotation errors */ }
+            }
+        }
+        this.emitter.setMaxListeners(options?.maxListeners ?? 100);
+    }
+    /**
+     * Emit a typed event. Auto-logs to JSONL if configured.
+     */
+    emit(type, data, source = 'system') {
+        const event = {
+            id: generateId(),
+            type,
+            timestamp: new Date(),
+            source,
+            data,
+        };
+        try {
+            this.emitter.emit(type, event);
+        }
+        catch (e) { /* listener error — don't crash emitter */ }
+        try {
+            this.emitter.emit('*', event);
+        }
+        catch (e) { /* listener error */ }
+        this.eventCount++;
+        // Append to JSONL log
+        if (this.logFile) {
+            try {
+                const line = redactSecrets(JSON.stringify({
+                    ...event,
+                    timestamp: event.timestamp.toISOString(),
+                })) + '\n';
+                appendFileSync(this.logFile, line);
+            }
+            catch {
+                // Don't fail on log write errors
+            }
+        }
+        return event;
+    }
+    /**
+     * Listen for a specific event type.
+     */
+    on(type, handler) {
+        this.emitter.on(type, handler);
+    }
+    /**
+     * Listen for a specific event type, once only.
+     */
+    once(type, handler) {
+        this.emitter.once(type, handler);
+    }
+    /**
+     * Remove a listener.
+     */
+    off(type, handler) {
+        this.emitter.off(type, handler);
+    }
+    /**
+     * Wait for a specific event type. Returns a promise that resolves with the event.
+     */
+    waitFor(type, timeout) {
+        return new Promise((resolve, reject) => {
+            const timer = timeout
+                ? setTimeout(() => {
+                    this.emitter.off(type, handler);
+                    reject(new Error(`Timeout waiting for event: ${type}`));
+                }, timeout)
+                : null;
+            const handler = (event) => {
+                if (timer)
+                    clearTimeout(timer);
+                resolve(event);
+            };
+            this.emitter.once(type, handler);
+        });
+    }
+    /**
+     * Get event count.
+     */
+    get count() {
+        return this.eventCount;
+    }
+    /**
+     * Remove all listeners.
+     */
+    clear() {
+        this.emitter.removeAllListeners();
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

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

package/dist/core/lifecycle.d.ts

@@ -0,0 +1,30 @@
+import { AgentStatus } from './types.js';
+export declare class AgentLifecycle {
+    private _status;
+    private _history;
+    constructor(initialStatus?: AgentStatus);
+    get status(): AgentStatus;
+    get history(): ReadonlyArray<{
+        status: AgentStatus;
+        timestamp: Date;
+    }>;
+    get isTerminal(): boolean;
+    get isActive(): boolean;
+    /**
+     * Transition to a new status. Throws if the transition is invalid.
+     */
+    transition(newStatus: AgentStatus): void;
+    /**
+     * Check if a transition would be valid without performing it.
+     */
+    canTransition(newStatus: AgentStatus): boolean;
+    /**
+     * Get duration in current state (ms).
+     */
+    get durationInCurrentState(): number;
+    /**
+     * Get total duration from first to last state (ms).
+     */
+    get totalDuration(): number;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/core/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmBzC,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAuD;gBAE3D,aAAa,GAAE,WAA0B;IAKrD,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,IAAI,OAAO,IAAI,aAAa,CAAC;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CAErE;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAYxC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO;IAI9C;;OAEG;IACH,IAAI,sBAAsB,IAAI,MAAM,CAGnC;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAK1B;CACF"}