swarm-engine 1.0.0

package/dist/runtime/mcp.js

@@ -0,0 +1,154 @@
+import { spawn } from 'child_process';
+import { randomUUID } from 'crypto';
+import { safeEnv } from '../utils/env.js';
+export class MCPClient {
+    servers = new Map();
+    tools = new Map();
+    bus;
+    constructor(bus) { this.bus = bus ?? null; }
+    async connect(config) {
+        const conn = config.transport === 'stdio' ? new StdioConn(config) : new HttpConn(config);
+        await conn.initialize();
+        this.servers.set(config.name, conn);
+        const tools = await conn.listTools();
+        for (const t of tools)
+            this.tools.set(`${config.name}:${t.name}`, { ...t, serverName: config.name });
+        return tools.map((t) => ({ ...t, serverName: config.name }));
+    }
+    async callTool(server, tool, args) {
+        const conn = this.servers.get(server);
+        if (!conn)
+            throw new Error(`MCP not connected: ${server}`);
+        return conn.callTool(tool, args);
+    }
+    getAllTools() { return [...this.tools.values()]; }
+    async disconnectAll() {
+        for (const c of this.servers.values())
+            try {
+                await c.shutdown();
+            }
+            catch { }
+        this.servers.clear();
+        this.tools.clear();
+    }
+}
+class StdioConn {
+    config;
+    proc = null;
+    pending = new Map();
+    buf = '';
+    constructor(config) {
+        this.config = config;
+    }
+    async initialize() {
+        this.proc = spawn(this.config.command, this.config.args ?? [], {
+            cwd: this.config.cwd, env: safeEnv(this.config.env), stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.proc.stdout.on('data', (c) => { this.buf += c.toString(); this.flush(); });
+        await this.req('initialize', { protocolVersion: '2024-11-05', capabilities: {}, clientInfo: { name: 'swarm-engine', version: '1.0.0' } });
+        this.proc?.stdin?.write(JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized', params: {} }) + '\n');
+    }
+    async listTools() { return (await this.req('tools/list', {})).tools ?? []; }
+    async callTool(name, args) { return (await this.req('tools/call', { name, arguments: args })).content; }
+    async shutdown() {
+        // Clear all pending request timers to prevent leaks
+        for (const [, entry] of this.pending) {
+            clearTimeout(entry.timer);
+            entry.reject(new Error('Connection shutdown'));
+        }
+        this.pending.clear();
+        this.proc?.kill('SIGTERM');
+    }
+    req(method, params) {
+        return new Promise((resolve, reject) => {
+            const id = randomUUID();
+            const timer = setTimeout(() => { if (this.pending.has(id)) {
+                this.pending.delete(id);
+                reject(new Error(`Timeout: ${method}`));
+            } }, 30_000);
+            this.pending.set(id, { resolve, reject, timer });
+            this.proc?.stdin?.write(JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n');
+        });
+    }
+    flush() {
+        const lines = this.buf.split('\n');
+        this.buf = lines.pop() ?? '';
+        for (const l of lines) {
+            if (!l.trim())
+                continue;
+            try {
+                const m = JSON.parse(l);
+                if (m.id && this.pending.has(String(m.id))) {
+                    const { resolve, reject, timer } = this.pending.get(String(m.id));
+                    this.pending.delete(String(m.id));
+                    clearTimeout(timer);
+                    m.error ? reject(new Error(m.error.message)) : resolve(m.result);
+                }
+            }
+            catch { }
+        }
+    }
+}
+class HttpConn {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async initialize() {
+        if (!this.config.url)
+            throw new Error('HTTP MCP requires url');
+        await this.req('initialize', { protocolVersion: '2024-11-05', capabilities: {}, clientInfo: { name: 'swarm-engine', version: '1.0.0' } });
+    }
+    async listTools() { return (await this.req('tools/list', {})).tools ?? []; }
+    async callTool(name, args) { return (await this.req('tools/call', { name, arguments: args })).content; }
+    async shutdown() { }
+    validateUrl(url) {
+        const parsed = new URL(url);
+        const host = parsed.hostname.replace(/^\[|\]$/g, ''); // Strip IPv6 brackets
+        // Block obvious patterns
+        const blocked = [
+            '169.254.169.254', // AWS metadata
+            '0.0.0.0',
+            'localhost',
+            '127.0.0.1',
+            '::1', // IPv6 loopback
+            '::ffff:127.0.0.1', // IPv6-mapped loopback
+        ];
+        if (blocked.includes(host)) {
+            throw new Error(`SSRF blocked: ${host}`);
+        }
+        // Block private ranges (IPv4)
+        const ipv4Match = host.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+        if (ipv4Match) {
+            const [, a, b] = ipv4Match.map(Number);
+            if (a === 10 || a === 127 || // 10.x, 127.x
+                (a === 172 && b >= 16 && b <= 31) || // 172.16-31.x
+                (a === 192 && b === 168) || // 192.168.x
+                (a === 169 && b === 254)) { // 169.254.x
+                throw new Error(`SSRF blocked: ${host} is a private address`);
+            }
+        }
+        // Block IPv6 private/loopback
+        if (host.startsWith('::') || host.startsWith('fe80') || host.startsWith('fc') || host.startsWith('fd')) {
+            throw new Error(`SSRF blocked: ${host} is a private IPv6 address`);
+        }
+        // Block decimal/octal/hex IP representations
+        if (/^\d{8,}$/.test(host) || /^0\d/.test(host) || /^0x/i.test(host)) {
+            throw new Error(`SSRF blocked: ${host} uses non-standard IP representation`);
+        }
+    }
+    async req(method, params) {
+        this.validateUrl(this.config.url);
+        const r = await fetch(this.config.url, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ jsonrpc: '2.0', id: randomUUID(), method, params }), redirect: 'manual' });
+        if (r.status >= 300 && r.status < 400) {
+            throw new Error(`SSRF blocked: MCP server returned redirect to ${r.headers.get('location')}`);
+        }
+        if (!r.ok)
+            throw new Error(`HTTP ${r.status}`);
+        const m = await r.json();
+        if (m.error)
+            throw new Error(m.error.message);
+        return m.result;
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/runtime/mcp.js.map

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

package/dist/runtime/model-router.d.ts

@@ -0,0 +1,22 @@
+export interface ModelScore {
+    model: string;
+    taskType: string;
+    successes: number;
+    attempts: number;
+    avgReward: number;
+    ucbScore: number;
+}
+export declare class ModelRouter {
+    private db;
+    constructor(dbPath?: string);
+    private initSchema;
+    /** Record an outcome for a model on a task type */
+    record(model: string, taskType: string, success: boolean, reward?: number): void;
+    /** Select the best model for a task type using UCB1 */
+    recommend(taskType: string, candidates: string[]): string;
+    /** Get scores for all models for a task type */
+    getScores(taskType: string): ModelScore[];
+    prune(maxRows?: number): void;
+    close(): void;
+}
+//# sourceMappingURL=model-router.d.ts.map

package/dist/runtime/model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../../src/runtime/model-router.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,CAAC,EAAE,MAAM;IAU3B,OAAO,CAAC,UAAU;IAclB,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAMhF,uDAAuD;IACvD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM;IA0CzD,gDAAgD;IAChD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAoBzC,KAAK,CAAC,OAAO,GAAE,MAAc,GAAG,IAAI;IAIpC,KAAK,IAAI,IAAI;CACd"}

package/dist/runtime/model-router.js

@@ -0,0 +1,94 @@
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+export class ModelRouter {
+    db;
+    constructor(dbPath) {
+        const path = dbPath ?? join(homedir(), '.swarm', 'data', 'router.db');
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+        this.db = new Database(path);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('busy_timeout = 5000');
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS model_outcomes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        model TEXT NOT NULL,
+        task_type TEXT NOT NULL,
+        success INTEGER NOT NULL,
+        reward REAL DEFAULT 0,
+        created_at TEXT DEFAULT (datetime('now'))
+      );
+      CREATE INDEX IF NOT EXISTS idx_model_task ON model_outcomes(model, task_type);
+    `);
+    }
+    /** Record an outcome for a model on a task type */
+    record(model, taskType, success, reward) {
+        this.db.prepare('INSERT INTO model_outcomes (model, task_type, success, reward) VALUES (?, ?, ?, ?)').run(model, taskType, success ? 1 : 0, reward ?? (success ? 1.0 : 0.0));
+    }
+    /** Select the best model for a task type using UCB1 */
+    recommend(taskType, candidates) {
+        if (candidates.length === 0)
+            return 'sonnet';
+        // Single query for all models instead of N+1 per-candidate queries
+        const rows = this.db.prepare(`
+      SELECT model, COUNT(*) as attempts, AVG(reward) as avg_reward
+      FROM model_outcomes WHERE task_type = ?
+      GROUP BY model
+    `).all(taskType);
+        const statsMap = new Map();
+        let N = 0;
+        for (const row of rows) {
+            const attempts = row.attempts;
+            statsMap.set(row.model, { attempts, avgReward: row.avg_reward ?? 0.5 });
+            N += attempts;
+        }
+        if (N === 0)
+            N = 1;
+        let bestModel = candidates[0];
+        let bestScore = -Infinity;
+        for (const model of candidates) {
+            const stats = statsMap.get(model);
+            const attempts = stats?.attempts ?? 0;
+            const avgReward = stats?.avgReward ?? 0.5;
+            // UCB1 formula: avg_reward + sqrt(2 * ln(N) / n_i)
+            // For unexplored models, return Infinity (explore first)
+            const ucb = attempts === 0
+                ? Infinity
+                : avgReward + Math.sqrt(2 * Math.log(N) / attempts);
+            if (ucb > bestScore) {
+                bestScore = ucb;
+                bestModel = model;
+            }
+        }
+        return bestModel;
+    }
+    /** Get scores for all models for a task type */
+    getScores(taskType) {
+        const rows = this.db.prepare(`
+      SELECT model, task_type, COUNT(*) as attempts, SUM(success) as successes, AVG(reward) as avg_reward
+      FROM model_outcomes
+      WHERE task_type = ?
+      GROUP BY model
+    `).all(taskType);
+        const N = rows.reduce((sum, r) => sum + r.attempts, 0) || 1;
+        return rows.map(r => ({
+            model: r.model,
+            taskType: r.task_type,
+            successes: r.successes,
+            attempts: r.attempts,
+            avgReward: r.avg_reward ?? 0,
+            ucbScore: r.attempts === 0 ? Infinity : (r.avg_reward ?? 0) + Math.sqrt(2 * Math.log(N) / r.attempts),
+        }));
+    }
+    prune(maxRows = 10000) {
+        this.db.prepare('DELETE FROM model_outcomes WHERE id NOT IN (SELECT id FROM model_outcomes ORDER BY created_at DESC LIMIT ?)').run(maxRows);
+    }
+    close() { this.db.close(); }
+}
+//# sourceMappingURL=model-router.js.map

package/dist/runtime/model-router.js.map

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

package/dist/runtime/panes.d.ts

@@ -0,0 +1,76 @@
+export interface PaneInfo {
+    paneId: string;
+    agentId: string;
+    agentName: string;
+    windowId: string;
+    status: 'running' | 'done' | 'error';
+    outputFile: string;
+}
+/**
+ * Tmux pane manager for visible agent execution.
+ *
+ * Creates a tmux session with split panes so each agent
+ * runs in its own visible terminal pane. Panes are titled
+ * by agent name and auto-close after completion.
+ */
+export declare class PaneManager {
+    private sessionName;
+    private panes;
+    private active;
+    constructor(sessionName?: string);
+    /** Check if tmux is available on this system. */
+    static isAvailable(): boolean;
+    /** Start the tmux session with an initial orchestrator pane. */
+    start(orchestrationName: string): void;
+    /**
+     * Create a new pane for an agent and run a command in it.
+     * Returns the tmux pane ID.
+     */
+    createPane(agentId: string, agentName: string, command: string, env?: Record<string, string>): {
+        paneId: string;
+        outputFile: string;
+    };
+    /** Mark a pane as done -- show status and close after delay. */
+    markDone(agentId: string, success: boolean): void;
+    /** Print attachment instructions for the user. */
+    attach(): void;
+    /** Get the session name for external attachment. */
+    getSessionName(): string;
+    /** Kill the entire tmux session. */
+    stop(): void;
+    /** List active panes. */
+    list(): PaneInfo[];
+    /** Check if session is active. */
+    isActive(): boolean;
+    /**
+     * Wait for a pane's command to exit by polling tmux pane status.
+     * Resolves when the pane's process has finished.
+     */
+    waitForPane(paneId: string): Promise<void>;
+    /**
+     * Capture the output of a pane using tmux capture-pane.
+     */
+    capturePane(paneId: string): string;
+    /**
+     * Read captured output from the temp file (reliable, not lossy like tmux capture-pane).
+     */
+    captureFromFile(agentId: string): string;
+    /**
+     * Clean up the output file for an agent.
+     */
+    cleanupFile(agentId: string): void;
+    private setTitle;
+}
+/**
+ * Shell-escape a string by replacing single quotes with '\'' pattern.
+ */
+export declare function shellEscape(s: string): string;
+/**
+ * Build a CLI command string for a backend.
+ *
+ * For Codex: cd <cwd> && codex exec --full-auto --json --ephemeral '<prompt>'
+ * For Gemini: cd <cwd> && gemini -p '<prompt>' --output-format json -y
+ * For Claude: falls back to invisible execution (returns null)
+ */
+export declare function buildPaneCommand(backendName: string, prompt: string, cwd: string): string | null;
+//# sourceMappingURL=panes.d.ts.map

package/dist/runtime/panes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panes.d.ts","sourceRoot":"","sources":["../../src/runtime/panes.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAS;gBAEX,WAAW,CAAC,EAAE,MAAM;IAIhC,iDAAiD;IACjD,MAAM,CAAC,WAAW,IAAI,OAAO;IAO7B,gEAAgE;IAChE,KAAK,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAmCtC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAoDrI,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAwBjD,kDAAkD;IAClD,MAAM,IAAI,IAAI;IAKd,oDAAoD;IACpD,cAAc,IAAI,MAAM;IAIxB,oCAAoC;IACpC,IAAI,IAAI,IAAI;IASZ,yBAAyB;IACzB,IAAI,IAAI,QAAQ,EAAE;IAIlB,kCAAkC;IAClC,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC1C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAUnC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAWxC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlC,OAAO,CAAC,QAAQ;CAOjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAef"}

package/dist/runtime/panes.js

@@ -0,0 +1,279 @@
+import { execFileSync } from 'child_process';
+import { randomUUID } from 'crypto';
+import { readFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+/**
+ * Tmux pane manager for visible agent execution.
+ *
+ * Creates a tmux session with split panes so each agent
+ * runs in its own visible terminal pane. Panes are titled
+ * by agent name and auto-close after completion.
+ */
+export class PaneManager {
+    sessionName;
+    panes = new Map();
+    active = false;
+    constructor(sessionName) {
+        this.sessionName = sessionName ?? `swarm-${randomUUID().slice(0, 8)}`;
+    }
+    /** Check if tmux is available on this system. */
+    static isAvailable() {
+        try {
+            execFileSync('tmux', ['-V'], { encoding: 'utf-8' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Start the tmux session with an initial orchestrator pane. */
+    start(orchestrationName) {
+        // Create a new detached session
+        execFileSync('tmux', [
+            'new-session', '-d',
+            '-s', this.sessionName,
+            '-n', 'swarm',
+            '-x', '200', '-y', '50',
+        ]);
+        // Enable pane border titles
+        try {
+            execFileSync('tmux', [
+                'set', '-t', this.sessionName, 'pane-border-status', 'top',
+            ]);
+            execFileSync('tmux', [
+                'set', '-t', this.sessionName, 'pane-border-format',
+                ' #[bold]#{pane_title}#[default] ',
+            ]);
+            // Keep pane visible after command exits so we can capture output
+            execFileSync('tmux', [
+                'set', '-t', this.sessionName, 'remain-on-exit', 'on',
+            ]);
+        }
+        catch { /* older tmux versions may not support these options */ }
+        // Set initial pane title
+        try {
+            execFileSync('tmux', [
+                'select-pane', '-t', `${this.sessionName}:swarm`,
+                '-T', `swarm: ${orchestrationName.slice(0, 50)}`,
+            ]);
+        }
+        catch { /* ignore */ }
+        this.active = true;
+    }
+    /**
+     * Create a new pane for an agent and run a command in it.
+     * Returns the tmux pane ID.
+     */
+    createPane(agentId, agentName, command, env) {
+        if (!this.active)
+            throw new Error('Session not started');
+        // Build env prefix — validate env key names to prevent injection
+        const ENV_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+        const envStr = env
+            ? Object.entries(env)
+                .filter(([k]) => ENV_KEY_RE.test(k))
+                .map(([k, v]) => `${k}=${shellEscape(v)}`).join(' ') + ' '
+            : '';
+        // Create a temp file to tee output for reliable parsing (tmux capture-pane is lossy)
+        const outputFile = join(tmpdir(), `swarm-pane-${agentId.replace(/[^a-zA-Z0-9-]/g, '')}.out`);
+        // The original command runs and output is tee'd to a file for reliable parsing
+        const wrappedCommand = `${envStr}${command} 2>&1 | tee ${shellEscape(outputFile)}; echo ""; echo "--- DONE ---"`;
+        // Split window and run the command directly via shell -c
+        // This way the pane's process IS the command, and pane_dead=1 when it exits
+        const result = execFileSync('tmux', [
+            'split-window', '-t', `${this.sessionName}:swarm`,
+            '-h', // horizontal split
+            '-P', '-F', '#{pane_id}', // print the new pane ID
+            'sh', '-c', wrappedCommand,
+        ], { encoding: 'utf-8' }).trim();
+        const paneId = result;
+        // Rebalance the layout
+        try {
+            execFileSync('tmux', ['select-layout', '-t', `${this.sessionName}:swarm`, 'tiled']);
+        }
+        catch { /* layout may fail if only 1 pane */ }
+        // Set pane title
+        execFileSync('tmux', [
+            'select-pane', '-t', paneId,
+            '-T', agentName,
+        ]);
+        const info = {
+            paneId,
+            agentId,
+            agentName,
+            windowId: 'swarm',
+            status: 'running',
+            outputFile,
+        };
+        this.panes.set(agentId, info);
+        return { paneId, outputFile };
+    }
+    /** Mark a pane as done -- show status and close after delay. */
+    markDone(agentId, success) {
+        const pane = this.panes.get(agentId);
+        if (!pane)
+            return;
+        pane.status = success ? 'done' : 'error';
+        const msg = success ? 'DONE' : 'FAILED';
+        try {
+            // Send a visible completion message
+            execFileSync('tmux', [
+                'send-keys', '-t', pane.paneId,
+                `echo "--- ${msg} ---"`, 'Enter',
+            ]);
+            // Close the pane after a short delay (3 seconds)
+            setTimeout(() => {
+                try {
+                    execFileSync('tmux', ['kill-pane', '-t', pane.paneId]);
+                }
+                catch { /* pane may already be gone */ }
+                this.panes.delete(agentId);
+            }, 3000);
+        }
+        catch { /* pane may already be gone */ }
+    }
+    /** Print attachment instructions for the user. */
+    attach() {
+        if (!this.active)
+            return;
+        console.log(`\nView agents: tmux attach -t ${this.sessionName}\n`);
+    }
+    /** Get the session name for external attachment. */
+    getSessionName() {
+        return this.sessionName;
+    }
+    /** Kill the entire tmux session. */
+    stop() {
+        if (!this.active)
+            return;
+        try {
+            execFileSync('tmux', ['kill-session', '-t', this.sessionName]);
+        }
+        catch { /* session may already be gone */ }
+        this.active = false;
+        this.panes.clear();
+    }
+    /** List active panes. */
+    list() {
+        return [...this.panes.values()];
+    }
+    /** Check if session is active. */
+    isActive() {
+        return this.active;
+    }
+    /**
+     * Wait for a pane's command to exit by polling tmux pane status.
+     * Resolves when the pane's process has finished.
+     */
+    waitForPane(paneId) {
+        return new Promise((resolve) => {
+            const check = setInterval(() => {
+                try {
+                    const dead = execFileSync('tmux', [
+                        'list-panes', '-t', `${this.sessionName}:swarm`,
+                        '-F', '#{pane_id} #{pane_dead}',
+                    ], { encoding: 'utf-8' });
+                    // Parse output lines looking for our pane
+                    const lines = dead.trim().split('\n');
+                    for (const line of lines) {
+                        const [id, isDead] = line.split(' ');
+                        if (id === paneId && isDead === '1') {
+                            clearInterval(check);
+                            resolve();
+                            return;
+                        }
+                    }
+                    // If pane is no longer listed at all, it's gone
+                    const paneIds = lines.map(l => l.split(' ')[0]);
+                    if (!paneIds.includes(paneId)) {
+                        clearInterval(check);
+                        resolve();
+                        return;
+                    }
+                }
+                catch {
+                    // Session/pane gone
+                    clearInterval(check);
+                    resolve();
+                }
+            }, 2000); // poll every 2 seconds
+        });
+    }
+    /**
+     * Capture the output of a pane using tmux capture-pane.
+     */
+    capturePane(paneId) {
+        try {
+            return execFileSync('tmux', [
+                'capture-pane', '-t', paneId, '-p',
+            ], { encoding: 'utf-8' });
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Read captured output from the temp file (reliable, not lossy like tmux capture-pane).
+     */
+    captureFromFile(agentId) {
+        const pane = this.panes.get(agentId);
+        if (!pane?.outputFile)
+            return this.capturePane(pane?.paneId ?? '');
+        try {
+            return readFileSync(pane.outputFile, 'utf-8');
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Clean up the output file for an agent.
+     */
+    cleanupFile(agentId) {
+        const pane = this.panes.get(agentId);
+        if (pane?.outputFile) {
+            try {
+                unlinkSync(pane.outputFile);
+            }
+            catch { /* file may already be gone */ }
+        }
+    }
+    setTitle(title) {
+        try {
+            execFileSync('tmux', [
+                'rename-window', '-t', `${this.sessionName}:0`, title.slice(0, 40),
+            ]);
+        }
+        catch { /* ignore */ }
+    }
+}
+/**
+ * Shell-escape a string by replacing single quotes with '\'' pattern.
+ */
+export function shellEscape(s) {
+    return "'" + s.replace(/'/g, "'\\''") + "'";
+}
+/**
+ * Build a CLI command string for a backend.
+ *
+ * For Codex: cd <cwd> && codex exec --full-auto --json --ephemeral '<prompt>'
+ * For Gemini: cd <cwd> && gemini -p '<prompt>' --output-format json -y
+ * For Claude: falls back to invisible execution (returns null)
+ */
+export function buildPaneCommand(backendName, prompt, cwd) {
+    const escaped = shellEscape(prompt);
+    switch (backendName) {
+        case 'codex':
+            return `cd ${shellEscape(cwd)} && codex exec --full-auto --json --ephemeral ${escaped}`;
+        case 'gemini':
+            return `cd ${shellEscape(cwd)} && gemini -p ${escaped} --output-format json -y`;
+        case 'claude':
+            // Claude uses the Agent SDK, not a CLI command for pane mode.
+            // Return null to signal fallback to invisible execution.
+            return null;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=panes.js.map