@ai-sdk/harness-claude-code 1.0.72 → 1.0.74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/harness-claude-code",
-  "version": "1.0.72",
+  "version": "1.0.74",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "ws": "^8.21.0",
-    "@ai-sdk/harness": "1.0.70",
+    "@ai-sdk/harness": "1.0.71",
     "@ai-sdk/provider-utils": "5.0.27"
   },
   "peerDependencies": {

package/src/bridge/index.ts

@@ -347,6 +347,7 @@ async function runTurn(start: StartMessage, turn: BridgeTurn): Promise<void> {
         : {}),
       systemPrompt: createClaudeCodeSystemPrompt(start.instructions),
       thinking: start.thinking,
+      ...(start.effort !== undefined ? { effort: start.effort } : {}),
       includePartialMessages: true,
       // The `PostCompact` hook carries the compaction summary, which the
       // `compact_boundary` system message does not. Latch it for the unified

package/src/claude-code-auth.ts

@@ -4,7 +4,12 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { getAiGatewayAuthFromEnv } from '@ai-sdk/harness/utils';
 
-export type ClaudeCodeAuthOptions = {
+export type ClaudeCodeAuthenticationMode = 'auto' | 'direct' | 'ai-gateway';
+
+/**
+ * @deprecated Passing an object to auth options is deprecated. Use a `ClaudeCodeAuthenticationMode` string value ("auto" | "direct" | "ai-gateway") instead, and pass credentials via environment variables.
+ */
+export type LegacyClaudeCodeAuthOptions = {
   readonly anthropic?: {
     readonly apiKey?: string;
     readonly authToken?: string;
@@ -16,6 +21,10 @@ export type ClaudeCodeAuthOptions = {
   };
 };
 
+export type ClaudeCodeAuthOptions =
+  | ClaudeCodeAuthenticationMode
+  | LegacyClaudeCodeAuthOptions;
+
 /**
  * Resolve the environment-variable blob the bridge needs to authenticate
  * with Anthropic (directly or via the Vercel AI Gateway). Precedence:
@@ -42,15 +51,21 @@ export function resolveClaudeCodeEnv(
   processEnv: Record<string, string | undefined> = process.env,
   options: ResolveClaudeCodeEnvOptions = {},
 ): Record<string, string> {
+  const normalizedAuth = normalizeClaudeCodeAuthToLegacyAuth(auth);
+
   const readApiKey = options.readApiKeyHelper ?? readApiKeyHelper;
-  if (auth?.anthropic) {
-    return pickAnthropic({ explicit: auth.anthropic, processEnv, readApiKey });
+  if (normalizedAuth?.anthropic) {
+    return pickAnthropic({
+      explicit: normalizedAuth.anthropic,
+      processEnv,
+      readApiKey,
+    });
   }
 
   const gatewayAuthFromEnv = getAiGatewayAuthFromEnv({ env: processEnv });
-  if (auth?.gateway) {
+  if (normalizedAuth?.gateway) {
     return pickGateway({
-      explicit: auth.gateway,
+      explicit: normalizedAuth.gateway,
       gatewayAuthFromEnv,
     });
   }
@@ -64,12 +79,35 @@ export function resolveClaudeCodeEnv(
   return pickAnthropic({ processEnv, readApiKey });
 }
 
+function normalizeClaudeCodeAuthToLegacyAuth(
+  auth: ClaudeCodeAuthOptions | undefined,
+): LegacyClaudeCodeAuthOptions | undefined {
+  if (auth == null || auth === 'auto') {
+    return undefined;
+  }
+  if (typeof auth === 'string') {
+    switch (auth) {
+      case 'direct':
+        return { anthropic: {} };
+      case 'ai-gateway':
+        return { gateway: {} };
+      default:
+        return undefined;
+    }
+  }
+
+  console.warn(
+    '[claude-code] Passing an object to auth options is deprecated. Use a string mode ("auto" | "direct" | "ai-gateway") instead, and pass credentials via environment variables.',
+  );
+  return auth;
+}
+
 function pickAnthropic({
   explicit,
   processEnv,
   readApiKey,
 }: {
-  explicit?: NonNullable<ClaudeCodeAuthOptions['anthropic']>;
+  explicit?: NonNullable<LegacyClaudeCodeAuthOptions['anthropic']>;
   processEnv: Record<string, string | undefined>;
   readApiKey: () => string | undefined;
 }): Record<string, string> {
@@ -125,7 +163,7 @@ function pickGateway({
   explicit,
   gatewayAuthFromEnv,
 }: {
-  explicit: NonNullable<ClaudeCodeAuthOptions['gateway']>;
+  explicit: NonNullable<LegacyClaudeCodeAuthOptions['gateway']>;
   gatewayAuthFromEnv: ReturnType<typeof getAiGatewayAuthFromEnv>;
 }): Record<string, string> {
   const apiKey = explicit.apiKey ?? gatewayAuthFromEnv.apiKey;

package/src/claude-code-bridge-protocol.ts

@@ -33,6 +33,7 @@ const thinkingSchema = z.discriminatedUnion('type', [
 export const startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
   instructions: z.string().optional(),
   thinking: thinkingSchema,
+  effort: z.enum(['low', 'medium', 'high', 'xhigh', 'max']).optional(),
   maxTurns: z.number().optional(),
   env: z.record(z.string(), z.string()).optional(),
   skills: z.array(z.string()).optional(),

package/src/claude-code-harness.ts

@@ -89,6 +89,11 @@ export type ClaudeCodeHarnessSettings = {
    * omitted. Defaults to `{ type: 'adaptive', display: 'summarized' }`.
    */
   readonly thinking?: ClaudeCodeThinkingConfig;
+  /**
+   * Controls how much effort Claude applies when adaptive thinking is enabled.
+   * Unset uses the Claude Agent SDK default.
+   */
+  readonly effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
   /**
    * Override the port the bridge binds inside the sandbox. By default the
    * adapter uses the first port the sandbox declares via `sandbox.ports`.
@@ -919,6 +924,7 @@ export function createClaudeCode(
             maxTurns: settings.maxTurns,
             env: settings.env,
             thinking,
+            effort: settings.effort,
             isResume: true,
             continueOnFirstPrompt: false,
             rerunContinue: false,
@@ -1094,6 +1100,7 @@ export function createClaudeCode(
         maxTurns: settings.maxTurns,
         env: settings.env,
         thinking,
+        effort: settings.effort,
         isResume: respawnStrategy !== undefined,
         continueOnFirstPrompt: respawnStrategy !== undefined,
         rerunContinue: respawnStrategy === 'rerun',
@@ -1352,6 +1359,7 @@ function createSession({
   maxTurns,
   env,
   thinking,
+  effort,
   isResume,
   continueOnFirstPrompt,
   rerunContinue,
@@ -1372,6 +1380,7 @@ function createSession({
   maxTurns: number | undefined;
   env: Readonly<Record<string, string>> | undefined;
   thinking: ClaudeCodeThinkingConfig;
+  effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | undefined;
   isResume: boolean;
   continueOnFirstPrompt: boolean;
   rerunContinue: boolean;
@@ -1554,6 +1563,7 @@ function createSession({
         maxTurns,
         ...(env !== undefined ? { env } : {}),
         thinking,
+        ...(effort !== undefined ? { effort } : {}),
         ...(skills.length > 0
           ? { skills: skills.map(skill => skill.name) }
           : {}),
@@ -1611,6 +1621,7 @@ function createSession({
           maxTurns,
           ...(env !== undefined ? { env } : {}),
           thinking,
+          ...(effort !== undefined ? { effort } : {}),
           ...(skills.length > 0
             ? { skills: skills.map(skill => skill.name) }
             : {}),

package/src/index.ts

@@ -10,5 +10,8 @@ export const claudeCode = createClaudeCode();
 export { createClaudeCode } from './claude-code-harness';
 export { VERSION } from './version';
 export type { ClaudeCodeHarnessSettings } from './claude-code-harness';
-export type { ClaudeCodeAuthOptions } from './claude-code-auth';
+export type {
+  ClaudeCodeAuthenticationMode,
+  ClaudeCodeAuthOptions,
+} from './claude-code-auth';
 export type { ClaudeCodeThinkingConfig } from './claude-code-thinking';