@anthropic-ai/claude-agent-sdk 0.1.39 → 0.1.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.1.39",
+  "version": "0.1.43",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "engines": {

package/sdk.d.ts

@@ -97,6 +97,10 @@ export type PermissionResult = {
      * commands.
      */
     updatedPermissions?: PermissionUpdate[];
+    /**
+     * The tool use ID. Supplied and used internally.
+     */
+    toolUseID?: string;
 } | {
     behavior: 'deny';
     /**
@@ -112,6 +116,10 @@ export type PermissionResult = {
      * which the model should incorporate and continue.
      */
     interrupt?: boolean;
+    /**
+     * The tool use ID. Supplied and used internally.
+     */
+    toolUseID?: string;
 };
 export type PermissionRuleValue = {
     toolName: string;
@@ -129,13 +137,20 @@ export type CanUseTool = (toolName: string, input: Record<string, unknown>, opti
      * `updatedPermissions` in the PermissionResult.
      */
     suggestions?: PermissionUpdate[];
+    /**
+     * The file path that triggered the permission request, if applicable.
+     * For example, when a Bash command tries to access a path outside allowed directories.
+     */
+    blockedPath?: string;
+    /** Explains why this permission request was triggered. */
+    decisionReason?: string;
     /**
      * Unique identifier for this specific tool call within the assistant message.
      * Multiple tool calls in the same assistant message will have different toolUseIDs.
      */
     toolUseID: string;
 }) => Promise<PermissionResult>;
-export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStop", "PreCompact"];
+export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact"];
 export type HookEvent = (typeof HOOK_EVENTS)[number];
 export type HookCallback = (input: HookInput, toolUseID: string | undefined, options: {
     signal: AbortSignal;
@@ -156,12 +171,14 @@ export type PreToolUseHookInput = BaseHookInput & {
     hook_event_name: 'PreToolUse';
     tool_name: string;
     tool_input: unknown;
+    tool_use_id: string;
 };
 export type PostToolUseHookInput = BaseHookInput & {
     hook_event_name: 'PostToolUse';
     tool_name: string;
     tool_input: unknown;
     tool_response: unknown;
+    tool_use_id: string;
 };
 export type NotificationHookInput = BaseHookInput & {
     hook_event_name: 'Notification';
@@ -181,9 +198,16 @@ export type StopHookInput = BaseHookInput & {
     hook_event_name: 'Stop';
     stop_hook_active: boolean;
 };
+export type SubagentStartHookInput = BaseHookInput & {
+    hook_event_name: 'SubagentStart';
+    agent_id: string;
+    agent_type: string;
+};
 export type SubagentStopHookInput = BaseHookInput & {
     hook_event_name: 'SubagentStop';
     stop_hook_active: boolean;
+    agent_id: string;
+    agent_transcript_path: string;
 };
 export type PreCompactHookInput = BaseHookInput & {
     hook_event_name: 'PreCompact';
@@ -196,7 +220,7 @@ export type SessionEndHookInput = BaseHookInput & {
     hook_event_name: 'SessionEnd';
     reason: ExitReason;
 };
-export type HookInput = PreToolUseHookInput | PostToolUseHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | SubagentStopHookInput | PreCompactHookInput;
+export type HookInput = PreToolUseHookInput | PostToolUseHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput;
 export type AsyncHookJSONOutput = {
     async: true;
     asyncTimeout?: number;
@@ -219,6 +243,9 @@ export type SyncHookJSONOutput = {
     } | {
         hookEventName: 'SessionStart';
         additionalContext?: string;
+    } | {
+        hookEventName: 'SubagentStart';
+        additionalContext?: string;
     } | {
         hookEventName: 'PostToolUse';
         additionalContext?: string;
@@ -302,11 +329,12 @@ export type SDKResultMessage = {
         [modelName: string]: ModelUsage;
     };
     permission_denials: SDKPermissionDenial[];
+    structured_output?: unknown;
     uuid: UUID;
     session_id: string;
 } | {
     type: 'result';
-    subtype: 'error_during_execution' | 'error_max_turns' | 'error_max_budget_usd';
+    subtype: 'error_during_execution' | 'error_max_turns' | 'error_max_budget_usd' | 'error_max_structured_output_retries';
     duration_ms: number;
     duration_api_ms: number;
     is_error: boolean;
@@ -484,6 +512,7 @@ export type Options = {
     maxBudgetUsd?: number;
     mcpServers?: Record<string, McpServerConfig>;
     model?: string;
+    outputSchema?: Record<string, unknown>;
     pathToClaudeCodeExecutable?: string;
     permissionMode?: PermissionMode;
     allowDangerouslySkipPermissions?: boolean;
@@ -505,10 +534,9 @@ export type Options = {
     plugins?: SdkPluginConfig[];
     resume?: string;
     /**
-     * When resuming, only resume messages up to and including the assistant
-     * message with this message.id. Use with --resume.
-     * This allows you to resume from a specific point in the conversation.
-     * The message ID is expected to be from SDKAssistantMessage.message.id.
+     * When resuming, only resume messages up to and including the message with this message.uuid.
+     * Use with --resume. This allows you to resume from a specific point in the conversation.
+     * The message ID is expected to be from SDKAssistantMessage.uuid.
      */
     resumeSessionAt?: string;
     settingSources?: SettingSource[];

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.39
+// Version: 0.1.43
 
 // Want to see the unminified source? We're hiring!
 // https://job-boards.greenhouse.io/anthropic/jobs/4816199008
@@ -6349,6 +6349,7 @@ var HOOK_EVENTS = [
   "SessionStart",
   "SessionEnd",
   "Stop",
+  "SubagentStart",
   "SubagentStop",
   "PreCompact"
 ];
@@ -6403,6 +6404,7 @@ class ProcessTransport {
         maxBudgetUsd,
         model,
         fallbackModel,
+        outputSchema,
         permissionMode,
         allowDangerouslySkipPermissions,
         permissionPromptToolName,
@@ -6438,6 +6440,9 @@ class ProcessTransport {
       }
       if (model)
         args.push("--model", model);
+      if (outputSchema) {
+        args.push("--output-schema", JSON.stringify(outputSchema));
+      }
       if (env.DEBUG)
         args.push("--debug-to-stderr");
       if (canUseTool) {
@@ -7435,7 +7440,8 @@ function getInitialState() {
     envVarValidators: [bashMaxOutputLengthValidator, maxOutputTokensValidator],
     lastAPIRequest: null,
     inMemoryErrorLog: [],
-    inlinePlugins: []
+    inlinePlugins: [],
+    sessionBypassPermissionsMode: false
   };
 }
 var STATE = getInitialState();
@@ -7665,11 +7671,17 @@ class Query {
       if (!this.canUseTool) {
         throw new Error("canUseTool callback is not provided.");
       }
-      return this.canUseTool(request.request.tool_name, request.request.input, {
+      const result = await this.canUseTool(request.request.tool_name, request.request.input, {
         signal,
         suggestions: request.request.permission_suggestions,
+        blockedPath: request.request.blocked_path,
+        decisionReason: request.request.decision_reason,
         toolUseID: request.request.tool_use_id
       });
+      return {
+        ...result,
+        toolUseID: request.request.tool_use_id
+      };
     } else if (request.request.subtype === "hook_callback") {
       const result = await this.handleHookCallbacks(request.request.callback_id, request.request.input, request.request.tool_use_id, signal);
       return result;
@@ -7750,6 +7762,12 @@ class Query {
       max_thinking_tokens: maxThinkingTokens
     });
   }
+  async rewindCode(userMessageId) {
+    await this.request({
+      subtype: "rewind_code",
+      user_message_id: userMessageId
+    });
+  }
   async processPendingPermissionRequests(pendingPermissionRequests) {
     for (const request of pendingPermissionRequests) {
       if (request.request.subtype === "can_use_tool") {
@@ -14802,7 +14820,7 @@ function query({
     const dirname2 = join3(filename, "..");
     pathToClaudeCodeExecutable = join3(dirname2, "cli.js");
   }
-  process.env.CLAUDE_AGENT_SDK_VERSION = "0.1.39";
+  process.env.CLAUDE_AGENT_SDK_VERSION = "0.1.43";
   const {
     abortController = createAbortController(),
     additionalDirectories = [],
@@ -14825,6 +14843,7 @@ function query({
     maxBudgetUsd,
     mcpServers,
     model,
+    outputSchema,
     permissionMode = "default",
     allowDangerouslySkipPermissions = false,
     permissionPromptToolName,
@@ -14879,6 +14898,7 @@ function query({
     maxBudgetUsd,
     model,
     fallbackModel,
+    outputSchema,
     permissionMode,
     allowDangerouslySkipPermissions,
     permissionPromptToolName,