@ai-sdk/harness-acp 1.0.38 → 1.0.40

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { HarnessV1Authentication, HarnessV1RequestTransformation, HarnessV1CredentialForwarding, HarnessV1PermissionMode, HarnessV1PortEndpoint, HarnessV1 } from '@ai-sdk/harness';
-import { ToolSet } from '@ai-sdk/provider-utils';
+import { HarnessV1StreamPart, HarnessV1Authentication, HarnessV1RequestTransformation, HarnessV1CredentialForwarding, HarnessV1PermissionMode, HarnessV1PortEndpoint, HarnessV1, HARNESS_V1_BUILTIN_TOOLS } from '@ai-sdk/harness';
+import { ToolResultPart, ToolSet } from '@ai-sdk/provider-utils';
 
 type ACPMetadata = Record<string, unknown>;
 type ACPRole = 'assistant' | 'user';
@@ -152,9 +152,10 @@ type ACPModelMapping = {
     readonly type: 'session-model';
     readonly path: string;
 };
-type ACPCredentialBrokering = ({ env, sandboxEnv, }: {
+type ACPCredentialBrokering = ({ env, sandboxEnv, headers, }: {
     env: Readonly<Record<string, string>>;
     sandboxEnv?: Readonly<Record<string, string>>;
+    headers?: Readonly<Record<string, string>>;
 }) => ReadonlyArray<HarnessV1RequestTransformation>;
 type ACPPermissionModeTarget = {
     readonly type: 'session-mode';
@@ -177,11 +178,39 @@ type ACPInstructionMapping = {
     readonly type: 'launch-env-json';
     readonly variable: string;
     readonly path: ReadonlyArray<string>;
+} | {
+    readonly type: 'filesystem';
+    readonly path: string;
 };
 type ACPOutputSchemaMapping = {
     readonly type: 'session-prompt-meta';
     readonly path: ReadonlyArray<string>;
 };
+/**
+ * Transport used for the harness-owned MCP server that exposes host tools to
+ * an ACP implementation.
+ */
+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;
+};
 type ACPV1Settings = {
     readonly version?: 'v1';
     readonly harnessId: string;
@@ -232,6 +261,15 @@ type ACPV1Settings = {
      * 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>>;
@@ -249,7 +287,7 @@ type ACPClientApp = {
     readonly version: string;
 };
 
-type ACPHarnessSettings<TBuiltinTools extends ToolSet = {}> = {
+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
@@ -295,12 +333,24 @@ type ACPHarnessSettings<TBuiltinTools extends ToolSet = {}> = {
     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?: ACPV1Settings['mintBridgeToken'];
 };
-declare function createACP<TBuiltinTools extends ToolSet = {}>(settings: ACPHarnessSettings<TBuiltinTools>): HarnessV1<TBuiltinTools>;
+type ACPHarnessTools<TBuiltinTools extends ToolSet, TAskUserQuestions> = TBuiltinTools & ([TAskUserQuestions] extends [undefined] ? {} : {
+    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 ACPAudioContent, type ACPAuthentication, type ACPAuthenticationMode, type ACPBlobResourceContents, type ACPClientApp, type ACPContentBlock, type ACPCredentialBrokering, type ACPEmbeddedResource, type ACPHarnessSettings, 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 { type ACPAnnotations, type ACPAskUserQuestionsSettings, type ACPAudioContent, type ACPAuthentication, 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 };