@anthropic-ai/claude-agent-sdk 0.1.28 → 0.1.30

package/sdk.d.ts

@@ -249,10 +249,6 @@ export type McpServerStatus = {
         version: string;
     };
 };
-export type SDKMessageBase = {
-    uuid: UUID;
-    session_id: string;
-};
 type SDKUserMessageContent = {
     type: 'user';
     message: APIUserMessage;
@@ -267,24 +263,28 @@ export type SDKUserMessage = SDKUserMessageContent & {
     uuid?: UUID;
     session_id: string;
 };
-export type SDKUserMessageReplay = SDKMessageBase & SDKUserMessageContent & {
+export type SDKUserMessageReplay = SDKUserMessageContent & {
+    uuid: UUID;
+    session_id: string;
     /**
      * True if this is a replay/acknowledgment of a user message that was already
      * added to the messages array. Used internally to prevent duplicate messages.
      */
     isReplay: true;
 };
-export type SDKAssistantMessage = SDKMessageBase & {
+export type SDKAssistantMessage = {
     type: 'assistant';
     message: APIAssistantMessage;
     parent_tool_use_id: string | null;
+    uuid: UUID;
+    session_id: string;
 };
 export type SDKPermissionDenial = {
     tool_name: string;
     tool_use_id: string;
     tool_input: Record<string, unknown>;
 };
-export type SDKResultMessage = (SDKMessageBase & {
+export type SDKResultMessage = {
     type: 'result';
     subtype: 'success';
     duration_ms: number;
@@ -298,9 +298,11 @@ export type SDKResultMessage = (SDKMessageBase & {
         [modelName: string]: ModelUsage;
     };
     permission_denials: SDKPermissionDenial[];
-}) | (SDKMessageBase & {
+    uuid: UUID;
+    session_id: string;
+} | {
     type: 'result';
-    subtype: 'error_max_turns' | 'error_during_execution';
+    subtype: 'error_during_execution' | 'error_max_turns' | 'error_max_budget_usd';
     duration_ms: number;
     duration_api_ms: number;
     is_error: boolean;
@@ -311,8 +313,11 @@ export type SDKResultMessage = (SDKMessageBase & {
         [modelName: string]: ModelUsage;
     };
     permission_denials: SDKPermissionDenial[];
-});
-export type SDKSystemMessage = SDKMessageBase & {
+    errors: string[];
+    uuid: UUID;
+    session_id: string;
+};
+export type SDKSystemMessage = {
     type: 'system';
     subtype: 'init';
     agents?: string[];
@@ -333,21 +338,27 @@ export type SDKSystemMessage = SDKMessageBase & {
         name: string;
         path: string;
     }[];
+    uuid: UUID;
+    session_id: string;
 };
-export type SDKPartialAssistantMessage = SDKMessageBase & {
+export type SDKPartialAssistantMessage = {
     type: 'stream_event';
     event: RawMessageStreamEvent;
     parent_tool_use_id: string | null;
+    uuid: UUID;
+    session_id: string;
 };
-export type SDKCompactBoundaryMessage = SDKMessageBase & {
+export type SDKCompactBoundaryMessage = {
     type: 'system';
     subtype: 'compact_boundary';
     compact_metadata: {
         trigger: 'manual' | 'auto';
         pre_tokens: number;
     };
+    uuid: UUID;
+    session_id: string;
 };
-export type SDKHookResponseMessage = SDKMessageBase & {
+export type SDKHookResponseMessage = {
     type: 'system';
     subtype: 'hook_response';
     hook_name: string;
@@ -355,8 +366,27 @@ export type SDKHookResponseMessage = SDKMessageBase & {
     stdout: string;
     stderr: string;
     exit_code?: number;
+    uuid: UUID;
+    session_id: string;
 };
-export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKHookResponseMessage;
+export type SDKToolProgressMessage = {
+    type: 'tool_progress';
+    tool_use_id: string;
+    tool_name: string;
+    parent_tool_use_id: string | null;
+    elapsed_time_seconds: number;
+    uuid: UUID;
+    session_id: string;
+};
+export type SDKAuthStatusMessage = {
+    type: 'auth_status';
+    isAuthenticating: boolean;
+    output: string[];
+    error?: string;
+    uuid: UUID;
+    session_id: string;
+};
+export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKHookResponseMessage | SDKToolProgressMessage | SDKAuthStatusMessage;
 export interface Query extends AsyncGenerator<SDKMessage, void> {
     /**
      * Control Requests
@@ -405,6 +435,7 @@ export declare class AbortError extends Error {
 export type AgentDefinition = {
     description: string;
     tools?: string[];
+    disallowedTools?: string[];
     prompt: string;
     model?: 'sonnet' | 'opus' | 'haiku' | 'inherit';
 };
@@ -438,6 +469,7 @@ export type Options = {
     includePartialMessages?: boolean;
     maxThinkingTokens?: number;
     maxTurns?: number;
+    maxBudgetUsd?: number;
     mcpServers?: Record<string, McpServerConfig>;
     model?: string;
     pathToClaudeCodeExecutable?: string;

package/sdk.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // (c) Anthropic PBC. All rights reserved. Use is subject to the Legal Agreements outlined here: https://docs.claude.com/en/docs/claude-code/legal-and-compliance.
 
-// Version: 0.1.28
+// Version: 0.1.30
 
 // Want to see the unminified source? We're hiring!
 // https://job-boards.greenhouse.io/anthropic/jobs/4816199008
@@ -6387,6 +6387,7 @@ class ProcessTransport {
         appendSystemPrompt,
         maxThinkingTokens,
         maxTurns,
+        maxBudgetUsd,
         model,
         fallbackModel,
         permissionMode,
@@ -6419,6 +6420,9 @@ class ProcessTransport {
       }
       if (maxTurns)
         args.push("--max-turns", maxTurns.toString());
+      if (maxBudgetUsd !== undefined) {
+        args.push("--max-budget-usd", maxBudgetUsd.toString());
+      }
       if (model)
         args.push("--model", model);
       if (env.DEBUG)
@@ -7339,22 +7343,24 @@ var maxOutputTokensValidator = {
   name: "CLAUDE_CODE_MAX_OUTPUT_TOKENS",
   default: 32000,
   validate: (value) => {
+    const MAX_OUTPUT_TOKENS = 64000;
+    const DEFAULT_MAX_OUTPUT_TOKENS = 32000;
     if (!value) {
-      return { effective: 32000, status: "valid" };
+      return { effective: DEFAULT_MAX_OUTPUT_TOKENS, status: "valid" };
     }
     const parsed = parseInt(value, 10);
     if (isNaN(parsed) || parsed <= 0) {
       return {
-        effective: 32000,
+        effective: DEFAULT_MAX_OUTPUT_TOKENS,
         status: "invalid",
-        message: `Invalid value "${value}" (using default: 32000)`
+        message: `Invalid value "${value}" (using default: ${DEFAULT_MAX_OUTPUT_TOKENS})`
       };
     }
-    if (parsed > 32000) {
+    if (parsed > MAX_OUTPUT_TOKENS) {
       return {
-        effective: 32000,
+        effective: MAX_OUTPUT_TOKENS,
         status: "capped",
-        message: `Capped from ${parsed} to 32000`
+        message: `Capped from ${parsed} to ${MAX_OUTPUT_TOKENS}`
       };
     }
     return { effective: parsed, status: "valid" };
@@ -7782,7 +7788,8 @@ class Query {
       }
       logForDebugging(`[Query.streamInput] Finished processing ${messageCount} messages from input stream`);
       logForDebugging(`[Query.streamInput] About to check MCP servers. this.sdkMcpTransports.size = ${this.sdkMcpTransports.size}`);
-      if (this.sdkMcpTransports.size > 0 && this.firstResultReceivedPromise) {
+      const hasHooks = this.hooks && Object.keys(this.hooks).length > 0;
+      if ((this.sdkMcpTransports.size > 0 || hasHooks) && this.firstResultReceivedPromise) {
         logForDebugging(`[Query.streamInput] Entering Promise.race to wait for result`);
         let timeoutId;
         await Promise.race([
@@ -14763,7 +14770,7 @@ function query({
     const dirname2 = join3(filename, "..");
     pathToClaudeCodeExecutable = join3(dirname2, "cli.js");
   }
-  process.env.CLAUDE_AGENT_SDK_VERSION = "0.1.28";
+  process.env.CLAUDE_AGENT_SDK_VERSION = "0.1.30";
   const {
     abortController = createAbortController(),
     additionalDirectories = [],
@@ -14783,6 +14790,7 @@ function query({
     includePartialMessages,
     maxThinkingTokens,
     maxTurns,
+    maxBudgetUsd,
     mcpServers,
     model,
     permissionMode = "default",
@@ -14836,6 +14844,7 @@ function query({
     appendSystemPrompt,
     maxThinkingTokens,
     maxTurns,
+    maxBudgetUsd,
     model,
     fallbackModel,
     permissionMode,