cognitive-core 0.0.2 → 0.1.2

package/dist/runtime/backends/acp-protocol.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ACP Protocol Handler (Base Class)
+ *
+ * Extracts the ACP wire protocol handling (processUpdate, runPrompt,
+ * session state management) from the monolithic ACPBackend into a
+ * reusable base class.
+ *
+ * Backend implementations (local, remote) extend this and provide
+ * their own spawn() / terminate() for their compute environment.
+ */
+import type { Session, ExtendedSessionUpdate } from 'acp-factory';
+import type { AgentSpawnConfig, AgentSession } from '../types.js';
+/**
+ * Base session state shared by all ACP backends.
+ * Subclasses can extend this with backend-specific fields.
+ */
+export interface ACPSessionBase {
+    atlasSession: AgentSession;
+    acpSession: Session;
+}
+/**
+ * Abstract base class that handles ACP wire protocol concerns:
+ * - processUpdate(): Parses ExtendedSessionUpdate into AgentSession messages/tool calls
+ * - runPrompt(): Streams updates from an ACP session prompt
+ * - Common session accessors (getSession, sendMessage, listSessions)
+ *
+ * Subclasses provide their own lifecycle management (spawn, terminate).
+ */
+export declare abstract class ACPProtocolHandler<TState extends ACPSessionBase = ACPSessionBase> {
+    protected sessions: Map<string, TState>;
+    /**
+     * Process a session update from the agent.
+     * Uses defensive typing since ACP types can vary.
+     */
+    protected processUpdate(session: AgentSession, update: ExtendedSessionUpdate, config: AgentSpawnConfig): void;
+    /**
+     * Run a prompt on an ACP session and collect all streaming updates
+     * into the Atlas session.
+     */
+    protected runPrompt(state: TState, promptContent: string, config: AgentSpawnConfig): Promise<void>;
+    getSession(sessionId: string): Promise<AgentSession | undefined>;
+    sendMessage(sessionId: string, message: string): Promise<void>;
+    listSessions(): Promise<AgentSession[]>;
+    /**
+     * Get a raw ACP session for advanced usage
+     */
+    getACPSession(sessionId: string): Session | undefined;
+}
+//# sourceMappingURL=acp-protocol.d.ts.map

package/dist/runtime/backends/acp-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-protocol.d.ts","sourceRoot":"","sources":["../../../src/runtime/backends/acp-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,OAAO,EACP,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EAGb,MAAM,aAAa,CAAC;AAMrB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD;;;;;;;GAOG;AACH,8BAAsB,kBAAkB,CACtC,MAAM,SAAS,cAAc,GAAG,cAAc;IAE9C,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAMpD;;;OAGG;IACH,SAAS,CAAC,aAAa,CACrB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,gBAAgB,GACvB,IAAI;IAuGP;;;OAGG;cACa,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC;IA2BV,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;IAe9D,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7C;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;CAGtD"}

package/dist/runtime/backends/acp-protocol.js

@@ -0,0 +1,166 @@
+// ============================================================
+// Protocol Handler Base Class
+// ============================================================
+/**
+ * Abstract base class that handles ACP wire protocol concerns:
+ * - processUpdate(): Parses ExtendedSessionUpdate into AgentSession messages/tool calls
+ * - runPrompt(): Streams updates from an ACP session prompt
+ * - Common session accessors (getSession, sendMessage, listSessions)
+ *
+ * Subclasses provide their own lifecycle management (spawn, terminate).
+ */
+export class ACPProtocolHandler {
+    sessions = new Map();
+    // ----------------------------------------------------------
+    // Protocol: process a single ACP session update
+    // ----------------------------------------------------------
+    /**
+     * 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;
+        }
+    }
+    // ----------------------------------------------------------
+    // Protocol: run a prompt and collect streaming updates
+    // ----------------------------------------------------------
+    /**
+     * Run a prompt on an ACP session and collect all streaming updates
+     * into the Atlas session.
+     */
+    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(`[ACPProtocol] Session ${atlasSession.id} prompt execution failed:`, error instanceof Error ? error.message : String(error));
+        }
+    }
+    // ----------------------------------------------------------
+    // Common session accessors
+    // ----------------------------------------------------------
+    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 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;
+    }
+}
+//# sourceMappingURL=acp-protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acp-protocol.js","sourceRoot":"","sources":["../../../src/runtime/backends/acp-protocol.ts"],"names":[],"mappings":"AAkCA,+DAA+D;AAC/D,8BAA8B;AAC9B,+DAA+D;AAE/D;;;;;;;GAOG;AACH,MAAM,OAAgB,kBAAkB;IAG5B,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEpD,6DAA6D;IAC7D,gDAAgD;IAChD,6DAA6D;IAE7D;;;OAGG;IACO,aAAa,CACrB,OAAqB,EACrB,MAA6B,EAC7B,MAAwB;QAExB,8EAA8E;QAC9E,MAAM,CAAC,GAAG,MAAiC,CAAC;QAC5C,MAAM,UAAU,GAAG,CAAC,CAAC,aAAuB,CAAC;QAE7C,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,qBAAqB,CAAC;YAC3B,KAAK,oBAAoB,CAAC;YAC1B,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,2DAA2D;gBAC3D,MAAM,OAAO,GAAG,CAAC,CAAC,OAA8C,CAAC;gBACjE,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC3E,MAAM,OAAO,GAAiB;wBAC5B,IAAI,EAAE,UAAU,KAAK,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW;wBAChE,OAAO,EAAE,OAAO,CAAC,IAAI;wBACrB,SAAS,EAAE,IAAI,IAAI,EAAE;qBACtB,CAAC;oBACF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBAC/B,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;gBAC9B,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,kEAAkE;gBAClE,MAAM,UAAU,GAAI,CAAC,CAAC,UAAqB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACnE,MAAM,KAAK,GAAI,CAAC,CAAC,KAAgB,IAAI,SAAS,CAAC;gBAC/C,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;gBAE5B,MAAM,QAAQ,GAAa;oBACzB,EAAE,EAAE,UAAU;oBACd,IAAI,EAAE,KAAK;oBACX,KAAK,EAAE,QAAQ;oBACf,SAAS,EAAE,IAAI,IAAI,EAAE;iBACtB,CAAC;gBACF,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjC,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;gBAC9B,MAAM;YACR,CAAC;YAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,uDAAuD;gBACvD,MAAM,UAAU,GAAG,CAAC,CAAC,UAAoB,CAAC;gBAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,MAA4B,CAAC;gBAC9C,MAAM,OAAO,GAAG,CAAC,CAAC,OAAqD,CAAC;gBAExE,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;gBACtE,IAAI,UAAU,EAAE,CAAC;oBACf,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;wBAClD,UAAU,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;oBAClC,CAAC;oBACD,IAAI,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;wBACtC,mCAAmC;wBACnC,MAAM,OAAO,GAAa,EAAE,CAAC;wBAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;4BAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gCAC5D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;4BAC3B,CAAC;iCAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gCACnE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;4BAC3B,CAAC;wBACH,CAAC;wBACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACvB,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACzC,CAAC;oBACH,CAAC;oBACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;wBACxB,UAAU,CAAC,KAAK,GAAG,kBAAkB,CAAC;oBACxC,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,0DAA0D;gBAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACpB,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,yBAAyB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;oBAC1D,SAAS,EAAE,IAAI,IAAI,EAAE;iBACtB,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,wBAAwB;gBACxB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;gBACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACpB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;oBACzC,SAAS,EAAE,IAAI,IAAI,EAAE;iBACtB,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YAED;gBACE,kCAAkC;gBAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;QACzC,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,uDAAuD;IACvD,6DAA6D;IAE7D;;;OAGG;IACO,KAAK,CAAC,SAAS,CACvB,KAAa,EACb,aAAqB,EACrB,MAAwB;QAExB,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAE3C,IAAI,CAAC;YACH,gCAAgC;YAChC,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC5D,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAED,oBAAoB;YACpB,YAAY,CAAC,KAAK,GAAG,WAAW,CAAC;YACjC,YAAY,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,KAAK,GAAG,QAAQ,CAAC;YAC9B,YAAY,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC9E,YAAY,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CACX,yBAAyB,YAAY,CAAC,EAAE,2BAA2B,EACnE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,2BAA2B;IAC3B,6DAA6D;IAE7D,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,OAAe;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,yBAAyB;QACzB,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE;gBAC7C,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,SAAS;gBACvC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAClD,CAAC;CACF"}

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

@@ -0,0 +1,67 @@
+/**
+ * Local ACP Backend using acp-factory
+ *
+ * Extends ACPProtocolHandler with local process spawning via AgentFactory.
+ * The protocol handling (processUpdate, runPrompt, session management) is
+ * inherited from the base class so it can be reused by future remote backends.
+ */
+import { AgentHandle, type AgentConfig } from 'acp-factory';
+import type { AgentBackend, AgentSpawnConfig, AgentSession } from '../types.js';
+import { ACPProtocolHandler, type ACPSessionBase } from './acp-protocol.js';
+/**
+ * ACP agent configuration
+ */
+export interface ACPAgentConfig extends AgentConfig {
+    /** Display name for the agent */
+    displayName?: string;
+}
+/**
+ * Session state for locally-spawned ACP agents.
+ * Extends the base with an AgentHandle for process lifecycle.
+ */
+interface LocalACPSessionState extends ACPSessionBase {
+    agentHandle: AgentHandle;
+}
+/**
+ * Local ACP Backend
+ *
+ * Spawns ACP-compatible agents as local processes via AgentFactory.
+ * Protocol handling is inherited from ACPProtocolHandler.
+ */
+export declare class LocalACPBackend extends ACPProtocolHandler<LocalACPSessionState> implements AgentBackend {
+    readonly name = "acp";
+    readonly supportedTypes: string[];
+    private handles;
+    constructor(configs: Record<string, ACPAgentConfig>);
+    isAvailable(): Promise<boolean>;
+    spawn(config: AgentSpawnConfig): Promise<AgentSession>;
+    terminate(sessionId: string): Promise<void>;
+    /**
+     * Get a raw agent handle for advanced usage (local-specific)
+     */
+    getAgentHandle(sessionId: string): AgentHandle | undefined;
+}
+/**
+ * @deprecated Use LocalACPBackend directly. ACPBackend is a backward-compatible alias.
+ */
+export declare const ACPBackend: typeof LocalACPBackend;
+export type ACPBackend = LocalACPBackend;
+/**
+ * Create an ACP backend with agent configurations
+ */
+export declare function createACPBackend(configs: Record<string, ACPAgentConfig>): LocalACPBackend;
+/**
+ * Pre-configured Claude Code agent via claude-code-acp
+ */
+export declare const claudeCodeACPConfig: ACPAgentConfig;
+/**
+ * Pre-configured Claude direct (requires --print mode)
+ * Note: This may not support full ACP protocol
+ */
+export declare const claudeCodeDirectConfig: ACPAgentConfig;
+/**
+ * Helper to register common agents
+ */
+export declare function registerCommonAgents(): void;
+export {};
+//# sourceMappingURL=acp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../../../src/runtime/backends/acp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAEL,WAAW,EACX,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM5E;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,UAAU,oBAAqB,SAAQ,cAAc;IACnD,WAAW,EAAE,WAAW,CAAC;CAC1B;AAMD;;;;;GAKG;AACH,qBAAa,eACX,SAAQ,kBAAkB,CAAC,oBAAoB,CAC/C,YAAW,YAAY;IAEvB,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAElC,OAAO,CAAC,OAAO,CAAuC;gBAE1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAc7C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAmEtD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCjD;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG3D;AAMD;;GAEG;AACH,eAAO,MAAM,UAAU,wBAAkB,CAAC;AAC1C,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC;AAMzC;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GACtC,eAAe,CAEjB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAIjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAIpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}

package/dist/runtime/backends/acp.js

@@ -0,0 +1,166 @@
+/**
+ * Local ACP Backend using acp-factory
+ *
+ * Extends ACPProtocolHandler with local process spawning via AgentFactory.
+ * The protocol handling (processUpdate, runPrompt, session management) is
+ * inherited from the base class so it can be reused by future remote backends.
+ */
+import { AgentFactory, } from 'acp-factory';
+import { ACPProtocolHandler } from './acp-protocol.js';
+// ============================================================
+// LocalACPBackend
+// ============================================================
+/**
+ * Local ACP Backend
+ *
+ * Spawns ACP-compatible agents as local processes via AgentFactory.
+ * Protocol handling is inherited from ACPProtocolHandler.
+ */
+export class LocalACPBackend extends ACPProtocolHandler {
+    name = 'acp';
+    supportedTypes;
+    handles = new Map();
+    constructor(configs) {
+        super();
+        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 locally via AgentFactory
+            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 (inherited protocol handler)
+            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(`[LocalACPBackend] Session ${atlasSessionId} spawn failed:`, error instanceof Error ? error.message : String(error));
+            return atlasSession;
+        }
+    }
+    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(`[LocalACPBackend] Session ${sessionId} cancel error:`, error instanceof Error ? error.message : String(error));
+        }
+        try {
+            // Close the local agent handle
+            await state.agentHandle.close();
+        }
+        catch (error) {
+            // Log close errors but don't throw
+            console.error(`[LocalACPBackend] 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);
+    }
+    /**
+     * Get a raw agent handle for advanced usage (local-specific)
+     */
+    getAgentHandle(sessionId) {
+        return this.sessions.get(sessionId)?.agentHandle;
+    }
+}
+// ============================================================
+// Backward-compatible alias
+// ============================================================
+/**
+ * @deprecated Use LocalACPBackend directly. ACPBackend is a backward-compatible alias.
+ */
+export const ACPBackend = LocalACPBackend;
+// ============================================================
+// Factory helpers
+// ============================================================
+/**
+ * Create an ACP backend with agent configurations
+ */
+export function createACPBackend(configs) {
+    return new LocalACPBackend(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,7 @@
+export { SubprocessBackend, createSubprocessBackend, claudeCodeConfig, type SubprocessAgentConfig, } from './subprocess.js';
+export { MockBackend, createMockBackend, type MockAgentBehavior, } from './mock.js';
+export { LocalACPBackend, ACPBackend, createACPBackend, claudeCodeACPConfig, claudeCodeDirectConfig, registerCommonAgents, type ACPAgentConfig, } from './acp.js';
+export { ACPProtocolHandler, type ACPSessionBase, } from './acp-protocol.js';
+export { MacroAgentBackendAdapter, adaptMacroBackend, createMacroAgentSource, type MacroAgentBackendLike, type MacroSessionLike, } from './macro-agent.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,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/backends/index.js

@@ -0,0 +1,8 @@
+export { SubprocessBackend, createSubprocessBackend, claudeCodeConfig, } from './subprocess.js';
+export { MockBackend, createMockBackend, } from './mock.js';
+export { LocalACPBackend, ACPBackend, createACPBackend, claudeCodeACPConfig, claudeCodeDirectConfig, registerCommonAgents, } from './acp.js';
+export { ACPProtocolHandler, } from './acp-protocol.js';
+export { MacroAgentBackendAdapter, adaptMacroBackend, createMacroAgentSource, } from './macro-agent.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,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GAErB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,GAGvB,MAAM,kBAAkB,CAAC;AAE1B,0CAA0C;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/backends/macro-agent.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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);
+ * ```
+ */
+import type { AgentBackend, AgentSpawnConfig, AgentSession, AgentMessage, ToolCall } from '../types.js';
+import type { ComputeSource, CostTier } from '../compute-provider.js';
+/**
+ * Structural contract for macro-agent's MacroAgentBackend.
+ *
+ * Any object matching this shape can be adapted — no import from
+ * macro-agent is needed. macro-agent's bridge types (CognitiveAgentSession,
+ * CognitiveAgentMessage, CognitiveToolCall) are structurally identical
+ * to cognitive-core's canonical types.
+ */
+export interface MacroAgentBackendLike {
+    readonly name: string;
+    readonly supportedTypes: readonly string[];
+    isAvailable(): Promise<boolean>;
+    spawn(config: {
+        agentType: string;
+        task: {
+            description: string;
+        };
+    }): Promise<MacroSessionLike>;
+    getSession(sessionId: string): Promise<MacroSessionLike | undefined>;
+    terminate(sessionId: string): Promise<void>;
+    listSessions(): Promise<MacroSessionLike[]>;
+}
+/**
+ * Structural contract for macro-agent's CognitiveAgentSession.
+ */
+export interface MacroSessionLike {
+    id: string;
+    agentType: string;
+    task: {
+        description: string;
+    };
+    state: string;
+    messages: AgentMessage[];
+    toolCalls: ToolCall[];
+    startTime: Date;
+    endTime?: Date;
+    result?: unknown;
+    error?: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * 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 declare class MacroAgentBackendAdapter implements AgentBackend {
+    readonly name: string;
+    readonly supportedTypes: string[];
+    private readonly inner;
+    private readonly taskCache;
+    constructor(backend: MacroAgentBackendLike);
+    isAvailable(): Promise<boolean>;
+    spawn(config: AgentSpawnConfig): Promise<AgentSession>;
+    getSession(sessionId: string): Promise<AgentSession | undefined>;
+    terminate(sessionId: string): Promise<void>;
+    listSessions(): Promise<AgentSession[]>;
+    private toAgentSession;
+}
+/**
+ * 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 declare function adaptMacroBackend(backend: MacroAgentBackendLike): AgentBackend;
+/**
+ * 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 declare function createMacroAgentSource(backend: MacroAgentBackendLike, options?: {
+    costTier?: CostTier;
+    location?: 'local' | 'remote';
+    priority?: number;
+}): ComputeSource;
+//# sourceMappingURL=macro-agent.d.ts.map

package/dist/runtime/backends/macro-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macro-agent.d.ts","sourceRoot":"","sources":["../../../src/runtime/backends/macro-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAKtE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,MAAM,EAAE;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACrE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,YAAY,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAID;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;gBAEzC,OAAO,EAAE,qBAAqB;IAMpC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAMtD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAMhE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK7C,OAAO,CAAC,cAAc;CAkBvB;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,qBAAqB,GAC7B,YAAY,CAEd;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,aAAa,CAQf"}