@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/README.md +1 -1
- package/bridge.mjs +82 -87
- package/browser-sdk.js +44 -51
- package/core-39qh0swp.mjs +18 -0
- package/core-d4nhj2hh.mjs +33 -0
- package/core-p0gry34p.mjs +43 -0
- package/core-q6qw5xwf.mjs +17 -0
- package/core.d.ts +1 -0
- package/core.mjs +12 -21
- package/manifest.json +19 -21
- package/manifest.zst.json +23 -25
- package/package.json +14 -14
- package/sdk-tools.d.ts +5 -0
- package/sdk.d.ts +35 -12
- package/sdk.mjs +77 -82
- package/core-azmey26z.mjs +0 -52
- package/core-jhgm58v5.mjs +0 -40
- package/core-qw4t51gr.mjs +0 -27
- package/core-x7q9bdvq.mjs +0 -26
package/manifest.json
CHANGED
|
@@ -1,54 +1,52 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.1.
|
|
2
|
+
"version": "2.1.315",
|
|
3
3
|
"manifestSignatureEnforcement": "flag",
|
|
4
|
-
"commit": "
|
|
5
|
-
"buildDate": "2026-10-
|
|
4
|
+
"commit": "4f69bb04c32a761bb81e3d764a864c028de92f09",
|
|
5
|
+
"buildDate": "2026-10-30T20:04:40Z",
|
|
6
6
|
"platforms": {
|
|
7
7
|
"darwin-arm64": {
|
|
8
8
|
"binary": "claude",
|
|
9
|
-
"checksum": "
|
|
10
|
-
"size":
|
|
9
|
+
"checksum": "ac4a9b309f0a0728cdd0fe1b0959cef3db77d4bcf6ce8bdc5d9f626006fcf58e",
|
|
10
|
+
"size": 310114176
|
|
11
11
|
},
|
|
12
12
|
"darwin-x64": {
|
|
13
13
|
"binary": "claude",
|
|
14
|
-
"checksum": "
|
|
15
|
-
"size":
|
|
14
|
+
"checksum": "ae49db877bf46017355b1174816c2d1bac6cac3313980127573512cd17fd55ca",
|
|
15
|
+
"size": 324381312
|
|
16
16
|
},
|
|
17
17
|
"linux-arm64": {
|
|
18
18
|
"binary": "claude",
|
|
19
|
-
"checksum": "
|
|
20
|
-
"size":
|
|
19
|
+
"checksum": "4b9c71d1e79644a52b49110289ef3a0782ca79eba1bbaa228c8bff1d3d159c49",
|
|
20
|
+
"size": 328459544
|
|
21
21
|
},
|
|
22
22
|
"linux-x64": {
|
|
23
23
|
"binary": "claude",
|
|
24
|
-
"checksum": "
|
|
25
|
-
"size":
|
|
24
|
+
"checksum": "a3b9d66caf61b40d6aad99ed4de80f48f17e0e024ddf1b6e4289efade06105df",
|
|
25
|
+
"size": 328262000
|
|
26
26
|
},
|
|
27
27
|
"linux-arm64-musl": {
|
|
28
28
|
"binary": "claude",
|
|
29
|
-
"checksum": "
|
|
30
|
-
"size":
|
|
29
|
+
"checksum": "8546880189b8be2c8c70a2de0177885145443477a364e47031ded46a65efe608",
|
|
30
|
+
"size": 311914480
|
|
31
31
|
},
|
|
32
32
|
"linux-x64-musl": {
|
|
33
33
|
"binary": "claude",
|
|
34
|
-
"checksum": "
|
|
35
|
-
"size":
|
|
34
|
+
"checksum": "f71cdba37cd88983b0359057b3daaf1999d5c8c1523f1a437e80441f6c9da459",
|
|
35
|
+
"size": 314779944
|
|
36
36
|
},
|
|
37
37
|
"win32-x64": {
|
|
38
38
|
"binary": "claude.exe",
|
|
39
|
-
"checksum": "
|
|
40
|
-
"size":
|
|
39
|
+
"checksum": "df57be6478a5bd6d5f5a0aa352729804aabff655339a3fa991b1ad8aae00b1e1",
|
|
40
|
+
"size": 335468192
|
|
41
41
|
},
|
|
42
42
|
"win32-arm64": {
|
|
43
43
|
"binary": "claude.exe",
|
|
44
|
-
"checksum": "
|
|
45
|
-
"size":
|
|
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.
|
|
2
|
+
"version": "2.1.315",
|
|
3
3
|
"manifestSignatureEnforcement": "flag",
|
|
4
|
-
"commit": "
|
|
5
|
-
"buildDate": "2026-10-
|
|
4
|
+
"commit": "4f69bb04c32a761bb81e3d764a864c028de92f09",
|
|
5
|
+
"buildDate": "2026-10-30T20:06:45Z",
|
|
6
6
|
"platforms": {
|
|
7
7
|
"darwin-arm64": {
|
|
8
8
|
"binary": "claude.zst",
|
|
9
|
-
"checksum": "
|
|
10
|
-
"size":
|
|
9
|
+
"checksum": "d80509fcc18db7d93e50445ccae8882d3611aa90f472a196851c8dbaac93bf12",
|
|
10
|
+
"size": 106992076,
|
|
11
11
|
"bundle": {
|
|
12
|
-
"checksum": "
|
|
13
|
-
"size":
|
|
12
|
+
"checksum": "2f119b4fcddc13aebcf9782abb8b2eeca7cf3c310d9243f95869ff8059d23fda",
|
|
13
|
+
"size": 107001904
|
|
14
14
|
}
|
|
15
15
|
},
|
|
16
16
|
"darwin-x64": {
|
|
17
17
|
"binary": "claude.zst",
|
|
18
|
-
"checksum": "
|
|
19
|
-
"size":
|
|
18
|
+
"checksum": "4cc10f22e5d29ff77c667ab9fa4cc6c4137634d72e9dd487ec8c99d61e58f471",
|
|
19
|
+
"size": 113959167,
|
|
20
20
|
"bundle": {
|
|
21
|
-
"checksum": "
|
|
22
|
-
"size":
|
|
21
|
+
"checksum": "2fac4dc4757d95397bc30fadb6e1847ca2c6eaa36a9c6048626ec89cd0324b9f",
|
|
22
|
+
"size": 113973942
|
|
23
23
|
}
|
|
24
24
|
},
|
|
25
25
|
"linux-arm64": {
|
|
26
26
|
"binary": "claude.zst",
|
|
27
|
-
"checksum": "
|
|
28
|
-
"size":
|
|
27
|
+
"checksum": "88daa22cd8618a9e6fa53db3a828bb68f8fc756e9a3eff38712f4e5ea2fb5c9d",
|
|
28
|
+
"size": 116986474
|
|
29
29
|
},
|
|
30
30
|
"linux-x64": {
|
|
31
31
|
"binary": "claude.zst",
|
|
32
|
-
"checksum": "
|
|
33
|
-
"size":
|
|
32
|
+
"checksum": "b5914b03859c0e6d1fe0782a95f5a6792d016623666d2f99103cd0a27552be01",
|
|
33
|
+
"size": 118793022
|
|
34
34
|
},
|
|
35
35
|
"linux-arm64-musl": {
|
|
36
36
|
"binary": "claude.zst",
|
|
37
|
-
"checksum": "
|
|
38
|
-
"size":
|
|
37
|
+
"checksum": "e6ea78f7e6c0b24ea86c18bc8743d0dfbfeb83213a6d1ab32676d09448a10177",
|
|
38
|
+
"size": 112459790
|
|
39
39
|
},
|
|
40
40
|
"linux-x64-musl": {
|
|
41
41
|
"binary": "claude.zst",
|
|
42
|
-
"checksum": "
|
|
43
|
-
"size":
|
|
42
|
+
"checksum": "b0da978bced3bf4afd57eb5d8c81703038f61ee969fb2278522895ec1141aac8",
|
|
43
|
+
"size": 113883786
|
|
44
44
|
},
|
|
45
45
|
"win32-x64": {
|
|
46
46
|
"binary": "claude.exe.zst",
|
|
47
|
-
"checksum": "
|
|
48
|
-
"size":
|
|
47
|
+
"checksum": "315ed00f020ec4e46be506feaee7d7edb559799a39335a9188a2f4d69fa5498d",
|
|
48
|
+
"size": 122072467
|
|
49
49
|
},
|
|
50
50
|
"win32-arm64": {
|
|
51
51
|
"binary": "claude.exe.zst",
|
|
52
|
-
"checksum": "
|
|
53
|
-
"size":
|
|
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.
|
|
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.
|
|
65
|
-
"@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.
|
|
66
|
-
"@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.
|
|
67
|
-
"@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.
|
|
68
|
-
"@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.
|
|
69
|
-
"@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.
|
|
70
|
-
"@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.
|
|
71
|
-
"@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.
|
|
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-
|
|
89
|
-
"core-
|
|
90
|
-
"core-
|
|
91
|
-
"core-
|
|
88
|
+
"core-39qh0swp.mjs",
|
|
89
|
+
"core-d4nhj2hh.mjs",
|
|
90
|
+
"core-p0gry34p.mjs",
|
|
91
|
+
"core-q6qw5xwf.mjs"
|
|
92
92
|
],
|
|
93
|
-
"claudeCodeVersion": "2.1.
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
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)
|
|
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.
|
|
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
|
|
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;
|