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

package/dist/index.js

@@ -136,7 +136,9 @@ var thinkingSchema = z.discriminatedUnion("type", [
 var startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
   thinking: thinkingSchema,
   maxTurns: z.number().optional(),
+  env: z.record(z.string(), z.string()).optional(),
   skills: z.array(z.string()).optional(),
+  mcpServers: z.record(z.string(), z.unknown()).optional(),
   // Resume signal. When true, the bridge passes `{ continue: true }` to the
   // Claude SDK so the in-workdir thread state is rehydrated. The host sets this
   // on the first prompt after a cross-process resume.
@@ -148,10 +150,35 @@ var inboundMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 // src/version.ts
-var VERSION = true ? "1.0.65" : "0.0.0-test";
+var VERSION = true ? "1.0.67" : "0.0.0-test";
 
 // src/claude-code-harness.ts
 var CLAUDE_CODE_CLIENT_APP = `ai-sdk/harness-claude-code/${VERSION}`;
+var listMcpResourcesInputSchema = z2.object({
+  server: z2.string().optional()
+});
+var readMcpResourceInputSchema = z2.object({
+  server: z2.string(),
+  uri: z2.string()
+});
+var structuredTeamMessageSchema = z2.discriminatedUnion("type", [
+  z2.object({
+    type: z2.literal("shutdown_request"),
+    reason: z2.string().optional()
+  }),
+  z2.object({
+    type: z2.literal("shutdown_response"),
+    request_id: z2.string(),
+    approve: z2.boolean(),
+    reason: z2.string().optional()
+  }),
+  z2.object({
+    type: z2.literal("plan_approval_response"),
+    request_id: z2.string(),
+    approve: z2.boolean(),
+    feedback: z2.string().optional()
+  })
+]);
 var CLAUDE_CODE_BUILTIN_TOOLS = {
   read: commonTool("read", {
     nativeName: "Read",
@@ -336,23 +363,64 @@ var CLAUDE_CODE_BUILTIN_TOOLS = {
       timeout: z2.number()
     })
   }),
-  Monitor: tool({
-    description: "Run and monitor a shell command",
-    inputSchema: z2.object({
-      command: z2.string(),
-      description: z2.string().optional(),
-      timeout_ms: z2.number().optional(),
-      persistent: z2.boolean().optional()
-    })
-  }),
-  ListMcpResources: tool({
-    description: "List resources available from MCP servers",
-    inputSchema: z2.object({ server: z2.string().optional() })
-  }),
-  ReadMcpResource: tool({
-    description: "Read a specific MCP resource by URI",
-    inputSchema: z2.object({ server: z2.string(), uri: z2.string() })
-  }),
+  Monitor: {
+    ...tool({
+      description: "Run and monitor a shell command or WebSocket",
+      inputSchema: z2.object({
+        description: z2.string().optional(),
+        timeout_ms: z2.number().optional(),
+        persistent: z2.boolean().optional(),
+        command: z2.string().optional(),
+        ws: z2.object({
+          url: z2.string(),
+          protocols: z2.array(z2.string()).optional()
+        }).optional()
+      })
+    }),
+    toolUseKind: "bash"
+  },
+  ListMcpResources: {
+    ...tool({
+      description: "List resources available from MCP servers",
+      inputSchema: listMcpResourcesInputSchema
+    }),
+    toolUseKind: "readonly"
+  },
+  ListMcpResourcesTool: {
+    ...tool({
+      description: "List resources available from MCP servers",
+      inputSchema: listMcpResourcesInputSchema
+    }),
+    toolUseKind: "readonly"
+  },
+  ReadMcpResource: {
+    ...tool({
+      description: "Read a specific MCP resource by URI",
+      inputSchema: readMcpResourceInputSchema
+    }),
+    toolUseKind: "readonly"
+  },
+  ReadMcpResourceTool: {
+    ...tool({
+      description: "Read a specific MCP resource by URI",
+      inputSchema: readMcpResourceInputSchema
+    }),
+    toolUseKind: "readonly"
+  },
+  ReadMcpResourceDirTool: {
+    ...tool({
+      description: "List direct children of an MCP directory resource",
+      inputSchema: readMcpResourceInputSchema
+    }),
+    toolUseKind: "readonly"
+  },
+  RefreshMcpTools: {
+    ...tool({
+      description: "Refresh tools from one or all connected MCP servers",
+      inputSchema: z2.object({ server: z2.string().optional() })
+    }),
+    toolUseKind: "readonly"
+  },
   ExitPlanMode: tool({
     description: "Exit plan mode with optional permission approvals",
     inputSchema: z2.looseObject({
@@ -364,6 +432,13 @@ var CLAUDE_CODE_BUILTIN_TOOLS = {
       ).optional()
     })
   }),
+  EnterPlanMode: {
+    ...tool({
+      description: "Enter plan mode",
+      inputSchema: z2.object({})
+    }),
+    toolUseKind: "readonly"
+  },
   EnterWorktree: tool({
     description: "Create or enter an isolated git worktree",
     inputSchema: z2.object({
@@ -422,7 +497,255 @@ var CLAUDE_CODE_BUILTIN_TOOLS = {
       query: z2.string(),
       max_results: z2.number().optional()
     })
-  })
+  }),
+  Artifact: {
+    ...tool({
+      description: "Publish or list claude.ai artifacts",
+      inputSchema: z2.object({
+        action: z2.enum(["publish", "list"]).optional(),
+        file_path: z2.string().optional(),
+        favicon: z2.string().optional(),
+        limit: z2.number().optional(),
+        scope: z2.enum(["mine", "shared", "all"]).optional(),
+        title: z2.string().optional(),
+        description: z2.string().optional(),
+        label: z2.string().optional(),
+        url: z2.string().optional(),
+        force: z2.boolean().optional()
+      })
+    }),
+    toolUseKind: "edit"
+  },
+  CronCreate: {
+    ...tool({
+      description: "Schedule a recurring or one-shot prompt",
+      inputSchema: z2.object({
+        cron: z2.string(),
+        prompt: z2.string(),
+        recurring: z2.boolean().optional(),
+        durable: z2.boolean().optional()
+      })
+    }),
+    toolUseKind: "edit"
+  },
+  CronDelete: {
+    ...tool({
+      description: "Delete a scheduled prompt by id",
+      inputSchema: z2.object({ id: z2.string() })
+    }),
+    toolUseKind: "edit"
+  },
+  CronList: {
+    ...tool({
+      description: "List scheduled prompts for the current session",
+      inputSchema: z2.object({})
+    }),
+    toolUseKind: "readonly"
+  },
+  DesignSync: {
+    ...tool({
+      description: "Read or update claude.ai Design projects",
+      inputSchema: z2.object({
+        method: z2.enum([
+          "list_projects",
+          "get_project",
+          "list_files",
+          "get_file",
+          "finalize_plan",
+          "write_files",
+          "delete_files",
+          "register_assets",
+          "unregister_assets",
+          "create_project",
+          "report_validate"
+        ]),
+        projectId: z2.string().optional(),
+        path: z2.string().optional(),
+        writes: z2.array(z2.string()).max(256).optional(),
+        deletes: z2.array(z2.string()).max(256).optional(),
+        planId: z2.string().optional(),
+        files: z2.array(
+          z2.object({
+            path: z2.string(),
+            localPath: z2.string().optional(),
+            data: z2.string().optional(),
+            encoding: z2.literal("base64").optional(),
+            mimeType: z2.string().optional()
+          })
+        ).max(256).optional(),
+        paths: z2.array(z2.string()).max(256).optional(),
+        name: z2.string().optional(),
+        assets: z2.array(
+          z2.object({
+            name: z2.string(),
+            path: z2.string(),
+            subtitle: z2.string().optional(),
+            viewport: z2.object({
+              width: z2.number(),
+              height: z2.number().optional()
+            }).optional(),
+            group: z2.string().optional()
+          })
+        ).max(256).optional(),
+        localDir: z2.string().optional(),
+        counts: z2.object({
+          total: z2.number(),
+          bad: z2.number(),
+          thin: z2.number(),
+          variantsIdentical: z2.number(),
+          iterations: z2.number()
+        }).optional()
+      })
+    }),
+    toolUseKind: "edit"
+  },
+  LSP: {
+    ...tool({
+      description: "Query a language server for code intelligence",
+      inputSchema: z2.object({
+        operation: z2.enum([
+          "goToDefinition",
+          "findReferences",
+          "hover",
+          "documentSymbol",
+          "workspaceSymbol",
+          "goToImplementation",
+          "prepareCallHierarchy",
+          "incomingCalls",
+          "outgoingCalls"
+        ]),
+        filePath: z2.string(),
+        line: z2.number().int().positive(),
+        character: z2.number().int().positive(),
+        query: z2.string().optional()
+      })
+    }),
+    toolUseKind: "readonly"
+  },
+  PowerShell: {
+    ...tool({
+      description: "Execute a PowerShell command, optionally in background",
+      inputSchema: z2.object({
+        command: z2.string(),
+        timeout: z2.number().optional(),
+        description: z2.string().optional(),
+        run_in_background: z2.boolean().optional(),
+        dangerouslyDisableSandbox: z2.boolean().optional()
+      })
+    }),
+    toolUseKind: "bash"
+  },
+  PushNotification: {
+    ...tool({
+      description: "Send a notification for proactive or scheduled work",
+      inputSchema: z2.object({
+        message: z2.string(),
+        status: z2.literal("proactive")
+      })
+    }),
+    toolUseKind: "edit"
+  },
+  RemoteTrigger: {
+    ...tool({
+      description: "List, manage, or run a claude.ai Routine trigger",
+      inputSchema: z2.object({
+        action: z2.enum(["list", "get", "create", "update", "run"]),
+        trigger_id: z2.string().optional(),
+        body: z2.record(z2.string(), z2.unknown()).optional()
+      })
+    }),
+    toolUseKind: "edit"
+  },
+  ReportFindings: {
+    ...tool({
+      description: "Return verified code-review findings",
+      inputSchema: z2.object({
+        level: z2.enum(["low", "medium", "high", "xhigh", "max"]).optional(),
+        findings: z2.array(
+          z2.object({
+            file: z2.string(),
+            line: z2.number().optional(),
+            summary: z2.string(),
+            short_summary: z2.string().optional(),
+            failure_scenario: z2.string(),
+            category: z2.string().optional(),
+            verdict: z2.enum(["CONFIRMED", "PLAUSIBLE"]).optional(),
+            outcome: z2.enum(["fixed", "skipped", "no_change_needed"]).optional()
+          })
+        ).max(32)
+      })
+    }),
+    toolUseKind: "readonly"
+  },
+  ScheduleWakeup: {
+    ...tool({
+      description: "Schedule or stop the next iteration of a dynamic loop",
+      inputSchema: z2.object({
+        delaySeconds: z2.number().optional(),
+        reason: z2.string().optional(),
+        prompt: z2.string().optional(),
+        stop: z2.boolean().optional()
+      })
+    }),
+    toolUseKind: "edit"
+  },
+  SendMessage: {
+    ...tool({
+      description: "Send a plain-text or protocol message to another agent",
+      inputSchema: z2.object({
+        to: z2.string(),
+        summary: z2.string().max(200).optional(),
+        message: z2.union([z2.string(), structuredTeamMessageSchema])
+      })
+    }),
+    toolUseKind: "edit"
+  },
+  SendUserFile: {
+    ...tool({
+      description: "Send one or more files to the user",
+      inputSchema: z2.object({
+        files: z2.union([z2.string(), z2.array(z2.string()).min(1)]),
+        caption: z2.string().optional(),
+        status: z2.enum(["normal", "proactive"]),
+        display: z2.enum(["render", "attach"]).optional()
+      })
+    }),
+    toolUseKind: "readonly"
+  },
+  ShareOnboardingGuide: {
+    ...tool({
+      description: "Create, update, inspect, or delete an onboarding guide",
+      inputSchema: z2.object({
+        mode: z2.enum(["check", "update", "create", "delete"]).optional(),
+        short_code: z2.string().regex(/^[A-Za-z0-9_-]{1,64}$/).optional()
+      })
+    }),
+    toolUseKind: "edit"
+  },
+  WaitForMcpServers: {
+    ...tool({
+      description: "Wait for MCP servers that are still connecting",
+      inputSchema: z2.object({
+        servers: z2.array(z2.string()).optional()
+      })
+    }),
+    toolUseKind: "readonly"
+  },
+  Workflow: {
+    ...tool({
+      description: "Run or resume a dynamic multi-agent workflow",
+      inputSchema: z2.object({
+        script: z2.string().optional(),
+        name: z2.string().optional(),
+        description: z2.string().optional(),
+        title: z2.string().optional(),
+        args: z2.record(z2.string(), z2.unknown()).optional(),
+        scriptPath: z2.string().optional(),
+        resumeFromRunId: z2.string().optional()
+      })
+    }),
+    toolUseKind: "edit"
+  }
 };
 var BOOTSTRAP_DIR = ".harness-bootstrap/claude-code";
 var claudeCodeBridgeCoordsSchema = z2.object({
@@ -435,6 +758,11 @@ var claudeCodeResumeStateSchema = z2.looseObject({
   bridge: claudeCodeBridgeCoordsSchema.optional()
 });
 function createClaudeCode(settings = {}) {
+  if (settings.mcpServers != null && Object.prototype.hasOwnProperty.call(settings.mcpServers, "harness-tools")) {
+    throw new Error(
+      'Claude Code MCP server name "harness-tools" is reserved for HarnessAgent tools.'
+    );
+  }
   let cachedBootstrap;
   const thinking = settings.thinking ?? {
     type: "adaptive",
@@ -526,6 +854,7 @@ function createClaudeCode(settings = {}) {
             proc: void 0,
             model: settings.model,
             maxTurns: settings.maxTurns,
+            env: settings.env,
             thinking,
             isResume: true,
             continueOnFirstPrompt: false,
@@ -536,7 +865,8 @@ function createClaudeCode(settings = {}) {
             debug: startOpts.observability?.debug,
             permissionMode: startOpts.permissionMode,
             builtinToolFiltering: startOpts.builtinToolFiltering,
-            skills: startOpts.skills ?? []
+            skills: startOpts.skills ?? [],
+            mcpServers: settings.mcpServers
           });
         } catch {
         }
@@ -558,7 +888,7 @@ function createClaudeCode(settings = {}) {
         abortSignal: startOpts.abortSignal
       }) : void 0;
       const port = resolveBridgePort(sandboxSession, settings.port);
-      const token = randomBytes(32).toString("hex");
+      const token = settings.mintBridgeToken == null ? randomBytes(32).toString("hex") : settings.mintBridgeToken(sandboxId);
       const authEnv = resolveClaudeCodeEnv(settings.auth);
       const env = {
         ...authEnv,
@@ -656,6 +986,7 @@ function createClaudeCode(settings = {}) {
         proc,
         model: settings.model,
         maxTurns: settings.maxTurns,
+        env: settings.env,
         thinking,
         isResume: respawnStrategy !== void 0,
         continueOnFirstPrompt: respawnStrategy !== void 0,
@@ -666,7 +997,8 @@ function createClaudeCode(settings = {}) {
         debug: startOpts.observability?.debug,
         permissionMode: startOpts.permissionMode,
         builtinToolFiltering: startOpts.builtinToolFiltering,
-        skills: startOpts.skills ?? []
+        skills: startOpts.skills ?? [],
+        mcpServers: settings.mcpServers
       });
     }
   };
@@ -843,6 +1175,7 @@ function createSession({
   proc,
   model,
   maxTurns,
+  env,
   thinking,
   isResume,
   continueOnFirstPrompt,
@@ -853,7 +1186,8 @@ function createSession({
   debug,
   permissionMode,
   builtinToolFiltering,
-  skills
+  skills,
+  mcpServers
 }) {
   let stopped = false;
   let stopPromise;
@@ -996,8 +1330,10 @@ function createSession({
         })),
         model,
         maxTurns,
+        ...env !== void 0 ? { env } : {},
         thinking,
         ...skills.length > 0 ? { skills: skills.map((skill) => skill.name) } : {},
+        ...mcpServers == null ? {} : { mcpServers },
         ...permissionMode ? { permissionMode } : {},
         ...builtinToolFiltering ? { builtinToolFiltering } : {},
         ...debug ? { debug } : {},
@@ -1031,8 +1367,10 @@ function createSession({
           })),
           model,
           maxTurns,
+          ...env !== void 0 ? { env } : {},
           thinking,
           ...skills.length > 0 ? { skills: skills.map((skill) => skill.name) } : {},
+          ...mcpServers == null ? {} : { mcpServers },
           ...permissionMode ? { permissionMode } : {},
           ...builtinToolFiltering ? { builtinToolFiltering } : {},
           ...debug ? { debug } : {},