@ai-sdk/harness-claude-code 1.0.171 → 1.0.173

package/src/claude-code-harness.ts

@@ -99,6 +99,23 @@ export type ClaudeCodeHarnessSettings = {
    * underlying runtime's native MCP server configuration format.
    */
   readonly mcpServers?: Record<string, unknown>;
+  /**
+   * Claude Code hints for host tools, keyed by tool name.
+   *
+   * - `readOnly`: the tool has no side effects. Claude Code can run read-only
+   *   tool calls in parallel, and runs each call to any other host tool on
+   *   its own. It also allows read-only tools in plan mode, so mark only
+   *   tools that change nothing.
+   * - `alwaysLoad`: when Claude Code's tool search is on, it defers MCP tools
+   *   until the model looks them up; this sends the tool's definition from
+   *   the first request instead.
+   */
+  readonly toolHints?: Readonly<
+    Record<
+      string,
+      { readonly readOnly?: boolean; readonly alwaysLoad?: boolean }
+    >
+  >;
   /**
    * Hard cap on how many internal turns the CLI can take before yielding
    * back to the caller. Unset means the CLI's default.
@@ -1101,6 +1118,7 @@ export function createClaudeCode(
             sandbox: toolSafeSandboxSession,
             sandboxHomeDir,
             mcpServers: settings.mcpServers,
+            toolHints: settings.toolHints,
             supportsUserMessageResponses: () => supportsUserMessageResponses,
           });
         } catch {
@@ -1266,6 +1284,15 @@ export function createClaudeCode(
         continueOnFirstPrompt: respawnStrategy !== undefined,
         ...(resumeSessionId ? { resumeSessionId } : {}),
         rerunContinue: respawnStrategy === 'rerun',
+        ...(respawnStrategy === 'rerun'
+          ? {
+              deferredToolUseId: (
+                startOpts.continueFrom ?? startOpts.resumeFrom?.continueFrom
+              )?.pendingToolApprovals?.find(
+                approval => approval.kind === 'builtin',
+              )?.toolCallId,
+            }
+          : {}),
         bridgePort: boundPort,
         bridgeToken: token,
         sandboxId,
@@ -1276,6 +1303,7 @@ export function createClaudeCode(
         sandbox: toolSafeSandboxSession,
         sandboxHomeDir,
         mcpServers: settings.mcpServers,
+        toolHints: settings.toolHints,
         supportsUserMessageResponses: () => supportsUserMessageResponses,
       });
     },
@@ -1308,6 +1336,7 @@ function createSession({
   continueOnFirstPrompt,
   resumeSessionId,
   rerunContinue,
+  deferredToolUseId,
   bridgePort,
   bridgeToken,
   sandboxId,
@@ -1318,6 +1347,7 @@ function createSession({
   sandbox,
   sandboxHomeDir,
   mcpServers,
+  toolHints,
   supportsUserMessageResponses,
 }: {
   sessionId: string;
@@ -1344,6 +1374,12 @@ function createSession({
    */
   resumeSessionId?: string;
   rerunContinue: boolean;
+  /**
+   * Built-in tool call the previous bridge deferred while it waited for host
+   * approval. The respawned bridge resumes it once the host answers instead
+   * of starting a new turn.
+   */
+  deferredToolUseId?: string;
   bridgePort: number;
   bridgeToken: string;
   sandboxId: string | undefined;
@@ -1354,6 +1390,7 @@ function createSession({
   sandbox: SandboxSession;
   sandboxHomeDir: string;
   mcpServers: Record<string, unknown> | undefined;
+  toolHints: ClaudeCodeHarnessSettings['toolHints'];
   supportsUserMessageResponses: () => boolean;
 }): HarnessV1Session {
   let stopped = false;
@@ -1624,6 +1661,7 @@ function createSession({
           ? { skills: promptOpts.skills.map(skill => skill.name) }
           : {}),
         ...(mcpServers == null ? {} : { mcpServers }),
+        ...(toolHints == null ? {} : { toolHints }),
         ...(permissionMode ? { permissionMode } : {}),
         ...(builtinToolFiltering ? { builtinToolFiltering } : {}),
         ...(debug ? { debug } : {}),
@@ -1701,12 +1739,14 @@ function createSession({
             ? { skills: continueOpts.skills.map(skill => skill.name) }
             : {}),
           ...(mcpServers == null ? {} : { mcpServers }),
+          ...(toolHints == null ? {} : { toolHints }),
           ...(permissionMode ? { permissionMode } : {}),
           ...(builtinToolFiltering ? { builtinToolFiltering } : {}),
           ...(debug ? { debug } : {}),
           ...(lastClaudeSessionId
             ? { resumeSessionId: lastClaudeSessionId }
             : { continue: true }),
+          ...(deferredToolUseId != null ? { deferredToolUseId } : {}),
         });
       }