@anthropic-ai/claude-agent-sdk 0.3.310 → 0.3.312
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 +77 -77
- package/browser-sdk.js +72 -72
- package/core-azmey26z.mjs +52 -0
- package/core-jhgm58v5.mjs +40 -0
- package/core-qw4t51gr.mjs +27 -0
- package/{core-pzfwbvz7.mjs → core-x7q9bdvq.mjs} +3 -3
- package/core.mjs +11 -11
- package/manifest.json +19 -21
- package/manifest.zst.json +23 -25
- package/package.json +15 -15
- package/sdk-tools.d.ts +6 -0
- package/sdk.d.ts +105 -25
- package/sdk.mjs +76 -76
- package/core-4pv47a2z.mjs +0 -27
- package/core-bz5kkzv0.mjs +0 -40
- package/core-c86d180z.mjs +0 -52
package/manifest.json
CHANGED
|
@@ -1,54 +1,52 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.1.
|
|
2
|
+
"version": "2.1.312",
|
|
3
3
|
"manifestSignatureEnforcement": "flag",
|
|
4
|
-
"commit": "
|
|
5
|
-
"buildDate": "2026-10-
|
|
4
|
+
"commit": "f375cd85d4f70920de17ce3a4ad646e18834e833",
|
|
5
|
+
"buildDate": "2026-10-27T17:16:03Z",
|
|
6
6
|
"platforms": {
|
|
7
7
|
"darwin-arm64": {
|
|
8
8
|
"binary": "claude",
|
|
9
|
-
"checksum": "
|
|
10
|
-
"size":
|
|
9
|
+
"checksum": "6b5ec691195e551b02c41df9f7d723f4ea61eaa03c2df90acefe3736f1aeb620",
|
|
10
|
+
"size": 275988512
|
|
11
11
|
},
|
|
12
12
|
"darwin-x64": {
|
|
13
13
|
"binary": "claude",
|
|
14
|
-
"checksum": "
|
|
15
|
-
"size":
|
|
14
|
+
"checksum": "9534770e162cfd6e39301d9ab775affce214df032a68484085bdbab966a7f8cf",
|
|
15
|
+
"size": 287239296
|
|
16
16
|
},
|
|
17
17
|
"linux-arm64": {
|
|
18
18
|
"binary": "claude",
|
|
19
|
-
"checksum": "
|
|
20
|
-
"size":
|
|
19
|
+
"checksum": "dc4af28917455e009d26704b82a438353a06149e825b6cdf782908b2d28661f5",
|
|
20
|
+
"size": 293462200
|
|
21
21
|
},
|
|
22
22
|
"linux-x64": {
|
|
23
23
|
"binary": "claude",
|
|
24
|
-
"checksum": "
|
|
25
|
-
"size":
|
|
24
|
+
"checksum": "4f4178ce41d83e23341ebfbaecdbcf8ea6bf7baea0690025abe49eeec3a5d01d",
|
|
25
|
+
"size": 293592432
|
|
26
26
|
},
|
|
27
27
|
"linux-arm64-musl": {
|
|
28
28
|
"binary": "claude",
|
|
29
|
-
"checksum": "
|
|
30
|
-
"size":
|
|
29
|
+
"checksum": "62555d1d87e4fff49298b70f306ef851fa167fc58b179958680f7c4d407a8c5c",
|
|
30
|
+
"size": 285625544
|
|
31
31
|
},
|
|
32
32
|
"linux-x64-musl": {
|
|
33
33
|
"binary": "claude",
|
|
34
|
-
"checksum": "
|
|
35
|
-
"size":
|
|
34
|
+
"checksum": "78adef63924b762580b039c9ff0dd2ae44eb06171d467db62fd9040442505f76",
|
|
35
|
+
"size": 287258072
|
|
36
36
|
},
|
|
37
37
|
"win32-x64": {
|
|
38
38
|
"binary": "claude.exe",
|
|
39
|
-
"checksum": "
|
|
40
|
-
"size":
|
|
39
|
+
"checksum": "6099672ebe5dcb518b67d1d32dde1e3360bc6bee1dae7f8d28a69c49acc7c865",
|
|
40
|
+
"size": 298690208
|
|
41
41
|
},
|
|
42
42
|
"win32-arm64": {
|
|
43
43
|
"binary": "claude.exe",
|
|
44
|
-
"checksum": "
|
|
45
|
-
"size":
|
|
44
|
+
"checksum": "2bde7020ff94a52b59fa4c0c14f81558d3c5180848b2d85069b6efcad0415a4f",
|
|
45
|
+
"size": 282754208
|
|
46
46
|
}
|
|
47
47
|
},
|
|
48
48
|
"sdkCompat": {
|
|
49
49
|
"testedWrapperVersions": [
|
|
50
|
-
"0.3.277",
|
|
51
|
-
"0.3.278",
|
|
52
50
|
"0.3.280",
|
|
53
51
|
"0.3.281",
|
|
54
52
|
"0.3.282",
|
package/manifest.zst.json
CHANGED
|
@@ -1,62 +1,60 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.1.
|
|
2
|
+
"version": "2.1.312",
|
|
3
3
|
"manifestSignatureEnforcement": "flag",
|
|
4
|
-
"commit": "
|
|
5
|
-
"buildDate": "2026-10-
|
|
4
|
+
"commit": "f375cd85d4f70920de17ce3a4ad646e18834e833",
|
|
5
|
+
"buildDate": "2026-10-27T17:17:45Z",
|
|
6
6
|
"platforms": {
|
|
7
7
|
"darwin-arm64": {
|
|
8
8
|
"binary": "claude.zst",
|
|
9
|
-
"checksum": "
|
|
10
|
-
"size":
|
|
9
|
+
"checksum": "7d759495d011057b6e8b8ee911c5be3cd36e9491c71a4ab194a425cdb1418073",
|
|
10
|
+
"size": 93329610,
|
|
11
11
|
"bundle": {
|
|
12
|
-
"checksum": "
|
|
13
|
-
"size":
|
|
12
|
+
"checksum": "1ff759dda10f393e0194f29a890c12798619bebbb471bf512ccae254eed6a186",
|
|
13
|
+
"size": 93329934
|
|
14
14
|
}
|
|
15
15
|
},
|
|
16
16
|
"darwin-x64": {
|
|
17
17
|
"binary": "claude.zst",
|
|
18
|
-
"checksum": "
|
|
19
|
-
"size":
|
|
18
|
+
"checksum": "14e650c4383c00c23cdb2ff9e5b277d6248031adfbbaf1208876edb692b7dd3f",
|
|
19
|
+
"size": 98769361,
|
|
20
20
|
"bundle": {
|
|
21
|
-
"checksum": "
|
|
22
|
-
"size":
|
|
21
|
+
"checksum": "b2a050e9a9fc570ac0334cbad4dc7c46091b97a3a71bdeffdec83c91530aef84",
|
|
22
|
+
"size": 98760451
|
|
23
23
|
}
|
|
24
24
|
},
|
|
25
25
|
"linux-arm64": {
|
|
26
26
|
"binary": "claude.zst",
|
|
27
|
-
"checksum": "
|
|
28
|
-
"size":
|
|
27
|
+
"checksum": "863ee1d2a91a39ee22fa13322582e4c3fb45bfb4739b22ec7e396dde694d8581",
|
|
28
|
+
"size": 102731812
|
|
29
29
|
},
|
|
30
30
|
"linux-x64": {
|
|
31
31
|
"binary": "claude.zst",
|
|
32
|
-
"checksum": "
|
|
33
|
-
"size":
|
|
32
|
+
"checksum": "6fb9e329947c003740be888f98db1aecaa238d6c7d9ceef8581eb71d5a59480b",
|
|
33
|
+
"size": 103703105
|
|
34
34
|
},
|
|
35
35
|
"linux-arm64-musl": {
|
|
36
36
|
"binary": "claude.zst",
|
|
37
|
-
"checksum": "
|
|
38
|
-
"size":
|
|
37
|
+
"checksum": "5e8714a8944f6771325a8b2bd641bcdca7bcc632d60b4b965f8c716db989a6cc",
|
|
38
|
+
"size": 101059126
|
|
39
39
|
},
|
|
40
40
|
"linux-x64-musl": {
|
|
41
41
|
"binary": "claude.zst",
|
|
42
|
-
"checksum": "
|
|
43
|
-
"size":
|
|
42
|
+
"checksum": "122b51ddadc68c6afc8deb4d7bda82fcb5e1d49e5994c3eed750a5d6428ab6a4",
|
|
43
|
+
"size": 102078647
|
|
44
44
|
},
|
|
45
45
|
"win32-x64": {
|
|
46
46
|
"binary": "claude.exe.zst",
|
|
47
|
-
"checksum": "
|
|
48
|
-
"size":
|
|
47
|
+
"checksum": "c5e376352bf2b0e56592358ba3b2943d3de7b351f750c2340f0675fe88148038",
|
|
48
|
+
"size": 106918151
|
|
49
49
|
},
|
|
50
50
|
"win32-arm64": {
|
|
51
51
|
"binary": "claude.exe.zst",
|
|
52
|
-
"checksum": "
|
|
53
|
-
"size":
|
|
52
|
+
"checksum": "dc3fd34fc9d523e6a94702e051998db52afd1d647132f61fd3daa246022ffcf9",
|
|
53
|
+
"size": 102110572
|
|
54
54
|
}
|
|
55
55
|
},
|
|
56
56
|
"sdkCompat": {
|
|
57
57
|
"testedWrapperVersions": [
|
|
58
|
-
"0.3.277",
|
|
59
|
-
"0.3.278",
|
|
60
58
|
"0.3.280",
|
|
61
59
|
"0.3.281",
|
|
62
60
|
"0.3.282",
|
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.312",
|
|
4
4
|
"main": "sdk.mjs",
|
|
5
5
|
"types": "sdk.d.ts",
|
|
6
6
|
"exports": {
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
}
|
|
33
33
|
},
|
|
34
34
|
"engines": {
|
|
35
|
-
"node": ">=18.
|
|
35
|
+
"node": ">=18.14.0"
|
|
36
36
|
},
|
|
37
37
|
"type": "module",
|
|
38
38
|
"author": "Anthropic <support@anthropic.com>",
|
|
@@ -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.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"
|
|
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-azmey26z.mjs",
|
|
89
|
+
"core-jhgm58v5.mjs",
|
|
90
|
+
"core-qw4t51gr.mjs",
|
|
91
|
+
"core-x7q9bdvq.mjs"
|
|
92
92
|
],
|
|
93
|
-
"claudeCodeVersion": "2.1.
|
|
93
|
+
"claudeCodeVersion": "2.1.312"
|
|
94
94
|
}
|
package/sdk-tools.d.ts
CHANGED
|
@@ -135,6 +135,7 @@ export type AgentOutput =
|
|
|
135
135
|
} | null;
|
|
136
136
|
fallback_credit?: unknown;
|
|
137
137
|
};
|
|
138
|
+
toolsUsed?: string[];
|
|
138
139
|
toolStats?: {
|
|
139
140
|
readCount: number;
|
|
140
141
|
searchCount: number;
|
|
@@ -689,6 +690,7 @@ export type ProjectsOutput =
|
|
|
689
690
|
| {
|
|
690
691
|
method: "project_info";
|
|
691
692
|
notice?: string;
|
|
693
|
+
local_file?: string;
|
|
692
694
|
name: string;
|
|
693
695
|
description: string;
|
|
694
696
|
instructions: string;
|
|
@@ -3976,6 +3978,10 @@ export interface AskUserQuestionOutput {
|
|
|
3976
3978
|
* Free-text notes the user added to their selection.
|
|
3977
3979
|
*/
|
|
3978
3980
|
notes?: string;
|
|
3981
|
+
/**
|
|
3982
|
+
* How the question went unanswered: 'skipped' (the user skipped it), 'replied_in_chat' (the user sent a chat message instead), or 'dismissed' (the user closed the card). The model does not see this field; put the text it should read in `answers`. Absent when the question was answered, and also when the answering client did not report it (in a session that does not advertise ask_user_question_unanswered_v1, from an older client, or in an older transcript): then only the text in `answers` says how it ended. Treat any other value as absent.
|
|
3983
|
+
*/
|
|
3984
|
+
unanswered?: "skipped" | "replied_in_chat" | "dismissed";
|
|
3979
3985
|
};
|
|
3980
3986
|
};
|
|
3981
3987
|
/**
|
package/sdk.d.ts
CHANGED
|
@@ -361,17 +361,23 @@ export declare type ClaimOptions = {
|
|
|
361
361
|
* permission rules, a claim that has one holds the prompt until the process
|
|
362
362
|
* has accepted the overlay (one round trip) and does not send it if the
|
|
363
363
|
* overlay is refused: `claimed` then rejects with `settings_not_applied`
|
|
364
|
-
* and the process is
|
|
365
|
-
*
|
|
364
|
+
* and the process is let go — start the session with `query()`. The overlay
|
|
365
|
+
* is written ahead of the claim, so `disabledMcpjsonServers`,
|
|
366
|
+
* `deniedMcpServers` and `enabledPlugins` decide which of the folder's
|
|
367
|
+
* `.mcp.json` servers and plugins the claim starts, and a refusal stops the
|
|
368
|
+
* claim, as does an invalid value that would leave one of those keys out of
|
|
369
|
+
* force. `model`, `agent`, `fastMode`, `permissions`, `availableModels` and
|
|
370
|
+
* `disableAutoMode` follow it: they are in force before the prompt you pass
|
|
371
|
+
* to `claim()` is read, but the folder's SessionStart hooks, and a first
|
|
372
|
+
* message such a hook hands the session, do not wait for them, and a refusal
|
|
373
|
+
* of them comes after the folder's servers have started. One limit in this version:
|
|
374
|
+
* keys that govern hooks (`hooks`, `disableAllHooks`,
|
|
366
375
|
* `allowManagedHooksOnly`, `allowedHttpHookUrls`, `httpHookAllowedEnvVars`)
|
|
367
376
|
* are refused — `claim()` throws before sending anything and the spare stays
|
|
368
|
-
* parked
|
|
369
|
-
*
|
|
370
|
-
*
|
|
371
|
-
*
|
|
372
|
-
* `claim()` is read; the claimed folder's own SessionStart hooks, and a
|
|
373
|
-
* first message such a hook hands the session, start with the claim and do
|
|
374
|
-
* not wait for the overlay.
|
|
377
|
+
* parked; give those to `prewarm()` in `Options.settings`, where they are in
|
|
378
|
+
* force before any hook as on a cold start. Servers from the user's or
|
|
379
|
+
* managed configuration, and those running in the parked spare, are
|
|
380
|
+
* `prewarm()`'s to govern.
|
|
375
381
|
*/
|
|
376
382
|
settings?: Parameters<Query['applyFlagSettings']>[0];
|
|
377
383
|
appendSystemPrompt?: string;
|
|
@@ -1475,6 +1481,14 @@ export declare type ModelUsage = {
|
|
|
1475
1481
|
thinkingTokens?: number;
|
|
1476
1482
|
cacheReadInputTokens: number;
|
|
1477
1483
|
cacheCreationInputTokens: number;
|
|
1484
|
+
/**
|
|
1485
|
+
* Cache writes with a 5-minute lifetime, already counted inside cacheCreationInputTokens. This and cacheCreationEphemeral1hInputTokens can add up to less than cacheCreationInputTokens, because a response that does not report how long its cache writes live adds to neither. costUSD prices those writes at the 5-minute rate. Counts only turns run on CLI versions that record this field: absent when none did, and an undercount when part of the session ran on an older version.
|
|
1486
|
+
*/
|
|
1487
|
+
cacheCreationEphemeral5mInputTokens?: number;
|
|
1488
|
+
/**
|
|
1489
|
+
* Cache writes with a 1-hour lifetime, already counted inside cacheCreationInputTokens. costUSD prices them at the 1-hour rate when the model's price table has one. The built-in list prices do. A managed-settings modelPricing row does not: its one cache-write rate applies to both lifetimes. costUSD never uses the 1-hour rate for a response that a fallback model served after a refusal. Absent or an undercount in the same cases as cacheCreationEphemeral5mInputTokens.
|
|
1490
|
+
*/
|
|
1491
|
+
cacheCreationEphemeral1hInputTokens?: number;
|
|
1478
1492
|
webSearchRequests: number;
|
|
1479
1493
|
costUSD: number;
|
|
1480
1494
|
contextWindow: number;
|
|
@@ -2837,9 +2851,9 @@ export declare type PreToolUseHookSpecificOutput = {
|
|
|
2837
2851
|
*
|
|
2838
2852
|
* What a claim can set ({@link ClaimOptions}): `cwd`, `additionalDirectories`,
|
|
2839
2853
|
* `model`, `permissionMode`, `maxThinkingTokens`, a flag-settings overlay
|
|
2840
|
-
* (`settings`, e.g. effort
|
|
2841
|
-
*
|
|
2842
|
-
*
|
|
2854
|
+
* (`settings`, e.g. effort, permission rules or which of the folder's MCP
|
|
2855
|
+
* servers may start — but not hook settings; those go in `Options.settings`
|
|
2856
|
+
* here), `appendSystemPrompt`, `title`, `agents`, and
|
|
2843
2857
|
* three environment variables (`CLAUDE_CODE_OAUTH_TOKEN`,
|
|
2844
2858
|
* `CLAUDE_CODE_SESSION_ACCESS_TOKEN`, `CLAUDE_CODE_HOST_SESSION_ID`). Everything
|
|
2845
2859
|
* else — the executable, `settingSources`, `env` the process reads at
|
|
@@ -5066,6 +5080,7 @@ declare type SDKControlPermissionRequest = {
|
|
|
5066
5080
|
|
|
5067
5081
|
|
|
5068
5082
|
|
|
5083
|
+
|
|
5069
5084
|
};
|
|
5070
5085
|
|
|
5071
5086
|
/**
|
|
@@ -5816,7 +5831,7 @@ export declare type SDKPermissionRuleEntry = {
|
|
|
5816
5831
|
/**
|
|
5817
5832
|
* Where the rule comes from. Mirrors PermissionRuleSource (permissionRuleLookup.ts PERMISSION_RULE_SOURCES); the parity test in test/cli/headlessControl/listPermissionRules.test.ts keeps the two aligned.
|
|
5818
5833
|
*/
|
|
5819
|
-
source: 'userSettings' | 'projectSettings' | 'localSettings' | 'flagSettings' | 'policySettings' | 'cliArg' | 'command' | 'session' | 'toolsNarrowing' | 'mcpServerPolicy' | 'hostCredential';
|
|
5834
|
+
source: 'userSettings' | 'projectSettings' | 'localSettings' | 'flagSettings' | 'policySettings' | 'cliArg' | 'command' | 'session' | 'mcpMount' | 'toolsNarrowing' | 'mcpServerPolicy' | 'hostCredential';
|
|
5820
5835
|
/**
|
|
5821
5836
|
* The stored rule string VERBATIM, exactly as the session holds it. Two stored spellings that parse identically each get their own entry. Can carry invisible or control characters by design — escape at display.
|
|
5822
5837
|
*/
|
|
@@ -5976,6 +5991,9 @@ export declare type SDKResultError = {
|
|
|
5976
5991
|
* Why this turn continued one that a worker restart interrupted. Such a turn is the automatic re-run of the interrupted turn (CLAUDE_CODE_RESUME_INTERRUPTED_TURN), or one that goes on from the answer to the permission prompt the new worker took over, or from that turn's tool calls still in flight. The value is the host's CLAUDE_CODE_RESUME_REASON when it set one (host_draining, checkpoint_restore, container_recreated, …), else 'interrupted_turn'. Present on such a headless turn's result, success or error, with or without an echo (a turn whose opening user prompt could not be vouched for still carries the reason); absent on every other turn (also one that goes on from the answer to any other permission prompt), on the Remote Control bridge's per-turn synthetic results, and from older producers.
|
|
5977
5992
|
*/
|
|
5978
5993
|
resume_reason?: string;
|
|
5994
|
+
|
|
5995
|
+
|
|
5996
|
+
|
|
5979
5997
|
terminal_reason?: TerminalReason;
|
|
5980
5998
|
|
|
5981
5999
|
/**
|
|
@@ -6014,6 +6032,14 @@ export declare type SDKResultSuccess = {
|
|
|
6014
6032
|
|
|
6015
6033
|
|
|
6016
6034
|
|
|
6035
|
+
|
|
6036
|
+
|
|
6037
|
+
|
|
6038
|
+
|
|
6039
|
+
|
|
6040
|
+
|
|
6041
|
+
|
|
6042
|
+
|
|
6017
6043
|
|
|
6018
6044
|
|
|
6019
6045
|
|
|
@@ -6047,6 +6073,9 @@ export declare type SDKResultSuccess = {
|
|
|
6047
6073
|
warm_spare_claimed?: boolean;
|
|
6048
6074
|
|
|
6049
6075
|
time_origin_ms?: number;
|
|
6076
|
+
|
|
6077
|
+
|
|
6078
|
+
|
|
6050
6079
|
is_error: boolean;
|
|
6051
6080
|
api_error_status?: number | null;
|
|
6052
6081
|
|
|
@@ -6249,7 +6278,7 @@ export declare type SDKSystemMessage = {
|
|
|
6249
6278
|
fast_mode_disabled_reason?: FastModeDisabledReason;
|
|
6250
6279
|
|
|
6251
6280
|
/**
|
|
6252
|
-
* The effort level the session
|
|
6281
|
+
* The effort level set for the session's next message — after env overrides, session state, org caps and model-support downgrades; the same value get_settings reports as applied.effort. null when no effort parameter will be sent (a model without effort, CLAUDE_CODE_EFFORT_LEVEL=unset, or an internal numeric budget). Present on Remote Control bridge init frames (terminal- and Desktop/VS Code-hosted sessions); absent on hosts that do not publish it and on CLIs that predate the field. Re-emitted inits carry the current value — the newest frame wins.
|
|
6253
6282
|
*/
|
|
6254
6283
|
effort?: ('low' | 'medium' | 'high' | 'xhigh' | 'max') | null;
|
|
6255
6284
|
|
|
@@ -6258,7 +6287,7 @@ export declare type SDKSystemMessage = {
|
|
|
6258
6287
|
*/
|
|
6259
6288
|
view_mode?: 'focus' | 'default';
|
|
6260
6289
|
/**
|
|
6261
|
-
* Protocol capabilities this CLI supports, so SDK consumers can feature-detect instead of version-sniffing. Open set — ignore unknown values; check each capability for exactly the behavior you use. 'interrupt_receipt_v1' = the interrupt control_response success payload carries still_queued (uuids of async user messages that survive the interrupt). 'interrupt_cancel_queued_v1' = the interrupt control_request honors cancel_queued:true (queued and pending-dispatch commands are cancelled alongside the abort, listed on the response's cancelled field; still_queued is then empty — including any uuid that was mid-fold at the interrupt instant, since this request also aborts and the fold never delivers it — except that a client driving a hosted session lists there what it can no longer recall: a send already in flight to that session, or the first prompt the session was created with). 'queued_notifications' = the CLI accepts inbound queued_notification stream messages and drains them via ReadNotifications (the cloud session backend reads this from the persisted init event to decide whether it may send them). Absent on older CLIs.
|
|
6290
|
+
* Protocol capabilities this CLI supports, so SDK consumers can feature-detect instead of version-sniffing. Open set — ignore unknown values; check each capability for exactly the behavior you use. 'interrupt_receipt_v1' = the interrupt control_response success payload carries still_queued (uuids of async user messages that survive the interrupt). 'interrupt_cancel_queued_v1' = the interrupt control_request honors cancel_queued:true (queued and pending-dispatch commands are cancelled alongside the abort, listed on the response's cancelled field; still_queued is then empty — including any uuid that was mid-fold at the interrupt instant, since this request also aborts and the fold never delivers it — except that a client driving a hosted session lists there what it can no longer recall: a send already in flight to that session, or the first prompt the session was created with). 'queued_notifications' = the CLI accepts inbound queued_notification stream messages and drains them via ReadNotifications (the cloud session backend reads this from the persisted init event to decide whether it may send them). 'ask_user_question_unanswered_v1' = an AskUserQuestion answer may set annotations[question].unanswered ('skipped' | 'replied_in_chat' | 'dismissed'), which the tool result echoes; send it only to a session that advertises this, since an older CLI on a strict host refuses the whole answer. A strict host also refuses an answer with a value outside these three; a new value will come with a new capability. Absent on older CLIs.
|
|
6262
6291
|
*/
|
|
6263
6292
|
capabilities?: string[];
|
|
6264
6293
|
|
|
@@ -7147,6 +7176,10 @@ export declare interface Settings {
|
|
|
7147
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.
|
|
7148
7177
|
*/
|
|
7149
7178
|
blockReadsOutsideWorkingDirectories?: boolean;
|
|
7179
|
+
/**
|
|
7180
|
+
* Disable auto mode
|
|
7181
|
+
*/
|
|
7182
|
+
disableAutoMode?: 'disable';
|
|
7150
7183
|
/**
|
|
7151
7184
|
* Additional directories to include in the permission scope
|
|
7152
7185
|
*/
|
|
@@ -7937,6 +7970,12 @@ export declare interface Settings {
|
|
|
7937
7970
|
* Whether to automatically update this marketplace and its installed plugins on startup
|
|
7938
7971
|
*/
|
|
7939
7972
|
autoUpdate?: boolean;
|
|
7973
|
+
/**
|
|
7974
|
+
* Managed settings only: the plugins of this marketplace that an organization delivers with its own tier, by plugin name, each with the digests of its releases. A plugin also enabled and listed in prependPlugins or appendPlugins by managed settings the session vouches for loads its hooks module only from a folder that proves one of them, and is then seated in that tier; any other copy does not load. A digest is sha256- and the base64 SHA-256 of, for every regular file in the folder in UTF-16 code unit order of its path, not normalized, "f PATH" NUL BYTE-LENGTH NUL BYTES, with / in paths; .git, .in_use, .orphaned_at, .claude-plugin-link and .links_materialized at the root are left out. The plugin keeps its manifest at .claude-plugin/plugin.json and names one module in hooks/hooks.json. A string of any other form, or a list that is empty or of any other shape, matches no folder. A symbolic link, or a surface module, proves nothing. A proved plugin ships bundled with no install step: the digest covers the whole folder, node_modules included. A checkout whose line endings were converted proves nothing.
|
|
7975
|
+
*/
|
|
7976
|
+
pluginDigests?: {
|
|
7977
|
+
[k: string]: string[];
|
|
7978
|
+
};
|
|
7940
7979
|
};
|
|
7941
7980
|
};
|
|
7942
7981
|
/**
|
|
@@ -8189,6 +8228,12 @@ export declare interface Settings {
|
|
|
8189
8228
|
* Whether to automatically update this marketplace and its installed plugins on startup
|
|
8190
8229
|
*/
|
|
8191
8230
|
autoUpdate?: boolean;
|
|
8231
|
+
/**
|
|
8232
|
+
* Managed settings only: the plugins of this marketplace that an organization delivers with its own tier, by plugin name, each with the digests of its releases. A plugin also enabled and listed in prependPlugins or appendPlugins by managed settings the session vouches for loads its hooks module only from a folder that proves one of them, and is then seated in that tier; any other copy does not load. A digest is sha256- and the base64 SHA-256 of, for every regular file in the folder in UTF-16 code unit order of its path, not normalized, "f PATH" NUL BYTE-LENGTH NUL BYTES, with / in paths; .git, .in_use, .orphaned_at, .claude-plugin-link and .links_materialized at the root are left out. The plugin keeps its manifest at .claude-plugin/plugin.json and names one module in hooks/hooks.json. A string of any other form, or a list that is empty or of any other shape, matches no folder. A symbolic link, or a surface module, proves nothing. A proved plugin ships bundled with no install step: the digest covers the whole folder, node_modules included. A checkout whose line endings were converted proves nothing.
|
|
8233
|
+
*/
|
|
8234
|
+
pluginDigests?: {
|
|
8235
|
+
[k: string]: string[];
|
|
8236
|
+
};
|
|
8192
8237
|
};
|
|
8193
8238
|
};
|
|
8194
8239
|
/**
|
|
@@ -9010,7 +9055,7 @@ export declare interface Settings {
|
|
|
9010
9055
|
*/
|
|
9011
9056
|
allowLocalBinding?: boolean;
|
|
9012
9057
|
/**
|
|
9013
|
-
* macOS only: Additional XPC/Mach service names to allow looking up. Supports trailing-wildcard prefix matching (e.g., "com.apple.
|
|
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.
|
|
9014
9059
|
*/
|
|
9015
9060
|
allowMachLookup?: string[];
|
|
9016
9061
|
/**
|
|
@@ -9644,6 +9689,39 @@ export declare interface Settings {
|
|
|
9644
9689
|
* Allow Claude to push proactive mobile notifications
|
|
9645
9690
|
*/
|
|
9646
9691
|
agentPushNotifEnabled?: boolean;
|
|
9692
|
+
/**
|
|
9693
|
+
* Whether the user has accepted the auto mode opt-in dialog
|
|
9694
|
+
*/
|
|
9695
|
+
skipAutoPermissionPrompt?: boolean;
|
|
9696
|
+
/**
|
|
9697
|
+
* Whether plan mode uses auto mode semantics when auto mode is available (default: true)
|
|
9698
|
+
*/
|
|
9699
|
+
useAutoModeDuringPlan?: boolean;
|
|
9700
|
+
/**
|
|
9701
|
+
* Auto mode classifier prompt customization
|
|
9702
|
+
*/
|
|
9703
|
+
autoMode?: {
|
|
9704
|
+
/**
|
|
9705
|
+
* Rules for the auto mode classifier allow section. Include the literal string "$defaults" to inherit the built-in rules at that position.
|
|
9706
|
+
*/
|
|
9707
|
+
allow?: string[];
|
|
9708
|
+
/**
|
|
9709
|
+
* Rules for the auto mode classifier SOFT BLOCK section — destructive/irreversible actions that user intent can clear. Include the literal string "$defaults" to inherit the built-in rules at that position.
|
|
9710
|
+
*/
|
|
9711
|
+
soft_deny?: string[];
|
|
9712
|
+
/**
|
|
9713
|
+
* Rules for the auto mode classifier HARD BLOCK section — security boundaries that user intent does NOT clear. Include the literal string "$defaults" to inherit the built-in rules at that position.
|
|
9714
|
+
*/
|
|
9715
|
+
hard_deny?: string[];
|
|
9716
|
+
/**
|
|
9717
|
+
* Entries for the auto mode classifier environment section. Include the literal string "$defaults" to inherit the built-in entries at that position.
|
|
9718
|
+
*/
|
|
9719
|
+
environment?: string[];
|
|
9720
|
+
/**
|
|
9721
|
+
* When true, every Bash/PowerShell allow rule is suspended while auto mode is active so all shell commands are routed through the classifier (higher safety, more classifier calls). Default: false.
|
|
9722
|
+
*/
|
|
9723
|
+
classifyAllShell?: boolean;
|
|
9724
|
+
};
|
|
9647
9725
|
/**
|
|
9648
9726
|
* Prevent claude-cli:// protocol handler registration with the OS
|
|
9649
9727
|
*/
|
|
@@ -9733,12 +9811,12 @@ export declare interface SpareProcess extends AsyncDisposable {
|
|
|
9733
9811
|
* agents, commands and output styles, the claimed permission mode — as they
|
|
9734
9812
|
* would after a cold `query()` in that folder (the folder's `availableModels`
|
|
9735
9813
|
* narrows the model list as it does there). One limit: that snapshot is
|
|
9736
|
-
* taken as part of the claim, before `model` and `settings`
|
|
9737
|
-
*
|
|
9814
|
+
* taken as part of the claim, before `model` and the `settings` keys that
|
|
9815
|
+
* follow it are applied, so fields they decide (for example
|
|
9738
9816
|
* `fast_mode_state`, `output_style`, the remote-control defaults, an
|
|
9739
9817
|
* `availableModels` in the overlay) may not reflect them yet. After a refused claim the reads
|
|
9740
|
-
* keep describing the parked process; after `option_not_applied
|
|
9741
|
-
* `settings_not_applied`
|
|
9818
|
+
* keep describing the parked process; after `option_not_applied`, or a
|
|
9819
|
+
* `settings_not_applied` that carries `.claim`, they describe the claimed
|
|
9742
9820
|
* session.
|
|
9743
9821
|
*
|
|
9744
9822
|
* @throws when called a second time, when the spare was closed or has
|
|
@@ -9762,10 +9840,12 @@ export declare interface SpareProcess extends AsyncDisposable {
|
|
|
9762
9840
|
* when the spare exited or was closed before a claim (`spare_exited` /
|
|
9763
9841
|
* `spare_closed`), or when the `settings` overlay was refused
|
|
9764
9842
|
* (`settings_not_applied: …`; the prompt was never sent and the process
|
|
9765
|
-
*
|
|
9843
|
+
* goes away). In all of those your prompt has not run. The one rejection
|
|
9766
9844
|
* after which it does run is `option_not_applied: …`: `model` or
|
|
9767
9845
|
* `maxThinkingTokens` was not accepted and the session runs without it.
|
|
9768
|
-
*
|
|
9846
|
+
* `option_not_applied` carries `.claim` with the claim info, and so does a
|
|
9847
|
+
* `settings_not_applied` for a key sent behind the claim; one that stopped
|
|
9848
|
+
* the claim does not.
|
|
9769
9849
|
* `permissionMode` is part of the claim itself and fails closed: see
|
|
9770
9850
|
* {@link ClaimOptions}.
|
|
9771
9851
|
*/
|
|
@@ -10179,12 +10259,12 @@ export declare const USAGE_LIMIT_ERROR_PREFIXES: readonly ["You've hit your", "Y
|
|
|
10179
10259
|
*
|
|
10180
10260
|
* @alpha
|
|
10181
10261
|
*/
|
|
10182
|
-
export declare const USAGE_TRANSITION_PREFIXES: readonly ["You're now using usage credits", "You're now using your usage allocation", 'Now using your usage allocation', 'Now using usage credits', "You're now using extra usage", 'Now using extra usage'];
|
|
10262
|
+
export declare const USAGE_TRANSITION_PREFIXES: readonly ["You're now using usage credits", "You're now using your usage allocation", 'Now using your usage allocation', 'Now using usage credits', 'Now using credits', "You're now using extra usage", 'Now using extra usage'];
|
|
10183
10263
|
|
|
10184
10264
|
/**
|
|
10185
10265
|
* Approaching-limit warnings (severity:'warning'). Footer/toast only; these
|
|
10186
|
-
* never arrive as API errors. ("Approaching …"
|
|
10187
|
-
* deliberately unregistered — they render in the footer without
|
|
10266
|
+
* never arrive as API errors. ("Approaching …" and "Over N% of your … used"
|
|
10267
|
+
* warnings are deliberately unregistered — they render in the footer without
|
|
10188
10268
|
* <RateLimitMessage> styling; see the generator-coverage tests.)
|
|
10189
10269
|
*
|
|
10190
10270
|
* @alpha
|