@anthropic-ai/claude-agent-sdk 0.3.296 → 0.3.299

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,55 +1,52 @@
1
1
  {
2
- "version": "2.1.296",
2
+ "version": "2.1.299",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "fdb6c17a97b6e0e3cf15e3566663fca58e7c43a9",
5
- "buildDate": "2026-10-09T14:46:35Z",
4
+ "commit": "c416f56ec7eca27e49747c35af51d5c92c856ba1",
5
+ "buildDate": "2026-10-13T22:05:00Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "c9b5341637becbd423ddffc5b254afb645682a3868cb708bbc6cc0e7bb419937",
10
- "size": 240664432
9
+ "checksum": "ba5ab7b8c195fa03ab8d5bf3915c76153b576a2c40e79a5c46e265e7ed9744b3",
10
+ "size": 247931696
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "a6bf4f30be241053a923f3820ad23c5991d2f5ac2935b3a8dd64da218d9cc603",
15
- "size": 249194752
14
+ "checksum": "099dcc53dabbbefabed8926dab25b0318775c175a7c87bb6ba6c54fde9f8ece2",
15
+ "size": 257765072
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "f1f6e96e0d8342b9dbf41d7e88255397a6a52ce3d8736ad6a4c6b59c9b62fefa",
20
- "size": 256434168
19
+ "checksum": "4cd5ab006b49dc12a247fed4dbc42a925ad1aea1e711d9aa24587d285ee87c2f",
20
+ "size": 264626168
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "24972e3bc859fab2b46ed4c1e51f7d6130f06d3bd550811a114640de3370d0de",
25
- "size": 257068216
24
+ "checksum": "2d894a4b1bfaaa9aab72aeff7803e3c73bc2510f279a171f6b8f59f72d17d077",
25
+ "size": 265342136
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "b0bbc936a82930933d7d5645081050d5f827a946cf6abc6575383b777a0feec0",
30
- "size": 248788800
29
+ "checksum": "3e90af8f81cf7db932bbda3ab2ba57facb1e2a19a43f911b70536bf627472757",
30
+ "size": 256784472
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "94a1ccc6ffc9b0889c6b2b80e202885c8a575766775377398daa4db5fd89417f",
35
- "size": 250818648
34
+ "checksum": "af9b922a7a018c69eb6de3a9d401b32b6cdfba3c01bf75a5edb6b477ef17f117",
35
+ "size": 258953576
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "76de74f7694a5bdc03378a5f837c9e132827bf004c98c276bc4e9094ff06769a",
40
- "size": 260489376
39
+ "checksum": "295b49ec092f31a7de9c6ff286d9d8f120a4f029b9ad9a5ac0b12c35cbf4df2b",
40
+ "size": 269231264
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "a652a17f5a324d2d9ad9995cc047145f8176b9a4b4f28bbd3aa0708a22679e3b",
45
- "size": 248013984
44
+ "checksum": "a34fe98210ae38e55543e094036fea698db93bb4bba458c63d560b19ed2a56a2",
45
+ "size": 255381152
46
46
  }
47
47
  },
48
48
  "sdkCompat": {
49
49
  "testedWrapperVersions": [
50
- "0.3.261",
51
- "0.3.263",
52
- "0.3.265",
53
50
  "0.3.266",
54
51
  "0.3.267",
55
52
  "0.3.268",
@@ -66,6 +63,8 @@
66
63
  "0.3.280",
67
64
  "0.3.281",
68
65
  "0.3.282",
66
+ "0.3.283",
67
+ "0.3.284",
69
68
  "0.3.285"
70
69
  ],
71
70
  "harnessSchema": 1
package/manifest.zst.json CHANGED
@@ -1,63 +1,60 @@
1
1
  {
2
- "version": "2.1.296",
2
+ "version": "2.1.299",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "fdb6c17a97b6e0e3cf15e3566663fca58e7c43a9",
5
- "buildDate": "2026-10-09T14:48:00Z",
4
+ "commit": "c416f56ec7eca27e49747c35af51d5c92c856ba1",
5
+ "buildDate": "2026-10-13T22:06:14Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "26426aa3dcf41b0f554951766c3c583cf243345ca3d32fa590caf84685be5f97",
10
- "size": 80134216,
9
+ "checksum": "b510036268e62391c50f72c846319325958289283ee2dcc2b93c48f6f3c1d0ab",
10
+ "size": 83064935,
11
11
  "bundle": {
12
- "checksum": "0e4b5ce62190b45b9aa2ff5311404b227c47232f5ff09c6e1ec285d17e644402",
13
- "size": 80149558
12
+ "checksum": "4fa9694b79752a9a7e755eefa26978f0645aacfc39556267795fe45b6aa9f8fc",
13
+ "size": 83068622
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "6f1d6f926a303c423eb4815a01764165ed4375054bfa8ef6203e55fc806f50ac",
19
- "size": 84394829,
18
+ "checksum": "47d60e863db060992020f1b6add9b1342cf1808248239e920fb29a7a136cd1f6",
19
+ "size": 87828689,
20
20
  "bundle": {
21
- "checksum": "31a721b22f5e6039baf241a151d2f778c4b8d864539335385f35ec241cc3df50",
22
- "size": 84390337
21
+ "checksum": "d55abe38f7972556711bb138728a10cd4e9544cbacf0ec95f13de063debdf17b",
22
+ "size": 87803040
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "23aa91437a06eff80a65bfc32b0e4b5a6dda3e821019c543696c154274e56913",
28
- "size": 89208531
27
+ "checksum": "c9c8b11eb1d5bfad71820e6bf39254b75bd75c95f9e2921332526c60fcb32587",
28
+ "size": 92333403
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "fac1d78be9446052ac084878c04c2648abb6b22d53279a685fa19ee517d74410",
33
- "size": 89939877
32
+ "checksum": "20ca25213130255bacdcae3ed5df3fc99e1d8e86cdf46e9188b7ff9c1b478fa4",
33
+ "size": 93164406
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "a6f1ae5219e4ad60ebec2136c2ec27bb12cc674c2db66768ea46566ae28e52c8",
38
- "size": 87620237
37
+ "checksum": "8aedb90a7351fba268cc3c4aaaa585d43def1a6076fcca37a37859fabc48a8ee",
38
+ "size": 90689368
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "ca4feec52ea8d8c1aae0959bbb25d656aa2c9f9781d9225fd19e824a15479a46",
43
- "size": 88372013
42
+ "checksum": "61255662f269895254de0b696558d0132e992ab868d1ea185fe07217bfd6d985",
43
+ "size": 91585340
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "3c03de917c2ac45f9e4bf8d6670f843d2eaa9bbd57170c0ede5b2a3585ec4297",
48
- "size": 92248996
47
+ "checksum": "f0584be0fbaf0853072de7b532e6c4078f5d2c38ea70a4c711032408a78edd8a",
48
+ "size": 95700039
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "e638b6c6f831f5d51839caef7a7e8ccb68fc4b0c0ee51339a7fe2aadf5ca7528",
53
- "size": 88583594
52
+ "checksum": "e40a912906de9dff61624b5d36a66c65e32a67d1603cc8a0174d887721bf1fed",
53
+ "size": 91644699
54
54
  }
55
55
  },
56
56
  "sdkCompat": {
57
57
  "testedWrapperVersions": [
58
- "0.3.261",
59
- "0.3.263",
60
- "0.3.265",
61
58
  "0.3.266",
62
59
  "0.3.267",
63
60
  "0.3.268",
@@ -74,6 +71,8 @@
74
71
  "0.3.280",
75
72
  "0.3.281",
76
73
  "0.3.282",
74
+ "0.3.283",
75
+ "0.3.284",
77
76
  "0.3.285"
78
77
  ],
79
78
  "harnessSchema": 1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.296",
3
+ "version": "0.3.299",
4
4
  "main": "sdk.mjs",
5
5
  "types": "sdk.d.ts",
6
6
  "exports": {
@@ -61,14 +61,14 @@
61
61
  "zod": "^4.0.0"
62
62
  },
63
63
  "optionalDependencies": {
64
- "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.296",
65
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.296",
66
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.296",
67
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.296",
68
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.296",
69
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.296",
70
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.296",
71
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.296"
64
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.299",
65
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.299",
66
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.299",
67
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.299",
68
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.299",
69
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.299",
70
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.299",
71
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.299"
72
72
  },
73
73
  "files": [
74
74
  "sdk.mjs",
@@ -85,8 +85,8 @@
85
85
  "extractFromBunfs.d.ts",
86
86
  "manifest.json",
87
87
  "manifest.zst.json",
88
- "core-2haqfy07.mjs",
89
- "core-a92dt75k.mjs"
88
+ "core-x6a2shyd.mjs",
89
+ "core-xcjrj654.mjs"
90
90
  ],
91
- "claudeCodeVersion": "2.1.296"
91
+ "claudeCodeVersion": "2.1.299"
92
92
  }
package/sdk-tools.d.ts CHANGED
@@ -447,6 +447,7 @@ export type ArtifactOutput =
447
447
  publishesResetAt?: number;
448
448
  contract?: string;
449
449
  updated?: boolean;
450
+ owned?: boolean;
450
451
  icon?: string;
451
452
  faviconSent?: true;
452
453
  iconDropped?: true;
@@ -484,6 +485,7 @@ export type ArtifactOutput =
484
485
  durationMs: number;
485
486
  title?: string;
486
487
  };
488
+ owned?: boolean;
487
489
  artifactRead?: {
488
490
  slug: string;
489
491
  ver?: string;
@@ -564,6 +566,7 @@ export type ArtifactOutput =
564
566
  written?: {
565
567
  url: string;
566
568
  };
569
+ owned?: boolean;
567
570
  asset_upload: {
568
571
  id: string;
569
572
  url: string;
@@ -577,6 +580,7 @@ export type ArtifactOutput =
577
580
  written?: {
578
581
  url: string;
579
582
  };
583
+ owned?: boolean;
580
584
  asset_uploads: {
581
585
  url: string;
582
586
  /**
@@ -667,6 +671,7 @@ export type ArtifactOutput =
667
671
  written?: {
668
672
  url: string;
669
673
  };
674
+ owned?: boolean;
670
675
  asset_delete: {
671
676
  id: string;
672
677
  deleted: boolean;
@@ -4176,6 +4181,10 @@ export interface CronCreateOutput {
4176
4181
  humanSchedule: string;
4177
4182
  recurring: boolean;
4178
4183
  durable?: boolean;
4184
+ /**
4185
+ * Epoch ms of the job's next run, the scheduler's per-job offset included
4186
+ */
4187
+ nextFireAt?: number;
4179
4188
  }
4180
4189
  export interface CronDeleteOutput {
4181
4190
  id: string;
@@ -4188,6 +4197,10 @@ export interface CronListOutput {
4188
4197
  prompt: string;
4189
4198
  recurring?: boolean;
4190
4199
  durable?: boolean;
4200
+ /**
4201
+ * Epoch ms of the job's next run, the scheduler's per-job offset included
4202
+ */
4203
+ nextFireAt?: number;
4191
4204
  }[];
4192
4205
  }
4193
4206
  export interface PushNotificationOutput {
package/sdk.d.ts CHANGED
@@ -283,6 +283,7 @@ export declare type CanUseTool = (toolName: string, input: Record<string, unknow
283
283
  toolUseID: string;
284
284
  /** If running within the context of a sub-agent, the sub-agent's ID. */
285
285
  agentID?: string;
286
+
286
287
  /**
287
288
  * The control_request envelope's `request_id`. A control_response sent
288
289
  * out-of-band (e.g. a signed HTTP POST instead of the SDK's WS write)
@@ -2770,6 +2771,7 @@ export declare type PreToolUseHookSpecificOutput = {
2770
2771
  permissionDecisionReason?: string;
2771
2772
  updatedInput?: Record<string, unknown>;
2772
2773
  additionalContext?: string;
2774
+
2773
2775
  };
2774
2776
 
2775
2777
  /**
@@ -3712,6 +3714,7 @@ export declare type SDKAssistantMessage = {
3712
3714
 
3713
3715
 
3714
3716
 
3717
+
3715
3718
  };
3716
3719
 
3717
3720
  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';
@@ -3911,7 +3914,7 @@ declare type SDKControlBackgroundTasksRequest = {
3911
3914
  };
3912
3915
 
3913
3916
  /**
3914
- * Drops a pending async user message from the command queue by uuid. No-op if already dequeued for execution.
3917
+ * Drops a pending async user message from the command queue by uuid. No-op if already dequeued for execution. Also a no-op, on a worker that recognises held messages, for the queued re-run of an interrupted turn while that re-run also answers for other client messages, which cancelling it would close though nobody withdrew them; see the response.
3915
3918
  */
3916
3919
  declare type SDKControlCancelAsyncMessageRequest = {
3917
3920
  subtype: 'cancel_async_message';
@@ -3940,6 +3943,10 @@ declare type SDKControlElicitationRequest = {
3940
3943
  url?: string;
3941
3944
  elicitation_id?: string;
3942
3945
  requested_schema?: Record<string, unknown>;
3946
+ /**
3947
+ * requested_schema.properties' top-level keys in the order the MCP server listed them; absent for URL mode and when the schema has no properties object. For a host whose transport keeps no JSON object key order (a protobuf Struct, say). Names that look like array indices ("0", "1", …) come first, in JavaScript's object key order.
3948
+ */
3949
+ property_order?: string[];
3943
3950
  /**
3944
3951
  * Permission-display title from the MCP server's _meta['anthropic/permissionDisplay']. Mirrors can_use_tool.title so SDK consumers can render elicitation-driven permission prompts with structured headers instead of parsing `message`.
3945
3952
  */
@@ -4398,7 +4405,7 @@ export declare type SDKControlGetUsageResponse = {
4398
4405
  * Behavioral characteristics of local usage. Categories overlap — this is not a partition, so percentages do not sum to 100.
4399
4406
  */
4400
4407
  behaviors: {
4401
- key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron';
4408
+ key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron' | 'max_effort' | 'workflow' | 'always_on_context' | 'large_tool_results';
4402
4409
  /**
4403
4410
  * Share of the weighted local usage attributed to this behavior, 0-100.
4404
4411
  */
@@ -4453,7 +4460,7 @@ export declare type SDKControlGetUsageResponse = {
4453
4460
  * Behavioral characteristics of local usage. Categories overlap — this is not a partition, so percentages do not sum to 100.
4454
4461
  */
4455
4462
  behaviors: {
4456
- key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron';
4463
+ key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron' | 'max_effort' | 'workflow' | 'always_on_context' | 'large_tool_results';
4457
4464
  /**
4458
4465
  * Share of the weighted local usage attributed to this behavior, 0-100.
4459
4466
  */
@@ -4610,6 +4617,7 @@ export declare type SDKControlInitializeResponse = {
4610
4617
  */
4611
4618
  plugins_applied?: boolean;
4612
4619
 
4620
+
4613
4621
  /**
4614
4622
  * What became of each entry of this initialize's sdkMcpServerManifests, keyed by sdk server name, for the entries whose name is in sdkMcpServers. 'parked': kept for the connect that follows this reply, which answers the server's MCP initialize and first tools/list from it (a later failure to replay shows up as live mcp_message frames, as when no entry was sent). 'already_connected': this CLI already had a live client for the server. 'protocol_version_mismatch': initializeResult.protocolVersion is not the version this CLI's client requests. 'malformed': the entry is not of the documented shape, reported whether or not manifests were honoured (every name in sdkMcpServers gets this when the field itself is not an object); or an honoured entry is past the limits this CLI sets on a live answer. 'not_honoured': the CLI did not use the entry: manifests or remote manifests are switched off in this CLI, the session service has not told this remote-session worker in the last five minutes that only the account owning the session can send events to it, or the request reached such a worker other than over its session stream (nothing for the host to change in any of these cases); or this CLI had read as many tool lists as it allows in a minute (send it again later); or it came over the session stream without sdkMcpServerManifestsOrigin or on a frame too old to trust (the host's to fix). Absent when the request carried no sdkMcpServerManifests or named no sdkMcpServers, and on CLIs that predate the field.
4615
4623
  */
@@ -4658,13 +4666,13 @@ declare type SDKControlInterruptRequest = {
4658
4666
  */
4659
4667
  export declare type SDKControlInterruptResponse = {
4660
4668
  /**
4661
- * Uuids of async user messages that survive this interrupt: commands still in the queue, plus any batch already dequeued for the imminent turn but not yet reachable by the abort. An interrupt — plain or cancel_queued:true — that lands during the FIRST-command prewait window (before the first turn of the session has armed a controller) is additionally LATCHED, scoped to the user-intent work pending at that instant — the batch already dequeued and parked for the imminent turn, plus the user-intent main-thread commands then in the queue (the work this list enumerates): the first turn to arm that carries any of that doomed work starts already aborted, exactly once, so the listed prewait batch is delivered into an immediately-aborted turn, its frames and result flowing through the normal abort path, instead of running to completion. A turn carrying none of it arms live and leaves the latch waiting: a system delivery turn (for example a replayed host event), or a prompt enqueued after the interrupt — post-interrupt work is never coalesced with the doomed work and never dies to the latch, so the Stop kills exactly what this receipt listed. The latch is released when the doomed work is retired without arming: if a parked prewait batch is entirely cancelled, the latch is released even when other queued commands remain (those arm and run normally); with nothing parked, it is released once none of the doomed commands remains queued — work enqueued after the interrupt neither holds it up nor is aborted by it. Survivors that ride any later turn run normally. These WILL run (subject to that latch) unless cancelled first (or unless the request set cancel_queued:true, in which case every uuid-stamped survivor this process holds is removed, emitted a terminal `cancelled` synchronously, and listed under `cancelled` instead — leaving here only what a client driving a hosted session can no longer recall: a send already in flight to that session, or the first prompt the session was created with; a send that client still holds on its own machine behind a send gate (it waits there until that session is ready to take it) has not gone out, so it is withdrawn and listed under `cancelled` like a queued one, and cancel_async_message can withdraw it too, while a plain interrupt leaves it held and lists it here). Cancellation granularity: uuids still in the queue are individually cancellable via cancel_async_message; once a batch is dequeued and coalesced into one turn, cancelling a NON-representative member uuid is a no-op (its content still runs), while cancelling the batch-representative uuid drops the WHOLE coalesced batch — in both cases the cancel response reports cancelled:false because the message was no longer in the queue. Coverage caveats: only uuid-STAMPED messages appear (a message enqueued without a uuid still runs but is never listed, so [] does not mean "nothing will run"); only main-thread messages are listed (subagent-addressed messages are out of scope); and the list may include internally-enqueued uuids the client never sent (cron triggers, auto-resume continuations) — ignore unknown uuids rather than treating them as an error. Ordering: on a clean interrupt this receipt is written before the interrupted turn result; a turn that crashes during interrupt handling emits its error result on a direct-write path that may precede the receipt. Snapshot is taken synchronously with abort processing — probing the queue after the interrupted result instead always loses the race against the drain loop, which starts the next queued turn immediately.
4669
+ * Uuids of async user messages that survive this interrupt: commands still in the queue, plus any batch already dequeued for the imminent turn but not yet reachable by the abort. An interrupt — plain or cancel_queued:true — that lands during the FIRST-command prewait window (before the first turn of the session has armed a controller) is additionally LATCHED, scoped to the user-intent work pending at that instant — the batch already dequeued and parked for the imminent turn, plus the user-intent main-thread commands then in the queue (the work this list enumerates): the first turn to arm that carries any of that doomed work starts already aborted, exactly once, so the listed prewait batch is delivered into an immediately-aborted turn, its frames and result flowing through the normal abort path, instead of running to completion. A turn carrying none of it arms live and leaves the latch waiting: a system delivery turn (for example a replayed host event), or a prompt enqueued after the interrupt — post-interrupt work is never coalesced with the doomed work and never dies to the latch, so the Stop kills exactly what this receipt listed. The latch is released when the doomed work is retired without arming: if a parked prewait batch is entirely cancelled, the latch is released even when other queued commands remain (those arm and run normally); with nothing parked, it is released once none of the doomed commands remains queued — work enqueued after the interrupt neither holds it up nor is aborted by it. Survivors that ride any later turn run normally. These WILL run (subject to that latch) unless cancelled first (or unless the request set cancel_queued:true, in which case every uuid-stamped survivor this process holds is removed, emitted a terminal `cancelled` synchronously, and listed under `cancelled` instead — leaving here only what a client driving a hosted session can no longer recall: a send already in flight to that session, or the first prompt the session was created with; a send that client still holds on its own machine behind a send gate (it waits there until that session is ready to take it) has not gone out, so it is withdrawn and listed under `cancelled` like a queued one, and cancel_async_message can withdraw it too, while a plain interrupt leaves it held and lists it here). Cancellation granularity: uuids still in the queue are individually cancellable via cancel_async_message (the re-run of an interrupted turn that also answers for other client messages only if this interrupt was for it; see the response to that request); once a batch is dequeued and coalesced into one turn, cancelling a NON-representative member uuid is a no-op (its content still runs), while cancelling the batch-representative uuid drops the WHOLE coalesced batch — in both cases the cancel response reports cancelled:false because the message was no longer in the queue. Coverage caveats: only uuid-STAMPED messages appear (a message enqueued without a uuid still runs but is never listed, so [] does not mean "nothing will run"); only main-thread messages are listed (subagent-addressed messages are out of scope); and the list may include internally-enqueued uuids the client never sent (cron triggers, auto-resume continuations) — ignore unknown uuids rather than treating them as an error. Ordering: on a clean interrupt this receipt is written before the interrupted turn result; a turn that crashes during interrupt handling emits its error result on a direct-write path that may precede the receipt. Snapshot is taken synchronously with abort processing — probing the queue after the interrupted result instead always loses the race against the drain loop, which starts the next queued turn immediately.
4662
4670
  */
4663
4671
  still_queued: string[];
4664
4672
 
4665
4673
 
4666
4674
  /**
4667
- * Present only when the request set cancel_queued:true — uuids of main-thread commands cancelled by this interrupt: every survivor that would otherwise have appeared under `still_queued`, including any uuid that was mid-fold at the interrupt instant (this request also aborts, so the fold never delivers it). Each listed uuid has been removed (queue-resident) or marked cancel-pending (the first-command prewait window, closed by the drain loop's backstop) and emits a terminal 'cancelled' lifecycle synchronously at the first such interrupt (a repeat interrupt over the same parked batch re-lists the uuid idempotently without re-emitting); none will run. Same coverage caveats as `still_queued` (uuid-stamped main-thread only; internally-enqueued uuids may appear). Advertised by the `interrupt_cancel_queued_v1` capability.
4675
+ * Present only when the request set cancel_queued:true — uuids of main-thread commands cancelled by this interrupt: every survivor that would otherwise have appeared under `still_queued`, including any uuid that was mid-fold at the interrupt instant (this request also aborts, so the fold never delivers it). Each listed uuid has been removed (queue-resident) or marked cancel-pending (the first-command prewait window, closed by the drain loop's backstop) and emits a terminal 'cancelled' lifecycle synchronously at the first such interrupt (a repeat interrupt over the same parked batch re-lists the uuid idempotently without re-emitting); none will run. Where one of them is the re-run of an interrupted turn that also answered for other client messages whose re-sent copies had been set aside for it, those messages' uuids are listed behind the commands' too: they were in no queue and never under `still_queued`, each has its terminal 'cancelled' lifecycle, and a repeat interrupt does not list them again. Same coverage caveats as `still_queued` (uuid-stamped main-thread only; internally-enqueued uuids may appear). Advertised by the `interrupt_cancel_queued_v1` capability.
4668
4676
  */
4669
4677
  cancelled?: string[];
4670
4678
  };
@@ -4843,6 +4851,8 @@ declare type SDKControlPermissionRequest = {
4843
4851
  */
4844
4852
  decision_reason_type?: 'rule' | 'mode' | 'subcommandResults' | 'permissionPromptTool' | 'hook' | 'asyncAgent' | 'sandboxOverride' | 'workingDir' | 'safetyCheck' | 'classifier' | 'other';
4845
4853
 
4854
+
4855
+
4846
4856
  /**
4847
4857
  * Set when a safetyCheck is present anywhere in the decision reason (including nested inside subcommandResults for compound bash). false = at least one safety check requires manual approval (e.g. Windows path bypass, dangerous rm); true = all safety checks MAY be classifier-approved (e.g. sensitive-file paths). Absent when no safetyCheck is involved.
4848
4858
  */
@@ -4867,9 +4877,10 @@ declare type SDKControlPermissionRequest = {
4867
4877
  display_name?: string;
4868
4878
  tool_use_id: string;
4869
4879
  agent_id?: string;
4880
+
4870
4881
  description?: string;
4871
4882
  /**
4872
- * True when one-tap Approve/Deny must not be offered: the tool's approval card IS the user-interaction surface (Tool.requiresUserInteraction() — the user responds on the card itself), OR the pending ask is localDisplayOnly (its consent disclosure cannot ride this wire and only the local dialog renders it). Either way the user has to open the session to answer.
4883
+ * True when one-tap Approve/Deny must not be offered: the tool's approval card IS the user-interaction surface (Tool.requiresUserInteraction(): the user responds on the card itself), OR the pending ask is localDisplayOnly (its consent disclosure cannot ride this wire and only the local dialog renders it), OR the auto-mode classifier blocked the call and it was handed to a person (decision_reason_type 'classifier' on a person-only ask), which no stored grant or automatic approval may answer, OR the SDK host worded the ask (title and description are its consent copy, which a push cannot carry whole). In each case the user has to open the session to answer.
4873
4884
  */
4874
4885
  requires_user_interaction?: boolean;
4875
4886
 
@@ -5306,6 +5317,7 @@ export declare type SDKInformationalMessage = {
5306
5317
  * Opaque feature tag on a line a host may treat specially; absent on ordinary lines. Hosts ignore values they do not know.
5307
5318
  */
5308
5319
  tag?: string;
5320
+
5309
5321
  uuid: UUID;
5310
5322
  session_id: string;
5311
5323
  };
@@ -5418,6 +5430,10 @@ export declare type SDKMessageOrigin = {
5418
5430
  * Kernel-verified pid of the process that connected to this session's cross-session messaging socket, read from the connection (SO_PEERCRED / LOCAL_PEERPID) — never from the payload. This identifies the CONNECTING process, which for relayed traffic (e.g. a daemon forwarding on another session's behalf) is the relay, not the message's author. Key sender identity on this, never on `from`: `from` is sender-authored and kept only for reply routing, so it is forgeable by any same-user process. Absent when unverifiable (Windows, non-UDS ingress) — never a wrong value. Pids are recyclable: provenance, not an authentication token.
5419
5431
  */
5420
5432
  verifiedPeerPid?: number;
5433
+
5434
+
5435
+
5436
+
5421
5437
  } | {
5422
5438
  kind: 'task-notification';
5423
5439
  /**
@@ -5772,6 +5788,7 @@ export declare type SDKResultError = {
5772
5788
  */
5773
5789
  resume_reason?: string;
5774
5790
  terminal_reason?: TerminalReason;
5791
+
5775
5792
  /**
5776
5793
  * Delivery sequence of this result within the run: how many results the run numbered before this one, starting at 0, in the order the process writes them. A result held back while background work finishes is numbered when it is finally written, not when its text was produced; a result whose write fails still consumes its number, so a gap in a stream-json sequence means a result was lost. Distinct from num_turns, which counts model round-trips within one turn. Numbered by the process that hosts the run (`claude -p`, stream-json): a local client relaying a cloud session passes the cloud session's numbering through and its own locally built error results carry none; the in-process engine surface does not number yet. Absent from older producers.
5777
5794
  */
@@ -5804,6 +5821,16 @@ export declare type SDKResultSuccess = {
5804
5821
 
5805
5822
 
5806
5823
 
5824
+
5825
+
5826
+
5827
+
5828
+
5829
+
5830
+
5831
+
5832
+
5833
+
5807
5834
  user_message_uuid?: string;
5808
5835
  user_message_uuids?: string[];
5809
5836
  resume_reason?: string;
@@ -5835,6 +5862,7 @@ export declare type SDKResultSuccess = {
5835
5862
  api_error_status?: number | null;
5836
5863
 
5837
5864
 
5865
+
5838
5866
  num_turns: number;
5839
5867
  result: string;
5840
5868
  stop_reason: string | null;
@@ -5860,6 +5888,7 @@ export declare type SDKResultSuccess = {
5860
5888
  structured_output?: unknown;
5861
5889
  deferred_tool_use?: SDKDeferredToolUse;
5862
5890
  terminal_reason?: TerminalReason;
5891
+
5863
5892
  /**
5864
5893
  * Delivery sequence of this result within the run: how many results the run numbered before this one, starting at 0, in the order the process writes them. A result held back while background work finishes is numbered when it is finally written, not when its text was produced; a result whose write fails still consumes its number, so a gap in a stream-json sequence means a result was lost. Distinct from num_turns, which counts model round-trips within one turn. Numbered by the process that hosts the run (`claude -p`, stream-json): a local client relaying a cloud session passes the cloud session's numbering through and its own locally built error results carry none; the in-process engine surface does not number yet. Absent from older producers.
5865
5894
  */
@@ -8690,7 +8719,7 @@ export declare interface Settings {
8690
8719
  */
8691
8720
  parentSettingsBehavior?: 'first-wins' | 'merge';
8692
8721
  /**
8693
- * Controls how the managed settings sources compose. "first-wins" (default): the highest-priority source present (server-managed > MDM (managed plist / HKLM) > managed-settings.json) is the managed tier alone. "merge": every present source deep-merges with fixed precedence server-managed > MDM > managed-settings.json — scalars take the highest source's value (a restrictive boolean or enum — the allowManaged*Only locks, the disable* switches, the sandbox lock family — takes the strictest value any source sets) and arrays union, except fallbackModel, the restriction allowlists allowedMcpServers, allowedProviders, availableModels, strictKnownMarketplaces and allowedChannelPlugins, and sandbox.credentials.awsPairs and sandbox.ripgrep (the highest source that sets one owns it whole), modelOverrides (the whole map of the highest source that sets it, dropped when that source sits below the one that sets availableModels), managedMcpServers (server names union; a name set by two sources takes the higher source's whole entry), and the keys taken from the highest source only: the auth pins forceLoginOrgUUID, forceLoginMethod, forceLoginGatewayUrl and gatewayInternalNetworks, the credential helpers apiKeyHelper, awsAuthRefresh, awsCredentialExport, gcpAuthRefresh, otelHeadersHelper and proxyAuthHelper, modelPicker, permissions.defaultMode, parentSettingsBehavior and the policyHelper configuration (env keeps its own per-key union). Honored only from the highest-priority source present; enable it only when every lower source is admin-controlled, since lower sources then contribute entries such as permissions.allow. HKCU and --managed-settings never take part in the merge.
8722
+ * Controls how the managed settings sources compose. "first-wins" (default): the highest-priority source present (server-managed > MDM (managed plist / HKLM) > managed-settings.json) is the managed tier alone. "merge": every present source deep-merges with fixed precedence server-managed > MDM > managed-settings.json — scalars take the highest source's value (a restrictive boolean or enum — the allowManaged*Only locks, the disable* switches, the sandbox lock family — takes the strictest value any source sets) and arrays union, except fallbackModel, the restriction allowlists allowedMcpServers, allowedProviders, availableModels, strictKnownMarketplaces and allowedChannelPlugins, and sandbox.credentials.awsPairs and sandbox.ripgrep (the highest source that sets one owns it whole), modelOverrides (the whole map of the highest source that sets it, dropped when that source sits below the one that sets availableModels), managedMcpServers (server names union; a name set by two sources takes the higher source's whole entry), and the keys taken from the highest source only: the auth pins forceLoginOrgUUID, forceLoginMethod, forceLoginGatewayUrl and gatewayInternalNetworks, the credential helpers apiKeyHelper, awsAuthRefresh, awsCredentialExport, gcpAuthRefresh, otelHeadersHelper and proxyAuthHelper, modelPicker, permissions.defaultMode, parentSettingsBehavior and the policyHelper configuration (env keeps its own per-key union). In both modes, a forceLoginOrgUUID, or a forceLoginMethod of claudeai or console, that this machine's own MDM policy or managed settings file sets applies ahead of server-managed settings. Honored only from the highest-priority source present; enable it only when every lower source is admin-controlled, since lower sources then contribute entries such as permissions.allow. HKCU and --managed-settings never take part in the merge.
8694
8723
  */
8695
8724
  managedSourcesBehavior?: 'first-wins' | 'merge';
8696
8725
  /**
@@ -9449,6 +9478,7 @@ export declare type SlashCommand = {
9449
9478
  * True when the command is Claude Code's own; absent for a command defined by a user, project, plugin or MCP server. Rows can share a name: when a marked row carries it, /name runs that one, and an unmarked row is the one /name runs only when no marked row shares its name. The marker describes the row's name, not its aliases: a typed alias runs a command that has it as its name, when one exists, whatever this marker says.
9450
9479
  */
9451
9480
  builtin?: boolean;
9481
+
9452
9482
  };
9453
9483
 
9454
9484
  /**