@anthropic-ai/claude-agent-sdk 0.3.314 → 0.3.315

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,53 +1,52 @@
1
1
  {
2
- "version": "2.1.314",
2
+ "version": "2.1.315",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "5c99a5b6399766569a32979c715862fdb61c7efa",
5
- "buildDate": "2026-10-29T23:00:10Z",
4
+ "commit": "4f69bb04c32a761bb81e3d764a864c028de92f09",
5
+ "buildDate": "2026-10-30T20:04:40Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "21d6e7b9a6f07b4cfcb7df13760b3b72aa25e084e13a5354413382987ba832ed",
10
- "size": 278848096
9
+ "checksum": "ac4a9b309f0a0728cdd0fe1b0959cef3db77d4bcf6ce8bdc5d9f626006fcf58e",
10
+ "size": 310114176
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "404779a308a358ecec8b25c8bccf0ce79a94cf261d12cb74065518d189c174f8",
15
- "size": 290710016
14
+ "checksum": "ae49db877bf46017355b1174816c2d1bac6cac3313980127573512cd17fd55ca",
15
+ "size": 324381312
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "a66c0a8f5d0c87a439953d797985192bbcbaefbce2e0d7b2eaa8df30ef0f3ef2",
20
- "size": 297067016
19
+ "checksum": "4b9c71d1e79644a52b49110289ef3a0782ca79eba1bbaa228c8bff1d3d159c49",
20
+ "size": 328459544
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "4487042b4c4f5d88d4568f68ae98aae0b1ffae58864cf57fb868641bc5f84594",
25
- "size": 298229464
24
+ "checksum": "a3b9d66caf61b40d6aad99ed4de80f48f17e0e024ddf1b6e4289efade06105df",
25
+ "size": 328262000
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "95b14da22c20a6b4c5b24c8ff08993ac44663a0f52dd262086482ec1a3352d38",
30
- "size": 287595856
29
+ "checksum": "8546880189b8be2c8c70a2de0177885145443477a364e47031ded46a65efe608",
30
+ "size": 311914480
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "b7a970a6e1fde58d8032723f0f4ebdc9dd9aa66150534344e5d01d32c1f5813f",
35
- "size": 289338976
34
+ "checksum": "f71cdba37cd88983b0359057b3daaf1999d5c8c1523f1a437e80441f6c9da459",
35
+ "size": 314779944
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "66e00df32e6981f686a91f67287fcc86e6e1b80ba4973a7b7c4aa43c59986cfa",
40
- "size": 301388448
39
+ "checksum": "df57be6478a5bd6d5f5a0aa352729804aabff655339a3fa991b1ad8aae00b1e1",
40
+ "size": 335468192
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "7bb0bc6be25e71e7aa3be2dfa537fd4c9c06d4565eb4446b6b748a74ea0d3a28",
45
- "size": 285591200
44
+ "checksum": "6800b9a5ca4327875ea677abea65e8133d87f8fb69bf854584b283e0b4615597",
45
+ "size": 315963552
46
46
  }
47
47
  },
48
48
  "sdkCompat": {
49
49
  "testedWrapperVersions": [
50
- "0.3.281",
51
50
  "0.3.282",
52
51
  "0.3.283",
53
52
  "0.3.284",
package/manifest.zst.json CHANGED
@@ -1,61 +1,60 @@
1
1
  {
2
- "version": "2.1.314",
2
+ "version": "2.1.315",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "5c99a5b6399766569a32979c715862fdb61c7efa",
5
- "buildDate": "2026-10-29T23:01:46Z",
4
+ "commit": "4f69bb04c32a761bb81e3d764a864c028de92f09",
5
+ "buildDate": "2026-10-30T20:06:45Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "a23ee5ca645a7e342f0960464c948baeb7c4218894ba25836da12c289ada56ca",
10
- "size": 94571356,
9
+ "checksum": "d80509fcc18db7d93e50445ccae8882d3611aa90f472a196851c8dbaac93bf12",
10
+ "size": 106992076,
11
11
  "bundle": {
12
- "checksum": "77aa04c73e1117a20a7d92ed72d911a189bd133b413f0bbc15d328d514310efe",
13
- "size": 94578963
12
+ "checksum": "2f119b4fcddc13aebcf9782abb8b2eeca7cf3c310d9243f95869ff8059d23fda",
13
+ "size": 107001904
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "1ceb09cb91340b3b4de212c97b093ce39c9b05b92592402b7a6f180e968170ab",
19
- "size": 100220791,
18
+ "checksum": "4cc10f22e5d29ff77c667ab9fa4cc6c4137634d72e9dd487ec8c99d61e58f471",
19
+ "size": 113959167,
20
20
  "bundle": {
21
- "checksum": "9ae05b0e79420e92d9358cae8487706e0c72ef26ca98113724a80c5f5f12f771",
22
- "size": 100216724
21
+ "checksum": "2fac4dc4757d95397bc30fadb6e1847ca2c6eaa36a9c6048626ec89cd0324b9f",
22
+ "size": 113973942
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "5ad42d08f44e02d56922ca82d88db6388e93564a8fc03fef02e4279b23204214",
28
- "size": 105147380
27
+ "checksum": "88daa22cd8618a9e6fa53db3a828bb68f8fc756e9a3eff38712f4e5ea2fb5c9d",
28
+ "size": 116986474
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "e8c6f963a5417a93eb19a8db70f4609c039d827426120971d2eff34e90c704b3",
33
- "size": 107353846
32
+ "checksum": "b5914b03859c0e6d1fe0782a95f5a6792d016623666d2f99103cd0a27552be01",
33
+ "size": 118793022
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "12dd7ef6e7e07bfe38f70d298931f85dfa1d763cca7389eb13b13f190bfa0ec3",
38
- "size": 102121171
37
+ "checksum": "e6ea78f7e6c0b24ea86c18bc8743d0dfbfeb83213a6d1ab32676d09448a10177",
38
+ "size": 112459790
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "14238b2f775d6ae2f85ed6e958c603984fbb23119d670bec2963c48c6c779404",
43
- "size": 103217626
42
+ "checksum": "b0da978bced3bf4afd57eb5d8c81703038f61ee969fb2278522895ec1141aac8",
43
+ "size": 113883786
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "dd9a764520cc9336dcd1580504b23de08f218a2a994dc04b39e9a38d922c81af",
48
- "size": 108263820
47
+ "checksum": "315ed00f020ec4e46be506feaee7d7edb559799a39335a9188a2f4d69fa5498d",
48
+ "size": 122072467
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "6ccba3912b025a5e7a848549785b1ef44885150faa599261bfb9217bb55bd203",
53
- "size": 103400908
52
+ "checksum": "2537a24587c448acb6312b500d716428b4ee9601b585eab793a4641744b51db2",
53
+ "size": 115558699
54
54
  }
55
55
  },
56
56
  "sdkCompat": {
57
57
  "testedWrapperVersions": [
58
- "0.3.281",
59
58
  "0.3.282",
60
59
  "0.3.283",
61
60
  "0.3.284",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.314",
3
+ "version": "0.3.315",
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.314",
65
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.314",
66
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.314",
67
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.314",
68
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.314",
69
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.314",
70
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.314",
71
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.314"
64
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.315",
65
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.315",
66
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.315",
67
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.315",
68
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.315",
69
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.315",
70
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.315",
71
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.315"
72
72
  },
73
73
  "files": [
74
74
  "sdk.mjs",
@@ -85,10 +85,10 @@
85
85
  "extractFromBunfs.d.ts",
86
86
  "manifest.json",
87
87
  "manifest.zst.json",
88
- "core-a9vq6p1m.mjs",
89
- "core-bb8r6h44.mjs",
90
- "core-kzw924e6.mjs",
91
- "core-t4mxrz5y.mjs"
88
+ "core-39qh0swp.mjs",
89
+ "core-d4nhj2hh.mjs",
90
+ "core-p0gry34p.mjs",
91
+ "core-q6qw5xwf.mjs"
92
92
  ],
93
- "claudeCodeVersion": "2.1.314"
93
+ "claudeCodeVersion": "2.1.315"
94
94
  }
package/sdk.d.ts CHANGED
@@ -420,6 +420,10 @@ declare type ControlErrorResponse = {
420
420
  * request_user_dialog requests this CLI process has issued and not yet resolved (sibling of pending_permission_requests, with the same inherited-prompt caveat), so a client joining an already-initialized session can re-arm in-flight dialogs. 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". Receivers must tolerate the same request_id also arriving as a live or replayed control_request frame and render it once.
421
421
  */
422
422
  pending_user_dialog_requests?: SDKControlRequest[];
423
+ /**
424
+ * elicitation requests that this CLI process sent and that are not yet answered or withdrawn (sibling of pending_permission_requests), each as it was sent, so a client that joins after an MCP server asked can still show the question. Present (possibly empty) on a success `initialize` response when this CLI lists them, which not every session does yet; absence says nothing about what is pending. Receivers must tolerate the same request_id also arriving as a live or replayed control_request frame and render it once.
425
+ */
426
+ pending_elicitation_requests?: SDKControlRequest[];
423
427
  };
424
428
 
425
429
  /**
@@ -443,6 +447,10 @@ declare type ControlResponse = {
443
447
  * request_user_dialog requests this CLI process has issued and not yet resolved (sibling of pending_permission_requests, with the same inherited-prompt caveat), so a client joining an already-initialized session can re-arm in-flight dialogs. 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". Receivers must tolerate the same request_id also arriving as a live or replayed control_request frame and render it once.
444
448
  */
445
449
  pending_user_dialog_requests?: SDKControlRequest[];
450
+ /**
451
+ * elicitation requests that this CLI process sent and that are not yet answered or withdrawn (sibling of pending_permission_requests), each as it was sent, so a client that joins after an MCP server asked can still show the question. Present (possibly empty) on a success `initialize` response when this CLI lists them, which not every session does yet; absence says nothing about what is pending. Receivers must tolerate the same request_id also arriving as a live or replayed control_request frame and render it once.
452
+ */
453
+ pending_elicitation_requests?: SDKControlRequest[];
446
454
  };
447
455
 
448
456
  declare namespace coreTypes {
@@ -1297,6 +1305,7 @@ export declare type McpServerStatus = {
1297
1305
 
1298
1306
 
1299
1307
 
1308
+
1300
1309
  /**
1301
1310
  * Configuration scope (e.g., project, user, local, claudeai, managed)
1302
1311
  */
@@ -5638,11 +5647,11 @@ export declare type SDKMessageOrigin = {
5638
5647
  } | {
5639
5648
  kind: 'task-notification';
5640
5649
  /**
5641
- * Present when the delivery is the fired stored prompt of a scheduled task/routine ('scheduled-trigger', stamped from server-asserted provenance, or declared by a local host for its own scheduled runs; the schedule attests storage, not authorship) or a coordinator co-member SendMessage delivery ('peer-send-message': model-authored text from another of the same user's sessions, verified by the server-stamped receiver co-membership — task-notification for prompt authority, but distinguishable so the receive-side crossSessionInbound setting can apply to it). The harness frames a scheduled-trigger delivery as the session's assigned task instead of the generic background-notification frame. Absent on webhook, PR-steward, plugin, and background-event deliveries.
5650
+ * Present when the delivery is the fired stored prompt of a scheduled task ('scheduled-trigger', stamped from server-asserted provenance, or declared by a local host for its own scheduled runs; the schedule attests storage, not authorship) or a coordinator co-member SendMessage delivery ('peer-send-message': model-authored text from another of the same user's sessions, verified by the server-stamped receiver co-membership — task-notification for prompt authority, but distinguishable so the receive-side crossSessionInbound setting can apply to it). The harness frames a scheduled-trigger delivery as the session's assigned task instead of the generic background-notification frame. Absent on webhook, PR-steward, plugin, and background-event deliveries.
5642
5651
  */
5643
5652
  subkind?: 'scheduled-trigger' | 'peer-send-message' | 'projects-relay' | 'session-inbox';
5644
5653
  /**
5645
- * On a 'scheduled-trigger' delivery, why it fired: a short lowercase token such as 'scheduled', 'manual', 'retry', 'catch_up' or 'api'. Set by the server for cloud routines, or declared by a local host for its own scheduled runs, which is honored only in a process the host started with CLAUDE_CODE_HOST_SCHEDULED_RUN=1 (a local host's value is kept only if it is 1 to 32 lowercase letters or underscores); absent when neither sent one.
5654
+ * On a 'scheduled-trigger' delivery, why it fired: a short lowercase token such as 'scheduled', 'manual', 'retry', 'catch_up' or 'api'. Set by the server for cloud scheduled tasks, or declared by a local host for its own scheduled runs, which is honored only in a process the host started with CLAUDE_CODE_HOST_SCHEDULED_RUN=1 (a local host's value is kept only if it is 1 to 32 lowercase letters or underscores); absent when neither sent one.
5646
5655
  */
5647
5656
  fireReason?: string;
5648
5657
 
@@ -6070,6 +6079,9 @@ export declare type SDKResultSuccess = {
6070
6079
  first_text_post_queue_wait_ms?: number;
6071
6080
  first_text_post_queued_behind?: 'durable_post' | 'ephemeral_post' | 'retry_backoff' | 'hold' | 'none';
6072
6081
  first_text_post_wall_ms?: number;
6082
+
6083
+
6084
+
6073
6085
  time_to_request_from_spawn_ms?: number;
6074
6086
  warm_spare_claimed?: boolean;
6075
6087
 
@@ -6283,6 +6295,7 @@ export declare type SDKSystemMessage = {
6283
6295
  */
6284
6296
  effort?: ('low' | 'medium' | 'high' | 'xhigh' | 'max') | null;
6285
6297
 
6298
+
6286
6299
  /**
6287
6300
  * 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.
6288
6301
  */
@@ -7178,9 +7191,13 @@ export declare interface Settings {
7178
7191
  */
7179
7192
  blockReadsOutsideWorkingDirectories?: boolean;
7180
7193
  /**
7181
- * Refuse file-tool writes (Write, Edit, NotebookEdit) outside the working directories in every permission mode; true in any settings source wins. No allow rule lifts it. Files that Claude Code keeps for the session are not refused: its plan files, scratchpad and background job folder, and the auto-memory of this project, unless the CLAUDE_COWORK_MEMORY_PATH_OVERRIDE environment variable or a repository settings file points it elsewhere. Nothing runs them unless the model asks. Also refuses file-tool writes to Claude Code settings files, inside the working directories too, and takes EnterWorktree and ExitWorktree, which move the working directory, out of the tools on offer. Does not limit shell commands, MCP tools, the programs that hooks run, or the memory tools. Cloud sessions (Claude Code on the web), whose file tools run in a container that is itself the boundary, may not apply it.
7194
+ * Refuse file-tool writes (Write, Edit, NotebookEdit) outside the working directories in every permission mode; true in any settings source wins. No allow rule lifts it. Files that Claude Code keeps for the session are not refused: its plan files, scratchpad and background job folder, and the auto-memory of this project, unless a repository settings file points it elsewhere. Nothing runs them unless the model asks. Also refuses file-tool writes to Claude Code settings files, inside the working directories too, and takes EnterWorktree and ExitWorktree, which move the working directory, out of the tools on offer. Does not limit shell commands, MCP tools, the programs that hooks run, or the memory tools. Cloud sessions (Claude Code on the web), whose file tools run in a container that is itself the boundary, may not apply it.
7182
7195
  */
7183
7196
  blockWritesOutsideWorkingDirectories?: boolean;
7197
+ /**
7198
+ * For the program that starts Claude Code: read only from --settings and from settings that program sends while the session runs; ignored in user, project, local and managed settings. Absolute paths, each a folder with all below it or one file, that blockReadsOutsideWorkingDirectories lets through beside the working directories. It allows nothing: an allow rule, the permission mode or the user still decides each read, as with that setting off, and a shell command that hands such a path to a program is still asked about unless a Read allow rule covers it. The paths do not become working directories, so blockWritesOutsideWorkingDirectories refuses writes to them, and they are not told to MCP servers or to the model. Each path counts as written: a link in it is not followed and a pattern is not expanded, so list every spelling that a read may arrive by. Ignored: an entry that starts with ~, has a ".." segment or has white space at either end (as written or once normalized), a relative or network path, and the root of a filesystem. Does not change what sandboxed commands may read (sandbox.filesystem.allowRead does).
7199
+ */
7200
+ blockReadsExemptPaths?: string[];
7184
7201
  /**
7185
7202
  * Disable auto mode
7186
7203
  */
@@ -7607,7 +7624,7 @@ export declare interface Settings {
7607
7624
  */
7608
7625
  defaultShell?: 'bash' | 'powershell';
7609
7626
  /**
7610
- * Whether the Bash tool shows a diff of the files a Bash command changed (PostToolUse Bash hooks get the changed-file list in tool_response). Set to false to turn that off. Default: on when the Bash tool handles file edits. Only user, flag or policy settings can turn it on outside auto and bypassPermissions modes.
7627
+ * Whether the Bash tool shows a diff of the files a Bash command changed (PostToolUse Bash hooks get the changed-file list in tool_response). Set to false to turn that off. Default: off, except in auto and bypassPermissions modes when the Bash tool handles file edits or the model's configuration turns it on. Only user, flag or policy settings can turn it on in other modes.
7611
7628
  */
7612
7629
  bashEditDiffEnabled?: boolean;
7613
7630
  /**
@@ -10332,7 +10349,7 @@ export declare type UserPromptSubmitHookInput = BaseHookInput & {
10332
10349
  hook_event_name: 'UserPromptSubmit';
10333
10350
  prompt: string;
10334
10351
  /**
10335
- * Who authored/injected the prompt: `user` = submitted from the interactive composer, `sdk` = non-interactive entrypoint (`-p` / Agent SDK), `loop_wakeup` = dynamic /loop wakeup, `schedule_wakeup` = scheduled-task fire (CronCreate/routine), `system` = other machine-injected turns (peer/channel messages, task notifications, auto-continuation), `poll_event` = the poll-event channel enqueue-time pass (the hook fires when the host submits an event, before its delivery ack exists — a blocking verdict rejects the event). Payloads may omit it while the field rolls out.
10352
+ * Who authored/injected the prompt: `user` = submitted from the interactive composer, `sdk` = non-interactive entrypoint (`-p` / Agent SDK), `loop_wakeup` = dynamic /loop wakeup, `schedule_wakeup` = scheduled-task fire (CronCreate or a cloud scheduled task), `system` = other machine-injected turns (peer/channel messages, task notifications, auto-continuation), `poll_event` = the poll-event channel enqueue-time pass (the hook fires when the host submits an event, before its delivery ack exists — a blocking verdict rejects the event). Payloads may omit it while the field rolls out.
10336
10353
  */
10337
10354
  source?: 'user' | 'sdk' | 'system' | 'loop_wakeup' | 'schedule_wakeup' | 'poll_event';
10338
10355
  session_title?: string;