cognitive-core 0.0.1 → 0.1.0

package/dist/runtime/backends/acp.js

@@ -0,0 +1,290 @@
+/**
+ * ACP Backend using acp-factory
+ *
+ * This backend uses the acp-factory package to spawn and manage ACP-compatible
+ * agents like Claude Code, providing a clean interface for Atlas integration.
+ */
+import { AgentFactory, } from 'acp-factory';
+/**
+ * ACP Backend
+ * Uses acp-factory to spawn and manage ACP-compatible agents
+ */
+export class ACPBackend {
+    name = 'acp';
+    supportedTypes;
+    sessions = new Map();
+    handles = new Map();
+    constructor(configs) {
+        this.supportedTypes = Object.keys(configs);
+        // Register all agent configs with AgentFactory
+        for (const [name, config] of Object.entries(configs)) {
+            AgentFactory.register(name, {
+                command: config.command,
+                args: config.args,
+                env: config.env,
+            });
+        }
+    }
+    async isAvailable() {
+        return this.supportedTypes.length > 0;
+    }
+    async spawn(config) {
+        const atlasSessionId = crypto.randomUUID();
+        // Create Atlas session tracking
+        const atlasSession = {
+            id: atlasSessionId,
+            agentType: config.agentType,
+            task: config.task,
+            state: 'running',
+            messages: [],
+            toolCalls: [],
+            startTime: new Date(),
+            metadata: {
+                injectedKnowledge: !!config.injectedKnowledge,
+            },
+        };
+        try {
+            // Spawn the agent
+            const spawnOptions = {
+                permissionMode: 'auto-approve', // Auto-approve for automated learning
+                env: config.env,
+            };
+            const agentHandle = await AgentFactory.spawn(config.agentType, spawnOptions);
+            this.handles.set(atlasSessionId, agentHandle);
+            // Store capabilities
+            atlasSession.metadata.capabilities = agentHandle.capabilities;
+            // Create a session with the agent
+            const cwd = config.cwd ?? process.cwd();
+            const acpSession = await agentHandle.createSession(cwd);
+            // Store session state
+            const state = {
+                atlasSession,
+                agentHandle,
+                acpSession,
+            };
+            this.sessions.set(atlasSessionId, state);
+            // Build prompt content with knowledge injection
+            let promptContent = config.task.description;
+            if (config.systemPromptAdditions) {
+                promptContent = `## Context from Atlas Memory\n\n${config.systemPromptAdditions}\n\n---\n\n${promptContent}`;
+            }
+            if (Object.keys(config.task.context).length > 0) {
+                promptContent += `\n\n## Additional Context\n\`\`\`json\n${JSON.stringify(config.task.context, null, 2)}\n\`\`\``;
+            }
+            // Send prompt and collect updates
+            await this.runPrompt(state, promptContent, config);
+            return atlasSession;
+        }
+        catch (error) {
+            atlasSession.state = 'failed';
+            atlasSession.error = error instanceof Error ? error.message : 'Unknown error';
+            atlasSession.endTime = new Date();
+            console.error(`[ACPBackend] Session ${atlasSessionId} spawn failed:`, error instanceof Error ? error.message : String(error));
+            return atlasSession;
+        }
+    }
+    /**
+     * Run a prompt and collect all updates
+     */
+    async runPrompt(state, promptContent, config) {
+        const { atlasSession, acpSession } = state;
+        try {
+            // Stream updates from the agent
+            for await (const update of acpSession.prompt(promptContent)) {
+                this.processUpdate(atlasSession, update, config);
+            }
+            // Mark as completed
+            atlasSession.state = 'completed';
+            atlasSession.endTime = new Date();
+        }
+        catch (error) {
+            atlasSession.state = 'failed';
+            atlasSession.error = error instanceof Error ? error.message : 'Unknown error';
+            atlasSession.endTime = new Date();
+            console.error(`[ACPBackend] Session ${atlasSession.id} prompt execution failed:`, error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Process a session update from the agent
+     * Uses defensive typing since ACP types can vary
+     */
+    processUpdate(session, update, config) {
+        // Cast to any for flexible property access since ACP types are complex unions
+        const u = update;
+        const updateType = u.sessionUpdate;
+        switch (updateType) {
+            case 'agent_message_chunk':
+            case 'user_message_chunk':
+            case 'agent_thought_chunk': {
+                // ContentChunk has a single 'content' field (ContentBlock)
+                const content = u.content;
+                if (content && content.type === 'text' && typeof content.text === 'string') {
+                    const message = {
+                        role: updateType === 'user_message_chunk' ? 'user' : 'assistant',
+                        content: content.text,
+                        timestamp: new Date(),
+                    };
+                    session.messages.push(message);
+                    config.onMessage?.(message);
+                }
+                break;
+            }
+            case 'tool_call': {
+                // ToolCall has toolCallId, title, rawInput, status, content, etc.
+                const toolCallId = u.toolCallId ?? crypto.randomUUID();
+                const title = u.title ?? 'unknown';
+                const rawInput = u.rawInput;
+                const toolCall = {
+                    id: toolCallId,
+                    name: title,
+                    input: rawInput,
+                    startTime: new Date(),
+                };
+                session.toolCalls.push(toolCall);
+                config.onToolCall?.(toolCall);
+                break;
+            }
+            case 'tool_call_update': {
+                // ToolCallUpdate has toolCallId, status, content, etc.
+                const toolCallId = u.toolCallId;
+                const status = u.status;
+                const content = u.content;
+                const existingTc = session.toolCalls.find((t) => t.id === toolCallId);
+                if (existingTc) {
+                    if (status === 'completed' || status === 'failed') {
+                        existingTc.endTime = new Date();
+                    }
+                    if (content && Array.isArray(content)) {
+                        // Extract text from content blocks
+                        const outputs = [];
+                        for (const block of content) {
+                            if (block.type === 'text' && typeof block.text === 'string') {
+                                outputs.push(block.text);
+                            }
+                            else if (block.type === 'diff' && typeof block.diff === 'string') {
+                                outputs.push(block.diff);
+                            }
+                        }
+                        if (outputs.length > 0) {
+                            existingTc.output = outputs.join('\n');
+                        }
+                    }
+                    if (status === 'failed') {
+                        existingTc.error = 'Tool call failed';
+                    }
+                }
+                break;
+            }
+            case 'permission_request': {
+                // In auto-approve mode, this shouldn't happen, but log it
+                session.messages.push({
+                    role: 'system',
+                    content: `Permission requested: ${JSON.stringify(update)}`,
+                    timestamp: new Date(),
+                });
+                break;
+            }
+            case 'plan': {
+                // Agent shared its plan
+                const plan = u.plan;
+                session.messages.push({
+                    role: 'assistant',
+                    content: `[Plan] ${JSON.stringify(plan)}`,
+                    timestamp: new Date(),
+                });
+                break;
+            }
+            default:
+                // Log other updates for debugging
+                session.metadata.lastUpdate = update;
+        }
+    }
+    async getSession(sessionId) {
+        return this.sessions.get(sessionId)?.atlasSession;
+    }
+    async sendMessage(sessionId, message) {
+        const state = this.sessions.get(sessionId);
+        if (!state) {
+            throw new Error('Session not found');
+        }
+        // Send additional prompt
+        for await (const update of state.acpSession.prompt(message)) {
+            this.processUpdate(state.atlasSession, update, {
+                agentType: state.atlasSession.agentType,
+                task: state.atlasSession.task,
+            });
+        }
+    }
+    async terminate(sessionId) {
+        const state = this.sessions.get(sessionId);
+        if (!state)
+            return;
+        try {
+            // Cancel any running prompt
+            await state.acpSession.cancel();
+        }
+        catch (error) {
+            // Log cancellation errors but don't throw
+            console.error(`[ACPBackend] Session ${sessionId} cancel error:`, error instanceof Error ? error.message : String(error));
+        }
+        try {
+            // Close the agent handle
+            await state.agentHandle.close();
+        }
+        catch (error) {
+            // Log close errors but don't throw
+            console.error(`[ACPBackend] Session ${sessionId} close error:`, error instanceof Error ? error.message : String(error));
+        }
+        state.atlasSession.state = 'failed';
+        state.atlasSession.error = 'Terminated';
+        state.atlasSession.endTime = new Date();
+        this.sessions.delete(sessionId);
+        this.handles.delete(sessionId);
+    }
+    async listSessions() {
+        return Array.from(this.sessions.values()).map((s) => s.atlasSession);
+    }
+    /**
+     * Get a raw ACP session for advanced usage
+     */
+    getACPSession(sessionId) {
+        return this.sessions.get(sessionId)?.acpSession;
+    }
+    /**
+     * Get a raw agent handle for advanced usage
+     */
+    getAgentHandle(sessionId) {
+        return this.sessions.get(sessionId)?.agentHandle;
+    }
+}
+/**
+ * Create an ACP backend with agent configurations
+ */
+export function createACPBackend(configs) {
+    return new ACPBackend(configs);
+}
+/**
+ * Pre-configured Claude Code agent via claude-code-acp
+ */
+export const claudeCodeACPConfig = {
+    command: 'npx',
+    args: ['claude-code-acp'],
+    displayName: 'Claude Code (ACP)',
+};
+/**
+ * Pre-configured Claude direct (requires --print mode)
+ * Note: This may not support full ACP protocol
+ */
+export const claudeCodeDirectConfig = {
+    command: 'claude',
+    args: ['--print'],
+    displayName: 'Claude (Direct)',
+};
+/**
+ * Helper to register common agents
+ */
+export function registerCommonAgents() {
+    AgentFactory.register('claude-code', claudeCodeACPConfig);
+    AgentFactory.register('claude-code-acp', claudeCodeACPConfig);
+}
+//# sourceMappingURL=acp.js.map

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

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

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

@@ -0,0 +1,5 @@
+export { SubprocessBackend, createSubprocessBackend, claudeCodeConfig, type SubprocessAgentConfig, } from './subprocess.js';
+export { MockBackend, createMockBackend, type MockAgentBehavior, } from './mock.js';
+export { ACPBackend, createACPBackend, claudeCodeACPConfig, claudeCodeDirectConfig, registerCommonAgents, type ACPAgentConfig, } from './acp.js';
+export { AgentFactory } from 'acp-factory';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/backends/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/backends/index.js

@@ -0,0 +1,6 @@
+export { SubprocessBackend, createSubprocessBackend, claudeCodeConfig, } from './subprocess.js';
+export { MockBackend, createMockBackend, } from './mock.js';
+export { ACPBackend, createACPBackend, claudeCodeACPConfig, claudeCodeDirectConfig, registerCommonAgents, } from './acp.js';
+// Re-export useful types from acp-factory
+export { AgentFactory } from 'acp-factory';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/backends/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,iBAAiB,GAElB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GAErB,MAAM,UAAU,CAAC;AAElB,0CAA0C;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

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":"AAmCA;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,MAAM,CAAC;IACd,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,QAAQ,GAA8B,IAAI,GAAG,EAAE,CAAC;IAChD,SAAS,GAAmC,IAAI,GAAG,EAAE,CAAC;IACtD,eAAe,CAAoB;IAE3C,YAAY,eAAmC;QAC7C,IAAI,CAAC,eAAe,GAAG,eAAe,IAAI;YACxC,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,GAAG;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,eAAuB,EAAE,QAA2B;QAC9D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAA2B;QAC5C,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAwB;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,QAAQ,GACZ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC;QAEtE,MAAM,OAAO,GAAiB;YAC5B,EAAE,EAAE,SAAS;YACb,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE;gBACR,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,iBAAiB;gBAC7C,wBAAwB,EAAE,CAAC,CAAC,MAAM,CAAC,qBAAqB;aACzD;SACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEtC,oCAAoC;QACpC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAChE,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;YACzB,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,OAAO,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,OAAqB,EACrB,QAA2B,EAC3B,MAAwB;QAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,gBAAgB;QAChB,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACpC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAChB,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;gBAED,MAAM,OAAO,GAAiB;oBAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,SAAS,EAAE,IAAI,IAAI,EAAE;iBACtB,CAAC;gBACF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC/B,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACpC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;oBACf,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;gBAC/B,CAAC;gBAED,MAAM,QAAQ,GAAa;oBACzB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;oBACvB,IAAI,EAAE,EAAE,CAAC,IAAI;oBACb,KAAK,EAAE,EAAE,CAAC,KAAK;oBACf,MAAM,EAAE,EAAE,CAAC,MAAM;oBACjB,SAAS,EAAE,IAAI,IAAI,EAAE;oBACrB,OAAO,EAAE,IAAI,IAAI,EAAE;iBACpB,CAAC;gBACF,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjC,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACvC,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC;QACzD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QAED,WAAW;QACX,OAAO,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC;YAC5B,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;YACzB,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,cAAc,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,QAAgB;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QACD,2CAA2C;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;QACzB,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC;QAC7B,OAAO,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,eAAmC;IAEnC,OAAO,IAAI,WAAW,CAAC,eAAe,CAAC,CAAC;AAC1C,CAAC"}

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"}