@anthropic-ai/claude-agent-sdk 0.3.282 → 0.3.284
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/bridge.mjs +67 -62
- package/browser-sdk.js +46 -40
- package/core-3ctbshc7.mjs +40 -0
- package/core-eg2e19h0.mjs +31 -0
- package/core.mjs +18 -18
- package/manifest.json +22 -22
- package/manifest.zst.json +26 -26
- package/package.json +12 -12
- package/sdk-tools.d.ts +1 -1
- package/sdk.d.ts +44 -27
- package/sdk.mjs +82 -80
- package/core-276encc2.mjs +0 -38
- package/core-5drmq1nt.mjs +0 -31
package/manifest.json
CHANGED
|
@@ -1,54 +1,53 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.1.
|
|
2
|
+
"version": "2.1.284",
|
|
3
3
|
"manifestSignatureEnforcement": "flag",
|
|
4
|
-
"commit": "
|
|
5
|
-
"modsCommit": "
|
|
6
|
-
"buildDate": "2026-09-
|
|
4
|
+
"commit": "2b8ce618c24de26410e4bdfc4e1d592accd61f61",
|
|
5
|
+
"modsCommit": "7779afb12e3635f46f56ec823979d68350ae000b",
|
|
6
|
+
"buildDate": "2026-09-28T02:36:51Z",
|
|
7
7
|
"platforms": {
|
|
8
8
|
"darwin-arm64": {
|
|
9
9
|
"binary": "claude",
|
|
10
|
-
"checksum": "
|
|
11
|
-
"size":
|
|
10
|
+
"checksum": "50a14c2f50f56668380fdda490167f1d3630d5cc18fb8aed3073c2c7ea7314fe",
|
|
11
|
+
"size": 226563088
|
|
12
12
|
},
|
|
13
13
|
"darwin-x64": {
|
|
14
14
|
"binary": "claude",
|
|
15
|
-
"checksum": "
|
|
16
|
-
"size":
|
|
15
|
+
"checksum": "79441b868935a11ed0630b2ee59327eda9f6a93bb8d470bd6633c03df76d2135",
|
|
16
|
+
"size": 235010944
|
|
17
17
|
},
|
|
18
18
|
"linux-arm64": {
|
|
19
19
|
"binary": "claude",
|
|
20
|
-
"checksum": "
|
|
21
|
-
"size":
|
|
20
|
+
"checksum": "3dd0f96d7ada463152d20300186f6cfc6ab94b57e218f49e3ac86db42ac695a6",
|
|
21
|
+
"size": 242409464
|
|
22
22
|
},
|
|
23
23
|
"linux-x64": {
|
|
24
24
|
"binary": "claude",
|
|
25
|
-
"checksum": "
|
|
26
|
-
"size":
|
|
25
|
+
"checksum": "5cd90aabd83f8a15136c35aa37bb1d92b348993573316643dc3fe4e04afbf88f",
|
|
26
|
+
"size": 243059896
|
|
27
27
|
},
|
|
28
28
|
"linux-arm64-musl": {
|
|
29
29
|
"binary": "claude",
|
|
30
|
-
"checksum": "
|
|
31
|
-
"size":
|
|
30
|
+
"checksum": "d8bce5724ecd1e6930ddf5f4cef7cebb0cd3e50b4f5d5158b30a53f81824f982",
|
|
31
|
+
"size": 234764096
|
|
32
32
|
},
|
|
33
33
|
"linux-x64-musl": {
|
|
34
34
|
"binary": "claude",
|
|
35
|
-
"checksum": "
|
|
36
|
-
"size":
|
|
35
|
+
"checksum": "1c5e4d7431c1e70c45efdce69ea74c2c9a2ad309f16555f7dc563f4743d978a0",
|
|
36
|
+
"size": 236810328
|
|
37
37
|
},
|
|
38
38
|
"win32-x64": {
|
|
39
39
|
"binary": "claude.exe",
|
|
40
|
-
"checksum": "
|
|
41
|
-
"size":
|
|
40
|
+
"checksum": "0416631e846f743110da5282409776fa1313e65f33a588aae066eaf8db0fda7d",
|
|
41
|
+
"size": 246480032
|
|
42
42
|
},
|
|
43
43
|
"win32-arm64": {
|
|
44
44
|
"binary": "claude.exe",
|
|
45
|
-
"checksum": "
|
|
46
|
-
"size":
|
|
45
|
+
"checksum": "8a968e1500576eea43d04d7cffd40cf39b1c83e5b443522bafe0e92e50d6a389",
|
|
46
|
+
"size": 234005152
|
|
47
47
|
}
|
|
48
48
|
},
|
|
49
49
|
"sdkCompat": {
|
|
50
50
|
"testedWrapperVersions": [
|
|
51
|
-
"0.3.243",
|
|
52
51
|
"0.3.245",
|
|
53
52
|
"0.3.246",
|
|
54
53
|
"0.3.247",
|
|
@@ -77,7 +76,8 @@
|
|
|
77
76
|
"0.3.277",
|
|
78
77
|
"0.3.278",
|
|
79
78
|
"0.3.280",
|
|
80
|
-
"0.3.281"
|
|
79
|
+
"0.3.281",
|
|
80
|
+
"0.3.282"
|
|
81
81
|
],
|
|
82
82
|
"harnessSchema": 1
|
|
83
83
|
}
|
package/manifest.zst.json
CHANGED
|
@@ -1,62 +1,61 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.1.
|
|
2
|
+
"version": "2.1.284",
|
|
3
3
|
"manifestSignatureEnforcement": "flag",
|
|
4
|
-
"commit": "
|
|
5
|
-
"modsCommit": "
|
|
6
|
-
"buildDate": "2026-09-
|
|
4
|
+
"commit": "2b8ce618c24de26410e4bdfc4e1d592accd61f61",
|
|
5
|
+
"modsCommit": "7779afb12e3635f46f56ec823979d68350ae000b",
|
|
6
|
+
"buildDate": "2026-09-28T02:38:01Z",
|
|
7
7
|
"platforms": {
|
|
8
8
|
"darwin-arm64": {
|
|
9
9
|
"binary": "claude.zst",
|
|
10
|
-
"checksum": "
|
|
11
|
-
"size":
|
|
10
|
+
"checksum": "ed26ee9ccbf05b2dfa3c8abf52348b78b00274304824ad1eeaf9d88366fa70ae",
|
|
11
|
+
"size": 75450868,
|
|
12
12
|
"bundle": {
|
|
13
|
-
"checksum": "
|
|
14
|
-
"size":
|
|
13
|
+
"checksum": "e8e2eb9333a6b949199ceba0bbb203ae7c15822cfb284ffa8998818136cccc83",
|
|
14
|
+
"size": 75472329
|
|
15
15
|
}
|
|
16
16
|
},
|
|
17
17
|
"darwin-x64": {
|
|
18
18
|
"binary": "claude.zst",
|
|
19
|
-
"checksum": "
|
|
20
|
-
"size":
|
|
19
|
+
"checksum": "28f05c4cbd49a8192e2ea6535a3bc55c11f6bb8f15d1b5932785291d0eb52d81",
|
|
20
|
+
"size": 79633391,
|
|
21
21
|
"bundle": {
|
|
22
|
-
"checksum": "
|
|
23
|
-
"size":
|
|
22
|
+
"checksum": "f520ee6863b8241cadd4ce746cdd23a54ca66023f7ce26635e74033ad2296d5f",
|
|
23
|
+
"size": 79631029
|
|
24
24
|
}
|
|
25
25
|
},
|
|
26
26
|
"linux-arm64": {
|
|
27
27
|
"binary": "claude.zst",
|
|
28
|
-
"checksum": "
|
|
29
|
-
"size":
|
|
28
|
+
"checksum": "6e31b86de3952594441b4ef91c1f5079c1385b0169a9df351dd2762bb2336d23",
|
|
29
|
+
"size": 84564981
|
|
30
30
|
},
|
|
31
31
|
"linux-x64": {
|
|
32
32
|
"binary": "claude.zst",
|
|
33
|
-
"checksum": "
|
|
34
|
-
"size":
|
|
33
|
+
"checksum": "5021d631dacbd516603a779b3cf2463085470417a838b6a0835f77fa44d23f0a",
|
|
34
|
+
"size": 85305499
|
|
35
35
|
},
|
|
36
36
|
"linux-arm64-musl": {
|
|
37
37
|
"binary": "claude.zst",
|
|
38
|
-
"checksum": "
|
|
39
|
-
"size":
|
|
38
|
+
"checksum": "6ea61bf336a2f4077313e6d28a527bcb27c197557fdca3236bc2b54fe08afaf7",
|
|
39
|
+
"size": 82964275
|
|
40
40
|
},
|
|
41
41
|
"linux-x64-musl": {
|
|
42
42
|
"binary": "claude.zst",
|
|
43
|
-
"checksum": "
|
|
44
|
-
"size":
|
|
43
|
+
"checksum": "f7c3c7007c94943cd2a18d0bfbccf5b1b71e34b2657ba28b60e39e21cced9e73",
|
|
44
|
+
"size": 83735595
|
|
45
45
|
},
|
|
46
46
|
"win32-x64": {
|
|
47
47
|
"binary": "claude.exe.zst",
|
|
48
|
-
"checksum": "
|
|
49
|
-
"size":
|
|
48
|
+
"checksum": "43ca996effd9a70a475693a68331f3a943c3e179c4457a23be45c1858e400db8",
|
|
49
|
+
"size": 87601305
|
|
50
50
|
},
|
|
51
51
|
"win32-arm64": {
|
|
52
52
|
"binary": "claude.exe.zst",
|
|
53
|
-
"checksum": "
|
|
54
|
-
"size":
|
|
53
|
+
"checksum": "4d0079df92f51d3e8caf6ecc9c0dac52201d0e392764e246729b9eb7ee56de14",
|
|
54
|
+
"size": 83931586
|
|
55
55
|
}
|
|
56
56
|
},
|
|
57
57
|
"sdkCompat": {
|
|
58
58
|
"testedWrapperVersions": [
|
|
59
|
-
"0.3.243",
|
|
60
59
|
"0.3.245",
|
|
61
60
|
"0.3.246",
|
|
62
61
|
"0.3.247",
|
|
@@ -85,7 +84,8 @@
|
|
|
85
84
|
"0.3.277",
|
|
86
85
|
"0.3.278",
|
|
87
86
|
"0.3.280",
|
|
88
|
-
"0.3.281"
|
|
87
|
+
"0.3.281",
|
|
88
|
+
"0.3.282"
|
|
89
89
|
],
|
|
90
90
|
"harnessSchema": 1
|
|
91
91
|
}
|
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.284",
|
|
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.284",
|
|
65
|
+
"@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.284",
|
|
66
|
+
"@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.284",
|
|
67
|
+
"@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.284",
|
|
68
|
+
"@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.284",
|
|
69
|
+
"@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.284",
|
|
70
|
+
"@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.284",
|
|
71
|
+
"@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.284"
|
|
72
72
|
},
|
|
73
73
|
"files": [
|
|
74
74
|
"sdk.mjs",
|
|
@@ -85,8 +85,8 @@
|
|
|
85
85
|
"extractFromBunfs.d.ts",
|
|
86
86
|
"manifest.json",
|
|
87
87
|
"manifest.zst.json",
|
|
88
|
-
"core-
|
|
89
|
-
"core-
|
|
88
|
+
"core-3ctbshc7.mjs",
|
|
89
|
+
"core-eg2e19h0.mjs"
|
|
90
90
|
],
|
|
91
|
-
"claudeCodeVersion": "2.1.
|
|
91
|
+
"claudeCodeVersion": "2.1.284"
|
|
92
92
|
}
|
package/sdk-tools.d.ts
CHANGED
|
@@ -3165,7 +3165,7 @@ export interface ArtifactInput {
|
|
|
3165
3165
|
*/
|
|
3166
3166
|
label?: string;
|
|
3167
3167
|
/**
|
|
3168
|
-
*
|
|
3168
|
+
* An existing artifact's claude.ai link (claude.ai/artifact/{id} or claude.ai/code/artifact/{uuid}; a chat, project or session link is not one) to update in place. Pass whenever the user wants to update an artifact this conversation did not publish — "update my artifact", "keep the same link", a pasted artifact URL — and find the URL with action: "list" or ask the user for the link if you don't have it; without this, the publish creates a separate artifact instead of updating the existing one. Omit for new artifacts and same-conversation redeploys. Must be an artifact the user owns or was given edit access to (a read of it says "writer"). Before publishing to an artifact this conversation has neither read nor published, read it (action: "read") and build on what comes back; a publish sent without that read is refused. A refusal that hands you the live version counts as that read: merge your edits into that version and publish that; never resend the refused content unchanged. For 'read' and the other url-addressed actions: the artifact to act on.
|
|
3169
3169
|
*/
|
|
3170
3170
|
url?: string;
|
|
3171
3171
|
/**
|
package/sdk.d.ts
CHANGED
|
@@ -679,11 +679,7 @@ export declare type DirectoryAddedHookInput = BaseHookInput & {
|
|
|
679
679
|
/**
|
|
680
680
|
* Effort level for controlling how much thinking/reasoning Claude applies.
|
|
681
681
|
*
|
|
682
|
-
* -
|
|
683
|
-
* - `'medium'` — Moderate thinking
|
|
684
|
-
* - `'high'` — Deep reasoning (default)
|
|
685
|
-
* - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+, Sonnet 5; falls back to `'high'` elsewhere)
|
|
686
|
-
* - `'max'` — Maximum effort (select models only)
|
|
682
|
+
* @see https://platform.claude.com/docs/en/build-with-claude/effort
|
|
687
683
|
*/
|
|
688
684
|
export declare type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
|
|
689
685
|
|
|
@@ -1905,12 +1901,6 @@ export declare type Options = {
|
|
|
1905
1901
|
* Controls how much effort Claude puts into its response.
|
|
1906
1902
|
* Works with adaptive thinking to guide thinking depth.
|
|
1907
1903
|
*
|
|
1908
|
-
* - `'low'` — Minimal thinking, fastest responses
|
|
1909
|
-
* - `'medium'` — Moderate thinking
|
|
1910
|
-
* - `'high'` — Deep reasoning (default)
|
|
1911
|
-
* - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+, Sonnet 5)
|
|
1912
|
-
* - `'max'` — Maximum effort (Fable 5, Opus 4.6+, Sonnet 4.6+)
|
|
1913
|
-
*
|
|
1914
1904
|
* @see https://platform.claude.com/docs/en/build-with-claude/effort
|
|
1915
1905
|
*/
|
|
1916
1906
|
effort?: EffortLevel;
|
|
@@ -2933,6 +2923,11 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
|
|
|
2933
2923
|
* main-thread agent, and `ultracode` to off with the current effort kept.
|
|
2934
2924
|
* Only available in streaming input mode.
|
|
2935
2925
|
*
|
|
2926
|
+
* `ultracode: true` or `false` turns ultracode on or off and leaves the
|
|
2927
|
+
* effort level alone. An `effortLevel` that moves the session to a
|
|
2928
|
+
* different level, sent without an `ultracode` key, also turns ultracode
|
|
2929
|
+
* off; send both keys to change the level and keep it on.
|
|
2930
|
+
*
|
|
2936
2931
|
* @param settings - A partial settings object to merge into the flag
|
|
2937
2932
|
* settings. `effortLevel` also accepts `'max'` (never written to settings
|
|
2938
2933
|
* files, so the persisted {@link Settings.effortLevel} excludes it): it is
|
|
@@ -4539,6 +4534,7 @@ export declare type SDKControlInitializeResponse = {
|
|
|
4539
4534
|
|
|
4540
4535
|
|
|
4541
4536
|
|
|
4537
|
+
|
|
4542
4538
|
};
|
|
4543
4539
|
|
|
4544
4540
|
/**
|
|
@@ -5007,7 +5003,7 @@ declare type SDKControlSetColorRequest = {
|
|
|
5007
5003
|
};
|
|
5008
5004
|
|
|
5009
5005
|
/**
|
|
5010
|
-
* Sets the maximum number of thinking tokens for extended thinking. When max_thinking_tokens is
|
|
5006
|
+
* Sets the maximum number of thinking tokens for extended thinking. When max_thinking_tokens is null, thinking resets to the session default: any mid-session budget override is cleared (back to the spawn-time budget, if one was set), and thinking stays off for sessions that have it disabled. When max_thinking_tokens is omitted, the budget is left as it is, so a request that only changes thinking_display can leave the field out. thinking_display optionally sets the thinking display mode for the rest of the session: a value replaces the session display mode, null clears that override so Claude Code's default display handling applies again, and when omitted the display mode from session start (--thinking-display) is kept. 'highlights' returns one short title per stretch of thinking instead of a prose summary. The API accepts it only from Claude Code sessions that Anthropic hosts; if the API rejects it, the session sends 'omitted' (no thinking text) in its place from then on. A request for 'highlights' fails, and changes neither the budget nor the display, after such a rejection, on Amazon Bedrock, Google Vertex AI or another provider without Anthropic's first-party beta features, when experimental betas are off (CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS or organization policy), or on a Claude 3 model (except on Microsoft Foundry).
|
|
5011
5007
|
*/
|
|
5012
5008
|
declare type SDKControlSetMaxThinkingTokensRequest = {
|
|
5013
5009
|
subtype: 'set_max_thinking_tokens';
|
|
@@ -5318,6 +5314,7 @@ export declare type SDKMessageOrigin = {
|
|
|
5318
5314
|
* 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.
|
|
5319
5315
|
*/
|
|
5320
5316
|
fireReason?: string;
|
|
5317
|
+
|
|
5321
5318
|
} | {
|
|
5322
5319
|
kind: 'coordinator';
|
|
5323
5320
|
} | {
|
|
@@ -5429,6 +5426,7 @@ export declare type SDKPartialAssistantMessage = {
|
|
|
5429
5426
|
uuid: UUID;
|
|
5430
5427
|
session_id: string;
|
|
5431
5428
|
ttft_ms?: number;
|
|
5429
|
+
|
|
5432
5430
|
/**
|
|
5433
5431
|
* Client uuid of the user message this turn is answering (submitMessage options.uuid), stamped on a non-ping stream event each time that send changes: the turn's FIRST non-ping stream event (normally the frame that triggers the turn's initial ack), and, for a turn started by a synthetic (meta) prompt, the first non-ping stream event after each queued user message folded in mid-turn takes the echo over (see SDKAssistantMessage.user_message_uuid for the rule) — so a consumer can bind the reply stream to the send it answers without waiting for the result. A turn started by a typed prompt stamps only its first non-ping stream event; independently, its first complete assistant message is stamped as well (see SDKAssistantMessage.user_message_uuid), so the same uuid may appear on both. Absent on every other stream event of the turn, on turns that neither had a client uuid nor folded a user message in, and from older producers.
|
|
5434
5432
|
*/
|
|
@@ -5809,7 +5807,7 @@ export declare type SDKSettingsParseError = {
|
|
|
5809
5807
|
};
|
|
5810
5808
|
|
|
5811
5809
|
/**
|
|
5812
|
-
* 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. 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,
|
|
5810
|
+
* 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. 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.
|
|
5813
5811
|
*/
|
|
5814
5812
|
export declare type SDKStartupFailureReason = 'org_pin_api_key_conflict' | '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';
|
|
5815
5813
|
|
|
@@ -5872,7 +5870,18 @@ export declare type SDKSystemMessage = {
|
|
|
5872
5870
|
*/
|
|
5873
5871
|
version?: string;
|
|
5874
5872
|
}[];
|
|
5875
|
-
|
|
5873
|
+
/**
|
|
5874
|
+
* Plugin load-time errors. A plugin that did not load (an unmet dependency, a --plugin-dir entry that failed) is absent from `plugins[]`; a plugin that loaded without one of its components keeps its row and gets an entry here too. `plugin` is `name@marketplace`, or the positional `inline[N]` / `synced[N]` tag for a directory entry that failed before it had a name; `type` is a category from an open set (path-not-found, generic-error, manifest-validation-error, dependency-unsatisfied, hook-load-failed, …) — treat a value you do not recognize as a generic failure; `message` is display text. The key is omitted when there are no errors; CI can fail on `(plugin_errors?.length ?? 0) > 0`. A session whose frames are persisted server-side (a Remote Control worker) always omits this key — plugin diagnostics stay in the local log there, so an omitted key does not assert a clean load.
|
|
5875
|
+
*/
|
|
5876
|
+
plugin_errors?: {
|
|
5877
|
+
plugin: string;
|
|
5878
|
+
type: string;
|
|
5879
|
+
message: string;
|
|
5880
|
+
/**
|
|
5881
|
+
* Present only when a --plugin-dir, SDK `plugins` or synced directory entry did not load at all: the path of that entry, resolved against the cwd (for a directory, the value its `plugins[]` row would have carried; for a .zip, the archive; a --plugin-url entry carries none). `plugin` is then the positional `inline[N]` / `synced[N]` tag, so a host that mounts several directories pairs the error to its own by this path.
|
|
5882
|
+
*/
|
|
5883
|
+
path?: string;
|
|
5884
|
+
}[];
|
|
5876
5885
|
|
|
5877
5886
|
|
|
5878
5887
|
fast_mode_state?: FastModeState;
|
|
@@ -6739,13 +6748,21 @@ export declare interface Settings {
|
|
|
6739
6748
|
*/
|
|
6740
6749
|
fallbackModel?: string[];
|
|
6741
6750
|
/**
|
|
6742
|
-
* Allowlist of models that users can select. Accepts family aliases ("opus" allows any opus version), version prefixes ("opus-4-5" allows
|
|
6751
|
+
* Allowlist of models that users can select. Accepts family aliases ("opus" allows any opus version), version prefixes ("opus-4-5" allows that version and any model ID that extends it, so "claude-opus-5" also allows "claude-opus-5-5"), and full model IDs. If undefined, all models are available. If empty array, only the default model is available. Typically set in managed settings by enterprise administrators.
|
|
6743
6752
|
*/
|
|
6744
6753
|
availableModels?: string[];
|
|
6745
6754
|
/**
|
|
6746
6755
|
* When true and availableModels is a non-empty array, the Default model selection is also constrained: if the default model for the user tier is not in availableModels, Default resolves to the first allowed availableModels entry instead. Has no effect when availableModels is unset or an empty array. Typically set in managed settings by enterprise administrators.
|
|
6747
6756
|
*/
|
|
6748
6757
|
enforceAvailableModels?: boolean;
|
|
6758
|
+
/**
|
|
6759
|
+
* How availableModels entries match model IDs. "prefix" (the default) lets an entry also allow any model ID that extends it, so "claude-opus-5" allows "claude-opus-5-5". "exact" keeps that matching but stops a model ID entry from allowing other versions: "claude-opus-5" allows Opus 5 and its dated and -fast IDs, but not Opus 5.5 or a later release until it is listed, and a -latest ID needs a -latest entry. Family aliases ("opus") still allow the whole family; aliases whose model depends on the release or settings (best, opusplan, default) are ignored. With "exact" and a list that names at least one model, the Default option also uses only a listed model; if none can be used, Claude Code will not start. Haiku background models, and hooks and other helper requests that pick their own model, are not restricted (deniedModels covers them; allowManagedHooksOnly limits hooks). Read from managed settings only.
|
|
6760
|
+
*/
|
|
6761
|
+
availableModelsMatch?: 'prefix' | 'exact';
|
|
6762
|
+
/**
|
|
6763
|
+
* Models users cannot select, even when availableModels allows them. A family alias ("opus") blocks that family. A model ID blocks that version in every spelling: dates, -fast and provider prefixes are ignored, so "claude-opus-5-5" blocks every Opus 5.5 ID but not Opus 5. An ID with no minor version ("claude-opus-5") also blocks later minor versions, as it allows them in availableModels. Aliases whose model depends on the release or settings (best, opusplan, default) are ignored. The Default option steps down past a blocked model; if the Default has no allowed model to step down to, Claude Code will not start. Read from managed settings only.
|
|
6764
|
+
*/
|
|
6765
|
+
deniedModels?: string[];
|
|
6749
6766
|
/**
|
|
6750
6767
|
* Override mapping from Anthropic model ID (e.g. "claude-opus-4-6") to provider-specific model ID (e.g. a Bedrock inference profile ARN). Typically set in managed settings by enterprise administrators.
|
|
6751
6768
|
*/
|
|
@@ -7158,7 +7175,7 @@ export declare interface Settings {
|
|
|
7158
7175
|
*/
|
|
7159
7176
|
httpHookAllowedEnvVars?: string[];
|
|
7160
7177
|
/**
|
|
7161
|
-
* When true (and set in managed settings), permission rules from user, project, local, and --settings files and allow rules from --allowedTools are ignored; only managed settings can add allow rules through settings. The allowed-tools frontmatter of skills and custom commands from user, project, and --add-dir sources, and of plugins
|
|
7178
|
+
* When true (and set in managed settings), permission rules from user, project, local, and --settings files and allow rules from --allowedTools are ignored; only managed settings can add allow rules through settings. The allowed-tools frontmatter of skills and custom commands from user, project, and --add-dir sources, and of plugins no managed setting vouches for, is ignored too. Plugins keep theirs only on an admin-backed channel: host-delivered --plugin-dir plugins, the official marketplace registered from its unpinned anthropics source, claude.ai-synced plugins Anthropic attests, the saved login organization's claude.ai-hosted marketplaces, marketplaces whose registered source managed extraKnownMarketplaces declares or an exact or owner-pinned (owner/*) strictKnownMarketplaces entry names at the path it pins (an npm marketplace source only when the registration and the declared entry pin the same registry, and a settings marketplace source only when every nested npm plugin entry pins one on a bare package name — unpinned, the package resolves through the member's own npm config, and a non-bare spelling packs as an exotic spec the pin does not bind, so nothing an entry names is what was fetched), and npm-direct (package\@npm) plugins whose recorded resolution a registry-pinned managed npm strictKnownMarketplaces entry names (host and path patterns and enabledPlugins ids do not vouch); managed and bundled skills keep theirs. --disallowedTools, skill disallowed-tools, and other deny and ask rules from the command line or the current session still apply.
|
|
7162
7179
|
*/
|
|
7163
7180
|
allowManagedPermissionRulesOnly?: boolean;
|
|
7164
7181
|
/**
|
|
@@ -7327,7 +7344,7 @@ export declare interface Settings {
|
|
|
7327
7344
|
*/
|
|
7328
7345
|
version?: string;
|
|
7329
7346
|
/**
|
|
7330
|
-
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
|
|
7347
|
+
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
|
|
7331
7348
|
*/
|
|
7332
7349
|
registry?: string;
|
|
7333
7350
|
} | {
|
|
@@ -7371,7 +7388,7 @@ export declare interface Settings {
|
|
|
7371
7388
|
*/
|
|
7372
7389
|
name: string;
|
|
7373
7390
|
/**
|
|
7374
|
-
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
|
|
7391
|
+
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
|
|
7375
7392
|
*/
|
|
7376
7393
|
source: string | {
|
|
7377
7394
|
source: 'npm';
|
|
@@ -7579,7 +7596,7 @@ export declare interface Settings {
|
|
|
7579
7596
|
*/
|
|
7580
7597
|
version?: string;
|
|
7581
7598
|
/**
|
|
7582
|
-
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
|
|
7599
|
+
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
|
|
7583
7600
|
*/
|
|
7584
7601
|
registry?: string;
|
|
7585
7602
|
} | {
|
|
@@ -7623,7 +7640,7 @@ export declare interface Settings {
|
|
|
7623
7640
|
*/
|
|
7624
7641
|
name: string;
|
|
7625
7642
|
/**
|
|
7626
|
-
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
|
|
7643
|
+
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
|
|
7627
7644
|
*/
|
|
7628
7645
|
source: string | {
|
|
7629
7646
|
source: 'npm';
|
|
@@ -7826,7 +7843,7 @@ export declare interface Settings {
|
|
|
7826
7843
|
*/
|
|
7827
7844
|
version?: string;
|
|
7828
7845
|
/**
|
|
7829
|
-
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
|
|
7846
|
+
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
|
|
7830
7847
|
*/
|
|
7831
7848
|
registry?: string;
|
|
7832
7849
|
} | {
|
|
@@ -7870,7 +7887,7 @@ export declare interface Settings {
|
|
|
7870
7887
|
*/
|
|
7871
7888
|
name: string;
|
|
7872
7889
|
/**
|
|
7873
|
-
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
|
|
7890
|
+
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
|
|
7874
7891
|
*/
|
|
7875
7892
|
source: string | {
|
|
7876
7893
|
source: 'npm';
|
|
@@ -8063,7 +8080,7 @@ export declare interface Settings {
|
|
|
8063
8080
|
*/
|
|
8064
8081
|
version?: string;
|
|
8065
8082
|
/**
|
|
8066
|
-
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
|
|
8083
|
+
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
|
|
8067
8084
|
*/
|
|
8068
8085
|
registry?: string;
|
|
8069
8086
|
} | {
|
|
@@ -8107,7 +8124,7 @@ export declare interface Settings {
|
|
|
8107
8124
|
*/
|
|
8108
8125
|
name: string;
|
|
8109
8126
|
/**
|
|
8110
|
-
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
|
|
8127
|
+
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
|
|
8111
8128
|
*/
|
|
8112
8129
|
source: string | {
|
|
8113
8130
|
source: 'npm';
|
|
@@ -8300,7 +8317,7 @@ export declare interface Settings {
|
|
|
8300
8317
|
*/
|
|
8301
8318
|
version?: string;
|
|
8302
8319
|
/**
|
|
8303
|
-
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
|
|
8320
|
+
* Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
|
|
8304
8321
|
*/
|
|
8305
8322
|
registry?: string;
|
|
8306
8323
|
} | {
|
|
@@ -8344,7 +8361,7 @@ export declare interface Settings {
|
|
|
8344
8361
|
*/
|
|
8345
8362
|
name: string;
|
|
8346
8363
|
/**
|
|
8347
|
-
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
|
|
8364
|
+
* Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
|
|
8348
8365
|
*/
|
|
8349
8366
|
source: string | {
|
|
8350
8367
|
source: 'npm';
|
|
@@ -8848,7 +8865,7 @@ export declare interface Settings {
|
|
|
8848
8865
|
};
|
|
8849
8866
|
};
|
|
8850
8867
|
/**
|
|
8851
|
-
* Enable ultracode for the session:
|
|
8868
|
+
* Enable ultracode for the session: standing dynamic-workflow orchestration at any effort level. Session-scoped — typically provided via --settings or the apply_flag_settings control request; interactive toggles never persist it. Requires workflows to be enabled and a model that supports ultracode.
|
|
8852
8869
|
*/
|
|
8853
8870
|
ultracode?: boolean;
|
|
8854
8871
|
/**
|