@agent-relay/bridge 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { ProjectConfig } from '@agent-relay/config/bridge-config';
+export * from './types.js';
+export * from './multi-project-client.js';
+export * from './utils.js';
+export { escapeForShell, escapeForTmux } from './utils.js';
+export { selectShadowCli, type ShadowCli, type ShadowMode, type ShadowCliSelection, } from './shadow-cli.js';
+export { AgentSpawner, readWorkersMetadata, getWorkerLogsDir, type AgentSpawnerOptions, type CloudPersistenceHandler, type OnAgentDeathCallback, } from './spawner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './multi-project-client.js';
+export * from './utils.js';
+export { escapeForShell, escapeForTmux } from './utils.js';
+// Shadow CLI selection
+export { selectShadowCli, } from './shadow-cli.js';
+// Agent spawner
+export { AgentSpawner, readWorkersMetadata, getWorkerLogsDir, } from './spawner.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,uBAAuB;AACvB,OAAO,EACL,eAAe,GAIhB,MAAM,iBAAiB,CAAC;AAEzB,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,cAAc,CAAC"}

package/dist/multi-project-client.d.ts

@@ -0,0 +1,99 @@
+/**
+ * MultiProjectClient
+ * Connects to multiple project daemons simultaneously for cross-project orchestration.
+ */
+import { type SendPayload } from '@agent-relay/protocol/types';
+import type { ProjectConfig } from './types.js';
+interface MultiProjectClientOptions {
+    /** Agent name to register as (default: '__BridgeClient'). Must be unique per daemon. */
+    agentName?: string;
+    /** Enable automatic reconnection on disconnect (default: true) */
+    reconnect?: boolean;
+    /** Initial reconnection delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Maximum reconnection delay in ms (default: 30000) */
+    maxReconnectDelay?: number;
+    /** Maximum reconnection attempts before giving up (default: Infinity) */
+    maxReconnectAttempts?: number;
+}
+export declare class MultiProjectClient {
+    private projects;
+    private connections;
+    private leads;
+    private options;
+    private shuttingDown;
+    /** Handler for incoming messages */
+    onMessage?: (projectId: string, from: string, payload: SendPayload, messageId: string) => void;
+    /** Handler for connection state changes */
+    onProjectStateChange?: (projectId: string, connected: boolean) => void;
+    constructor(projects: ProjectConfig[], options?: MultiProjectClientOptions);
+    /**
+     * Connect to all project daemons
+     */
+    connect(): Promise<void>;
+    /**
+     * Connect to a single project daemon
+     */
+    private connectToProject;
+    /**
+     * Send HELLO to a project daemon
+     */
+    private sendHello;
+    /**
+     * Handle incoming data from a project connection
+     */
+    private handleData;
+    /**
+     * Process a frame from a project daemon
+     */
+    private processFrame;
+    /**
+     * Handle delivered message from a project
+     */
+    private handleDeliver;
+    /**
+     * Send envelope to a project daemon
+     */
+    private send;
+    /**
+     * Send message to a project
+     * @param projectId - Target project ID
+     * @param to - Agent name within the project (or '*' for broadcast, 'lead' for project lead)
+     * @param body - Message body
+     */
+    sendToProject(projectId: string, to: string, body: string): boolean;
+    /**
+     * Broadcast to all leads
+     */
+    broadcastToLeads(body: string): void;
+    /**
+     * Broadcast to all agents in all projects
+     */
+    broadcastAll(body: string): void;
+    /**
+     * Register a lead for a project
+     */
+    registerLead(projectId: string, leadName: string): void;
+    /**
+     * Get all connected projects
+     */
+    getConnectedProjects(): string[];
+    /**
+     * Get project connection info
+     */
+    getProject(projectId: string): ProjectConfig | undefined;
+    /**
+     * Schedule a reconnection attempt with exponential backoff
+     */
+    private scheduleReconnect;
+    /**
+     * Attempt to reconnect to a project daemon
+     */
+    private attemptReconnect;
+    /**
+     * Disconnect from all projects
+     */
+    disconnect(): void;
+}
+export {};
+//# sourceMappingURL=multi-project-client.d.ts.map

package/dist/multi-project-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-project-client.d.ts","sourceRoot":"","sources":["../src/multi-project-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAGL,KAAK,WAAW,EAGjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,YAAY,CAAC;AAa1D,UAAU,yBAAyB;IACjC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,kBAAkB;IAYjB,OAAO,CAAC,QAAQ;IAX5B,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAAiF;IAChG,OAAO,CAAC,YAAY,CAAS;IAE7B,oCAAoC;IACpC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/F,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;gBAEnD,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,GAAE,yBAA8B;IAUtF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiExB;;OAEG;IACH,OAAO,CAAC,SAAS;IAqBjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,IAAI;IAaZ;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAkCnE;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBhC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQvD;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAMhC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIxD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoExB;;OAEG;IACH,UAAU,IAAI,IAAI;CAyBnB"}

package/dist/multi-project-client.js

@@ -0,0 +1,389 @@
+/**
+ * MultiProjectClient
+ * Connects to multiple project daemons simultaneously for cross-project orchestration.
+ */
+import net from 'node:net';
+import fs from 'node:fs';
+import { generateId } from './utils.js';
+import { PROTOCOL_VERSION, } from '@agent-relay/protocol/types';
+import { encodeFrameLegacy as encodeFrame, FrameParser } from '@agent-relay/protocol/framing';
+export class MultiProjectClient {
+    projects;
+    connections = new Map();
+    leads = new Map();
+    options;
+    shuttingDown = false;
+    /** Handler for incoming messages */
+    onMessage;
+    /** Handler for connection state changes */
+    onProjectStateChange;
+    constructor(projects, options = {}) {
+        this.projects = projects;
+        this.options = {
+            agentName: options.agentName ?? '__BridgeClient',
+            reconnect: options.reconnect ?? true,
+            reconnectDelay: options.reconnectDelay ?? 1000,
+            maxReconnectDelay: options.maxReconnectDelay ?? 30000,
+            maxReconnectAttempts: options.maxReconnectAttempts ?? Infinity,
+        };
+    }
+    /**
+     * Connect to all project daemons
+     */
+    async connect() {
+        const connectPromises = this.projects.map((project) => this.connectToProject(project));
+        await Promise.all(connectPromises);
+    }
+    /**
+     * Connect to a single project daemon
+     */
+    connectToProject(project) {
+        return new Promise((resolve, reject) => {
+            // Check socket exists
+            if (!fs.existsSync(project.socketPath)) {
+                console.error(`[bridge] No daemon running for ${project.id} (${project.path})`);
+                console.error(`[bridge] Start with: cd ${project.path} && agent-relay up`);
+                reject(new Error(`No daemon for ${project.id}`));
+                return;
+            }
+            const socket = net.createConnection(project.socketPath, () => {
+                this.sendHello(conn);
+            });
+            const parser = new FrameParser();
+            parser.setLegacyMode(true); // Use 4-byte header for backwards compatibility
+            const conn = {
+                config: project,
+                socket,
+                parser,
+                ready: false,
+            };
+            socket.on('data', (data) => this.handleData(conn, data));
+            socket.on('close', () => {
+                const wasReady = conn.ready;
+                conn.ready = false;
+                this.onProjectStateChange?.(project.id, false);
+                // Attempt reconnection if enabled and not shutting down
+                if (wasReady && this.options.reconnect && !this.shuttingDown) {
+                    this.scheduleReconnect(conn);
+                }
+            });
+            socket.on('error', (err) => {
+                console.error(`[bridge] Connection error for ${project.id}:`, err.message);
+                if (!conn.ready) {
+                    reject(err);
+                }
+            });
+            this.connections.set(project.id, conn);
+            // Wait for ready
+            const checkReady = setInterval(() => {
+                if (conn.ready) {
+                    clearInterval(checkReady);
+                    clearTimeout(timeout);
+                    resolve();
+                }
+            }, 10);
+            const timeout = setTimeout(() => {
+                if (!conn.ready) {
+                    clearInterval(checkReady);
+                    socket.destroy();
+                    reject(new Error(`Connection timeout for ${project.id}`));
+                }
+            }, 5000);
+        });
+    }
+    /**
+     * Send HELLO to a project daemon
+     */
+    sendHello(conn) {
+        const hello = {
+            v: PROTOCOL_VERSION,
+            type: 'HELLO',
+            id: generateId(),
+            ts: Date.now(),
+            payload: {
+                agent: this.options.agentName,
+                cli: 'bridge',
+                capabilities: {
+                    ack: true,
+                    resume: false,
+                    max_inflight: 256,
+                    supports_topics: true,
+                },
+            },
+        };
+        this.send(conn, hello);
+    }
+    /**
+     * Handle incoming data from a project connection
+     */
+    handleData(conn, data) {
+        try {
+            const frames = conn.parser.push(data);
+            for (const frame of frames) {
+                this.processFrame(conn, frame);
+            }
+        }
+        catch (err) {
+            console.error(`[bridge] Parse error for ${conn.config.id}:`, err);
+        }
+    }
+    /**
+     * Process a frame from a project daemon
+     */
+    processFrame(conn, envelope) {
+        switch (envelope.type) {
+            case 'WELCOME':
+                conn.ready = true;
+                console.log(`[bridge] Connected to ${conn.config.id}`);
+                this.onProjectStateChange?.(conn.config.id, true);
+                break;
+            case 'DELIVER':
+                this.handleDeliver(conn, envelope);
+                break;
+            case 'PING':
+                this.send(conn, {
+                    v: PROTOCOL_VERSION,
+                    type: 'PONG',
+                    id: generateId(),
+                    ts: Date.now(),
+                    payload: envelope.payload ?? {},
+                });
+                break;
+        }
+    }
+    /**
+     * Handle delivered message from a project
+     */
+    handleDeliver(conn, envelope) {
+        // Send ACK
+        this.send(conn, {
+            v: PROTOCOL_VERSION,
+            type: 'ACK',
+            id: generateId(),
+            ts: Date.now(),
+            payload: {
+                ack_id: envelope.id,
+                seq: envelope.delivery.seq,
+            },
+        });
+        // Notify handler
+        if (this.onMessage && envelope.from) {
+            this.onMessage(conn.config.id, envelope.from, envelope.payload, envelope.id);
+        }
+    }
+    /**
+     * Send envelope to a project daemon
+     */
+    send(conn, envelope) {
+        if (!conn.socket)
+            return false;
+        try {
+            const frame = encodeFrame(envelope);
+            conn.socket.write(frame);
+            return true;
+        }
+        catch (err) {
+            console.error(`[bridge] Send error for ${conn.config.id}:`, err);
+            return false;
+        }
+    }
+    /**
+     * Send message to a project
+     * @param projectId - Target project ID
+     * @param to - Agent name within the project (or '*' for broadcast, 'lead' for project lead)
+     * @param body - Message body
+     */
+    sendToProject(projectId, to, body) {
+        const conn = this.connections.get(projectId);
+        if (!conn?.ready) {
+            console.error(`[bridge] Cannot send to ${projectId}: not connected`);
+            return false;
+        }
+        // Resolve 'lead' to actual lead name
+        let targetAgent = to;
+        if (to === 'lead') {
+            const lead = this.leads.get(projectId);
+            if (lead) {
+                targetAgent = lead.name;
+            }
+            else {
+                // Fallback to configured lead name
+                targetAgent = conn.config.leadName;
+            }
+        }
+        const envelope = {
+            v: PROTOCOL_VERSION,
+            type: 'SEND',
+            id: generateId(),
+            ts: Date.now(),
+            to: targetAgent,
+            payload: {
+                kind: 'message',
+                body,
+            },
+        };
+        return this.send(conn, envelope);
+    }
+    /**
+     * Broadcast to all leads
+     */
+    broadcastToLeads(body) {
+        for (const [projectId] of this.connections) {
+            this.sendToProject(projectId, 'lead', body);
+        }
+    }
+    /**
+     * Broadcast to all agents in all projects
+     */
+    broadcastAll(body) {
+        for (const [_projectId, conn] of this.connections) {
+            if (conn.ready) {
+                const envelope = {
+                    v: PROTOCOL_VERSION,
+                    type: 'SEND',
+                    id: generateId(),
+                    ts: Date.now(),
+                    to: '*',
+                    payload: {
+                        kind: 'message',
+                        body,
+                    },
+                };
+                this.send(conn, envelope);
+            }
+        }
+    }
+    /**
+     * Register a lead for a project
+     */
+    registerLead(projectId, leadName) {
+        this.leads.set(projectId, {
+            name: leadName,
+            projectId,
+            connected: true,
+        });
+    }
+    /**
+     * Get all connected projects
+     */
+    getConnectedProjects() {
+        return Array.from(this.connections.entries())
+            .filter(([_, conn]) => conn.ready)
+            .map(([id]) => id);
+    }
+    /**
+     * Get project connection info
+     */
+    getProject(projectId) {
+        return this.connections.get(projectId)?.config;
+    }
+    /**
+     * Schedule a reconnection attempt with exponential backoff
+     */
+    scheduleReconnect(conn) {
+        if (conn.reconnecting || this.shuttingDown)
+            return;
+        const attempts = conn.reconnectAttempts ?? 0;
+        if (attempts >= this.options.maxReconnectAttempts) {
+            console.error(`[bridge] Max reconnection attempts reached for ${conn.config.id}`);
+            return;
+        }
+        conn.reconnecting = true;
+        conn.reconnectAttempts = attempts + 1;
+        // Calculate delay with exponential backoff
+        const delay = Math.min(this.options.reconnectDelay * Math.pow(2, attempts), this.options.maxReconnectDelay);
+        console.log(`[bridge] Reconnecting to ${conn.config.id} in ${delay}ms (attempt ${conn.reconnectAttempts})`);
+        conn.reconnectTimer = setTimeout(() => {
+            this.attemptReconnect(conn);
+        }, delay);
+    }
+    /**
+     * Attempt to reconnect to a project daemon
+     */
+    attemptReconnect(conn) {
+        if (this.shuttingDown) {
+            conn.reconnecting = false;
+            return;
+        }
+        // Check socket exists
+        if (!fs.existsSync(conn.config.socketPath)) {
+            console.error(`[bridge] No daemon running for ${conn.config.id}, will retry`);
+            conn.reconnecting = false;
+            this.scheduleReconnect(conn);
+            return;
+        }
+        const socket = net.createConnection(conn.config.socketPath, () => {
+            this.sendHello(conn);
+        });
+        // Update connection with new socket and fresh parser
+        conn.socket = socket;
+        conn.parser = new FrameParser();
+        conn.parser.setLegacyMode(true); // Use 4-byte header for backwards compatibility
+        socket.on('data', (data) => this.handleData(conn, data));
+        socket.on('close', () => {
+            const wasReady = conn.ready;
+            conn.ready = false;
+            this.onProjectStateChange?.(conn.config.id, false);
+            if (wasReady && this.options.reconnect && !this.shuttingDown) {
+                this.scheduleReconnect(conn);
+            }
+        });
+        socket.on('error', (err) => {
+            console.error(`[bridge] Reconnection error for ${conn.config.id}:`, err.message);
+            conn.reconnecting = false;
+            if (!this.shuttingDown) {
+                this.scheduleReconnect(conn);
+            }
+        });
+        // Reset reconnection state on successful connect
+        const originalReady = conn.ready;
+        const checkReady = setInterval(() => {
+            if (conn.ready && !originalReady) {
+                clearInterval(checkReady);
+                clearTimeout(timeout);
+                conn.reconnecting = false;
+                conn.reconnectAttempts = 0;
+                console.log(`[bridge] Reconnected to ${conn.config.id}`);
+            }
+        }, 10);
+        const timeout = setTimeout(() => {
+            if (!conn.ready) {
+                clearInterval(checkReady);
+                socket.destroy();
+                conn.reconnecting = false;
+                console.error(`[bridge] Reconnection timeout for ${conn.config.id}`);
+                if (!this.shuttingDown) {
+                    this.scheduleReconnect(conn);
+                }
+            }
+        }, 5000);
+    }
+    /**
+     * Disconnect from all projects
+     */
+    disconnect() {
+        this.shuttingDown = true;
+        for (const [_, conn] of this.connections) {
+            // Clear any pending reconnection timers
+            if (conn.reconnectTimer) {
+                clearTimeout(conn.reconnectTimer);
+            }
+            try {
+                this.send(conn, {
+                    v: PROTOCOL_VERSION,
+                    type: 'BYE',
+                    id: generateId(),
+                    ts: Date.now(),
+                    payload: {},
+                });
+                conn.socket.end();
+            }
+            catch {
+                // Ignore
+            }
+        }
+        this.connections.clear();
+        this.leads.clear();
+    }
+}
+//# sourceMappingURL=multi-project-client.js.map

package/dist/multi-project-client.js.map

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

package/dist/shadow-cli.d.ts

@@ -0,0 +1,17 @@
+export type ShadowCli = 'claude' | 'codex';
+export type ShadowMode = 'subagent' | 'process';
+export interface ShadowCliSelection {
+    cli: ShadowCli;
+    /** Actual command to execute when spawning a process */
+    command: string;
+    mode: ShadowMode;
+}
+/**
+ * Select the shadow CLI and execution mode based on the primary agent's CLI.
+ * - Claude/OpenCode primaries run shadows as subagents (Task tool)
+ * - Others fall back to spawning a process using an authenticated CLI
+ */
+export declare function selectShadowCli(primaryCli: string, options?: {
+    preferredShadowCli?: string;
+}): Promise<ShadowCliSelection>;
+//# sourceMappingURL=shadow-cli.d.ts.map

package/dist/shadow-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-cli.d.ts","sourceRoot":"","sources":["../src/shadow-cli.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAC3C,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,SAAS,CAAC;IACf,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB;AAsCD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,kBAAkB,CAAC,CAkC7B"}

package/dist/shadow-cli.js

@@ -0,0 +1,75 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { commandExists } from '@agent-relay/utils/command-resolver';
+const execFileAsync = promisify(execFile);
+/** Normalize CLI name to a supported identifier */
+function normalizeCli(cli) {
+    if (!cli)
+        return null;
+    const base = cli.trim().split(' ')[0]; // Strip any args
+    const [command] = base.split(':'); // Handle variants like claude:opus
+    const lower = command.toLowerCase();
+    if (lower.startsWith('claude'))
+        return 'claude';
+    if (lower === 'codex' || lower === 'opencode')
+        return 'codex';
+    return null;
+}
+async function isCommandAuthenticated(command) {
+    if (!commandExists(command))
+        return false;
+    try {
+        await execFileAsync(command, ['--version'], { timeout: 4000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function detectAuthenticatedCommand(cli) {
+    const candidates = cli === 'claude' ? ['claude'] : ['codex', 'opencode'];
+    for (const candidate of candidates) {
+        if (await isCommandAuthenticated(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Select the shadow CLI and execution mode based on the primary agent's CLI.
+ * - Claude/OpenCode primaries run shadows as subagents (Task tool)
+ * - Others fall back to spawning a process using an authenticated CLI
+ */
+export async function selectShadowCli(primaryCli, options) {
+    const primary = normalizeCli(primaryCli);
+    const preferred = normalizeCli(options?.preferredShadowCli);
+    // Native subagent support for Claude/OpenCode primaries
+    if (primary) {
+        return {
+            cli: primary,
+            command: primary === 'claude' ? 'claude' : 'codex',
+            mode: 'subagent',
+        };
+    }
+    // Process-mode fallback for non-supporting primaries
+    const fallbackOrder = [];
+    if (preferred)
+        fallbackOrder.push(preferred);
+    fallbackOrder.push('claude', 'codex');
+    const seen = new Set();
+    for (const candidate of fallbackOrder) {
+        if (seen.has(candidate))
+            continue;
+        seen.add(candidate);
+        const authenticatedCommand = await detectAuthenticatedCommand(candidate);
+        if (authenticatedCommand) {
+            return {
+                cli: candidate,
+                command: authenticatedCommand,
+                mode: 'process',
+            };
+        }
+    }
+    throw new Error('No shadow-capable CLI authenticated. Install Claude or OpenCode (codex) and try again.');
+}
+//# sourceMappingURL=shadow-cli.js.map

package/dist/shadow-cli.js.map

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