ai-sdk-provider-claude-code 3.0.0-beta.1 → 3.0.1

package/dist/index.d.cts

@@ -134,6 +134,9 @@ interface ClaudeCodeSettings {
     /**
      * Filesystem settings sources to load (CLAUDE.md, settings.json, etc.)
      * When omitted, the Agent SDK loads no filesystem settings.
+     *
+     * Required for Skills support - skills are loaded from these sources.
+     * @example ['user', 'project']
      */
     settingSources?: Array<'user' | 'project' | 'local'>;
     /**

package/dist/index.d.ts

@@ -134,6 +134,9 @@ interface ClaudeCodeSettings {
     /**
      * Filesystem settings sources to load (CLAUDE.md, settings.json, etc.)
      * When omitted, the Agent SDK loads no filesystem settings.
+     *
+     * Required for Skills support - skills are loaded from these sources.
+     * @example ['user', 'project']
      */
     settingSources?: Array<'user' | 'project' | 'local'>;
     /**

package/dist/index.js

@@ -370,13 +370,15 @@ function getErrorMetadata(error) {
 function mapClaudeCodeFinishReason(subtype) {
   switch (subtype) {
     case "success":
-      return "stop";
+      return { unified: "stop", raw: subtype };
     case "error_max_turns":
-      return "length";
+      return { unified: "length", raw: subtype };
     case "error_during_execution":
-      return "error";
+      return { unified: "error", raw: subtype };
+    case void 0:
+      return { unified: "stop", raw: void 0 };
     default:
-      return "stop";
+      return { unified: "other", raw: subtype };
   }
 }
 
@@ -548,6 +550,11 @@ function validateSettings(settings) {
     if (validSettings.disallowedTools) {
       validateToolNames(validSettings.disallowedTools, "disallowed");
     }
+    if (validSettings.allowedTools?.includes("Skill") && !validSettings.settingSources) {
+      warnings.push(
+        "allowedTools includes 'Skill' but settingSources is not set. Skills require settingSources (e.g., ['user', 'project']) to load skill definitions."
+      );
+    }
     return { valid: true, warnings, errors };
   } catch (error) {
     errors.push(`Validation error: ${error instanceof Error ? error.message : String(error)}`);
@@ -652,6 +659,42 @@ function isAbortError(err) {
   return false;
 }
 var STREAMING_FEATURE_WARNING = "Claude Agent SDK features (hooks/MCP/images) require streaming input. Set `streamingInput: 'always'` or provide `canUseTool` (auto streams only when canUseTool is set).";
+function createEmptyUsage() {
+  return {
+    inputTokens: {
+      total: 0,
+      noCache: 0,
+      cacheRead: 0,
+      cacheWrite: 0
+    },
+    outputTokens: {
+      total: 0,
+      text: void 0,
+      reasoning: void 0
+    },
+    raw: void 0
+  };
+}
+function convertClaudeCodeUsage(usage) {
+  const inputTokens = usage.input_tokens ?? 0;
+  const outputTokens = usage.output_tokens ?? 0;
+  const cacheWrite = usage.cache_creation_input_tokens ?? 0;
+  const cacheRead = usage.cache_read_input_tokens ?? 0;
+  return {
+    inputTokens: {
+      total: inputTokens + cacheWrite + cacheRead,
+      noCache: inputTokens,
+      cacheRead,
+      cacheWrite
+    },
+    outputTokens: {
+      total: outputTokens,
+      text: void 0,
+      reasoning: void 0
+    },
+    raw: usage
+  };
+}
 function toAsyncIterablePrompt(messagesPrompt, outputStreamEnded, sessionId, contentParts) {
   const content = contentParts && contentParts.length > 0 ? contentParts : [{ type: "text", text: messagesPrompt }];
   const msg = {
@@ -1005,16 +1048,12 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     const queryOptions = this.createQueryOptions(abortController, options.responseFormat);
     let text = "";
     let structuredOutput;
-    let usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
-    let finishReason = "stop";
+    let usage = createEmptyUsage();
+    let finishReason = { unified: "stop", raw: void 0 };
     let wasTruncated = false;
     let costUsd;
     let durationMs;
-    let rawUsage;
-    const warnings = this.generateAllWarnings(
-      options,
-      messagesPrompt
-    );
+    const warnings = this.generateAllWarnings(options, messagesPrompt);
     if (messageWarnings) {
       messageWarnings.forEach((warning) => {
         warnings.push({
@@ -1077,18 +1116,13 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
             `[claude-code] Request completed - Session: ${message.session_id}, Cost: $${costUsd?.toFixed(4) ?? "N/A"}, Duration: ${durationMs ?? "N/A"}ms`
           );
           if ("usage" in message) {
-            rawUsage = message.usage;
-            usage = {
-              inputTokens: (message.usage.cache_creation_input_tokens ?? 0) + (message.usage.cache_read_input_tokens ?? 0) + (message.usage.input_tokens ?? 0),
-              outputTokens: message.usage.output_tokens ?? 0,
-              totalTokens: (message.usage.cache_creation_input_tokens ?? 0) + (message.usage.cache_read_input_tokens ?? 0) + (message.usage.input_tokens ?? 0) + (message.usage.output_tokens ?? 0)
-            };
+            usage = convertClaudeCodeUsage(message.usage);
             this.logger.debug(
-              `[claude-code] Token usage - Input: ${usage.inputTokens}, Output: ${usage.outputTokens}, Total: ${usage.totalTokens}`
+              `[claude-code] Token usage - Input: ${usage.inputTokens.total}, Output: ${usage.outputTokens.total}`
             );
           }
           finishReason = mapClaudeCodeFinishReason(message.subtype);
-          this.logger.debug(`[claude-code] Finish reason: ${finishReason}`);
+          this.logger.debug(`[claude-code] Finish reason: ${finishReason.unified}`);
         } else if (message.type === "system" && message.subtype === "init") {
           this.setSessionId(message.session_id);
           this.logger.info(`[claude-code] Session initialized: ${message.session_id}`);
@@ -1108,7 +1142,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           `[claude-code] Detected truncated response, returning ${text.length} characters of buffered text`
         );
         wasTruncated = true;
-        finishReason = "length";
+        finishReason = { unified: "length", raw: "truncation" };
         warnings.push({
           type: "other",
           message: CLAUDE_CODE_TRUNCATION_WARNING
@@ -1140,7 +1174,6 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           ...this.sessionId !== void 0 && { sessionId: this.sessionId },
           ...costUsd !== void 0 && { costUsd },
           ...durationMs !== void 0 && { durationMs },
-          ...rawUsage !== void 0 && { rawUsage },
           ...wasTruncated && { truncated: true }
         }
       }
@@ -1170,10 +1203,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     if (queryOptions.includePartialMessages === void 0) {
       queryOptions.includePartialMessages = true;
     }
-    const warnings = this.generateAllWarnings(
-      options,
-      messagesPrompt
-    );
+    const warnings = this.generateAllWarnings(options, messagesPrompt);
     if (messageWarnings) {
       messageWarnings.forEach((warning) => {
         warnings.push({
@@ -1238,7 +1268,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           }
           toolStates.clear();
         };
-        let usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+        let usage = createEmptyUsage();
         let accumulatedText = "";
         let textPartId;
         let streamedTextLength = 0;
@@ -1536,22 +1566,16 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               this.logger.info(
                 `[claude-code] Stream completed - Session: ${message.session_id}, Cost: $${message.total_cost_usd?.toFixed(4) ?? "N/A"}, Duration: ${message.duration_ms ?? "N/A"}ms`
               );
-              let rawUsage;
               if ("usage" in message) {
-                rawUsage = message.usage;
-                usage = {
-                  inputTokens: (message.usage.cache_creation_input_tokens ?? 0) + (message.usage.cache_read_input_tokens ?? 0) + (message.usage.input_tokens ?? 0),
-                  outputTokens: message.usage.output_tokens ?? 0,
-                  totalTokens: (message.usage.cache_creation_input_tokens ?? 0) + (message.usage.cache_read_input_tokens ?? 0) + (message.usage.input_tokens ?? 0) + (message.usage.output_tokens ?? 0)
-                };
+                usage = convertClaudeCodeUsage(message.usage);
                 this.logger.debug(
-                  `[claude-code] Stream token usage - Input: ${usage.inputTokens}, Output: ${usage.outputTokens}, Total: ${usage.totalTokens}`
+                  `[claude-code] Stream token usage - Input: ${usage.inputTokens.total}, Output: ${usage.outputTokens.total}`
                 );
               }
               const finishReason = mapClaudeCodeFinishReason(
                 message.subtype
               );
-              this.logger.debug(`[claude-code] Stream finish reason: ${finishReason}`);
+              this.logger.debug(`[claude-code] Stream finish reason: ${finishReason.unified}`);
               this.setSessionId(message.session_id);
               const structuredOutput = "structured_output" in message ? message.structured_output : void 0;
               const alreadyStreamedJson = textPartId && options.responseFormat?.type === "json" && hasReceivedStreamEvents;
@@ -1610,7 +1634,6 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
                       costUsd: message.total_cost_usd
                     },
                     ...message.duration_ms !== void 0 && { durationMs: message.duration_ms },
-                    ...rawUsage !== void 0 && { rawUsage },
                     // JSON validation warnings are collected during streaming and included
                     // in providerMetadata since the AI SDK's finish event doesn't support
                     // a top-level warnings field (unlike stream-start which was already emitted)
@@ -1673,7 +1696,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
             const warningsJson = this.serializeWarningsForMetadata(streamWarnings);
             controller.enqueue({
               type: "finish",
-              finishReason: "length",
+              finishReason: { unified: "length", raw: "truncation" },
               usage,
               providerMetadata: {
                 "claude-code": {