@ai-sdk/harness-claude-code 1.0.66 → 1.0.68

package/dist/index.js

@@ -134,10 +134,12 @@ var thinkingSchema = z.discriminatedUnion("type", [
   z.object({ type: z.literal("disabled") })
 ]);
 var startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
+  instructions: z.string().optional(),
   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.
@@ -149,10 +151,35 @@ var inboundMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 // src/version.ts
-var VERSION = true ? "1.0.66" : "0.0.0-test";
+var VERSION = true ? "1.0.68" : "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",
@@ -337,23 +364,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({
@@ -365,6 +433,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({
@@ -423,7 +498,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({
@@ -436,6 +759,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",
@@ -538,7 +866,8 @@ function createClaudeCode(settings = {}) {
             debug: startOpts.observability?.debug,
             permissionMode: startOpts.permissionMode,
             builtinToolFiltering: startOpts.builtinToolFiltering,
-            skills: startOpts.skills ?? []
+            skills: startOpts.skills ?? [],
+            mcpServers: settings.mcpServers
           });
         } catch {
         }
@@ -560,7 +889,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,
@@ -669,7 +998,8 @@ function createClaudeCode(settings = {}) {
         debug: startOpts.observability?.debug,
         permissionMode: startOpts.permissionMode,
         builtinToolFiltering: startOpts.builtinToolFiltering,
-        skills: startOpts.skills ?? []
+        skills: startOpts.skills ?? [],
+        mcpServers: settings.mcpServers
       });
     }
   };
@@ -857,12 +1187,12 @@ function createSession({
   debug,
   permissionMode,
   builtinToolFiltering,
-  skills
+  skills,
+  mcpServers
 }) {
   let stopped = false;
   let stopPromise;
   let pendingResumeFlag = continueOnFirstPrompt;
-  let instructionsApplied = isResume;
   const wireTurn = (turnOpts) => {
     let pendingResolve;
     let pendingReject;
@@ -985,24 +1315,21 @@ function createSession({
         emit: promptOpts.emit,
         abortSignal: promptOpts.abortSignal
       });
-      let promptText = extractUserText(promptOpts.prompt);
-      if (!instructionsApplied && promptOpts.instructions) {
-        promptText = frameInstructions(promptOpts.instructions, promptText);
-      }
-      instructionsApplied = true;
       const startMessage = {
         type: "start",
-        prompt: promptText,
+        prompt: extractUserText(promptOpts.prompt),
         tools: (promptOpts.tools ?? []).map((t) => ({
           name: t.name,
           description: t.description,
           inputSchema: t.inputSchema
         })),
+        ...promptOpts.instructions ? { instructions: promptOpts.instructions } : {},
         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 } : {},
@@ -1034,11 +1361,13 @@ function createSession({
             description: t.description,
             inputSchema: t.inputSchema
           })),
+          ...continueOpts.instructions ? { instructions: continueOpts.instructions } : {},
           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 } : {},
@@ -1190,17 +1519,6 @@ function createSession({
     }
   };
 }
-function frameInstructions(instructions, userText) {
-  return `<session-instructions>
-The block below is operating guidance from the system, not a message from the user \u2014 follow it, but do not mention it or attribute it to the user.
-
-${instructions}
-</session-instructions>
-
-<user-message>
-${userText}
-</user-message>`;
-}
 function extractUserText(prompt) {
   if (typeof prompt === "string") return prompt;
   const { content } = prompt;