@anthropic-ai/claude-agent-sdk 0.2.131 → 0.2.133

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.131",
-  "commit": "c122cd1bd5247f2a4bde8bcaec712fb1dff247e8",
-  "buildDate": "2026-05-06T06:18:01Z",
+  "version": "2.1.133",
+  "commit": "cba57ffec4f5d5c279b5f66ea9d7a2544fa410ec",
+  "buildDate": "2026-05-07T18:34:30Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "cc6066b0db7bb423c75316366542f771a41923999a76a5771afad87dd65dceae",
-      "size": 217349888
+      "checksum": "d38f34444911c86c73f32beb82821008b26be889fa0d0caf7085580cf5737e14",
+      "size": 204170768
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "a1bd2c782c3f961987d7d6456f75b3fa538cc425f1573908850afedcb038ca5f",
-      "size": 218914128
+      "checksum": "b16758680c3bb1e0f8a867e31f9df84e8df2473b0693e811f0b29b465d2e64c3",
+      "size": 206672560
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "0919cdf512ca673b38230882b458801b78e9248eb472383631cfc12d8d0d55cf",
-      "size": 249367104
+      "checksum": "dcc7275f9198317e073c329abe174827604a801e9bfb577a00d86efcf4f8167c",
+      "size": 229619336
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "9af15b9302ffde3fa83e3ea4a41cdd00158301cd8badc755567a8e9149f1c36c",
-      "size": 249178752
+      "checksum": "d0ddf0aee6e4426a705719e5d4716e3ce3cb38f9a5fe06eb6d5ffcef6c98832a",
+      "size": 229701328
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "78ffce2cad108ef1ca3301fc34307277b8a98e4095344b091b84be1678bd6ebc",
-      "size": 242092416
+      "checksum": "fd8370f93bb41b4018b7ec26f421368c25630e42129882e9c6ae6b719d595330",
+      "size": 222474072
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "f712c043f6df7552b95d30d256ebc4feb9c3a642f04b0e823719b524e3128939",
-      "size": 243444096
+      "checksum": "9dedf83f3e367bcd306e80a47c06f70234e02e38846096f39d84a0131d7a5320",
+      "size": 224095280
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "49204d250c5fe1797f74bc68f305016e72b356b06fe7ff1f8a651f7ad6a0df8b",
-      "size": 255085216
+      "checksum": "ba4c41963ed7d6567dfec0e7b252cdbc02f17a4f7c0a9e69ca2d7ccb9e94016e",
+      "size": 225659552
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "d1b1336200468b5e29a0e4cc8c1dfc5c79d01f11118d8594756243bb6102dc40",
-      "size": 251148960
+      "checksum": "389d5e7bc9d4bf3f1909c60be63fccc93cc824d7c691638418a5904ce675afbd",
+      "size": 221617824
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.131",
-  "commit": "c122cd1bd5247f2a4bde8bcaec712fb1dff247e8",
-  "buildDate": "2026-05-06T06:24:18Z",
+  "version": "2.1.133",
+  "commit": "cba57ffec4f5d5c279b5f66ea9d7a2544fa410ec",
+  "buildDate": "2026-05-07T18:41:25Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "b548092de9bca513348b766bcc3a975a4da7f12f91cd79bd03e9d763b7980a32",
-      "size": 44927139,
+      "checksum": "9947312c65fdd4c632926099ef4b0baf4796d232bb183c2a24e529055ddf338f",
+      "size": 42353282,
       "bundle": {
-        "checksum": "aa7e6b88856bd43a4aad9b1b716cb928ee1fac5293002283d6276b65ae193b0e",
-        "size": 44930068
+        "checksum": "acdc148b07ca2d5d58d1ef0f7d9d1263fa9380b8368d00c48abd78a4fa998ad0",
+        "size": 42360716
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "60e9b87bf74b7283ef3c15e890bc0a52ee8b021c16d489989339fe9fed26d398",
-      "size": 46624953,
+      "checksum": "907bcb38b96e7a0a141f299467550b9ead5ee8ec21b2e0943eca5ba291188ce0",
+      "size": 44266071,
       "bundle": {
-        "checksum": "8110110c6c7c7119ff714940fc3521eea11e485e3dfdb1209c7b301155d72ca4",
-        "size": 46628908
+        "checksum": "038c40341848d7808ae976373887e1f06ec0ef1522d7a21d6082693fdb3da4f2",
+        "size": 44263353
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "d1a9749375ae4b0f48e8736e95782ac8417a772e7031faf65aa19096a7a0f74f",
-      "size": 54468169
+      "checksum": "38716ff150d6b551d1dbeb7bd27ca0d06ce3e836e6fce77af6c3ac13c2e18967",
+      "size": 50147780
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "c97f80e7b8daa2d865d58b8c48a6a60c605d97f1abce5bbea88d738db5c4e40e",
-      "size": 55029869
+      "checksum": "2b3f2b28ba5142c87b740bbd3d587ebe1c1e051cace6f8326207bdc1205849fa",
+      "size": 50761829
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "74a584b30e50d6b83ed18254fe0a5cf28143c089b28d149655b655a220344ae4",
-      "size": 53061718
+      "checksum": "b8fa2a77e0ab7a07f3cb91418c4e5edf99ef3291b762481aa14916301feba40d",
+      "size": 48774646
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "92d07fef73348f5b2ac6b1af4773ea2c01bf14b95c8aadb19b89385f16217d4d",
-      "size": 53729600
+      "checksum": "0eb3c6bd29e5ce9eec973682e701de06663ca432b29b339903edeb12b853dea4",
+      "size": 49480595
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "df6987816a2ce72a4abff77ffb75f0161e54cc476bfcca31872d6a079a552b86",
-      "size": 56098167
+      "checksum": "ebfd46c5664f381e6b9e2cae2b05ab446776ae160314474aec00f9372bd361af",
+      "size": 51506130
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "6d8700265a93999c5c6fc404b3a647da6955ca3d2d3cbd0a2a0598ae20d0c3cf",
-      "size": 54237735
+      "checksum": "22bddc1a6f82e2b3be2c2a85540f802b698ebe5c51076bac924966ad2b358ab6",
+      "size": 49773273
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.131",
+  "version": "0.2.133",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -55,14 +55,14 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.131",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.131",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.131",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.131",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.131",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.131",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.131",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.131"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.133",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.133",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.133",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.133",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.133",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.133",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.133",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.133"
   },
   "files": [
     "sdk.mjs",
@@ -78,5 +78,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.131"
+  "claudeCodeVersion": "2.1.133"
 }

package/sdk-tools.d.ts

@@ -324,7 +324,7 @@ export interface BashInput {
    */
   description?: string;
   /**
-   * Set to true to run this command in the background. Use Read to read the output later.
+   * Set to true to run this command in the background.
    */
   run_in_background?: boolean;
   /**

package/sdk.d.ts

@@ -41,7 +41,7 @@ export declare type AgentDefinition = {
      */
     description: string;
     /**
-     * Array of allowed tool names. If omitted, inherits all tools from parent
+     * Array of allowed tool names. If omitted, inherits all tools from parent. Note: passing 'Skill' here is deprecated — use the `skills` field instead.
      */
     tools?: string[];
     /**
@@ -133,6 +133,15 @@ export declare type BaseHookInput = {
      * Agent type name (e.g., "general-purpose", "code-reviewer"). Present when the hook fires from within a subagent (alongside agent_id), or on the main thread of a session started with --agent (without agent_id).
      */
     agent_type?: string;
+    /**
+     * Reasoning effort applied to the current turn. Same shape as StatusLineCommandInput.effort. Present for hooks that fire within a tool-use context (PreToolUse, PostToolUse, Stop, SubagentStop, etc.) on a model that supports the effort parameter; absent for session-lifecycle hooks and models without effort support.
+     */
+    effort?: {
+        /**
+         * Active effort level for the current turn (e.g., "low", "medium", "high", "xhigh", "max"), after any silent downgrade for the selected model. Also exposed to hook commands and Bash as the CLAUDE_EFFORT env var.
+         */
+        level: string;
+    };
 };
 
 export declare type BaseOutputFormat = {
@@ -1185,6 +1194,8 @@ export declare type Options = {
      * List of tool names that are auto-allowed without prompting for permission.
      * These tools will execute automatically without asking the user for approval.
      * To restrict which tools are available, use the `tools` option instead.
+     *
+     * Note: passing `'Skill'` here is deprecated — use the `skills` option instead.
      */
     allowedTools?: string[];
     /**
@@ -1614,19 +1625,21 @@ export declare type Options = {
      */
     settings?: string | Settings;
     /**
-     * Policy-tier settings supplied by the spawning parent process. Merged into
-     * the managed-settings layer below IT-controlled sources (server / MDM /
-     * managed-settings.json) but above HKCU. Honors policy-only keys such as
-     * `sandbox.network.allowManagedDomainsOnly`.
+     * Policy-tier settings supplied by the spawning parent process. When an
+     * IT-controlled managed-settings tier (server / MDM / managed-settings.json)
+     * exists on the user's machine, these are **dropped by default** — they only
+     * layer in if that admin opts in via `parentSettingsBehavior: 'merge'` in
+     * their managed settings. Even when opted in, the value is filtered
+     * restrictive-only: permissive arrays (`permissions.allow`,
+     * `additionalDirectories`, `allowedMcpServers`, …) that would widen an
+     * existing admin lock are silently dropped. With no admin tier present,
+     * these apply as the sole policy tier (still filtered restrictive-only —
+     * non-allowlisted keys are dropped regardless).
      *
      * Intended for embedding applications (e.g. desktop apps) that derive
      * lockdown settings from their own enterprise configuration and need to
      * enforce them on the spawned subprocess without writing root-owned files.
      *
-     * Unlike `settings`, this option is loaded into the managed (policy) layer
-     * rather than the user-controlled flag layer, so user/project settings
-     * cannot widen restrictions set here.
-     *
      * @example
      * ```typescript
      * managedSettings: {
@@ -2066,17 +2079,25 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
     setMaxThinkingTokens(maxThinkingTokens: number | null): Promise<void>;
     /**
      * Merge the provided settings into the flag settings layer, dynamically
-     * updating the active configuration. Top-level keys are shallow-merged
-     * across successive calls — a second call with `{permissions: {...}}`
-     * replaces the entire `permissions` object from a prior call. The resulting
-     * flag settings are then deep-merged with file-based settings at read time.
+     * updating the active configuration. Equivalent to the inline `settings`
+     * option of `query()`, but applies mid-session. Flag settings sit above
+     * user/project/local settings and below managed policy settings in the
+     * precedence order.
      *
-     * Equivalent to passing an object to the `settings` option of `query()`,
-     * but applies mid-session. Only available in streaming input mode.
+     * Successive calls shallow-merge top-level keys — a second call with
+     * `{permissions: {...}}` replaces the entire `permissions` object from a
+     * prior call. Pass `null` for a key to clear it from the flag layer and
+     * fall back to lower-precedence sources (`undefined` is dropped by JSON
+     * serialization and has no effect).
+     *
+     * Only available in streaming input mode.
      *
-     * @param settings - A partial settings object to merge into the flag settings
+     * @param settings - A partial settings object to merge into the flag settings.
+     * Each top-level key also accepts `null` to clear it from the flag layer.
      */
-    applyFlagSettings(settings: Settings): Promise<void>;
+    applyFlagSettings(settings: {
+        [K in keyof Settings]?: Settings[K] | null;
+    }): Promise<void>;
     /**
      * Get the full initialization result, including supported commands, models,
      * account info, and output style configuration.
@@ -2322,6 +2343,8 @@ declare const SandboxSettingsSchema: () => z.ZodObject<{
         command: z.ZodString;
         args: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    bwrapPath: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<string, unknown>, z.ZodString>>>;
+    socatPath: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<string, unknown>, z.ZodString>>>;
 }, z.core.$loose>;
 
 /**
@@ -3173,6 +3196,7 @@ export declare type SDKResultSuccess = {
  * V2 API - UNSTABLE
  * Session interface for multi-turn conversations.
  * Has methods, so not serializable.
+ * @deprecated Use `query()` instead. The V2 session API will be removed in a future release.
  * @alpha
  */
 export declare interface SDKSession {
@@ -3241,6 +3265,7 @@ export declare type SDKSessionInfo = {
 /**
  * V2 API - UNSTABLE
  * Options for creating a session.
+ * @deprecated Use `query()` instead. The V2 session API will be removed in a future release.
  * @alpha
  */
 export declare type SDKSessionOptions = {
@@ -4130,6 +4155,10 @@ export declare interface Settings {
          * Directories to include when creating worktrees, via git sparse-checkout (cone mode). Dramatically faster in large monorepos — only the listed paths are written to disk.
          */
         sparsePaths?: string[];
+        /**
+         * Which ref new worktrees branch from. 'fresh' (default) branches from origin/<default-branch> for a clean tree. 'head' branches from your current local HEAD so unpushed commits and feature-branch state are present. Applies to --worktree, EnterWorktree, and agent isolation.
+         */
+        baseRef?: 'fresh' | 'head';
     };
     /**
      * Disable all hooks and statusLine execution
@@ -4203,7 +4232,7 @@ export declare interface Settings {
         command: string;
     };
     /**
-     * Enabled plugins using plugin-id\@marketplace-id format. Example: { "formatter\@anthropic-tools": true }. Also supports extended format with version constraints.
+     * Enabled plugins using plugin-id\@marketplace-id format. Example: { "formatter\@anthropic-tools": true }. Also supports extended format with version constraints. Settings precedence is user < project < local < flag < policy, so to disable a plugin that project settings enable, set it to false in .claude/settings.local.json — setting false in ~/.claude/settings.json is overridden by the project.
      */
     enabledPlugins?: {
         [k: string]: string[] | boolean | {
@@ -4769,6 +4798,10 @@ export declare interface Settings {
      * Force a specific login method: "claudeai" for Claude Pro/Max, "console" for Console billing
      */
     forceLoginMethod?: 'claudeai' | 'console';
+    /**
+     * Controls whether the SDK parent tier (Options.managedSettings / --managed-settings) layers under this admin tier. "first-wins" (default): parent is dropped — admin tiers are the only policy source. "merge": parent's restrictive-only-filtered settings union under the admin winner. Has no effect when no admin tier exists (parent applies as the sole policy tier, still filtered restrictive-only).
+     */
+    parentSettingsBehavior?: 'first-wins' | 'merge';
     /**
      * Organization UUID to require for OAuth login. Accepts a single UUID string or an array of UUIDs (any one is permitted). When set in managed settings, login fails if the authenticated account does not belong to a listed organization.
      */
@@ -4872,6 +4905,14 @@ export declare interface Settings {
             command: string;
             args?: string[];
         };
+        /**
+         * Linux/WSL only: Absolute path to the bwrap (bubblewrap) binary. Overrides auto-detection via PATH. Only honored from admin-controlled managed settings.
+         */
+        bwrapPath?: string;
+        /**
+         * Linux/WSL only: Absolute path to the socat binary used for the sandbox network proxy. Overrides auto-detection via PATH. Only honored from admin-controlled managed settings.
+         */
+        socatPath?: string;
         [k: string]: unknown;
     };
     /**
@@ -5466,6 +5507,7 @@ export declare interface Transport {
 /**
  * V2 API - UNSTABLE
  * Create a persistent session for multi-turn conversations.
+ * @deprecated Use `query()` instead. The V2 session API will be removed in a future release.
  * @alpha
  */
 export declare function unstable_v2_createSession(_options: SDKSessionOptions): SDKSession;
@@ -5473,6 +5515,7 @@ export declare function unstable_v2_createSession(_options: SDKSessionOptions):
 /**
  * V2 API - UNSTABLE
  * One-shot convenience function for single prompts.
+ * @deprecated Use `query()` instead. The V2 session API will be removed in a future release.
  * @alpha
  *
  * @example
@@ -5487,6 +5530,7 @@ export declare function unstable_v2_prompt(_message: string, _options: SDKSessio
 /**
  * V2 API - UNSTABLE
  * Resume an existing session by ID.
+ * @deprecated Use `query()` instead. The V2 session API will be removed in a future release.
  * @alpha
  */
 export declare function unstable_v2_resumeSession(_sessionId: string, _options: SDKSessionOptions): SDKSession;