@sudocode-ai/local-server 0.1.7 → 0.1.9

package/dist/workers/execution-worker.js

@@ -0,0 +1,340 @@
+/**
+ * Execution Worker Process Entry Point
+ *
+ * Standalone Node.js process that runs Claude Code executions in isolation.
+ * Communicates with main process via IPC (Inter-Process Communication).
+ *
+ * Environment Variables:
+ * - EXECUTION_ID: Execution record ID
+ * - PROJECT_ID: Project identifier
+ * - REPO_PATH: Path to git repository
+ * - DB_PATH: Path to SQLite database
+ * - WORKER_ID: Unique worker identifier
+ * - MAX_MEMORY_MB: Memory limit (for logging)
+ *
+ * @module workers/execution-worker
+ */
+import Database from "better-sqlite3";
+import { isMainMessage } from "./worker-ipc.js";
+import { createExecutorForAgent } from "../execution/executors/executor-factory.js";
+import { ExecutionLifecycleService } from "../services/execution-lifecycle.js";
+import { ExecutionLogsStore } from "../services/execution-logs-store.js";
+import { IpcTransportManager } from "../execution/transport/ipc-transport-manager.js";
+import { getExecution, updateExecution } from "../services/executions.js";
+// Validate required environment variables
+const EXECUTION_ID = process.env.EXECUTION_ID;
+const PROJECT_ID = process.env.PROJECT_ID;
+const REPO_PATH = process.env.REPO_PATH;
+const DB_PATH = process.env.DB_PATH;
+const WORKER_ID = process.env.WORKER_ID;
+const MAX_MEMORY_MB = process.env.MAX_MEMORY_MB;
+if (!EXECUTION_ID || !PROJECT_ID || !REPO_PATH || !DB_PATH || !WORKER_ID) {
+    console.error("[Worker] Missing required environment variables");
+    process.exit(1);
+}
+console.log(`[Worker:${WORKER_ID}] Starting execution worker for ${EXECUTION_ID}`);
+/**
+ * Send IPC message to main process
+ */
+function sendToMain(message) {
+    if (!process.send) {
+        console.error("[Worker] IPC not available (process.send is undefined)");
+        return;
+    }
+    try {
+        process.send(message);
+    }
+    catch (error) {
+        console.error("[Worker] Failed to send IPC message:", error);
+    }
+}
+/**
+ * Send log event to main process
+ * Note: Currently unused as AgentExecutorWrapper handles log storage directly.
+ * Kept for backward compatibility with IPC protocol.
+ */
+// function sendLog(data: OutputEvent): void {
+//   sendToMain({
+//     type: "log",
+//     executionId: EXECUTION_ID!,
+//     data,
+//   });
+// }
+/**
+ * Send status update to main process
+ */
+function sendStatus(status) {
+    sendToMain({
+        type: "status",
+        executionId: EXECUTION_ID,
+        status: status,
+    });
+}
+/**
+ * Send completion result to main process
+ */
+function sendComplete(result) {
+    sendToMain({
+        type: "complete",
+        executionId: EXECUTION_ID,
+        result,
+    });
+}
+/**
+ * Send error to main process
+ */
+function sendError(error, fatal = false) {
+    sendToMain({
+        type: "error",
+        executionId: EXECUTION_ID,
+        error,
+        fatal,
+    });
+}
+/**
+ * Flag to track if execution should be canceled
+ */
+let cancelRequested = false;
+/**
+ * Listen for messages from main process
+ */
+process.on("message", (message) => {
+    if (!isMainMessage(message)) {
+        console.warn("[Worker] Received invalid message from main:", message);
+        return;
+    }
+    switch (message.type) {
+        case "cancel":
+            console.log(`[Worker:${WORKER_ID}] Cancel requested`);
+            cancelRequested = true;
+            // Orchestrator will handle graceful cancellation
+            break;
+        case "ping":
+            // Health check - just acknowledge
+            console.log(`[Worker:${WORKER_ID}] Ping received`);
+            break;
+    }
+});
+/**
+ * Main execution function
+ */
+async function runExecution() {
+    let db = null;
+    try {
+        // 1. Initialize database connection
+        console.log(`[Worker:${WORKER_ID}] Connecting to database: ${DB_PATH}`);
+        db = new Database(DB_PATH);
+        // 2. Load execution record
+        const execution = getExecution(db, EXECUTION_ID);
+        if (!execution) {
+            throw new Error(`Execution ${EXECUTION_ID} not found in database`);
+        }
+        console.log(`[Worker:${WORKER_ID}] Loaded execution:`, {
+            id: execution.id,
+            issueId: execution.issue_id,
+            mode: execution.mode,
+            status: execution.status,
+        });
+        // 3. Parse execution config
+        const config = execution.config ? JSON.parse(execution.config) : {};
+        const prompt = execution.prompt || "";
+        if (!prompt.trim()) {
+            throw new Error("Execution prompt is empty");
+        }
+        // 4. Determine work directory
+        const workDir = execution.mode === "worktree"
+            ? execution.worktree_path || REPO_PATH
+            : REPO_PATH;
+        console.log(`[Worker:${WORKER_ID}] Work directory: ${workDir}`);
+        // 4.5. Validate worktree exists for worktree mode
+        if (execution.mode === "worktree" && execution.worktree_path) {
+            const fs = await import("fs/promises");
+            const path = await import("path");
+            try {
+                // Check if worktree path exists
+                const stats = await fs.stat(execution.worktree_path);
+                if (!stats.isDirectory()) {
+                    throw new Error(`Worktree path is not a directory: ${execution.worktree_path}`);
+                }
+                // Check if it's a valid git directory
+                const gitPath = path.join(execution.worktree_path, ".git");
+                await fs.access(gitPath);
+                console.log(`[Worker:${WORKER_ID}] Worktree validation passed`);
+            }
+            catch (error) {
+                // Provide clear error messages based on error code
+                let errorMessage;
+                if (error.code === "ENOENT") {
+                    errorMessage = `Worktree was deleted or does not exist at: ${execution.worktree_path}`;
+                }
+                else if (error.code === "ENOTDIR") {
+                    errorMessage = `Worktree path is not a valid directory: ${execution.worktree_path}`;
+                }
+                else if (error.code === "EACCES") {
+                    errorMessage = `Permission denied accessing worktree: ${execution.worktree_path}`;
+                }
+                else {
+                    errorMessage = `Failed to access worktree: ${error.message}`;
+                }
+                console.error(`[Worker:${WORKER_ID}] ${errorMessage}`);
+                // Attempt to recreate worktree
+                console.log(`[Worker:${WORKER_ID}] Attempting to recreate worktree...`);
+                try {
+                    const lifecycleService = new ExecutionLifecycleService(db, REPO_PATH);
+                    const worktreeManager = lifecycleService.worktreeManager;
+                    await worktreeManager.createWorktree({
+                        repoPath: REPO_PATH,
+                        branchName: execution.branch_name,
+                        worktreePath: execution.worktree_path,
+                        baseBranch: execution.target_branch,
+                        createBranch: false, // Branch should already exist
+                    });
+                    console.log(`[Worker:${WORKER_ID}] Successfully recreated worktree`);
+                }
+                catch (recreateError) {
+                    // Failed to recreate - this is a fatal error
+                    throw new Error(`${errorMessage}. Failed to recreate worktree: ${recreateError.message}`);
+                }
+            }
+        }
+        // 5. Send ready signal
+        sendToMain({
+            type: "ready",
+            executionId: EXECUTION_ID,
+            workerId: WORKER_ID,
+        });
+        // 6. Create services for AgentExecutorWrapper
+        const lifecycleService = new ExecutionLifecycleService(db, REPO_PATH);
+        const logsStore = new ExecutionLogsStore(db);
+        // 7. Create IPC transport manager to forward AG-UI events
+        const ipcTransport = new IpcTransportManager(EXECUTION_ID);
+        // 8. Determine agent type (default to claude-code for backwards compatibility)
+        const agentType = config.agentType || "claude-code";
+        // 9. Create executor using factory
+        const wrapper = createExecutorForAgent(agentType, { workDir: REPO_PATH, ...config }, {
+            workDir: REPO_PATH,
+            lifecycleService,
+            logsStore,
+            projectId: PROJECT_ID,
+            db,
+            transportManager: ipcTransport, // IpcTransportManager matches interface
+        });
+        // 10. Build execution task
+        const task = {
+            id: execution.id,
+            type: "issue",
+            entityId: execution.issue_id || undefined,
+            prompt: prompt,
+            workDir: workDir,
+            config: {
+                timeout: config.timeout,
+            },
+            metadata: {
+                model: config.model || "claude-sonnet-4",
+                captureFileChanges: config.captureFileChanges ?? true,
+                captureToolCalls: config.captureToolCalls ?? true,
+                issueId: execution.issue_id,
+                executionId: execution.id,
+            },
+            priority: 0,
+            dependencies: [],
+            createdAt: new Date(),
+        };
+        // 11. Update status to running
+        console.log(`[Worker:${WORKER_ID}] Starting execution with AgentExecutorWrapper (${agentType})`);
+        sendStatus("running");
+        // 12. Execute with lifecycle management (blocking)
+        const startTime = Date.now();
+        await wrapper.executeWithLifecycle(execution.id, task, workDir);
+        const duration = Date.now() - startTime;
+        console.log(`[Worker:${WORKER_ID}] Execution completed in ${duration}ms`);
+        // 13. Check if cancellation was requested
+        if (cancelRequested) {
+            console.log(`[Worker:${WORKER_ID}] Execution was cancelled`);
+            updateExecution(db, execution.id, {
+                status: "cancelled",
+                completed_at: new Date().toISOString(),
+            });
+            sendComplete({
+                status: "cancelled",
+                exitCode: 0,
+                completedAt: new Date().toISOString(),
+            });
+        }
+        else {
+            // Send completion (wrapper already updated DB and broadcast)
+            sendComplete({
+                status: "completed",
+                exitCode: 0,
+                completedAt: new Date().toISOString(),
+            });
+        }
+        console.log(`[Worker:${WORKER_ID}] Execution completed successfully`);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`[Worker:${WORKER_ID}] Execution failed:`, errorMessage);
+        // Wrapper already updated DB and broadcast, just send IPC message
+        sendError(errorMessage, true);
+        // Exit with failure code
+        process.exit(1);
+    }
+    finally {
+        // Clean up database connection
+        if (db) {
+            try {
+                db.close();
+                console.log(`[Worker:${WORKER_ID}] Database connection closed`);
+            }
+            catch (error) {
+                console.error(`[Worker:${WORKER_ID}] Error closing database:`, error);
+            }
+        }
+    }
+}
+/**
+ * Global error handlers
+ */
+process.on("uncaughtException", (error) => {
+    console.error(`[Worker:${WORKER_ID}] Uncaught exception:`, error);
+    sendError(`Uncaught exception: ${error.message}`, true);
+    process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+    console.error(`[Worker:${WORKER_ID}] Unhandled rejection:`, reason);
+    sendError(`Unhandled rejection: ${String(reason)}`, true);
+    process.exit(1);
+});
+/**
+ * Graceful shutdown handlers
+ */
+process.on("SIGTERM", () => {
+    console.log(`[Worker:${WORKER_ID}] Received SIGTERM, shutting down gracefully`);
+    cancelRequested = true;
+    // Let the orchestrator handle graceful shutdown
+    setTimeout(() => {
+        console.log(`[Worker:${WORKER_ID}] Force exit after grace period`);
+        process.exit(0);
+    }, 5000);
+});
+process.on("SIGINT", () => {
+    console.log(`[Worker:${WORKER_ID}] Received SIGINT, shutting down gracefully`);
+    cancelRequested = true;
+    setTimeout(() => {
+        process.exit(0);
+    }, 5000);
+});
+// Start execution
+console.log(`[Worker:${WORKER_ID}] Worker process initialized`);
+console.log(`[Worker:${WORKER_ID}] Memory limit: ${MAX_MEMORY_MB || "default"} MB`);
+console.log(`[Worker:${WORKER_ID}] PID: ${process.pid}`);
+runExecution()
+    .then(() => {
+    console.log(`[Worker:${WORKER_ID}] Worker exiting normally`);
+    process.exit(0);
+})
+    .catch((error) => {
+    console.error(`[Worker:${WORKER_ID}] Worker exiting with error:`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=execution-worker.js.map

package/dist/workers/execution-worker.js.map

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

package/dist/workers/worker-ipc.d.ts

@@ -0,0 +1,84 @@
+/**
+ * IPC Message Type Definitions for Worker Pool
+ *
+ * Defines the message protocol for bidirectional communication between
+ * main server process and worker processes.
+ *
+ * @module workers/worker-ipc
+ */
+import type { ExecutionStatus } from "@sudocode-ai/types";
+/**
+ * Output event from worker (logs, status updates)
+ */
+export interface OutputEvent {
+    type: "stdout" | "stderr" | "log";
+    data: string;
+    timestamp: string;
+}
+/**
+ * Execution result upon completion
+ */
+export interface ExecutionResult {
+    status: ExecutionStatus;
+    exitCode?: number;
+    error?: string;
+    completedAt: string;
+}
+/**
+ * Messages sent from Worker → Main Process
+ */
+export type WorkerToMainMessage = {
+    type: "ready";
+    executionId: string;
+    workerId: string;
+} | {
+    type: "log";
+    executionId: string;
+    data: OutputEvent;
+} | {
+    type: "agui-event";
+    executionId: string;
+    event: any;
+} | {
+    type: "status";
+    executionId: string;
+    status: ExecutionStatus;
+} | {
+    type: "complete";
+    executionId: string;
+    result: ExecutionResult;
+} | {
+    type: "error";
+    executionId: string;
+    error: string;
+    fatal?: boolean;
+};
+/**
+ * Messages sent from Main Process → Worker
+ */
+export type MainToWorkerMessage = {
+    type: "cancel";
+    executionId: string;
+} | {
+    type: "ping";
+};
+/**
+ * Worker environment configuration
+ */
+export interface WorkerEnv {
+    EXECUTION_ID: string;
+    PROJECT_ID: string;
+    REPO_PATH: string;
+    DB_PATH: string;
+    MAX_MEMORY_MB?: string;
+    WORKER_ID: string;
+}
+/**
+ * Type guard for WorkerToMainMessage
+ */
+export declare function isWorkerMessage(msg: any): msg is WorkerToMainMessage;
+/**
+ * Type guard for MainToWorkerMessage
+ */
+export declare function isMainMessage(msg: any): msg is MainToWorkerMessage;
+//# sourceMappingURL=worker-ipc.d.ts.map

package/dist/workers/worker-ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-ipc.d.ts","sourceRoot":"","sources":["../../src/workers/worker-ipc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;CACnB,GAED;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC;CACZ,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;CACzB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;CACzB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,mBAAmB,CAUpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,mBAAmB,CAQlE"}

package/dist/workers/worker-ipc.js

@@ -0,0 +1,29 @@
+/**
+ * IPC Message Type Definitions for Worker Pool
+ *
+ * Defines the message protocol for bidirectional communication between
+ * main server process and worker processes.
+ *
+ * @module workers/worker-ipc
+ */
+/**
+ * Type guard for WorkerToMainMessage
+ */
+export function isWorkerMessage(msg) {
+    return (msg &&
+        typeof msg === "object" &&
+        "type" in msg &&
+        typeof msg.type === "string" &&
+        ["ready", "log", "agui-event", "status", "complete", "error"].includes(msg.type));
+}
+/**
+ * Type guard for MainToWorkerMessage
+ */
+export function isMainMessage(msg) {
+    return (msg &&
+        typeof msg === "object" &&
+        "type" in msg &&
+        typeof msg.type === "string" &&
+        ["cancel", "ping"].includes(msg.type));
+}
+//# sourceMappingURL=worker-ipc.js.map

package/dist/workers/worker-ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-ipc.js","sourceRoot":"","sources":["../../src/workers/worker-ipc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsFH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAQ;IACtC,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAI,GAAG;QACb,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CACpE,GAAG,CAAC,IAAI,CACT,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAI,GAAG;QACb,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CACtC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudocode-ai/local-server",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Local backend server for sudocode - provides REST API and WebSocket endpoints",
   "main": "dist/index.js",
   "type": "module",
@@ -41,17 +41,17 @@
   },
   "dependencies": {
     "@ag-ui/core": "^0.0.39",
-    "@sudocode-ai/cli": "^0.1.7",
-    "@sudocode-ai/types": "^0.1.7",
+    "@sudocode-ai/cli": "^0.1.9",
+    "@sudocode-ai/types": "^0.1.9",
     "@types/ws": "^8.18.1",
-    "agent-execution-engine": "^0.0.4",
+    "agent-execution-engine": "^0.0.12",
     "async-mutex": "^0.5.0",
     "better-sqlite3": "^11.10.0",
     "cors": "^2.8.5",
-    "dotenv": "^16.4.5",
     "express": "^4.18.2",
     "glob": "^10.4.5",
     "node-fetch": "^2.7.0",
+    "which": "^6.0.0",
     "ws": "^8.18.3",
     "zod": "^3.22.4"
   },
@@ -61,6 +61,7 @@
     "@types/express": "^4.17.21",
     "@types/node": "^20.11.19",
     "@types/supertest": "^6.0.3",
+    "@types/which": "^3.0.4",
     "esbuild": "^0.27.0",
     "supertest": "^7.1.4",
     "tsx": "^4.7.1",

package/dist/execution/output/ag-ui-integration.d.ts

@@ -1,96 +0,0 @@
-/**
- * AG-UI Integration Helpers
- *
- * Factory functions and helpers to wire SPEC-007 output processing with SPEC-009 AG-UI streaming.
- * Simplifies the integration between ClaudeCodeOutputProcessor and AgUiEventAdapter.
- *
- * @module execution/output/ag-ui-integration
- */
-import { AgUiEventAdapter } from './ag-ui-adapter.js';
-import type { IOutputProcessor } from './types.js';
-/**
- * AG-UI System containing processor and adapter
- *
- * The processor handles parsing Claude Code output and emitting events.
- * The adapter transforms those events into AG-UI protocol events.
- */
-export interface AgUiSystem {
-    /** Output processor for parsing Claude Code stream-json */
-    processor: IOutputProcessor;
-    /** AG-UI event adapter for broadcasting events */
-    adapter: AgUiEventAdapter;
-}
-/**
- * Create a complete AG-UI system with processor and adapter pre-wired
- *
- * This is the recommended way to create an AG-UI streaming system.
- * It automatically:
- * - Creates a ClaudeCodeOutputProcessor
- * - Creates an AgUiEventAdapter with the provided runId
- * - Wires the processor to emit events through the adapter
- *
- * @param runId - Unique identifier for this execution run
- * @param threadId - Optional thread ID (defaults to runId)
- * @returns Complete AG-UI system ready to process output
- *
- * @example
- * ```typescript
- * const { processor, adapter } = createAgUiSystem('run-123');
- *
- * // Wire adapter to transport for SSE streaming
- * transportManager.connectAdapter(adapter, 'run-123');
- *
- * // Process Claude Code output
- * await processor.processLine('{"type":"assistant",...}');
- *
- * // Events automatically flow: processor -> adapter -> transport -> SSE clients
- * ```
- */
-export declare function createAgUiSystem(runId: string, threadId?: string): AgUiSystem;
-/**
- * Manually wire an output processor to an AG-UI adapter
- *
- * Use this when you need more control over processor/adapter creation.
- * This function handles all the event handler registration.
- *
- * @param processor - Output processor to wire
- * @param adapter - AG-UI adapter to receive events
- *
- * @example
- * ```typescript
- * const processor = new ClaudeCodeOutputProcessor();
- * const adapter = new AgUiEventAdapter('run-123');
- *
- * // Manually wire them together
- * wireManually(processor, adapter);
- *
- * // Now processor events will flow to adapter
- * ```
- */
-export declare function wireManually(processor: IOutputProcessor, adapter: AgUiEventAdapter): void;
-/**
- * Create an AG-UI system with custom processor implementation
- *
- * Use this when you have a custom output processor that implements IOutputProcessor.
- * The processor will be wired to a new AgUiEventAdapter.
- *
- * @param processor - Custom output processor implementation
- * @param runId - Unique identifier for this execution run
- * @param threadId - Optional thread ID (defaults to runId)
- * @returns AG-UI system with your custom processor
- *
- * @example
- * ```typescript
- * class CustomProcessor implements IOutputProcessor {
- *   // ... your implementation
- * }
- *
- * const processor = new CustomProcessor();
- * const { processor, adapter } = createAgUiSystemWithProcessor(
- *   processor,
- *   'run-123'
- * );
- * ```
- */
-export declare function createAgUiSystemWithProcessor(processor: IOutputProcessor, runId: string, threadId?: string): AgUiSystem;
-//# sourceMappingURL=ag-ui-integration.d.ts.map

package/dist/execution/output/ag-ui-integration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ag-ui-integration.d.ts","sourceRoot":"","sources":["../../../src/execution/output/ag-ui-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kDAAkD;IAClD,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAQZ;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAKZ"}