@ai-sdk/harness-acp 1.0.71 → 1.0.73

package/dist/index.d.ts

@@ -1,183 +1,185 @@
-import { HarnessV1StreamPart, HarnessV1Authentication, HarnessV1RequestTransformation, HarnessV1CredentialForwarding, HarnessV1PermissionMode, HarnessV1MintBridgeTokenCallback, HarnessV1PortEndpoint, HarnessV1, HARNESS_V1_BUILTIN_TOOLS } from '@ai-sdk/harness';
-import { SandboxChannelReconnectOptions } from '@ai-sdk/harness/utils';
-import { ToolResultPart, ToolSet } from '@ai-sdk/provider-utils';
-
+import { HARNESS_V1_BUILTIN_TOOLS, HarnessV1, HarnessV1Authentication, HarnessV1CredentialForwarding, HarnessV1MintBridgeTokenCallback, HarnessV1PermissionMode, HarnessV1PortEndpoint, HarnessV1RequestTransformation, HarnessV1StreamPart, harnessV1BridgeStartBaseSchema } from "@ai-sdk/harness";
+import { z } from "zod/v4";
+import { SandboxChannelReconnectOptions } from "@ai-sdk/harness/utils";
+import { ToolResultPart, ToolSet } from "@ai-sdk/provider-utils";
+//#region src/acp-tool-call.d.ts
 type ACPMetadata = Record<string, unknown>;
 type ACPRole = 'assistant' | 'user';
 type ACPAnnotations = {
-    audience?: Array<ACPRole> | null;
-    lastModified?: string | null;
-    priority?: number | null;
-    _meta?: ACPMetadata | null;
+  audience?: Array<ACPRole> | null;
+  lastModified?: string | null;
+  priority?: number | null;
+  _meta?: ACPMetadata | null;
 };
 type ACPTextContent = {
-    annotations?: ACPAnnotations | null;
-    text: string;
-    _meta?: ACPMetadata | null;
+  annotations?: ACPAnnotations | null;
+  text: string;
+  _meta?: ACPMetadata | null;
 };
 type ACPImageContent = {
-    annotations?: ACPAnnotations | null;
-    data: string;
-    mimeType: string;
-    uri?: string | null;
-    _meta?: ACPMetadata | null;
+  annotations?: ACPAnnotations | null;
+  data: string;
+  mimeType: string;
+  uri?: string | null;
+  _meta?: ACPMetadata | null;
 };
 type ACPAudioContent = {
-    annotations?: ACPAnnotations | null;
-    data: string;
-    mimeType: string;
-    _meta?: ACPMetadata | null;
+  annotations?: ACPAnnotations | null;
+  data: string;
+  mimeType: string;
+  _meta?: ACPMetadata | null;
 };
 type ACPResourceLink = {
-    annotations?: ACPAnnotations | null;
-    description?: string | null;
-    mimeType?: string | null;
-    name: string;
-    size?: number | null;
-    title?: string | null;
-    uri: string;
-    _meta?: ACPMetadata | null;
+  annotations?: ACPAnnotations | null;
+  description?: string | null;
+  mimeType?: string | null;
+  name: string;
+  size?: number | null;
+  title?: string | null;
+  uri: string;
+  _meta?: ACPMetadata | null;
 };
 type ACPTextResourceContents = {
-    mimeType?: string | null;
-    text: string;
-    uri: string;
-    _meta?: ACPMetadata | null;
+  mimeType?: string | null;
+  text: string;
+  uri: string;
+  _meta?: ACPMetadata | null;
 };
 type ACPBlobResourceContents = {
-    blob: string;
-    mimeType?: string | null;
-    uri: string;
-    _meta?: ACPMetadata | null;
+  blob: string;
+  mimeType?: string | null;
+  uri: string;
+  _meta?: ACPMetadata | null;
 };
 type ACPEmbeddedResource = {
-    annotations?: ACPAnnotations | null;
-    resource: ACPTextResourceContents | ACPBlobResourceContents;
-    _meta?: ACPMetadata | null;
+  annotations?: ACPAnnotations | null;
+  resource: ACPTextResourceContents | ACPBlobResourceContents;
+  _meta?: ACPMetadata | null;
 };
 type ACPContentBlock = (ACPTextContent & {
-    type: 'text';
+  type: 'text';
 }) | (ACPImageContent & {
-    type: 'image';
+  type: 'image';
 }) | (ACPAudioContent & {
-    type: 'audio';
+  type: 'audio';
 }) | (ACPResourceLink & {
-    type: 'resource_link';
+  type: 'resource_link';
 }) | (ACPEmbeddedResource & {
-    type: 'resource';
+  type: 'resource';
 });
 type ACPToolCallContent = {
-    type: 'content';
-    content: ACPContentBlock;
-    _meta?: ACPMetadata | null;
+  type: 'content';
+  content: ACPContentBlock;
+  _meta?: ACPMetadata | null;
 } | {
-    type: 'diff';
-    path: string;
-    oldText?: string | null;
-    newText: string;
-    _meta?: ACPMetadata | null;
+  type: 'diff';
+  path: string;
+  oldText?: string | null;
+  newText: string;
+  _meta?: ACPMetadata | null;
 } | {
-    type: 'terminal';
-    terminalId: string;
-    _meta?: ACPMetadata | null;
+  type: 'terminal';
+  terminalId: string;
+  _meta?: ACPMetadata | null;
 };
 type ACPToolKind = 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'switch_mode' | 'other';
 type ACPToolCallStatus = 'pending' | 'in_progress' | 'completed' | 'failed';
 type ACPToolCallLocation = {
-    path: string;
-    line?: number | null;
-    _meta?: ACPMetadata | null;
+  path: string;
+  line?: number | null;
+  _meta?: ACPMetadata | null;
 };
 type ACPToolCall = {
-    toolCallId: string;
-    name?: string | null;
-    title: string;
-    kind?: ACPToolKind;
-    status?: ACPToolCallStatus;
-    content?: Array<ACPToolCallContent>;
-    locations?: Array<ACPToolCallLocation>;
-    rawInput?: unknown;
-    rawOutput?: unknown;
-    _meta?: ACPMetadata | null;
+  toolCallId: string;
+  name?: string | null;
+  title: string;
+  kind?: ACPToolKind;
+  status?: ACPToolCallStatus;
+  content?: Array<ACPToolCallContent>;
+  locations?: Array<ACPToolCallLocation>;
+  rawInput?: unknown;
+  rawOutput?: unknown;
+  _meta?: ACPMetadata | null;
 };
-
+//#endregion
+//#region src/v1/acp-v1-settings.d.ts
 type ACPSerializablePrimitive = string | number | boolean | null;
 type ACPSerializableValue = ACPSerializablePrimitive | ReadonlyArray<ACPSerializableValue> | {
-    readonly [key: string]: ACPSerializableValue;
+  readonly [key: string]: ACPSerializableValue;
 };
 type ACPValueSource = {
-    readonly $source: 'gateway-api-key' | 'gateway-base-url' | 'gateway-authorization' | 'client-app' | 'client-app-name' | 'client-app-version';
-    readonly prefix?: string;
-    readonly suffix?: string;
-    readonly ensureSuffix?: string;
+  readonly $source: 'gateway-api-key' | 'gateway-base-url' | 'gateway-authorization' | 'client-app' | 'client-app-name' | 'client-app-version';
+  readonly prefix?: string;
+  readonly suffix?: string;
+  readonly ensureSuffix?: string;
 };
 type ACPProfileValue = ACPSerializablePrimitive | ACPValueSource | ReadonlyArray<ACPProfileValue> | {
-    readonly [key: string]: ACPProfileValue;
+  readonly [key: string]: ACPProfileValue;
 };
 type ACPNpmSimpleSource = {
-    readonly type: 'npm-simple';
-    readonly packageName: string;
-    /**
-     * Exact version to install. When omitted, the package's `latest` dist-tag is
-     * installed and no version takes part in the implementation identity, so a
-     * new upstream release does not invalidate existing lifecycle state.
-     */
-    readonly packageVersion?: string;
+  readonly type: 'npm-simple';
+  readonly packageName: string;
+  /**
+   * Exact version to install. When omitted, the package's `latest` dist-tag is
+   * installed and no version takes part in the implementation identity, so a
+   * new upstream release does not invalidate existing lifecycle state.
+   */
+  readonly packageVersion?: string;
 };
 type ACPNpmLockedSource = {
-    readonly type: 'npm-locked';
-    readonly packageJson: string;
-    readonly pnpmLockYaml: string;
-    /** Optional pnpm workspace configuration required by the locked install. */
-    readonly pnpmWorkspaceYaml?: string;
+  readonly type: 'npm-locked';
+  readonly packageJson: string;
+  readonly pnpmLockYaml: string;
+  /** Optional pnpm workspace configuration required by the locked install. */
+  readonly pnpmWorkspaceYaml?: string;
 };
 type ACPInstallCommandSource = {
-    readonly type: 'install-command';
-    readonly command: string;
+  readonly type: 'install-command';
+  readonly command: string;
 };
 type ACPSource = ACPNpmSimpleSource | ACPNpmLockedSource | ACPInstallCommandSource;
 type ACPAuthentication = {
-    readonly methodId: string;
-    readonly meta?: Readonly<Record<string, ACPSerializableValue>>;
-    readonly clientCapabilities?: Readonly<Record<string, ACPSerializableValue>>;
+  readonly methodId: string;
+  readonly meta?: Readonly<Record<string, ACPSerializableValue>>;
+  readonly clientCapabilities?: Readonly<Record<string, ACPSerializableValue>>;
 };
 type ACPAuthenticationMode$1 = HarnessV1Authentication;
 type ACPProviderAuthentication = {
-    readonly gateway: {
-        readonly env: Readonly<Record<string, ACPProfileValue>>;
-    };
+  readonly gateway: {
+    readonly env: Readonly<Record<string, ACPProfileValue>>;
+  };
 };
 type ACPModelMapping = {
-    readonly type: 'session-config-option';
-    readonly path: string;
+  readonly type: 'session-config-option';
+  readonly path: string;
 } | {
-    readonly type: 'session-model';
-    readonly path: string;
+  readonly type: 'session-model';
+  readonly path: string;
 };
-type ACPCredentialBrokering = ({ env, sandboxEnv, headers, }: {
-    env: Readonly<Record<string, string>>;
-    sandboxEnv?: Readonly<Record<string, string>>;
-    headers?: Readonly<Record<string, string>>;
+type ACPCredentialBrokering = ({ env, sandboxEnv, headers }: {
+  env: Readonly<Record<string, string>>;
+  sandboxEnv?: Readonly<Record<string, string>>;
+  headers?: Readonly<Record<string, string>>;
 }) => ReadonlyArray<HarnessV1RequestTransformation>;
 type ACPAuthenticationFile = {
-    /** Path relative to the ACP implementation's private home directory. */
-    readonly path: string;
-    readonly content: string;
+  /** Path relative to the ACP implementation's private home directory. */
+  readonly path: string;
+  readonly content: string;
 };
 type ACPAuthenticationFiles = (options: {
-    /** Host values resolved for the implementation. */
-    readonly env: Readonly<Record<string, string>>;
-    /** Values exposed to the sandbox process after credential brokering. */
-    readonly sandboxEnv: Readonly<Record<string, string>>;
-    readonly credentialBrokeringAvailable: boolean;
+  /** Host values resolved for the implementation. */
+  readonly env: Readonly<Record<string, string>>;
+  /** Values exposed to the sandbox process after credential brokering. */
+  readonly sandboxEnv: Readonly<Record<string, string>>;
+  readonly credentialBrokeringAvailable: boolean;
 }) => ReadonlyArray<ACPAuthenticationFile>;
 type ACPPermissionModeTarget = {
-    readonly type: 'session-mode';
-    readonly modeId: string;
+  readonly type: 'session-mode';
+  readonly modeId: string;
 } | {
-    readonly type: 'session-config-option';
-    readonly configId: string;
-    readonly value: string | boolean;
+  readonly type: 'session-config-option';
+  readonly configId: string;
+  readonly value: string | boolean;
 };
 type ACPPermissionModeMapping = Readonly<Record<HarnessV1PermissionMode, ACPPermissionModeTarget | null>>;
 /**
@@ -186,19 +188,19 @@ type ACPPermissionModeMapping = Readonly<Record<HarnessV1PermissionMode, ACPPerm
  * relative to the parsed JSON object stored in `variable`.
  */
 type ACPInstructionMapping = {
-    readonly type: 'session-meta';
-    readonly path: ReadonlyArray<string>;
+  readonly type: 'session-meta';
+  readonly path: ReadonlyArray<string>;
 } | {
-    readonly type: 'launch-env-json';
-    readonly variable: string;
-    readonly path: ReadonlyArray<string>;
+  readonly type: 'launch-env-json';
+  readonly variable: string;
+  readonly path: ReadonlyArray<string>;
 } | {
-    readonly type: 'filesystem';
-    readonly path: string;
+  readonly type: 'filesystem';
+  readonly path: string;
 };
 type ACPOutputSchemaMapping = {
-    readonly type: 'session-prompt-meta';
-    readonly path: ReadonlyArray<string>;
+  readonly type: 'session-prompt-meta';
+  readonly path: ReadonlyArray<string>;
 };
 /**
  * Transport used for the harness-owned MCP server that exposes host tools to
@@ -206,179 +208,183 @@ type ACPOutputSchemaMapping = {
  */
 type ACPHostToolMCPTransport = 'stdio' | 'http';
 type ACPAskUserQuestionsSettings = {
-    readonly requestMethod: string;
-    readonly isNativeToolCall?: (options: {
-        nativeToolCall: ACPToolCall;
-    }) => boolean;
-    readonly fromNativeRequest: (options: {
-        nativeRequest: unknown;
-        nativeToolCall?: ACPToolCall;
-    }) => Extract<HarnessV1StreamPart, {
-        type: 'tool-call';
-    }> | null;
-    readonly toNativeResponse: (options: {
-        nativeRequest: unknown;
-        toolResult: ToolResultPart;
-    }) => unknown;
-    readonly matchesNativeRequest?: (options: {
-        previousNativeRequest: unknown;
-        nativeRequest: unknown;
-    }) => boolean;
+  readonly requestMethod: string;
+  readonly isNativeToolCall?: (options: {
+    nativeToolCall: ACPToolCall;
+  }) => boolean;
+  readonly fromNativeRequest: (options: {
+    nativeRequest: unknown;
+    nativeToolCall?: ACPToolCall;
+  }) => Extract<HarnessV1StreamPart, {
+    type: 'tool-call';
+  }> | null;
+  readonly toNativeResponse: (options: {
+    nativeRequest: unknown;
+    toolResult: ToolResultPart;
+  }) => unknown;
+  readonly matchesNativeRequest?: (options: {
+    previousNativeRequest: unknown;
+    nativeRequest: unknown;
+  }) => boolean;
 };
 type ACPV1Settings = {
-    readonly version?: 'v1';
-    readonly harnessId: string;
-    readonly mcpServers?: Record<string, unknown>;
-    readonly isMcpToolCall?: (toolCall: ACPToolCall) => boolean;
-    readonly auth?: ACPAuthenticationMode$1;
-    /**
-     * Resolves adapter-owned authentication on the host before any environment
-     * values are forwarded to the ACP implementation.
-     */
-    readonly resolveAuthenticationEnvironment?: (options: {
-        readonly auth: ACPAuthenticationMode$1 | undefined;
-        readonly env: Readonly<Record<string, string | undefined>>;
-    }) => Promise<Readonly<Record<string, string | undefined>>>;
-    readonly source: ACPSource;
-    readonly executable: string;
-    readonly args?: ReadonlyArray<string>;
-    readonly forwardEnv?: ReadonlyArray<string>;
-    readonly credentialEnv?: ReadonlyArray<string>;
-    readonly credentialBrokering?: ACPCredentialBrokering;
-    /**
-     * Materializes private authentication files below the ACP implementation's
-     * home directory before the implementation starts.
-     */
-    readonly authenticationFiles?: ACPAuthenticationFiles;
-    /**
-     * Customizes each credential value before it is forwarded into a sandbox
-     * process. This does not restrict which credentials the harness adapter can
-     * discover, read, or otherwise access in the host process.
-     */
-    readonly credentialForwarding?: HarnessV1CredentialForwarding;
-    /**
-     * Runtime environment values that are safe to persist in bootstrap and
-     * lifecycle compatibility identity.
-     */
-    readonly env?: Readonly<Record<string, string>>;
-    readonly authentication?: ACPAuthentication;
-    readonly clientCapabilities?: Readonly<Record<string, ACPSerializableValue>>;
-    readonly providerAuthentication?: ACPProviderAuthentication;
-    /**
-     * Maps the HarnessAgent model identifier to an ACP session operation.
-     */
-    readonly modelMapping: ACPModelMapping;
-    /**
-     * Native skills directory relative to the ACP implementation's home
-     * directory. Defaults to `.agents/skills`.
-     */
-    readonly skillsDirectory?: string;
-    /**
-     * Routes HarnessAgent instructions to a runtime-native system or developer
-     * prompt. Changed instructions are prepended to the next user prompt when
-     * ACP does not expose a native per-turn instruction update.
-     */
-    readonly instructionMapping?: ACPInstructionMapping;
-    /**
-     * Maps structured output JSON Schema to an implementation-specific path
-     * below the ACP session prompt's `_meta` field.
-     */
-    readonly outputSchemaMapping?: ACPOutputSchemaMapping;
-    /**
-     * Transport used for the harness-owned MCP server that exposes host tools to
-     * the ACP implementation. Defaults to `stdio`. Set this to `http` for
-     * implementations that only accept HTTP or SSE MCP servers from the client,
-     * which requires the implementation to advertise
-     * `agentCapabilities.mcpCapabilities.http`.
-     */
-    readonly hostToolMcpTransport?: ACPHostToolMCPTransport;
-    readonly askUserQuestions?: ACPAskUserQuestionsSettings;
-    readonly permissionModeMapping?: ACPPermissionModeMapping;
-    readonly session?: {
-        readonly meta?: Readonly<Record<string, ACPSerializableValue>>;
-    };
-    /**
-     * Creates the authentication token used by the sandbox bridge. Defaults to
-     * a random 32-byte hexadecimal token.
-     */
-    readonly mintBridgeToken?: HarnessV1MintBridgeTokenCallback;
+  readonly version?: 'v1';
+  readonly harnessId: string;
+  readonly mcpServers?: Record<string, unknown>;
+  readonly isMcpToolCall?: (toolCall: ACPToolCall) => boolean;
+  readonly auth?: ACPAuthenticationMode$1;
+  /**
+   * Resolves adapter-owned authentication on the host before any environment
+   * values are forwarded to the ACP implementation.
+   */
+  readonly resolveAuthenticationEnvironment?: (options: {
+    readonly auth: ACPAuthenticationMode$1 | undefined;
+    readonly env: Readonly<Record<string, string | undefined>>;
+  }) => Promise<Readonly<Record<string, string | undefined>>>;
+  readonly source: ACPSource;
+  readonly executable: string;
+  readonly args?: ReadonlyArray<string>;
+  readonly forwardEnv?: ReadonlyArray<string>;
+  readonly credentialEnv?: ReadonlyArray<string>;
+  readonly credentialBrokering?: ACPCredentialBrokering;
+  /**
+   * Materializes private authentication files below the ACP implementation's
+   * home directory before the implementation starts.
+   */
+  readonly authenticationFiles?: ACPAuthenticationFiles;
+  /**
+   * Customizes each credential value before it is forwarded into a sandbox
+   * process. This does not restrict which credentials the harness adapter can
+   * discover, read, or otherwise access in the host process.
+   */
+  readonly credentialForwarding?: HarnessV1CredentialForwarding;
+  /**
+   * Runtime environment values that are safe to persist in bootstrap and
+   * lifecycle compatibility identity.
+   */
+  readonly env?: Readonly<Record<string, string>>;
+  readonly authentication?: ACPAuthentication;
+  readonly clientCapabilities?: Readonly<Record<string, ACPSerializableValue>>;
+  readonly providerAuthentication?: ACPProviderAuthentication;
+  /**
+   * Maps the HarnessAgent model identifier to an ACP session operation.
+   */
+  readonly modelMapping: ACPModelMapping;
+  /**
+   * Native skills directory relative to the ACP implementation's home
+   * directory. Defaults to `.agents/skills`.
+   */
+  readonly skillsDirectory?: string;
+  /**
+   * Routes HarnessAgent instructions to a runtime-native system or developer
+   * prompt. Changed instructions are prepended to the next user prompt when
+   * ACP does not expose a native per-turn instruction update.
+   */
+  readonly instructionMapping?: ACPInstructionMapping;
+  /**
+   * Maps structured output JSON Schema to an implementation-specific path
+   * below the ACP session prompt's `_meta` field.
+   */
+  readonly outputSchemaMapping?: ACPOutputSchemaMapping;
+  /**
+   * Transport used for the harness-owned MCP server that exposes host tools to
+   * the ACP implementation. Defaults to `stdio`. Set this to `http` for
+   * implementations that only accept HTTP or SSE MCP servers from the client,
+   * which requires the implementation to advertise
+   * `agentCapabilities.mcpCapabilities.http`.
+   */
+  readonly hostToolMcpTransport?: ACPHostToolMCPTransport;
+  readonly askUserQuestions?: ACPAskUserQuestionsSettings;
+  readonly permissionModeMapping?: ACPPermissionModeMapping;
+  readonly session?: {
+    readonly meta?: Readonly<Record<string, ACPSerializableValue>>;
+  };
+  /**
+   * Creates the authentication token used by the sandbox bridge. Defaults to
+   * a random 32-byte hexadecimal token.
+   */
+  readonly mintBridgeToken?: HarnessV1MintBridgeTokenCallback;
 };
-
+//#endregion
+//#region src/acp-auth.d.ts
 type ACPAuthenticationMode = ACPAuthenticationMode$1;
 type ACPClientApp = {
-    readonly name: string;
-    readonly version: string;
+  readonly name: string;
+  readonly version: string;
 };
-
+//#endregion
+//#region src/acp-harness.d.ts
 type ACPHarnessSettings<TBuiltinTools extends ToolSet = {}, TAskUserQuestions extends ACPAskUserQuestionsSettings | undefined = ACPAskUserQuestionsSettings | undefined> = {
-    readonly builtinTools?: TBuiltinTools;
-    /**
-     * MCP server definitions keyed by server name. Each definition uses the
-     * underlying runtime's native MCP server configuration format.
-     */
-    readonly mcpServers?: Record<string, unknown>;
-    readonly isMcpToolCall?: (toolCall: ACPToolCall) => boolean;
-    readonly port?: number;
-    /**
-     * Override the host endpoint used to connect to the sandbox bridge. Required
-     * together with `port` when using a basic sandbox session.
-     */
-    readonly portEndpoint?: HarnessV1PortEndpoint;
-    readonly startupTimeoutMs?: number;
-    /**
-     * Configures reconnection attempts after an established bridge connection
-     * drops. The reconnect window includes connection establishment and
-     * backoff delays. Defaults to 30 seconds with exponential backoff from 50
-     * milliseconds up to 2 seconds.
-     */
-    readonly reconnect?: SandboxChannelReconnectOptions;
-    readonly clientApp?: ACPClientApp;
-    readonly version?: ACPV1Settings['version'];
-    readonly harnessId: ACPV1Settings['harnessId'];
-    readonly auth?: ACPAuthenticationMode;
-    readonly resolveAuthenticationEnvironment?: ACPV1Settings['resolveAuthenticationEnvironment'];
-    readonly source: ACPV1Settings['source'];
-    readonly executable: ACPV1Settings['executable'];
-    readonly args?: ACPV1Settings['args'];
-    readonly forwardEnv?: ACPV1Settings['forwardEnv'];
-    readonly credentialEnv?: ACPV1Settings['credentialEnv'];
-    readonly credentialBrokering?: ACPV1Settings['credentialBrokering'];
-    readonly authenticationFiles?: ACPV1Settings['authenticationFiles'];
-    /**
-     * Customizes each credential value before it is forwarded into a sandbox
-     * process. This does not restrict which credentials the harness adapter can
-     * discover, read, or otherwise access in the host process.
-     */
-    readonly credentialForwarding?: HarnessV1CredentialForwarding;
-    readonly env?: ACPV1Settings['env'];
-    readonly authentication?: ACPV1Settings['authentication'];
-    readonly clientCapabilities?: ACPV1Settings['clientCapabilities'];
-    readonly providerAuthentication?: ACPV1Settings['providerAuthentication'];
-    /**
-     * Maps the HarnessAgent model identifier to an ACP session operation.
-     */
-    readonly modelMapping: ACPV1Settings['modelMapping'];
-    readonly skillsDirectory?: ACPV1Settings['skillsDirectory'];
-    readonly instructionMapping?: ACPV1Settings['instructionMapping'];
-    readonly outputSchemaMapping?: ACPV1Settings['outputSchemaMapping'];
-    /**
-     * Transport used for the harness-owned MCP server that exposes host tools to
-     * the ACP implementation. Defaults to `stdio`. Set this to `http` for
-     * implementations that only accept HTTP or SSE MCP servers from the client,
-     * which requires the implementation to advertise
-     * `agentCapabilities.mcpCapabilities.http`.
-     */
-    readonly hostToolMcpTransport?: ACPV1Settings['hostToolMcpTransport'];
-    readonly askUserQuestions?: TAskUserQuestions;
-    readonly permissionModeMapping?: ACPV1Settings['permissionModeMapping'];
-    readonly session?: ACPV1Settings['session'];
-    readonly mintBridgeToken?: HarnessV1MintBridgeTokenCallback;
+  readonly builtinTools?: TBuiltinTools;
+  /**
+   * MCP server definitions keyed by server name. Each definition uses the
+   * underlying runtime's native MCP server configuration format.
+   */
+  readonly mcpServers?: Record<string, unknown>;
+  readonly isMcpToolCall?: (toolCall: ACPToolCall) => boolean;
+  readonly port?: number;
+  /**
+   * Override the host endpoint used to connect to the sandbox bridge. Required
+   * together with `port` when using a basic sandbox session.
+   */
+  readonly portEndpoint?: HarnessV1PortEndpoint;
+  readonly startupTimeoutMs?: number;
+  /**
+   * Configures reconnection attempts after an established bridge connection
+   * drops. The reconnect window includes connection establishment and
+   * backoff delays. Defaults to 30 seconds with exponential backoff from 50
+   * milliseconds up to 2 seconds.
+   */
+  readonly reconnect?: SandboxChannelReconnectOptions;
+  readonly clientApp?: ACPClientApp;
+  readonly version?: ACPV1Settings['version'];
+  readonly harnessId: ACPV1Settings['harnessId'];
+  readonly auth?: ACPAuthenticationMode;
+  readonly resolveAuthenticationEnvironment?: ACPV1Settings['resolveAuthenticationEnvironment'];
+  readonly source: ACPV1Settings['source'];
+  readonly executable: ACPV1Settings['executable'];
+  readonly args?: ACPV1Settings['args'];
+  readonly forwardEnv?: ACPV1Settings['forwardEnv'];
+  readonly credentialEnv?: ACPV1Settings['credentialEnv'];
+  readonly credentialBrokering?: ACPV1Settings['credentialBrokering'];
+  readonly authenticationFiles?: ACPV1Settings['authenticationFiles'];
+  /**
+   * Customizes each credential value before it is forwarded into a sandbox
+   * process. This does not restrict which credentials the harness adapter can
+   * discover, read, or otherwise access in the host process.
+   */
+  readonly credentialForwarding?: HarnessV1CredentialForwarding;
+  readonly env?: ACPV1Settings['env'];
+  readonly authentication?: ACPV1Settings['authentication'];
+  readonly clientCapabilities?: ACPV1Settings['clientCapabilities'];
+  readonly providerAuthentication?: ACPV1Settings['providerAuthentication'];
+  /**
+   * Maps the HarnessAgent model identifier to an ACP session operation.
+   */
+  readonly modelMapping: ACPV1Settings['modelMapping'];
+  readonly skillsDirectory?: ACPV1Settings['skillsDirectory'];
+  readonly instructionMapping?: ACPV1Settings['instructionMapping'];
+  readonly outputSchemaMapping?: ACPV1Settings['outputSchemaMapping'];
+  /**
+   * Transport used for the harness-owned MCP server that exposes host tools to
+   * the ACP implementation. Defaults to `stdio`. Set this to `http` for
+   * implementations that only accept HTTP or SSE MCP servers from the client,
+   * which requires the implementation to advertise
+   * `agentCapabilities.mcpCapabilities.http`.
+   */
+  readonly hostToolMcpTransport?: ACPV1Settings['hostToolMcpTransport'];
+  readonly askUserQuestions?: TAskUserQuestions;
+  readonly permissionModeMapping?: ACPV1Settings['permissionModeMapping'];
+  readonly session?: ACPV1Settings['session'];
+  readonly mintBridgeToken?: HarnessV1MintBridgeTokenCallback;
 };
 type ACPHarnessTools<TBuiltinTools extends ToolSet, TAskUserQuestions> = TBuiltinTools & ([TAskUserQuestions] extends [undefined] ? {} : {
-    askUserQuestions: typeof HARNESS_V1_BUILTIN_TOOLS.askUserQuestions;
+  askUserQuestions: typeof HARNESS_V1_BUILTIN_TOOLS.askUserQuestions;
 });
-declare function createACP<TBuiltinTools extends ToolSet = {}, TAskUserQuestions extends ACPAskUserQuestionsSettings | undefined = undefined>(settings: ACPHarnessSettings<TBuiltinTools, TAskUserQuestions>): HarnessV1<ACPHarnessTools<TBuiltinTools, TAskUserQuestions>>;
-
-declare const VERSION: string;
-
-export { type ACPAnnotations, type ACPAskUserQuestionsSettings, type ACPAudioContent, type ACPAuthentication, type ACPAuthenticationFile, type ACPAuthenticationFiles, type ACPAuthenticationMode, type ACPBlobResourceContents, type ACPClientApp, type ACPContentBlock, type ACPCredentialBrokering, type ACPEmbeddedResource, type ACPHarnessSettings, type ACPHostToolMCPTransport, type ACPImageContent, type ACPInstallCommandSource, type ACPInstructionMapping, type ACPMetadata, type ACPModelMapping, type ACPNpmLockedSource, type ACPNpmSimpleSource, type ACPOutputSchemaMapping, type ACPPermissionModeMapping, type ACPPermissionModeTarget, type ACPProfileValue, type ACPProviderAuthentication, type ACPResourceLink, type ACPRole, type ACPSerializablePrimitive, type ACPSerializableValue, type ACPSource, type ACPTextContent, type ACPTextResourceContents, type ACPToolCall, type ACPToolCallContent, type ACPToolCallLocation, type ACPToolCallStatus, type ACPToolKind, type ACPV1Settings, type ACPValueSource, VERSION, createACP };
+export declare function createACP<TBuiltinTools extends ToolSet = {}, TAskUserQuestions extends ACPAskUserQuestionsSettings | undefined = undefined>(settings: ACPHarnessSettings<TBuiltinTools, TAskUserQuestions>): HarnessV1<ACPHarnessTools<TBuiltinTools, TAskUserQuestions>>;
+//#endregion
+//#region src/version.d.ts
+export declare const VERSION: string;
+//#endregion
+export type { ACPAnnotations, ACPAskUserQuestionsSettings, ACPAudioContent, ACPAuthentication, ACPAuthenticationFile, ACPAuthenticationFiles, ACPAuthenticationMode, ACPBlobResourceContents, ACPClientApp, ACPContentBlock, ACPCredentialBrokering, ACPEmbeddedResource, ACPHarnessSettings, ACPHostToolMCPTransport, ACPImageContent, ACPInstallCommandSource, ACPInstructionMapping, ACPMetadata, ACPModelMapping, ACPNpmLockedSource, ACPNpmSimpleSource, ACPOutputSchemaMapping, ACPPermissionModeMapping, ACPPermissionModeTarget, ACPProfileValue, ACPProviderAuthentication, ACPResourceLink, ACPRole, ACPSerializablePrimitive, ACPSerializableValue, ACPSource, ACPTextContent, ACPTextResourceContents, ACPToolCall, ACPToolCallContent, ACPToolCallLocation, ACPToolCallStatus, ACPToolKind, ACPV1Settings, ACPValueSource };
+//# sourceMappingURL=index.d.ts.map