@ai-sdk/harness-claude-code 1.0.65 → 1.0.67

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @ai-sdk/harness-claude-code
 
+## 1.0.67
+
+### Patch Changes
+
+- a03ff6c: feat(harness): add support for per-harness MCP servers
+- fc3baaf: feat(harness): add optional `mintBridgeToken(sandboxId)` to harness settings to control the bridge token value
+- cfc587b: fix(harness-claude-code): add missing Claude Code built-in tools
+- Updated dependencies [401a4ba]
+- Updated dependencies [a03ff6c]
+  - @ai-sdk/provider-utils@5.0.26
+  - @ai-sdk/harness@1.0.65
+
+## 1.0.66
+
+### Patch Changes
+
+- 8c95b3f: fix(harness-claude-code): fix built-in tool filtering by using actual denylist when passing `inactiveTools`
+- a65bbb2: feat(harness-claude-code): add optional `env` property to `createClaudeCode()` for custom env vars
+
 ## 1.0.65
 
 ### Patch Changes

package/README.md

@@ -62,3 +62,16 @@ try {
 ```
 
 The adapter requires a `HarnessV1SandboxProvider` whose handles expose at least one port — `@ai-sdk/sandbox-vercel` is the supported choice today. The agent calls `provider.createSession()` when a session starts. Use `session.detach()` to park the bridge and sandbox, `session.stop()` to save state and stop the sandbox, or `session.destroy()` to clean up without keeping resume state.
+
+## Runtime configuration
+
+Use `env` to add environment variables to the Claude Code process. Configured
+values override variables inherited from the sandbox bridge process.
+
+```ts
+const harness = createClaudeCode({
+  env: {
+    DEPLOYMENT_ENV: 'staging',
+  },
+});
+```

package/dist/bridge/index.mjs

@@ -491,7 +491,7 @@ function createCompactionLatch(emit) {
 
 // src/bridge/index.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import { argv, stdout as stdout2 } from "process";
+import { argv, env as procEnv2, stdout as stdout2 } from "process";
 import * as claudeAgentSdk from "@anthropic-ai/claude-agent-sdk";
 import * as mcpServerModule from "@modelcontextprotocol/sdk/server/mcp.js";
 
@@ -512,6 +512,7 @@ function createClaudeStreamEventState() {
     pendingStepUsage: void 0,
     stepOpen: false,
     mcpToolUseIds: /* @__PURE__ */ new Set(),
+    externalMcpToolUseIds: /* @__PURE__ */ new Set(),
     observedTerminalError: void 0
   };
 }
@@ -586,6 +587,8 @@ function createEmitStreamEvent({
             continue;
           }
           state.nativeToolCallNames.set(block.id, block.name);
+          const dynamic = block.name.startsWith("mcp__");
+          if (dynamic) state.externalMcpToolUseIds.add(block.id);
           if (state.approvalRequestedToolUseIds.has(block.id)) {
             continue;
           }
@@ -597,7 +600,8 @@ function createEmitStreamEvent({
             toolName: toCommonName2(block.name),
             nativeName: block.name,
             input: JSON.stringify(block.input ?? {}),
-            providerExecuted: true
+            providerExecuted: true,
+            ...dynamic ? { dynamic: true } : {}
           });
         }
       }
@@ -619,15 +623,17 @@ function createEmitStreamEvent({
           const nativeName = state.nativeToolCallNames.get(block.tool_use_id) ?? "unknown";
           state.nativeToolCallNames.delete(block.tool_use_id);
           const toolName = toCommonName2(nativeName);
+          const dynamic = state.externalMcpToolUseIds.delete(block.tool_use_id);
           const isError = !!block.is_error;
           const content = stringifyContent(block.content);
-          const result = toolName === "bash" ? { exitCode: isError ? 1 : 0, stdout: content } : content;
+          const result = toolName === "bash" ? { exitCode: isError ? 1 : 0, stdout: content } : dynamic ? parseMcpToolResult(content) : content;
           emit({
             type: "tool-result",
             toolCallId: block.tool_use_id,
             toolName,
             result,
-            isError
+            isError,
+            ...dynamic ? { dynamic: true } : {}
           });
           state.pendingStepToolUseIds.delete(block.tool_use_id);
         }
@@ -734,6 +740,13 @@ function stringifyContent(content) {
   }
   return JSON.stringify(content);
 }
+function parseMcpToolResult(content) {
+  try {
+    return JSON.parse(content);
+  } catch {
+    return content;
+  }
+}
 function mapUsage(usage) {
   if (!usage || typeof usage !== "object") return void 0;
   const u = usage;
@@ -848,16 +861,7 @@ function isJsonLiteral(value) {
   return value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value);
 }
 
-// src/bridge/index.ts
-var NATIVE_TO_COMMON = {
-  Read: "read",
-  Write: "write",
-  Edit: "edit",
-  Bash: "bash",
-  Glob: "glob",
-  Grep: "grep",
-  WebSearch: "webSearch"
-};
+// src/bridge/tool-filtering.ts
 var PUBLIC_TO_NATIVE = {
   read: "Read",
   write: "Write",
@@ -887,6 +891,31 @@ var PUBLIC_TO_NATIVE = {
   ToolSearch: "ToolSearch"
 };
 var PUBLIC_TOOL_NAMES = Object.keys(PUBLIC_TO_NATIVE);
+function toNativeName(toolName) {
+  return PUBLIC_TO_NATIVE[toolName] ?? toolName;
+}
+function resolveNativeTools(toolFiltering) {
+  if (toolFiltering == null || toolFiltering.mode === "deny") return void 0;
+  return toolFiltering.toolNames.map((name) => toNativeName(name));
+}
+function resolveInactiveNativeTools(toolFiltering) {
+  if (toolFiltering == null) return [];
+  const inactiveToolNames = toolFiltering.mode === "allow" ? PUBLIC_TOOL_NAMES.filter(
+    (name) => !toolFiltering.toolNames.includes(name)
+  ) : toolFiltering.toolNames;
+  return inactiveToolNames.map((name) => toNativeName(name));
+}
+
+// src/bridge/index.ts
+var NATIVE_TO_COMMON = {
+  Read: "read",
+  Write: "write",
+  Edit: "edit",
+  Bash: "bash",
+  Glob: "glob",
+  Grep: "grep",
+  WebSearch: "webSearch"
+};
 var NATIVE_TOOL_KINDS = {
   Read: "readonly",
   Glob: "readonly",
@@ -917,25 +946,6 @@ var NATIVE_TOOL_KINDS = {
 function toCommonName(nativeName) {
   return NATIVE_TO_COMMON[nativeName] ?? nativeName;
 }
-function toNativeName(toolName) {
-  return PUBLIC_TO_NATIVE[toolName] ?? toolName;
-}
-function resolveNativeTools(start) {
-  const toolFiltering = start.builtinToolFiltering;
-  if (toolFiltering == null) return void 0;
-  const activeToolNames = toolFiltering.mode === "allow" ? toolFiltering.toolNames : PUBLIC_TOOL_NAMES.filter(
-    (name) => !toolFiltering.toolNames.includes(name)
-  );
-  return activeToolNames.map((name) => toNativeName(name));
-}
-function resolveInactiveNativeTools(start) {
-  const toolFiltering = start.builtinToolFiltering;
-  if (toolFiltering == null) return [];
-  const inactiveToolNames = toolFiltering.mode === "allow" ? PUBLIC_TOOL_NAMES.filter(
-    (name) => !toolFiltering.toolNames.includes(name)
-  ) : toolFiltering.toolNames;
-  return inactiveToolNames.map((name) => toNativeName(name));
-}
 var args = parseArgs(argv.slice(2));
 var workdir = args.workdir;
 var bridgeStateDir = args.bridgeStateDir;
@@ -1038,7 +1048,7 @@ async function runTurn(start, turn) {
     });
   }
   const streamEventState = createClaudeStreamEventState();
-  const mcpServers = {};
+  const mcpServers = { ...start.mcpServers ?? {} };
   if (start.tools && start.tools.length > 0) {
     const server = new mcpModule.McpServer({
       name: "harness-tools",
@@ -1087,8 +1097,10 @@ async function runTurn(start, turn) {
     abortSignal: abortCtl.signal
   });
   const skillsOption = toClaudeSkillsOption(start.skills);
-  const nativeTools = resolveNativeTools(start);
-  const inactiveNativeTools = resolveInactiveNativeTools(start);
+  const nativeTools = resolveNativeTools(start.builtinToolFiltering);
+  const inactiveNativeTools = resolveInactiveNativeTools(
+    start.builtinToolFiltering
+  );
   const permissionOptions = createPermissionOptions({
     start,
     inactiveNativeTools,
@@ -1105,6 +1117,7 @@ async function runTurn(start, turn) {
     options: {
       ...start.model ? { model: start.model } : {},
       ...start.maxTurns !== void 0 ? { maxTurns: start.maxTurns } : {},
+      ...start.env !== void 0 ? { env: { ...procEnv2, ...start.env } } : {},
       ...skillsOption ? { skills: skillsOption } : {},
       ...nativeTools !== void 0 ? { tools: nativeTools } : {},
       ...inactiveNativeTools.length > 0 ? { disallowedTools: inactiveNativeTools } : {},