@anthropic-ai/claude-agent-sdk 0.3.312 → 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,54 +1,52 @@
1
1
  {
2
- "version": "2.1.312",
2
+ "version": "2.1.315",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "f375cd85d4f70920de17ce3a4ad646e18834e833",
5
- "buildDate": "2026-10-27T17:16:03Z",
4
+ "commit": "4f69bb04c32a761bb81e3d764a864c028de92f09",
5
+ "buildDate": "2026-10-30T20:04:40Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "6b5ec691195e551b02c41df9f7d723f4ea61eaa03c2df90acefe3736f1aeb620",
10
- "size": 275988512
9
+ "checksum": "ac4a9b309f0a0728cdd0fe1b0959cef3db77d4bcf6ce8bdc5d9f626006fcf58e",
10
+ "size": 310114176
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "9534770e162cfd6e39301d9ab775affce214df032a68484085bdbab966a7f8cf",
15
- "size": 287239296
14
+ "checksum": "ae49db877bf46017355b1174816c2d1bac6cac3313980127573512cd17fd55ca",
15
+ "size": 324381312
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "dc4af28917455e009d26704b82a438353a06149e825b6cdf782908b2d28661f5",
20
- "size": 293462200
19
+ "checksum": "4b9c71d1e79644a52b49110289ef3a0782ca79eba1bbaa228c8bff1d3d159c49",
20
+ "size": 328459544
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "4f4178ce41d83e23341ebfbaecdbcf8ea6bf7baea0690025abe49eeec3a5d01d",
25
- "size": 293592432
24
+ "checksum": "a3b9d66caf61b40d6aad99ed4de80f48f17e0e024ddf1b6e4289efade06105df",
25
+ "size": 328262000
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "62555d1d87e4fff49298b70f306ef851fa167fc58b179958680f7c4d407a8c5c",
30
- "size": 285625544
29
+ "checksum": "8546880189b8be2c8c70a2de0177885145443477a364e47031ded46a65efe608",
30
+ "size": 311914480
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "78adef63924b762580b039c9ff0dd2ae44eb06171d467db62fd9040442505f76",
35
- "size": 287258072
34
+ "checksum": "f71cdba37cd88983b0359057b3daaf1999d5c8c1523f1a437e80441f6c9da459",
35
+ "size": 314779944
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "6099672ebe5dcb518b67d1d32dde1e3360bc6bee1dae7f8d28a69c49acc7c865",
40
- "size": 298690208
39
+ "checksum": "df57be6478a5bd6d5f5a0aa352729804aabff655339a3fa991b1ad8aae00b1e1",
40
+ "size": 335468192
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "2bde7020ff94a52b59fa4c0c14f81558d3c5180848b2d85069b6efcad0415a4f",
45
- "size": 282754208
44
+ "checksum": "6800b9a5ca4327875ea677abea65e8133d87f8fb69bf854584b283e0b4615597",
45
+ "size": 315963552
46
46
  }
47
47
  },
48
48
  "sdkCompat": {
49
49
  "testedWrapperVersions": [
50
- "0.3.280",
51
- "0.3.281",
52
50
  "0.3.282",
53
51
  "0.3.283",
54
52
  "0.3.284",
package/manifest.zst.json CHANGED
@@ -1,62 +1,60 @@
1
1
  {
2
- "version": "2.1.312",
2
+ "version": "2.1.315",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "f375cd85d4f70920de17ce3a4ad646e18834e833",
5
- "buildDate": "2026-10-27T17:17:45Z",
4
+ "commit": "4f69bb04c32a761bb81e3d764a864c028de92f09",
5
+ "buildDate": "2026-10-30T20:06:45Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "7d759495d011057b6e8b8ee911c5be3cd36e9491c71a4ab194a425cdb1418073",
10
- "size": 93329610,
9
+ "checksum": "d80509fcc18db7d93e50445ccae8882d3611aa90f472a196851c8dbaac93bf12",
10
+ "size": 106992076,
11
11
  "bundle": {
12
- "checksum": "1ff759dda10f393e0194f29a890c12798619bebbb471bf512ccae254eed6a186",
13
- "size": 93329934
12
+ "checksum": "2f119b4fcddc13aebcf9782abb8b2eeca7cf3c310d9243f95869ff8059d23fda",
13
+ "size": 107001904
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "14e650c4383c00c23cdb2ff9e5b277d6248031adfbbaf1208876edb692b7dd3f",
19
- "size": 98769361,
18
+ "checksum": "4cc10f22e5d29ff77c667ab9fa4cc6c4137634d72e9dd487ec8c99d61e58f471",
19
+ "size": 113959167,
20
20
  "bundle": {
21
- "checksum": "b2a050e9a9fc570ac0334cbad4dc7c46091b97a3a71bdeffdec83c91530aef84",
22
- "size": 98760451
21
+ "checksum": "2fac4dc4757d95397bc30fadb6e1847ca2c6eaa36a9c6048626ec89cd0324b9f",
22
+ "size": 113973942
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "863ee1d2a91a39ee22fa13322582e4c3fb45bfb4739b22ec7e396dde694d8581",
28
- "size": 102731812
27
+ "checksum": "88daa22cd8618a9e6fa53db3a828bb68f8fc756e9a3eff38712f4e5ea2fb5c9d",
28
+ "size": 116986474
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "6fb9e329947c003740be888f98db1aecaa238d6c7d9ceef8581eb71d5a59480b",
33
- "size": 103703105
32
+ "checksum": "b5914b03859c0e6d1fe0782a95f5a6792d016623666d2f99103cd0a27552be01",
33
+ "size": 118793022
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "5e8714a8944f6771325a8b2bd641bcdca7bcc632d60b4b965f8c716db989a6cc",
38
- "size": 101059126
37
+ "checksum": "e6ea78f7e6c0b24ea86c18bc8743d0dfbfeb83213a6d1ab32676d09448a10177",
38
+ "size": 112459790
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "122b51ddadc68c6afc8deb4d7bda82fcb5e1d49e5994c3eed750a5d6428ab6a4",
43
- "size": 102078647
42
+ "checksum": "b0da978bced3bf4afd57eb5d8c81703038f61ee969fb2278522895ec1141aac8",
43
+ "size": 113883786
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "c5e376352bf2b0e56592358ba3b2943d3de7b351f750c2340f0675fe88148038",
48
- "size": 106918151
47
+ "checksum": "315ed00f020ec4e46be506feaee7d7edb559799a39335a9188a2f4d69fa5498d",
48
+ "size": 122072467
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "dc3fd34fc9d523e6a94702e051998db52afd1d647132f61fd3daa246022ffcf9",
53
- "size": 102110572
52
+ "checksum": "2537a24587c448acb6312b500d716428b4ee9601b585eab793a4641744b51db2",
53
+ "size": 115558699
54
54
  }
55
55
  },
56
56
  "sdkCompat": {
57
57
  "testedWrapperVersions": [
58
- "0.3.280",
59
- "0.3.281",
60
58
  "0.3.282",
61
59
  "0.3.283",
62
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.312",
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.312",
65
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.312",
66
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.312",
67
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.312",
68
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.312",
69
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.312",
70
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.312",
71
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.312"
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-azmey26z.mjs",
89
- "core-jhgm58v5.mjs",
90
- "core-qw4t51gr.mjs",
91
- "core-x7q9bdvq.mjs"
88
+ "core-39qh0swp.mjs",
89
+ "core-d4nhj2hh.mjs",
90
+ "core-p0gry34p.mjs",
91
+ "core-q6qw5xwf.mjs"
92
92
  ],
93
- "claudeCodeVersion": "2.1.312"
93
+ "claudeCodeVersion": "2.1.315"
94
94
  }
package/sdk-tools.d.ts CHANGED
@@ -467,6 +467,7 @@ export type ArtifactOutput =
467
467
  rel?: "mine" | "shared";
468
468
  external?: true;
469
469
  role?: "editor" | "commenter" | "reader" | "viewer";
470
+ outsidersMayHaveWritten?: true;
470
471
  pinned?: boolean;
471
472
  }[];
472
473
  truncated?: boolean;
@@ -3322,6 +3323,10 @@ export interface BashOutput {
3322
3323
  * True when this backgrounded command is terminated at its caller's final response, so no completion notification can follow (a synchronous subagent's command, or a headless session that takes no further input and is not waiting for background commands); absent when the command survives
3323
3324
  */
3324
3325
  backgroundEndsWithFinalResponse?: true;
3326
+ /**
3327
+ * True when the subagent that owns this backgrounded command parks for its end and is woken by it
3328
+ */
3329
+ backgroundWakesOwner?: true;
3325
3330
  /**
3326
3331
  * Flag to indicate if sandbox mode was overridden
3327
3332
  */
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
  */
@@ -4824,6 +4833,7 @@ export declare type SDKControlInitializeResponse = {
4824
4833
 
4825
4834
 
4826
4835
 
4836
+
4827
4837
  };
4828
4838
 
4829
4839
  /**
@@ -5073,7 +5083,7 @@ declare type SDKControlPermissionRequest = {
5073
5083
 
5074
5084
  description?: string;
5075
5085
  /**
5076
- * 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 MCP server's name spells a claude.ai connector's key and the server came from neither claude.ai nor whoever launched the session, so a grant keyed on the tool name must not answer it, 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.
5086
+ * 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 MCP server's name spells a claude.ai connector's key and the server came from neither claude.ai nor whoever launched the session, so a grant keyed on the tool name must not answer it, OR the SDK host worded the ask (title and description are its consent copy, which a push cannot carry whole), OR the ask is the one made before the first upload by file reference to a connector, which no stored grant or automatic approval may answer. In each case the user has to open the session to answer.
5077
5087
  */
5078
5088
  requires_user_interaction?: boolean;
5079
5089
 
@@ -5637,11 +5647,11 @@ export declare type SDKMessageOrigin = {
5637
5647
  } | {
5638
5648
  kind: 'task-notification';
5639
5649
  /**
5640
- * 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.
5641
5651
  */
5642
5652
  subkind?: 'scheduled-trigger' | 'peer-send-message' | 'projects-relay' | 'session-inbox';
5643
5653
  /**
5644
- * 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.
5645
5655
  */
5646
5656
  fireReason?: string;
5647
5657
 
@@ -5976,7 +5986,7 @@ export declare type SDKResultError = {
5976
5986
  errors: string[];
5977
5987
 
5978
5988
  /**
5979
- * Set on the zeroed error_during_execution result a stream-json run writes before exiting on a known startup failure; errors carries the same text as stderr. Failures that used to end with stderr alone write that result only when the host sets CLAUDE_CODE_STARTUP_FAILURE_RESULTS. Absent on every other result, on startup failures without a known cause, and from older producers.
5989
+ * Set on the zeroed error_during_execution result a stream-json run writes before exiting on a known startup failure; errors carries the failure message. Failures that otherwise end with stderr alone write that result only when the host sets CLAUDE_CODE_STARTUP_FAILURE_RESULTS. Absent on every other result, on startup failures without a known cause, and from older producers.
5980
5990
  */
5981
5991
  startup_failure_reason?: SDKStartupFailureReason;
5982
5992
  /**
@@ -6069,6 +6079,9 @@ export declare type SDKResultSuccess = {
6069
6079
  first_text_post_queue_wait_ms?: number;
6070
6080
  first_text_post_queued_behind?: 'durable_post' | 'ephemeral_post' | 'retry_backoff' | 'hold' | 'none';
6071
6081
  first_text_post_wall_ms?: number;
6082
+
6083
+
6084
+
6072
6085
  time_to_request_from_spawn_ms?: number;
6073
6086
  warm_spare_claimed?: boolean;
6074
6087
 
@@ -6195,9 +6208,9 @@ export declare type SDKSettingsParseError = {
6195
6208
  };
6196
6209
 
6197
6210
  /**
6198
- * Why Claude Code refused to start, so a host can offer the fix instead of a retry. org_pin_api_key_conflict: managed settings pin a first-party or Cloud gateway sign-in, and an Anthropic API key or auth token is configured instead. provider_not_allowed: managed settings list the API providers this machine may use (allowedProviders), and the session is set up for one that is not listed. org_verify_failed: the sign-in's organization could not be verified against the pin (network, or a revoked token). org_pin_mismatch: the sign-in belongs to an organization the pin does not allow. managed_settings_invalid: managed policy settings could not be read, the pin names no organization, or managed model settings (deniedModels, or an availableModels list matched exactly) block the default model and leave no allowed model to use instead. remote_settings_required_unavailable: managed settings the organization requires could not be loaded. gateway_signin_required: the Cloud gateway ended this sign-in. gateway_access_denied: the Cloud gateway refused managed settings for this account. proxy_invalid: a proxy setting is not a complete URL. temp_dir_unusable: the per-user temp directory is unsafe or could not be created. cwd_unavailable: the working directory was deleted, moved or cannot be read. shell_tool_missing: Windows has no shell tool: Git Bash is missing, and PowerShell is missing or turned off by CLAUDE_CODE_USE_POWERSHELL_TOOL. session_held_by_background: the conversation to resume or continue is running as a background session. worktree_resume_refused: the resume was refused because the session's worktree failed its safety checks or the resume was launched from inside it; errors says whether a re-run continues without the worktree. worktree_unverified: the session's worktree could not be verified right now; retrying may succeed. cli_version_too_old: this Claude Code version is below the minimum Anthropic requires. bypass_root: bypass permissions mode was requested while running as root. org_config_required_unavailable: the organization requires its policy limits and managed settings before a session starts, and they could not be loaded (network, proxy, or an Anthropic error); retrying may succeed. org_config_refused: the organization requires its policy limits and managed settings, and Anthropic refused them for this sign-in (expired or revoked session, or the organization does not allow Claude Code for this account); signing in again or an admin's change is the fix, not a retry.
6211
+ * Why Claude Code refused to start, so a host can offer the fix instead of a retry. org_pin_api_key_conflict: managed settings pin a first-party or Cloud gateway sign-in, and an Anthropic API key or auth token is configured instead. provider_not_allowed: managed settings list the API providers this machine may use (allowedProviders), and the session is set up for one that is not listed. org_verify_failed: the sign-in's organization could not be verified against the pin (network, or a revoked token). org_pin_mismatch: the sign-in belongs to an organization the pin does not allow. managed_settings_invalid: managed policy settings could not be read, the pin names no organization, or managed model settings (deniedModels, or an availableModels list matched exactly) block the default model and leave no allowed model to use instead. remote_settings_required_unavailable: managed settings the organization requires could not be loaded. gateway_signin_required: the Cloud gateway ended this sign-in. gateway_access_denied: the Cloud gateway refused managed settings for this account. proxy_invalid: a proxy setting is not a complete URL. temp_dir_unusable: the per-user temp directory is unsafe or could not be created. cwd_unavailable: the working directory was deleted, moved or cannot be read. shell_tool_missing: Windows has no shell tool: Git Bash is missing, and PowerShell is missing or turned off by CLAUDE_CODE_USE_POWERSHELL_TOOL. session_held_by_background: the conversation to resume or continue is running as a background session. worktree_resume_refused: the resume was refused because the session's worktree failed its safety checks or the resume was launched from inside it; errors says whether a re-run continues without the worktree. worktree_unverified: the session's worktree could not be verified right now; retrying may succeed. cli_version_too_old: this Claude Code version is below the minimum Anthropic requires. bypass_root: bypass permissions mode was requested while running as root. org_config_required_unavailable: the organization requires its policy limits and managed settings before a session starts, and they could not be loaded (network, proxy, or an Anthropic error); retrying may succeed. org_config_refused: the organization requires its policy limits and managed settings, and Anthropic refused them for this sign-in (expired or revoked session, or the organization does not allow Claude Code for this account); signing in again or an admin's change is the fix, not a retry. sandbox_required_unavailable: a working sandbox is required and it cannot run in this session, for example because bubblewrap is missing or the platform is not supported; make the sandbox available or have the requirement changed.
6199
6212
  */
6200
- export declare type SDKStartupFailureReason = 'org_pin_api_key_conflict' | 'provider_not_allowed' | 'org_verify_failed' | 'org_pin_mismatch' | 'managed_settings_invalid' | 'remote_settings_required_unavailable' | 'gateway_signin_required' | 'gateway_access_denied' | 'proxy_invalid' | 'temp_dir_unusable' | 'cwd_unavailable' | 'shell_tool_missing' | 'session_held_by_background' | 'worktree_resume_refused' | 'worktree_unverified' | 'cli_version_too_old' | 'bypass_root' | 'org_config_required_unavailable' | 'org_config_refused';
6213
+ export declare type SDKStartupFailureReason = 'org_pin_api_key_conflict' | 'provider_not_allowed' | 'org_verify_failed' | 'org_pin_mismatch' | 'managed_settings_invalid' | 'remote_settings_required_unavailable' | 'gateway_signin_required' | 'gateway_access_denied' | 'proxy_invalid' | 'temp_dir_unusable' | 'cwd_unavailable' | 'shell_tool_missing' | 'session_held_by_background' | 'worktree_resume_refused' | 'worktree_unverified' | 'cli_version_too_old' | 'bypass_root' | 'org_config_required_unavailable' | 'org_config_refused' | 'sandbox_required_unavailable';
6201
6214
 
6202
6215
  export declare type SDKStatus = 'compacting' | 'requesting' | null;
6203
6216
 
@@ -6282,6 +6295,7 @@ export declare type SDKSystemMessage = {
6282
6295
  */
6283
6296
  effort?: ('low' | 'medium' | 'high' | 'xhigh' | 'max') | null;
6284
6297
 
6298
+
6285
6299
  /**
6286
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.
6287
6301
  */
@@ -7173,9 +7187,17 @@ export declare interface Settings {
7173
7187
  */
7174
7188
  disableBypassPermissionsMode?: 'disable';
7175
7189
  /**
7176
- * Refuse file-tool reads (Read, Grep, Glob, LSP) outside the working directories in every permission mode; true in any settings source wins. Also set when the user picks "block" on the one-time auto-mode prompt for a read outside the working directories.
7190
+ * Refuse file-tool reads (Read, Grep, Glob, LSP) outside the working directories in every permission mode; true in any settings source wins. No allow rule lifts it. Also set when the user picks "block" on the one-time auto-mode prompt for a read outside the working directories.
7177
7191
  */
7178
7192
  blockReadsOutsideWorkingDirectories?: boolean;
7193
+ /**
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.
7195
+ */
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[];
7179
7201
  /**
7180
7202
  * Disable auto mode
7181
7203
  */
@@ -7602,7 +7624,7 @@ export declare interface Settings {
7602
7624
  */
7603
7625
  defaultShell?: 'bash' | 'powershell';
7604
7626
  /**
7605
- * 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.
7606
7628
  */
7607
7629
  bashEditDiffEnabled?: boolean;
7608
7630
  /**
@@ -9055,7 +9077,7 @@ export declare interface Settings {
9055
9077
  */
9056
9078
  allowLocalBinding?: boolean;
9057
9079
  /**
9058
- * macOS only: Additional XPC/Mach service names to allow looking up. Supports trailing-wildcard prefix matching (e.g., "com.apple.CoreSimulator.*"). Needed for tools that communicate via XPC such as the iOS Simulator or Playwright. Merged across settings sources. When managed settings or a --settings file set allowUnsandboxedCommands: false, or managed settings set network.allowManagedDomainsOnly: true, values from project settings (.claude/settings.json and .claude/settings.local.json) are ignored.
9080
+ * macOS only: Additional XPC/Mach service names to allow looking up. Supports trailing-wildcard prefix matching (e.g., "com.apple.CoreSimulator.*"). Needed for tools that communicate via XPC such as the iOS Simulator or Playwright. Each entry lets sandboxed commands reach services outside the sandbox, and the sandbox does not confine what those services do for them. Merged across settings sources. When managed settings or a --settings file set allowUnsandboxedCommands: false, or managed settings set network.allowManagedDomainsOnly: true, values from project settings (.claude/settings.json and .claude/settings.local.json) are ignored.
9059
9081
  */
9060
9082
  allowMachLookup?: string[];
9061
9083
  /**
@@ -9233,7 +9255,7 @@ export declare interface Settings {
9233
9255
  */
9234
9256
  allowAppleEvents?: boolean;
9235
9257
  /**
9236
- * Command patterns (Bash permission-rule syntax) that always run outside the sandbox. A convenience, not a security boundary: excluded commands still go through the permission flow. Merged across settings sources. When managed settings or a --settings file set allowUnsandboxedCommands: false, or managed settings set network.allowManagedDomainsOnly: true, values from project settings (.claude/settings.json and .claude/settings.local.json) are ignored.
9258
+ * Command patterns (Bash permission-rule syntax) for commands to run outside the sandbox. An entry takes a call out of the sandbox only when every command in the call matches an entry: in a Bash pipe or a chain such as `a && b`, each part needs its own match. Some calls stay sandboxed whatever the entries, such as one with a `cd`, a command substitution, or a redirect other than a file-descriptor duplication like `2>&1`, a heredoc included. A convenience, not a security boundary: excluded commands still go through the permission flow. Merged across settings sources. When managed settings or a --settings file set allowUnsandboxedCommands: false, or managed settings set network.allowManagedDomainsOnly: true, values from project settings (.claude/settings.json and .claude/settings.local.json) are ignored.
9237
9259
  */
9238
9260
  excludedCommands?: string[];
9239
9261
  /**
@@ -9393,6 +9415,7 @@ export declare interface Settings {
9393
9415
  */
9394
9416
  emojiCompletionEnabled?: boolean;
9395
9417
 
9418
+
9396
9419
  /**
9397
9420
  * When true, the plan-approval dialog offers a "clear context" option. Defaults to false.
9398
9421
  */
@@ -9617,7 +9640,7 @@ export declare interface Settings {
9617
9640
  */
9618
9641
  precomputeCompactionEnabled?: boolean;
9619
9642
  /**
9620
- * Set to false to stop Claude Code from compacting a long conversation while the session is idle. Setting it to true does not turn idle compaction on.
9643
+ * Set to false to stop Claude Code from compacting a long conversation while the session is idle. Defaults to true.
9621
9644
  */
9622
9645
  idleCompaction?: boolean;
9623
9646
  /**
@@ -10326,7 +10349,7 @@ export declare type UserPromptSubmitHookInput = BaseHookInput & {
10326
10349
  hook_event_name: 'UserPromptSubmit';
10327
10350
  prompt: string;
10328
10351
  /**
10329
- * 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.
10330
10353
  */
10331
10354
  source?: 'user' | 'sdk' | 'system' | 'loop_wakeup' | 'schedule_wakeup' | 'poll_event';
10332
10355
  session_title?: string;