@stdiobus/workers-registry 1.3.7

package/out/dist/workers/mcp-to-acp-proxy/proxy.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../workers-registry/mcp-to-acp-proxy/proxy.js"],
+  "sourcesContent": ["#!/usr/bin/env node\n\n/*\n * Apache License 2.0\n * Copyright (c) 2025\u2013present Raman Marozau, Target Insight Function.\n * Contact: raman@worktif.com\n *\n * This file is part of the stdio bus protocol reference implementation:\n *   stdio_bus_kernel_workers (target: <target_stdio_bus_kernel_workers>).\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * MCP-to-ACP Protocol Proxy\n *\n * Converts MCP protocol (from Kiro) to ACP protocol (for stdio Bus)\n * Runs as MCP server for Kiro, forwards to ACP via TCP\n */\n\nimport net from 'net';\nimport { createInterface } from 'readline';\n\nconst ACP_HOST = process.env.ACP_HOST || '127.0.0.1';\nconst ACP_PORT = process.env.ACP_PORT || 9000;\nconst AGENT_ID = process.env.AGENT_ID || 'default-agent';\n\nconsole.error(`[MCP-APC][proxy] Starting proxy...`);\nconsole.error(`[MCP-APC][proxy] Target: ${ACP_HOST}:${ACP_PORT}`);\nconsole.error(`[MCP-APC][proxy] Agent ID: ${AGENT_ID}`);\n\n// State\nconst acpSocket = net.connect(ACP_PORT, ACP_HOST);\nlet acpConnected = false;\nlet proxySessionId = null; // For stdio Bus routing\nlet acpSessionId = null; // From ACP agent\nlet pendingRequests = new Map(); // id -> {method, params, ...}\nlet accumulatedText = new Map(); // requestId -> accumulated text\n\nacpSocket.on('connect', () => {\n  console.error('[MCP-APC][proxy] Connected to ACP stdio Bus');\n  acpConnected = true;\n});\n\nacpSocket.on('error', (err) => {\n  console.error(`[MCP-APC][proxy] ACP connection error: ${err.message}`);\n  process.exit(1);\n});\n\n// Handle ACP messages\nlet acpBuffer = '';\nacpSocket.on('data', (data) => {\n  acpBuffer += data.toString();\n\n  let newlineIndex;\n  while ((newlineIndex = acpBuffer.indexOf('\\n')) !== -1) {\n    const line = acpBuffer.slice(0, newlineIndex);\n    acpBuffer = acpBuffer.slice(newlineIndex + 1);\n\n    if (line.trim()) {\n      try {\n        const acpMsg = JSON.parse(line);\n        console.error(`[MCP-APC][proxy] \u2190 ACP: ${JSON.stringify(acpMsg)}`);\n\n        // Check if notification or response\n        if (acpMsg.id === undefined || acpMsg.id === null) {\n          // Notification\n          console.error(`[MCP-APC][proxy] Processing notification: ${acpMsg.method}`);\n          handleACPNotification(acpMsg);\n        } else {\n          // Response\n          console.error(`[MCP-APC][proxy] Processing response id=${acpMsg.id}`);\n          console.error(`[MCP-APC][proxy] Pending: ${JSON.stringify([...pendingRequests.keys()])}`);\n          const mcpResponse = convertACPtoMCP(acpMsg);\n          if (mcpResponse) {\n            console.error(`[MCP-APC][proxy] \u2192 MCP: ${JSON.stringify(mcpResponse)}`);\n            process.stdout.write(JSON.stringify(mcpResponse) + '\\n');\n          } else {\n            console.error(`[MCP-APC][proxy] WARNING: No MCP response for id=${acpMsg.id}`);\n          }\n        }\n      } catch (err) {\n        console.error(`[MCP-APC][proxy] Error parsing ACP: ${err.message}`);\n      }\n    }\n  }\n});\n\n// Handle MCP requests\nconst rl = createInterface({\n  input: process.stdin,\n  terminal: false\n});\n\nrl.on('line', (line) => {\n  if (!line.trim()) return;\n\n  try {\n    const mcpReq = JSON.parse(line);\n    console.error(`[MCP-APC][proxy] \u2190 MCP: ${JSON.stringify(mcpReq)}`);\n\n    const acpReq = convertMCPtoACP(mcpReq);\n    if (acpReq) {\n      console.error(`[MCP-APC][proxy] \u2192 ACP: ${JSON.stringify(acpReq)}`);\n      if (acpConnected) {\n        acpSocket.write(JSON.stringify(acpReq) + '\\n');\n      }\n    }\n  } catch (err) {\n    console.error(`[MCP-APC][proxy] Error parsing MCP: ${err.message}`);\n  }\n});\n\nfunction handleACPNotification(msg) {\n  const { method, params } = msg;\n\n  if (method === 'session/update' && params?.update) {\n    const update = params.update;\n\n    // Find pending session/prompt request\n    for (const [reqId, pending] of pendingRequests.entries()) {\n      if (pending.method === 'session/prompt') {\n        if (update.sessionUpdate === 'agent_message_chunk' && update.content?.text) {\n          if (!accumulatedText.has(reqId)) {\n            accumulatedText.set(reqId, '');\n          }\n          accumulatedText.set(reqId, accumulatedText.get(reqId) + update.content.text);\n        }\n        break;\n      }\n    }\n  }\n}\n\nfunction convertMCPtoACP(mcpReq) {\n  const { id, method, params } = mcpReq;\n\n  if (id === undefined || id === null) {\n    return null; // Ignore notifications\n  }\n\n  pendingRequests.set(id, { method, params });\n\n  if (!proxySessionId) {\n    proxySessionId = `proxy-${Date.now()}`;\n  }\n\n  switch (method) {\n    case 'initialize':\n      return {\n        jsonrpc: '2.0',\n        id,\n        method: 'initialize',\n        agentId: AGENT_ID,\n        sessionId: proxySessionId,\n        params: {\n          protocolVersion: 1,\n          clientCapabilities: params?.capabilities || {},\n          clientInfo: params?.clientInfo || { name: 'mcp-proxy', version: '1.0.0' }\n        }\n      };\n\n    case 'tools/list':\n      sendMCP({\n        jsonrpc: '2.0',\n        id,\n        result: {\n          tools: [{\n            name: 'acp_prompt',\n            description: `Send prompt to ${AGENT_ID}`,\n            inputSchema: {\n              type: 'object',\n              properties: {\n                prompt: { type: 'string', description: 'Prompt text' }\n              },\n              required: ['prompt']\n            }\n          }]\n        }\n      });\n      pendingRequests.delete(id);\n      return null;\n\n    case 'tools/call':\n      const promptText = params?.arguments?.prompt || '';\n\n      if (!acpSessionId) {\n        // Need to create session first\n        const sessionReqId = `sess-${id}`;\n        pendingRequests.set(sessionReqId, {\n          method: 'session/new',\n          originalId: id,\n          promptText\n        });\n        return {\n          jsonrpc: '2.0',\n          id: sessionReqId,\n          method: 'session/new',\n          agentId: AGENT_ID,\n          sessionId: proxySessionId,\n          params: { cwd: process.cwd(), mcpServers: [] }\n        };\n      }\n\n      // Session exists, send prompt\n      // IMPORTANT: Update pending to session/prompt since that's what we're sending\n      pendingRequests.set(id, { method: 'session/prompt', params });\n      return {\n        jsonrpc: '2.0',\n        id,\n        method: 'session/prompt',\n        agentId: AGENT_ID,\n        sessionId: proxySessionId,\n        params: {\n          sessionId: acpSessionId,\n          prompt: [{ type: 'text', text: promptText }]\n        }\n      };\n\n    case 'resources/list':\n      sendMCP({ jsonrpc: '2.0', id, result: { resources: [] } });\n      pendingRequests.delete(id);\n      return null;\n\n    case 'resources/templates/list':\n      sendMCP({ jsonrpc: '2.0', id, result: { resourceTemplates: [] } });\n      pendingRequests.delete(id);\n      return null;\n\n    case 'prompts/list':\n      sendMCP({ jsonrpc: '2.0', id, result: { prompts: [] } });\n      pendingRequests.delete(id);\n      return null;\n\n    default:\n      sendMCP({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown method: ${method}` } });\n      pendingRequests.delete(id);\n      return null;\n  }\n}\n\nfunction convertACPtoMCP(acpResp) {\n  const { id, result, error } = acpResp;\n\n  const pending = pendingRequests.get(id);\n  if (!pending) {\n    console.error(`[MCP-APC][proxy] ERROR: No pending request for id=${id}`);\n    return null;\n  }\n\n  console.error(`[MCP-APC][proxy] Converting ACP->MCP for method: ${pending.method}`);\n  pendingRequests.delete(id);\n\n  if (error) {\n    accumulatedText.delete(id);\n    return {\n      jsonrpc: '2.0',\n      id,\n      error: { code: error.code || -32603, message: error.message || 'ACP error' }\n    };\n  }\n\n  switch (pending.method) {\n    case 'initialize':\n      return {\n        jsonrpc: '2.0',\n        id,\n        result: {\n          protocolVersion: '2024-11-05',\n          capabilities: { tools: {}, resources: {} },\n          serverInfo: result?.agentInfo || { name: 'acp-agent', version: '1.0.0' }\n        }\n      };\n\n    case 'session/new':\n      acpSessionId = result?.sessionId;\n      console.error(`[MCP-APC][proxy] ACP session: ${acpSessionId}`);\n\n      if (pending.originalId && pending.promptText) {\n        // Send queued prompt\n        const promptReq = {\n          jsonrpc: '2.0',\n          id: pending.originalId,\n          method: 'session/prompt',\n          agentId: AGENT_ID,\n          sessionId: proxySessionId,\n          params: {\n            sessionId: acpSessionId,\n            prompt: [{ type: 'text', text: pending.promptText }]\n          }\n        };\n\n        pendingRequests.set(pending.originalId, { method: 'session/prompt' });\n\n        console.error(`[MCP-APC][proxy] \u2192 ACP: ${JSON.stringify(promptReq)}`);\n        if (acpConnected) {\n          acpSocket.write(JSON.stringify(promptReq) + '\\n');\n        }\n      }\n      return null;\n\n    case 'session/prompt':\n      const text = accumulatedText.get(id) || '';\n      accumulatedText.delete(id);\n      console.error(`[MCP-APC][proxy] Returning accumulated text (${text.length} chars): \"${text.substring(0, 50)}...\"`);\n      return {\n        jsonrpc: '2.0',\n        id,\n        result: {\n          content: [{ type: 'text', text: text || 'No response' }]\n        }\n      };\n\n    default:\n      console.error(`[MCP-APC][proxy] WARNING: Unhandled method ${pending.method}, returning raw result`);\n      return { jsonrpc: '2.0', id, result: result || {} };\n  }\n}\n\nfunction sendMCP(msg) {\n  console.error(`[MCP-APC][proxy] \u2192 MCP: ${JSON.stringify(msg)}`);\n  process.stdout.write(JSON.stringify(msg) + '\\n');\n}\n\nprocess.on('SIGTERM', () => {\n  acpSocket.end();\n  process.exit(0);\n});\n\nprocess.on('SIGINT', () => {\n  acpSocket.end();\n  process.exit(0);\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/out/tsc/workers/acp-worker/src/acp/client-capabilities.d.ts

@@ -0,0 +1,131 @@
+/**
+ * ACP Client Capabilities
+ *
+ * Provides utilities for accessing client capabilities like file system
+ * and terminal operations via the ACP SDK.
+ *
+ * @module acp/client-capabilities
+ */
+import type { AgentSideConnection, ClientCapabilities, TerminalHandle } from '@agentclientprotocol/sdk';
+/**
+ * Result of a file read operation.
+ */
+export interface FileReadResult {
+    /** The file content */
+    content: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Error message if the operation failed */
+    error?: string;
+}
+/**
+ * Result of a file write operation.
+ */
+export interface FileWriteResult {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Error message if the operation failed */
+    error?: string;
+}
+/**
+ * Result of a terminal command execution.
+ */
+export interface TerminalResult {
+    /** The terminal output */
+    output: string;
+    /** The exit code (null if terminated by signal) */
+    exitCode: number | null;
+    /** The signal that terminated the process (null if exited normally) */
+    signal: string | null;
+    /** Whether the output was truncated */
+    truncated: boolean;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Error message if the operation failed */
+    error?: string;
+}
+/**
+ * Check if the client supports file system read operations.
+ *
+ * @param capabilities - The client capabilities
+ * @returns Whether file read is supported
+ */
+export declare function canReadFile(capabilities: ClientCapabilities | null): boolean;
+/**
+ * Check if the client supports file system write operations.
+ *
+ * @param capabilities - The client capabilities
+ * @returns Whether file write is supported
+ */
+export declare function canWriteFile(capabilities: ClientCapabilities | null): boolean;
+/**
+ * Check if the client supports terminal operations.
+ *
+ * @param capabilities - The client capabilities
+ * @returns Whether terminal is supported
+ */
+export declare function canUseTerminal(capabilities: ClientCapabilities | null): boolean;
+/**
+ * Read a text file from the client's file system.
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param path - Absolute path to the file
+ * @param options - Optional read options (line, limit)
+ * @returns The file read result
+ */
+export declare function readFile(connection: AgentSideConnection, sessionId: string, path: string, options?: {
+    line?: number;
+    limit?: number;
+}): Promise<FileReadResult>;
+/**
+ * Write content to a text file in the client's file system.
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param path - Absolute path to the file
+ * @param content - The content to write
+ * @returns The file write result
+ */
+export declare function writeFile(connection: AgentSideConnection, sessionId: string, path: string, content: string): Promise<FileWriteResult>;
+/**
+ * Execute a command in a terminal and wait for completion.
+ * - Use SDK terminal methods (create, output, wait, kill, release)
+ * - Track terminal IDs for cleanup
+ * - Implement command timeouts
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param command - The command to execute
+ * @param options - Optional execution options
+ * @returns The terminal execution result
+ */
+export declare function executeCommand(connection: AgentSideConnection, sessionId: string, command: string, options?: {
+    args?: string[];
+    cwd?: string;
+    env?: Array<{
+        name: string;
+        value: string;
+    }>;
+    timeout?: number;
+    outputByteLimit?: number;
+}): Promise<TerminalResult>;
+/**
+ * Execute a command in a terminal without waiting for completion.
+ * Returns a handle for managing the terminal.
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param command - The command to execute
+ * @param options - Optional execution options
+ * @returns The terminal handle for managing the process
+ */
+export declare function startCommand(connection: AgentSideConnection, sessionId: string, command: string, options?: {
+    args?: string[];
+    cwd?: string;
+    env?: Array<{
+        name: string;
+        value: string;
+    }>;
+    outputByteLimit?: number;
+}): Promise<TerminalHandle>;

package/out/tsc/workers/acp-worker/src/acp/content-mapper.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Content Mapper
+ *
+ * Maps MCP tool call results to ACP ToolCallContent format.
+ * Handles conversion between MCP content types (TextContent, ImageContent, EmbeddedResource)
+ * and ACP ToolCallContent types (Content, Diff, Terminal).
+ *
+ * Also provides resource_link resolution for ACP prompts.
+ *
+ * @module acp/content-mapper
+ */
+import type { ContentBlock, ToolCallContent } from '@agentclientprotocol/sdk';
+import type { MCPContent, MCPResourceContents } from '../mcp/types.js';
+/**
+ * Maps a single MCP content item to an ACP ContentBlock.
+ *
+ * MCP content types:
+ * - TextContent: { type: 'text', text: string }
+ * - ImageContent: { type: 'image', data: string, mimeType: string }
+ * - EmbeddedResource: { type: 'resource', resource: { uri, mimeType?, text?, blob? } }
+ *
+ * ACP ContentBlock types:
+ * - TextContent: { type: 'text', text: string }
+ * - ImageContent: { type: 'image', data: string, mimeType: string }
+ * - EmbeddedResource: { type: 'resource', resource: TextResourceContents | BlobResourceContents }
+ *
+ * @param mcpContent - The MCP content item to convert
+ * @returns The corresponding ACP ContentBlock
+ */
+export declare function mapMCPContentToACPContentBlock(mcpContent: MCPContent): ContentBlock;
+/**
+ * Maps an array of MCP content items to ACP ToolCallContent array.
+ *
+ * Each MCP content item is wrapped in an ACP Content structure with type: 'content'.
+ *
+ * @param mcpContents - Array of MCP content items
+ * @returns Array of ACP ToolCallContent items
+ */
+export declare function mapMCPResultToACPToolCallContent(mcpContents: MCPContent[]): ToolCallContent[];
+/**
+ * Creates an error ToolCallContent from an error message.
+ *
+ * Used when MCP tool execution fails (isError: true) to create
+ * appropriate error content for the ACP client.
+ *
+ * @param errorMessage - The error message to display
+ * @returns A ToolCallContent array with the error message
+ */
+export declare function createErrorToolCallContent(errorMessage: string): ToolCallContent[];
+/**
+ * Maps MCP tool call result to ACP ToolCallContent array.
+ *
+ * Handles both successful results and error results.
+ * For errors, creates appropriate error content.
+ *
+ * @param content - Array of MCP content items from tool result
+ * @param isError - Whether the tool execution resulted in an error
+ * @returns Array of ACP ToolCallContent items
+ */
+export declare function mapToolResultToACPContent(content: MCPContent[], isError?: boolean): ToolCallContent[];
+/**
+ * Represents a resource_link from an ACP ContentBlock.
+ */
+export interface ResourceLink {
+    type: 'resource_link';
+    uri: string;
+    name: string;
+    title?: string;
+    description?: string;
+    mimeType?: string;
+    size?: number;
+}
+/**
+ * Type guard to check if a ContentBlock is a resource_link.
+ *
+ * @param block - The content block to check
+ * @returns True if the block is a resource_link
+ */
+export declare function isResourceLink(block: ContentBlock): block is ResourceLink;
+/**
+ * Maps MCP resource contents to an ACP EmbeddedResource ContentBlock.
+ *
+ * Converts the result of readResource() to an ACP-compatible format.
+ *
+ * @param contents - The MCP resource contents from readResource()
+ * @returns The ACP embedded resource content block
+ */
+export declare function mapMCPResourceContentsToACPContentBlock(contents: MCPResourceContents): ContentBlock;
+/**
+ * Extracts the URI from a resource_link ContentBlock.
+ *
+ * @param block - The resource_link content block
+ * @returns The URI string or null if not a valid resource_link
+ */
+export declare function extractResourceLinkUri(block: ContentBlock): string | null;

package/out/tsc/workers/acp-worker/src/acp/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ACP Module
+ *
+ * Exports ACP-related utilities and mappers.
+ *
+ * @module acp
+ */
+export { mapMCPContentToACPContentBlock, mapMCPResultToACPToolCallContent, createErrorToolCallContent, mapToolResultToACPContent, isResourceLink, extractResourceLinkUri, mapMCPResourceContentsToACPContentBlock, } from './content-mapper.js';
+export { generateToolCallId, determineToolKind, sendToolCallInitiation, sendToolCallUpdate, requestToolPermission, executeToolCall, executeToolCallWithPermission, } from './tools.js';
+export { canReadFile, canWriteFile, canUseTerminal, readFile, writeFile, executeCommand, startCommand, } from './client-capabilities.js';
+export type { ToolKind, ToolCallStatus, PermissionResult } from './tools.js';
+export type { ResourceLink } from './content-mapper.js';
+export type { FileReadResult, FileWriteResult, TerminalResult } from './client-capabilities.js';

package/out/tsc/workers/acp-worker/src/acp/tools.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Tool Call Utilities
+ *
+ * Provides utilities for initiating and managing tool calls in ACP.
+ * Handles tool call lifecycle including initiation, permission requests,
+ * execution, and result reporting.
+ *
+ * @module acp/tools
+ */
+import type { AgentSideConnection, PermissionOption, ToolCallContent } from '@agentclientprotocol/sdk';
+import type { MCPManager } from '../mcp/manager.js';
+/**
+ * Permission request result.
+ */
+export interface PermissionResult {
+    /** Whether permission was granted */
+    granted: boolean;
+    /** The option ID that was selected (if granted) */
+    optionId?: string;
+    /** Whether the request was cancelled */
+    cancelled?: boolean;
+}
+/**
+ * Tool kind categories for ACP tool calls.
+ * Helps clients choose appropriate icons and UI treatment.
+ */
+export type ToolKind = 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'switch_mode' | 'other';
+/**
+ * Tool call status values.
+ */
+export type ToolCallStatus = 'pending' | 'in_progress' | 'completed' | 'failed';
+/**
+ * Generate a unique tool call ID.
+ *
+ * @returns A unique tool call ID string
+ */
+export declare function generateToolCallId(): string;
+/**
+ * Determine the tool kind based on tool name and description.
+ *
+ * @param toolName - The name of the tool
+ * @param description - Optional tool description
+ * @returns The appropriate ToolKind
+ */
+export declare function determineToolKind(toolName: string, description?: string): ToolKind;
+/**
+ * Send a tool_call session update to initiate a tool call.
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param toolCallId - The unique tool call ID
+ * @param title - Human-readable title for the tool call
+ * @param kind - The tool kind category
+ * @param status - Initial status (usually 'pending')
+ */
+export declare function sendToolCallInitiation(connection: AgentSideConnection, sessionId: string, toolCallId: string, title: string, kind?: ToolKind, status?: ToolCallStatus): Promise<void>;
+/**
+ * Send a tool_call_update to report progress or results.
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param toolCallId - The tool call ID to update
+ * @param status - The new status
+ * @param content - Optional content to include
+ * @param title - Optional updated title
+ */
+export declare function sendToolCallUpdate(connection: AgentSideConnection, sessionId: string, toolCallId: string, status: ToolCallStatus, content?: ToolCallContent[], title?: string): Promise<void>;
+/**
+ * Request permission from the user before executing a tool.
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param toolCallId - The tool call ID
+ * @param title - Human-readable title for the tool call
+ * @param kind - The tool kind category
+ * @param options - Permission options to present to the user
+ * @returns The permission result with granted/cancelled status
+ */
+export declare function requestToolPermission(connection: AgentSideConnection, sessionId: string, toolCallId: string, title: string, kind?: ToolKind, options?: PermissionOption[]): Promise<PermissionResult>;
+/**
+ * Execute a tool call with full lifecycle management.
+ *
+ * This function handles the complete tool call flow:
+ * 1. Sends tool_call initiation with pending status
+ * 2. Updates to in_progress when execution starts
+ * 3. Executes the tool via MCP
+ * 4. Updates with completed/failed status and results
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param mcpManager - The MCP manager for tool execution
+ * @param toolName - The name of the tool to execute
+ * @param args - Arguments to pass to the tool
+ * @param description - Optional tool description for kind detection
+ * @returns The tool call result content
+ */
+export declare function executeToolCall(connection: AgentSideConnection, sessionId: string, mcpManager: MCPManager, toolName: string, args: Record<string, unknown>, description?: string): Promise<ToolCallContent[]>;
+/**
+ * Execute a tool call with permission request.
+ *
+ * This function handles the complete tool call flow with permission:
+ * 1. Sends tool_call initiation with pending status
+ * 2. Requests permission from the user
+ * 3. If granted, executes the tool via MCP
+ * 4. Updates with completed/failed status and results
+ *
+ * @param connection - The ACP connection
+ * @param sessionId - The session ID
+ * @param mcpManager - The MCP manager for tool execution
+ * @param toolName - The name of the tool to execute
+ * @param args - Arguments to pass to the tool
+ * @param description - Optional tool description for kind detection
+ * @param requirePermission - Whether to request permission before execution
+ * @returns The tool call result content and permission result
+ */
+export declare function executeToolCallWithPermission(connection: AgentSideConnection, sessionId: string, mcpManager: MCPManager, toolName: string, args: Record<string, unknown>, description?: string, requirePermission?: boolean): Promise<{
+    content: ToolCallContent[];
+    permissionResult?: PermissionResult;
+}>;

package/out/tsc/workers/acp-worker/src/agent.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Agent Implementation
+ *
+ * This module implements the ACP Agent interface using @agentclientprotocol/sdk.
+ * The Agent handles all ACP protocol methods including initialization,
+ * session management, and prompt processing.
+ *
+ * @module agent
+ */
+import type { Agent, AgentSideConnection, AuthenticateRequest, AuthenticateResponse, CancelNotification, ClientCapabilities, InitializeRequest, InitializeResponse, LoadSessionRequest, LoadSessionResponse, NewSessionRequest, NewSessionResponse, PromptRequest, PromptResponse } from '@agentclientprotocol/sdk';
+import { SessionManager } from './session/manager.js';
+/**
+ * ACP Agent implementation for stdio Bus kernel worker.
+ *
+ * This class implements the Agent interface from the ACP SDK,
+ * handling all protocol methods and coordinating with MCP servers
+ * for tool execution.
+ */
+export declare class ACPAgent implements Agent {
+    /**
+     * Reference to the AgentSideConnection for sending notifications.
+     * Used by prompt processing to send session updates.
+     */
+    private readonly _connection;
+    /**
+     * Session manager for handling session lifecycle.
+     * Manages session creation, lookup, cancellation, and cleanup.
+     */
+    private readonly _sessionManager;
+    /**
+     * Client capabilities received during initialization.
+     * Used to determine what features the client supports.
+     */
+    private _clientCapabilities;
+    /**
+     * Creates a new ACP Agent instance.
+     *
+     * @param connection - The AgentSideConnection for communicating with the client
+     */
+    constructor(connection: AgentSideConnection);
+    /**
+     * Get the connection for sending notifications.
+     * Used by prompt processing to send session updates.
+     */
+    get connection(): AgentSideConnection;
+    /**
+     * Get the session manager for session operations.
+     */
+    get sessionManager(): SessionManager;
+    /**
+     * Get the client capabilities received during initialization.
+     * Returns null if initialize() has not been called yet.
+     */
+    get clientCapabilities(): ClientCapabilities | null;
+    /**
+     * Handle ACP initialize request.
+     * Returns agent capabilities and info.
+     *
+     * Stores client capabilities for later use and returns InitializeResponse
+     * with agent info and capabilities including promptCapabilities.embeddedContext: true.
+     *
+     * @param params - The initialization request parameters
+     * @returns Promise resolving to InitializeResponse with agent capabilities
+     */
+    initialize(params: InitializeRequest): Promise<InitializeResponse>;
+    /**
+     * Handle ACP session/new request.
+     * Creates a new session with MCP server connections.
+     *
+     * Generates a unique sessionId using crypto.randomUUID(), stores session state,
+     * initializes MCP connections from the request params, and returns NewSessionResponse.
+     *
+     * @param params - The new session request parameters containing cwd and optional mcpServers
+     * @returns Promise resolving to NewSessionResponse with session ID
+     */
+    newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
+    /**
+     * Handle ACP session/load request.
+     * Loads an existing session (optional capability).
+     *
+     * @param params - The load session request parameters
+     * @returns Promise resolving to LoadSessionResponse
+     */
+    loadSession(_params: LoadSessionRequest): Promise<LoadSessionResponse>;
+    /**
+     * Handle ACP authenticate request.
+     * Processes authentication (if required).
+     *
+     * @param params - The authentication request parameters
+     * @returns Promise resolving to AuthenticateResponse or void
+     */
+    authenticate(_params: AuthenticateRequest): Promise<AuthenticateResponse | void>;
+    /**
+     * Handle ACP session/prompt request.
+     * Processes user prompts and streams responses.
+     *
+     * Currently implements echo mode for testing - echoes user prompt as agent response.
+     *
+     * @param params - The prompt request parameters
+     * @returns Promise resolving to PromptResponse with stop reason
+     */
+    prompt(params: PromptRequest): Promise<PromptResponse>;
+    /**
+     * Handle ACP session/cancel notification.
+     * Cancels ongoing operations for a session.
+     *
+     * Looks up the session by sessionId and calls session.cancel() to set
+     * the cancellation flag and abort pending MCP operations.
+     *
+     * @param params - The cancel notification parameters containing sessionId
+     */
+    cancel(params: CancelNotification): Promise<void>;
+}

package/out/tsc/workers/acp-worker/src/index.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers/acp-worker/src/mcp/connection.d.ts

@@ -0,0 +1,54 @@
+/**
+ * MCP Connection
+ *
+ * Represents a single connection to an MCP server.
+ * Uses @modelcontextprotocol/sdk for protocol handling.
+ *
+ * @module mcp/connection
+ */
+import type { MCPResource, MCPServerConfig, MCPTool } from './types.js';
+/**
+ * Represents a connection to a single MCP server.
+ */
+export declare class MCPConnection {
+    private _config;
+    private connected;
+    constructor(config: MCPServerConfig);
+    /**
+     * Get the server configuration.
+     */
+    get config(): MCPServerConfig;
+    /**
+     * Establish connection to the MCP server.
+     */
+    connect(): Promise<void>;
+    /**
+     * Check if the connection is active.
+     */
+    isConnected(): boolean;
+    /**
+     * Get tools available from this server.
+     */
+    listTools(): Promise<MCPTool[]>;
+    /**
+     * Invoke a tool on this server.
+     */
+    callTool(_name: string, _args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get resources available from this server.
+     */
+    listResources(): Promise<MCPResource[]>;
+    /**
+     * Read a resource from this server.
+     */
+    readResource(_uri: string): Promise<unknown>;
+    /**
+     * Close the connection to the MCP server.
+     */
+    close(): Promise<void>;
+    /**
+     * Abort all pending operations on this connection.
+     * Called when a session is cancelled to stop in-flight requests.
+     */
+    abortPendingOperations(): void;
+}

package/out/tsc/workers/acp-worker/src/mcp/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Client Management
+ *
+ * This module provides MCP client functionality using @modelcontextprotocol/sdk.
+ * It handles connections to MCP servers, tool discovery, and tool invocation.
+ *
+ * @module mcp
+ */
+export { MCPManager, type MCPConnection } from './manager.js';
+export type { MCPServerConfig, MCPTool, MCPResource } from './types.js';