amp-acp 0.3.7 → 0.4.1

package/README.md

@@ -52,6 +52,81 @@ That's it! The SDK handles authentication and Amp integration automatically.
 - Renders Amp messages and interactions natively in Zed
 - Tool permissions are handled by Amp (no additional configuration needed)
 - Supports conversation continuity across multiple prompts
+- **MCP servers configured in Zed are automatically passed through to Amp**
+
+## MCP Configuration Passthrough
+
+The adapter supports passing [MCP (Model Context Protocol)](https://modelcontextprotocol.io) servers configured in Zed through to Amp. This allows you to use the same MCP tools in both Zed's native AI and Amp.
+
+This implementation is compatible with how other ACP agents like [Claude Code](https://github.com/zed-industries/claude-code-acp) and [Codex](https://github.com/zed-industries/codex-acp) handle MCP servers. See [Zed's MCP documentation](https://zed.dev/docs/ai/mcp) for more details.
+
+### Supported MCP Server Types
+
+| Type | Description | Example |
+|------|-------------|---------|
+| **stdio** | Local command-line MCP servers | `@playwright/mcp`, `@modelcontextprotocol/server-filesystem` |
+| **HTTP** | Remote HTTP MCP servers | `https://mcp.exa.ai/mcp`, `https://mcp.semgrep.ai/mcp` |
+| **SSE** | Remote Server-Sent Events MCP servers | `https://mcp.monday.com/sse` |
+
+### Example: Using Exa Search with Amp
+
+[Exa](https://exa.ai) provides a powerful web search MCP server. Add both the agent server and context servers to your Zed `settings.json`:
+
+```json
+{
+  "agent_servers": {
+    "Amp": {
+      "command": "npx",
+      "args": ["-y", "amp-acp"]
+    }
+  },
+  "context_servers": {
+    "exa": {
+      "url": "https://mcp.exa.ai/mcp"
+    }
+  }
+}
+```
+
+### Example: Multiple MCP Servers
+
+You can configure multiple MCP servers to extend Amp's capabilities:
+
+```json
+{
+  "agent_servers": {
+    "Amp": {
+      "command": "npx",
+      "args": ["-y", "amp-acp"]
+    }
+  },
+  "context_servers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest", "--headless"]
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
+      }
+    }
+  }
+}
+```
+
+### How MCP Passthrough Works
+
+1. When you configure `context_servers` in Zed's `settings.json`, Zed passes them to the ACP agent via the `mcpServers` parameter in the `session/new` request
+2. The amp-acp adapter converts the MCP server configurations from ACP format to Amp SDK format
+3. Amp connects to the MCP servers and makes their tools available during the session
+
+For more details, see [docs/mcp-passthrough.md](docs/mcp-passthrough.md).
 
 ## Troubleshooting
 
@@ -60,3 +135,6 @@ That's it! The SDK handles authentication and Amp integration automatically.
 **Connection issues**: Restart Zed and try again. The adapter creates a fresh connection each time.
 
 **Tool execution problems**: Check Zed's output panel for detailed error messages from the Amp SDK.
+
+**MCP server not connecting**: Ensure the MCP server command is correct and any required environment variables are set. Check Zed's logs for connection errors.
+

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/{src → dist}/index.js

@@ -1,13 +1,9 @@
 #!/usr/bin/env node
-// stdout is reserved for ACP stream. Redirect logs to stderr.
 console.log = console.error;
 console.info = console.error;
 console.warn = console.error;
 console.debug = console.error;
-
 import { runAcp } from './run-acp.js';
-
 runAcp();
-
-// Keep process alive
-process.stdin.resume();
+process.stdin.resume();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC;AAC5B,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;AAC7B,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;AAC7B,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;AAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,EAAE,CAAC;AAET,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC"}

package/dist/mcp-config.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from '@agentclientprotocol/sdk';
+interface AmpMcpServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+}
+export type AmpMcpConfig = Record<string, AmpMcpServerConfig>;
+export declare function convertAcpMcpServersToAmpConfig(mcpServers: McpServer[] | undefined | null): AmpMcpConfig;
+export {};
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,UAAU,kBAAkB;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAE9D,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,GAAG,YAAY,CA6BxG"}

package/dist/mcp-config.js

@@ -0,0 +1,30 @@
+export function convertAcpMcpServersToAmpConfig(mcpServers) {
+    const mcpConfig = {};
+    if (!Array.isArray(mcpServers)) {
+        return mcpConfig;
+    }
+    for (const server of mcpServers) {
+        if ('type' in server && (server.type === 'http' || server.type === 'sse')) {
+            const headers = {};
+            for (const h of server.headers) {
+                headers[h.name] = h.value;
+            }
+            mcpConfig[server.name] = {
+                url: server.url,
+                headers: Object.keys(headers).length > 0 ? headers : undefined,
+            };
+        }
+        else {
+            const env = server.env.length > 0
+                ? Object.fromEntries(server.env.map((e) => [e.name, e.value]))
+                : undefined;
+            mcpConfig[server.name] = {
+                command: server.command,
+                args: server.args,
+                env,
+            };
+        }
+    }
+    return mcpConfig;
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,+BAA+B,CAAC,UAA0C;IACxF,MAAM,SAAS,GAAiB,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,MAAM,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAC1E,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC/B,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAC5B,CAAC;YACD,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;gBACvB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;aAC/D,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;gBAC/B,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC9D,CAAC,CAAC,SAAS,CAAC;YACd,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,GAAG;aACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/run-acp.d.ts

@@ -0,0 +1,2 @@
+export declare function runAcp(): void;
+//# sourceMappingURL=run-acp.d.ts.map

package/dist/run-acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-acp.d.ts","sourceRoot":"","sources":["../src/run-acp.ts"],"names":[],"mappings":"AAIA,wBAAgB,MAAM,IAAI,IAAI,CAQ7B"}

package/dist/run-acp.js

@@ -0,0 +1,10 @@
+import { AgentSideConnection, ndJsonStream } from '@agentclientprotocol/sdk';
+import { nodeToWebWritable, nodeToWebReadable } from './utils.js';
+import { AmpAcpAgent } from './server.js';
+export function runAcp() {
+    const input = nodeToWebWritable(process.stdout);
+    const output = nodeToWebReadable(process.stdin);
+    const stream = ndJsonStream(input, output);
+    new AgentSideConnection((client) => new AmpAcpAgent(client), stream);
+}
+//# sourceMappingURL=run-acp.js.map

package/dist/run-acp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-acp.js","sourceRoot":"","sources":["../src/run-acp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,MAAM;IACpB,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,YAAY,CACzB,KAA8C,EAC9C,MAA+C,CAChD,CAAC;IACF,IAAI,mBAAmB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,28 @@
+import { type AgentSideConnection, type Agent, type InitializeRequest, type InitializeResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type AuthenticateRequest, type AuthenticateResponse, type CancelNotification, type SetSessionModeRequest, type SetSessionModeResponse, type SetSessionModelRequest, type SetSessionModelResponse, type ReadTextFileRequest, type ReadTextFileResponse, type WriteTextFileRequest, type WriteTextFileResponse } from '@agentclientprotocol/sdk';
+import { type AmpMcpConfig } from './mcp-config.js';
+interface SessionState {
+    threadId: string | null;
+    controller: AbortController | null;
+    cancelled: boolean;
+    active: boolean;
+    mode: string;
+    mcpConfig: AmpMcpConfig;
+    cwd: string;
+}
+export declare class AmpAcpAgent implements Agent {
+    private client;
+    sessions: Map<string, SessionState>;
+    private clientCapabilities?;
+    constructor(client: AgentSideConnection);
+    initialize(request: InitializeRequest): Promise<InitializeResponse>;
+    newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
+    authenticate(_params: AuthenticateRequest): Promise<AuthenticateResponse>;
+    prompt(params: PromptRequest): Promise<PromptResponse>;
+    cancel(params: CancelNotification): Promise<void>;
+    setSessionModel(_params: SetSessionModelRequest): Promise<SetSessionModelResponse>;
+    setSessionMode(params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
+    readTextFile(params: ReadTextFileRequest): Promise<ReadTextFileResponse>;
+    writeTextFile(params: WriteTextFileRequest): Promise<WriteTextFileResponse>;
+}
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAE3B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGrF,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,MAAM,CAAsB;IACpC,QAAQ,4BAAmC;IAC3C,OAAO,CAAC,kBAAkB,CAAC,CAAqB;gBAEpC,MAAM,EAAE,mBAAmB;IAIjC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYnE,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgDlE,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIzE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA+FtD,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAElF,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAO9E,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IACxE,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAClF"}

package/dist/server.js

@@ -0,0 +1,178 @@
+import { RequestError, } from '@agentclientprotocol/sdk';
+import { execute } from '@sourcegraph/amp-sdk';
+import { convertAcpMcpServersToAmpConfig } from './mcp-config.js';
+import { toAcpNotifications } from './to-acp.js';
+export class AmpAcpAgent {
+    client;
+    sessions = new Map();
+    clientCapabilities;
+    constructor(client) {
+        this.client = client;
+    }
+    async initialize(request) {
+        this.clientCapabilities = request.clientCapabilities;
+        return {
+            protocolVersion: 1,
+            agentCapabilities: {
+                promptCapabilities: { image: true, embeddedContext: true },
+                mcpCapabilities: { http: true, sse: true },
+            },
+            authMethods: [],
+        };
+    }
+    async newSession(params) {
+        const sessionId = `S-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+        const mcpConfig = convertAcpMcpServersToAmpConfig(params.mcpServers);
+        this.sessions.set(sessionId, {
+            threadId: null,
+            controller: null,
+            cancelled: false,
+            active: false,
+            mode: 'default',
+            mcpConfig,
+            cwd: params.cwd || process.cwd(),
+        });
+        const result = {
+            sessionId,
+            modes: {
+                currentModeId: 'default',
+                availableModes: [
+                    { id: 'default', name: 'Default', description: 'Prompts for permission on first use of each tool' },
+                    { id: 'bypass', name: 'Bypass', description: 'Skips all permission prompts' },
+                ],
+            },
+        };
+        setImmediate(async () => {
+            try {
+                await this.client.sessionUpdate({
+                    sessionId,
+                    update: {
+                        sessionUpdate: 'available_commands_update',
+                        availableCommands: [
+                            {
+                                name: 'init',
+                                description: 'Generate an AGENTS.md file for the project',
+                            },
+                        ],
+                    },
+                });
+            }
+            catch (e) {
+                console.error('[acp] failed to send available_commands_update', e);
+            }
+        });
+        return result;
+    }
+    async authenticate(_params) {
+        throw RequestError.authRequired();
+    }
+    async prompt(params) {
+        const s = this.sessions.get(params.sessionId);
+        if (!s)
+            throw new Error('Session not found');
+        s.cancelled = false;
+        s.active = true;
+        let textInput = '';
+        for (const chunk of params.prompt) {
+            switch (chunk.type) {
+                case 'text':
+                    if (chunk.text.trim() === '/init') {
+                        textInput += `Please analyze this codebase and create an AGENTS.md file containing:
+1. Build/lint/test commands - especially for running a single test
+2. Architecture and codebase structure information, including important subprojects, internal APIs, databases, etc.
+3. Code style guidelines, including imports, conventions, formatting, types, naming conventions, error handling, etc.
+
+The file you create will be given to agentic coding tools (such as yourself) that operate in this repository. Make it about 20 lines long.
+
+If there are Cursor rules (in .cursor/rules/ or .cursorrules), Claude rules (CLAUDE.md), Windsurf rules (.windsurfrules), Cline rules (.clinerules), Goose rules (.goosehints), or Copilot rules (in .github/copilot-instructions.md), make sure to include them. Also, first check if there is an existing AGENTS.md or AGENT.md file, and if so, update it instead of overwriting it.`;
+                    }
+                    else {
+                        textInput += chunk.text;
+                    }
+                    break;
+                case 'resource_link':
+                    textInput += `\n${chunk.uri}\n`;
+                    break;
+                case 'resource':
+                    if ('text' in chunk.resource) {
+                        textInput += `\n<context ref="${chunk.resource.uri}">\n${chunk.resource.text}\n</context>\n`;
+                    }
+                    break;
+                case 'image':
+                    break;
+                default:
+                    break;
+            }
+        }
+        const options = {
+            cwd: s.cwd,
+        };
+        if (s.mode === 'bypass') {
+            options.dangerouslyAllowAll = true;
+        }
+        if (Object.keys(s.mcpConfig).length > 0) {
+            options.mcpConfig = s.mcpConfig;
+        }
+        if (s.threadId) {
+            options.continue = s.threadId;
+        }
+        const controller = new AbortController();
+        s.controller = controller;
+        try {
+            for await (const message of execute({ prompt: textInput, options, signal: controller.signal })) {
+                if (!s.threadId && message.session_id) {
+                    s.threadId = message.session_id;
+                }
+                if (message.type === 'assistant') {
+                    for (const n of toAcpNotifications(message, params.sessionId)) {
+                        try {
+                            await this.client.sessionUpdate(n);
+                        }
+                        catch (e) {
+                            console.error('[acp] sessionUpdate failed', e);
+                        }
+                    }
+                }
+                if (message.type === 'result' && message.is_error) {
+                    await this.client.sessionUpdate({
+                        sessionId: params.sessionId,
+                        update: { sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: `Error: ${message.error}` } },
+                    });
+                }
+            }
+            return { stopReason: s.cancelled ? 'cancelled' : 'end_turn' };
+        }
+        catch (err) {
+            if (s.cancelled || (err instanceof Error && (err.name === 'AbortError' || err.message.includes('aborted')))) {
+                return { stopReason: 'cancelled' };
+            }
+            console.error('[amp] Execution error:', err);
+            throw err;
+        }
+        finally {
+            s.active = false;
+            s.cancelled = false;
+            s.controller = null;
+        }
+    }
+    async cancel(params) {
+        const s = this.sessions.get(params.sessionId);
+        if (!s)
+            return;
+        if (s.active && s.controller) {
+            s.cancelled = true;
+            s.controller.abort();
+        }
+    }
+    async setSessionModel(_params) { return {}; }
+    async setSessionMode(params) {
+        const s = this.sessions.get(params.sessionId);
+        if (!s)
+            throw new Error('Session not found');
+        s.mode = params.modeId;
+        return {};
+    }
+    async readTextFile(params) { return this.client.readTextFile(params); }
+    async writeTextFile(params) { return this.client.writeTextFile(params); }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/to-acp.d.ts

@@ -0,0 +1,41 @@
+import type { SessionNotification } from '@agentclientprotocol/sdk';
+interface AmpContentText {
+    type: 'text';
+    text: string;
+}
+interface AmpContentImage {
+    type: 'image';
+    source?: {
+        type: 'base64' | 'url';
+        data?: string;
+        media_type?: string;
+        url?: string;
+    };
+}
+interface AmpContentThinking {
+    type: 'thinking';
+    thinking: string;
+}
+interface AmpContentToolUse {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: unknown;
+}
+interface AmpContentToolResult {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | AmpContentText[];
+    is_error: boolean;
+}
+type AmpContentBlock = AmpContentText | AmpContentImage | AmpContentThinking | AmpContentToolUse | AmpContentToolResult;
+interface AmpMessage {
+    type: string;
+    message?: {
+        content: string | AmpContentBlock[];
+    };
+    session_id?: string;
+}
+export declare function toAcpNotifications(message: AmpMessage, sessionId: string): SessionNotification[];
+export {};
+//# sourceMappingURL=to-acp.d.ts.map

package/dist/to-acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-acp.d.ts","sourceRoot":"","sources":["../src/to-acp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAiC,MAAM,0BAA0B,CAAC;AAEnG,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,KAAK,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAExH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;KACrC,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAkEhG"}

package/dist/to-acp.js

@@ -0,0 +1,93 @@
+export function toAcpNotifications(message, sessionId) {
+    const content = message.message?.content;
+    if (typeof content === 'string') {
+        return [
+            {
+                sessionId,
+                update: {
+                    sessionUpdate: message.type === 'assistant' ? 'agent_message_chunk' : 'user_message_chunk',
+                    content: { type: 'text', text: content },
+                },
+            },
+        ];
+    }
+    const output = [];
+    if (!Array.isArray(content))
+        return output;
+    for (const chunk of content) {
+        let update = null;
+        switch (chunk.type) {
+            case 'text':
+                update = {
+                    sessionUpdate: message.type === 'assistant' ? 'agent_message_chunk' : 'user_message_chunk',
+                    content: { type: 'text', text: chunk.text },
+                };
+                break;
+            case 'image':
+                update = {
+                    sessionUpdate: message.type === 'assistant' ? 'agent_message_chunk' : 'user_message_chunk',
+                    content: {
+                        type: 'image',
+                        data: chunk.source?.type === 'base64' ? (chunk.source.data ?? '') : '',
+                        mimeType: chunk.source?.type === 'base64' ? (chunk.source.media_type ?? '') : '',
+                        uri: chunk.source?.type === 'url' ? chunk.source.url : undefined,
+                    },
+                };
+                break;
+            case 'thinking':
+                update = {
+                    sessionUpdate: 'agent_thought_chunk',
+                    content: { type: 'text', text: chunk.thinking },
+                };
+                break;
+            case 'tool_use':
+                update = {
+                    toolCallId: chunk.id,
+                    sessionUpdate: 'tool_call',
+                    rawInput: safeJson(chunk.input),
+                    status: 'pending',
+                    title: chunk.name || 'Tool',
+                    kind: 'other',
+                    content: [],
+                };
+                break;
+            case 'tool_result':
+                update = {
+                    toolCallId: chunk.tool_use_id,
+                    sessionUpdate: 'tool_call_update',
+                    status: chunk.is_error ? 'failed' : 'completed',
+                    content: toAcpContentArray(chunk.content, chunk.is_error),
+                };
+                break;
+            default:
+                break;
+        }
+        if (update)
+            output.push({ sessionId, update });
+    }
+    return output;
+}
+function toAcpContentArray(content, isError = false) {
+    if (Array.isArray(content) && content.length > 0) {
+        return content.map((c) => ({
+            type: 'content',
+            content: { type: 'text', text: isError ? wrapCode(c.text) : c.text },
+        }));
+    }
+    if (typeof content === 'string' && content.length > 0) {
+        return [{ type: 'content', content: { type: 'text', text: isError ? wrapCode(content) : content } }];
+    }
+    return [];
+}
+function wrapCode(t) {
+    return '```\n' + t + '\n```';
+}
+function safeJson(x) {
+    try {
+        return JSON.parse(JSON.stringify(x));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=to-acp.js.map

package/dist/to-acp.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+import { WritableStream, ReadableStream } from 'node:stream/web';
+import type { Writable, Readable } from 'node:stream';
+export declare function nodeToWebWritable(nodeStream: Writable): WritableStream<Uint8Array>;
+export declare function nodeToWebReadable(nodeStream: Readable): ReadableStream<Uint8Array>;
+export declare function unreachable(x: never): never;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAUlF;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAQlF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAE3C"}

package/dist/utils.js

@@ -0,0 +1,28 @@
+import { WritableStream, ReadableStream } from 'node:stream/web';
+export function nodeToWebWritable(nodeStream) {
+    return new WritableStream({
+        write(chunk) {
+            return new Promise((resolve, reject) => {
+                nodeStream.write(Buffer.from(chunk), (err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+    });
+}
+export function nodeToWebReadable(nodeStream) {
+    return new ReadableStream({
+        start(controller) {
+            nodeStream.on('data', (chunk) => controller.enqueue(new Uint8Array(chunk)));
+            nodeStream.on('end', () => controller.close());
+            nodeStream.on('error', (err) => controller.error(err));
+        },
+    });
+}
+export function unreachable(x) {
+    throw new Error(`unreachable: ${JSON.stringify(x)}`);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjE,MAAM,UAAU,iBAAiB,CAAC,UAAoB;IACpD,OAAO,IAAI,cAAc,CAAC;QACxB,KAAK,CAAC,KAAiB;YACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;oBAC3C,IAAI,GAAG;wBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;wBAAM,OAAO,EAAE,CAAC;gBACvC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAoB;IACpD,OAAO,IAAI,cAAc,CAAC;QACxB,KAAK,CAAC,UAAU;YACd,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACpF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAQ;IAClC,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "amp-acp",
-  "version": "0.3.7",
+  "version": "0.4.1",
   "private": false,
   "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
-    "amp-acp": "src/index.js"
+    "amp-acp": "dist/index.js"
   },
+  "files": [
+    "dist"
+  ],
   "description": "ACP adapter that bridges Amp Code to Agent Client Protocol (Zed external agent)",
   "license": "Apache-2.0",
   "repository": {
@@ -13,13 +18,18 @@
     "url": "https://github.com/tao12345666333/amp-acp"
   },
   "scripts": {
-    "start": "node src/index.js",
-    "lint": "echo 'no lint'",
-    "test": "node -e 'console.log(\"OK\")'"
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "tsc --noEmit",
+    "test": "tsc -p tsconfig.test.json --outDir dist-test && node --test dist-test/mcp-config.test.js dist-test/mcp-integration.test.js"
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "0.4.8",
     "@sourcegraph/amp": "^0.0.1765685598-g5365e6",
     "@sourcegraph/amp-sdk": "^0.1.0-20251214200908-g3251f72"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.1",
+    "typescript": "^5.9.3"
   }
-}
+}

package/AGENTS.md

@@ -1,22 +0,0 @@
-# AGENTS.md
-
-## Commands
-- `npm start` or `node src/index.js` — Run the ACP adapter
-- `npm run lint` — Lint (currently a no-op)
-- `npm test` — Test (currently a no-op)
-
-## Architecture
-This is an ACP (Agent Client Protocol) adapter that bridges Amp Code to ACP-compatible clients like Zed.
-
-- `src/index.js` — Entry point, redirects console to stderr (stdout reserved for ACP stream)
-- `src/run-acp.js` — Sets up ACP connection using stdin/stdout JSON streams
-- `src/server.js` — `AmpAcpAgent` class: handles sessions, prompts, MCP config, and calls `@sourcegraph/amp-sdk`
-- `src/to-acp.js` — Converts Amp stream events to ACP `sessionUpdate` notifications
-- `src/utils.js` — Node-to-Web stream converters
-
-## Code Style
-- ES modules (`"type": "module"` in package.json), use `.js` extension in imports
-- No TypeScript; plain JavaScript with JSDoc if needed
-- Use `console.error` for logging (stdout is for ACP protocol only)
-- Error handling: throw `RequestError` from `@agentclientprotocol/sdk` for protocol errors
-- Naming: camelCase for variables/functions, PascalCase for classes

package/src/run-acp.js

@@ -1,10 +0,0 @@
-import { AgentSideConnection, ndJsonStream } from '@agentclientprotocol/sdk';
-import { nodeToWebReadable, nodeToWebWritable } from './utils.js';
-import { AmpAcpAgent } from './server.js';
-
-export function runAcp() {
-  const input = nodeToWebWritable(process.stdout);
-  const output = nodeToWebReadable(process.stdin);
-  const stream = ndJsonStream(input, output);
-  new AgentSideConnection((client) => new AmpAcpAgent(client), stream);
-}

package/src/server.js

@@ -1,208 +0,0 @@
-import { RequestError } from '@agentclientprotocol/sdk';
-import { execute } from '@sourcegraph/amp-sdk';
-import { toAcpNotifications } from './to-acp.js';
-
-export class AmpAcpAgent {
-  constructor(client) {
-    this.client = client;
-    this.sessions = new Map();
-  }
-
-  async initialize(request) {
-    this.clientCapabilities = request.clientCapabilities;
-    return {
-      protocolVersion: 1,
-      agentCapabilities: {
-        promptCapabilities: { image: true, embeddedContext: true },
-        mcpCapabilities: { http: true, sse: true },
-      },
-      authMethods: [],
-    };
-  }
-
-  async newSession(params) {
-    const sessionId = `S-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-
-    // Convert ACP mcpServers to Amp SDK mcpConfig format
-    const mcpConfig = {};
-    if (Array.isArray(params.mcpServers)) {
-      for (const server of params.mcpServers) {
-        if ('type' in server && (server.type === 'http' || server.type === 'sse')) {
-          // HTTP/SSE type - Amp SDK may not support this directly
-          // Skip for now or handle if SDK supports it
-        } else {
-          // stdio type
-          mcpConfig[server.name] = {
-            command: server.command,
-            args: server.args,
-            env: server.env ? Object.fromEntries(server.env.map((e) => [e.name, e.value])) : undefined,
-          };
-        }
-      }
-    }
-
-    this.sessions.set(sessionId, {
-      threadId: null,
-      controller: null,
-      cancelled: false,
-      active: false,
-      mode: 'default',
-      mcpConfig,
-    });
-
-    const result = {
-      sessionId,
-      modes: {
-        currentModeId: 'default',
-        availableModes: [
-          { id: 'default', name: 'Default', description: 'Prompts for permission on first use of each tool' },
-          { id: 'bypass', name: 'Bypass', description: 'Skips all permission prompts' },
-        ],
-      },
-    };
-
-    setImmediate(async () => {
-      try {
-        await this.client.sessionUpdate({
-          sessionId,
-          update: {
-            sessionUpdate: 'available_commands_update',
-            availableCommands: [
-              {
-                name: 'init',
-                description: 'Generate an AGENTS.md file for the project',
-              },
-            ],
-          },
-        });
-      } catch (e) {
-        console.error('[acp] failed to send available_commands_update', e);
-      }
-    });
-
-    return result;
-  }
-
-  async authenticate(_params) {
-    throw RequestError.authRequired();
-  }
-
-  async prompt(params) {
-    const s = this.sessions.get(params.sessionId);
-    if (!s) throw new Error('Session not found');
-    s.cancelled = false;
-    s.active = true;
-
-    // Build plain-text input for Amp from ACP prompt chunks
-    let textInput = '';
-    for (const chunk of params.prompt) {
-      switch (chunk.type) {
-        case 'text':
-          if (chunk.text.trim() === '/init') {
-            textInput += `Please analyze this codebase and create an AGENTS.md file containing:
-1. Build/lint/test commands - especially for running a single test
-2. Architecture and codebase structure information, including important subprojects, internal APIs, databases, etc.
-3. Code style guidelines, including imports, conventions, formatting, types, naming conventions, error handling, etc.
-
-The file you create will be given to agentic coding tools (such as yourself) that operate in this repository. Make it about 20 lines long.
-
-If there are Cursor rules (in .cursor/rules/ or .cursorrules), Claude rules (CLAUDE.md), Windsurf rules (.windsurfrules), Cline rules (.clinerules), Goose rules (.goosehints), or Copilot rules (in .github/copilot-instructions.md), make sure to include them. Also, first check if there is an existing AGENTS.md or AGENT.md file, and if so, update it instead of overwriting it.`;
-          } else {
-            textInput += chunk.text;
-          }
-          break;
-        case 'resource_link':
-          textInput += `\n${chunk.uri}\n`;
-          break;
-        case 'resource':
-          if ('text' in chunk.resource) {
-            textInput += `\n<context ref="${chunk.resource.uri}">\n${chunk.resource.text}\n</context>\n`;
-          }
-          break;
-        case 'image':
-          // Images not supported by Amp SDK yet via simple prompt string; ignore for now
-          break;
-        default:
-          break;
-      }
-    }
-
-    const options = {
-      cwd: params.cwd || process.cwd(),
-    };
-
-    if (s.mode === 'bypass') {
-      options.dangerouslyAllowAll = true;
-    }
-
-    if (Object.keys(s.mcpConfig).length > 0) {
-      options.mcpConfig = s.mcpConfig;
-    }
-
-    if (s.threadId) {
-      options.continue = s.threadId;
-    }
-
-    const controller = new AbortController();
-    s.controller = controller;
-
-    try {
-      for await (const message of execute({ prompt: textInput, options, signal: controller.signal })) {
-        if (!s.threadId && message.session_id) {
-          s.threadId = message.session_id;
-        }
-
-        if (message.type === 'assistant') {
-          for (const n of toAcpNotifications(message, params.sessionId)) {
-            try {
-              await this.client.sessionUpdate(n);
-            } catch (e) {
-              console.error('[acp] sessionUpdate failed', e);
-            }
-          }
-        }
-
-        if (message.type === 'result' && message.is_error) {
-          await this.client.sessionUpdate({
-            sessionId: params.sessionId,
-            update: { sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: `Error: ${message.error}` } },
-          });
-        }
-      }
-
-      return { stopReason: s.cancelled ? 'cancelled' : 'end_turn' };
-    } catch (err) {
-      if (s.cancelled || (err.name === 'AbortError') || err.message.includes('aborted')) {
-        return { stopReason: 'cancelled' };
-      }
-      console.error('[amp] Execution error:', err);
-      throw err;
-    } finally {
-      s.active = false;
-      s.cancelled = false;
-      s.controller = null;
-    }
-  }
-
-  async cancel(params) {
-    const s = this.sessions.get(params.sessionId);
-    if (!s) return {};
-    if (s.active && s.controller) {
-      s.cancelled = true;
-      s.controller.abort();
-    }
-    return {};
-  }
-
-  async setSessionModel(_params) { return {}; }
-
-  async setSessionMode(params) {
-    const s = this.sessions.get(params.sessionId);
-    if (!s) throw new Error('Session not found');
-    s.mode = params.modeId;
-    return {};
-  }
-
-  async readTextFile(params) { return this.client.readTextFile(params); }
-  async writeTextFile(params) { return this.client.writeTextFile(params); }
-}

package/src/to-acp.js

@@ -1,91 +0,0 @@
-// Minimal conversion from Amp stream JSON events (Claude Code compatible)
-// into ACP sessionUpdate notifications. Based on zed-industries/claude-code-acp.
-
-export function toAcpNotifications(message, sessionId) {
-  const content = message.message?.content;
-  if (typeof content === 'string') {
-    return [
-      {
-        sessionId,
-        update: {
-          sessionUpdate: message.type === 'assistant' ? 'agent_message_chunk' : 'user_message_chunk',
-          content: { type: 'text', text: content },
-        },
-      },
-    ];
-  }
-  const output = [];
-  if (!Array.isArray(content)) return output;
-  for (const chunk of content) {
-    let update = null;
-    switch (chunk.type) {
-      case 'text':
-        update = {
-          sessionUpdate: message.type === 'assistant' ? 'agent_message_chunk' : 'user_message_chunk',
-          content: { type: 'text', text: chunk.text },
-        };
-        break;
-      case 'image':
-        update = {
-          sessionUpdate: message.type === 'assistant' ? 'agent_message_chunk' : 'user_message_chunk',
-          content: {
-            type: 'image',
-            data: chunk.source?.type === 'base64' ? chunk.source.data : '',
-            mimeType: chunk.source?.type === 'base64' ? chunk.source.media_type : '',
-            uri: chunk.source?.type === 'url' ? chunk.source.url : undefined,
-          },
-        };
-        break;
-      case 'thinking':
-        update = {
-          sessionUpdate: 'agent_thought_chunk',
-          content: { type: 'text', text: chunk.thinking },
-        };
-        break;
-      case 'tool_use':
-        update = {
-          toolCallId: chunk.id,
-          sessionUpdate: 'tool_call',
-          rawInput: safeJson(chunk.input),
-          status: 'pending',
-          title: chunk.name || 'Tool',
-          kind: 'other',
-          content: [],
-        };
-        break;
-      case 'tool_result':
-        update = {
-          toolCallId: chunk.tool_use_id,
-          sessionUpdate: 'tool_call_update',
-          status: chunk.is_error ? 'failed' : 'completed',
-          content: toAcpContentArray(chunk.content, chunk.is_error),
-        };
-        break;
-      default:
-        break;
-    }
-    if (update) output.push({ sessionId, update });
-  }
-  return output;
-}
-
-function toAcpContentArray(content, isError = false) {
-  if (Array.isArray(content) && content.length > 0) {
-    return content.map((c) => ({
-      type: 'content',
-      content: c.type === 'text' ? { type: 'text', text: isError ? wrapCode(c.text) : c.text } : c,
-    }));
-  }
-  if (typeof content === 'string' && content.length > 0) {
-    return [{ type: 'content', content: { type: 'text', text: isError ? wrapCode(content) : content } }];
-  }
-  return [];
-}
-
-function wrapCode(t) {
-  return '```\n' + t + '\n```';
-}
-
-function safeJson(x) {
-  try { return JSON.parse(JSON.stringify(x)); } catch { return undefined; }
-}

package/src/utils.js

@@ -1,27 +0,0 @@
-import { WritableStream, ReadableStream } from 'node:stream/web';
-
-export function nodeToWebWritable(nodeStream) {
-  return new WritableStream({
-    write(chunk) {
-      return new Promise((resolve, reject) => {
-        nodeStream.write(Buffer.from(chunk), (err) => {
-          if (err) reject(err); else resolve();
-        });
-      });
-    },
-  });
-}
-
-export function nodeToWebReadable(nodeStream) {
-  return new ReadableStream({
-    start(controller) {
-      nodeStream.on('data', (chunk) => controller.enqueue(new Uint8Array(chunk)));
-      nodeStream.on('end', () => controller.close());
-      nodeStream.on('error', (err) => controller.error(err));
-    },
-  });
-}
-
-export function unreachable(x) {
-  throw new Error(`unreachable: ${JSON.stringify(x)}`);
-}