@anthropic-ai/claude-agent-sdk 0.1.76 → 0.2.0

package/entrypoints/sandboxTypes.d.ts

@@ -4,32 +4,18 @@
  * This file is the single source of truth for sandbox configuration types.
  * Both the SDK and the settings validation import from here.
  */
-import { z } from 'zod';
+import { z } from 'zod/v4';
 /**
  * Network configuration schema for sandbox.
  */
 export declare const SandboxNetworkConfigSchema: z.ZodOptional<z.ZodObject<{
-    allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString>>;
     allowAllUnixSockets: z.ZodOptional<z.ZodBoolean>;
     allowLocalBinding: z.ZodOptional<z.ZodBoolean>;
     httpProxyPort: z.ZodOptional<z.ZodNumber>;
     socksProxyPort: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    allowedDomains?: string[];
-    allowUnixSockets?: string[];
-    allowAllUnixSockets?: boolean;
-    allowLocalBinding?: boolean;
-    httpProxyPort?: number;
-    socksProxyPort?: number;
-}, {
-    allowedDomains?: string[];
-    allowUnixSockets?: string[];
-    allowAllUnixSockets?: boolean;
-    allowLocalBinding?: boolean;
-    httpProxyPort?: number;
-    socksProxyPort?: number;
-}>>;
+}, z.core.$strip>>;
 /**
  * Sandbox settings schema.
  */
@@ -38,119 +24,21 @@ export declare const SandboxSettingsSchema: z.ZodObject<{
     autoAllowBashIfSandboxed: z.ZodOptional<z.ZodBoolean>;
     allowUnsandboxedCommands: z.ZodOptional<z.ZodBoolean>;
     network: z.ZodOptional<z.ZodObject<{
-        allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString>>;
         allowAllUnixSockets: z.ZodOptional<z.ZodBoolean>;
         allowLocalBinding: z.ZodOptional<z.ZodBoolean>;
         httpProxyPort: z.ZodOptional<z.ZodNumber>;
         socksProxyPort: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        allowedDomains?: string[];
-        allowUnixSockets?: string[];
-        allowAllUnixSockets?: boolean;
-        allowLocalBinding?: boolean;
-        httpProxyPort?: number;
-        socksProxyPort?: number;
-    }, {
-        allowedDomains?: string[];
-        allowUnixSockets?: string[];
-        allowAllUnixSockets?: boolean;
-        allowLocalBinding?: boolean;
-        httpProxyPort?: number;
-        socksProxyPort?: number;
-    }>>;
-    ignoreViolations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+    }, z.core.$strip>>;
+    ignoreViolations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     enableWeakerNestedSandbox: z.ZodOptional<z.ZodBoolean>;
-    excludedCommands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    excludedCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
     ripgrep: z.ZodOptional<z.ZodObject<{
         command: z.ZodString;
-        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        command?: string;
-        args?: string[];
-    }, {
-        command?: string;
-        args?: string[];
-    }>>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    enabled: z.ZodOptional<z.ZodBoolean>;
-    autoAllowBashIfSandboxed: z.ZodOptional<z.ZodBoolean>;
-    allowUnsandboxedCommands: z.ZodOptional<z.ZodBoolean>;
-    network: z.ZodOptional<z.ZodObject<{
-        allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        allowAllUnixSockets: z.ZodOptional<z.ZodBoolean>;
-        allowLocalBinding: z.ZodOptional<z.ZodBoolean>;
-        httpProxyPort: z.ZodOptional<z.ZodNumber>;
-        socksProxyPort: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        allowedDomains?: string[];
-        allowUnixSockets?: string[];
-        allowAllUnixSockets?: boolean;
-        allowLocalBinding?: boolean;
-        httpProxyPort?: number;
-        socksProxyPort?: number;
-    }, {
-        allowedDomains?: string[];
-        allowUnixSockets?: string[];
-        allowAllUnixSockets?: boolean;
-        allowLocalBinding?: boolean;
-        httpProxyPort?: number;
-        socksProxyPort?: number;
-    }>>;
-    ignoreViolations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-    enableWeakerNestedSandbox: z.ZodOptional<z.ZodBoolean>;
-    excludedCommands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    ripgrep: z.ZodOptional<z.ZodObject<{
-        command: z.ZodString;
-        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        command?: string;
-        args?: string[];
-    }, {
-        command?: string;
-        args?: string[];
-    }>>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    enabled: z.ZodOptional<z.ZodBoolean>;
-    autoAllowBashIfSandboxed: z.ZodOptional<z.ZodBoolean>;
-    allowUnsandboxedCommands: z.ZodOptional<z.ZodBoolean>;
-    network: z.ZodOptional<z.ZodObject<{
-        allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        allowAllUnixSockets: z.ZodOptional<z.ZodBoolean>;
-        allowLocalBinding: z.ZodOptional<z.ZodBoolean>;
-        httpProxyPort: z.ZodOptional<z.ZodNumber>;
-        socksProxyPort: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        allowedDomains?: string[];
-        allowUnixSockets?: string[];
-        allowAllUnixSockets?: boolean;
-        allowLocalBinding?: boolean;
-        httpProxyPort?: number;
-        socksProxyPort?: number;
-    }, {
-        allowedDomains?: string[];
-        allowUnixSockets?: string[];
-        allowAllUnixSockets?: boolean;
-        allowLocalBinding?: boolean;
-        httpProxyPort?: number;
-        socksProxyPort?: number;
-    }>>;
-    ignoreViolations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-    enableWeakerNestedSandbox: z.ZodOptional<z.ZodBoolean>;
-    excludedCommands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    ripgrep: z.ZodOptional<z.ZodObject<{
-        command: z.ZodString;
-        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        command?: string;
-        args?: string[];
-    }, {
-        command?: string;
-        args?: string[];
-    }>>;
-}, z.ZodTypeAny, "passthrough">>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
 export type SandboxSettings = z.infer<typeof SandboxSettingsSchema>;
 export type SandboxNetworkConfig = NonNullable<z.infer<typeof SandboxNetworkConfigSchema>>;
 export type SandboxIgnoreViolations = NonNullable<SandboxSettings['ignoreViolations']>;

package/entrypoints/sdk/controlTypes.d.ts

@@ -0,0 +1,2 @@
+export * from './coreTypes.js';
+export * from './controlTypes.generated.js';

package/entrypoints/{sdkControlTypes.d.ts → sdk/controlTypes.generated.d.ts}

@@ -1,105 +1,135 @@
-import { type AccountInfo, type PermissionMode, type SDKMessage, type SDKUserMessage, type HookInput, type HookEvent, type PermissionUpdate, type ModelInfo, type SlashCommand, type AgentDefinition, type McpServerConfigForProcessTransport } from './agentSdkTypes.js';
+/**
+ * AUTO-GENERATED - DO NOT EDIT
+ *
+ * This file is auto-generated from Zod schemas in controlSchemas.ts.
+ * To modify these types, edit the Zod schemas and run:
+ *
+ *   bun scripts/generate-sdk-types.ts
+ */
 import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import type * as coreTypes from './coreTypes.js';
+export type ControlErrorResponse = {
+    subtype: 'error';
+    request_id: string;
+    error: string;
+    pending_permission_requests?: SDKControlRequest[];
+};
+export type ControlResponse = {
+    subtype: 'success';
+    request_id: string;
+    response?: Record<string, unknown>;
+};
+/**
+ * Cancels a currently open control request.
+ */
+export type SDKControlCancelRequest = {
+    type: 'control_cancel_request';
+    request_id: string;
+};
 export type SDKControlInitializeRequest = {
     subtype: 'initialize';
-    hooks?: Partial<Record<HookEvent, SDKHookCallbackMatcher[]>>;
+    hooks?: Partial<Record<coreTypes.HookEvent, SDKHookCallbackMatcher[]>>;
     sdkMcpServers?: string[];
     jsonSchema?: Record<string, unknown>;
     systemPrompt?: string;
     appendSystemPrompt?: string;
-    agents?: Record<string, AgentDefinition>;
+    agents?: Record<string, coreTypes.AgentDefinition>;
 };
 export type SDKControlInitializeResponse = {
-    commands: SlashCommand[];
+    commands: coreTypes.SlashCommand[];
     output_style: string;
     available_output_styles: string[];
-    models: ModelInfo[];
-    account: AccountInfo;
+    models: coreTypes.ModelInfo[];
+    /** Information about the logged in user's account. */
+    account: coreTypes.AccountInfo;
 };
 export type SDKControlInterruptRequest = {
     subtype: 'interrupt';
 };
+export type SDKControlMcpMessageRequest = {
+    subtype: 'mcp_message';
+    server_name: string;
+    message: JSONRPCMessage;
+};
+export type SDKControlMcpSetServersRequest = {
+    subtype: 'mcp_set_servers';
+    servers: Record<string, coreTypes.McpServerConfigForProcessTransport>;
+};
+export type SDKControlMcpSetServersResponse = {
+    added: string[];
+    removed: string[];
+    errors: Record<string, string>;
+};
+export type SDKControlMcpStatusRequest = {
+    subtype: 'mcp_status';
+};
 export type SDKControlPermissionRequest = {
     subtype: 'can_use_tool';
     tool_name: string;
     input: Record<string, unknown>;
-    permission_suggestions?: PermissionUpdate[];
+    permission_suggestions?: coreTypes.PermissionUpdate[];
     blocked_path?: string;
     decision_reason?: string;
     tool_use_id: string;
     agent_id?: string;
 };
-export type SDKControlSetPermissionModeRequest = {
-    subtype: 'set_permission_mode';
-    mode: PermissionMode;
+export type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlMcpSetServersRequest;
+export type SDKControlRequest = {
+    type: 'control_request';
+    request_id: string;
+    request: SDKControlRequestInner;
 };
-export type SDKControlSetModelRequest = {
-    subtype: 'set_model';
-    model?: string;
+export type SDKControlResponse = {
+    type: 'control_response';
+    response: ControlResponse | ControlErrorResponse;
+};
+export type SDKControlRewindFilesRequest = {
+    subtype: 'rewind_files';
+    user_message_id: string;
+    dry_run?: boolean;
+};
+/**
+ * Result of a rewindFiles operation.
+ */
+export type SDKControlRewindFilesResponse = {
+    canRewind: boolean;
+    error?: string;
+    filesChanged?: string[];
+    insertions?: number;
+    deletions?: number;
 };
 export type SDKControlSetMaxThinkingTokensRequest = {
     subtype: 'set_max_thinking_tokens';
     max_thinking_tokens: number | null;
 };
-export type SDKControlMcpStatusRequest = {
-    subtype: 'mcp_status';
+export type SDKControlSetModelRequest = {
+    subtype: 'set_model';
+    model?: string;
 };
-export type SDKControlRewindFilesRequest = {
-    subtype: 'rewind_files';
-    user_message_id: string;
+export type SDKControlSetPermissionModeRequest = {
+    subtype: 'set_permission_mode';
+    /** Permission mode for controlling how tool executions are handled. 'default' - Standard behavior, prompts for dangerous operations. 'acceptEdits' - Auto-accept file edit operations. 'bypassPermissions' - Bypass all permission checks (requires allowDangerouslySkipPermissions). 'plan' - Planning mode, no actual tool execution. 'delegate' - Delegate mode, restricts team leader to only Teammate and Task tools. 'dontAsk' - Don't prompt for permissions, deny if not pre-approved. */
+    mode: coreTypes.PermissionMode;
 };
+/**
+ * Configuration for matching and routing hook callbacks.
+ */
 export type SDKHookCallbackMatcher = {
     matcher?: string;
     hookCallbackIds: string[];
-    /** Timeout in seconds for all hooks in this matcher */
     timeout?: number;
 };
 export type SDKHookCallbackRequest = {
     subtype: 'hook_callback';
     callback_id: string;
-    input: HookInput;
+    input: coreTypes.HookInput;
     tool_use_id?: string;
 };
-export type SDKControlMcpMessageRequest = {
-    subtype: 'mcp_message';
-    server_name: string;
-    message: JSONRPCMessage;
-};
-export type SDKControlMcpSetServersRequest = {
-    subtype: 'mcp_set_servers';
-    servers: Record<string, McpServerConfigForProcessTransport>;
-};
-export type SDKControlMcpSetServersResponse = {
-    added: string[];
-    removed: string[];
-    errors: Record<string, string>;
-};
-export type SDKControlRequest = {
-    type: 'control_request';
-    request_id: string;
-    request: SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlMcpSetServersRequest;
-};
-export type SDKControlResponse = {
-    type: 'control_response';
-    response: ControlResponse | ControlErrorResponse;
-};
-export type ControlResponse = {
-    subtype: 'success';
-    request_id: string;
-    response?: Record<string, unknown>;
-};
-export type ControlErrorResponse = {
-    subtype: 'error';
-    request_id: string;
-    error: string;
-    pending_permission_requests?: SDKControlRequest[];
-};
-export type SDKControlCancelRequest = {
-    type: 'control_cancel_request';
-    request_id: string;
-};
+/**
+ * Keep-alive message to maintain WebSocket connection.
+ */
 export type SDKKeepAliveMessage = {
     type: 'keep_alive';
 };
-export type StdoutMessage = SDKMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
-export type StdinMessage = SDKUserMessage | SDKControlRequest | SDKControlResponse | SDKKeepAliveMessage;
+export type StdinMessage = coreTypes.SDKUserMessage | SDKControlRequest | SDKControlResponse | SDKKeepAliveMessage;
+export type StdoutMessage = coreTypes.SDKMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;

package/entrypoints/sdk/coreTypes.d.ts

@@ -0,0 +1,5 @@
+export * from './coreTypes.generated.js';
+export type { SandboxSettings, SandboxNetworkConfig, SandboxIgnoreViolations, } from '../sandboxTypes.js';
+export type { NonNullableUsage } from './sdkUtilityTypes.js';
+export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PermissionRequest"];
+export declare const EXIT_REASONS: readonly ["clear", "logout", "prompt_input_exit", "other", "bypass_permissions_disabled"];