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

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,56 +1,52 @@
1
1
  {
2
- "version": "2.1.296",
2
+ "version": "2.1.300",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "fdb6c17a97b6e0e3cf15e3566663fca58e7c43a9",
5
- "buildDate": "2026-10-09T14:46:35Z",
4
+ "commit": "c6733ae1276880507ca0c5b053ae18fb0df090d6",
5
+ "buildDate": "2026-10-14T13:29:53Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "c9b5341637becbd423ddffc5b254afb645682a3868cb708bbc6cc0e7bb419937",
10
- "size": 240664432
9
+ "checksum": "475517caa611e3318a2f298fa071287ec98955538df78c58f709ecc01e5ae2d3",
10
+ "size": 249556880
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "a6bf4f30be241053a923f3820ad23c5991d2f5ac2935b3a8dd64da218d9cc603",
15
- "size": 249194752
14
+ "checksum": "5824fc36863e70bbd070491bb9359e217d3f17b38c45697c085b31a3a67356b3",
15
+ "size": 259416272
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "f1f6e96e0d8342b9dbf41d7e88255397a6a52ce3d8736ad6a4c6b59c9b62fefa",
20
- "size": 256434168
19
+ "checksum": "ae2295ae2da156936bf5831ab01971ce924d0c9a0af174e28d96fffa8d5fa0a6",
20
+ "size": 266264568
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "24972e3bc859fab2b46ed4c1e51f7d6130f06d3bd550811a114640de3370d0de",
25
- "size": 257068216
24
+ "checksum": "674deba0bba9aee479f4503c438b49303b6fdd304b9a471b14977aaec5215453",
25
+ "size": 266972344
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "b0bbc936a82930933d7d5645081050d5f827a946cf6abc6575383b777a0feec0",
30
- "size": 248788800
29
+ "checksum": "267fecafb9df3dc1ef93f01ea936742455151d38b9bceebc4c12b531df827a2c",
30
+ "size": 258422872
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "94a1ccc6ffc9b0889c6b2b80e202885c8a575766775377398daa4db5fd89417f",
35
- "size": 250818648
34
+ "checksum": "426e7b0a3726d656babc943a92392eb3653377587658a240ab442d19e4eef3c9",
35
+ "size": 260587880
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "76de74f7694a5bdc03378a5f837c9e132827bf004c98c276bc4e9094ff06769a",
40
- "size": 260489376
39
+ "checksum": "56810a111c01dcd218b42727c23fd8763be42320038b1adcac93cf599fac2de2",
40
+ "size": 270863520
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "a652a17f5a324d2d9ad9995cc047145f8176b9a4b4f28bbd3aa0708a22679e3b",
45
- "size": 248013984
44
+ "checksum": "fef0df9c7f72b2d7d0c26b1702f4646113be2c45a5b40eb5bbb7c93f5cbd5f8b",
45
+ "size": 257010848
46
46
  }
47
47
  },
48
48
  "sdkCompat": {
49
49
  "testedWrapperVersions": [
50
- "0.3.261",
51
- "0.3.263",
52
- "0.3.265",
53
- "0.3.266",
54
50
  "0.3.267",
55
51
  "0.3.268",
56
52
  "0.3.269",
@@ -66,6 +62,8 @@
66
62
  "0.3.280",
67
63
  "0.3.281",
68
64
  "0.3.282",
65
+ "0.3.283",
66
+ "0.3.284",
69
67
  "0.3.285"
70
68
  ],
71
69
  "harnessSchema": 1
package/manifest.zst.json CHANGED
@@ -1,64 +1,60 @@
1
1
  {
2
- "version": "2.1.296",
2
+ "version": "2.1.300",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "fdb6c17a97b6e0e3cf15e3566663fca58e7c43a9",
5
- "buildDate": "2026-10-09T14:48:00Z",
4
+ "commit": "c6733ae1276880507ca0c5b053ae18fb0df090d6",
5
+ "buildDate": "2026-10-14T13:31:05Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "26426aa3dcf41b0f554951766c3c583cf243345ca3d32fa590caf84685be5f97",
10
- "size": 80134216,
9
+ "checksum": "5f19cc8fef7b1387f4b71691213b5aadc62d9157a78014287f3002ce8642cc23",
10
+ "size": 83582341,
11
11
  "bundle": {
12
- "checksum": "0e4b5ce62190b45b9aa2ff5311404b227c47232f5ff09c6e1ec285d17e644402",
13
- "size": 80149558
12
+ "checksum": "f53c2f9a3934eeebf8b7c86990e2c08b9ec046623941daea91d80a1f58a5d197",
13
+ "size": 83578473
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "6f1d6f926a303c423eb4815a01764165ed4375054bfa8ef6203e55fc806f50ac",
19
- "size": 84394829,
18
+ "checksum": "0bf82ce30e45f97b271db94af3a6877b72f658f570cea4dfac66741708a7737d",
19
+ "size": 88318346,
20
20
  "bundle": {
21
- "checksum": "31a721b22f5e6039baf241a151d2f778c4b8d864539335385f35ec241cc3df50",
22
- "size": 84390337
21
+ "checksum": "5e4397e2736e9b9e40de94251d9c621e4fe8bcfc460dec98312090002db750f3",
22
+ "size": 88323146
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "23aa91437a06eff80a65bfc32b0e4b5a6dda3e821019c543696c154274e56913",
28
- "size": 89208531
27
+ "checksum": "1f87b1a7838056aaf69c2b819c0b6b118ac713e0e2ba6c0a768aa531c7c5e8d0",
28
+ "size": 92840828
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "fac1d78be9446052ac084878c04c2648abb6b22d53279a685fa19ee517d74410",
33
- "size": 89939877
32
+ "checksum": "ca1608ae4e85017c5408c85a3778410add7dd796324acfd0eef3ad707268d5d6",
33
+ "size": 93676652
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "a6f1ae5219e4ad60ebec2136c2ec27bb12cc674c2db66768ea46566ae28e52c8",
38
- "size": 87620237
37
+ "checksum": "f006bb2458db1d50c5c956b47864bc708823c132345d94dd8a10e8d5e0b2ffd8",
38
+ "size": 91194411
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "ca4feec52ea8d8c1aae0959bbb25d656aa2c9f9781d9225fd19e824a15479a46",
43
- "size": 88372013
42
+ "checksum": "0f5c6b4abe1d772642f85d52a4a05c79bbe7fd83bd0a551d1d0cfabbcc30ef53",
43
+ "size": 92091262
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "3c03de917c2ac45f9e4bf8d6670f843d2eaa9bbd57170c0ede5b2a3585ec4297",
48
- "size": 92248996
47
+ "checksum": "78ed93dd777f073ef3a5961457775091d152d17c65823c40a86fc9bf55cb113a",
48
+ "size": 96203531
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "e638b6c6f831f5d51839caef7a7e8ccb68fc4b0c0ee51339a7fe2aadf5ca7528",
53
- "size": 88583594
52
+ "checksum": "ca0cb24c68d402e8b3caa7a0daa38992cec05ac1076a4ebf709983aa608bb665",
53
+ "size": 92145199
54
54
  }
55
55
  },
56
56
  "sdkCompat": {
57
57
  "testedWrapperVersions": [
58
- "0.3.261",
59
- "0.3.263",
60
- "0.3.265",
61
- "0.3.266",
62
58
  "0.3.267",
63
59
  "0.3.268",
64
60
  "0.3.269",
@@ -74,6 +70,8 @@
74
70
  "0.3.280",
75
71
  "0.3.281",
76
72
  "0.3.282",
73
+ "0.3.283",
74
+ "0.3.284",
77
75
  "0.3.285"
78
76
  ],
79
77
  "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.300",
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.300",
65
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.300",
66
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.300",
67
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.300",
68
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.300",
69
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.300",
70
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.300",
71
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.300"
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-3fs8zete.mjs",
89
+ "core-5kpyasem.mjs"
90
90
  ],
91
- "claudeCodeVersion": "2.1.296"
91
+ "claudeCodeVersion": "2.1.300"
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)
@@ -1432,6 +1433,7 @@ export declare type ModelInfo = {
1432
1433
  supportsAutoMode?: boolean;
1433
1434
 
1434
1435
 
1436
+
1435
1437
  };
1436
1438
 
1437
1439
  export declare type ModelUsage = {
@@ -2770,6 +2772,7 @@ export declare type PreToolUseHookSpecificOutput = {
2770
2772
  permissionDecisionReason?: string;
2771
2773
  updatedInput?: Record<string, unknown>;
2772
2774
  additionalContext?: string;
2775
+
2773
2776
  };
2774
2777
 
2775
2778
  /**
@@ -3712,6 +3715,7 @@ export declare type SDKAssistantMessage = {
3712
3715
 
3713
3716
 
3714
3717
 
3718
+
3715
3719
  };
3716
3720
 
3717
3721
  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 +3915,7 @@ declare type SDKControlBackgroundTasksRequest = {
3911
3915
  };
3912
3916
 
3913
3917
  /**
3914
- * Drops a pending async user message from the command queue by uuid. No-op if already dequeued for execution.
3918
+ * 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
3919
  */
3916
3920
  declare type SDKControlCancelAsyncMessageRequest = {
3917
3921
  subtype: 'cancel_async_message';
@@ -3940,6 +3944,10 @@ declare type SDKControlElicitationRequest = {
3940
3944
  url?: string;
3941
3945
  elicitation_id?: string;
3942
3946
  requested_schema?: Record<string, unknown>;
3947
+ /**
3948
+ * 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.
3949
+ */
3950
+ property_order?: string[];
3943
3951
  /**
3944
3952
  * 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
3953
  */
@@ -4398,7 +4406,7 @@ export declare type SDKControlGetUsageResponse = {
4398
4406
  * Behavioral characteristics of local usage. Categories overlap — this is not a partition, so percentages do not sum to 100.
4399
4407
  */
4400
4408
  behaviors: {
4401
- key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron';
4409
+ key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron' | 'max_effort' | 'workflow' | 'always_on_context' | 'large_tool_results';
4402
4410
  /**
4403
4411
  * Share of the weighted local usage attributed to this behavior, 0-100.
4404
4412
  */
@@ -4453,7 +4461,7 @@ export declare type SDKControlGetUsageResponse = {
4453
4461
  * Behavioral characteristics of local usage. Categories overlap — this is not a partition, so percentages do not sum to 100.
4454
4462
  */
4455
4463
  behaviors: {
4456
- key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron';
4464
+ key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron' | 'max_effort' | 'workflow' | 'always_on_context' | 'large_tool_results';
4457
4465
  /**
4458
4466
  * Share of the weighted local usage attributed to this behavior, 0-100.
4459
4467
  */
@@ -4610,6 +4618,7 @@ export declare type SDKControlInitializeResponse = {
4610
4618
  */
4611
4619
  plugins_applied?: boolean;
4612
4620
 
4621
+
4613
4622
  /**
4614
4623
  * 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
4624
  */
@@ -4658,13 +4667,13 @@ declare type SDKControlInterruptRequest = {
4658
4667
  */
4659
4668
  export declare type SDKControlInterruptResponse = {
4660
4669
  /**
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.
4670
+ * 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
4671
  */
4663
4672
  still_queued: string[];
4664
4673
 
4665
4674
 
4666
4675
  /**
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.
4676
+ * 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
4677
  */
4669
4678
  cancelled?: string[];
4670
4679
  };
@@ -4843,6 +4852,8 @@ declare type SDKControlPermissionRequest = {
4843
4852
  */
4844
4853
  decision_reason_type?: 'rule' | 'mode' | 'subcommandResults' | 'permissionPromptTool' | 'hook' | 'asyncAgent' | 'sandboxOverride' | 'workingDir' | 'safetyCheck' | 'classifier' | 'other';
4845
4854
 
4855
+
4856
+
4846
4857
  /**
4847
4858
  * 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
4859
  */
@@ -4867,9 +4878,10 @@ declare type SDKControlPermissionRequest = {
4867
4878
  display_name?: string;
4868
4879
  tool_use_id: string;
4869
4880
  agent_id?: string;
4881
+
4870
4882
  description?: string;
4871
4883
  /**
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.
4884
+ * 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
4885
  */
4874
4886
  requires_user_interaction?: boolean;
4875
4887
 
@@ -5143,6 +5155,7 @@ declare type SDKControlSetPermissionModeRequest = {
5143
5155
  */
5144
5156
  mode: coreTypes.PermissionMode;
5145
5157
 
5158
+
5146
5159
  };
5147
5160
 
5148
5161
  /**
@@ -5306,6 +5319,7 @@ export declare type SDKInformationalMessage = {
5306
5319
  * Opaque feature tag on a line a host may treat specially; absent on ordinary lines. Hosts ignore values they do not know.
5307
5320
  */
5308
5321
  tag?: string;
5322
+
5309
5323
  uuid: UUID;
5310
5324
  session_id: string;
5311
5325
  };
@@ -5418,6 +5432,11 @@ export declare type SDKMessageOrigin = {
5418
5432
  * 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
5433
  */
5420
5434
  verifiedPeerPid?: number;
5435
+
5436
+
5437
+
5438
+
5439
+
5421
5440
  } | {
5422
5441
  kind: 'task-notification';
5423
5442
  /**
@@ -5433,6 +5452,7 @@ export declare type SDKMessageOrigin = {
5433
5452
  * On a background task's own notification: the run_id its task_* events carried, as of when the notification was queued. Not part of the text the model reads.
5434
5453
  */
5435
5454
  runId?: string;
5455
+
5436
5456
  } | {
5437
5457
  kind: 'coordinator';
5438
5458
  } | {
@@ -5772,6 +5792,7 @@ export declare type SDKResultError = {
5772
5792
  */
5773
5793
  resume_reason?: string;
5774
5794
  terminal_reason?: TerminalReason;
5795
+
5775
5796
  /**
5776
5797
  * 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
5798
  */
@@ -5804,6 +5825,16 @@ export declare type SDKResultSuccess = {
5804
5825
 
5805
5826
 
5806
5827
 
5828
+
5829
+
5830
+
5831
+
5832
+
5833
+
5834
+
5835
+
5836
+
5837
+
5807
5838
  user_message_uuid?: string;
5808
5839
  user_message_uuids?: string[];
5809
5840
  resume_reason?: string;
@@ -5835,6 +5866,7 @@ export declare type SDKResultSuccess = {
5835
5866
  api_error_status?: number | null;
5836
5867
 
5837
5868
 
5869
+
5838
5870
  num_turns: number;
5839
5871
  result: string;
5840
5872
  stop_reason: string | null;
@@ -5860,6 +5892,7 @@ export declare type SDKResultSuccess = {
5860
5892
  structured_output?: unknown;
5861
5893
  deferred_tool_use?: SDKDeferredToolUse;
5862
5894
  terminal_reason?: TerminalReason;
5895
+
5863
5896
  /**
5864
5897
  * 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
5898
  */
@@ -6377,6 +6410,7 @@ export declare type SDKUserMessage = {
6377
6410
 
6378
6411
 
6379
6412
 
6413
+
6380
6414
  uuid?: UUID;
6381
6415
  /**
6382
6416
  * Content the user pasted into the prompt rather than typed: each entry a string or an array of content blocks. The CLI appends the text of each entry after the typed text, in order, and may wrap it in `<pasted_content>` tags. Blocks other than text are ignored; send images and documents in `message.content`. A list of over 1,000 entries and blocks in all is ignored.
@@ -6471,6 +6505,7 @@ export declare type SDKUserMessageReplay = {
6471
6505
 
6472
6506
 
6473
6507
 
6508
+
6474
6509
  uuid: UUID;
6475
6510
  session_id: string;
6476
6511
  isReplay: true;
@@ -8690,7 +8725,7 @@ export declare interface Settings {
8690
8725
  */
8691
8726
  parentSettingsBehavior?: 'first-wins' | 'merge';
8692
8727
  /**
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.
8728
+ * 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
8729
  */
8695
8730
  managedSourcesBehavior?: 'first-wins' | 'merge';
8696
8731
  /**
@@ -9449,6 +9484,7 @@ export declare type SlashCommand = {
9449
9484
  * 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
9485
  */
9451
9486
  builtin?: boolean;
9487
+
9452
9488
  };
9453
9489
 
9454
9490
  /**