copilot-flow 0.3.0

package/dist/commands/memory.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMemory = registerMemory;
+const store_js_1 = require("../memory/store.js");
+const output_js_1 = require("../output.js");
+function registerMemory(program) {
+    const memory = program.command('memory').description('Manage the namespaced memory store');
+    // ── memory store ───────────────────────────────────────────────────────────
+    memory
+        .command('store')
+        .description('Store a value in memory')
+        .requiredOption('--namespace <ns>', 'Memory namespace')
+        .requiredOption('--key <key>', 'Entry key')
+        .requiredOption('--value <value>', 'Value to store')
+        .option('--ttl <ms>', 'Time-to-live in milliseconds (optional)')
+        .option('--tags <tags>', 'Comma-separated tags')
+        .action((opts) => {
+        const store = (0, store_js_1.getMemoryStore)();
+        store.store(opts.namespace, opts.key, opts.value, {
+            ttlMs: opts.ttl != null ? parseInt(opts.ttl, 10) : undefined,
+            tags: opts.tags?.split(',').map(t => t.trim()),
+        });
+        output_js_1.output.success(`Stored: ${opts.namespace}/${opts.key}`);
+    });
+    // ── memory retrieve ────────────────────────────────────────────────────────
+    memory
+        .command('retrieve')
+        .description('Retrieve a value from memory')
+        .requiredOption('--namespace <ns>', 'Memory namespace')
+        .requiredOption('--key <key>', 'Entry key')
+        .action((opts) => {
+        const store = (0, store_js_1.getMemoryStore)();
+        const value = store.retrieve(opts.namespace, opts.key);
+        if (value == null) {
+            output_js_1.output.warn(`Not found: ${opts.namespace}/${opts.key}`);
+            process.exit(1);
+        }
+        output_js_1.output.print(value);
+    });
+    // ── memory search ──────────────────────────────────────────────────────────
+    memory
+        .command('search')
+        .description('Search entries in a namespace')
+        .requiredOption('--namespace <ns>', 'Memory namespace')
+        .requiredOption('--query <query>', 'Search query (substring match on key and value)')
+        .option('--limit <n>', 'Max results', '20')
+        .action((opts) => {
+        const store = (0, store_js_1.getMemoryStore)();
+        const results = store.search(opts.namespace, opts.query, parseInt(opts.limit, 10));
+        if (results.length === 0) {
+            output_js_1.output.dim('No results found.');
+            return;
+        }
+        output_js_1.output.header(`Search results (${results.length})`);
+        for (const entry of results) {
+            (0, output_js_1.printTable)([
+                ['Key', entry.key],
+                ['Value', entry.value.slice(0, 100) + (entry.value.length > 100 ? '…' : '')],
+                ['Tags', entry.tags.join(', ') || '—'],
+                ['Created', new Date(entry.createdAt).toISOString()],
+            ]);
+            output_js_1.output.blank();
+        }
+    });
+    // ── memory list ────────────────────────────────────────────────────────────
+    memory
+        .command('list')
+        .description('List all entries in a namespace')
+        .requiredOption('--namespace <ns>', 'Memory namespace')
+        .action((opts) => {
+        const store = (0, store_js_1.getMemoryStore)();
+        const entries = store.list(opts.namespace);
+        if (entries.length === 0) {
+            output_js_1.output.dim(`No entries in namespace: ${opts.namespace}`);
+            return;
+        }
+        output_js_1.output.header(`Memory: ${opts.namespace} (${entries.length} entries)`);
+        for (const entry of entries) {
+            output_js_1.output.print(`  ${entry.key}: ${entry.value.slice(0, 60)}${entry.value.length > 60 ? '…' : ''}`);
+        }
+    });
+    // ── memory delete ──────────────────────────────────────────────────────────
+    memory
+        .command('delete')
+        .description('Delete an entry from memory')
+        .requiredOption('--namespace <ns>', 'Memory namespace')
+        .requiredOption('--key <key>', 'Entry key')
+        .action((opts) => {
+        const store = (0, store_js_1.getMemoryStore)();
+        const deleted = store.delete(opts.namespace, opts.key);
+        if (deleted) {
+            output_js_1.output.success(`Deleted: ${opts.namespace}/${opts.key}`);
+        }
+        else {
+            output_js_1.output.warn(`Not found: ${opts.namespace}/${opts.key}`);
+        }
+    });
+    // ── memory clear ───────────────────────────────────────────────────────────
+    memory
+        .command('clear')
+        .description('Delete all entries in a namespace')
+        .requiredOption('--namespace <ns>', 'Memory namespace')
+        .action((opts) => {
+        const store = (0, store_js_1.getMemoryStore)();
+        const count = store.clear(opts.namespace);
+        output_js_1.output.success(`Cleared ${count} entries from: ${opts.namespace}`);
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/commands/memory.js.map

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

package/dist/commands/route.d.ts

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

package/dist/commands/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/commands/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+BpD"}

package/dist/commands/route.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRoute = registerRoute;
+const registry_js_1 = require("../agents/registry.js");
+const output_js_1 = require("../output.js");
+function registerRoute(program) {
+    const route = program.command('route').description('Route tasks to the best agent type');
+    // ── route task ─────────────────────────────────────────────────────────────
+    route
+        .command('task')
+        .description('Suggest the best agent type for a task')
+        .requiredOption('--task <task>', 'Task description')
+        .action((opts) => {
+        const type = (0, registry_js_1.routeTask)(opts.task);
+        const def = registry_js_1.AGENT_REGISTRY[type];
+        output_js_1.output.header('Routing Result');
+        (0, output_js_1.printTable)([
+            ['Task', opts.task.slice(0, 80)],
+            ['Agent', (0, output_js_1.agentBadge)(type)],
+            ['Description', def.description],
+            ['Capabilities', def.capabilities.join(', ')],
+        ]);
+    });
+    // ── route list-agents ──────────────────────────────────────────────────────
+    route
+        .command('list-agents')
+        .description('List all agent types with their capabilities')
+        .action(() => {
+        output_js_1.output.header('Available Agent Types');
+        for (const type of (0, registry_js_1.listAgentTypes)()) {
+            const def = registry_js_1.AGENT_REGISTRY[type];
+            output_js_1.output.print(`  ${(0, output_js_1.agentBadge)(type).padEnd(32)} ${def.description}`);
+        }
+    });
+}
+//# sourceMappingURL=route.js.map

package/dist/commands/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/commands/route.ts"],"names":[],"mappings":";;AAIA,sCA+BC;AAlCD,uDAAkF;AAClF,4CAA8D;AAE9D,SAAgB,aAAa,CAAC,OAAgB;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC;IAEzF,8EAA8E;IAC9E,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wCAAwC,CAAC;SACrD,cAAc,CAAC,eAAe,EAAE,kBAAkB,CAAC;SACnD,MAAM,CAAC,CAAC,IAAsB,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,IAAA,uBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,4BAAc,CAAC,IAAI,CAAC,CAAC;QACjC,kBAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAChC,IAAA,sBAAU,EAAC;YACT,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC,OAAO,EAAE,IAAA,sBAAU,EAAC,IAAI,CAAC,CAAC;YAC3B,CAAC,aAAa,EAAE,GAAG,CAAC,WAAW,CAAC;YAChC,CAAC,cAAc,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,8EAA8E;IAC9E,KAAK;SACF,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,GAAG,EAAE;QACX,kBAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,IAAA,4BAAc,GAAE,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,4BAAc,CAAC,IAAI,CAAC,CAAC;YACjC,kBAAM,CAAC,KAAK,CAAC,KAAK,IAAA,sBAAU,EAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/status.d.ts

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

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoDrD"}

package/dist/commands/status.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStatus = registerStatus;
+const pool_js_1 = require("../agents/pool.js");
+const store_js_1 = require("../memory/store.js");
+const output_js_1 = require("../output.js");
+const config_js_1 = require("../config.js");
+function registerStatus(program) {
+    program
+        .command('status')
+        .description('Show system status overview')
+        .action(() => {
+        const initialised = (0, config_js_1.isInitialised)();
+        output_js_1.output.header('copilot-flow status');
+        (0, output_js_1.printTable)([
+            ['Initialised', initialised ? '✓ Yes' : '✗ No — run: copilot-flow init'],
+        ]);
+        if (!initialised)
+            return;
+        const config = (0, config_js_1.loadConfig)();
+        output_js_1.output.blank();
+        output_js_1.output.print('Configuration');
+        (0, output_js_1.printTable)([
+            ['Default model', config.defaultModel],
+            ['Topology', config.swarm.topology],
+            ['Max agents', String(config.swarm.maxAgents)],
+            ['Max retries', String(config.retry.maxAttempts)],
+            ['Backoff', config.retry.backoffStrategy],
+            ['Jitter', config.retry.jitter ? 'on' : 'off'],
+        ]);
+        output_js_1.output.blank();
+        output_js_1.output.print('Agents');
+        const agents = pool_js_1.agentPool.list();
+        if (agents.length === 0) {
+            output_js_1.output.dim('  No agent records found.');
+        }
+        else {
+            const byStatus = agents.reduce((acc, a) => {
+                acc[a.status] = (acc[a.status] ?? 0) + 1;
+                return acc;
+            }, {});
+            for (const [status, count] of Object.entries(byStatus)) {
+                output_js_1.output.print(`  ${status}: ${count}`);
+            }
+        }
+        output_js_1.output.blank();
+        output_js_1.output.print('Memory');
+        try {
+            const store = (0, store_js_1.getMemoryStore)(config.memory.path);
+            const swarmEntries = store.list('swarm').length;
+            output_js_1.output.print(`  swarm namespace: ${swarmEntries} entries`);
+        }
+        catch {
+            output_js_1.output.dim('  Memory store not available.');
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":";;AAMA,wCAoDC;AAzDD,+CAA8C;AAC9C,iDAAoD;AACpD,4CAAkD;AAClD,4CAAyD;AAEzD,SAAgB,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,WAAW,GAAG,IAAA,yBAAa,GAAE,CAAC;QACpC,kBAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAErC,IAAA,sBAAU,EAAC;YACT,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC;SACzE,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW;YAAE,OAAO;QAEzB,MAAM,MAAM,GAAG,IAAA,sBAAU,GAAE,CAAC;QAE5B,kBAAM,CAAC,KAAK,EAAE,CAAC;QACf,kBAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC9B,IAAA,sBAAU,EAAC;YACT,CAAC,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC;YACtC,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YACnC,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACjD,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC;YACzC,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;SAC/C,CAAC,CAAC;QAEH,kBAAM,CAAC,KAAK,EAAE,CAAC;QACf,kBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvB,MAAM,MAAM,GAAG,mBAAS,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,kBAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAyB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBAChE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACzC,OAAO,GAAG,CAAC;YACb,CAAC,EAAE,EAAE,CAAC,CAAC;YACP,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvD,kBAAM,CAAC,KAAK,CAAC,KAAK,MAAM,KAAK,KAAK,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,kBAAM,CAAC,KAAK,EAAE,CAAC;QACf,kBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAA,yBAAc,EAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAChD,kBAAM,CAAC,KAAK,CAAC,sBAAsB,YAAY,UAAU,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,kBAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/swarm.d.ts

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

package/dist/commands/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/commands/swarm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyFpD"}

package/dist/commands/swarm.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSwarm = registerSwarm;
+const coordinator_js_1 = require("../swarm/coordinator.js");
+const registry_js_1 = require("../agents/registry.js");
+const output_js_1 = require("../output.js");
+const config_js_1 = require("../config.js");
+function registerSwarm(program) {
+    const swarm = program.command('swarm').description('Manage multi-agent swarms');
+    // ── swarm init ─────────────────────────────────────────────────────────────
+    swarm
+        .command('init')
+        .description('Configure swarm defaults')
+        .option('--topology <type>', 'Topology (hierarchical|mesh|sequential)', 'hierarchical')
+        .option('--max-agents <n>', 'Maximum concurrent agents', '8')
+        .action((opts) => {
+        const config = (0, config_js_1.loadConfig)();
+        config.swarm.topology = opts.topology;
+        config.swarm.maxAgents = parseInt(opts.maxAgents, 10);
+        (0, config_js_1.saveConfig)(config);
+        output_js_1.output.success(`Swarm configured: topology=${config.swarm.topology}, maxAgents=${config.swarm.maxAgents}`);
+    });
+    // ── swarm start ────────────────────────────────────────────────────────────
+    swarm
+        .command('start')
+        .description('Run a multi-agent swarm for a task')
+        .requiredOption('--task <task>', 'High-level task to decompose across agents')
+        .option('--topology <type>', 'Override topology for this run')
+        .option('--agents <list>', 'Comma-separated agent types (e.g. researcher,coder,reviewer)')
+        .option('--stream', 'Stream agent outputs as they arrive')
+        .option('--max-retries <n>', 'Retry attempts per agent', '3')
+        .option('--retry-delay <ms>', 'Initial retry delay in ms', '1000')
+        .option('--retry-strategy <strategy>', 'Backoff strategy (exponential|linear|constant|fibonacci)', 'exponential')
+        .action(async (opts) => {
+        const config = (0, config_js_1.loadConfig)();
+        const topology = (opts.topology ?? config.swarm.topology);
+        const tasks = buildTaskList(opts.task, opts.agents, {
+            maxAttempts: parseInt(opts.maxRetries, 10),
+            initialDelayMs: parseInt(opts.retryDelay, 10),
+            backoffStrategy: opts.retryStrategy,
+        });
+        output_js_1.output.header(`Swarm: ${topology}`);
+        output_js_1.output.dim(`Pipeline: ${tasks.map(t => t.agentType).join(' → ')}`);
+        output_js_1.output.blank();
+        const results = await (0, coordinator_js_1.runSwarm)(tasks, topology, {
+            onProgress: opts.stream
+                ? (_taskId, agentType, chunk) => {
+                    process.stdout.write(`${(0, output_js_1.agentBadge)(agentType)} ${chunk}`);
+                }
+                : undefined,
+        });
+        if (opts.stream)
+            output_js_1.output.blank();
+        output_js_1.output.header('Results');
+        for (const [taskId, result] of results) {
+            const icon = result.success ? '✓' : '✗';
+            output_js_1.output.print(`${icon} [${taskId}] ${(0, output_js_1.agentBadge)(result.agentType)} — ${result.durationMs}ms` +
+                (result.attempts > 1 ? ` (${result.attempts} attempts)` : ''));
+            if (!opts.stream && result.success) {
+                output_js_1.output.dim(result.output.slice(0, 200) + (result.output.length > 200 ? '…' : ''));
+            }
+            else if (!result.success) {
+                output_js_1.output.error(result.error ?? 'Unknown error');
+            }
+            output_js_1.output.blank();
+        }
+    });
+    // ── swarm status ───────────────────────────────────────────────────────────
+    swarm
+        .command('status')
+        .description('Show current swarm configuration')
+        .action(() => {
+        const config = (0, config_js_1.loadConfig)();
+        output_js_1.output.header('Swarm Configuration');
+        output_js_1.output.print(`  Topology   : ${config.swarm.topology}`);
+        output_js_1.output.print(`  Max agents : ${config.swarm.maxAgents}`);
+        output_js_1.output.print(`  Model      : ${config.defaultModel}`);
+        output_js_1.output.print(`  Max retries: ${config.retry.maxAttempts}`);
+        output_js_1.output.print(`  Backoff    : ${config.retry.backoffStrategy}`);
+    });
+}
+function buildTaskList(task, agentsFlag, retryConfig) {
+    if (agentsFlag) {
+        const types = agentsFlag.split(',').map(s => s.trim());
+        return types.map((type, i) => ({
+            id: `task-${i + 1}`,
+            agentType: type,
+            prompt: task,
+            dependsOn: i > 0 ? [`task-${i}`] : undefined,
+            retryConfig,
+        }));
+    }
+    // Default pipeline based on task type
+    const suggested = (0, registry_js_1.routeTask)(task);
+    const pipeline = suggested === 'coder'
+        ? ['researcher', 'coder', 'reviewer']
+        : [suggested, 'reviewer'];
+    return pipeline.map((type, i) => ({
+        id: `task-${i + 1}`,
+        agentType: type,
+        prompt: task,
+        dependsOn: i > 0 ? [`task-${i}`] : undefined,
+        retryConfig,
+    }));
+}
+//# sourceMappingURL=swarm.js.map

package/dist/commands/swarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../../src/commands/swarm.ts"],"names":[],"mappings":";;AAOA,sCAyFC;AA/FD,4DAAmD;AACnD,uDAAkD;AAClD,4CAAkD;AAClD,4CAAsD;AAGtD,SAAgB,aAAa,CAAC,OAAgB;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAEhF,8EAA8E;IAC9E,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,EAAE,cAAc,CAAC;SACtF,MAAM,CAAC,kBAAkB,EAAE,2BAA2B,EAAE,GAAG,CAAC;SAC5D,MAAM,CAAC,CAAC,IAA6C,EAAE,EAAE;QACxD,MAAM,MAAM,GAAG,IAAA,sBAAU,GAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAyB,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACtD,IAAA,sBAAU,EAAC,MAAM,CAAC,CAAC;QACnB,kBAAM,CAAC,OAAO,CACZ,8BAA8B,MAAM,CAAC,KAAK,CAAC,QAAQ,eAAe,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAC3F,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,8EAA8E;IAC9E,KAAK;SACF,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oCAAoC,CAAC;SACjD,cAAc,CAAC,eAAe,EAAE,4CAA4C,CAAC;SAC7E,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CAAC,iBAAiB,EAAE,8DAA8D,CAAC;SACzF,MAAM,CAAC,UAAU,EAAE,qCAAqC,CAAC;SACzD,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,GAAG,CAAC;SAC5D,MAAM,CAAC,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,CAAC;SACjE,MAAM,CAAC,6BAA6B,EAAE,0DAA0D,EAAE,aAAa,CAAC;SAChH,MAAM,CAAC,KAAK,EAAE,IAQd,EAAE,EAAE;QACH,MAAM,MAAM,GAAG,IAAA,sBAAU,GAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAkB,CAAC;QAC3E,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;YAClD,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YAC1C,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YAC7C,eAAe,EAAE,IAAI,CAAC,aAAoE;SAC3F,CAAC,CAAC;QAEH,kBAAM,CAAC,MAAM,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;QACpC,kBAAM,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnE,kBAAM,CAAC,KAAK,EAAE,CAAC;QAEf,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAQ,EAAC,KAAK,EAAE,QAAQ,EAAE;YAC9C,UAAU,EAAE,IAAI,CAAC,MAAM;gBACrB,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE;oBAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,sBAAU,EAAC,SAAS,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;gBAC5D,CAAC;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM;YAAE,kBAAM,CAAC,KAAK,EAAE,CAAC;QAChC,kBAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACxC,kBAAM,CAAC,KAAK,CACV,GAAG,IAAI,KAAK,MAAM,KAAK,IAAA,sBAAU,EAAC,MAAM,CAAC,SAAS,CAAC,MAAM,MAAM,CAAC,UAAU,IAAI;gBAC5E,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAChE,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnC,kBAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpF,CAAC;iBAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,kBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC;YAChD,CAAC;YACD,kBAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,8EAA8E;IAC9E,KAAK;SACF,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,MAAM,GAAG,IAAA,sBAAU,GAAE,CAAC;QAC5B,kBAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACrC,kBAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,kBAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACzD,kBAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QACtD,kBAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3D,kBAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACP,CAAC;AAQD,SAAS,aAAa,CACpB,IAAY,EACZ,UAA8B,EAC9B,WAA4B;IAE5B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAe,CAAC,CAAC;QACpE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;YACnB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5C,WAAW;SACZ,CAAC,CAAC,CAAC;IACN,CAAC;IAED,sCAAsC;IACtC,MAAM,SAAS,GAAG,IAAA,uBAAS,EAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GACZ,SAAS,KAAK,OAAO;QACnB,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC;QACrC,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAE9B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5C,WAAW;KACZ,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Configuration loading, defaults, and persistence for copilot-flow.
+ */
+import type { CopilotFlowConfig } from './types.js';
+export declare const DEFAULT_CONFIG: CopilotFlowConfig;
+/** Resolve the config file path relative to cwd. */
+export declare function getConfigPath(cwd?: string): string;
+/** Load config from disk, merging with defaults. Returns defaults if file missing. */
+export declare function loadConfig(cwd?: string): CopilotFlowConfig;
+/** Write config to disk. Creates the directory if it doesn't exist. */
+export declare function saveConfig(config: CopilotFlowConfig, cwd?: string): void;
+/** Check whether the config directory has been initialised. */
+export declare function isInitialised(cwd?: string): boolean;
+/** Ensure the .copilot-flow/ runtime directories exist. */
+export declare function ensureRuntimeDirs(cwd?: string): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOpD,eAAO,MAAM,cAAc,EAAE,iBAoB5B,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,GAAG,SAAgB,GAAG,MAAM,CAEzD;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,GAAG,SAAgB,GAAG,iBAAiB,CAcjE;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,SAAgB,GAAG,IAAI,CAS/E;AAiBD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,GAAG,SAAgB,GAAG,OAAO,CAE1D;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,GAAG,SAAgB,GAAG,IAAI,CAQ3D"}

package/dist/config.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Configuration loading, defaults, and persistence for copilot-flow.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.getConfigPath = getConfigPath;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.isInitialised = isInitialised;
+exports.ensureRuntimeDirs = ensureRuntimeDirs;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const retry_js_1 = require("./core/retry.js");
+const CONFIG_DIR = '.copilot-flow';
+const CONFIG_FILE = 'config.json';
+const CONFIG_VERSION = '1.0.0';
+exports.DEFAULT_CONFIG = {
+    version: CONFIG_VERSION,
+    defaultModel: process.env.COPILOT_FLOW_DEFAULT_MODEL ?? 'gpt-4o',
+    swarm: {
+        topology: 'hierarchical',
+        maxAgents: 8,
+    },
+    memory: {
+        backend: 'sqlite',
+        path: path_1.default.join(CONFIG_DIR, 'memory.db'),
+    },
+    retry: {
+        ...retry_js_1.DEFAULT_RETRY_CONFIG,
+        maxAttempts: parseInt(process.env.COPILOT_FLOW_MAX_RETRIES ?? '3', 10),
+        initialDelayMs: parseInt(process.env.COPILOT_FLOW_RETRY_DELAY_MS ?? '1000', 10),
+    },
+    hooks: {
+        enabled: true,
+        timeoutMs: 5_000,
+    },
+};
+/** Resolve the config file path relative to cwd. */
+function getConfigPath(cwd = process.cwd()) {
+    return path_1.default.join(cwd, CONFIG_DIR, CONFIG_FILE);
+}
+/** Load config from disk, merging with defaults. Returns defaults if file missing. */
+function loadConfig(cwd = process.cwd()) {
+    const configPath = getConfigPath(cwd);
+    if (!fs_1.default.existsSync(configPath)) {
+        return exports.DEFAULT_CONFIG;
+    }
+    try {
+        const raw = fs_1.default.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return mergeConfig(exports.DEFAULT_CONFIG, parsed);
+    }
+    catch {
+        return exports.DEFAULT_CONFIG;
+    }
+}
+/** Write config to disk. Creates the directory if it doesn't exist. */
+function saveConfig(config, cwd = process.cwd()) {
+    const configDir = path_1.default.join(cwd, CONFIG_DIR);
+    const configPath = path_1.default.join(configDir, CONFIG_FILE);
+    if (!fs_1.default.existsSync(configDir)) {
+        fs_1.default.mkdirSync(configDir, { recursive: true });
+    }
+    fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+/** Deep merge partial config over base config. */
+function mergeConfig(base, override) {
+    return {
+        ...base,
+        ...override,
+        swarm: { ...base.swarm, ...(override.swarm ?? {}) },
+        memory: { ...base.memory, ...(override.memory ?? {}) },
+        retry: { ...base.retry, ...(override.retry ?? {}) },
+        hooks: { ...base.hooks, ...(override.hooks ?? {}) },
+    };
+}
+/** Check whether the config directory has been initialised. */
+function isInitialised(cwd = process.cwd()) {
+    return fs_1.default.existsSync(getConfigPath(cwd));
+}
+/** Ensure the .copilot-flow/ runtime directories exist. */
+function ensureRuntimeDirs(cwd = process.cwd()) {
+    const base = path_1.default.join(cwd, CONFIG_DIR);
+    for (const sub of ['', 'agents', 'swarm']) {
+        const dir = path_1.default.join(base, sub);
+        if (!fs_1.default.existsSync(dir)) {
+            fs_1.default.mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/client-manager.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Singleton manager for the CopilotClient lifecycle.
+ * Ensures the client is started once and stopped on process exit.
+ */
+import { CopilotClient } from '@github/copilot-sdk';
+export declare class ClientManager {
+    private client;
+    private started;
+    /** Return the running CopilotClient, starting it lazily if needed. */
+    getClient(): Promise<CopilotClient>;
+    /** Ping the client to verify connectivity. */
+    ping(): Promise<boolean>;
+    /** Gracefully stop all sessions and the client. */
+    shutdown(): Promise<void>;
+    get isRunning(): boolean;
+}
+/** Process-wide singleton. Import this everywhere you need a client. */
+export declare const clientManager: ClientManager;
+//# sourceMappingURL=client-manager.d.ts.map

package/dist/core/client-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-manager.d.ts","sourceRoot":"","sources":["../../src/core/client-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,OAAO,CAAS;IAExB,sEAAsE;IAChE,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IA0BzC,8CAA8C;IACxC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAU9B,mDAAmD;IAC7C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe/B,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED,wEAAwE;AACxE,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/core/client-manager.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Singleton manager for the CopilotClient lifecycle.
+ * Ensures the client is started once and stopped on process exit.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clientManager = exports.ClientManager = void 0;
+const copilot_sdk_1 = require("@github/copilot-sdk");
+const output_js_1 = require("../output.js");
+class ClientManager {
+    client = null;
+    started = false;
+    /** Return the running CopilotClient, starting it lazily if needed. */
+    async getClient() {
+        if (this.client && this.started) {
+            return this.client;
+        }
+        const token = process.env.GITHUB_TOKEN;
+        this.client = new copilot_sdk_1.CopilotClient(token
+            ? { githubToken: token }
+            : { useLoggedInUser: true });
+        output_js_1.output.debug('Starting CopilotClient...');
+        await this.client.start();
+        this.started = true;
+        output_js_1.output.debug('CopilotClient started.');
+        // Register cleanup on exit
+        process.once('exit', () => void this.shutdown());
+        process.once('SIGINT', async () => { await this.shutdown(); process.exit(0); });
+        process.once('SIGTERM', async () => { await this.shutdown(); process.exit(0); });
+        return this.client;
+    }
+    /** Ping the client to verify connectivity. */
+    async ping() {
+        try {
+            const client = await this.getClient();
+            await client.ping();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Gracefully stop all sessions and the client. */
+    async shutdown() {
+        if (!this.client || !this.started)
+            return;
+        output_js_1.output.debug('Shutting down CopilotClient...');
+        try {
+            await this.client.stop();
+        }
+        catch {
+            // Force stop if graceful fails
+            try {
+                await this.client.forceStop();
+            }
+            catch { /* ignore */ }
+        }
+        this.started = false;
+        this.client = null;
+        output_js_1.output.debug('CopilotClient stopped.');
+    }
+    get isRunning() {
+        return this.started && this.client !== null;
+    }
+}
+exports.ClientManager = ClientManager;
+/** Process-wide singleton. Import this everywhere you need a client. */
+exports.clientManager = new ClientManager();
+//# sourceMappingURL=client-manager.js.map

package/dist/core/client-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-manager.js","sourceRoot":"","sources":["../../src/core/client-manager.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qDAAoD;AACpD,4CAAsC;AAEtC,MAAa,aAAa;IAChB,MAAM,GAAyB,IAAI,CAAC;IACpC,OAAO,GAAG,KAAK,CAAC;IAExB,sEAAsE;IACtE,KAAK,CAAC,SAAS;QACb,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAEvC,IAAI,CAAC,MAAM,GAAG,IAAI,2BAAa,CAC7B,KAAK;YACH,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE;YACxB,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAC9B,CAAC;QAEF,kBAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,kBAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAEvC,2BAA2B;QAC3B,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1C,kBAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;YAC/B,IAAI,CAAC;gBAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,kBAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9C,CAAC;CACF;AA7DD,sCA6DC;AAED,wEAAwE;AAC3D,QAAA,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/core/error-handler.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Error classification for GitHub Copilot SDK errors.
+ * Maps raw errors into structured CopilotFlowError with category and retryability.
+ */
+export type CopilotFlowErrorCategory = 'copilot_not_installed' | 'authentication' | 'authorization' | 'not_found' | 'rate_limit' | 'timeout' | 'session_error' | 'network' | 'validation' | 'unknown';
+export interface CopilotFlowError {
+    category: CopilotFlowErrorCategory;
+    message: string;
+    /** Whether this error type is safe to retry. */
+    retryable: boolean;
+    /** Suggested delay before retry (ms). Present for rate_limit and session_error. */
+    retryAfterMs?: number;
+    originalError?: unknown;
+}
+/** Classify an unknown thrown value into a structured CopilotFlowError. */
+export declare function classifyError(error: unknown): CopilotFlowError;
+/** Format a CopilotFlowError for display in the terminal. */
+export declare function formatError(error: CopilotFlowError): string;
+/**
+ * Wraps an unknown error as a CopilotFlowError and re-throws it.
+ * Useful for catch blocks that need structured error info.
+ */
+export declare function asCopilotFlowError(error: unknown): CopilotFlowError;
+export declare function isCopilotFlowError(value: unknown): value is CopilotFlowError;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/core/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/core/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,wBAAwB,GAChC,uBAAuB,GACvB,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,YAAY,GACZ,SAAS,GACT,eAAe,GACf,SAAS,GACT,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,wBAAwB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA+FD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAsB9D;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAW3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAGnE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAQ5E"}