@tanstack/ai-acp 0.1.0

package/dist/esm/adapters/compatible.js

@@ -0,0 +1,313 @@
+import { normalizeSystemPrompts, EventType } from "@tanstack/ai";
+import { toRunErrorRawEvent } from "@tanstack/ai/adapter-internals";
+import { BaseTextAdapter } from "@tanstack/ai/adapters";
+import { SandboxCapability, getSandbox, buildApprovalRequestedEvent, resolveHarnessCwd, createBridgeEventChannel, getToolBridgeProvisioner, nodeHttpBridgeProvisioner, getWorkspaceProjection, mergeChunkStreams } from "@tanstack/ai-sandbox";
+import { AsyncQueue } from "../stream/queue.js";
+import { startAcpSession } from "../session/acp-client.js";
+import { translateAcpStream } from "../stream/translate.js";
+import { resolveInteractivePermission, resolvePermission } from "../permissions.js";
+import { buildAcpPrompt } from "../messages/prompt.js";
+import { projectAcpWorkspace, workspaceMcpServers } from "./projection.js";
+const DEFAULT_WORKDIR = "/workspace";
+function q(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+async function disposeTransport(transport) {
+  if (transport.kind === "stdio") {
+    await transport.process.kill();
+    return;
+  }
+  await transport.dispose();
+}
+class AcpCompatibleTextAdapter extends BaseTextAdapter {
+  name;
+  requires = [SandboxCapability];
+  harness;
+  constructor(config, model) {
+    super({}, model);
+    if (config.command === void 0 && config.openTransport === void 0) {
+      throw new Error(
+        `acpCompatible("${config.name}") needs either a "command" or an "openTransport".`
+      );
+    }
+    this.harness = config;
+    this.name = config.name;
+  }
+  sandboxFrom(options) {
+    const ctx = options.capabilities;
+    if (!ctx) {
+      throw new Error(
+        `Adapter "${this.name}" requires a sandbox. Add withSandbox(defineSandbox({ ... })) to chat() middleware.`
+      );
+    }
+    return getSandbox(ctx);
+  }
+  buildPrompt(messages, sessionId) {
+    return this.harness.buildPrompt ? this.harness.buildPrompt(messages, sessionId) : buildAcpPrompt(messages, sessionId, this.name);
+  }
+  applySystemPrompts(systemPrompts, prompt) {
+    if (systemPrompts.length === 0) return prompt;
+    return `${systemPrompts.join("\n\n")}
+
+${prompt}`;
+  }
+  makePermissionHandler(input) {
+    if (this.harness.onPermissionRequest)
+      return this.harness.onPermissionRequest;
+    if (this.harness.permissions === "interactive") {
+      return (request) => {
+        const result = resolveInteractivePermission(
+          request,
+          input.mode,
+          input.bridgedToolNames,
+          input.approvals,
+          this.name
+        );
+        if (result.approvalId !== void 0) {
+          input.approvalRequests.push(
+            buildApprovalRequestedEvent({
+              approvalId: result.approvalId,
+              title: result.title ?? request.toolCall.title ?? request.toolCall.toolCallId,
+              threadId: input.threadId,
+              runId: input.runId,
+              detail: { provider: this.name }
+            })
+          );
+        }
+        return result.outcome;
+      };
+    }
+    return (request) => resolvePermission(request, input.mode, input.bridgedToolNames);
+  }
+  async *chatStream(options) {
+    const { logger } = options;
+    let handle;
+    let bridge;
+    let transport;
+    const externalSignal = options.abortController?.signal ?? options.request?.signal ?? void 0;
+    let onAbort;
+    try {
+      const sandbox = this.sandboxFrom(options);
+      const modelOptions = options.modelOptions;
+      const cwd = modelOptions?.cwd ?? this.harness.cwd ?? DEFAULT_WORKDIR;
+      const harnessCwd = resolveHarnessCwd(sandbox, cwd);
+      const runId = options.runId ?? this.generateId();
+      const threadId = options.threadId ?? this.generateId();
+      const channel = createBridgeEventChannel({
+        model: this.model,
+        threadId,
+        runId
+      });
+      const sessionId = modelOptions?.sessionId;
+      const { prompt: resumePrompt } = this.buildPrompt(
+        options.messages,
+        sessionId
+      );
+      const bridgedToolNames = new Set(
+        (options.tools ?? []).map((tool) => tool.name)
+      );
+      if (options.tools && options.tools.length > 0) {
+        const provisioner = (options.capabilities ? getToolBridgeProvisioner(options.capabilities, { optional: true }) : void 0) ?? nodeHttpBridgeProvisioner;
+        bridge = await provisioner.provision(options.tools, {
+          provider: sandbox.provider,
+          context: options.context,
+          emitCustomEvent: channel.emitCustomEvent,
+          ...externalSignal ? { signal: externalSignal } : {}
+        });
+      }
+      let workspaceServers = [];
+      const projection = options.capabilities ? getWorkspaceProjection(options.capabilities, { optional: true }) : void 0;
+      if (projection !== void 0) {
+        await projectAcpWorkspace(sandbox, projection, {
+          ...this.harness.skillsDir !== void 0 && {
+            skillsDir: this.harness.skillsDir
+          },
+          harnessName: this.name
+        });
+        workspaceServers = workspaceMcpServers(projection);
+      }
+      const ctx = {
+        sandbox,
+        model: this.model,
+        cwd,
+        harnessCwd,
+        env: this.harness.env,
+        modelOptions,
+        signal: externalSignal
+      };
+      transport = this.harness.openTransport ? await this.harness.openTransport(ctx) : await this.openStdioTransport(ctx);
+      const mode = modelOptions?.permissionMode ?? this.harness.permissionMode ?? "bypassPermissions";
+      const authMethodId = modelOptions?.authMethodId ?? this.harness.authMethodId;
+      const approvalRequests = [];
+      const permissionHandler = this.makePermissionHandler({
+        mode,
+        bridgedToolNames,
+        approvals: options.approvals,
+        approvalRequests,
+        threadId,
+        runId
+      });
+      const queue = new AsyncQueue();
+      logger.request(
+        `activity=chat provider=${this.name} model=${this.model} sandbox=${sandbox.provider} messages=${options.messages.length} resume=${sessionId ?? "none"}`,
+        { provider: this.name, model: this.model }
+      );
+      const mcpServers = [
+        ...bridge !== void 0 ? [
+          {
+            name: bridge.name,
+            url: bridge.url,
+            headers: [
+              { name: "Authorization", value: `Bearer ${bridge.token}` }
+            ]
+          }
+        ] : [],
+        ...workspaceServers
+      ];
+      const onAcpUpdate = (update) => queue.push({ kind: "update", update });
+      handle = await startAcpSession({
+        transport,
+        cwd: harnessCwd,
+        ...authMethodId !== void 0 && { authMethodId },
+        ...sessionId !== void 0 && { resumeSessionId: sessionId },
+        ...mcpServers.length > 0 && { mcpServers },
+        onUpdate: onAcpUpdate,
+        ...this.harness.onExtNotification && {
+          onExtNotification: this.harness.onExtNotification
+        },
+        onPermissionRequest: permissionHandler
+      });
+      const session = handle;
+      if (externalSignal !== void 0) {
+        onAbort = () => void session.cancel().catch(() => void 0);
+        if (externalSignal.aborted) onAbort();
+        else externalSignal.addEventListener("abort", onAbort, { once: true });
+      }
+      queue.push({ kind: "session", sessionId: session.sessionId });
+      const systemPrompts = normalizeSystemPrompts(options.systemPrompts).map((p) => p.content).filter((c) => c.trim() !== "");
+      const promptText = this.applySystemPrompts(
+        systemPrompts,
+        session.resumed || sessionId === void 0 ? resumePrompt : this.buildPrompt(options.messages, void 0).prompt
+      );
+      session.prompt(promptText).then(({ stopReason, usage }) => {
+        queue.push({
+          kind: "done",
+          stopReason,
+          ...usage !== void 0 && { usage }
+        });
+        queue.end();
+      }).catch((error) => queue.fail(error));
+      yield* mergeChunkStreams(
+        translateAcpStream(queue, {
+          model: this.model,
+          runId,
+          threadId,
+          ...options.parentRunId !== void 0 && {
+            parentRunId: options.parentRunId
+          },
+          genId: () => this.generateId(),
+          bridgedToolNames,
+          labels: {
+            sessionIdEvent: `${this.name}.session-id`,
+            // Surface non-text agent content (image/audio/resource) instead of
+            // dropping it — emitted as a CUSTOM `<name>.message-content` event.
+            contentEvent: `${this.name}.message-content`,
+            ...this.harness.planEventName !== void 0 && {
+              planEvent: this.harness.planEventName
+            },
+            ...this.harness.refusalMessage !== void 0 && {
+              refusalMessage: this.harness.refusalMessage
+            }
+          },
+          onAcpEvent: (event) => logger.provider(`provider=${this.name} kind=${event.kind}`, {
+            chunk: event
+          })
+        }),
+        channel.stream
+      );
+      for (const event of approvalRequests) yield event;
+      if (this.harness.emitDiff) {
+        yield* this.emitDiffChunks(sandbox, cwd, threadId, runId);
+      }
+    } catch (error) {
+      const err = error;
+      const rawEvent = toRunErrorRawEvent(error);
+      logger.errors(`${this.name}.chatStream fatal`, {
+        error,
+        source: `${this.name}.chatStream`
+      });
+      yield {
+        type: EventType.RUN_ERROR,
+        model: options.model,
+        timestamp: Date.now(),
+        message: err.message || "Unknown error occurred",
+        ...err.code !== void 0 && { code: err.code },
+        ...rawEvent !== void 0 && { rawEvent },
+        error: {
+          message: err.message || "Unknown error occurred",
+          ...err.code !== void 0 && { code: err.code }
+        }
+      };
+    } finally {
+      if (externalSignal !== void 0 && onAbort !== void 0) {
+        externalSignal.removeEventListener("abort", onAbort);
+      }
+      if (handle !== void 0) await handle.dispose();
+      else if (transport !== void 0) await disposeTransport(transport);
+      await bridge?.close();
+    }
+  }
+  async openStdioTransport(ctx) {
+    const build = this.harness.command;
+    if (build === void 0) {
+      throw new Error(
+        `acpCompatible("${this.name}") has no "command" to launch over stdio.`
+      );
+    }
+    const command = build(ctx);
+    const proc = await ctx.sandbox.process.spawn(command, {
+      cwd: ctx.cwd,
+      ...this.harness.env ? { env: this.harness.env } : {},
+      ...ctx.signal ? { signal: ctx.signal } : {}
+    });
+    return { kind: "stdio", process: proc };
+  }
+  async *emitDiffChunks(sandbox, cwd, threadId, runId) {
+    try {
+      const diff = await sandbox.process.exec(`git -C ${q(cwd)} diff`, { cwd });
+      if (diff.exitCode === 0 && diff.stdout.trim() !== "") {
+        yield {
+          type: EventType.CUSTOM,
+          name: "file.changed",
+          value: { path: ".", diff: diff.stdout },
+          timestamp: Date.now(),
+          threadId,
+          runId
+        };
+      }
+    } catch {
+    }
+  }
+  structuredOutput(_options) {
+    return Promise.reject(
+      new Error(
+        `Structured output is not supported by the in-sandbox "${this.name}" ACP harness adapter. Use a model adapter for structured output, or omit outputSchema.`
+      )
+    );
+  }
+}
+function acpCompatible(config) {
+  return (model, overrides) => new AcpCompatibleTextAdapter(
+    overrides ? { ...config, ...overrides } : config,
+    model
+  );
+}
+function acpCompatibleText(model, config) {
+  return new AcpCompatibleTextAdapter(config, model);
+}
+export {
+  AcpCompatibleTextAdapter,
+  acpCompatible,
+  acpCompatibleText
+};
+//# sourceMappingURL=compatible.js.map

package/dist/esm/adapters/compatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatible.js","sources":["../../../src/adapters/compatible.ts"],"sourcesContent":["import { EventType, normalizeSystemPrompts } from '@tanstack/ai'\nimport { toRunErrorRawEvent } from '@tanstack/ai/adapter-internals'\nimport { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport {\n  SandboxCapability,\n  buildApprovalRequestedEvent,\n  createBridgeEventChannel,\n  getSandbox,\n  getToolBridgeProvisioner,\n  getWorkspaceProjection,\n  mergeChunkStreams,\n  nodeHttpBridgeProvisioner,\n  resolveHarnessCwd,\n} from '@tanstack/ai-sandbox'\nimport { AsyncQueue } from '../stream/queue'\nimport { startAcpSession } from '../session/acp-client'\nimport { translateAcpStream } from '../stream/translate'\nimport { resolveInteractivePermission, resolvePermission } from '../permissions'\nimport { buildAcpPrompt } from '../messages/prompt'\nimport { projectAcpWorkspace, workspaceMcpServers } from './projection'\nimport type { AcpMcpServer } from './projection'\nimport type { HostToolBridge, SandboxHandle } from '@tanstack/ai-sandbox'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type {\n  DefaultMessageMetadataByModality,\n  Modality,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\nimport type { AcpSessionHandle } from '../session/acp-client'\nimport type { AcpStreamEvent } from '../stream/translate'\nimport type { AcpSessionTransport } from '../transport/types'\nimport type {\n  AcpPermissionMode,\n  AcpSessionUpdate,\n  PermissionHandler,\n} from '../types/acp-types'\nimport type { BuiltAcpPrompt } from '../messages/prompt'\n\nconst DEFAULT_WORKDIR = '/workspace'\n\n/**\n * Everything a harness needs to know to launch its ACP server inside the\n * sandbox. Passed to {@link AcpCompatibleConfig.command} /\n * {@link AcpCompatibleConfig.openTransport}.\n */\nexport interface AcpHarnessContext<\n  TModelOptions extends Record<string, any> = AcpCompatibleProviderOptions,\n> {\n  /** The sandbox the harness runs in (from `withSandbox(...)` middleware). */\n  sandbox: SandboxHandle\n  /** The selected model id. */\n  model: string\n  /** Virtual cwd for `sandbox.process.spawn` (the provider maps `/workspace`). */\n  cwd: string\n  /** Literal cwd for the harness's own `--cwd` flag / ACP `newSession`. */\n  harnessCwd: string\n  /** Extra env vars configured for the harness process. */\n  env: Record<string, string> | undefined\n  /**\n   * Per-call options from `chat({ modelOptions })` — the base ACP options plus\n   * whatever you declared via {@link AcpCompatibleConfig.modelOptions}. Read\n   * these to turn options into CLI flags / transport choices.\n   */\n  modelOptions: TModelOptions | undefined\n  /** Abort signal for the run, when one was provided. */\n  signal: AbortSignal | undefined\n}\n\n/** Union of selectable model names from a `models` tuple (any string if omitted). */\nexport type AcpModelNameOf<TModels extends ReadonlyArray<string>> =\n  TModels[number]\n\nexport interface AcpCompatibleConfig<\n  TModels extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TModelOptions extends Record<string, any> = AcpCompatibleProviderOptions,\n> {\n  /**\n   * Harness name. Used as the provider label, the log prefix, and the CUSTOM\n   * session-id event name (`<name>.session-id`).\n   */\n  name: string\n  /**\n   * The models this harness accepts. Declaring them makes the returned factory\n   * type-safe — `harness('known-model')` is checked, unknown ids are rejected.\n   * Omit to accept any string.\n   */\n  models?: TModels\n  /**\n   * Type-only brand for the per-call options accepted via `chat({ modelOptions })`.\n   * Declare your harness's options here with `{} as { ... }` (the value is unused\n   * at runtime); they are merged with the base {@link AcpCompatibleProviderOptions}\n   * and exposed on {@link AcpHarnessContext.modelOptions} so `command` /\n   * `openTransport` can turn them into CLI flags.\n   *\n   * @example modelOptions: {} as { reasoningEffort?: 'low' | 'high' }\n   */\n  modelOptions?: TModelOptions\n  /**\n   * Build the shell command that launches the harness's ACP server over\n   * **stdio** inside the sandbox (e.g. `` `pi --acp -m ${model}` ``). Required\n   * unless {@link openTransport} is provided.\n   */\n  command?: (\n    ctx: AcpHarnessContext<AcpCompatibleProviderOptions & TModelOptions>,\n  ) => string\n  /**\n   * Full transport escape hatch — open any {@link AcpSessionTransport} yourself\n   * (e.g. boot a `serve` process and connect over WebSocket, as Grok Build\n   * does). Overrides {@link command}. Put ALL teardown in the returned\n   * transport's `dispose` (stream) / process (stdio); it is disposed when the\n   * session ends.\n   */\n  openTransport?: (\n    ctx: AcpHarnessContext<AcpCompatibleProviderOptions & TModelOptions>,\n  ) => Promise<AcpSessionTransport> | AcpSessionTransport\n  /** Working directory inside the sandbox. Defaults to `/workspace`. */\n  cwd?: string\n  /**\n   * The harness's skills directory, relative to the workspace root (e.g.\n   * `'.pi/skills'`) — its native convention for where it auto-discovers skills,\n   * the way Claude Code uses `.claude/skills`. When set, `withSandbox` workspace\n   * `gitSkill`s are linked here. MCP skills don't need this: they're passed to\n   * the agent over ACP natively. Omit and `gitSkill`s are left unlinked (warned).\n   */\n  skillsDir?: string\n  /** Extra environment variables for the harness process. */\n  env?: Record<string, string>\n  /**\n   * ACP auth method to select before the session starts, when the harness\n   * advertises one (e.g. `'pi-api-key'`). Overridable per call via\n   * `modelOptions.authMethodId`.\n   */\n  authMethodId?: string\n  /** ACP permission policy. Defaults to `'bypassPermissions'`. */\n  permissionMode?: AcpPermissionMode\n  /**\n   * Permission strategy:\n   * - `'headless'` (default) — auto-resolve via {@link permissionMode}; the\n   *   sandbox is the boundary, so the agent runs without prompting.\n   * - `'interactive'` — same policy, but `ask`-style prompts emit an\n   *   approval-requested event so a client can approve and re-run.\n   */\n  permissions?: 'headless' | 'interactive'\n  /** Custom permission handler; overrides {@link permissions}/{@link permissionMode}. */\n  onPermissionRequest?: PermissionHandler\n  /** Message used for `RUN_ERROR` when the harness refuses a request. */\n  refusalMessage?: string\n  /** Emit ACP `plan` updates as a CUSTOM event under this name (off by default). */\n  planEventName?: string\n  /**\n   * After the run, emit the `git diff` of the working dir as a `file.changed`\n   * CUSTOM event. Requires a git repo at `cwd`. Off by default.\n   */\n  emitDiff?: boolean\n  /**\n   * Harness-specific JSON-RPC notifications (vendor `_x/...` extensions). Must\n   * return without throwing — unknown extensions must not tear down the session.\n   */\n  onExtNotification?: (method: string, params: Record<string, unknown>) => void\n  /**\n   * Convert chat history into the harness prompt + resume inputs. Defaults to\n   * {@link buildAcpPrompt} (trailing user message + flattened transcript).\n   */\n  buildPrompt?: (\n    messages: Array<ModelMessage>,\n    sessionId: string | undefined,\n  ) => BuiltAcpPrompt\n}\n\n/** Per-call provider options, passed via `modelOptions` on `chat()`. */\nexport interface AcpCompatibleProviderOptions {\n  /**\n   * Resume an existing harness session. The adapter emits the session id of\n   * every run via a CUSTOM `<name>.session-id` event; thread it back here to\n   * continue (only the trailing user message is sent).\n   */\n  sessionId?: string\n  /** Per-call override of the harness working directory. */\n  cwd?: string\n  /** Per-call override of the ACP auth method. */\n  authMethodId?: string\n  /** Per-call override of the ACP permission policy. */\n  permissionMode?: AcpPermissionMode\n}\n\n/** Per-call options the adapter sees: the base ACP options + the harness's own. */\ntype ResolvedOptions<TModelOptions extends Record<string, any>> =\n  AcpCompatibleProviderOptions & TModelOptions\n\nfunction q(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`\n}\n\nasync function disposeTransport(transport: AcpSessionTransport): Promise<void> {\n  if (transport.kind === 'stdio') {\n    await transport.process.kill()\n    return\n  }\n  await transport.dispose()\n}\n\n/**\n * A generic ACP harness adapter built from {@link AcpCompatibleConfig}. Runs the\n * configured coding-agent CLI inside the sandbox provided by `withSandbox(...)`\n * and translates its ACP session into AG-UI `StreamChunk`s.\n */\nexport class AcpCompatibleTextAdapter<\n  TModel extends string,\n  TModelOptions extends Record<string, any> = AcpCompatibleProviderOptions,\n> extends BaseTextAdapter<\n  TModel,\n  ResolvedOptions<TModelOptions>,\n  ReadonlyArray<Modality> & readonly ['text'],\n  DefaultMessageMetadataByModality,\n  ReadonlyArray<string>,\n  unknown,\n  never\n> {\n  override readonly name: string\n\n  override readonly requires = [SandboxCapability] as const\n\n  private readonly harness: AcpCompatibleConfig<\n    ReadonlyArray<string>,\n    TModelOptions\n  >\n\n  constructor(\n    config: AcpCompatibleConfig<ReadonlyArray<string>, TModelOptions>,\n    model: TModel,\n  ) {\n    super({}, model)\n    if (config.command === undefined && config.openTransport === undefined) {\n      throw new Error(\n        `acpCompatible(\"${config.name}\") needs either a \"command\" or an \"openTransport\".`,\n      )\n    }\n    this.harness = config\n    this.name = config.name\n  }\n\n  private sandboxFrom(\n    options: TextOptions<ResolvedOptions<TModelOptions>>,\n  ): SandboxHandle {\n    const ctx = options.capabilities\n    if (!ctx) {\n      throw new Error(\n        `Adapter \"${this.name}\" requires a sandbox. Add withSandbox(defineSandbox({ ... })) to chat() middleware.`,\n      )\n    }\n    return getSandbox(ctx)\n  }\n\n  private buildPrompt(\n    messages: Array<ModelMessage>,\n    sessionId: string | undefined,\n  ): BuiltAcpPrompt {\n    return this.harness.buildPrompt\n      ? this.harness.buildPrompt(messages, sessionId)\n      : buildAcpPrompt(messages, sessionId, this.name)\n  }\n\n  private applySystemPrompts(\n    systemPrompts: Array<string>,\n    prompt: string,\n  ): string {\n    if (systemPrompts.length === 0) return prompt\n    return `${systemPrompts.join('\\n\\n')}\\n\\n${prompt}`\n  }\n\n  private makePermissionHandler(input: {\n    mode: AcpPermissionMode\n    bridgedToolNames: ReadonlySet<string>\n    approvals: ReadonlyMap<string, boolean> | undefined\n    approvalRequests: Array<StreamChunk>\n    threadId: string\n    runId: string\n  }): PermissionHandler {\n    if (this.harness.onPermissionRequest)\n      return this.harness.onPermissionRequest\n\n    if (this.harness.permissions === 'interactive') {\n      return (request) => {\n        const result = resolveInteractivePermission(\n          request,\n          input.mode,\n          input.bridgedToolNames,\n          input.approvals,\n          this.name,\n        )\n        if (result.approvalId !== undefined) {\n          input.approvalRequests.push(\n            buildApprovalRequestedEvent({\n              approvalId: result.approvalId,\n              title:\n                result.title ??\n                request.toolCall.title ??\n                request.toolCall.toolCallId,\n              threadId: input.threadId,\n              runId: input.runId,\n              detail: { provider: this.name },\n            }),\n          )\n        }\n        return result.outcome\n      }\n    }\n\n    return (request) =>\n      resolvePermission(request, input.mode, input.bridgedToolNames)\n  }\n\n  async *chatStream(\n    options: TextOptions<ResolvedOptions<TModelOptions>>,\n  ): AsyncIterable<StreamChunk> {\n    const { logger } = options\n    let handle: AcpSessionHandle | undefined\n    let bridge: HostToolBridge | undefined\n    let transport: AcpSessionTransport | undefined\n    const externalSignal =\n      options.abortController?.signal ?? options.request?.signal ?? undefined\n    let onAbort: (() => void) | undefined\n\n    try {\n      const sandbox = this.sandboxFrom(options)\n      const modelOptions = options.modelOptions\n      const cwd = modelOptions?.cwd ?? this.harness.cwd ?? DEFAULT_WORKDIR\n      const harnessCwd = resolveHarnessCwd(sandbox, cwd)\n      const runId = options.runId ?? this.generateId()\n      const threadId = options.threadId ?? this.generateId()\n      const channel = createBridgeEventChannel({\n        model: this.model,\n        threadId,\n        runId,\n      })\n\n      const sessionId = modelOptions?.sessionId\n      const { prompt: resumePrompt } = this.buildPrompt(\n        options.messages,\n        sessionId,\n      )\n\n      // Bridge chat()-provided tools into the agent over MCP (ACP http server).\n      const bridgedToolNames = new Set(\n        (options.tools ?? []).map((tool) => tool.name),\n      )\n      if (options.tools && options.tools.length > 0) {\n        const provisioner =\n          (options.capabilities\n            ? getToolBridgeProvisioner(options.capabilities, { optional: true })\n            : undefined) ?? nodeHttpBridgeProvisioner\n        bridge = await provisioner.provision(options.tools, {\n          provider: sandbox.provider,\n          context: options.context,\n          emitCustomEvent: channel.emitCustomEvent,\n          ...(externalSignal ? { signal: externalSignal } : {}),\n        })\n      }\n\n      // Project workspace skills declared via withSandbox. MCP skills ride ACP's\n      // native `mcpServers` (below); gitSkills are linked into `skillsDir`.\n      let workspaceServers: Array<AcpMcpServer> = []\n      const projection = options.capabilities\n        ? getWorkspaceProjection(options.capabilities, { optional: true })\n        : undefined\n      if (projection !== undefined) {\n        await projectAcpWorkspace(sandbox, projection, {\n          ...(this.harness.skillsDir !== undefined && {\n            skillsDir: this.harness.skillsDir,\n          }),\n          harnessName: this.name,\n        })\n        workspaceServers = workspaceMcpServers(projection)\n      }\n\n      const ctx: AcpHarnessContext<ResolvedOptions<TModelOptions>> = {\n        sandbox,\n        model: this.model,\n        cwd,\n        harnessCwd,\n        env: this.harness.env,\n        modelOptions,\n        signal: externalSignal,\n      }\n      transport = this.harness.openTransport\n        ? await this.harness.openTransport(ctx)\n        : await this.openStdioTransport(ctx)\n\n      const mode =\n        modelOptions?.permissionMode ??\n        this.harness.permissionMode ??\n        'bypassPermissions'\n      const authMethodId =\n        modelOptions?.authMethodId ?? this.harness.authMethodId\n\n      const approvalRequests: Array<StreamChunk> = []\n      const permissionHandler = this.makePermissionHandler({\n        mode,\n        bridgedToolNames,\n        approvals: options.approvals,\n        approvalRequests,\n        threadId,\n        runId,\n      })\n\n      const queue = new AsyncQueue<AcpStreamEvent>()\n\n      logger.request(\n        `activity=chat provider=${this.name} model=${this.model} sandbox=${sandbox.provider} messages=${options.messages.length} resume=${sessionId ?? 'none'}`,\n        { provider: this.name, model: this.model },\n      )\n\n      // The host tool-bridge (chat() tools) + workspace MCP skills, both over\n      // ACP's native MCP channel.\n      const mcpServers: Array<AcpMcpServer> = [\n        ...(bridge !== undefined\n          ? [\n              {\n                name: bridge.name,\n                url: bridge.url,\n                headers: [\n                  { name: 'Authorization', value: `Bearer ${bridge.token}` },\n                ],\n              },\n            ]\n          : []),\n        ...workspaceServers,\n      ]\n\n      const onAcpUpdate = (update: AcpSessionUpdate) =>\n        queue.push({ kind: 'update', update })\n      handle = await startAcpSession({\n        transport,\n        cwd: harnessCwd,\n        ...(authMethodId !== undefined && { authMethodId }),\n        ...(sessionId !== undefined && { resumeSessionId: sessionId }),\n        ...(mcpServers.length > 0 && { mcpServers }),\n        onUpdate: onAcpUpdate,\n        ...(this.harness.onExtNotification && {\n          onExtNotification: this.harness.onExtNotification,\n        }),\n        onPermissionRequest: permissionHandler,\n      })\n      const session = handle\n\n      if (externalSignal !== undefined) {\n        onAbort = () => void session.cancel().catch(() => undefined)\n        if (externalSignal.aborted) onAbort()\n        else externalSignal.addEventListener('abort', onAbort, { once: true })\n      }\n\n      queue.push({ kind: 'session', sessionId: session.sessionId })\n\n      const systemPrompts = normalizeSystemPrompts(options.systemPrompts)\n        .map((p) => p.content)\n        .filter((c) => c.trim() !== '')\n      const promptText = this.applySystemPrompts(\n        systemPrompts,\n        session.resumed || sessionId === undefined\n          ? resumePrompt\n          : this.buildPrompt(options.messages, undefined).prompt,\n      )\n\n      session\n        .prompt(promptText)\n        .then(({ stopReason, usage }) => {\n          queue.push({\n            kind: 'done',\n            stopReason,\n            ...(usage !== undefined && { usage }),\n          })\n          queue.end()\n        })\n        .catch((error: unknown) => queue.fail(error))\n\n      yield* mergeChunkStreams(\n        translateAcpStream(queue, {\n          model: this.model,\n          runId,\n          threadId,\n          ...(options.parentRunId !== undefined && {\n            parentRunId: options.parentRunId,\n          }),\n          genId: () => this.generateId(),\n          bridgedToolNames,\n          labels: {\n            sessionIdEvent: `${this.name}.session-id`,\n            // Surface non-text agent content (image/audio/resource) instead of\n            // dropping it — emitted as a CUSTOM `<name>.message-content` event.\n            contentEvent: `${this.name}.message-content`,\n            ...(this.harness.planEventName !== undefined && {\n              planEvent: this.harness.planEventName,\n            }),\n            ...(this.harness.refusalMessage !== undefined && {\n              refusalMessage: this.harness.refusalMessage,\n            }),\n          },\n          onAcpEvent: (event) =>\n            logger.provider(`provider=${this.name} kind=${event.kind}`, {\n              chunk: event,\n            }),\n        }),\n        channel.stream,\n      )\n\n      // Surface any pending approval requests (interactive ask-policy actions\n      // awaiting a client decision); the client approves and re-runs to continue.\n      for (const event of approvalRequests) yield event\n\n      if (this.harness.emitDiff) {\n        yield* this.emitDiffChunks(sandbox, cwd, threadId, runId)\n      }\n    } catch (error: unknown) {\n      const err = error as Error & { code?: string }\n      const rawEvent = toRunErrorRawEvent(error)\n      logger.errors(`${this.name}.chatStream fatal`, {\n        error,\n        source: `${this.name}.chatStream`,\n      })\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: err.message || 'Unknown error occurred',\n        ...(err.code !== undefined && { code: err.code }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: err.message || 'Unknown error occurred',\n          ...(err.code !== undefined && { code: err.code }),\n        },\n      }\n    } finally {\n      if (externalSignal !== undefined && onAbort !== undefined) {\n        externalSignal.removeEventListener('abort', onAbort)\n      }\n      // startAcpSession owns transport teardown once a handle exists (and tears\n      // it down itself on a failed init). Only dispose here if we opened a\n      // transport but never reached a session.\n      if (handle !== undefined) await handle.dispose()\n      else if (transport !== undefined) await disposeTransport(transport)\n      await bridge?.close()\n    }\n  }\n\n  private async openStdioTransport(\n    ctx: AcpHarnessContext<ResolvedOptions<TModelOptions>>,\n  ): Promise<AcpSessionTransport> {\n    const build = this.harness.command\n    if (build === undefined) {\n      // Unreachable — the constructor requires `command` or `openTransport`,\n      // and this path only runs when `openTransport` is absent.\n      throw new Error(\n        `acpCompatible(\"${this.name}\") has no \"command\" to launch over stdio.`,\n      )\n    }\n    const command = build(ctx)\n    const proc = await ctx.sandbox.process.spawn(command, {\n      cwd: ctx.cwd,\n      ...(this.harness.env ? { env: this.harness.env } : {}),\n      ...(ctx.signal ? { signal: ctx.signal } : {}),\n    })\n    return { kind: 'stdio', process: proc }\n  }\n\n  private async *emitDiffChunks(\n    sandbox: SandboxHandle,\n    cwd: string,\n    threadId: string,\n    runId: string,\n  ): AsyncIterable<StreamChunk> {\n    try {\n      const diff = await sandbox.process.exec(`git -C ${q(cwd)} diff`, { cwd })\n      if (diff.exitCode === 0 && diff.stdout.trim() !== '') {\n        yield {\n          type: EventType.CUSTOM,\n          name: 'file.changed',\n          value: { path: '.', diff: diff.stdout },\n          timestamp: Date.now(),\n          threadId,\n          runId,\n        }\n      }\n    } catch {\n      // ignore — diff is best-effort\n    }\n  }\n\n  structuredOutput(\n    _options: StructuredOutputOptions<ResolvedOptions<TModelOptions>>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    return Promise.reject(\n      new Error(\n        `Structured output is not supported by the in-sandbox \"${this.name}\" ACP harness adapter. ` +\n          'Use a model adapter for structured output, or omit outputSchema.',\n      ),\n    )\n  }\n}\n\n/**\n * Configure an ACP-compatible harness once, then select a model per call.\n *\n * Mirrors `openaiCompatible`: it lets you plug ANY Agent Client Protocol agent\n * into a TanStack AI sandbox without a dedicated adapter package.\n *\n * @example\n * ```ts\n * import { acpCompatible } from '@tanstack/ai-acp'\n * import { chat } from '@tanstack/ai'\n * import { defineSandbox, withSandbox } from '@tanstack/ai-sandbox'\n *\n * const pi = acpCompatible({\n *   name: 'pi',\n *   // declaring `models` makes pi('…') type-safe; omit to accept any string\n *   models: ['pi-fast', 'pi-pro'],\n *   // declare per-call options; merged with the base ACP options and exposed\n *   // on ctx.modelOptions inside `command` / `openTransport`\n *   modelOptions: {} as { reasoningEffort?: 'low' | 'high' },\n *   command: ({ model, harnessCwd, modelOptions }) =>\n *     `pi --acp -m ${model} --cwd ${harnessCwd}` +\n *     (modelOptions?.reasoningEffort ? ` --effort ${modelOptions.reasoningEffort}` : ''),\n *   authMethodId: 'pi-api-key',\n * })\n *\n * chat({\n *   adapter: pi('pi-pro'),\n *   modelOptions: { reasoningEffort: 'high' }, // typed\n *   messages,\n *   middleware: [withSandbox(defineSandbox({ /* provider, install pi *\\/ }))],\n * })\n * ```\n */\nexport function acpCompatible<\n  const TModels extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TModelOptions extends Record<string, any> = AcpCompatibleProviderOptions,\n>(config: AcpCompatibleConfig<TModels, TModelOptions>) {\n  return <TModel extends AcpModelNameOf<TModels>>(\n    model: TModel,\n    overrides?: Partial<AcpCompatibleConfig<TModels, TModelOptions>>,\n  ): AcpCompatibleTextAdapter<TModel, TModelOptions> =>\n    new AcpCompatibleTextAdapter<TModel, TModelOptions>(\n      overrides ? { ...config, ...overrides } : config,\n      model,\n    )\n}\n\n/**\n * One-shot helper: build a single-model ACP-compatible harness adapter inline.\n *\n * @example\n * ```ts\n * chat({\n *   adapter: acpCompatibleText('pi-fast', {\n *     name: 'pi',\n *     command: ({ model }) => `pi --acp -m ${model}`,\n *   }),\n *   messages,\n *   middleware: [withSandbox(defineSandbox({ ... }))],\n * })\n * ```\n */\nexport function acpCompatibleText<\n  TModel extends string,\n  TModelOptions extends Record<string, any> = AcpCompatibleProviderOptions,\n>(\n  model: TModel,\n  config: AcpCompatibleConfig<ReadonlyArray<string>, TModelOptions>,\n): AcpCompatibleTextAdapter<TModel, TModelOptions> {\n  return new AcpCompatibleTextAdapter<TModel, TModelOptions>(config, model)\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/adapters/projection.d.ts

@@ -0,0 +1,29 @@
+import { SandboxHandle, WorkspaceProjection } from '@tanstack/ai-sandbox';
+/** ACP `newSession` MCP server descriptor (HTTP transport). */
+export interface AcpMcpServer {
+    name: string;
+    url: string;
+    headers: Array<{
+        name: string;
+        value: string;
+    }>;
+}
+/**
+ * Build ACP `mcpServers` entries from the workspace's `mcp` skills, resolving
+ * every header value (SecretRef / bearer / plain string). Returns `[]` when
+ * there are no MCP skills. Pass the result to `startAcpSession({ mcpServers })`.
+ */
+export declare function workspaceMcpServers(projection: WorkspaceProjection): Array<AcpMcpServer>;
+/**
+ * Project the non-MCP parts of a workspace into an ACP harness. Links each
+ * cloned `gitSkill` repo into the harness's skills directory when one is
+ * declared; warns and skips `agentSkill`s, `plugin`s, and (when no `skillsDir`
+ * is configured) `gitSkill`s. Idempotent — gated by the projection marker.
+ *
+ * MCP skills are NOT handled here; pass {@link workspaceMcpServers} to the ACP
+ * session instead.
+ */
+export declare function projectAcpWorkspace(handle: SandboxHandle, projection: WorkspaceProjection, options: {
+    skillsDir?: string;
+    harnessName: string;
+}): Promise<void>;

package/dist/esm/adapters/projection.js

@@ -0,0 +1,83 @@
+import { resolveGitSkillDir, isSecretRef } from "@tanstack/ai-sandbox";
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function basenameOf(path) {
+  const segments = path.split("/").filter((segment) => segment !== "");
+  return segments[segments.length - 1] ?? path;
+}
+function relativeToRoot(root, p) {
+  return p.startsWith(`${root}/`) ? p.slice(root.length + 1) : p;
+}
+function isBearerMarker(value) {
+  return typeof value === "object" && value !== null && isSecretRef(value.__bearerRef);
+}
+function resolveHeaderValue(value, resolveSecret) {
+  if (isSecretRef(value)) return resolveSecret(value);
+  if (isBearerMarker(value)) return `Bearer ${resolveSecret(value.__bearerRef)}`;
+  return value;
+}
+function workspaceMcpServers(projection) {
+  const servers = [];
+  for (const skill of projection.skills) {
+    if (skill.kind !== "mcp") continue;
+    const rawUrl = skill.config["url"];
+    const url = typeof rawUrl === "string" ? rawUrl : "";
+    const headers = Object.entries(skill.config.headers ?? {}).map(
+      ([name, value]) => ({
+        name,
+        value: resolveHeaderValue(value, projection.resolveSecret)
+      })
+    );
+    servers.push({ name: skill.name, url, headers });
+  }
+  return servers;
+}
+async function projectAcpWorkspace(handle, projection, options) {
+  if (await handle.fs.exists(projection.markerPath)) return;
+  const { skillsDir, harnessName } = options;
+  const gitSkills = projection.skills.filter((skill) => skill.kind === "git");
+  if (gitSkills.length > 0) {
+    if (skillsDir === void 0) {
+      for (const skill of gitSkills) {
+        console.warn(
+          `[${harnessName}] gitSkill "${skill.repo}" cannot be projected: this harness declares no \`skillsDir\`. The clone is still available under the workspace, but the harness will not auto-discover it. Skipping link.`
+        );
+      }
+    } else {
+      await handle.fs.mkdir(`${projection.root}/${skillsDir}`);
+      for (const skill of gitSkills) {
+        const source = skill.into ?? resolveGitSkillDir(projection.root, skill);
+        const relSource = relativeToRoot(projection.root, source);
+        const relTarget = `${skillsDir}/${basenameOf(source)}`;
+        const cp = await handle.process.exec(
+          `cp -r ${shellQuote(relSource)} ${shellQuote(relTarget)}`,
+          { cwd: projection.root }
+        );
+        if (cp.exitCode !== 0) {
+          console.warn(
+            `[${harnessName}] failed to copy gitSkill "${skill.repo}" into ${relTarget}: ${cp.stderr.trim()}`
+          );
+        }
+      }
+    }
+  }
+  for (const skill of projection.skills) {
+    if (skill.kind === "agent-skill") {
+      console.warn(
+        `[${harnessName}] agentSkill "${skill.name}" cannot be projected: there is no generic ACP primitive to install a skill by bare name. Provide it as a gitSkill instead. Skipping.`
+      );
+    }
+  }
+  for (const name of projection.plugins) {
+    console.warn(
+      `[${harnessName}] plugin "${name}" cannot be projected: ACP has no generic plugin concept. Provide its functionality as a gitSkill or MCP server. Skipping.`
+    );
+  }
+  await handle.fs.write(projection.markerPath, "");
+}
+export {
+  projectAcpWorkspace,
+  workspaceMcpServers
+};
+//# sourceMappingURL=projection.js.map

package/dist/esm/adapters/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sources":["../../../src/adapters/projection.ts"],"sourcesContent":["/**\n * Generic workspace projector for ACP harnesses.\n *\n * `withSandbox` surfaces a portable {@link WorkspaceProjection} (skills, plugins,\n * a secret resolver, a one-time marker path) via a capability. Most of it maps\n * onto ACP natively:\n *\n *   - **MCP skills** → passed straight through ACP's `newSession` `mcpServers`\n *     (see {@link workspaceMcpServers}); no config file is written, because an\n *     ACP agent receives MCP servers over the protocol. This is the key\n *     difference from file-based harnesses (Claude Code, Codex) that read MCP\n *     from disk.\n *   - **gitSkill repos** → linked into the harness's skills directory (when the\n *     harness declares one via `skillsDir`, e.g. `.pi/skills`).\n *   - **agentSkill / plugins** → no generic ACP primitive, so we warn-and-skip.\n *\n * `fileSkill` and `instructions` are already written by the provider-agnostic\n * bootstrap (into the workspace root + `AGENTS.md`), so they need no projection.\n */\nimport { isSecretRef, resolveGitSkillDir } from '@tanstack/ai-sandbox'\nimport type {\n  BearerRef,\n  SandboxHandle,\n  SecretRef,\n  WorkspaceProjection,\n} from '@tanstack/ai-sandbox'\n\n/** ACP `newSession` MCP server descriptor (HTTP transport). */\nexport interface AcpMcpServer {\n  name: string\n  url: string\n  headers: Array<{ name: string; value: string }>\n}\n\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`\n}\n\nfunction basenameOf(path: string): string {\n  const segments = path.split('/').filter((segment) => segment !== '')\n  return segments[segments.length - 1] ?? path\n}\n\n/**\n * Make a sandbox path relative to the workspace root, so shell commands work on\n * every provider. Only `fs.*` remaps the virtual `/workspace`; a raw `/workspace`\n * in a shell command is the real path in a container but a non-existent absolute\n * path on local-process. Running relative to the root (the exec cwd) is correct\n * everywhere.\n */\nfunction relativeToRoot(root: string, p: string): string {\n  return p.startsWith(`${root}/`) ? p.slice(root.length + 1) : p\n}\n\nfunction isBearerMarker(value: unknown): value is BearerRef {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    isSecretRef((value as { __bearerRef?: unknown }).__bearerRef)\n  )\n}\n\nfunction resolveHeaderValue(\n  value: string | SecretRef | BearerRef,\n  resolveSecret: (ref: SecretRef) => string,\n): string {\n  if (isSecretRef(value)) return resolveSecret(value)\n  if (isBearerMarker(value)) return `Bearer ${resolveSecret(value.__bearerRef)}`\n  return value\n}\n\n/**\n * Build ACP `mcpServers` entries from the workspace's `mcp` skills, resolving\n * every header value (SecretRef / bearer / plain string). Returns `[]` when\n * there are no MCP skills. Pass the result to `startAcpSession({ mcpServers })`.\n */\nexport function workspaceMcpServers(\n  projection: WorkspaceProjection,\n): Array<AcpMcpServer> {\n  const servers: Array<AcpMcpServer> = []\n  for (const skill of projection.skills) {\n    if (skill.kind !== 'mcp') continue\n    const rawUrl = skill.config['url']\n    const url = typeof rawUrl === 'string' ? rawUrl : ''\n    const headers = Object.entries(skill.config.headers ?? {}).map(\n      ([name, value]) => ({\n        name,\n        value: resolveHeaderValue(value, projection.resolveSecret),\n      }),\n    )\n    servers.push({ name: skill.name, url, headers })\n  }\n  return servers\n}\n\n/**\n * Project the non-MCP parts of a workspace into an ACP harness. Links each\n * cloned `gitSkill` repo into the harness's skills directory when one is\n * declared; warns and skips `agentSkill`s, `plugin`s, and (when no `skillsDir`\n * is configured) `gitSkill`s. Idempotent — gated by the projection marker.\n *\n * MCP skills are NOT handled here; pass {@link workspaceMcpServers} to the ACP\n * session instead.\n */\nexport async function projectAcpWorkspace(\n  handle: SandboxHandle,\n  projection: WorkspaceProjection,\n  options: { skillsDir?: string; harnessName: string },\n): Promise<void> {\n  // Idempotent, non-secret operations only — gate on the one-time marker.\n  if (await handle.fs.exists(projection.markerPath)) return\n\n  const { skillsDir, harnessName } = options\n  const gitSkills = projection.skills.filter((skill) => skill.kind === 'git')\n\n  if (gitSkills.length > 0) {\n    if (skillsDir === undefined) {\n      for (const skill of gitSkills) {\n        console.warn(\n          `[${harnessName}] gitSkill \"${skill.repo}\" cannot be projected: this ` +\n            'harness declares no `skillsDir`. The clone is still available under ' +\n            'the workspace, but the harness will not auto-discover it. Skipping link.',\n        )\n      }\n    } else {\n      // Create the skills dir via fs (which remaps the virtual root), then copy\n      // each clone in with paths relative to the exec cwd (the workspace root)\n      // so the shell command resolves on every provider.\n      await handle.fs.mkdir(`${projection.root}/${skillsDir}`)\n      for (const skill of gitSkills) {\n        const source = skill.into ?? resolveGitSkillDir(projection.root, skill)\n        const relSource = relativeToRoot(projection.root, source)\n        const relTarget = `${skillsDir}/${basenameOf(source)}`\n        const cp = await handle.process.exec(\n          `cp -r ${shellQuote(relSource)} ${shellQuote(relTarget)}`,\n          { cwd: projection.root },\n        )\n        if (cp.exitCode !== 0) {\n          console.warn(\n            `[${harnessName}] failed to copy gitSkill \"${skill.repo}\" into ${relTarget}: ${cp.stderr.trim()}`,\n          )\n        }\n      }\n    }\n  }\n\n  for (const skill of projection.skills) {\n    if (skill.kind === 'agent-skill') {\n      console.warn(\n        `[${harnessName}] agentSkill \"${skill.name}\" cannot be projected: there is ` +\n          'no generic ACP primitive to install a skill by bare name. Provide it as ' +\n          'a gitSkill instead. Skipping.',\n      )\n    }\n  }\n  for (const name of projection.plugins) {\n    console.warn(\n      `[${harnessName}] plugin \"${name}\" cannot be projected: ACP has no generic ` +\n        'plugin concept. Provide its functionality as a gitSkill or MCP server. Skipping.',\n    )\n  }\n\n  await handle.fs.write(projection.markerPath, '')\n}\n"],"names":[],"mappings":";AAkCA,SAAS,WAAW,OAAuB;AACzC,SAAO,IAAI,MAAM,QAAQ,MAAM,OAAO,CAAC;AACzC;AAEA,SAAS,WAAW,MAAsB;AACxC,QAAM,WAAW,KAAK,MAAM,GAAG,EAAE,OAAO,CAAC,YAAY,YAAY,EAAE;AACnE,SAAO,SAAS,SAAS,SAAS,CAAC,KAAK;AAC1C;AASA,SAAS,eAAe,MAAc,GAAmB;AACvD,SAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,IAAI;AAC/D;AAEA,SAAS,eAAe,OAAoC;AAC1D,SACE,OAAO,UAAU,YACjB,UAAU,QACV,YAAa,MAAoC,WAAW;AAEhE;AAEA,SAAS,mBACP,OACA,eACQ;AACR,MAAI,YAAY,KAAK,EAAG,QAAO,cAAc,KAAK;AAClD,MAAI,eAAe,KAAK,EAAG,QAAO,UAAU,cAAc,MAAM,WAAW,CAAC;AAC5E,SAAO;AACT;AAOO,SAAS,oBACd,YACqB;AACrB,QAAM,UAA+B,CAAA;AACrC,aAAW,SAAS,WAAW,QAAQ;AACrC,QAAI,MAAM,SAAS,MAAO;AAC1B,UAAM,SAAS,MAAM,OAAO,KAAK;AACjC,UAAM,MAAM,OAAO,WAAW,WAAW,SAAS;AAClD,UAAM,UAAU,OAAO,QAAQ,MAAM,OAAO,WAAW,CAAA,CAAE,EAAE;AAAA,MACzD,CAAC,CAAC,MAAM,KAAK,OAAO;AAAA,QAClB;AAAA,QACA,OAAO,mBAAmB,OAAO,WAAW,aAAa;AAAA,MAAA;AAAA,IAC3D;AAEF,YAAQ,KAAK,EAAE,MAAM,MAAM,MAAM,KAAK,SAAS;AAAA,EACjD;AACA,SAAO;AACT;AAWA,eAAsB,oBACpB,QACA,YACA,SACe;AAEf,MAAI,MAAM,OAAO,GAAG,OAAO,WAAW,UAAU,EAAG;AAEnD,QAAM,EAAE,WAAW,YAAA,IAAgB;AACnC,QAAM,YAAY,WAAW,OAAO,OAAO,CAAC,UAAU,MAAM,SAAS,KAAK;AAE1E,MAAI,UAAU,SAAS,GAAG;AACxB,QAAI,cAAc,QAAW;AAC3B,iBAAW,SAAS,WAAW;AAC7B,gBAAQ;AAAA,UACN,IAAI,WAAW,eAAe,MAAM,IAAI;AAAA,QAAA;AAAA,MAI5C;AAAA,IACF,OAAO;AAIL,YAAM,OAAO,GAAG,MAAM,GAAG,WAAW,IAAI,IAAI,SAAS,EAAE;AACvD,iBAAW,SAAS,WAAW;AAC7B,cAAM,SAAS,MAAM,QAAQ,mBAAmB,WAAW,MAAM,KAAK;AACtE,cAAM,YAAY,eAAe,WAAW,MAAM,MAAM;AACxD,cAAM,YAAY,GAAG,SAAS,IAAI,WAAW,MAAM,CAAC;AACpD,cAAM,KAAK,MAAM,OAAO,QAAQ;AAAA,UAC9B,SAAS,WAAW,SAAS,CAAC,IAAI,WAAW,SAAS,CAAC;AAAA,UACvD,EAAE,KAAK,WAAW,KAAA;AAAA,QAAK;AAEzB,YAAI,GAAG,aAAa,GAAG;AACrB,kBAAQ;AAAA,YACN,IAAI,WAAW,8BAA8B,MAAM,IAAI,UAAU,SAAS,KAAK,GAAG,OAAO,KAAA,CAAM;AAAA,UAAA;AAAA,QAEnG;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,aAAW,SAAS,WAAW,QAAQ;AACrC,QAAI,MAAM,SAAS,eAAe;AAChC,cAAQ;AAAA,QACN,IAAI,WAAW,iBAAiB,MAAM,IAAI;AAAA,MAAA;AAAA,IAI9C;AAAA,EACF;AACA,aAAW,QAAQ,WAAW,SAAS;AACrC,YAAQ;AAAA,MACN,IAAI,WAAW,aAAa,IAAI;AAAA,IAAA;AAAA,EAGpC;AAEA,QAAM,OAAO,GAAG,MAAM,WAAW,YAAY,EAAE;AACjD;"}

package/dist/esm/index.d.ts

@@ -0,0 +1,21 @@
+export type { AcpContentBlock, AcpPermissionMode, AcpPermissionOption, AcpPermissionOutcome, AcpPermissionRequest, AcpSessionUpdate, AcpStopReason, AcpToolCallStatus, AcpToolCallUpdate, AcpUsage, PermissionHandler, } from './types/acp-types.js';
+export { AsyncQueue } from './stream/queue.js';
+export { BRIDGED_MCP_SERVER_NAME, matchBridgedToolName, translateAcpStream, } from './stream/translate.js';
+export type { AcpStreamEvent, AcpTranslateLabels, TranslateContext, } from './stream/translate.js';
+export type { AcpByteTransport, AcpJsonRpcStream, AcpMessageFraming, AcpSessionTransport, AcpTransportPreference, } from './transport/types.js';
+export { spawnHandleToAcpTransport } from './transport/stdio.js';
+export type { AcpByteTransport as AcpTransport } from './transport/types.js';
+export { connectAcpWebSocket, httpChannelUrlToWsBase, webSocketFrameToAcpStream, } from './transport/websocket.js';
+export type { AcpWebSocketConnection, ConnectAcpWebSocketOptions, } from './transport/websocket.js';
+export { resolveAcpTransportMode } from './transport/resolve.js';
+export { buildGrokServeWebSocketUrl, parseWebSocketUrlFromServeOutput, startAcpServerInSandbox, } from './session/sandbox-server.js';
+export type { AcpSandboxServer, StartAcpServerOptions, } from './session/sandbox-server.js';
+export { startAcpSession } from './session/acp-client.js';
+export type { AcpSessionHandle, StartAcpSessionOptions, } from './session/acp-client.js';
+export { resolveInteractivePermission, resolvePermission } from './permissions.js';
+export { AcpCompatibleTextAdapter, acpCompatible, acpCompatibleText, } from './adapters/compatible.js';
+export type { AcpCompatibleConfig, AcpCompatibleProviderOptions, AcpHarnessContext, AcpModelNameOf, } from './adapters/compatible.js';
+export { buildAcpPrompt } from './messages/prompt.js';
+export type { BuiltAcpPrompt } from './messages/prompt.js';
+export { projectAcpWorkspace, workspaceMcpServers } from './adapters/projection.js';
+export type { AcpMcpServer } from './adapters/projection.js';

package/dist/esm/index.js

@@ -0,0 +1,35 @@
+import { AsyncQueue } from "./stream/queue.js";
+import { BRIDGED_MCP_SERVER_NAME, matchBridgedToolName, translateAcpStream } from "./stream/translate.js";
+import { spawnHandleToAcpTransport } from "./transport/stdio.js";
+import { connectAcpWebSocket, httpChannelUrlToWsBase, webSocketFrameToAcpStream } from "./transport/websocket.js";
+import { resolveAcpTransportMode } from "./transport/resolve.js";
+import { buildGrokServeWebSocketUrl, parseWebSocketUrlFromServeOutput, startAcpServerInSandbox } from "./session/sandbox-server.js";
+import { startAcpSession } from "./session/acp-client.js";
+import { resolveInteractivePermission, resolvePermission } from "./permissions.js";
+import { AcpCompatibleTextAdapter, acpCompatible, acpCompatibleText } from "./adapters/compatible.js";
+import { buildAcpPrompt } from "./messages/prompt.js";
+import { projectAcpWorkspace, workspaceMcpServers } from "./adapters/projection.js";
+export {
+  AcpCompatibleTextAdapter,
+  AsyncQueue,
+  BRIDGED_MCP_SERVER_NAME,
+  acpCompatible,
+  acpCompatibleText,
+  buildAcpPrompt,
+  buildGrokServeWebSocketUrl,
+  connectAcpWebSocket,
+  httpChannelUrlToWsBase,
+  matchBridgedToolName,
+  parseWebSocketUrlFromServeOutput,
+  projectAcpWorkspace,
+  resolveAcpTransportMode,
+  resolveInteractivePermission,
+  resolvePermission,
+  spawnHandleToAcpTransport,
+  startAcpServerInSandbox,
+  startAcpSession,
+  translateAcpStream,
+  webSocketFrameToAcpStream,
+  workspaceMcpServers
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/esm/messages/prompt.d.ts

@@ -0,0 +1,19 @@
+import { ModelMessage } from '@tanstack/ai';
+export interface BuiltAcpPrompt {
+    prompt: string;
+    /** Harness session id to resume, when the caller threaded one through. */
+    resume?: string;
+}
+/**
+ * Convert TanStack chat history into a harness prompt + resume inputs.
+ *
+ * With a `sessionId`, the harness already holds the conversation context, so
+ * only the trailing user message is sent and the session is resumed. Without
+ * one, prior user/assistant turns are flattened into a plain-text transcript
+ * preamble (tool messages and tool-call-only assistant turns are
+ * harness-internal noise and are skipped; prompts are text-only).
+ *
+ * Shared default for ACP harness adapters; pass a custom `buildPrompt` to
+ * {@link acpCompatible} to override.
+ */
+export declare function buildAcpPrompt(messages: Array<ModelMessage>, sessionId: string | undefined, harnessName?: string): BuiltAcpPrompt;

package/dist/esm/messages/prompt.js

@@ -0,0 +1,37 @@
+function extractText(content) {
+  if (content === null) return "";
+  if (typeof content === "string") return content;
+  return content.map(
+    (part) => part.type === "text" && typeof part.content === "string" ? part.content : ""
+  ).join("");
+}
+function buildAcpPrompt(messages, sessionId, harnessName = "ACP harness") {
+  const lastMessage = messages.at(-1);
+  const lastUserText = lastMessage?.role === "user" ? extractText(lastMessage.content).trim() : "";
+  if (!lastUserText) {
+    throw new Error(
+      `${harnessName} adapter requires a trailing user message with text content.`
+    );
+  }
+  if (sessionId !== void 0) {
+    return { prompt: lastUserText, resume: sessionId };
+  }
+  const priorTurns = messages.slice(0, -1).filter(
+    (message) => (message.role === "user" || message.role === "assistant") && extractText(message.content).trim() !== ""
+  ).map(
+    (message) => `${message.role === "user" ? "User" : "Assistant"}: ${extractText(message.content).trim()}`
+  );
+  if (priorTurns.length === 0) {
+    return { prompt: lastUserText };
+  }
+  return {
+    prompt: `Previous conversation:
+${priorTurns.join("\n")}
+
+${lastUserText}`
+  };
+}
+export {
+  buildAcpPrompt
+};
+//# sourceMappingURL=prompt.js.map

package/dist/esm/messages/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sources":["../../../src/messages/prompt.ts"],"sourcesContent":["import type { ModelMessage } from '@tanstack/ai'\n\nexport interface BuiltAcpPrompt {\n  prompt: string\n  /** Harness session id to resume, when the caller threaded one through. */\n  resume?: string\n}\n\nfunction extractText(content: ModelMessage['content']): string {\n  if (content === null) return ''\n  if (typeof content === 'string') return content\n  return content\n    .map((part) =>\n      part.type === 'text' && typeof part.content === 'string'\n        ? part.content\n        : '',\n    )\n    .join('')\n}\n\n/**\n * Convert TanStack chat history into a harness prompt + resume inputs.\n *\n * With a `sessionId`, the harness already holds the conversation context, so\n * only the trailing user message is sent and the session is resumed. Without\n * one, prior user/assistant turns are flattened into a plain-text transcript\n * preamble (tool messages and tool-call-only assistant turns are\n * harness-internal noise and are skipped; prompts are text-only).\n *\n * Shared default for ACP harness adapters; pass a custom `buildPrompt` to\n * {@link acpCompatible} to override.\n */\nexport function buildAcpPrompt(\n  messages: Array<ModelMessage>,\n  sessionId: string | undefined,\n  harnessName = 'ACP harness',\n): BuiltAcpPrompt {\n  const lastMessage = messages.at(-1)\n  const lastUserText =\n    lastMessage?.role === 'user' ? extractText(lastMessage.content).trim() : ''\n\n  if (!lastUserText) {\n    throw new Error(\n      `${harnessName} adapter requires a trailing user message with text content.`,\n    )\n  }\n\n  if (sessionId !== undefined) {\n    return { prompt: lastUserText, resume: sessionId }\n  }\n\n  const priorTurns = messages\n    .slice(0, -1)\n    .filter(\n      (message) =>\n        (message.role === 'user' || message.role === 'assistant') &&\n        extractText(message.content).trim() !== '',\n    )\n    .map(\n      (message) =>\n        `${message.role === 'user' ? 'User' : 'Assistant'}: ${extractText(message.content).trim()}`,\n    )\n\n  if (priorTurns.length === 0) {\n    return { prompt: lastUserText }\n  }\n\n  return {\n    prompt: `Previous conversation:\\n${priorTurns.join('\\n')}\\n\\n${lastUserText}`,\n  }\n}\n"],"names":[],"mappings":"AAQA,SAAS,YAAY,SAA0C;AAC7D,MAAI,YAAY,KAAM,QAAO;AAC7B,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,SAAO,QACJ;AAAA,IAAI,CAAC,SACJ,KAAK,SAAS,UAAU,OAAO,KAAK,YAAY,WAC5C,KAAK,UACL;AAAA,EAAA,EAEL,KAAK,EAAE;AACZ;AAcO,SAAS,eACd,UACA,WACA,cAAc,eACE;AAChB,QAAM,cAAc,SAAS,GAAG,EAAE;AAClC,QAAM,eACJ,aAAa,SAAS,SAAS,YAAY,YAAY,OAAO,EAAE,KAAA,IAAS;AAE3E,MAAI,CAAC,cAAc;AACjB,UAAM,IAAI;AAAA,MACR,GAAG,WAAW;AAAA,IAAA;AAAA,EAElB;AAEA,MAAI,cAAc,QAAW;AAC3B,WAAO,EAAE,QAAQ,cAAc,QAAQ,UAAA;AAAA,EACzC;AAEA,QAAM,aAAa,SAChB,MAAM,GAAG,EAAE,EACX;AAAA,IACC,CAAC,aACE,QAAQ,SAAS,UAAU,QAAQ,SAAS,gBAC7C,YAAY,QAAQ,OAAO,EAAE,WAAW;AAAA,EAAA,EAE3C;AAAA,IACC,CAAC,YACC,GAAG,QAAQ,SAAS,SAAS,SAAS,WAAW,KAAK,YAAY,QAAQ,OAAO,EAAE,MAAM;AAAA,EAAA;AAG/F,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO,EAAE,QAAQ,aAAA;AAAA,EACnB;AAEA,SAAO;AAAA,IACL,QAAQ;AAAA,EAA2B,WAAW,KAAK,IAAI,CAAC;AAAA;AAAA,EAAO,YAAY;AAAA,EAAA;AAE/E;"}