@tanstack/ai-acp 0.2.2 → 0.2.4

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

@@ -1 +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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"}
+{"version":3,"file":"compatible.js","names":[],"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  DurableAttachNotSupportedError,\n  SandboxCapability,\n  buildApprovalRequestedEvent,\n  createBridgeEventChannel,\n  getSandbox,\n  getSandboxDurability,\n  getToolBridgeProvisioner,\n  getWorkspaceProjection,\n  mergeChunkStreams,\n  nodeHttpBridgeProvisioner,\n  resolveDurableRunId,\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      // This adapter does not journal yet, so a generated id is still fine.\n      // Routed through the helper anyway so that whenever it gains journaling\n      // it inherits the caller-supplied-runId requirement instead of\n      // re-deriving it (see `packages/ai-sandbox/src/durability.ts`).\n      const runId = resolveDurableRunId(options.runId, {\n        durable: false,\n        adapter: 'acp',\n        fallback: () => this.generateId(),\n      })\n      const threadId = options.threadId ?? this.generateId()\n\n      // Durability wired onto a path that cannot deliver it. Two outcomes, split\n      // by whether a first attempt has already run.\n      //\n      // ATTACH is fatal. `sandboxRunDriver`'s `drive()` sets `attach: true` only\n      // when a previous host was already streaming this run, so continuing past\n      // here reaches `startAcpSession` + `session.prompt(...)` and re-runs the\n      // agent from scratch against the workspace that attempt already mutated,\n      // appending its whole output to a log that still holds the first\n      // attempt's. This adapter has no journal to tail, no\n      // `awaitAttachableJournal` to refuse the attach up front, and no\n      // `alignedIfAttaching` to suppress the already-delivered prefix — so there\n      // is nothing between here and that corruption except this throw.\n      //\n      // A FRESH durable run only fails to be recoverable LATER, which an app may\n      // knowingly accept (it can wire `withSandbox({ runs, durability })` once at\n      // the middleware level and still route some runs through this adapter). So\n      // that is a warn, not a throw: audible, not fatal. Once per run, not per\n      // chunk — a per-chunk warning would be worse than none. Mirrors\n      // `ai-grok-build`'s `chatStreamAcp`.\n      const durability = options.capabilities\n        ? getSandboxDurability(options.capabilities, { optional: true })\n        : undefined\n      if (durability !== undefined) {\n        if (durability.attach) {\n          throw new DurableAttachNotSupportedError(\n            'acp',\n            'this adapter drives the harness over a bidirectional ACP ' +\n              'connection and does not journal',\n          )\n        }\n        logger.warn(\n          'acp: sandbox durability is wired but this adapter never journals — ' +\n            'this run will not be recoverable on reconnect. Use a journaling ' +\n            'harness adapter for runs that must survive a host restart, or drop ' +\n            'durability if these runs are not meant to.',\n          { runId, adapter: 'acp' },\n        )\n      }\n\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"],"mappings":"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"}

package/dist/esm/adapters/projection.js

@@ -1,83 +1,101 @@
-import { resolveGitSkillDir, isSecretRef } from "@tanstack/ai-sandbox";
+import { isSecretRef, resolveGitSkillDir } from "@tanstack/ai-sandbox";
+//#region src/adapters/projection.ts
+/**
+* Generic workspace projector for ACP harnesses.
+*
+* `withSandbox` surfaces a portable {@link WorkspaceProjection} (skills, plugins,
+* a secret resolver, a one-time marker path) via a capability. Most of it maps
+* onto ACP natively:
+*
+*   - **MCP skills** → passed straight through ACP's `newSession` `mcpServers`
+*     (see {@link workspaceMcpServers}); no config file is written, because an
+*     ACP agent receives MCP servers over the protocol. This is the key
+*     difference from file-based harnesses (Claude Code, Codex) that read MCP
+*     from disk.
+*   - **gitSkill repos** → linked into the harness's skills directory (when the
+*     harness declares one via `skillsDir`, e.g. `.pi/skills`).
+*   - **agentSkill / plugins** → no generic ACP primitive, so we warn-and-skip.
+*
+* `fileSkill` and `instructions` are already written by the provider-agnostic
+* bootstrap (into the workspace root + `AGENTS.md`), so they need no projection.
+*/
 function shellQuote(value) {
-  return `'${value.replace(/'/g, `'\\''`)}'`;
+	return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 function basenameOf(path) {
-  const segments = path.split("/").filter((segment) => segment !== "");
-  return segments[segments.length - 1] ?? path;
+	const segments = path.split("/").filter((segment) => segment !== "");
+	return segments[segments.length - 1] ?? path;
 }
+/**
+* Make a sandbox path relative to the workspace root, so shell commands work on
+* every provider. Only `fs.*` remaps the virtual `/workspace`; a raw `/workspace`
+* in a shell command is the real path in a container but a non-existent absolute
+* path on local-process. Running relative to the root (the exec cwd) is correct
+* everywhere.
+*/
 function relativeToRoot(root, p) {
-  return p.startsWith(`${root}/`) ? p.slice(root.length + 1) : p;
+	return p.startsWith(`${root}/`) ? p.slice(root.length + 1) : p;
 }
 function isBearerMarker(value) {
-  return typeof value === "object" && value !== null && isSecretRef(value.__bearerRef);
+	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;
+	if (isSecretRef(value)) return resolveSecret(value);
+	if (isBearerMarker(value)) return `Bearer ${resolveSecret(value.__bearerRef)}`;
+	return value;
 }
+/**
+* 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 })`.
+*/
 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;
+	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;
 }
+/**
+* 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.
+*/
 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, "");
+	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
+//#endregion
+export { projectAcpWorkspace, workspaceMcpServers };
+
+//# sourceMappingURL=projection.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"projection.js","names":[],"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"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkCA,SAAS,WAAW,OAAuB;CACzC,OAAO,IAAI,MAAM,QAAQ,MAAM,OAAO,EAAE;AAC1C;AAEA,SAAS,WAAW,MAAsB;CACxC,MAAM,WAAW,KAAK,MAAM,GAAG,CAAC,CAAC,QAAQ,YAAY,YAAY,EAAE;CACnE,OAAO,SAAS,SAAS,SAAS,MAAM;AAC1C;;;;;;;;AASA,SAAS,eAAe,MAAc,GAAmB;CACvD,OAAO,EAAE,WAAW,GAAG,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,IAAI;AAC/D;AAEA,SAAS,eAAe,OAAoC;CAC1D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,YAAa,MAAoC,WAAW;AAEhE;AAEA,SAAS,mBACP,OACA,eACQ;CACR,IAAI,YAAY,KAAK,GAAG,OAAO,cAAc,KAAK;CAClD,IAAI,eAAe,KAAK,GAAG,OAAO,UAAU,cAAc,MAAM,WAAW;CAC3E,OAAO;AACT;;;;;;AAOA,SAAgB,oBACd,YACqB;CACrB,MAAM,UAA+B,CAAC;CACtC,KAAK,MAAM,SAAS,WAAW,QAAQ;EACrC,IAAI,MAAM,SAAS,OAAO;EAC1B,MAAM,SAAS,MAAM,OAAO;EAC5B,MAAM,MAAM,OAAO,WAAW,WAAW,SAAS;EAClD,MAAM,UAAU,OAAO,QAAQ,MAAM,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,KACxD,CAAC,MAAM,YAAY;GAClB;GACA,OAAO,mBAAmB,OAAO,WAAW,aAAa;EAC3D,EACF;EACA,QAAQ,KAAK;GAAE,MAAM,MAAM;GAAM;GAAK;EAAQ,CAAC;CACjD;CACA,OAAO;AACT;;;;;;;;;;AAWA,eAAsB,oBACpB,QACA,YACA,SACe;CAEf,IAAI,MAAM,OAAO,GAAG,OAAO,WAAW,UAAU,GAAG;CAEnD,MAAM,EAAE,WAAW,gBAAgB;CACnC,MAAM,YAAY,WAAW,OAAO,QAAQ,UAAU,MAAM,SAAS,KAAK;CAE1E,IAAI,UAAU,SAAS,GACrB,IAAI,cAAc,KAAA,GAChB,KAAK,MAAM,SAAS,WAClB,QAAQ,KACN,IAAI,YAAY,cAAc,MAAM,KAAK,2KAG3C;MAEG;EAIL,MAAM,OAAO,GAAG,MAAM,GAAG,WAAW,KAAK,GAAG,WAAW;EACvD,KAAK,MAAM,SAAS,WAAW;GAC7B,MAAM,SAAS,MAAM,QAAQ,mBAAmB,WAAW,MAAM,KAAK;GACtE,MAAM,YAAY,eAAe,WAAW,MAAM,MAAM;GACxD,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,MAAM;GACnD,MAAM,KAAK,MAAM,OAAO,QAAQ,KAC9B,SAAS,WAAW,SAAS,EAAE,GAAG,WAAW,SAAS,KACtD,EAAE,KAAK,WAAW,KAAK,CACzB;GACA,IAAI,GAAG,aAAa,GAClB,QAAQ,KACN,IAAI,YAAY,6BAA6B,MAAM,KAAK,SAAS,UAAU,IAAI,GAAG,OAAO,KAAK,GAChG;EAEJ;CACF;CAGF,KAAK,MAAM,SAAS,WAAW,QAC7B,IAAI,MAAM,SAAS,eACjB,QAAQ,KACN,IAAI,YAAY,gBAAgB,MAAM,KAAK,sIAG7C;CAGJ,KAAK,MAAM,QAAQ,WAAW,SAC5B,QAAQ,KACN,IAAI,YAAY,YAAY,KAAK,2HAEnC;CAGF,MAAM,OAAO,GAAG,MAAM,WAAW,YAAY,EAAE;AACjD"}

package/dist/esm/index.js

@@ -6,30 +6,7 @@ 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
+import { AcpCompatibleTextAdapter, acpCompatible, acpCompatibleText } from "./adapters/compatible.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 };

package/dist/esm/messages/prompt.js

@@ -1,37 +1,34 @@
+//#region src/messages/prompt.ts
 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("");
+	if (content === null) return "";
+	if (typeof content === "string") return content;
+	return content.map((part) => part.type === "text" && typeof part.content === "string" ? part.content : "").join("");
 }
+/**
+* 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.
+*/
 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}`
-  };
+	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:\n${priorTurns.join("\n")}\n\n${lastUserText}` };
 }
-export {
-  buildAcpPrompt
-};
-//# sourceMappingURL=prompt.js.map
+//#endregion
+export { buildAcpPrompt };
+
+//# sourceMappingURL=prompt.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"prompt.js","names":[],"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"],"mappings":";AAQA,SAAS,YAAY,SAA0C;CAC7D,IAAI,YAAY,MAAM,OAAO;CAC7B,IAAI,OAAO,YAAY,UAAU,OAAO;CACxC,OAAO,QACJ,KAAK,SACJ,KAAK,SAAS,UAAU,OAAO,KAAK,YAAY,WAC5C,KAAK,UACL,EACN,CAAC,CACA,KAAK,EAAE;AACZ;;;;;;;;;;;;;AAcA,SAAgB,eACd,UACA,WACA,cAAc,eACE;CAChB,MAAM,cAAc,SAAS,GAAG,EAAE;CAClC,MAAM,eACJ,aAAa,SAAS,SAAS,YAAY,YAAY,OAAO,CAAC,CAAC,KAAK,IAAI;CAE3E,IAAI,CAAC,cACH,MAAM,IAAI,MACR,GAAG,YAAY,6DACjB;CAGF,IAAI,cAAc,KAAA,GAChB,OAAO;EAAE,QAAQ;EAAc,QAAQ;CAAU;CAGnD,MAAM,aAAa,SAChB,MAAM,GAAG,EAAE,CAAC,CACZ,QACE,aACE,QAAQ,SAAS,UAAU,QAAQ,SAAS,gBAC7C,YAAY,QAAQ,OAAO,CAAC,CAAC,KAAK,MAAM,EAC5C,CAAC,CACA,KACE,YACC,GAAG,QAAQ,SAAS,SAAS,SAAS,YAAY,IAAI,YAAY,QAAQ,OAAO,CAAC,CAAC,KAAK,GAC5F;CAEF,IAAI,WAAW,WAAW,GACxB,OAAO,EAAE,QAAQ,aAAa;CAGhC,OAAO,EACL,QAAQ,2BAA2B,WAAW,KAAK,IAAI,EAAE,MAAM,eACjE;AACF"}

package/dist/esm/permissions.js

@@ -1,44 +1,51 @@
-import { approvalId } from "@tanstack/ai-sandbox";
 import { matchBridgedToolName } from "./stream/translate.js";
-const EDIT_KINDS = /* @__PURE__ */ new Set(["edit", "move", "delete"]);
+import { approvalId } from "@tanstack/ai-sandbox";
+//#region src/permissions.ts
+var EDIT_KINDS = /* @__PURE__ */ new Set([
+	"edit",
+	"move",
+	"delete"
+]);
 function pickOption(request, kinds) {
-  for (const kind of kinds) {
-    const option = request.options.find((candidate) => candidate.kind === kind);
-    if (option) return { outcome: "selected", optionId: option.optionId };
-  }
-  return { outcome: "cancelled" };
+	for (const kind of kinds) {
+		const option = request.options.find((candidate) => candidate.kind === kind);
+		if (option) return {
+			outcome: "selected",
+			optionId: option.optionId
+		};
+	}
+	return { outcome: "cancelled" };
 }
 function resolvePermission(request, mode, bridgedToolNames) {
-  const allow = () => pickOption(request, ["allow_once", "allow_always"]);
-  const reject = () => pickOption(request, ["reject_once", "reject_always"]);
-  if (matchBridgedToolName(request.toolCall.title, bridgedToolNames) !== void 0) {
-    return allow();
-  }
-  if (mode === "bypassPermissions") return allow();
-  if (mode === "acceptEdits" && EDIT_KINDS.has(request.toolCall.kind ?? "")) {
-    return allow();
-  }
-  return reject();
+	const allow = () => pickOption(request, ["allow_once", "allow_always"]);
+	const reject = () => pickOption(request, ["reject_once", "reject_always"]);
+	if (matchBridgedToolName(request.toolCall.title, bridgedToolNames) !== void 0) return allow();
+	if (mode === "bypassPermissions") return allow();
+	if (mode === "acceptEdits" && EDIT_KINDS.has(request.toolCall.kind ?? "")) return allow();
+	return reject();
 }
 function resolveInteractivePermission(request, mode, bridgedToolNames, approvals, provider) {
-  const allow = () => pickOption(request, ["allow_once", "allow_always"]);
-  const reject = () => pickOption(request, ["reject_once", "reject_always"]);
-  const title = request.toolCall.title ?? request.toolCall.toolCallId;
-  if (matchBridgedToolName(title, bridgedToolNames) !== void 0) {
-    return { outcome: allow() };
-  }
-  if (mode === "bypassPermissions") return { outcome: allow() };
-  if (mode === "acceptEdits" && EDIT_KINDS.has(request.toolCall.kind ?? "")) {
-    return { outcome: allow() };
-  }
-  const id = approvalId({ provider, kind: "tool", target: title });
-  const granted = approvals?.get(id);
-  if (granted === true) return { outcome: allow() };
-  if (granted === false) return { outcome: reject() };
-  return { outcome: reject(), approvalId: id, title };
+	const allow = () => pickOption(request, ["allow_once", "allow_always"]);
+	const reject = () => pickOption(request, ["reject_once", "reject_always"]);
+	const title = request.toolCall.title ?? request.toolCall.toolCallId;
+	if (matchBridgedToolName(title, bridgedToolNames) !== void 0) return { outcome: allow() };
+	if (mode === "bypassPermissions") return { outcome: allow() };
+	if (mode === "acceptEdits" && EDIT_KINDS.has(request.toolCall.kind ?? "")) return { outcome: allow() };
+	const id = approvalId({
+		provider,
+		kind: "tool",
+		target: title
+	});
+	const granted = approvals?.get(id);
+	if (granted === true) return { outcome: allow() };
+	if (granted === false) return { outcome: reject() };
+	return {
+		outcome: reject(),
+		approvalId: id,
+		title
+	};
 }
-export {
-  resolveInteractivePermission,
-  resolvePermission
-};
-//# sourceMappingURL=permissions.js.map
+//#endregion
+export { resolveInteractivePermission, resolvePermission };
+
+//# sourceMappingURL=permissions.js.map