@wrongstack/acp 0.10.2 → 0.24.0

package/dist/client.js

@@ -0,0 +1,315 @@
+import { buildChildEnv } from '@wrongstack/core';
+import { spawn } from 'child_process';
+
+// src/agent/stdio-transport.ts
+var ClientTransport = class {
+  child = null;
+  buffer = "";
+  handlers = /* @__PURE__ */ new Set();
+  closed = false;
+  resolveRead = null;
+  messageQueue = [];
+  opts;
+  constructor(options) {
+    this.opts = {
+      handshakeTimeoutMs: 3e4,
+      ...options
+    };
+  }
+  async start() {
+    if (this.child) return;
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(
+          new Error(`ACP child process failed to start within ${this.opts.handshakeTimeoutMs}ms`)
+        );
+      }, this.opts.handshakeTimeoutMs);
+      try {
+        this.child = spawn(this.opts.command, this.opts.args ?? [], {
+          env: { ...buildChildEnv(), ...this.opts.env },
+          cwd: this.opts.cwd,
+          stdio: ["pipe", "pipe", "pipe"]
+        });
+      } catch (err) {
+        clearTimeout(timeout);
+        reject(err);
+        return;
+      }
+      const child = this.child;
+      child.stdout.setEncoding("utf8");
+      const waitForMarker = (chunk) => {
+        this.buffer += chunk;
+        const idx = this.buffer.indexOf("[wstack-acp]\n");
+        if (idx !== -1) {
+          this.buffer = this.buffer.slice(idx + "[wstack-acp]\n".length);
+          child.stdout.removeListener("data", waitForMarker);
+          child.stdout.on("data", (c) => this.onChildData(c));
+          child.stderr.on("data", (c) => this.onChildError(c));
+          child.on("close", (code) => this.onChildClose(code));
+          clearTimeout(timeout);
+          resolve();
+        }
+      };
+      child.stdout.on("data", waitForMarker);
+      child.stdout.on("error", (err) => {
+        clearTimeout(timeout);
+        reject(err);
+      });
+      child.on("error", (err) => {
+        clearTimeout(timeout);
+        reject(err);
+      });
+    });
+  }
+  send(msg) {
+    if (!this.child) return Promise.reject(new Error("ClientTransport not started"));
+    return new Promise((resolve, reject) => {
+      const line = JSON.stringify(msg) + "\n";
+      this.child.stdin.write(line, "utf8", (err) => {
+        if (err) reject(err);
+        else resolve();
+      });
+    });
+  }
+  read() {
+    if (this.messageQueue.length > 0) return Promise.resolve(this.messageQueue.shift());
+    if (this.closed) return Promise.resolve(null);
+    return new Promise((resolve) => {
+      this.resolveRead = resolve;
+    });
+  }
+  onMessage(handler) {
+    this.handlers.add(handler);
+    return () => this.handlers.delete(handler);
+  }
+  stop() {
+    if (!this.child) return;
+    this.closed = true;
+    try {
+      this.child.kill();
+    } catch {
+    }
+    this.child = null;
+  }
+  onChildData(chunk) {
+    this.buffer += chunk;
+    const lines = this.buffer.split("\n");
+    this.buffer = lines.pop() ?? "";
+    for (const raw of lines) {
+      if (!raw.trim()) continue;
+      try {
+        this.dispatch(JSON.parse(raw));
+      } catch {
+      }
+    }
+  }
+  onChildError(chunk) {
+    process.stderr.write(`[acp-child stderr] ${chunk}`, "utf8");
+  }
+  onChildClose(code) {
+    this.closed = true;
+    this.resolveRead?.(null);
+    this.resolveRead = null;
+    if (code !== 0 && code !== null) {
+      process.stderr.write(`[acp-child exited with code ${code}]
+`, "utf8");
+    }
+  }
+  dispatch(msg) {
+    if (this.resolveRead) {
+      const resolve = this.resolveRead;
+      this.resolveRead = null;
+      resolve(msg);
+    } else {
+      this.messageQueue.push(msg);
+    }
+    for (const handler of this.handlers) {
+      try {
+        handler(msg);
+      } catch {
+      }
+    }
+  }
+};
+
+// src/client/tool-translator.ts
+var DEFAULT_OPTIONS = {
+  asyncTools: true,
+  pollIntervalMs: 500,
+  totalTimeoutMs: 12e4
+};
+function extractTextFromContent(blocks) {
+  const parts = [];
+  for (const b of blocks) {
+    if (b.type === "text") parts.push(b.text);
+    else if (b.type === "resource") parts.push(`[resource: ${b.resource.uri}]`);
+    else if (b.type === "image") parts.push(`[image: ${b.data.slice(0, 20)}...]`);
+    else if (b.type === "progress") {
+      if (b.messages?.length) parts.push(b.messages.join("\n"));
+    }
+  }
+  return parts.join("\n");
+}
+function parseToolResponse(taskId, subagentId, response) {
+  const blocks = response.result.content;
+  const text = extractTextFromContent(blocks);
+  const isError = response.result.isError || text.toLowerCase().includes("error") || text.toLowerCase().includes("failed");
+  return {
+    taskId,
+    subagentId,
+    status: isError ? "failed" : "success",
+    result: text,
+    iterations: 1,
+    toolCalls: 1,
+    durationMs: 0
+  };
+}
+var ToolTranslator = class {
+  opts;
+  pending = /* @__PURE__ */ new Map();
+  constructor(opts = {}) {
+    this.opts = { ...DEFAULT_OPTIONS, ...opts };
+  }
+  /**
+   * Start listening to a transport for tool responses and cancellations.
+   * Call this once after constructing the translator and before sending tasks.
+   */
+  attachToTransport(transport) {
+    transport.onMessage((msg) => {
+      if (msg.method === "tools/call" && msg.id !== void 0) {
+        const pending = this.pending.get(msg.id);
+        if (pending) {
+          clearTimeout(pending.timeout);
+          this.pending.delete(msg.id);
+          pending.resolve(msg);
+        }
+      }
+      if (msg.method === "cancel" && msg.id !== void 0) {
+        const pending = this.pending.get(msg.id);
+        if (pending) {
+          clearTimeout(pending.timeout);
+          this.pending.delete(msg.id);
+          pending.reject(new Error("Call cancelled by client"));
+        }
+      }
+    });
+  }
+  /**
+   * Send a tool call over the transport and wait for a response.
+   * If asyncTools is true, polls for progress and resolves when the final
+   * response arrives.
+   */
+  async callTool(transport, name, args, callId = crypto.randomUUID()) {
+    await transport.send({
+      method: "tools/call",
+      id: callId,
+      params: { name, arguments: args }
+    });
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.pending.delete(callId);
+        reject(new Error(`Tool call ${name} timed out after ${this.opts.totalTimeoutMs}ms`));
+      }, this.opts.totalTimeoutMs);
+      this.pending.set(callId, { resolve, reject, timeout });
+    });
+  }
+  cancelAll() {
+    for (const [, p] of this.pending) {
+      clearTimeout(p.timeout);
+    }
+    this.pending.clear();
+  }
+};
+
+// src/integration/acp-subagent-runner.ts
+async function makeACPSubagentRunner(options) {
+  const transport = new ClientTransport({
+    command: options.command,
+    args: options.args,
+    env: options.env,
+    cwd: options.cwd,
+    handshakeTimeoutMs: 3e4
+  });
+  const translator = new ToolTranslator(options.toolTranslatorOpts);
+  const activeAbort = new AbortController();
+  let sessionStarted = false;
+  const startSession = async () => {
+    if (sessionStarted) return;
+    await transport.start();
+    await transport.send({
+      method: "initialize",
+      id: "1",
+      params: {
+        capabilities: ["code-generation", "async-tools", "streaming", "progress"],
+        protocolVersion: "2024-11",
+        sessionId: options.role ?? "wrongstack-subagent"
+      }
+    });
+    const initResp = await transport.read();
+    if (!initResp || initResp.error) {
+      throw new Error(`ACP initialize failed: ${initResp?.error?.message ?? "no response"}`);
+    }
+    translator.attachToTransport({
+      onMessage: (h) => transport.onMessage(h),
+      send: (m) => transport.send(m)
+    });
+    sessionStarted = true;
+  };
+  const runner = async (task, ctx) => {
+    ctx.signal.addEventListener("abort", () => {
+      activeAbort.abort();
+      transport.stop();
+    });
+    await startSession();
+    const callId = crypto.randomUUID();
+    let toolResult = null;
+    const resultPromise = new Promise((resolve, reject) => {
+      const budgetMs = ctx.budget.limits.timeoutMs ?? 3e5;
+      const timeout = setTimeout(() => {
+        reject(new Error(`ACP task timed out for subagent ${ctx.subagentId} (${budgetMs}ms budget)`));
+      }, budgetMs);
+      transport.onMessage((msg) => {
+        if (msg.method === "tools/call" && msg.id !== void 0) {
+          clearTimeout(timeout);
+          resolve(msg);
+        }
+      });
+      ctx.signal.addEventListener("abort", () => {
+        clearTimeout(timeout);
+        reject(new Error("Task aborted by parent"));
+      });
+    });
+    try {
+      await transport.send({
+        method: "agent/run",
+        id: callId,
+        params: {
+          task: task.description,
+          sessionId: ctx.subagentId
+        }
+      });
+      toolResult = await resultPromise;
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return {
+        result: `ACP subagent error: ${msg}`,
+        iterations: 0,
+        toolCalls: 0
+      };
+    }
+    if (!toolResult) {
+      return { result: "ACP subagent returned no result", iterations: 1, toolCalls: 1 };
+    }
+    const parsed = parseToolResponse(task.id, ctx.subagentId, toolResult);
+    return {
+      result: parsed.result ?? parsed.error,
+      iterations: parsed.iterations,
+      toolCalls: parsed.toolCalls
+    };
+  };
+  return runner;
+}
+
+export { ClientTransport, ToolTranslator, makeACPSubagentRunner };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/stdio-transport.ts","../src/client/tool-translator.ts","../src/integration/acp-subagent-runner.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["/**\n * StdioTransport — bidirectional stdin/stdout communication for ACP.\n *\n * ACP uses newline-delimited JSON-RPC 2.0 messages over stdio:\n *   client → agent:  JSON-RPC request/notification on stdin\n *   agent  → client: JSON-RPC response/notification on stdout\n *\n * Start message: clients look for the `[wstack-acp]` marker on stdout before\n * treating subsequent lines as protocol messages.\n */\nimport { buildChildEnv } from '@wrongstack/core';\nimport type { ACPMessage } from '../types/acp-messages.js';\n\nexport interface AgentServerTransport {\n  send(msg: ACPMessage): Promise<void>;\n  sendRaw(chunk: string): void;\n  read(): Promise<ACPMessage | null>;\n  close(): void;\n  onMessage(handler: (msg: ACPMessage) => void): () => void;\n}\n\nexport class StdioTransport implements AgentServerTransport {\n  private readonly stdin = process.stdin;\n  private readonly stdout = process.stdout;\n  private readonly stderr = process.stderr;\n\n  private buffer = '';\n  private readonly handlers = new Set<(msg: ACPMessage) => void>();\n  private closed = false;\n  private resolveRead: ((msg: ACPMessage | null) => void) | null = null;\n  private messageQueue: ACPMessage[] = [];\n\n  constructor() {\n    this.stdin.resume();\n    this.stdin.setEncoding('utf8');\n    this.stdin.on('data', (chunk: string) => this.onData(chunk));\n    this.stdin.on('end', () => this.handleClose());\n    this.stdin.on('error', (err: Error) => this.failAll(err));\n  }\n\n  sendStartupMarker(): void {\n    this.stdout.write('[wstack-acp]\\n', 'utf8');\n  }\n\n  send(msg: ACPMessage): Promise<void> {\n    if (this.closed) return Promise.resolve();\n    return new Promise((resolve) => {\n      const line = JSON.stringify(msg) + '\\n';\n      this.stdout.write(line, 'utf8', () => resolve());\n    });\n  }\n\n  sendRaw(chunk: string): void {\n    this.stdout.write(chunk, 'utf8');\n  }\n\n  read(): Promise<ACPMessage | null> {\n    if (this.messageQueue.length > 0) return Promise.resolve(this.messageQueue.shift()!);\n    if (this.closed) return Promise.resolve(null);\n    return new Promise((resolve) => {\n      this.resolveRead = resolve;\n    });\n  }\n\n  onMessage(handler: (msg: ACPMessage) => void): () => void {\n    this.handlers.add(handler);\n    return () => this.handlers.delete(handler);\n  }\n\n  close(): void {\n    this.closed = true;\n    this.stdin.pause();\n    this.resolveRead?.(null);\n    this.resolveRead = null;\n  }\n\n  private onData(chunk: string): void {\n    this.buffer += chunk;\n    const lines = this.buffer.split('\\n');\n    this.buffer = lines.pop() ?? '';\n\n    for (const raw of lines) {\n      if (!raw.trim()) continue;\n      try {\n        this.dispatch(JSON.parse(raw) as ACPMessage);\n      } catch (err) {\n        this.stderr.write(`[wstack-acp parse error] ${err}\\n`, 'utf8');\n      }\n    }\n  }\n\n  private dispatch(msg: ACPMessage): void {\n    if (this.resolveRead) {\n      const resolve = this.resolveRead;\n      this.resolveRead = null;\n      resolve(msg);\n    } else {\n      this.messageQueue.push(msg);\n    }\n    for (const handler of this.handlers) {\n      try {\n        handler(msg);\n      } catch (err) {\n        this.stderr.write(`[wstack-acp handler error] ${err}\\n`, 'utf8');\n      }\n    }\n  }\n\n  private handleClose(): void {\n    this.closed = true;\n    this.resolveRead?.(null);\n    this.resolveRead = null;\n  }\n\n  private failAll(err: Error): void {\n    this.stderr.write(`[wstack-acp stdin error] ${err.message}\\n`, 'utf8');\n    this.close();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// ClientTransport — spawns a child ACP agent process (DIR-1)\n// ---------------------------------------------------------------------------\n\nimport { spawn } from 'node:child_process';\nimport type { EventEmitter } from 'node:events';\n\nexport interface ClientTransportOptions {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  cwd?: string;\n  handshakeTimeoutMs?: number;\n}\n\nexport interface ACPChildProcess extends EventEmitter {\n  stdout: NodeJS.ReadableStream;\n  stdin: NodeJS.WritableStream;\n  stderr: NodeJS.ReadableStream;\n  pid: number | undefined;\n  kill(): void;\n}\n\nexport class ClientTransport {\n  private child: ACPChildProcess | null = null;\n  private buffer = '';\n  private readonly handlers = new Set<(msg: ACPMessage) => void>();\n  private closed = false;\n  private resolveRead: ((msg: ACPMessage | null) => void) | null = null;\n  private messageQueue: ACPMessage[] = [];\n  private readonly opts: Required<Pick<ClientTransportOptions, 'handshakeTimeoutMs'>> &\n    ClientTransportOptions;\n\n  constructor(options: ClientTransportOptions) {\n    this.opts = {\n      handshakeTimeoutMs: 30_000,\n      ...options,\n    };\n  }\n\n  async start(): Promise<void> {\n    if (this.child) return;\n    return new Promise((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        reject(\n          new Error(`ACP child process failed to start within ${this.opts.handshakeTimeoutMs}ms`),\n        );\n      }, this.opts.handshakeTimeoutMs);\n\n      try {\n        this.child = spawn(this.opts.command, this.opts.args ?? [], {\n          env: { ...buildChildEnv(), ...this.opts.env },\n          cwd: this.opts.cwd,\n          stdio: ['pipe', 'pipe', 'pipe'],\n        }) as unknown as ACPChildProcess;\n      } catch (err) {\n        clearTimeout(timeout);\n        reject(err);\n        return;\n      }\n\n      const child = this.child;\n\n      child.stdout.setEncoding('utf8');\n\n      const waitForMarker = (chunk: string) => {\n        this.buffer += chunk;\n        const idx = this.buffer.indexOf('[wstack-acp]\\n');\n        if (idx !== -1) {\n          this.buffer = this.buffer.slice(idx + '[wstack-acp]\\n'.length);\n          child.stdout.removeListener('data', waitForMarker);\n          child.stdout.on('data', (c: string) => this.onChildData(c));\n          child.stderr.on('data', (c: string) => this.onChildError(c));\n          child.on('close', (code: number | null) => this.onChildClose(code));\n          clearTimeout(timeout);\n          resolve();\n        }\n      };\n\n      child.stdout.on('data', waitForMarker);\n      child.stdout.on('error', (err: Error) => {\n        clearTimeout(timeout);\n        reject(err);\n      });\n      child.on('error', (err: Error) => {\n        clearTimeout(timeout);\n        reject(err);\n      });\n    });\n  }\n\n  send(msg: ACPMessage): Promise<void> {\n    if (!this.child) return Promise.reject(new Error('ClientTransport not started'));\n    return new Promise((resolve, reject) => {\n      const line = JSON.stringify(msg) + '\\n';\n      this.child!.stdin.write(line, 'utf8', (err) => {\n        if (err) reject(err);\n        else resolve();\n      });\n    });\n  }\n\n  read(): Promise<ACPMessage | null> {\n    if (this.messageQueue.length > 0) return Promise.resolve(this.messageQueue.shift()!);\n    if (this.closed) return Promise.resolve(null);\n    return new Promise((resolve) => {\n      this.resolveRead = resolve;\n    });\n  }\n\n  onMessage(handler: (msg: ACPMessage) => void): () => void {\n    this.handlers.add(handler);\n    return () => this.handlers.delete(handler);\n  }\n\n  stop(): void {\n    if (!this.child) return;\n    this.closed = true;\n    try {\n      this.child.kill();\n    } catch {\n      // already dead\n    }\n    this.child = null;\n  }\n\n  private onChildData(chunk: string): void {\n    this.buffer += chunk;\n    const lines = this.buffer.split('\\n');\n    this.buffer = lines.pop() ?? '';\n\n    for (const raw of lines) {\n      if (!raw.trim()) continue;\n      try {\n        this.dispatch(JSON.parse(raw) as ACPMessage);\n      } catch {\n        // skip malformed\n      }\n    }\n  }\n\n  private onChildError(chunk: string): void {\n    process.stderr.write(`[acp-child stderr] ${chunk}`, 'utf8');\n  }\n\n  private onChildClose(code: number | null): void {\n    this.closed = true;\n    this.resolveRead?.(null);\n    this.resolveRead = null;\n    if (code !== 0 && code !== null) {\n      process.stderr.write(`[acp-child exited with code ${code}]\\n`, 'utf8');\n    }\n  }\n\n  private dispatch(msg: ACPMessage): void {\n    if (this.resolveRead) {\n      const resolve = this.resolveRead;\n      this.resolveRead = null;\n      resolve(msg);\n    } else {\n      this.messageQueue.push(msg);\n    }\n    for (const handler of this.handlers) {\n      try {\n        handler(msg);\n      } catch {\n        // non-fatal\n      }\n    }\n  }\n}\n","/**\n * ToolTranslator — bidirectional translation between WrongStack tools and\n * ACP tool representations.\n *\n * Used by DIR-1 (WrongStack as ACP client) to:\n *   - Map WrongStack TaskSpec → ACP task payload\n *   - Map ACP tool responses → TaskResult\n *\n * Used by DIR-2 (WrongStack as ACP server) to:\n *   - Convert the WrongStack Tool.inputSchema → ACPToolDefinition.inputSchema\n *   - (handled by tools-registry.ts — same logic lives there)\n *\n * For DIR-1 async tool calls: ACP agents send progress notifications while\n * a tool is running, then send a final result. The translator handles this\n * by polling for the final [result] notification on the transport.\n */\nimport type {ACPMessage, ACPToolDefinition, ACPToolCallResponse, ContentBlock} from '../types/acp-messages.js';\nimport type {TaskSpec, TaskResult} from '@wrongstack/core';\n\nexport interface ToolTranslatorOptions {\n  /**\n   * If true (default), wrap tool calls in an async poll loop that waits\n   * for progress notifications until a final result arrives.\n   */\n  asyncTools?: boolean;\n  pollIntervalMs?: number;\n  totalTimeoutMs?: number;\n}\n\nconst DEFAULT_OPTIONS: Required<ToolTranslatorOptions> = {\n  asyncTools: true,\n  pollIntervalMs: 500,\n  totalTimeoutMs: 120_000,\n};\n\n/** Convert an ACP ACPToolDefinition → a JSON schema object recognisable by WrongStack */\nexport function acpToolToSchema(def: ACPToolDefinition): Record<string, unknown> {\n  if (!def.inputSchema) return {type: 'object', properties: {}};\n  return def.inputSchema as Record<string, unknown>;\n}\n\n/** Extract tool result text from ACP ContentBlock[] */\nexport function extractTextFromContent(blocks: ContentBlock[]): string {\n  const parts: string[] = [];\n  for (const b of blocks) {\n    if (b.type === 'text') parts.push(b.text);\n    else if (b.type === 'resource') parts.push(`[resource: ${b.resource.uri}]`);\n    else if (b.type === 'image') parts.push(`[image: ${b.data.slice(0, 20)}...]`);\n    else if (b.type === 'progress') {\n      if (b.messages?.length) parts.push(b.messages.join('\\n'));\n    }\n  }\n  return parts.join('\\n');\n}\n\n/** Build a TaskSpec from an ACP task payload */\nexport function buildTaskSpec(payload: {\n  taskId: string;\n  task: string;\n  subagentId?: string;\n}): TaskSpec {\n  return {\n    id: payload.taskId,\n    description: payload.task,\n    subagentId: payload.subagentId,\n  };\n}\n\n/** Parse an ACP tools/call response → TaskResult */\nexport function parseToolResponse(\n  taskId: string,\n  subagentId: string,\n  response: ACPToolCallResponse,\n): TaskResult {\n  const blocks = response.result.content;\n  const text = extractTextFromContent(blocks);\n\n  // Detect error state from isError flag or error-like text\n  const isError =\n    response.result.isError || text.toLowerCase().includes('error') ||\n    text.toLowerCase().includes('failed');\n\n  return {\n    taskId,\n    subagentId,\n    status: isError ? 'failed' : 'success',\n    result: text,\n    iterations: 1,\n    toolCalls: 1,\n    durationMs: 0,\n  };\n}\n\n/** ToolTranslator for DIR-1 — wraps ACP client transport, adds task semantics */\nexport class ToolTranslator {\n  private readonly opts: Required<ToolTranslatorOptions>;\n  private readonly pending = new Map<string | number, {\n    resolve: (v: ACPToolCallResponse) => void;\n    reject: (e: Error) => void;\n    timeout: ReturnType<typeof setTimeout>;\n  }>();\n\n  constructor(opts: ToolTranslatorOptions = {}) {\n    this.opts = {...DEFAULT_OPTIONS, ...opts};\n  }\n\n  /**\n   * Start listening to a transport for tool responses and cancellations.\n   * Call this once after constructing the translator and before sending tasks.\n   */\n  attachToTransport(\n    transport: {onMessage: (h: (msg: ACPMessage) => void) => () => void; send: (msg: ACPMessage) => Promise<void>},\n  ): void {\n    transport.onMessage((msg) => {\n      if (msg.method === 'tools/call' && msg.id !== undefined) {\n        const pending = this.pending.get(msg.id);\n        if (pending) {\n          clearTimeout(pending.timeout);\n          this.pending.delete(msg.id!);\n          pending.resolve(msg as unknown as ACPToolCallResponse);\n        }\n      }\n\n      // Handle cancellation notifications\n      if (msg.method === 'cancel' && msg.id !== undefined) {\n        const pending = this.pending.get(msg.id);\n        if (pending) {\n          clearTimeout(pending.timeout);\n          this.pending.delete(msg.id!);\n          pending.reject(new Error('Call cancelled by client'));\n        }\n      }\n    });\n  }\n\n  /**\n   * Send a tool call over the transport and wait for a response.\n   * If asyncTools is true, polls for progress and resolves when the final\n   * response arrives.\n   */\n  async callTool(\n    transport: {send: (msg: ACPMessage) => Promise<void>},\n    name: string,\n    args: Record<string, unknown>,\n    callId: string | number = crypto.randomUUID(),\n  ): Promise<ACPToolCallResponse> {\n    await transport.send({\n      method: 'tools/call',\n      id: callId,\n      params: {name, arguments: args},\n    });\n\n    return new Promise((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        this.pending.delete(callId);\n        reject(new Error(`Tool call ${name} timed out after ${this.opts.totalTimeoutMs}ms`));\n      }, this.opts.totalTimeoutMs);\n\n      this.pending.set(callId, {resolve, reject, timeout});\n    });\n  }\n\n  cancelAll(): void {\n    for (const [, p] of this.pending) {\n      clearTimeout(p.timeout);\n    }\n    this.pending.clear();\n  }\n}\n","/**\n * ACPSubagentRunner — SubagentRunner implementation for DIR-1.\n *\n * Wraps an external ACP agent (Cline, Gemini CLI, Codex CLI, Copilot, etc.)\n * as a WrongStack subagent. The external agent runs its own agent loop;\n * we send it a task via ACP and return the result.\n *\n * Connected to Director / MultiAgentCoordinator via the SubagentRunner\n * interface (same as AgentSubagentRunner).\n */\nimport type {SubagentRunContext, SubagentRunner, TaskSpec} from '@wrongstack/core';\nimport {ClientTransport} from '../agent/stdio-transport.js';\nimport type {ACPToolCallResponse} from '../types/acp-messages.js';\nimport {ToolTranslator, parseToolResponse} from '../client/tool-translator.js';\nimport type {ToolTranslatorOptions} from '../client/tool-translator.js';\n\nexport interface ACPSubagentRunnerOptions {\n  /** ACP agent command or npm package (e.g. 'npx', 'gemini', 'gh') */\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  cwd?: string;\n  /** Subagent role — used for protocol negotiation and prompt overrides */\n  role?: string;\n  toolTranslatorOpts?: ToolTranslatorOptions;\n}\n\n/** Map WrongStack ACP agent role → how to spawn it. */\nexport const ACP_AGENT_COMMANDS: Record<string, ACPSubagentRunnerOptions> = {\n  cline: {\n    command: 'npx',\n    args: ['-y', '@agentify/cline'],\n    role: 'cline',\n  },\n  'gemini-cli': {\n    command: 'gemini',\n    role: 'gemini-cli',\n  },\n  copilot: {\n    command: 'gh',\n    args: ['copilot', 'agent'],\n    role: 'copilot',\n  },\n  openhands: {\n    command: 'openhands',\n    role: 'openhands',\n  },\n  goose: {\n    command: 'goose',\n    role: 'goose',\n  },\n};\n\n/**\n * Build an ACPSubagentRunner for a given role, or a generic one from explicit options.\n */\nexport async function makeACPSubagentRunner(\n  options: ACPSubagentRunnerOptions,\n): Promise<SubagentRunner> {\n  const transport = new ClientTransport({\n    command: options.command,\n    args: options.args,\n    env: options.env,\n    cwd: options.cwd,\n    handshakeTimeoutMs: 30_000,\n  });\n\n  const translator = new ToolTranslator(options.toolTranslatorOpts);\n  const activeAbort = new AbortController();\n\n  let sessionStarted = false;\n\n  const startSession = async (): Promise<void> => {\n    if (sessionStarted) return;\n    await transport.start();\n\n    await transport.send({\n      method: 'initialize',\n      id: '1',\n      params: {\n        capabilities: ['code-generation', 'async-tools', 'streaming', 'progress'],\n        protocolVersion: '2024-11',\n        sessionId: options.role ?? 'wrongstack-subagent',\n      },\n    });\n\n    const initResp = await transport.read();\n    if (!initResp || initResp.error) {\n      throw new Error(`ACP initialize failed: ${initResp?.error?.message ?? 'no response'}`);\n    }\n\n    translator.attachToTransport({\n      onMessage: (h) => transport.onMessage(h),\n      send: (m) => transport.send(m),\n    });\n\n    sessionStarted = true;\n  };\n\n  const runner: SubagentRunner = async (\n    task: TaskSpec,\n    ctx: SubagentRunContext,\n  ): Promise<{result?: unknown; iterations: number; toolCalls: number}> => {\n    ctx.signal.addEventListener('abort', () => {\n      activeAbort.abort();\n      transport.stop();\n    });\n\n    await startSession();\n\n    const callId = crypto.randomUUID();\n    let toolResult: ACPToolCallResponse | null = null;\n\n    const resultPromise = new Promise<ACPToolCallResponse>((resolve, reject) => {\n      const budgetMs = ctx.budget.limits.timeoutMs ?? 300_000;\n\n      const timeout = setTimeout(() => {\n        reject(new Error(`ACP task timed out for subagent ${ctx.subagentId} (${budgetMs}ms budget)`));\n      }, budgetMs);\n\n      transport.onMessage((msg) => {\n        if (msg.method === 'tools/call' && msg.id !== undefined) {\n          clearTimeout(timeout);\n          resolve(msg as unknown as ACPToolCallResponse);\n        }\n      });\n\n      ctx.signal.addEventListener('abort', () => {\n        clearTimeout(timeout);\n        reject(new Error('Task aborted by parent'));\n      });\n    });\n\n    try {\n      // Most ACP agents accept a free-form task string as their primary input.\n      // Use the tools/call protocol with a special 'task' pseudo-tool if the\n      // agent advertises it; otherwise send it as an initialize session detail\n      // or a custom agent/run message. The agent will respond on stdout.\n      await transport.send({\n        method: 'agent/run',\n        id: callId,\n        params: {\n          task: task.description,\n          sessionId: ctx.subagentId,\n        },\n      });\n\n      toolResult = await resultPromise;\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      return {\n        result: `ACP subagent error: ${msg}`,\n        iterations: 0,\n        toolCalls: 0,\n      };\n    }\n\n    if (!toolResult) {\n      return {result: 'ACP subagent returned no result', iterations: 1, toolCalls: 1};\n    }\n\n    const parsed = parseToolResponse(task.id, ctx.subagentId, toolResult);\n    return {\n      result: parsed.result ?? parsed.error,\n      iterations: parsed.iterations,\n      toolCalls: parsed.toolCalls,\n    };\n  };\n\n  return runner;\n}\n\n/** Returns the runner and a stop function to clean up the transport. */\nexport async function makeACPSubagentRunnerWithStop(\n  options: ACPSubagentRunnerOptions,\n): Promise<{runner: SubagentRunner; stop: () => void}> {\n  const transport = new ClientTransport({\n    command: options.command,\n    args: options.args,\n    env: options.env,\n    cwd: options.cwd,\n    handshakeTimeoutMs: 30_000,\n  });\n\n  const translator = new ToolTranslator(options.toolTranslatorOpts);\n  const activeAbort = new AbortController();\n\n  let sessionStarted = false;\n\n  const startSession = async (): Promise<void> => {\n    if (sessionStarted) return;\n    await transport.start();\n\n    await transport.send({\n      method: 'initialize',\n      id: '1',\n      params: {\n        capabilities: ['code-generation', 'async-tools', 'streaming', 'progress'],\n        protocolVersion: '2024-11',\n        sessionId: options.role ?? 'wrongstack-subagent',\n      },\n    });\n\n    const initResp = await transport.read();\n    if (!initResp || initResp.error) {\n      throw new Error(`ACP initialize failed: ${initResp?.error?.message ?? 'no response'}`);\n    }\n\n    translator.attachToTransport({\n      onMessage: (h) => transport.onMessage(h),\n      send: (m) => transport.send(m),\n    });\n\n    sessionStarted = true;\n  };\n\n  const stop = () => {\n    activeAbort.abort();\n    transport.stop();\n  };\n\n  const runner: SubagentRunner = async (\n    task: TaskSpec,\n    ctx: SubagentRunContext,\n  ): Promise<{result?: unknown; iterations: number; toolCalls: number}> => {\n    ctx.signal.addEventListener('abort', () => {\n      activeAbort.abort();\n      transport.stop();\n    });\n\n    await startSession();\n\n    const callId = crypto.randomUUID();\n    let toolResult: ACPToolCallResponse | null = null;\n\n    const resultPromise = new Promise<ACPToolCallResponse>((resolve, reject) => {\n      const budgetMs = ctx.budget.limits.timeoutMs ?? 300_000;\n\n      const timeout = setTimeout(() => {\n        reject(new Error(`ACP task timed out for subagent ${ctx.subagentId} (${budgetMs}ms budget)`));\n      }, budgetMs);\n\n      transport.onMessage((msg) => {\n        if (msg.method === 'tools/call' && msg.id !== undefined) {\n          clearTimeout(timeout);\n          resolve(msg as unknown as ACPToolCallResponse);\n        }\n      });\n\n      ctx.signal.addEventListener('abort', () => {\n        clearTimeout(timeout);\n        reject(new Error('Task aborted by parent'));\n      });\n    });\n\n    try {\n      await transport.send({\n        method: 'agent/run',\n        id: callId,\n        params: {\n          task: task.description,\n          sessionId: ctx.subagentId,\n        },\n      });\n\n      toolResult = await resultPromise;\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      return {\n        result: `ACP subagent error: ${msg}`,\n        iterations: 0,\n        toolCalls: 0,\n      };\n    }\n\n    if (!toolResult) {\n      return {result: 'ACP subagent returned no result', iterations: 1, toolCalls: 1};\n    }\n\n    const parsed = parseToolResponse(task.id, ctx.subagentId, toolResult);\n    return {\n      result: parsed.result ?? parsed.error,\n      iterations: parsed.iterations,\n      toolCalls: parsed.toolCalls,\n    };\n  };\n\n  return {runner, stop};\n}\n"]}

package/dist/{client/tool-translator.d.ts → index-CncECXiF.d.ts}

@@ -1,3 +1,6 @@
+import { g as ACPMessage, s as ACPToolCallResponse } from './stdio-transport-DqWq-2iP.js';
+import { SubagentRunner } from '@wrongstack/core';
+
 /**
  * ToolTranslator — bidirectional translation between WrongStack tools and
  * ACP tool representations.
@@ -14,9 +17,8 @@
  * a tool is running, then send a final result. The translator handles this
  * by polling for the final [result] notification on the transport.
  */
-import type { ACPMessage, ACPToolDefinition, ACPToolCallResponse, ContentBlock } from '../types/acp-messages.js';
-import type { TaskSpec, TaskResult } from '@wrongstack/core';
-export interface ToolTranslatorOptions {
+
+interface ToolTranslatorOptions {
     /**
      * If true (default), wrap tool calls in an async poll loop that waits
      * for progress notifications until a final result arrives.
@@ -25,20 +27,8 @@ export interface ToolTranslatorOptions {
     pollIntervalMs?: number;
     totalTimeoutMs?: number;
 }
-/** Convert an ACP ACPToolDefinition → a JSON schema object recognisable by WrongStack */
-export declare function acpToolToSchema(def: ACPToolDefinition): Record<string, unknown>;
-/** Extract tool result text from ACP ContentBlock[] */
-export declare function extractTextFromContent(blocks: ContentBlock[]): string;
-/** Build a TaskSpec from an ACP task payload */
-export declare function buildTaskSpec(payload: {
-    taskId: string;
-    task: string;
-    subagentId?: string;
-}): TaskSpec;
-/** Parse an ACP tools/call response → TaskResult */
-export declare function parseToolResponse(taskId: string, subagentId: string, response: ACPToolCallResponse): TaskResult;
 /** ToolTranslator for DIR-1 — wraps ACP client transport, adds task semantics */
-export declare class ToolTranslator {
+declare class ToolTranslator {
     private readonly opts;
     private readonly pending;
     constructor(opts?: ToolTranslatorOptions);
@@ -60,4 +50,38 @@ export declare class ToolTranslator {
     }, name: string, args: Record<string, unknown>, callId?: string | number): Promise<ACPToolCallResponse>;
     cancelAll(): void;
 }
-//# sourceMappingURL=tool-translator.d.ts.map
+
+/**
+ * ACPSubagentRunner — SubagentRunner implementation for DIR-1.
+ *
+ * Wraps an external ACP agent (Cline, Gemini CLI, Codex CLI, Copilot, etc.)
+ * as a WrongStack subagent. The external agent runs its own agent loop;
+ * we send it a task via ACP and return the result.
+ *
+ * Connected to Director / MultiAgentCoordinator via the SubagentRunner
+ * interface (same as AgentSubagentRunner).
+ */
+
+interface ACPSubagentRunnerOptions {
+    /** ACP agent command or npm package (e.g. 'npx', 'gemini', 'gh') */
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    /** Subagent role — used for protocol negotiation and prompt overrides */
+    role?: string;
+    toolTranslatorOpts?: ToolTranslatorOptions;
+}
+/** Map WrongStack ACP agent role → how to spawn it. */
+declare const ACP_AGENT_COMMANDS: Record<string, ACPSubagentRunnerOptions>;
+/**
+ * Build an ACPSubagentRunner for a given role, or a generic one from explicit options.
+ */
+declare function makeACPSubagentRunner(options: ACPSubagentRunnerOptions): Promise<SubagentRunner>;
+/** Returns the runner and a stop function to clean up the transport. */
+declare function makeACPSubagentRunnerWithStop(options: ACPSubagentRunnerOptions): Promise<{
+    runner: SubagentRunner;
+    stop: () => void;
+}>;
+
+export { type ACPSubagentRunnerOptions as A, ToolTranslator as T, ACP_AGENT_COMMANDS as a, type ToolTranslatorOptions as b, makeACPSubagentRunnerWithStop as c, makeACPSubagentRunner as m };

package/dist/index.d.ts

@@ -1,24 +1,5 @@
-/**
- * @wrongstack/acp — ACP integration public surface.
- *
- * DIR-2: WrongStack as ACP Server
- *   import { WrongStackACPServer } from '@wrongstack/acp/agent';
- *
- * DIR-1: WrongStack as ACP Client
- *   import { makeACPSubagentRunner } from '@wrongstack/acp/client';
- */
-export { StdioTransport } from './agent/stdio-transport.js';
-export type { AgentServerTransport } from './agent/stdio-transport.js';
-export { ACPToolsRegistry } from './agent/tools-registry.js';
-export { ACPProtocolHandler } from './agent/protocol-handler.js';
-export { WrongStackACPServer } from './agent/wrongstack-acp-agent.js';
-export type { WrongStackACPServerOptions } from './agent/wrongstack-acp-agent.js';
-export { ClientTransport } from './agent/stdio-transport.js';
-export type { ClientTransportOptions, ACPChildProcess } from './agent/stdio-transport.js';
-export { ToolTranslator } from './client/tool-translator.js';
-export type { ToolTranslatorOptions } from './client/tool-translator.js';
-export { makeACPSubagentRunner, makeACPSubagentRunnerWithStop } from './integration/acp-subagent-runner.js';
-export type { ACPSubagentRunnerOptions } from './integration/acp-subagent-runner.js';
-export { ACP_AGENT_COMMANDS } from './integration/acp-subagent-runner.js';
-export * from './types/acp-messages.js';
-//# sourceMappingURL=index.d.ts.map
+export { A as ACPCancelParams, a as ACPCapabilities, b as ACPChildProcess, c as ACPError, d as ACPImageContent, e as ACPInitializeParams, f as ACPInputSchema, g as ACPMessage, h as ACPNotification, i as ACPPlanContent, j as ACPPlanStep, k as ACPProgressContent, l as ACPRequest, m as ACPResourceContent, n as ACPResponse, o as ACPSessionInfo, p as ACPSessionMode, q as ACPTextContent, r as ACPToolCallRequest, s as ACPToolCallResponse, t as ACPToolDefinition, u as ACPToolList, v as ACPToolResult, w as AgentServerTransport, C as ClientTransport, x as ClientTransportOptions, y as ContentBlock, S as StdioTransport } from './stdio-transport-DqWq-2iP.js';
+export { ACPProtocolHandler, ACPToolsRegistry, WrongStackACPServer, WrongStackACPServerOptions } from './agent.js';
+export { A as ACPSubagentRunnerOptions, a as ACP_AGENT_COMMANDS, T as ToolTranslator, b as ToolTranslatorOptions, m as makeACPSubagentRunner, c as makeACPSubagentRunnerWithStop } from './index-CncECXiF.js';
+import 'node:events';
+import '@wrongstack/core';