copilot-flow 0.3.0

package/dist/memory/store.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * SQLite-backed namespaced key-value memory store.
+ * Used by agents to share state and by the CLI to persist data between runs.
+ *
+ * Uses Node.js built-in `node:sqlite` (available since Node 22.5) to avoid
+ * native addon compilation requirements.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStore = void 0;
+exports.getMemoryStore = getMemoryStore;
+const path_1 = __importDefault(require("path"));
+const node_sqlite_1 = require("node:sqlite");
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS entries (
+  id         TEXT    PRIMARY KEY,
+  namespace  TEXT    NOT NULL,
+  key        TEXT    NOT NULL,
+  value      TEXT    NOT NULL,
+  tags       TEXT    NOT NULL DEFAULT '[]',
+  created_at INTEGER NOT NULL,
+  expires_at INTEGER
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_ns_key ON entries (namespace, key);
+CREATE INDEX IF NOT EXISTS idx_namespace   ON entries (namespace);
+CREATE INDEX IF NOT EXISTS idx_tags        ON entries (tags);
+`;
+class MemoryStore {
+    db;
+    constructor(dbPath = path_1.default.join('.copilot-flow', 'memory.db')) {
+        const absPath = path_1.default.resolve(dbPath);
+        // Ensure parent directory exists
+        const dir = path_1.default.dirname(absPath);
+        const { mkdirSync, existsSync } = require('fs');
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        this.db = new node_sqlite_1.DatabaseSync(absPath);
+        this.db.exec(SCHEMA);
+        // Enable WAL for better concurrent read performance
+        this.db.exec('PRAGMA journal_mode = WAL');
+    }
+    /** Store a value under namespace/key. Upserts if key already exists. */
+    store(namespace, key, value, opts = {}) {
+        this._pruneExpired();
+        const id = `${namespace}:${key}`;
+        const now = Date.now();
+        const expiresAt = opts.ttlMs != null ? now + opts.ttlMs : null;
+        const tags = JSON.stringify(opts.tags ?? []);
+        this.db
+            .prepare(`INSERT INTO entries (id, namespace, key, value, tags, created_at, expires_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(namespace, key) DO UPDATE SET
+           value = excluded.value,
+           tags = excluded.tags,
+           created_at = excluded.created_at,
+           expires_at = excluded.expires_at`)
+            .run(id, namespace, key, value, tags, now, expiresAt);
+    }
+    /** Retrieve a value by namespace and key. Returns null if not found or expired. */
+    retrieve(namespace, key) {
+        this._pruneExpired();
+        const row = this.db
+            .prepare(`SELECT value FROM entries WHERE namespace = ? AND key = ?
+         AND (expires_at IS NULL OR expires_at > ?)`)
+            .get(namespace, key, Date.now());
+        return row?.value ?? null;
+    }
+    /**
+     * Search entries in a namespace by substring match on key or value.
+     * Returns up to `limit` results (default 20).
+     */
+    search(namespace, query, limit = 20) {
+        this._pruneExpired();
+        const like = `%${query}%`;
+        const rows = this.db
+            .prepare(`SELECT id, namespace, key, value, tags, created_at, expires_at
+         FROM entries
+         WHERE namespace = ?
+           AND (key LIKE ? OR value LIKE ?)
+           AND (expires_at IS NULL OR expires_at > ?)
+         ORDER BY created_at DESC
+         LIMIT ?`)
+            .all(namespace, like, like, Date.now(), limit);
+        return rows.map(r => ({
+            id: r.id,
+            namespace: r.namespace,
+            key: r.key,
+            value: r.value,
+            tags: JSON.parse(r.tags),
+            createdAt: r.created_at,
+            expiresAt: r.expires_at ?? undefined,
+        }));
+    }
+    /** List all non-expired entries in a namespace. */
+    list(namespace) {
+        this._pruneExpired();
+        const rows = this.db
+            .prepare(`SELECT id, namespace, key, value, tags, created_at, expires_at
+         FROM entries
+         WHERE namespace = ? AND (expires_at IS NULL OR expires_at > ?)
+         ORDER BY created_at DESC`)
+            .all(namespace, Date.now());
+        return rows.map(r => ({
+            id: r.id,
+            namespace: r.namespace,
+            key: r.key,
+            value: r.value,
+            tags: JSON.parse(r.tags),
+            createdAt: r.created_at,
+            expiresAt: r.expires_at ?? undefined,
+        }));
+    }
+    /** Delete a specific key from a namespace. */
+    delete(namespace, key) {
+        const result = this.db
+            .prepare(`DELETE FROM entries WHERE namespace = ? AND key = ?`)
+            .run(namespace, key);
+        return result.changes > 0;
+    }
+    /** Delete all entries in a namespace. Returns the number of deleted entries. */
+    clear(namespace) {
+        const result = this.db
+            .prepare(`DELETE FROM entries WHERE namespace = ?`)
+            .run(namespace);
+        return result.changes;
+    }
+    /** Close the database connection. */
+    close() {
+        this.db.close();
+    }
+    _pruneExpired() {
+        this.db
+            .prepare(`DELETE FROM entries WHERE expires_at IS NOT NULL AND expires_at <= ?`)
+            .run(Date.now());
+    }
+}
+exports.MemoryStore = MemoryStore;
+/** Process-wide default memory store. Lazily initialised. */
+let _defaultStore = null;
+function getMemoryStore(dbPath) {
+    if (!_defaultStore) {
+        _defaultStore = new MemoryStore(dbPath);
+    }
+    return _defaultStore;
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Terminal output utilities: colour, spinners, tables, and structured logging.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+export declare function setLogLevel(level: LogLevel): void;
+export declare const output: {
+    debug: (msg: string) => void;
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    /** Print a line without any prefix — for raw output. */
+    print: (msg: string) => void;
+    /** Print a dimmed/secondary line. */
+    dim: (msg: string) => void;
+    /** Print a section header. */
+    header: (title: string) => void;
+    /** Print a blank line. */
+    blank: () => void;
+};
+/** Default onRetry callback for CLI commands — logs retry attempt to stderr. */
+export declare function logRetry(error: Error, attempt: number, nextDelayMs: number): void;
+export declare function printTable(rows: Array<[string, string]>): void;
+export declare function withSpinner<T>(text: string, fn: () => Promise<T>): Promise<T>;
+export declare function agentBadge(type: string): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAatE,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAQD,eAAO,MAAM,MAAM;iBACJ,MAAM;gBAGP,MAAM;mBAGH,MAAM;gBAGT,MAAM;iBAGL,MAAM;IAGnB,wDAAwD;iBAC3C,MAAM;IAGnB,qCAAqC;eAC1B,MAAM;IAGjB,8BAA8B;oBACd,MAAM;IAOtB,0BAA0B;;CAI3B,CAAC;AAIF,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAIjF;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAQ9D;AAID,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAYZ;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB/C"}

package/dist/output.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Terminal output utilities: colour, spinners, tables, and structured logging.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.output = void 0;
+exports.setLogLevel = setLogLevel;
+exports.logRetry = logRetry;
+exports.printTable = printTable;
+exports.withSpinner = withSpinner;
+exports.agentBadge = agentBadge;
+const chalk_1 = __importDefault(require("chalk"));
+const LEVEL_RANK = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+let currentLevel = process.env.COPILOT_FLOW_LOG_LEVEL ?? 'info';
+function setLogLevel(level) {
+    currentLevel = level;
+}
+function shouldLog(level) {
+    return LEVEL_RANK[level] >= LEVEL_RANK[currentLevel];
+}
+// ─── Core log functions ───────────────────────────────────────────────────────
+exports.output = {
+    debug: (msg) => {
+        if (shouldLog('debug'))
+            console.log(chalk_1.default.gray(`[debug] ${msg}`));
+    },
+    info: (msg) => {
+        if (shouldLog('info'))
+            console.log(chalk_1.default.blue('ℹ') + ' ' + msg);
+    },
+    success: (msg) => {
+        if (shouldLog('info'))
+            console.log(chalk_1.default.green('✓') + ' ' + msg);
+    },
+    warn: (msg) => {
+        if (shouldLog('warn'))
+            console.warn(chalk_1.default.yellow('⚠') + ' ' + chalk_1.default.yellow(msg));
+    },
+    error: (msg) => {
+        if (shouldLog('error'))
+            console.error(chalk_1.default.red('✗') + ' ' + chalk_1.default.red(msg));
+    },
+    /** Print a line without any prefix — for raw output. */
+    print: (msg) => {
+        if (shouldLog('info'))
+            console.log(msg);
+    },
+    /** Print a dimmed/secondary line. */
+    dim: (msg) => {
+        if (shouldLog('info'))
+            console.log(chalk_1.default.dim(msg));
+    },
+    /** Print a section header. */
+    header: (title) => {
+        if (shouldLog('info')) {
+            console.log('');
+            console.log(chalk_1.default.bold(chalk_1.default.cyan(title)));
+            console.log(chalk_1.default.cyan('─'.repeat(Math.min(title.length + 4, 60))));
+        }
+    },
+    /** Print a blank line. */
+    blank: () => {
+        if (shouldLog('info'))
+            console.log('');
+    },
+};
+// ─── Retry progress reporter ──────────────────────────────────────────────────
+/** Default onRetry callback for CLI commands — logs retry attempt to stderr. */
+function logRetry(error, attempt, nextDelayMs) {
+    exports.output.warn(`Retry ${attempt} after ${nextDelayMs}ms — ${error.message.slice(0, 80)}`);
+}
+// ─── Simple key-value table ───────────────────────────────────────────────────
+function printTable(rows) {
+    if (!shouldLog('info'))
+        return;
+    const maxKey = Math.max(...rows.map(([k]) => k.length));
+    for (const [key, value] of rows) {
+        console.log(chalk_1.default.dim(key.padEnd(maxKey + 2)) + value);
+    }
+}
+// ─── Spinner wrapper (async) ──────────────────────────────────────────────────
+async function withSpinner(text, fn) {
+    // Use dynamic import for ESM-only ora
+    const { default: ora } = await Promise.resolve().then(() => __importStar(require('ora')));
+    const spinner = ora(text).start();
+    try {
+        const result = await fn();
+        spinner.succeed();
+        return result;
+    }
+    catch (err) {
+        spinner.fail();
+        throw err;
+    }
+}
+// ─── Agent status badge ───────────────────────────────────────────────────────
+function agentBadge(type) {
+    const colours = {
+        coder: chalk_1.default.blue,
+        researcher: chalk_1.default.cyan,
+        tester: chalk_1.default.green,
+        reviewer: chalk_1.default.yellow,
+        architect: chalk_1.default.magenta,
+        coordinator: chalk_1.default.white,
+        analyst: chalk_1.default.cyan,
+        debugger: chalk_1.default.red,
+        documenter: chalk_1.default.gray,
+        optimizer: chalk_1.default.yellow,
+        'security-auditor': chalk_1.default.red,
+        'performance-engineer': chalk_1.default.magenta,
+    };
+    const colour = colours[type] ?? chalk_1.default.white;
+    return colour(`[${type}]`);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/swarm/coordinator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Swarm coordinator — orchestrates multiple Copilot sessions as a swarm.
+ * Supports hierarchical, mesh, and sequential topologies.
+ */
+import type { SwarmTask, SwarmTopology, AgentResult } from '../types.js';
+export interface SwarmOptions {
+    /** Called whenever an agent produces a text chunk. */
+    onProgress?: (taskId: string, agentType: string, chunk: string) => void;
+    /** Namespace used for inter-agent memory sharing. Default: 'swarm' */
+    memoryNamespace?: string;
+}
+/**
+ * Run a set of tasks as a coordinated swarm.
+ *
+ * - **sequential**: Tasks run one by one in order.
+ * - **hierarchical**: Independent tasks run in parallel; dependent tasks wait.
+ * - **mesh**: All tasks run in parallel with shared memory.
+ */
+export declare function runSwarm(tasks: SwarmTask[], topology?: SwarmTopology, options?: SwarmOptions): Promise<Map<string, AgentResult>>;
+//# sourceMappingURL=coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/swarm/coordinator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,GAAE,aAA8B,EACxC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAwBnC"}

package/dist/swarm/coordinator.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Swarm coordinator — orchestrates multiple Copilot sessions as a swarm.
+ * Supports hierarchical, mesh, and sequential topologies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSwarm = runSwarm;
+const executor_js_1 = require("../agents/executor.js");
+const executor_js_2 = require("../hooks/executor.js");
+const store_js_1 = require("../memory/store.js");
+const output_js_1 = require("../output.js");
+/**
+ * Run a set of tasks as a coordinated swarm.
+ *
+ * - **sequential**: Tasks run one by one in order.
+ * - **hierarchical**: Independent tasks run in parallel; dependent tasks wait.
+ * - **mesh**: All tasks run in parallel with shared memory.
+ */
+async function runSwarm(tasks, topology = 'hierarchical', options = {}) {
+    const results = new Map();
+    const ns = options.memoryNamespace ?? 'swarm';
+    await executor_js_2.hooks.swarmStart({ topology, taskCount: tasks.length });
+    output_js_1.output.info(`Starting ${topology} swarm with ${tasks.length} task(s)`);
+    switch (topology) {
+        case 'sequential':
+            await runSequential(tasks, results, ns, options);
+            break;
+        case 'hierarchical':
+            await runHierarchical(tasks, results, ns, options);
+            break;
+        case 'mesh':
+            await runMesh(tasks, results, ns, options);
+            break;
+    }
+    await executor_js_2.hooks.swarmEnd({ topology, results: Object.fromEntries(results) });
+    const succeeded = [...results.values()].filter(r => r.success).length;
+    output_js_1.output.success(`Swarm complete: ${succeeded}/${tasks.length} tasks succeeded`);
+    return results;
+}
+/** Run tasks one after another. Results of earlier tasks are stored in memory. */
+async function runSequential(tasks, results, ns, options) {
+    const mem = (0, store_js_1.getMemoryStore)();
+    for (const task of tasks) {
+        output_js_1.output.info(`${(0, output_js_1.agentBadge)(task.agentType)} Running task: ${task.id}`);
+        const result = await (0, executor_js_1.runAgentTask)(task.agentType, buildPrompt(task, results, mem, ns), {
+            retryConfig: task.retryConfig,
+            onChunk: options.onProgress
+                ? chunk => options.onProgress(task.id, task.agentType, chunk)
+                : undefined,
+        });
+        results.set(task.id, result);
+        if (result.success) {
+            mem.store(ns, `task:${task.id}:result`, result.output, { ttlMs: 60 * 60 * 1000 });
+        }
+    }
+}
+/**
+ * Run independent tasks in parallel; tasks with dependencies wait.
+ * Uses a simple wave/level-based execution model.
+ */
+async function runHierarchical(tasks, results, ns, options) {
+    const mem = (0, store_js_1.getMemoryStore)();
+    const remaining = [...tasks];
+    while (remaining.length > 0) {
+        // Find tasks whose dependencies are all satisfied
+        const ready = remaining.filter(t => (t.dependsOn ?? []).every(dep => results.has(dep)));
+        if (ready.length === 0) {
+            throw new Error(`Swarm deadlock — no tasks are runnable. Remaining: ${remaining.map(t => t.id).join(', ')}`);
+        }
+        output_js_1.output.info(`Running ${ready.length} task(s) in parallel`);
+        const waveResults = await Promise.all(ready.map(task => (0, executor_js_1.runAgentTask)(task.agentType, buildPrompt(task, results, mem, ns), {
+            retryConfig: task.retryConfig,
+            onChunk: options.onProgress
+                ? chunk => options.onProgress(task.id, task.agentType, chunk)
+                : undefined,
+        }).then(r => ({ task, result: r }))));
+        for (const { task, result } of waveResults) {
+            results.set(task.id, result);
+            remaining.splice(remaining.indexOf(task), 1);
+            if (result.success) {
+                mem.store(ns, `task:${task.id}:result`, result.output, { ttlMs: 60 * 60 * 1000 });
+            }
+        }
+    }
+}
+/** All tasks run concurrently with shared memory. */
+async function runMesh(tasks, results, ns, options) {
+    const mem = (0, store_js_1.getMemoryStore)();
+    const settled = await Promise.allSettled(tasks.map(task => (0, executor_js_1.runAgentTask)(task.agentType, buildPrompt(task, results, mem, ns), {
+        retryConfig: task.retryConfig,
+        onChunk: options.onProgress
+            ? chunk => options.onProgress(task.id, task.agentType, chunk)
+            : undefined,
+    }).then(r => ({ task, result: r }))));
+    for (const s of settled) {
+        if (s.status === 'fulfilled') {
+            const { task, result } = s.value;
+            results.set(task.id, result);
+            if (result.success) {
+                mem.store(ns, `task:${task.id}:result`, result.output, { ttlMs: 60 * 60 * 1000 });
+            }
+        }
+    }
+}
+/**
+ * Enrich a task's prompt with available context from already-completed tasks.
+ * Injects results from dependencies into the prompt so agents can build on each other.
+ */
+function buildPrompt(task, results, mem, ns) {
+    let prompt = task.prompt;
+    const depContext = [];
+    for (const dep of task.dependsOn ?? []) {
+        const cached = mem.retrieve(ns, `task:${dep}:result`);
+        if (cached) {
+            depContext.push(`--- Output from task "${dep}" ---\n${cached}`);
+        }
+        else {
+            const result = results.get(dep);
+            if (result?.success) {
+                depContext.push(`--- Output from task "${dep}" ---\n${result.output}`);
+            }
+        }
+    }
+    if (depContext.length > 0) {
+        prompt = `Context from previous tasks:\n\n${depContext.join('\n\n')}\n\n---\n\n${prompt}`;
+    }
+    return prompt;
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/swarm/coordinator.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Shared TypeScript types and interfaces for copilot-flow.
+ */
+import type { RetryConfig } from './core/retry.js';
+export declare const AGENT_TYPE_LIST: readonly ["coder", "researcher", "tester", "reviewer", "architect", "coordinator", "analyst", "debugger", "documenter", "optimizer", "security-auditor", "performance-engineer"];
+export type AgentType = (typeof AGENT_TYPE_LIST)[number];
+export interface AgentDefinition {
+    model: string;
+    systemMessage: string;
+    description: string;
+    capabilities: string[];
+}
+export interface AgentState {
+    id: string;
+    type: AgentType;
+    sessionId: string;
+    status: 'idle' | 'busy' | 'error' | 'terminated';
+    task?: string;
+    startedAt: number;
+    completedAt?: number;
+    error?: string;
+}
+export interface AgentResult {
+    agentType: AgentType;
+    agentId: string;
+    sessionId: string;
+    output: string;
+    durationMs: number;
+    attempts: number;
+    success: boolean;
+    error?: string;
+}
+export type SwarmTopology = 'hierarchical' | 'mesh' | 'sequential';
+export interface SwarmTask {
+    id: string;
+    agentType: AgentType;
+    prompt: string;
+    /** IDs of tasks that must complete before this one. */
+    dependsOn?: string[];
+    retryConfig?: Partial<RetryConfig>;
+}
+export interface SwarmState {
+    id: string;
+    topology: SwarmTopology;
+    tasks: SwarmTask[];
+    status: 'idle' | 'running' | 'completed' | 'failed';
+    startedAt?: number;
+    completedAt?: number;
+}
+export interface MemoryEntry {
+    id: string;
+    namespace: string;
+    key: string;
+    value: string;
+    tags: string[];
+    createdAt: number;
+    expiresAt?: number;
+}
+export interface StoreOptions {
+    /** TTL in milliseconds. Entry is deleted after this duration. */
+    ttlMs?: number;
+    tags?: string[];
+}
+export type HookEvent = 'pre-task' | 'post-task' | 'session-start' | 'session-end' | 'agent-spawn' | 'agent-terminate' | 'swarm-start' | 'swarm-end';
+export interface HookContext<T = unknown> {
+    event: HookEvent;
+    timestamp: number;
+    data?: T;
+    metadata?: Record<string, unknown>;
+}
+export type HookHandler<T = unknown> = (ctx: HookContext<T>) => Promise<void>;
+export interface CopilotFlowConfig {
+    version: string;
+    /** Default model passed to createSession(). Default: 'gpt-4o' */
+    defaultModel: string;
+    swarm: {
+        topology: SwarmTopology;
+        /** Maximum concurrent sessions. Default: 8 */
+        maxAgents: number;
+    };
+    memory: {
+        backend: 'sqlite' | 'memory';
+        /** Path to SQLite file. Default: .copilot-flow/memory.db */
+        path: string;
+    };
+    retry: RetryConfig;
+    hooks: {
+        enabled: boolean;
+        /** Per-hook execution timeout in ms. Default: 5000 */
+        timeoutMs: number;
+    };
+}
+export interface CommandContext {
+    args: string[];
+    flags: Record<string, unknown>;
+    config: CopilotFlowConfig;
+    cwd: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,eAAO,MAAM,eAAe,kLAalB,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,WAAW,GACX,eAAe,GACf,aAAa,GACb,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAI9E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;QACL,QAAQ,EAAE,aAAa,CAAC;QACxB,8CAA8C;QAC9C,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAC7B,4DAA4D;QAC5D,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,sDAAsD;QACtD,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Shared TypeScript types and interfaces for copilot-flow.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_TYPE_LIST = void 0;
+// ─── Agent Types ─────────────────────────────────────────────────────────────
+exports.AGENT_TYPE_LIST = [
+    'coder',
+    'researcher',
+    'tester',
+    'reviewer',
+    'architect',
+    'coordinator',
+    'analyst',
+    'debugger',
+    'documenter',
+    'optimizer',
+    'security-auditor',
+    'performance-engineer',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,gFAAgF;AAEnE,QAAA,eAAe,GAAG;IAC7B,OAAO;IACP,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,WAAW;IACX,aAAa;IACb,SAAS;IACT,UAAU;IACV,YAAY;IACZ,WAAW;IACX,kBAAkB;IAClB,sBAAsB;CACd,CAAC"}