@ai-sdk/harness-acp 1.0.31 → 1.0.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/harness-acp",
-  "version": "1.0.31",
+  "version": "1.0.32",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -26,8 +26,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/harness": "1.0.93",
-    "@ai-sdk/provider-utils": "5.0.33",
+    "@ai-sdk/harness": "1.0.94",
+    "@ai-sdk/provider-utils": "5.0.34",
     "ws": "^8.21.0"
   },
   "peerDependencies": {

package/src/acp-harness.ts

@@ -48,11 +48,12 @@ export type ACPHarnessSettings<TBuiltinTools extends ToolSet = {}> = {
   readonly credentialForwarding?: ACPV1Settings['credentialForwarding'];
   readonly env?: ACPV1Settings['env'];
   readonly authentication?: ACPV1Settings['authentication'];
+  readonly clientCapabilities?: ACPV1Settings['clientCapabilities'];
   readonly providerAuthentication?: ACPV1Settings['providerAuthentication'];
   /**
-   * Maps a HarnessAgent model identifier to implementation launch settings.
+   * Maps the HarnessAgent model identifier to an ACP session operation.
    */
-  readonly resolveModel: ACPV1Settings['resolveModel'];
+  readonly modelMapping: ACPV1Settings['modelMapping'];
   /**
    * @deprecated Use `model` on `HarnessAgent` instead.
    */

package/src/index.ts

@@ -24,8 +24,7 @@ export type {
   ACPAuthentication,
   ACPInstallCommandSource,
   ACPInstructionMapping,
-  ACPModelResolution,
-  ACPModelResolver,
+  ACPModelMapping,
   ACPNpmLockedSource,
   ACPNpmSimpleSource,
   ACPOutputSchemaMapping,

package/src/v1/acp-v1-bridge-protocol.ts

@@ -14,6 +14,7 @@ import { z } from 'zod/v4';
 import type { ACPToolCall } from '../acp-tool-call';
 import type {
   ACPInstructionMapping,
+  ACPModelMapping,
   ACPPermissionModeMapping,
 } from './acp-v1-settings';
 import { acpTextContentBlockSchema } from './acp-v1-prompt';
@@ -125,6 +126,20 @@ const outputSchemaMappingSchema: z.ZodType<ACPSerializableOutputSchemaMapping> =
     path: z.array(z.string().min(1)).min(1),
   });
 
+const modelMappingSchema: z.ZodType<ACPModelMapping> = z.discriminatedUnion(
+  'type',
+  [
+    z.object({
+      type: z.literal('session-config-option'),
+      path: z.string().min(1),
+    }),
+    z.object({
+      type: z.literal('session-model'),
+      path: z.string().min(1),
+    }),
+  ],
+);
+
 export type ACPTurnStartConfig = {
   readonly version: 1;
   readonly configurationFingerprint: string;
@@ -133,6 +148,8 @@ export type ACPTurnStartConfig = {
   readonly builtinTools: Array<ACPBuiltinToolMapping>;
   readonly permissionMode: HarnessV1PermissionMode;
   readonly permissionModeMapping?: ACPPermissionModeMapping;
+  readonly model?: string;
+  readonly modelMapping?: ACPModelMapping;
   readonly debug?: HarnessV1DebugConfig;
   readonly responseFormat?: z.infer<
     typeof harnessV1BridgeStartBaseSchema
@@ -148,6 +165,8 @@ export const acpTurnStartConfigSchema = z.object({
   builtinTools: z.array(builtinToolSchema).default([]),
   permissionMode: harnessV1BridgeStartBaseSchema.shape.permissionMode.unwrap(),
   permissionModeMapping: permissionModeMappingSchema.optional(),
+  model: harnessV1BridgeStartBaseSchema.shape.model.optional(),
+  modelMapping: modelMappingSchema.optional(),
   debug: harnessV1BridgeStartBaseSchema.shape.debug.optional(),
   responseFormat:
     harnessV1BridgeStartBaseSchema.shape.responseFormat.optional(),
@@ -156,14 +175,15 @@ export const acpTurnStartConfigSchema = z.object({
 
 export type ACPColdSessionState = Omit<
   ACPTurnStartConfig,
-  'prompt' | 'debug'
-> & {
-  readonly modelId?: string;
-};
+  'prompt' | 'debug' | 'model' | 'modelMapping'
+>;
 
 export const acpColdSessionStateSchema: z.ZodType<ACPColdSessionState> =
-  acpTurnStartConfigSchema.omit({ prompt: true, debug: true }).extend({
-    modelId: z.string().optional(),
+  acpTurnStartConfigSchema.omit({
+    prompt: true,
+    debug: true,
+    model: true,
+    modelMapping: true,
   });
 
 const lossyRecoverySchema = z.object({
@@ -203,6 +223,7 @@ export const startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
   tools: z.array(acpSerializableToolSpecSchema).optional(),
   builtinTools: z.array(builtinToolSchema).readonly().default([]),
   permissionModeMapping: permissionModeMappingSchema.optional(),
+  modelMapping: modelMappingSchema.optional(),
   turnStartConfig: acpTurnStartConfigSchema,
   recoveryMode: z
     .discriminatedUnion('type', [lossyRecoverySchema, coldRestoreSchema])

package/src/v1/acp-v1-harness.ts

@@ -80,6 +80,7 @@ import {
 } from './acp-v1-prompt';
 import type {
   ACPInstructionMapping,
+  ACPModelMapping,
   ACPOutputSchemaMapping,
   ACPPermissionModeMapping,
   ACPPermissionModeTarget,
@@ -158,11 +159,11 @@ export function createACPV1<TBuiltinTools extends ToolSet = {}>({
       `ACP harnessId must be a stable kebab-case identifier; received ${JSON.stringify(settings.harnessId)}.`,
     );
   }
-  const baseImplementation = createACPV1Implementation({ settings });
-  validateACPV1Implementation(baseImplementation);
+  const implementation = createACPV1Implementation({ settings });
+  validateACPV1Implementation(implementation);
   const bootstrap = createACPBootstrap({
     harnessId: settings.harnessId,
-    implementation: baseImplementation,
+    implementation,
   });
   const permissionModeMapping = isCompletePermissionModeMapping({
     value: settings.permissionModeMapping,
@@ -186,24 +187,6 @@ export function createACPV1<TBuiltinTools extends ToolSet = {}>({
             'ACP built-in tool filtering is not available in this initial ACP v1 implementation.',
         });
       }
-      const modelId = startOptions.model ?? settings.modelId;
-      const modelConfiguration =
-        modelId == null ? undefined : settings.resolveModel({ model: modelId });
-      const implementation = {
-        ...baseImplementation,
-        ...(modelConfiguration?.args == null
-          ? {}
-          : { args: modelConfiguration.args }),
-        ...(modelConfiguration?.env == null
-          ? {}
-          : {
-              env: {
-                ...baseImplementation.env,
-                ...modelConfiguration.env,
-              },
-            }),
-      };
-      validateACPV1Implementation(implementation);
       const permissionMode = startOptions.permissionMode ?? 'allow-all';
       const env = { ...process.env };
       const authenticationEnvironment = resolveACPAuthenticationEnvironment({
@@ -221,6 +204,8 @@ export function createACPV1<TBuiltinTools extends ToolSet = {}>({
         acpVersion: 'v1',
         implementation,
         clientApp,
+        clientCapabilities: settings.clientCapabilities,
+        modelMapping: settings.modelMapping,
         providerAuthentication: providerAuthenticationCompatibility,
         permissionModeMapping: settings.permissionModeMapping,
       });
@@ -452,7 +437,8 @@ export function createACPV1<TBuiltinTools extends ToolSet = {}>({
               harnessId: settings.harnessId,
               channel: attachChannel,
               proc: undefined,
-              modelId,
+              modelMapping: settings.modelMapping,
+              defaultModelId: settings.modelId,
               sessionMeta: settings.session?.meta,
               instructionMapping: settings.instructionMapping,
               outputSchemaMapping: settings.outputSchemaMapping,
@@ -518,6 +504,7 @@ export function createACPV1<TBuiltinTools extends ToolSet = {}>({
                   sessionMeta: settings.session?.meta,
                   instructionMapping: settings.instructionMapping,
                   outputSchemaMapping: settings.outputSchemaMapping,
+                  modelMapping: settings.modelMapping,
                   builtinTools: builtinToolCatalog,
                   permissionModeMapping,
                   mcpServers: settings.mcpServers,
@@ -544,12 +531,12 @@ export function createACPV1<TBuiltinTools extends ToolSet = {}>({
           }
           const turnStartConfig = validateACPColdSessionConfiguration({
             coldSession,
-            modelId,
             permissionMode,
             authenticationProfile,
             sessionMeta: settings.session?.meta,
             instructionMapping: settings.instructionMapping,
             outputSchemaMapping: settings.outputSchemaMapping,
+            modelMapping: settings.modelMapping,
             builtinTools: builtinToolCatalog,
             permissionModeMapping,
             mcpServers: settings.mcpServers,
@@ -608,8 +595,7 @@ export function createACPV1<TBuiltinTools extends ToolSet = {}>({
             providerEnvironment:
               sandboxProviderEnvironment == null ? undefined : {},
             sessionMeta: settings.session?.meta,
-            implementationArgs: modelConfiguration?.args,
-            implementationEnv: modelConfiguration?.env,
+            clientCapabilities: settings.clientCapabilities,
           }),
           ...sandboxProviderAuthenticationEnvironment,
           BRIDGE_CHANNEL_TOKEN: token,
@@ -722,7 +708,8 @@ export function createACPV1<TBuiltinTools extends ToolSet = {}>({
         harnessId: settings.harnessId,
         channel,
         proc,
-        modelId,
+        modelMapping: settings.modelMapping,
+        defaultModelId: settings.modelId,
         sessionMeta: settings.session?.meta,
         instructionMapping: settings.instructionMapping,
         outputSchemaMapping: settings.outputSchemaMapping,
@@ -1046,7 +1033,8 @@ function createSession({
   harnessId,
   channel,
   proc,
-  modelId,
+  modelMapping,
+  defaultModelId,
   sessionMeta,
   instructionMapping,
   outputSchemaMapping,
@@ -1081,7 +1069,8 @@ function createSession({
   harnessId: string;
   channel: ACPChannel;
   proc: Experimental_SandboxProcess | undefined;
-  modelId: string | undefined;
+  modelMapping: ACPModelMapping;
+  defaultModelId: string | undefined;
   sessionMeta: Readonly<Record<string, ACPSerializableValue>> | undefined;
   instructionMapping: ACPInstructionMapping | undefined;
   outputSchemaMapping: ACPOutputSchemaMapping | undefined;
@@ -1375,7 +1364,6 @@ function createSession({
       : {
           coldSession: createACPColdSessionState({
             turnStartConfig: latestTurnStartConfig,
-            modelId,
           }),
         }),
     ...(!includeTurnStartConfig || latestTurnStartConfig == null
@@ -1407,7 +1395,6 @@ function createSession({
   return {
     sessionId,
     isResume,
-    ...(modelId == null ? {} : { modelId }),
     doPromptTurn: async options => {
       await synchronizeSkills({
         skills: options.skills,
@@ -1442,6 +1429,7 @@ function createSession({
         prompt: options.prompt,
         harnessId,
       });
+      const model = options.model ?? defaultModelId;
       const turnStartConfig = createACPTurnStartConfig({
         prompt,
         tools: options.tools ?? [],
@@ -1455,6 +1443,8 @@ function createSession({
         instructionMapping,
         responseFormat: options.responseFormat,
         outputSchemaMapping,
+        model,
+        modelMapping,
       });
       const nextInstructionsFingerprint = fingerprintValue({
         value: options.instructions ?? null,
@@ -1491,6 +1481,7 @@ function createSession({
             builtinTools,
             permissionMode,
             permissionModeMapping,
+            ...(model == null ? {} : { model, modelMapping }),
             ...(options.responseFormat == null
               ? {}
               : { responseFormat: options.responseFormat }),
@@ -1554,6 +1545,12 @@ function createSession({
             builtinTools: turnStartConfig.builtinTools,
             permissionMode: turnStartConfig.permissionMode,
             permissionModeMapping: turnStartConfig.permissionModeMapping,
+            ...(turnStartConfig.model == null
+              ? {}
+              : {
+                  model: turnStartConfig.model,
+                  modelMapping: turnStartConfig.modelMapping,
+                }),
             ...(turnStartConfig.responseFormat == null
               ? {}
               : { responseFormat: turnStartConfig.responseFormat }),
@@ -1751,6 +1748,7 @@ function validateACPTurnStartConfig({
   sessionMeta,
   instructionMapping,
   outputSchemaMapping,
+  modelMapping,
   builtinTools,
   permissionModeMapping,
   mcpServers,
@@ -1760,6 +1758,7 @@ function validateACPTurnStartConfig({
   sessionMeta: Readonly<Record<string, ACPSerializableValue>> | undefined;
   instructionMapping: ACPInstructionMapping | undefined;
   outputSchemaMapping: ACPOutputSchemaMapping | undefined;
+  modelMapping: ACPModelMapping;
   builtinTools: ReadonlyArray<ACPBuiltinToolMapping>;
   permissionModeMapping: ACPPermissionModeMapping | undefined;
   mcpServers: Record<string, unknown> | undefined;
@@ -1777,6 +1776,8 @@ function validateACPTurnStartConfig({
     instructionMapping,
     responseFormat: turnStartConfig.responseFormat,
     outputSchemaMapping,
+    model: turnStartConfig.model,
+    modelMapping,
   });
   if (
     current.configurationFingerprint !==
@@ -1790,24 +1791,24 @@ function validateACPTurnStartConfig({
 
 function validateACPColdSessionConfiguration({
   coldSession,
-  modelId,
   permissionMode,
   authenticationProfile,
   sessionMeta,
   instructionMapping,
   outputSchemaMapping,
+  modelMapping,
   builtinTools,
   permissionModeMapping,
   mcpServers,
   debug,
 }: {
   coldSession: ACPColdSessionState;
-  modelId: string | undefined;
   permissionMode: NonNullable<StartMessage['permissionMode']>;
   authenticationProfile: ACPAuthenticationProfileIdentity;
   sessionMeta: Readonly<Record<string, ACPSerializableValue>> | undefined;
   instructionMapping: ACPInstructionMapping | undefined;
   outputSchemaMapping: ACPOutputSchemaMapping | undefined;
+  modelMapping: ACPModelMapping;
   builtinTools: ReadonlyArray<ACPBuiltinToolMapping>;
   permissionModeMapping: ACPPermissionModeMapping | undefined;
   mcpServers: Record<string, unknown> | undefined;
@@ -1826,11 +1827,12 @@ function validateACPColdSessionConfiguration({
     instructionMapping,
     responseFormat: coldSession.responseFormat,
     outputSchemaMapping,
+    model: undefined,
+    modelMapping,
   });
   if (
     current.configurationFingerprint !== coldSession.configurationFingerprint ||
-    coldSession.permissionMode !== permissionMode ||
-    coldSession.modelId !== modelId
+    coldSession.permissionMode !== permissionMode
   ) {
     throw new Error(
       'ACP cold-session state is incompatible with the current non-secret session configuration.',

package/src/v1/acp-v1-settings.ts

@@ -75,20 +75,15 @@ export type ACPProviderAuthentication = {
   };
 };
 
-export type ACPModelResolution = {
-  /**
-   * Replaces the implementation's static launch arguments.
-   */
-  readonly args?: ReadonlyArray<string>;
-  /**
-   * Overlays the implementation's static launch environment.
-   */
-  readonly env?: Readonly<Record<string, string>>;
-};
-
-export type ACPModelResolver = (options: {
-  readonly model: string;
-}) => ACPModelResolution;
+export type ACPModelMapping =
+  | {
+      readonly type: 'session-config-option';
+      readonly path: string;
+    }
+  | {
+      readonly type: 'session-model';
+      readonly path: string;
+    };
 
 export type ACPCredentialBrokering = ({
   env,
@@ -158,11 +153,12 @@ export type ACPV1Settings = {
    */
   readonly env?: Readonly<Record<string, string>>;
   readonly authentication?: ACPAuthentication;
+  readonly clientCapabilities?: Readonly<Record<string, ACPSerializableValue>>;
   readonly providerAuthentication?: ACPProviderAuthentication;
   /**
-   * Maps a HarnessAgent model identifier to implementation launch settings.
+   * Maps the HarnessAgent model identifier to an ACP session operation.
    */
-  readonly resolveModel: ACPModelResolver;
+  readonly modelMapping: ACPModelMapping;
   /**
    * @deprecated Use `model` on `HarnessAgent` instead.
    */

package/src/v1/acp-v1-turn-start-config.ts

@@ -11,6 +11,7 @@ import {
 import type { ACPTextContentBlock } from './acp-v1-prompt';
 import type {
   ACPInstructionMapping,
+  ACPModelMapping,
   ACPOutputSchemaMapping,
   ACPPermissionModeMapping,
   ACPSerializableValue,
@@ -29,6 +30,8 @@ export function createACPTurnStartConfig({
   instructionMapping,
   responseFormat,
   outputSchemaMapping,
+  model,
+  modelMapping,
 }: {
   prompt: ReadonlyArray<ACPTextContentBlock>;
   tools: ReadonlyArray<HarnessV1ToolSpec>;
@@ -42,6 +45,8 @@ export function createACPTurnStartConfig({
   instructionMapping: ACPInstructionMapping | undefined;
   responseFormat: StartMessage['responseFormat'];
   outputSchemaMapping: ACPOutputSchemaMapping | undefined;
+  model: string | undefined;
+  modelMapping: ACPModelMapping;
 }): ACPTurnStartConfig {
   return {
     version: 1,
@@ -52,6 +57,7 @@ export function createACPTurnStartConfig({
           sessionMeta: sessionMeta ?? null,
           ...(instructionMapping == null ? {} : { instructionMapping }),
           ...(outputSchemaMapping == null ? {} : { outputSchemaMapping }),
+          modelMapping,
           builtinTools,
           permissionModeMapping: permissionModeMapping ?? null,
           mcpServers: mcpServers ?? null,
@@ -62,6 +68,7 @@ export function createACPTurnStartConfig({
     tools: tools.map(tool => acpSerializableToolSpecSchema.parse(tool)),
     builtinTools: [...builtinTools],
     permissionMode,
+    ...(model == null ? {} : { model, modelMapping }),
     ...(responseFormat == null ? {} : { responseFormat }),
     ...(outputSchemaMapping == null
       ? {}
@@ -78,10 +85,8 @@ export function createACPTurnStartConfig({
 
 export function createACPColdSessionState({
   turnStartConfig,
-  modelId,
 }: {
   turnStartConfig: ACPTurnStartConfig;
-  modelId: string | undefined;
 }): ACPColdSessionState {
   return {
     version: turnStartConfig.version,
@@ -98,7 +103,6 @@ export function createACPColdSessionState({
     ...(turnStartConfig.permissionModeMapping == null
       ? {}
       : { permissionModeMapping: turnStartConfig.permissionModeMapping }),
-    ...(modelId == null ? {} : { modelId }),
   };
 }
 

package/src/v1/bridge/acp-v1-bridge-environment.ts

@@ -59,8 +59,7 @@ export type ACPBridgeConfiguration = {
   readonly providerAuthentication?: ACPResolvedProviderAuthentication;
   readonly providerEnvironment?: Readonly<Record<string, string>>;
   readonly sessionMeta?: Readonly<Record<string, ACPSerializableValue>>;
-  readonly implementationArgs?: ReadonlyArray<string>;
-  readonly implementationEnv?: Readonly<Record<string, string>>;
+  readonly clientCapabilities?: Readonly<Record<string, ACPSerializableValue>>;
 };
 
 const bridgeConfigurationSchema: z.ZodType<ACPBridgeConfiguration> = z.object({
@@ -68,8 +67,7 @@ const bridgeConfigurationSchema: z.ZodType<ACPBridgeConfiguration> = z.object({
   providerAuthentication: providerAuthenticationSchema.optional(),
   providerEnvironment: z.record(z.string(), z.string()).optional(),
   sessionMeta: serializableRecordSchema.optional(),
-  implementationArgs: z.array(z.string()).optional(),
-  implementationEnv: z.record(z.string(), z.string()).optional(),
+  clientCapabilities: serializableRecordSchema.optional(),
 });
 
 export function createACPBridgeEnvironment({
@@ -77,8 +75,7 @@ export function createACPBridgeEnvironment({
   providerAuthentication,
   providerEnvironment,
   sessionMeta,
-  implementationArgs,
-  implementationEnv,
+  clientCapabilities,
 }: ACPBridgeConfiguration): Record<string, string> {
   return {
     [ACP_BRIDGE_CONFIGURATION_ENV]: JSON.stringify({
@@ -86,8 +83,7 @@ export function createACPBridgeEnvironment({
       ...(providerAuthentication == null ? {} : { providerAuthentication }),
       ...(providerEnvironment == null ? {} : { providerEnvironment }),
       ...(sessionMeta == null ? {} : { sessionMeta }),
-      ...(implementationArgs == null ? {} : { implementationArgs }),
-      ...(implementationEnv == null ? {} : { implementationEnv }),
+      ...(clientCapabilities == null ? {} : { clientCapabilities }),
     }),
   };
 }

package/src/v1/bridge/index.ts

@@ -44,6 +44,7 @@ import {
 } from './refresh-host-tool-catalog';
 import { createACPPermissionController } from './permission-controller';
 import { configureACPPermissionMode } from './permission-mode';
+import { configureACPModel } from './model-mapping';
 import {
   assertACPResumeCapability,
   createACPRecoveredSession,
@@ -214,6 +215,13 @@ async function runTurn(start: StartMessage, turn: BridgeTurn): Promise<void> {
     return;
   }
 
+  await configureACPModel({
+    agent: connection!.agent,
+    sessionId: activeSession.sessionId,
+    model: start.model,
+    mapping: start.modelMapping,
+  });
+
   let rejectCancellationFailure!: (error: unknown) => void;
   const cancellationFailure = new Promise<never>((_, reject) => {
     rejectCancellationFailure = reject;
@@ -419,12 +427,11 @@ async function ensureSession({
         implementationDir,
         privateHome: implementation.privateHome,
       }),
-      ...bridgeConfiguration.implementationEnv,
     },
   });
   child = spawn(
     `${implementationDir}/${implementation.executablePath}`,
-    [...(bridgeConfiguration.implementationArgs ?? implementation.args)],
+    [...implementation.args],
     {
       cwd: workDir,
       env: instructionConfiguration.environment,
@@ -475,6 +482,7 @@ async function ensureSession({
     protocolVersion: acp.PROTOCOL_VERSION,
     clientApp,
     authentication,
+    clientCapabilities: bridgeConfiguration.clientCapabilities,
     supportsBooleanSessionConfigOptions: Object.values(
       start.permissionModeMapping ?? {},
     ).some(

package/src/v1/bridge/model-mapping.ts

@@ -0,0 +1,35 @@
+import * as acp from '@agentclientprotocol/sdk';
+import type { ACPModelMapping } from '../acp-v1-settings';
+
+export async function configureACPModel({
+  agent,
+  sessionId,
+  model,
+  mapping,
+}: {
+  agent: acp.ClientContext;
+  sessionId: string;
+  model: string | undefined;
+  mapping: ACPModelMapping | undefined;
+}): Promise<void> {
+  if (model == null) return;
+  if (mapping == null) {
+    throw new Error('ACP model mapping is required when a model is set.');
+  }
+  /*
+   * Some ACP harnesses, including Grok Build, use the non-standard
+   * `session/set_model` convention.
+   */
+  if (mapping.type === 'session-model') {
+    await agent.request('session/set_model', {
+      sessionId,
+      [mapping.path]: model,
+    });
+    return;
+  }
+  await agent.request(acp.methods.agent.session.setConfigOption, {
+    sessionId,
+    configId: mapping.path,
+    value: model,
+  });
+}

package/src/v1/bridge/protocol-configuration.ts

@@ -16,11 +16,13 @@ export function createACPInitializeRequest({
   protocolVersion,
   clientApp,
   authentication,
+  clientCapabilities: configuredClientCapabilities,
   supportsBooleanSessionConfigOptions = false,
 }: {
   protocolVersion: number;
   clientApp: ACPClientApp;
   authentication: ACPAuthentication | undefined;
+  clientCapabilities?: Readonly<Record<string, unknown>>;
   supportsBooleanSessionConfigOptions?: boolean;
 }): {
   readonly protocolVersion: number;
@@ -30,8 +32,10 @@ export function createACPInitializeRequest({
   };
   readonly clientCapabilities: Readonly<Record<string, unknown>>;
 } {
-  let clientCapabilities: Readonly<Record<string, unknown>> =
-    authentication?.clientCapabilities ?? {};
+  let clientCapabilities = mergeRecords({
+    left: authentication?.clientCapabilities ?? {},
+    right: configuredClientCapabilities ?? {},
+  });
   if (supportsBooleanSessionConfigOptions) {
     clientCapabilities = mergeRecords({
       left: clientCapabilities,

package/src/v1/implementation.ts

@@ -4,8 +4,10 @@ import type {
   ACPProviderAuthenticationCompatibility,
 } from '../acp-auth';
 import type {
+  ACPModelMapping,
   ACPNpmSimpleSource,
   ACPPermissionModeMapping,
+  ACPSerializableValue,
   ACPSource,
   ACPV1Settings,
 } from './acp-v1-settings';
@@ -172,6 +174,8 @@ export function createImplementationIdentity({
   acpVersion,
   implementation,
   clientApp,
+  clientCapabilities,
+  modelMapping,
   providerAuthentication,
   permissionModeMapping,
 }: {
@@ -179,6 +183,8 @@ export function createImplementationIdentity({
   acpVersion: 'v1';
   implementation: ACPImplementation;
   clientApp: ACPClientApp;
+  clientCapabilities?: Readonly<Record<string, ACPSerializableValue>>;
+  modelMapping: ACPModelMapping;
   providerAuthentication: ACPProviderAuthenticationCompatibility | undefined;
   permissionModeMapping?: ACPPermissionModeMapping;
 }): string {
@@ -221,6 +227,8 @@ export function createImplementationIdentity({
     executable: implementation.executable,
     args: implementation.args ?? [],
     clientApp,
+    clientCapabilities: clientCapabilities ?? null,
+    modelMapping,
     environment: {
       forwarded: forwardedEnvironment,
       credential: credentialEnvironment,

package/src/v1/index.ts

@@ -5,8 +5,7 @@ export type {
   ACPAuthenticationMode,
   ACPInstallCommandSource,
   ACPInstructionMapping,
-  ACPModelResolution,
-  ACPModelResolver,
+  ACPModelMapping,
   ACPNpmLockedSource,
   ACPNpmSimpleSource,
   ACPOutputSchemaMapping,