@ai-sdk/harness-acp 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -1,6 +1,104 @@
 import { HarnessV1PermissionMode, HarnessV1 } from '@ai-sdk/harness';
 import { ToolSet } from '@ai-sdk/provider-utils';
 
+type ACPMetadata = Record<string, unknown>;
+type ACPRole = 'assistant' | 'user';
+type ACPAnnotations = {
+    audience?: Array<ACPRole> | null;
+    lastModified?: string | null;
+    priority?: number | null;
+    _meta?: ACPMetadata | null;
+};
+type ACPTextContent = {
+    annotations?: ACPAnnotations | null;
+    text: string;
+    _meta?: ACPMetadata | null;
+};
+type ACPImageContent = {
+    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;
+};
+type ACPResourceLink = {
+    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;
+};
+type ACPBlobResourceContents = {
+    blob: string;
+    mimeType?: string | null;
+    uri: string;
+    _meta?: ACPMetadata | null;
+};
+type ACPEmbeddedResource = {
+    annotations?: ACPAnnotations | null;
+    resource: ACPTextResourceContents | ACPBlobResourceContents;
+    _meta?: ACPMetadata | null;
+};
+type ACPContentBlock = (ACPTextContent & {
+    type: 'text';
+}) | (ACPImageContent & {
+    type: 'image';
+}) | (ACPAudioContent & {
+    type: 'audio';
+}) | (ACPResourceLink & {
+    type: 'resource_link';
+}) | (ACPEmbeddedResource & {
+    type: 'resource';
+});
+type ACPToolCallContent = {
+    type: 'content';
+    content: ACPContentBlock;
+    _meta?: ACPMetadata | null;
+} | {
+    type: 'diff';
+    path: string;
+    oldText?: string | null;
+    newText: 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;
+};
+type ACPToolCall = {
+    toolCallId: string;
+    title: string;
+    kind?: ACPToolKind;
+    status?: ACPToolCallStatus;
+    content?: Array<ACPToolCallContent>;
+    locations?: Array<ACPToolCallLocation>;
+    rawInput?: unknown;
+    rawOutput?: unknown;
+    _meta?: ACPMetadata | null;
+};
+
 type ACPSerializablePrimitive = string | number | boolean | null;
 type ACPSerializableValue = ACPSerializablePrimitive | ReadonlyArray<ACPSerializableValue> | {
     readonly [key: string]: ACPSerializableValue;
@@ -14,28 +112,22 @@ type ACPValueSource = {
 type ACPProfileValue = ACPSerializablePrimitive | ACPValueSource | ReadonlyArray<ACPProfileValue> | {
     readonly [key: string]: ACPProfileValue;
 };
-type ACPNpmLaunchSettings = {
-    readonly type: 'npm';
-    readonly executable: string;
-    readonly args?: ReadonlyArray<string>;
-    readonly forwardEnv?: ReadonlyArray<string>;
+type ACPNpmSimpleSource = {
+    readonly type: 'npm-simple';
+    readonly packageName: string;
     /**
-     * Runtime environment values that are safe to persist in bootstrap and
-     * lifecycle compatibility identity.
+     * 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 env?: Readonly<Record<string, string>>;
+    readonly packageVersion?: string;
 };
-type ACPSimpleNpmImplementation = ACPNpmLaunchSettings & {
-    readonly mode: 'simple';
-    readonly packageName: string;
-    readonly version: string;
-};
-type ACPLockedNpmImplementation = ACPNpmLaunchSettings & {
-    readonly mode: 'locked';
+type ACPNpmLockedSource = {
+    readonly type: 'npm-locked';
     readonly packageJson: string;
     readonly pnpmLockYaml: string;
 };
-type ACPNpmImplementation = ACPSimpleNpmImplementation | ACPLockedNpmImplementation;
+type ACPSource = ACPNpmSimpleSource | ACPNpmLockedSource;
 type ACPAuthentication = {
     readonly methodId: string;
     readonly meta?: Readonly<Record<string, ACPSerializableValue>>;
@@ -59,8 +151,18 @@ type ACPPermissionModeMapping = Readonly<Record<HarnessV1PermissionMode, ACPPerm
 type ACPV1Settings = {
     readonly version?: 'v1';
     readonly harnessId: string;
+    readonly mcpServers?: Record<string, unknown>;
+    readonly isMcpToolCall?: (toolCall: ACPToolCall) => boolean;
     readonly auth?: ACPProviderAuthenticationMode;
-    readonly implementation: ACPNpmImplementation;
+    readonly source: ACPSource;
+    readonly executable: string;
+    readonly args?: ReadonlyArray<string>;
+    readonly forwardEnv?: ReadonlyArray<string>;
+    /**
+     * Runtime environment values that are safe to persist in bootstrap and
+     * lifecycle compatibility identity.
+     */
+    readonly env?: Readonly<Record<string, string>>;
     readonly authentication?: ACPAuthentication;
     readonly providerAuthentication?: ACPProviderAuthentication;
     readonly modelId?: string;
@@ -68,6 +170,11 @@ type ACPV1Settings = {
     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?: (sandboxId: string) => string;
 };
 
 type ACPAuthOptions = ACPProviderAuthenticationMode;
@@ -78,21 +185,32 @@ type ACPClientApp = {
 
 type ACPHarnessSettings<TBuiltinTools extends ToolSet = {}> = {
     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;
     readonly startupTimeoutMs?: number;
     readonly clientApp?: ACPClientApp;
     readonly version?: ACPV1Settings['version'];
     readonly harnessId: ACPV1Settings['harnessId'];
     readonly auth?: ACPV1Settings['auth'];
-    readonly implementation: ACPV1Settings['implementation'];
+    readonly source: ACPV1Settings['source'];
+    readonly executable: ACPV1Settings['executable'];
+    readonly args?: ACPV1Settings['args'];
+    readonly forwardEnv?: ACPV1Settings['forwardEnv'];
+    readonly env?: ACPV1Settings['env'];
     readonly authentication?: ACPV1Settings['authentication'];
     readonly providerAuthentication?: ACPV1Settings['providerAuthentication'];
     readonly modelId?: ACPV1Settings['modelId'];
     readonly permissionModeMapping?: ACPV1Settings['permissionModeMapping'];
     readonly session?: ACPV1Settings['session'];
+    readonly mintBridgeToken?: ACPV1Settings['mintBridgeToken'];
 };
 declare function createACP<TBuiltinTools extends ToolSet = {}>(settings: ACPHarnessSettings<TBuiltinTools>): HarnessV1<TBuiltinTools>;
 
 declare const VERSION: string;
 
-export { type ACPAuthOptions, type ACPAuthentication, type ACPClientApp, type ACPHarnessSettings, type ACPLockedNpmImplementation, type ACPNpmImplementation, type ACPPermissionModeMapping, type ACPPermissionModeTarget, type ACPProfileValue, type ACPProviderAuthentication, type ACPProviderAuthenticationMode, type ACPSerializablePrimitive, type ACPSerializableValue, type ACPSimpleNpmImplementation, type ACPV1Settings, type ACPValueSource, VERSION, createACP };
+export { type ACPAnnotations, type ACPAudioContent, type ACPAuthOptions, type ACPAuthentication, type ACPBlobResourceContents, type ACPClientApp, type ACPContentBlock, type ACPEmbeddedResource, type ACPHarnessSettings, type ACPImageContent, type ACPMetadata, type ACPNpmLockedSource, type ACPNpmSimpleSource, type ACPPermissionModeMapping, type ACPPermissionModeTarget, type ACPProfileValue, type ACPProviderAuthentication, type ACPProviderAuthenticationMode, 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 };