@anthropic-ai/claude-agent-sdk 0.3.280 → 0.3.281

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/manifest.json CHANGED
@@ -1,54 +1,53 @@
1
1
  {
2
- "version": "2.1.280",
2
+ "version": "2.1.281",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "80abbfe7d7232280011ff01a21ae3338f4c6e372",
5
- "modsCommit": "8187baaaafb3a9ada02d3d6fb4e8d68587aef6b0",
6
- "buildDate": "2026-09-21T20:55:27Z",
4
+ "commit": "3e320108de6831eb996e9a3f7795152073cc0d0c",
5
+ "modsCommit": "56f36532530f88b572854538d685fcf781141e8c",
6
+ "buildDate": "2026-09-23T02:33:18Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude",
10
- "checksum": "387a5c5dcdbb815085edf0baf79591f9d8894efe922bceaf3d75b1b08055229d",
11
- "size": 217254576
10
+ "checksum": "a922981f6f3b55a251ef9f9dbaa0621a5f99cbcb5ca67f8a797476ccfc83f626",
11
+ "size": 220931760
12
12
  },
13
13
  "darwin-x64": {
14
14
  "binary": "claude",
15
- "checksum": "c1d32d87630482250633208ab77855429b24010ae3086a7ff7539b57b93168d4",
16
- "size": 225565024
15
+ "checksum": "a9355cbb0d291ce948efcf61a6ef397401672f64fa5e5e67bca092fed6cd9088",
16
+ "size": 229263712
17
17
  },
18
18
  "linux-arm64": {
19
19
  "binary": "claude",
20
- "checksum": "92f2b4fd05d0bdcf7b9a0d4e0ecef4a1e4b368b290cd8fd07cff9a50013f45a2",
21
- "size": 233103352
20
+ "checksum": "dd27b36438a4fed1670cd29bad2fda6a73b628b6da55443e5c2f647fe6ed328f",
21
+ "size": 236773368
22
22
  },
23
23
  "linux-x64": {
24
24
  "binary": "claude",
25
- "checksum": "1e08503dbdf3c2cb0d706d32f3408277388d1c76ef108673e8fe42c1b322925b",
26
- "size": 233709640
25
+ "checksum": "56fe3da88458465fb27d7e9299dddb3fead55750fb9c2de795f233b5eea6dce1",
26
+ "size": 237375560
27
27
  },
28
28
  "linux-arm64-musl": {
29
29
  "binary": "claude",
30
- "checksum": "6a9f349dccd1c74ab854f1877c5ebdf074998571d0177e26c1f7f46f29e0f971",
31
- "size": 225457992
30
+ "checksum": "4f72ebbb08706651e7a2204303793700698f4046bc31f3e7e65b381063b7c210",
31
+ "size": 229128008
32
32
  },
33
33
  "linux-x64-musl": {
34
34
  "binary": "claude",
35
- "checksum": "8d25ffbf600882d7b985706cc10ea45995060637ed009b5700b65e162bb00b96",
36
- "size": 227467360
35
+ "checksum": "30220a5cf0628634599e0ede13a5cc814d21880116abf762f0598a33636f7bca",
36
+ "size": 231137376
37
37
  },
38
38
  "win32-x64": {
39
39
  "binary": "claude.exe",
40
- "checksum": "0e4195524b73eb77efbdf3e2b36de5322a29f0ca575dfd2d9b4f946b1d425469",
41
- "size": 237100192
40
+ "checksum": "39be063c2512b43347fe7b0ab18c46f1596141701c9c5fc895ddfca9a051067c",
41
+ "size": 240767648
42
42
  },
43
43
  "win32-arm64": {
44
44
  "binary": "claude.exe",
45
- "checksum": "f49980314f4c0418079979723ffd6c0d00d57e60b26fd95c53e53155ed913bdf",
46
- "size": 225107104
45
+ "checksum": "103730182fe4dd36b8ff7791a408ac6144b2c40e35ab7b56b3561ce1d385ecbb",
46
+ "size": 228774560
47
47
  }
48
48
  },
49
49
  "sdkCompat": {
50
50
  "testedWrapperVersions": [
51
- "0.3.240",
52
51
  "0.3.241",
53
52
  "0.3.242",
54
53
  "0.3.243",
@@ -77,7 +76,8 @@
77
76
  "0.3.275",
78
77
  "0.3.276",
79
78
  "0.3.277",
80
- "0.3.278"
79
+ "0.3.278",
80
+ "0.3.280"
81
81
  ],
82
82
  "harnessSchema": 1
83
83
  }
package/manifest.zst.json CHANGED
@@ -1,62 +1,61 @@
1
1
  {
2
- "version": "2.1.280",
2
+ "version": "2.1.281",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "80abbfe7d7232280011ff01a21ae3338f4c6e372",
5
- "modsCommit": "8187baaaafb3a9ada02d3d6fb4e8d68587aef6b0",
6
- "buildDate": "2026-09-21T20:56:45Z",
4
+ "commit": "3e320108de6831eb996e9a3f7795152073cc0d0c",
5
+ "modsCommit": "56f36532530f88b572854538d685fcf781141e8c",
6
+ "buildDate": "2026-09-23T02:34:19Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude.zst",
10
- "checksum": "214fafd9d60bc0397cb68747b765ab752be4b53303c176ad885c4cafbe30826f",
11
- "size": 72900982,
10
+ "checksum": "056662a4e3a5ca37770730a59345d1b5796ef65444c32b97d236651ab68f3fa1",
11
+ "size": 74110572,
12
12
  "bundle": {
13
- "checksum": "5882f558c44d569dd35047588143a536711d4e415bebf94da1543a25e5bc5898",
14
- "size": 72903461
13
+ "checksum": "01c192d55a6fa8fcc84557bbd913dfb43ae65f15c39bd1fba9161fc4ff7de175",
14
+ "size": 74115578
15
15
  }
16
16
  },
17
17
  "darwin-x64": {
18
18
  "binary": "claude.zst",
19
- "checksum": "2b5ca074d02ea5dd507db0a90ba55847e297061ca3e987ddc49ea89ae0ff2e7e",
20
- "size": 77008555,
19
+ "checksum": "085dd9952999c742cf262d0fed571c3bcd749d5127eb7dd455bc5be0948c7b9d",
20
+ "size": 78229557,
21
21
  "bundle": {
22
- "checksum": "bf78bfd5af2400f39d21378198f689c3856d7a11aeb9919b012f27143e946cbf",
23
- "size": 77013965
22
+ "checksum": "05e821e3c9f1178b603c6f7fcb3e05b1a038f885cb55eed42ad8df9bbfc7fdad",
23
+ "size": 78233701
24
24
  }
25
25
  },
26
26
  "linux-arm64": {
27
27
  "binary": "claude.zst",
28
- "checksum": "6a01f30418f35122a672ccf74bed64aba5119ad47c71548a3b447cc9fec48c81",
29
- "size": 82030081
28
+ "checksum": "7583b65585561c714e18caca45e0e0fb9bdba6d7ed6ee5d5171834d5c657aea6",
29
+ "size": 83227605
30
30
  },
31
31
  "linux-x64": {
32
32
  "binary": "claude.zst",
33
- "checksum": "27910e2ae704d8f2e8024897d8fdf1e7710807baf4f6982c0e3797c058315384",
34
- "size": 82761570
33
+ "checksum": "4ffb9f6baada4d88bbd8c586773efd0605c524c7a31cc3833eeda229717a7b25",
34
+ "size": 83964259
35
35
  },
36
36
  "linux-arm64-musl": {
37
37
  "binary": "claude.zst",
38
- "checksum": "32dbe8a94da9689791688e0febfb88c39897ad67f055853e7ae1b6d11c4b4e39",
39
- "size": 80444179
38
+ "checksum": "b5400b7f787e78f6c206c1adf70c65b5b6835f2899b61edfa83a117be92111d5",
39
+ "size": 81645720
40
40
  },
41
41
  "linux-x64-musl": {
42
42
  "binary": "claude.zst",
43
- "checksum": "2b2e206987e357997bf5c06baf697379b5980a7cc6f1462ca70a6757ece58890",
44
- "size": 81193598
43
+ "checksum": "3921fd07a12e93f858c8b706eca0e4d7b12af14f4af5378d3b87254b4231def5",
44
+ "size": 82393109
45
45
  },
46
46
  "win32-x64": {
47
47
  "binary": "claude.exe.zst",
48
- "checksum": "cb50dbe5b595b52925d753b10d5907748a4137e7f0bff84d03ea60cd9a28eaf9",
49
- "size": 85069447
48
+ "checksum": "62f544612ca7e31cdc197bdf8651abcc529bd716964d2517e101177c6b94c70a",
49
+ "size": 86264937
50
50
  },
51
51
  "win32-arm64": {
52
52
  "binary": "claude.exe.zst",
53
- "checksum": "705dccf9d924d471e32efa19157283da2cdd0b8cfc71d7e0a9e3ec4d13ac381b",
54
- "size": 81530251
53
+ "checksum": "41b632497a440de03904c03483d000b4004b908a5f3eb71f139de6dbd40cd685",
54
+ "size": 82711371
55
55
  }
56
56
  },
57
57
  "sdkCompat": {
58
58
  "testedWrapperVersions": [
59
- "0.3.240",
60
59
  "0.3.241",
61
60
  "0.3.242",
62
61
  "0.3.243",
@@ -85,7 +84,8 @@
85
84
  "0.3.275",
86
85
  "0.3.276",
87
86
  "0.3.277",
88
- "0.3.278"
87
+ "0.3.278",
88
+ "0.3.280"
89
89
  ],
90
90
  "harnessSchema": 1
91
91
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.280",
3
+ "version": "0.3.281",
4
4
  "main": "sdk.mjs",
5
5
  "types": "sdk.d.ts",
6
6
  "exports": {
@@ -57,14 +57,14 @@
57
57
  "zod": "^4.0.0"
58
58
  },
59
59
  "optionalDependencies": {
60
- "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.280",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.280",
62
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.280",
63
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.280",
64
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.280",
65
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.280",
66
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.280",
67
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.280"
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.281",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.281",
62
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.281",
63
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.281",
64
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.281",
65
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.281",
66
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.281",
67
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.281"
68
68
  },
69
69
  "files": [
70
70
  "sdk.mjs",
@@ -80,5 +80,5 @@
80
80
  "manifest.json",
81
81
  "manifest.zst.json"
82
82
  ],
83
- "claudeCodeVersion": "2.1.280"
83
+ "claudeCodeVersion": "2.1.281"
84
84
  }
package/sdk-tools.d.ts CHANGED
@@ -2964,7 +2964,7 @@ export interface ProposeSkillsInput {
2964
2964
  | [
2965
2965
  {
2966
2966
  /**
2967
- * kebab-case skill slug
2967
+ * kebab-case skill slug; must not contain "claude" or "anthropic"; at most 64 characters for a new skill
2968
2968
  */
2969
2969
  name: string;
2970
2970
  kind: "new" | "improvement";
@@ -2989,7 +2989,7 @@ export interface ProposeSkillsInput {
2989
2989
  | [
2990
2990
  {
2991
2991
  /**
2992
- * kebab-case skill slug
2992
+ * kebab-case skill slug; must not contain "claude" or "anthropic"; at most 64 characters for a new skill
2993
2993
  */
2994
2994
  name: string;
2995
2995
  kind: "new" | "improvement";
@@ -3012,7 +3012,7 @@ export interface ProposeSkillsInput {
3012
3012
  },
3013
3013
  {
3014
3014
  /**
3015
- * kebab-case skill slug
3015
+ * kebab-case skill slug; must not contain "claude" or "anthropic"; at most 64 characters for a new skill
3016
3016
  */
3017
3017
  name: string;
3018
3018
  kind: "new" | "improvement";
@@ -3037,7 +3037,7 @@ export interface ProposeSkillsInput {
3037
3037
  | [
3038
3038
  {
3039
3039
  /**
3040
- * kebab-case skill slug
3040
+ * kebab-case skill slug; must not contain "claude" or "anthropic"; at most 64 characters for a new skill
3041
3041
  */
3042
3042
  name: string;
3043
3043
  kind: "new" | "improvement";
@@ -3060,7 +3060,7 @@ export interface ProposeSkillsInput {
3060
3060
  },
3061
3061
  {
3062
3062
  /**
3063
- * kebab-case skill slug
3063
+ * kebab-case skill slug; must not contain "claude" or "anthropic"; at most 64 characters for a new skill
3064
3064
  */
3065
3065
  name: string;
3066
3066
  kind: "new" | "improvement";
@@ -3083,7 +3083,7 @@ export interface ProposeSkillsInput {
3083
3083
  },
3084
3084
  {
3085
3085
  /**
3086
- * kebab-case skill slug
3086
+ * kebab-case skill slug; must not contain "claude" or "anthropic"; at most 64 characters for a new skill
3087
3087
  */
3088
3088
  name: string;
3089
3089
  kind: "new" | "improvement";
package/sdk.d.ts CHANGED
@@ -295,6 +295,9 @@ export declare type CanUseTool = (toolName: string, input: Record<string, unknow
295
295
  toolName: string;
296
296
  ruleContent?: string;
297
297
  };
298
+
299
+
300
+
298
301
  }) => Promise<PermissionResult | null>;
299
302
 
300
303
  export declare type ConfigChangeHookInput = BaseHookInput & {
@@ -321,6 +324,7 @@ declare type ControlErrorResponse = {
321
324
  * Human-readable failure description.
322
325
  */
323
326
  error: string;
327
+
324
328
  /**
325
329
  * can_use_tool requests this CLI process has issued and not yet resolved, so a client joining an already-initialized session learns about in-flight prompts. Always present (possibly empty) on a success `initialize` response from Claude Code v2.1.268 or later; earlier versions could omit it, so treat absence as an older CLI rather than as "nothing pending". A prompt inherited from a previous worker of the same session can remain answerable without appearing here and without a control_cancel_request; session_state "requires_action" on the same reply signals one the CLI is holding, but not every inherited prompt is signalled.
326
330
  */
@@ -2147,7 +2151,9 @@ export declare type Options = {
2147
2151
  * IT-controlled managed-settings tier (server / MDM / managed-settings.json)
2148
2152
  * exists on the user's machine, these are **dropped by default** — they only
2149
2153
  * layer in if that admin opts in via `parentSettingsBehavior: 'merge'` in
2150
- * their managed settings. Even when opted in, the value is filtered
2154
+ * their managed settings (a gateway-mode session that Claude Desktop's Code
2155
+ * tab launches merges them by default; `'first-wins'` in the highest-priority
2156
+ * managed source turns that off). Even when opted in, the value is filtered
2151
2157
  * restrictive-only: permissive arrays (`permissions.allow`,
2152
2158
  * `additionalDirectories`, `allowedMcpServers`, …) that would widen an
2153
2159
  * existing admin lock are silently dropped. With no admin tier present,
@@ -2992,6 +2998,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2992
2998
 
2993
2999
 
2994
3000
 
3001
+
2995
3002
  /**
2996
3003
  * Reconnect an MCP server by name.
2997
3004
  * Throws on failure.
@@ -3530,6 +3537,7 @@ export declare type SDKAssistantMessage = {
3530
3537
 
3531
3538
 
3532
3539
 
3540
+
3533
3541
  };
3534
3542
 
3535
3543
  export declare type SDKAssistantMessageError = 'authentication_failed' | 'oauth_org_not_allowed' | 'account_on_hold' | 'verification_required' | 'billing_error' | 'rate_limit' | 'overloaded' | 'invalid_request' | 'model_not_found' | 'server_error' | 'unknown' | 'max_output_tokens' | 'cloud_credential_error';
@@ -4623,6 +4631,8 @@ declare type SDKControlPermissionRequest = {
4623
4631
  */
4624
4632
  requires_user_interaction?: boolean;
4625
4633
 
4634
+
4635
+
4626
4636
  };
4627
4637
 
4628
4638
  /**
@@ -4910,13 +4920,25 @@ declare type SDKControlUpdateSettingsRequest = {
4910
4920
  };
4911
4921
 
4912
4922
  /**
4913
- * Emitted by /clear, plan-mode exit, and fresh-session flows. The surface should mount a fresh transcript under new_conversation_id and reset any cached session title. From internal QueryEvent 'conversation_reset'.
4923
+ * Emitted by /clear, plan-mode exit, fresh-session, and onboarding flows. The surface should mount a fresh transcript under new_conversation_id and reset any cached session title. From internal QueryEvent 'conversation_reset'.
4914
4924
  */
4915
4925
  export declare type SDKConversationResetMessage = {
4916
4926
  type: 'conversation_reset';
4917
4927
  new_conversation_id: UUID;
4918
4928
  uuid: UUID;
4919
4929
  session_id: string;
4930
+ /**
4931
+ * What discarded the conversation: 'clear' is the /clear command (or its /reset and /new aliases), 'plan_mode_exit' is leaving plan mode with the clear-context option, 'fresh_session' is a flow that starts a fresh session to implement an approved plan, 'onboarding' is an onboarding flow re-run inside an existing session. Informational: a consumer should reset on every conversation_reset frame whatever this says, and treat an absent (older emitter) or unrecognized value as an unspecified reset.
4932
+ */
4933
+ trigger?: 'clear' | 'plan_mode_exit' | 'fresh_session' | 'onboarding';
4934
+ /**
4935
+ * Only with trigger 'clear': the uuid of the user message whose /clear was executed (the client's own uuid for that message when it came from a Remote Control or stream-json client, otherwise the uuid the CLI assigned to the typed command). Lets a consumer match this frame to a /clear message it has already seen, wiping once whichever arrives first, instead of relying on arrival order. Absent for the other triggers, when that uuid is not a canonical UUID, and from older emitters.
4936
+ */
4937
+ user_message_uuid?: string;
4938
+ /**
4939
+ * When the reset happened, as an ISO 8601 string in UTC read from the clock of the process that performed it. Meant for display, such as the time on a "conversation cleared" row, not for ordering frames. Absent from older emitters; a consumer can fall back to the time it received the frame.
4940
+ */
4941
+ timestamp?: string;
4920
4942
  };
4921
4943
 
4922
4944
  export declare type SDKDeferredToolUse = {
@@ -5719,6 +5741,11 @@ export declare type SDKSystemMessage = {
5719
5741
  * The effort level the session will send on its next request — after env overrides, session state, org caps and model-support downgrades; the same value get_settings reports as applied.effort. null when no effort parameter will be sent (a model without effort, CLAUDE_CODE_EFFORT_LEVEL=unset, or an internal numeric budget). Present on Remote Control bridge init frames (terminal- and Desktop/VS Code-hosted sessions); absent on hosts that do not publish it and on CLIs that predate the field. Re-emitted inits carry the current value — the newest frame wins.
5720
5742
  */
5721
5743
  effort?: ('low' | 'medium' | 'high' | 'xhigh' | 'max') | null;
5744
+
5745
+ /**
5746
+ * Whether the session's transcript is in focus view ('focus': the model is told the user sees only its final message per turn, so clients may collapse each turn to the prompt and the final response; 'default' otherwise). Toggled by /focus, including over Remote Control. Present on Remote Control bridge init frames and on the per-turn init of headless stream-json runs (`claude rc` workers, -p, the SDK's subprocess transport); absent on hosts that do not publish it (the in-process engine) and on CLIs that predate the field. Re-emitted inits carry the current value — the newest frame wins.
5747
+ */
5748
+ view_mode?: 'focus' | 'default';
5722
5749
  /**
5723
5750
  * Protocol capabilities this CLI supports, so SDK consumers can feature-detect instead of version-sniffing. Open set — ignore unknown values; check each capability for exactly the behavior you use. 'interrupt_receipt_v1' = the interrupt control_response success payload carries still_queued (uuids of async user messages that survive the interrupt). 'interrupt_cancel_queued_v1' = the interrupt control_request honors cancel_queued:true (queued and pending-dispatch commands are cancelled alongside the abort, listed on the response's cancelled field; still_queued is then empty — including any uuid that was mid-fold at the interrupt instant, since this request also aborts and the fold never delivers it — except that a client driving a hosted session lists there what it can no longer recall: a send already in flight to that session, or the first prompt the session was created with). 'queued_notifications' = the CLI accepts inbound queued_notification stream messages and drains them via ReadNotifications (the cloud session backend reads this from the persisted init event to decide whether it may send them). Absent on older CLIs.
5724
5751
  */
@@ -6503,9 +6530,9 @@ export declare interface Settings {
6503
6530
  [k: string]: string;
6504
6531
  };
6505
6532
  /**
6506
- * Customize attribution text for commits and PRs. Each field defaults to the standard Claude Code attribution if not set.
6533
+ * Customize attribution text for commits and PRs. Each field defaults to the standard Claude Code attribution if not set. Set to false to hide all attribution, the same as { "commit": "", "pr": "", "sessionUrl": false }. Setting it to true is the same as leaving it out. Older Claude Code versions reject true or false here, so use the object form in settings files shared across versions.
6507
6534
  */
6508
- attribution?: {
6535
+ attribution?: boolean | {
6509
6536
  /**
6510
6537
  * Attribution text for git commits, including any trailers. Empty string hides attribution.
6511
6538
  */
@@ -8316,7 +8343,7 @@ export declare interface Settings {
8316
8343
  */
8317
8344
  gatewayInternalNetworks?: string[];
8318
8345
  /**
8319
- * 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).
8346
+ * Controls whether the SDK parent tier (Options.managedSettings / --managed-settings) layers under this admin tier. "first-wins" (the default, except in a gateway session Claude Desktop's Code tab launched, where "merge" is): 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).
8320
8347
  */
8321
8348
  parentSettingsBehavior?: 'first-wins' | 'merge';
8322
8349
  /**