cognitive-core 0.0.2 → 0.1.2

package/dist/runtime/backends/macro-agent.js

@@ -0,0 +1,107 @@
+/**
+ * macro-agent backend adapter.
+ *
+ * Wraps macro-agent's MacroAgentBackend as a cognitive-core AgentBackend
+ * using structural typing — cognitive-core does not import macro-agent.
+ *
+ * Usage:
+ * ```typescript
+ * import { MacroAgentBackend } from 'macro-agent';
+ * import { adaptMacroBackend, createMacroAgentSource } from 'cognitive-core';
+ *
+ * const macroBackend = new MacroAgentBackend(agentManager);
+ * const backend = adaptMacroBackend(macroBackend);
+ * atlas.setAgentManager([backend]);
+ *
+ * // Or register as a ComputeSource:
+ * const source = createMacroAgentSource(macroBackend, { costTier: 'medium' });
+ * computeProvider.register(source);
+ * ```
+ */
+// ── Adapter ───────────────────────────────────────────────────
+/**
+ * Adapter that wraps a macro-agent-compatible backend as a cognitive-core
+ * AgentBackend.
+ *
+ * Handles the type gap between macro-agent's CognitiveTask (description-only
+ * subset) and cognitive-core's Task (full schema with id, domain, etc.).
+ * Since cognitive-core always passes full Task objects through spawn(),
+ * the adapter caches them and re-attaches on session retrieval.
+ */
+export class MacroAgentBackendAdapter {
+    name;
+    supportedTypes;
+    inner;
+    taskCache = new Map();
+    constructor(backend) {
+        this.inner = backend;
+        this.name = backend.name;
+        this.supportedTypes = [...backend.supportedTypes];
+    }
+    async isAvailable() {
+        return this.inner.isAvailable();
+    }
+    async spawn(config) {
+        const session = await this.inner.spawn(config);
+        this.taskCache.set(session.id, config.task);
+        return this.toAgentSession(session);
+    }
+    async getSession(sessionId) {
+        const session = await this.inner.getSession(sessionId);
+        if (!session)
+            return undefined;
+        return this.toAgentSession(session);
+    }
+    async terminate(sessionId) {
+        return this.inner.terminate(sessionId);
+    }
+    async listSessions() {
+        const sessions = await this.inner.listSessions();
+        return sessions.map(s => this.toAgentSession(s));
+    }
+    toAgentSession(session) {
+        const task = this.taskCache.get(session.id);
+        return {
+            id: session.id,
+            agentType: session.agentType,
+            // Prefer the cached full Task; fall back to runtime object (which IS
+            // a full Task when cognitive-core is the caller, just typed narrowly).
+            task: task ?? session.task,
+            state: session.state,
+            messages: session.messages,
+            toolCalls: session.toolCalls,
+            startTime: session.startTime,
+            endTime: session.endTime,
+            result: session.result,
+            error: session.error,
+            metadata: session.metadata,
+        };
+    }
+}
+// ── Factory helpers ───────────────────────────────────────────
+/**
+ * Adapt a macro-agent MacroAgentBackend for use with cognitive-core.
+ *
+ * @param backend - Any object matching the MacroAgentBackendLike shape
+ * @returns An AgentBackend usable with Atlas.setAgentManager()
+ */
+export function adaptMacroBackend(backend) {
+    return new MacroAgentBackendAdapter(backend);
+}
+/**
+ * Create a ComputeSource for macro-agent backend registration
+ * with DefaultComputeProvider.
+ *
+ * @param backend - Any object matching the MacroAgentBackendLike shape
+ * @param options - Cost tier, location, and priority for compute resolution
+ */
+export function createMacroAgentSource(backend, options) {
+    return {
+        name: backend.name,
+        backend: adaptMacroBackend(backend),
+        costTier: options?.costTier ?? 'medium',
+        location: options?.location ?? 'local',
+        priority: options?.priority ?? 50,
+    };
+}
+//# sourceMappingURL=macro-agent.js.map

package/dist/runtime/backends/macro-agent.js.map

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

package/dist/runtime/backends/mock.d.ts

@@ -0,0 +1,67 @@
+import type { AgentBackend, AgentSpawnConfig, AgentSession } from '../types.js';
+/**
+ * Mock agent behavior definition
+ */
+export interface MockAgentBehavior {
+    /** Simulated tool calls */
+    toolCalls?: Array<{
+        name: string;
+        input: unknown;
+        output: unknown;
+        delayMs?: number;
+    }>;
+    /** Messages to emit */
+    messages?: Array<{
+        role: 'assistant' | 'user';
+        content: string;
+        delayMs?: number;
+    }>;
+    /** Final result */
+    result?: unknown;
+    /** Should the agent succeed? */
+    success?: boolean;
+    /** Error message if failing */
+    error?: string;
+    /** Total duration in ms */
+    durationMs?: number;
+}
+/**
+ * Mock backend for testing
+ */
+export declare class MockBackend implements AgentBackend {
+    readonly name = "mock";
+    readonly supportedTypes: string[];
+    private sessions;
+    private behaviors;
+    private defaultBehavior;
+    constructor(defaultBehavior?: MockAgentBehavior);
+    /**
+     * Set behavior for a specific task description
+     */
+    setBehavior(taskDescription: string, behavior: MockAgentBehavior): void;
+    /**
+     * Set default behavior for all tasks
+     */
+    setDefaultBehavior(behavior: MockAgentBehavior): void;
+    isAvailable(): Promise<boolean>;
+    spawn(config: AgentSpawnConfig): Promise<AgentSession>;
+    private simulateExecution;
+    private delay;
+    getSession(sessionId: string): Promise<AgentSession | undefined>;
+    sendMessage(sessionId: string, _message: string): Promise<void>;
+    terminate(sessionId: string): Promise<void>;
+    listSessions(): Promise<AgentSession[]>;
+    /**
+     * Get all sessions (for testing assertions)
+     */
+    getAllSessions(): AgentSession[];
+    /**
+     * Clear all sessions
+     */
+    clear(): void;
+}
+/**
+ * Create a mock backend
+ */
+export declare function createMockBackend(defaultBehavior?: MockAgentBehavior): MockBackend;
+//# sourceMappingURL=mock.d.ts.map

package/dist/runtime/backends/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/runtime/backends/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EAGb,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,uBAAuB;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,cAAc,WAAoB;IAE3C,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,eAAe,CAAoB;gBAE/B,eAAe,CAAC,EAAE,iBAAiB;IAQ/C;;OAEG;IACH,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIvE;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI/C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;YA+B9C,iBAAiB;IA8D/B,OAAO,CAAC,KAAK;IAIP,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIhE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3C,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7C;;OAEG;IACH,cAAc,IAAI,YAAY,EAAE;IAIhC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,CAAC,EAAE,iBAAiB,GAClC,WAAW,CAEb"}

package/dist/runtime/backends/mock.js

@@ -0,0 +1,153 @@
+/**
+ * Mock backend for testing
+ */
+export class MockBackend {
+    name = 'mock';
+    supportedTypes = ['mock', 'test'];
+    sessions = new Map();
+    behaviors = new Map();
+    defaultBehavior;
+    constructor(defaultBehavior) {
+        this.defaultBehavior = defaultBehavior ?? {
+            success: true,
+            result: 'Mock result',
+            durationMs: 100,
+        };
+    }
+    /**
+     * Set behavior for a specific task description
+     */
+    setBehavior(taskDescription, behavior) {
+        this.behaviors.set(taskDescription, behavior);
+    }
+    /**
+     * Set default behavior for all tasks
+     */
+    setDefaultBehavior(behavior) {
+        this.defaultBehavior = behavior;
+    }
+    async isAvailable() {
+        return true;
+    }
+    async spawn(config) {
+        const sessionId = crypto.randomUUID();
+        const behavior = this.behaviors.get(config.task.description) ?? this.defaultBehavior;
+        const session = {
+            id: sessionId,
+            agentType: config.agentType,
+            task: config.task,
+            state: 'running',
+            messages: [],
+            toolCalls: [],
+            startTime: new Date(),
+            metadata: {
+                injectedKnowledge: !!config.injectedKnowledge,
+                hasSystemPromptAdditions: !!config.systemPromptAdditions,
+            },
+        };
+        this.sessions.set(sessionId, session);
+        // Simulate execution asynchronously
+        this.simulateExecution(session, behavior, config).catch((error) => {
+            session.state = 'failed';
+            session.error = error.message;
+            session.endTime = new Date();
+        });
+        return session;
+    }
+    async simulateExecution(session, behavior, config) {
+        const startTime = Date.now();
+        // Emit messages
+        if (behavior.messages) {
+            for (const msg of behavior.messages) {
+                if (msg.delayMs) {
+                    await this.delay(msg.delayMs);
+                }
+                const message = {
+                    role: msg.role,
+                    content: msg.content,
+                    timestamp: new Date(),
+                };
+                session.messages.push(message);
+                config.onMessage?.(message);
+            }
+        }
+        // Emit tool calls
+        if (behavior.toolCalls) {
+            for (const tc of behavior.toolCalls) {
+                if (tc.delayMs) {
+                    await this.delay(tc.delayMs);
+                }
+                const toolCall = {
+                    id: crypto.randomUUID(),
+                    name: tc.name,
+                    input: tc.input,
+                    output: tc.output,
+                    startTime: new Date(),
+                    endTime: new Date(),
+                };
+                session.toolCalls.push(toolCall);
+                config.onToolCall?.(toolCall);
+            }
+        }
+        // Wait for remaining duration
+        const elapsed = Date.now() - startTime;
+        const remaining = (behavior.durationMs ?? 100) - elapsed;
+        if (remaining > 0) {
+            await this.delay(remaining);
+        }
+        // Complete
+        session.endTime = new Date();
+        if (behavior.success ?? true) {
+            session.state = 'completed';
+            session.result = behavior.result;
+        }
+        else {
+            session.state = 'failed';
+            session.error = behavior.error ?? 'Mock failure';
+        }
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    async getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    async sendMessage(sessionId, _message) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error('Session not found');
+        }
+        // Mock doesn't process additional messages
+    }
+    async terminate(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        session.state = 'failed';
+        session.error = 'Terminated';
+        session.endTime = new Date();
+    }
+    async listSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Get all sessions (for testing assertions)
+     */
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Clear all sessions
+     */
+    clear() {
+        this.sessions.clear();
+        this.behaviors.clear();
+    }
+}
+/**
+ * Create a mock backend
+ */
+export function createMockBackend(defaultBehavior) {
+    return new MockBackend(defaultBehavior);
+}
+//# sourceMappingURL=mock.js.map

package/dist/runtime/backends/mock.js.map

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

package/dist/runtime/backends/subprocess.d.ts

@@ -0,0 +1,56 @@
+import type { AgentBackend, AgentSpawnConfig, AgentSession, AgentMessage, ToolCall } from '../types.js';
+/**
+ * Configuration for subprocess-based agents
+ */
+export interface SubprocessAgentConfig {
+    /** Command to run the agent */
+    command: string;
+    /** Arguments for the command */
+    args?: string[];
+    /** How to pass the task to the agent */
+    taskPassingMode: 'stdin' | 'arg' | 'env' | 'file';
+    /** Environment variable name for task (if taskPassingMode is 'env') */
+    taskEnvVar?: string;
+    /** How to pass knowledge injection */
+    knowledgePassingMode: 'stdin' | 'env' | 'file' | 'system-prompt';
+    /** Environment variable name for knowledge (if knowledgePassingMode is 'env') */
+    knowledgeEnvVar?: string;
+    /** Parser for agent output to extract tool calls */
+    outputParser?: (output: string) => {
+        messages: AgentMessage[];
+        toolCalls: ToolCall[];
+        result?: unknown;
+        isComplete: boolean;
+    };
+}
+/**
+ * Subprocess-based agent backend
+ * Spawns agents as child processes (e.g., Claude Code CLI, custom scripts)
+ */
+export declare class SubprocessBackend implements AgentBackend {
+    readonly name = "subprocess";
+    readonly supportedTypes: string[];
+    private configs;
+    private sessions;
+    constructor(configs: Record<string, SubprocessAgentConfig>);
+    isAvailable(): Promise<boolean>;
+    spawn(config: AgentSpawnConfig): Promise<AgentSession>;
+    getSession(sessionId: string): Promise<AgentSession | undefined>;
+    sendMessage(sessionId: string, message: string): Promise<void>;
+    terminate(sessionId: string): Promise<void>;
+    listSessions(): Promise<AgentSession[]>;
+    /**
+     * Default parser for agent output
+     * Override with custom parser for specific agent formats
+     */
+    private defaultParser;
+}
+/**
+ * Create a subprocess backend with common agent configurations
+ */
+export declare function createSubprocessBackend(configs: Record<string, SubprocessAgentConfig>): SubprocessBackend;
+/**
+ * Pre-configured Claude Code agent
+ */
+export declare const claudeCodeConfig: SubprocessAgentConfig;
+//# sourceMappingURL=subprocess.d.ts.map

package/dist/runtime/backends/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../../src/runtime/backends/subprocess.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wCAAwC;IACxC,eAAe,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAClD,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,oBAAoB,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,eAAe,CAAC;IACjE,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;QACjC,QAAQ,EAAE,YAAY,EAAE,CAAC;QACzB,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAYD;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAElC,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,QAAQ,CAA6C;gBAEjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAOpD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAM/B,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IA4JtD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIhE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9D,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7C;;;OAGG;IACH,OAAO,CAAC,aAAa;CA+BtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC7C,iBAAiB,CAEnB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,qBAsD9B,CAAC"}

package/dist/runtime/backends/subprocess.js

@@ -0,0 +1,260 @@
+import { spawn } from 'child_process';
+import { EventEmitter } from 'events';
+/**
+ * Subprocess-based agent backend
+ * Spawns agents as child processes (e.g., Claude Code CLI, custom scripts)
+ */
+export class SubprocessBackend {
+    name = 'subprocess';
+    supportedTypes;
+    configs = new Map();
+    sessions = new Map();
+    constructor(configs) {
+        this.supportedTypes = Object.keys(configs);
+        for (const [type, config] of Object.entries(configs)) {
+            this.configs.set(type, config);
+        }
+    }
+    async isAvailable() {
+        // Check if at least one configured command exists
+        // For now, just return true
+        return true;
+    }
+    async spawn(config) {
+        const agentConfig = this.configs.get(config.agentType);
+        if (!agentConfig) {
+            const error = new Error(`Unknown agent type: ${config.agentType}`);
+            console.error('[SubprocessBackend] Spawn failed:', error.message);
+            throw error;
+        }
+        const sessionId = crypto.randomUUID();
+        const session = {
+            id: sessionId,
+            agentType: config.agentType,
+            task: config.task,
+            state: 'running',
+            messages: [],
+            toolCalls: [],
+            startTime: new Date(),
+            metadata: {},
+        };
+        // Build environment (filter out undefined values from process.env)
+        const env = Object.fromEntries(Object.entries({ ...process.env, ...config.env }).filter((entry) => entry[1] !== undefined));
+        // Pass task via env if configured
+        if (agentConfig.taskPassingMode === 'env' && agentConfig.taskEnvVar) {
+            env[agentConfig.taskEnvVar] = config.task.description;
+        }
+        // Pass knowledge via env if configured
+        if (agentConfig.knowledgePassingMode === 'env' &&
+            agentConfig.knowledgeEnvVar &&
+            config.systemPromptAdditions) {
+            env[agentConfig.knowledgeEnvVar] = config.systemPromptAdditions;
+        }
+        // Build arguments
+        const args = [...(agentConfig.args ?? [])];
+        if (agentConfig.taskPassingMode === 'arg') {
+            args.push(config.task.description);
+        }
+        // Spawn the process
+        const childProcess = spawn(agentConfig.command, args, {
+            cwd: config.cwd,
+            env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const emitter = new EventEmitter();
+        const subSession = {
+            session,
+            process: childProcess,
+            outputBuffer: '',
+            emitter,
+        };
+        this.sessions.set(sessionId, subSession);
+        // Pass task via stdin if configured
+        if (agentConfig.taskPassingMode === 'stdin') {
+            let input = config.task.description;
+            if (config.systemPromptAdditions) {
+                input = `${config.systemPromptAdditions}\n\n${input}`;
+            }
+            childProcess.stdin?.write(input);
+            childProcess.stdin?.end();
+        }
+        // Handle output
+        const parser = agentConfig.outputParser ?? this.defaultParser;
+        childProcess.stdout?.on('data', (data) => {
+            const output = data.toString();
+            subSession.outputBuffer += output;
+            // Parse and emit events
+            const parsed = parser(subSession.outputBuffer);
+            // Add new messages
+            for (const msg of parsed.messages) {
+                if (!session.messages.some((m) => m.timestamp === msg.timestamp)) {
+                    session.messages.push(msg);
+                    config.onMessage?.(msg);
+                }
+            }
+            // Add new tool calls
+            for (const tc of parsed.toolCalls) {
+                if (!session.toolCalls.some((t) => t.id === tc.id)) {
+                    session.toolCalls.push(tc);
+                    config.onToolCall?.(tc);
+                }
+            }
+            if (parsed.isComplete) {
+                session.result = parsed.result;
+            }
+        });
+        childProcess.stderr?.on('data', (data) => {
+            const error = data.toString();
+            session.messages.push({
+                role: 'system',
+                content: `[stderr] ${error}`,
+                timestamp: new Date(),
+            });
+        });
+        // Handle exit
+        childProcess.on('close', (code) => {
+            session.endTime = new Date();
+            session.state = code === 0 ? 'completed' : 'failed';
+            if (code !== 0) {
+                session.error = `Process exited with code ${code}`;
+                console.error(`[SubprocessBackend] Session ${sessionId} failed: exit code ${code}`);
+            }
+            emitter.emit('complete', session);
+        });
+        childProcess.on('error', (error) => {
+            session.endTime = new Date();
+            session.state = 'failed';
+            session.error = error.message;
+            console.error(`[SubprocessBackend] Session ${sessionId} process error:`, error.message);
+            emitter.emit('complete', session);
+        });
+        // Set up timeout
+        if (config.timeout) {
+            setTimeout(() => {
+                if (session.state === 'running') {
+                    console.error(`[SubprocessBackend] Session ${sessionId} timed out after ${config.timeout}ms`);
+                    childProcess.kill('SIGTERM');
+                    session.state = 'failed';
+                    session.error = 'Timeout';
+                    session.endTime = new Date();
+                }
+            }, config.timeout);
+        }
+        return session;
+    }
+    async getSession(sessionId) {
+        return this.sessions.get(sessionId)?.session;
+    }
+    async sendMessage(sessionId, message) {
+        const subSession = this.sessions.get(sessionId);
+        if (!subSession || subSession.session.state !== 'running') {
+            throw new Error('Session not found or not running');
+        }
+        subSession.process.stdin?.write(message + '\n');
+    }
+    async terminate(sessionId) {
+        const subSession = this.sessions.get(sessionId);
+        if (!subSession)
+            return;
+        subSession.process.kill('SIGTERM');
+        subSession.session.state = 'failed';
+        subSession.session.error = 'Terminated';
+        subSession.session.endTime = new Date();
+    }
+    async listSessions() {
+        return Array.from(this.sessions.values()).map((s) => s.session);
+    }
+    /**
+     * Default parser for agent output
+     * Override with custom parser for specific agent formats
+     */
+    defaultParser(output) {
+        const messages = [];
+        const toolCalls = [];
+        let result;
+        let isComplete = false;
+        // Simple line-based parsing
+        const lines = output.split('\n');
+        for (const line of lines) {
+            if (line.trim()) {
+                messages.push({
+                    role: 'assistant',
+                    content: line,
+                    timestamp: new Date(),
+                });
+            }
+            // Look for completion markers
+            if (line.includes('DONE:') || line.includes('COMPLETE:')) {
+                isComplete = true;
+                result = line.split(':').slice(1).join(':').trim();
+            }
+        }
+        return { messages, toolCalls, result, isComplete };
+    }
+}
+/**
+ * Create a subprocess backend with common agent configurations
+ */
+export function createSubprocessBackend(configs) {
+    return new SubprocessBackend(configs);
+}
+/**
+ * Pre-configured Claude Code agent
+ */
+export const claudeCodeConfig = {
+    command: 'claude',
+    args: ['--print', '--output-format', 'json'],
+    taskPassingMode: 'arg',
+    knowledgePassingMode: 'system-prompt',
+    outputParser: (output) => {
+        const messages = [];
+        const toolCalls = [];
+        let result;
+        let isComplete = false;
+        // Try to parse JSON lines (Claude Code output format)
+        const lines = output.split('\n');
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed.type === 'assistant') {
+                    messages.push({
+                        role: 'assistant',
+                        content: parsed.content ?? '',
+                        timestamp: new Date(parsed.timestamp ?? Date.now()),
+                    });
+                }
+                else if (parsed.type === 'tool_use') {
+                    toolCalls.push({
+                        id: parsed.id ?? crypto.randomUUID(),
+                        name: parsed.name,
+                        input: parsed.input,
+                        startTime: new Date(parsed.timestamp ?? Date.now()),
+                    });
+                }
+                else if (parsed.type === 'tool_result') {
+                    const tc = toolCalls.find((t) => t.id === parsed.tool_use_id);
+                    if (tc) {
+                        tc.output = parsed.content;
+                        tc.endTime = new Date(parsed.timestamp ?? Date.now());
+                    }
+                }
+                else if (parsed.type === 'result') {
+                    isComplete = true;
+                    result = parsed.result;
+                }
+            }
+            catch {
+                // Not JSON, treat as plain text
+                messages.push({
+                    role: 'assistant',
+                    content: line,
+                    timestamp: new Date(),
+                });
+            }
+        }
+        return { messages, toolCalls, result, isComplete };
+    },
+};
+//# sourceMappingURL=subprocess.js.map