ai-sdk-provider-claude-code 1.1.0 → 1.1.2

package/README.md

@@ -17,8 +17,8 @@
 
 | Provider Version | AI SDK Version | NPM Tag | Status | Branch |
 |-----------------|----------------|---------|---------|--------|
-| 1.x | v5 | `latest` | Stable | `main` |
-| 0.x | v4 | `ai-sdk-v4` | Maintenance | [`ai-sdk-v4`](https://github.com/ben-vargas/ai-sdk-provider-claude-code/tree/ai-sdk-v4) |
+| 1.x.x | v5 | `latest` | Stable | `main` |
+| 0.x.x | v4 | `ai-sdk-v4` | Maintenance | [`ai-sdk-v4`](https://github.com/ben-vargas/ai-sdk-provider-claude-code/tree/ai-sdk-v4) |
 
 ### Installing the Right Version
 
@@ -119,12 +119,14 @@ Key changes:
 - 🎯 Object generation with JSON schemas
 - 🛑 AbortSignal support
 - 🔧 Tool management (MCP servers, permissions)
+ - 🧩 Callbacks (hooks, canUseTool)
 
 ## Limitations
 
 - Requires Node.js ≥ 18
 - No image support
 - Some AI SDK parameters unsupported (temperature, maxTokens, etc.)
+- `canUseTool` requires streaming input at the SDK level (AsyncIterable prompt). This provider supports it via `streamingInput`: use `'auto'` (default when `canUseTool` is set) or `'always'`. See GUIDE for details.
 
 ## Contributing
 
@@ -140,4 +142,4 @@ For development status and technical details, see [Development Status](docs/ai-s
 
 ## License
 
-MIT
+MIT

package/dist/index.cjs

@@ -25,10 +25,13 @@ __export(index_exports, {
   createAPICallError: () => createAPICallError,
   createAuthenticationError: () => createAuthenticationError,
   createClaudeCode: () => createClaudeCode,
+  createCustomMcpServer: () => createCustomMcpServer,
+  createSdkMcpServer: () => import_claude_code3.createSdkMcpServer,
   createTimeoutError: () => createTimeoutError,
   getErrorMetadata: () => getErrorMetadata,
   isAuthenticationError: () => isAuthenticationError,
-  isTimeoutError: () => isTimeoutError
+  isTimeoutError: () => isTimeoutError,
+  tool: () => import_claude_code3.tool
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -82,9 +85,9 @@ function convertToClaudeCodeMessages(prompt, mode = { type: "regular" }, jsonSch
         break;
       }
       case "tool":
-        for (const tool of message.content) {
-          const resultText = tool.output.type === "text" ? tool.output.value : JSON.stringify(tool.output.value);
-          messages.push(`Tool Result (${tool.toolName}): ${resultText}`);
+        for (const tool3 of message.content) {
+          const resultText = tool3.output.type === "text" ? tool3.output.value : JSON.stringify(tool3.output.value);
+          messages.push(`Tool Result (${tool3.toolName}): ${resultText}`);
         }
         break;
     }
@@ -331,6 +334,15 @@ var claudeCodeSettingsSchema = import_zod.z.object({
   resume: import_zod.z.string().optional(),
   allowedTools: import_zod.z.array(import_zod.z.string()).optional(),
   disallowedTools: import_zod.z.array(import_zod.z.string()).optional(),
+  streamingInput: import_zod.z.enum(["auto", "always", "off"]).optional(),
+  // Hooks and tool-permission callback (permissive validation of shapes)
+  canUseTool: import_zod.z.any().refine((v) => v === void 0 || typeof v === "function", {
+    message: "canUseTool must be a function"
+  }).optional(),
+  hooks: import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.object({
+    matcher: import_zod.z.string().optional(),
+    hooks: import_zod.z.array(import_zod.z.any()).nonempty()
+  }))).optional(),
   mcpServers: import_zod.z.record(import_zod.z.string(), import_zod.z.union([
     // McpStdioServerConfig
     import_zod.z.object({
@@ -344,6 +356,18 @@ var claudeCodeSettingsSchema = import_zod.z.object({
       type: import_zod.z.literal("sse"),
       url: import_zod.z.string(),
       headers: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional()
+    }),
+    // McpHttpServerConfig
+    import_zod.z.object({
+      type: import_zod.z.literal("http"),
+      url: import_zod.z.string(),
+      headers: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional()
+    }),
+    // McpSdkServerConfig (in-process custom tools)
+    import_zod.z.object({
+      type: import_zod.z.literal("sdk"),
+      name: import_zod.z.string(),
+      instance: import_zod.z.any()
     })
   ])).optional(),
   verbose: import_zod.z.boolean().optional(),
@@ -387,9 +411,9 @@ function validateSettings(settings) {
       warnings.push("Both allowedTools and disallowedTools are specified. Only allowedTools will be used.");
     }
     const validateToolNames = (tools, type) => {
-      tools.forEach((tool) => {
-        if (!/^[a-zA-Z_][a-zA-Z0-9_]*(\([^)]*\))?$/.test(tool) && !tool.startsWith("mcp__")) {
-          warnings.push(`Unusual ${type} tool name format: '${tool}'`);
+      tools.forEach((tool3) => {
+        if (!/^[a-zA-Z_][a-zA-Z0-9_]*(\([^)]*\))?$/.test(tool3) && !tool3.startsWith("mcp__")) {
+          warnings.push(`Unusual ${type} tool name format: '${tool3}'`);
         }
       });
     };
@@ -442,6 +466,30 @@ function getLogger(logger) {
 
 // src/claude-code-language-model.ts
 var import_claude_code = require("@anthropic-ai/claude-code");
+function isAbortError(err) {
+  if (err && typeof err === "object") {
+    const e = err;
+    if (typeof e.name === "string" && e.name === "AbortError") return true;
+    if (typeof e.code === "string" && e.code.toUpperCase() === "ABORT_ERR") return true;
+  }
+  return false;
+}
+function toAsyncIterablePrompt(messagesPrompt, sessionId) {
+  const msg = {
+    type: "user",
+    message: {
+      role: "user",
+      content: [{ type: "text", text: messagesPrompt }]
+    },
+    parent_tool_use_id: null,
+    session_id: sessionId ?? ""
+  };
+  return {
+    async *[Symbol.asyncIterator]() {
+      yield msg;
+    }
+  };
+}
 var modelMap = {
   "opus": "opus",
   "sonnet": "sonnet"
@@ -522,7 +570,7 @@ var ClaudeCodeLanguageModel = class {
     return warnings;
   }
   createQueryOptions(abortController) {
-    return {
+    const opts = {
       model: this.getModel(),
       abortController,
       resume: this.settings.resume ?? this.sessionId,
@@ -539,11 +587,16 @@ var ClaudeCodeLanguageModel = class {
       continue: this.settings.continue,
       allowedTools: this.settings.allowedTools,
       disallowedTools: this.settings.disallowedTools,
-      mcpServers: this.settings.mcpServers
+      mcpServers: this.settings.mcpServers,
+      canUseTool: this.settings.canUseTool
     };
+    if (this.settings.hooks) {
+      opts.hooks = this.settings.hooks;
+    }
+    return opts;
   }
   handleClaudeCodeError(error, messagesPrompt) {
-    if (error instanceof import_claude_code.AbortError) {
+    if (isAbortError(error)) {
       throw error;
     }
     const isErrorWithMessage = (err) => {
@@ -626,8 +679,10 @@ var ClaudeCodeLanguageModel = class {
     );
     const abortController = new AbortController();
     let abortListener;
-    if (options.abortSignal) {
-      abortListener = () => abortController.abort();
+    if (options.abortSignal?.aborted) {
+      abortController.abort(options.abortSignal.reason);
+    } else if (options.abortSignal) {
+      abortListener = () => abortController.abort(options.abortSignal?.reason);
       options.abortSignal.addEventListener("abort", abortListener, { once: true });
     }
     const queryOptions = this.createQueryOptions(abortController);
@@ -647,8 +702,14 @@ var ClaudeCodeLanguageModel = class {
       });
     }
     try {
+      const modeSetting = this.settings.streamingInput ?? "auto";
+      const wantsStream = modeSetting === "always" || modeSetting === "auto" && !!this.settings.canUseTool;
+      if (this.settings.canUseTool && this.settings.permissionPromptToolName) {
+        throw new Error("canUseTool requires streamingInput mode ('auto' or 'always') and cannot be used with permissionPromptToolName (SDK constraint). Set streamingInput: 'auto' (or 'always') and remove permissionPromptToolName, or remove canUseTool.");
+      }
+      const sdkPrompt = wantsStream ? toAsyncIterablePrompt(messagesPrompt, this.settings.resume ?? this.sessionId) : messagesPrompt;
       const response = (0, import_claude_code.query)({
-        prompt: messagesPrompt,
+        prompt: sdkPrompt,
         options: queryOptions
       });
       for await (const message of response) {
@@ -674,7 +735,7 @@ var ClaudeCodeLanguageModel = class {
         }
       }
     } catch (error) {
-      if (error instanceof import_claude_code.AbortError) {
+      if (isAbortError(error)) {
         throw options.abortSignal?.aborted ? options.abortSignal.reason : error;
       }
       throw this.handleClaudeCodeError(error, messagesPrompt);
@@ -723,8 +784,10 @@ var ClaudeCodeLanguageModel = class {
     );
     const abortController = new AbortController();
     let abortListener;
-    if (options.abortSignal) {
-      abortListener = () => abortController.abort();
+    if (options.abortSignal?.aborted) {
+      abortController.abort(options.abortSignal.reason);
+    } else if (options.abortSignal) {
+      abortListener = () => abortController.abort(options.abortSignal?.reason);
       options.abortSignal.addEventListener("abort", abortListener, { once: true });
     }
     const queryOptions = this.createQueryOptions(abortController);
@@ -741,8 +804,14 @@ var ClaudeCodeLanguageModel = class {
       start: async (controller) => {
         try {
           controller.enqueue({ type: "stream-start", warnings });
+          const modeSetting = this.settings.streamingInput ?? "auto";
+          const wantsStream = modeSetting === "always" || modeSetting === "auto" && !!this.settings.canUseTool;
+          if (this.settings.canUseTool && this.settings.permissionPromptToolName) {
+            throw new Error("canUseTool requires streamingInput mode ('auto' or 'always') and cannot be used with permissionPromptToolName (SDK constraint). Set streamingInput: 'auto' (or 'always') and remove permissionPromptToolName, or remove canUseTool.");
+          }
+          const sdkPrompt = wantsStream ? toAsyncIterablePrompt(messagesPrompt, this.settings.resume ?? this.sessionId) : messagesPrompt;
           const response = (0, import_claude_code.query)({
-            prompt: messagesPrompt,
+            prompt: sdkPrompt,
             options: queryOptions
           });
           let usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
@@ -829,7 +898,7 @@ var ClaudeCodeLanguageModel = class {
           controller.close();
         } catch (error) {
           let errorToEmit;
-          if (error instanceof import_claude_code.AbortError) {
+          if (isAbortError(error)) {
             errorToEmit = options.abortSignal?.aborted ? options.abortSignal.reason : error;
           } else {
             errorToEmit = this.handleClaudeCodeError(error, messagesPrompt);
@@ -912,6 +981,24 @@ function createClaudeCode(options = {}) {
   return provider;
 }
 var claudeCode = createClaudeCode();
+
+// src/index.ts
+var import_claude_code3 = require("@anthropic-ai/claude-code");
+
+// src/mcp-helpers.ts
+var import_claude_code2 = require("@anthropic-ai/claude-code");
+var import_zod2 = require("zod");
+function createCustomMcpServer(config) {
+  const defs = Object.entries(config.tools).map(
+    ([name, def]) => (0, import_claude_code2.tool)(
+      name,
+      def.description,
+      def.inputSchema.shape,
+      (args, extra) => def.handler(args, extra)
+    )
+  );
+  return (0, import_claude_code2.createSdkMcpServer)({ name: config.name, version: config.version, tools: defs });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ClaudeCodeLanguageModel,
@@ -919,9 +1006,12 @@ var claudeCode = createClaudeCode();
   createAPICallError,
   createAuthenticationError,
   createClaudeCode,
+  createCustomMcpServer,
+  createSdkMcpServer,
   createTimeoutError,
   getErrorMetadata,
   isAuthenticationError,
-  isTimeoutError
+  isTimeoutError,
+  tool
 });
 //# sourceMappingURL=index.cjs.map