proxy-acpx-x 1.0.0

package/README.md

@@ -0,0 +1,231 @@
+# proxy-acpx-x
+
+ACP ↔ Claude Code `stream-json` adapter. Routes OpenClaw/acpx traffic through the **Claude Code CLI**, enabling subscription-based authentication instead of requiring a separate API key.
+
+## Architecture
+
+```
+Before (API key required):
+  OpenClaw → acpx → @zed/claude-agent-acp → Anthropic API (API key)
+
+After (subscription auth via CLI):
+  OpenClaw → acpx → proxy-acpx-x → claude CLI (stream-json) → Anthropic API (subscription OK)
+```
+
+The adapter is a thin NDJSON translator (~300 lines) that sits between acpx and the Claude Code CLI. Both protocols use stdin/stdout NDJSON, so only field-name mapping is needed.
+
+### Protocol Mapping
+
+**Input: ACP → Claude Code CLI stdin** (`--input-format stream-json`)
+
+| ACP (from acpx)                           | Claude Code stream-json stdin                                       |
+| ----------------------------------------- | ------------------------------------------------------------------- |
+| `session/prompt { prompt: [{text:"…"}] }` | `{"type":"user","message":{"role":"user","content":"…"}}`           |
+| `session/cancel`                          | SIGTERM to child process                                            |
+| `session/close`                           | Close stdin + SIGTERM                                               |
+
+**Output: Claude Code CLI stdout → ACP** (`--output-format stream-json`)
+
+| Claude Code stream-json stdout                                                  | ACP (to acpx)                    |
+| ------------------------------------------------------------------------------- | -------------------------------- |
+| `stream_event { event: { type: "content_block_delta", delta: { text } } }`      | `session/update { agent_message_chunk }` |
+| `stream_event { event: { type: "content_block_start", content_block: { type: "tool_use" } } }` | (tracked internally)   |
+| `stream_event { event: { type: "content_block_stop" } }` (after tool_use)      | `session/update { tool_call }`   |
+| `{ type: "result", subtype: "success" }`                                        | prompt response (stopReason: end_turn) |
+| `{ type: "system", subtype: "api_retry" }`                                     | logged to stderr                 |
+
+### CLI Flags Used
+
+```bash
+claude -p \
+  --input-format stream-json \
+  --output-format stream-json \
+  --verbose \
+  --include-partial-messages \
+  --bare \
+  --permission-mode bypassPermissions
+```
+
+| Flag | Purpose |
+| ---- | ------- |
+| `-p` | Non-interactive (print) mode |
+| `--input-format stream-json` | Accept NDJSON messages on stdin |
+| `--output-format stream-json` | Emit NDJSON streaming events on stdout |
+| `--verbose` | Full turn-by-turn output |
+| `--include-partial-messages` | Emit `stream_event` with real-time text/tool deltas |
+| `--bare` | Skip hooks, plugins, MCP, CLAUDE.md for fast startup |
+| `--permission-mode bypassPermissions` | Auto-approve all tools (required for non-interactive ACP) |
+
+Reference: [Claude Code headless docs](https://code.claude.com/docs/en/headless)
+
+## Prerequisites
+
+- **Node.js** >= 18
+- **Claude Code CLI** installed and authenticated (`claude` command in PATH)
+- **OpenClaw** with acpx plugin
+
+## Installation
+
+```bash
+# From npm (once published)
+npm install -g proxy-acpx-x
+
+# Or from source
+git clone https://github.com/clonn/proxy-acpx-x.git
+cd proxy-acpx-x
+npm install
+npm run build
+```
+
+## Setup with OpenClaw / acpx
+
+### Option 1: Register as an acpx agent
+
+```bash
+# If installed globally
+acpx config set agents.claude-native.command "proxy-acpx-x"
+
+# If running from source
+acpx config set agents.claude-native.command "node /path/to/proxy-acpx-x/dist/adapter.js"
+```
+
+Then edit `~/.openclaw/config.json`:
+
+```json
+{
+  "acp": {
+    "enabled": true,
+    "dispatch": { "enabled": true },
+    "backend": "acpx",
+    "defaultAgent": "claude-native"
+  }
+}
+```
+
+### Option 2: Direct execution (testing)
+
+```bash
+# Pipe ACP messages manually
+echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | node dist/adapter.js
+```
+
+## Usage
+
+Once configured, OpenClaw routes requests through the adapter automatically:
+
+**Direct conversation:**
+```
+You: "Refactor this function using Claude Code"
+```
+
+**Manual spawn:**
+```
+/acp spawn claude-native --mode persistent --thread auto
+```
+
+**Common commands:**
+
+| Command            | Description               |
+| ------------------ | ------------------------- |
+| `/acp status`      | Check current session     |
+| `/acp steer <msg>` | Send follow-up instruction|
+| `/acp cancel`      | Cancel current turn       |
+| `/acp close`       | Close session             |
+
+## Development
+
+```bash
+npm install          # Install dependencies
+npm run build        # Compile TypeScript → dist/
+npm run dev          # Run directly with ts-node
+```
+
+## Testing
+
+```bash
+npm test             # Run unit tests (vitest, 24 tests)
+npm run test:watch   # Run tests in watch mode
+npm run test:smoke   # Run E2E smoke tests against built adapter
+```
+
+**Unit tests** (`test/protocol.test.ts`) — test all pure protocol translation functions:
+- ACP ↔ stream-json message building
+- Tool classification, input extraction, summarization
+- CLI argument construction
+
+**Smoke tests** (`test/smoke.sh`) — test the actual adapter process:
+- ACP `initialize` handshake
+- `session/create` with custom session ID
+- Empty prompt returns `end_turn` immediately
+- Unknown method returns JSON-RPC error
+- `session/close` graceful shutdown
+
+### Manual E2E test (with real Claude CLI)
+
+```bash
+# 1. Build
+npm run build
+
+# 2. Start the adapter
+node dist/adapter.js
+
+# 3. In the same terminal, paste these lines one by one:
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}
+{"jsonrpc":"2.0","id":2,"method":"session/prompt","params":{"prompt":[{"type":"text","text":"What is 2+2? Reply with just the number."}]}}
+
+# 4. Watch stdout for ACP responses and stderr for debug logs
+# 5. Ctrl+C to stop
+```
+
+## How It Works
+
+The adapter has 4 parts:
+
+### Part 1: CLI Spawn (~20 lines)
+Starts `claude` as a child process with stream-json I/O flags. Uses `--bare` for fast startup and `--include-partial-messages` for real-time streaming events.
+
+### Part 2: ACP → stream-json (~60 lines)
+Reads NDJSON from stdin (ACP messages from acpx). Translates:
+- `initialize` → spawn Claude CLI, return capabilities
+- `session/prompt` → `{"type":"user","message":{"role":"user","content":"…"}}` to Claude's stdin
+- `session/cancel` → SIGTERM the Claude process
+- `session/close` → graceful stdin close + SIGTERM
+
+### Part 3: stream-json → ACP (~120 lines)
+Reads Claude's stdout stream events and translates:
+- `stream_event` with `content_block_delta` (`text_delta`) → `session/update { agent_message_chunk }`
+- `stream_event` with `content_block_start` (`tool_use`) → track tool name/id
+- `stream_event` with `content_block_delta` (`input_json_delta`) → accumulate tool input
+- `stream_event` with `content_block_stop` → emit `session/update { tool_call }` with complete input
+- `result` → ACP prompt response with stop reason and usage stats
+- `system` (`api_retry`) → logged to stderr
+
+### Part 4: Utilities (~30 lines)
+JSON emitters (`emitAcp`, `emitAcpResponse`, `emitAcpNotification`), prompt text extraction, input summarization, tool classification.
+
+## Permission Handling
+
+This adapter uses **Method A: pre-approved permissions** (`--permission-mode bypassPermissions`). ACP sessions are non-interactive, so all file writes and command executions are auto-approved.
+
+For dynamic permission control (Method B), integrate the [Claude Agent SDK](https://platform.claude.com/docs/en/agent-sdk/overview)'s `permissionHandler` callback — see [concept.md](./concept.md) for details.
+
+## Troubleshooting
+
+**"Failed to spawn claude"** — Ensure `claude` CLI is in your PATH. Run `which claude` to verify.
+
+**No output from Claude** — Check stderr logs (lines prefixed `[proxy-acpx-x]`). The adapter logs all lifecycle events to stderr.
+
+**Permission errors** — The adapter runs with `bypassPermissions`. For finer control, modify the spawn args to use `--allowedTools` instead.
+
+**Slow startup** — The adapter uses `--bare` to skip hooks/plugins/MCP discovery. If you need project context (CLAUDE.md, etc.), remove `--bare` from the spawn args.
+
+## References
+
+- [Claude Code headless mode](https://code.claude.com/docs/en/headless)
+- [Agent SDK streaming output](https://platform.claude.com/docs/en/agent-sdk/streaming-output)
+- [Agent SDK streaming input](https://platform.claude.com/docs/en/agent-sdk/streaming-vs-single-mode)
+- [Claude Code CLI reference](https://code.claude.com/docs/en/cli-reference)
+
+## License
+
+MIT

package/dist/adapter.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * proxy-acpx-x: ACP ↔ Claude Code stream-json adapter
+ *
+ * Translates between ACP protocol (stdin/stdout NDJSON from acpx) and
+ * Claude Code CLI's --input-format stream-json / --output-format stream-json.
+ *
+ * Architecture:
+ *   OpenClaw → acpx → [this adapter] → claude CLI (stream-json) → Anthropic API
+ *                                        (subscription auth OK)
+ */
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -0,0 +1,305 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * proxy-acpx-x: ACP ↔ Claude Code stream-json adapter
+ *
+ * Translates between ACP protocol (stdin/stdout NDJSON from acpx) and
+ * Claude Code CLI's --input-format stream-json / --output-format stream-json.
+ *
+ * Architecture:
+ *   OpenClaw → acpx → [this adapter] → claude CLI (stream-json) → Anthropic API
+ *                                        (subscription auth OK)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const readline_1 = require("readline");
+const protocol_1 = require("./protocol");
+// ─── State ───────────────────────────────────────────────────────────────────
+let claudeProcess = null;
+let currentRequestId = undefined;
+let sessionId = null;
+let accumulatedUsage = { inputTokens: 0, outputTokens: 0 };
+// Tool streaming state
+let currentToolName = null;
+let currentToolId = null;
+let currentToolInput = "";
+// ─── Output helpers ──────────────────────────────────────────────────────────
+function emit(obj) {
+    process.stdout.write(JSON.stringify(obj) + "\n");
+}
+function log(msg) {
+    process.stderr.write(`[proxy-acpx-x] ${msg}\n`);
+}
+// ─── Part 1: Spawn Claude Code CLI ───────────────────────────────────────────
+function spawnClaude() {
+    const args = (0, protocol_1.buildClaudeArgs)();
+    log(`Spawning: claude ${args.join(" ")}`);
+    const proc = (0, child_process_1.spawn)("claude", args, {
+        stdio: ["pipe", "pipe", "pipe"],
+        env: { ...process.env },
+    });
+    proc.on("error", (err) => {
+        log(`Failed to spawn claude: ${err.message}`);
+        if (currentRequestId !== undefined) {
+            emit((0, protocol_1.buildAcpResponse)(currentRequestId, {
+                stopReason: "error",
+                error: `Failed to spawn claude CLI: ${err.message}`,
+            }));
+            currentRequestId = undefined;
+        }
+    });
+    proc.on("exit", (code, signal) => {
+        log(`Claude exited (code=${code}, signal=${signal})`);
+        claudeProcess = null;
+        if (currentRequestId !== undefined) {
+            emit((0, protocol_1.buildAcpResponse)(currentRequestId, {
+                stopReason: "error",
+                error: `Claude process exited unexpectedly (code=${code})`,
+            }));
+            currentRequestId = undefined;
+        }
+    });
+    if (proc.stdout)
+        setupClaudeOutputHandler(proc);
+    if (proc.stderr) {
+        const rl = (0, readline_1.createInterface)({ input: proc.stderr });
+        rl.on("line", (line) => process.stderr.write(`[claude-stderr] ${line}\n`));
+    }
+    return proc;
+}
+// ─── Part 3: Claude Code stream-json output → ACP events ────────────────────
+function setupClaudeOutputHandler(proc) {
+    const rl = (0, readline_1.createInterface)({ input: proc.stdout });
+    rl.on("line", (line) => {
+        if (!line.trim())
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            log(`Failed to parse Claude output: ${line}`);
+            return;
+        }
+        handleClaudeMessage(msg);
+    });
+}
+function handleClaudeMessage(msg) {
+    switch (msg.type) {
+        case "stream_event":
+            handleStreamEvent(msg);
+            break;
+        case "assistant":
+            handleAssistantMessage(msg);
+            break;
+        case "result":
+            handleResultMessage(msg);
+            break;
+        case "system":
+            handleSystemMessage(msg);
+            break;
+        default: log(`Unknown message type: ${msg.type}`);
+    }
+}
+function handleStreamEvent(msg) {
+    const event = msg.event;
+    if (!event)
+        return;
+    switch (event.type) {
+        case "message_start": {
+            if (event.message?.usage) {
+                accumulatedUsage.inputTokens = event.message.usage.input_tokens ?? 0;
+            }
+            break;
+        }
+        case "content_block_start": {
+            const block = event.content_block;
+            if (block?.type === "tool_use") {
+                currentToolName = block.name ?? null;
+                currentToolId = block.id ?? null;
+                currentToolInput = "";
+                log(`Tool starting: ${currentToolName}`);
+            }
+            break;
+        }
+        case "content_block_delta": {
+            const delta = event.delta;
+            if (!delta)
+                break;
+            if (delta.type === "text_delta" && delta.text) {
+                emit((0, protocol_1.buildAgentMessageChunk)(sessionId, delta.text));
+            }
+            else if (delta.type === "input_json_delta" && delta.partial_json) {
+                currentToolInput += delta.partial_json;
+            }
+            break;
+        }
+        case "content_block_stop": {
+            if (currentToolName && currentToolId) {
+                let parsedInput = currentToolInput;
+                try {
+                    parsedInput = JSON.parse(currentToolInput);
+                }
+                catch { /* keep as string */ }
+                emit((0, protocol_1.buildToolCall)(sessionId, currentToolId, currentToolName, parsedInput));
+                log(`Tool call emitted: ${currentToolName}`);
+                currentToolName = null;
+                currentToolId = null;
+                currentToolInput = "";
+            }
+            break;
+        }
+        case "message_delta": {
+            if (event.delta?.stop_reason) {
+                log(`Stop reason: ${event.delta.stop_reason}`);
+            }
+            if (event.usage) {
+                accumulatedUsage.outputTokens += event.usage.output_tokens ?? 0;
+            }
+            break;
+        }
+        case "message_stop":
+            log("Message complete");
+            break;
+        default:
+            log(`Unhandled stream event: ${event.type}`);
+    }
+}
+function handleAssistantMessage(msg) {
+    if (!msg.message?.content)
+        return;
+    for (const block of msg.message.content) {
+        if (block.type === "tool_result") {
+            emit((0, protocol_1.buildToolResult)(sessionId, block.id ?? "", block.text ?? ""));
+        }
+    }
+}
+function handleResultMessage(msg) {
+    log(`Result: subtype=${msg.subtype}`);
+    emit((0, protocol_1.buildPromptResponse)(currentRequestId, msg.subtype === "success" ? "end_turn" : "error", msg.result ?? "", accumulatedUsage));
+    currentRequestId = undefined;
+    accumulatedUsage = { inputTokens: 0, outputTokens: 0 };
+}
+function handleSystemMessage(msg) {
+    if (msg.subtype === "api_retry") {
+        log(`API retry: attempt=${msg.attempt}/${msg.max_retries}, error=${msg.error}`);
+    }
+    else if (msg.subtype === "init") {
+        log(`Claude session initialized: ${msg.session_id}`);
+    }
+    else {
+        log(`System: ${JSON.stringify(msg)}`);
+    }
+}
+// ─── Part 2: ACP input → Claude Code stream-json ────────────────────────────
+function sendToClaude(obj) {
+    if (!claudeProcess?.stdin?.writable) {
+        log("Claude stdin not writable");
+        return;
+    }
+    const line = JSON.stringify(obj) + "\n";
+    log(`→ Claude stdin: ${line.trim().slice(0, 120)}`);
+    claudeProcess.stdin.write(line);
+}
+function handleAcpMessage(raw) {
+    let msg;
+    try {
+        msg = JSON.parse(raw);
+    }
+    catch {
+        log(`Failed to parse ACP input: ${raw}`);
+        return;
+    }
+    const method = msg.method;
+    log(`ACP ← ${method} (id=${msg.id})`);
+    switch (method) {
+        case "initialize": {
+            sessionId = `session-${Date.now()}`;
+            emit((0, protocol_1.buildAcpResponse)(msg.id, {
+                protocolVersion: "2024-11-05",
+                capabilities: { streaming: true, tools: true },
+                serverInfo: { name: "proxy-acpx-x", version: "1.0.0" },
+            }));
+            if (!claudeProcess)
+                claudeProcess = spawnClaude();
+            break;
+        }
+        case "session/create": {
+            sessionId = msg.params?.sessionId ?? `session-${Date.now()}`;
+            emit((0, protocol_1.buildAcpResponse)(msg.id, { sessionId }));
+            break;
+        }
+        case "session/prompt": {
+            currentRequestId = msg.id;
+            accumulatedUsage = { inputTokens: 0, outputTokens: 0 };
+            const prompts = msg.params?.prompt ?? [];
+            const text = (0, protocol_1.extractTextFromPrompt)(prompts);
+            if (!text) {
+                emit((0, protocol_1.buildAcpResponse)(msg.id, {
+                    stopReason: "end_turn",
+                    usage: { inputTokens: 0, outputTokens: 0 },
+                }));
+                break;
+            }
+            log(`Prompt: ${(0, protocol_1.summarizeInput)(text)}`);
+            if (!claudeProcess)
+                claudeProcess = spawnClaude();
+            sendToClaude((0, protocol_1.buildClaudeUserMessage)(text));
+            break;
+        }
+        case "session/cancel": {
+            if (claudeProcess) {
+                claudeProcess.kill("SIGTERM");
+                claudeProcess = null;
+            }
+            emit((0, protocol_1.buildAcpResponse)(msg.id, { cancelled: true }));
+            currentRequestId = undefined;
+            break;
+        }
+        case "session/close": {
+            if (claudeProcess) {
+                claudeProcess.stdin?.end();
+                setTimeout(() => {
+                    if (claudeProcess) {
+                        claudeProcess.kill("SIGTERM");
+                        claudeProcess = null;
+                    }
+                }, 1000);
+            }
+            emit((0, protocol_1.buildAcpResponse)(msg.id, { closed: true }));
+            sessionId = null;
+            currentRequestId = undefined;
+            break;
+        }
+        case "notifications/initialized":
+            break;
+        default: {
+            log(`Unhandled ACP method: ${method}`);
+            emit((0, protocol_1.buildAcpError)(msg.id, -32601, `Method not found: ${method}`));
+        }
+    }
+}
+// ─── Main ────────────────────────────────────────────────────────────────────
+function main() {
+    log("Adapter started, waiting for ACP input...");
+    log("Using Claude Code CLI with stream-json I/O");
+    const rl = (0, readline_1.createInterface)({ input: process.stdin });
+    rl.on("line", (line) => { if (line.trim())
+        handleAcpMessage(line); });
+    rl.on("close", () => {
+        log("stdin closed, shutting down");
+        shutdown();
+    });
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+function shutdown() {
+    log("Shutting down...");
+    if (claudeProcess) {
+        claudeProcess.stdin?.end();
+        claudeProcess.kill("SIGTERM");
+    }
+    process.exit(0);
+}
+main();
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Protocol translation utilities for ACP ↔ Claude Code stream-json.
+ * Pure functions — no side effects, no process I/O.
+ */
+export interface AcpPrompt {
+    type: string;
+    text: string;
+}
+export interface AcpMessage {
+    jsonrpc: string;
+    id?: string | number;
+    method: string;
+    params?: {
+        prompt?: AcpPrompt[];
+        sessionId?: string;
+        [key: string]: unknown;
+    };
+}
+export interface ClaudeStreamEvent {
+    type: string;
+    delta?: {
+        type: string;
+        text?: string;
+        partial_json?: string;
+        stop_reason?: string;
+    };
+    content_block?: {
+        type: string;
+        text?: string;
+        id?: string;
+        name?: string;
+        input?: unknown;
+    };
+    message?: {
+        usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+        };
+    };
+    usage?: {
+        output_tokens?: number;
+    };
+    index?: number;
+}
+export interface ClaudeStreamOutput {
+    type: string;
+    subtype?: string;
+    event?: ClaudeStreamEvent;
+    message?: {
+        content?: Array<{
+            type: string;
+            text?: string;
+            id?: string;
+            name?: string;
+            input?: unknown;
+        }>;
+    };
+    result?: string;
+    session_id?: string;
+    uuid?: string;
+    attempt?: number;
+    max_retries?: number;
+    error?: string;
+    [key: string]: unknown;
+}
+export declare function buildAcpResponse(id: string | number | undefined, result: Record<string, unknown>): Record<string, unknown>;
+export declare function buildAcpNotification(method: string, params: Record<string, unknown>): Record<string, unknown>;
+export declare function buildAcpError(id: string | number | undefined, code: number, message: string): Record<string, unknown>;
+export declare function extractTextFromPrompt(prompts: AcpPrompt[]): string;
+export declare function buildClaudeUserMessage(text: string): Record<string, unknown>;
+export declare function buildAgentMessageChunk(sessionId: string | null, textChunk: string): Record<string, unknown>;
+export declare function buildToolCall(sessionId: string | null, toolCallId: string, toolName: string, input: unknown): Record<string, unknown>;
+export declare function buildToolResult(sessionId: string | null, toolCallId: string, output: string): Record<string, unknown>;
+export declare function buildPromptResponse(id: string | number | undefined, stopReason: string, result: string, usage: {
+    inputTokens: number;
+    outputTokens: number;
+}): Record<string, unknown>;
+export declare function classifyTool(name: string): "read" | "write" | "execute";
+export declare function summarizeInput(text: string): string;
+export declare function parseNdjsonLine(line: string): unknown | null;
+/**
+ * Build the Claude CLI argument list.
+ */
+export declare function buildClaudeArgs(options?: {
+    bare?: boolean;
+    permissionMode?: string;
+    allowedTools?: string[];
+}): string[];
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Protocol translation utilities for ACP ↔ Claude Code stream-json.
+ * Pure functions — no side effects, no process I/O.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAcpResponse = buildAcpResponse;
+exports.buildAcpNotification = buildAcpNotification;
+exports.buildAcpError = buildAcpError;
+exports.extractTextFromPrompt = extractTextFromPrompt;
+exports.buildClaudeUserMessage = buildClaudeUserMessage;
+exports.buildAgentMessageChunk = buildAgentMessageChunk;
+exports.buildToolCall = buildToolCall;
+exports.buildToolResult = buildToolResult;
+exports.buildPromptResponse = buildPromptResponse;
+exports.classifyTool = classifyTool;
+exports.summarizeInput = summarizeInput;
+exports.parseNdjsonLine = parseNdjsonLine;
+exports.buildClaudeArgs = buildClaudeArgs;
+// ─── ACP output builders ─────────────────────────────────────────────────────
+function buildAcpResponse(id, result) {
+    return { jsonrpc: "2.0", id, result };
+}
+function buildAcpNotification(method, params) {
+    return { jsonrpc: "2.0", method, params };
+}
+function buildAcpError(id, code, message) {
+    return { jsonrpc: "2.0", id, error: { code, message } };
+}
+// ─── ACP → Claude Code stream-json ──────────────────────────────────────────
+function extractTextFromPrompt(prompts) {
+    return prompts
+        .filter((p) => p.type === "text")
+        .map((p) => p.text)
+        .join("\n");
+}
+function buildClaudeUserMessage(text) {
+    return {
+        type: "user",
+        message: {
+            role: "user",
+            content: text,
+        },
+    };
+}
+// ─── Claude Code stream-json → ACP ──────────────────────────────────────────
+function buildAgentMessageChunk(sessionId, textChunk) {
+    return buildAcpNotification("session/update", {
+        sessionId,
+        sessionUpdate: {
+            type: "agent_message_chunk",
+            textChunk,
+        },
+    });
+}
+function buildToolCall(sessionId, toolCallId, toolName, input) {
+    return buildAcpNotification("session/update", {
+        sessionId,
+        sessionUpdate: {
+            type: "tool_call",
+            toolCallId,
+            toolName,
+            toolCategory: classifyTool(toolName),
+            input,
+        },
+    });
+}
+function buildToolResult(sessionId, toolCallId, output) {
+    return buildAcpNotification("session/update", {
+        sessionId,
+        sessionUpdate: {
+            type: "tool_result",
+            toolCallId,
+            output,
+        },
+    });
+}
+function buildPromptResponse(id, stopReason, result, usage) {
+    return buildAcpResponse(id, { stopReason, result, usage });
+}
+// ─── Utilities ───────────────────────────────────────────────────────────────
+function classifyTool(name) {
+    const readTools = ["Read", "Glob", "Grep", "WebFetch", "WebSearch"];
+    const writeTools = ["Write", "Edit", "NotebookEdit"];
+    if (writeTools.includes(name))
+        return "write";
+    if (readTools.includes(name))
+        return "read";
+    return "execute";
+}
+function summarizeInput(text) {
+    const firstLine = text.split("\n")[0] ?? "";
+    return firstLine.length > 80 ? firstLine.slice(0, 80) + "..." : firstLine;
+}
+function parseNdjsonLine(line) {
+    if (!line.trim())
+        return null;
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build the Claude CLI argument list.
+ */
+function buildClaudeArgs(options) {
+    const args = [
+        "-p",
+        "--input-format", "stream-json",
+        "--output-format", "stream-json",
+        "--verbose",
+        "--include-partial-messages",
+    ];
+    if (options?.bare !== false) {
+        args.push("--bare");
+    }
+    const mode = options?.permissionMode ?? "bypassPermissions";
+    args.push("--permission-mode", mode);
+    if (options?.allowedTools?.length) {
+        args.push("--allowedTools", ...options.allowedTools);
+    }
+    return args;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "proxy-acpx-x",
+  "version": "1.0.0",
+  "description": "ACP ↔ Claude Code stream-json adapter — use Claude Code CLI subscription auth with OpenClaw/acpx",
+  "main": "dist/adapter.js",
+  "types": "dist/adapter.d.ts",
+  "bin": {
+    "proxy-acpx-x": "dist/adapter.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build && npm test",
+    "start": "node dist/adapter.js",
+    "dev": "ts-node src/adapter.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:smoke": "bash test/smoke.sh"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clonn/proxy-acpx-x.git"
+  },
+  "homepage": "https://github.com/clonn/proxy-acpx-x#readme",
+  "bugs": {
+    "url": "https://github.com/clonn/proxy-acpx-x/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "acp",
+    "acpx",
+    "openclaw",
+    "adapter",
+    "proxy",
+    "stream-json"
+  ],
+  "author": "Caesar Chi",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}