@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/manifest.json CHANGED
@@ -1,54 +1,52 @@
1
1
  {
2
- "version": "2.1.310",
2
+ "version": "2.1.312",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "0d2056ecf42d9452a8cd8e054600024e7c557add",
5
- "buildDate": "2026-10-23T20:13:54Z",
4
+ "commit": "f375cd85d4f70920de17ce3a4ad646e18834e833",
5
+ "buildDate": "2026-10-27T17:16:03Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "ffb64331bc0ee1b69efb7c2c428bd3ab516bc31b75bf60886b356c97c1c25ffd",
10
- "size": 274068224
9
+ "checksum": "6b5ec691195e551b02c41df9f7d723f4ea61eaa03c2df90acefe3736f1aeb620",
10
+ "size": 275988512
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "28fdbed5a84ef7d4205b5751c7f021e79151c4e319c4a401e48fe6aae86bbb39",
15
- "size": 285291472
14
+ "checksum": "9534770e162cfd6e39301d9ab775affce214df032a68484085bdbab966a7f8cf",
15
+ "size": 287239296
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "9c64d9a7442436b65fcd7cc02c1aa0051bb5a7041e7788576ed3b5f29c447d54",
20
- "size": 291496120
19
+ "checksum": "dc4af28917455e009d26704b82a438353a06149e825b6cdf782908b2d28661f5",
20
+ "size": 293462200
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "b73676430af12f97316a798b8371f81d640f90a58bdcb8f3ce56a835bb47df56",
25
- "size": 291638640
24
+ "checksum": "4f4178ce41d83e23341ebfbaecdbcf8ea6bf7baea0690025abe49eeec3a5d01d",
25
+ "size": 293592432
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "adfd1f0ef12a3bcafa66e33491fc3e4204e41aeb4a7305ffc311c16c26793825",
30
- "size": 283658112
29
+ "checksum": "62555d1d87e4fff49298b70f306ef851fa167fc58b179958680f7c4d407a8c5c",
30
+ "size": 285625544
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "2ceb05e0a97b09be4c14717464a2156e8d087dea9867a399dd75d3b898ca4824",
35
- "size": 285302928
34
+ "checksum": "78adef63924b762580b039c9ff0dd2ae44eb06171d467db62fd9040442505f76",
35
+ "size": 287258072
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "f9a3920634ae3b961ee92c2eb58d0051f5f8852b120983d0a4f57b6a5efeba61",
40
- "size": 296791712
39
+ "checksum": "6099672ebe5dcb518b67d1d32dde1e3360bc6bee1dae7f8d28a69c49acc7c865",
40
+ "size": 298690208
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "91da8a2247a8806162319bcdf3e70c6ffeeb58b568481a9827fbff167a694edb",
45
- "size": 280850592
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.310",
2
+ "version": "2.1.312",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "0d2056ecf42d9452a8cd8e054600024e7c557add",
5
- "buildDate": "2026-10-23T20:15:35Z",
4
+ "commit": "f375cd85d4f70920de17ce3a4ad646e18834e833",
5
+ "buildDate": "2026-10-27T17:17:45Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "0252ecc7c918fccc5a68d6f25a80c4579c4cf99fad8b315228236c2ee9c3f4af",
10
- "size": 92705677,
9
+ "checksum": "7d759495d011057b6e8b8ee911c5be3cd36e9491c71a4ab194a425cdb1418073",
10
+ "size": 93329610,
11
11
  "bundle": {
12
- "checksum": "1c80fdf086c7cc9d88430c466dfd9259fcfcc1a1824ddf11ea0803767c464891",
13
- "size": 92707820
12
+ "checksum": "1ff759dda10f393e0194f29a890c12798619bebbb471bf512ccae254eed6a186",
13
+ "size": 93329934
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "7c82300870d0b0eb565922f6e12bf7ebc0a1e3a35ebb61af55aab883af62d680",
19
- "size": 98096628,
18
+ "checksum": "14e650c4383c00c23cdb2ff9e5b277d6248031adfbbaf1208876edb692b7dd3f",
19
+ "size": 98769361,
20
20
  "bundle": {
21
- "checksum": "c119f31f16e4e8380028a5516809d5f9041251af395a4a827b96238ca98e8b43",
22
- "size": 98116332
21
+ "checksum": "b2a050e9a9fc570ac0334cbad4dc7c46091b97a3a71bdeffdec83c91530aef84",
22
+ "size": 98760451
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "ad34932dfad2bd67c328b9358acaac7c998e8113dc065dd328958b984a73fe27",
28
- "size": 102027606
27
+ "checksum": "863ee1d2a91a39ee22fa13322582e4c3fb45bfb4739b22ec7e396dde694d8581",
28
+ "size": 102731812
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "9314f28f679546a97813f2914c4fb60a190801ef782805f47bf197317cc4ffd2",
33
- "size": 102993457
32
+ "checksum": "6fb9e329947c003740be888f98db1aecaa238d6c7d9ceef8581eb71d5a59480b",
33
+ "size": 103703105
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "f4dc063aae358589c4b58027a5a2e0d8bdccde16109af11407301a50bb349281",
38
- "size": 100369361
37
+ "checksum": "5e8714a8944f6771325a8b2bd641bcdca7bcc632d60b4b965f8c716db989a6cc",
38
+ "size": 101059126
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "ac75639744e4185547254e3d1054089d6a78747b4b838783f3b758ca369c77f1",
43
- "size": 101393542
42
+ "checksum": "122b51ddadc68c6afc8deb4d7bda82fcb5e1d49e5994c3eed750a5d6428ab6a4",
43
+ "size": 102078647
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "f37a98ecff44e2605a30985bff7ba7c7a87bd936539eb3681a97b0c9794180a8",
48
- "size": 106282873
47
+ "checksum": "c5e376352bf2b0e56592358ba3b2943d3de7b351f750c2340f0675fe88148038",
48
+ "size": 106918151
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "691b41c2a6e91f094dbc501421eeb2a6c667ca98632894814c609ed1886c6b57",
53
- "size": 101465393
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.310",
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.0.0"
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.310",
65
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.310",
66
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.310",
67
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.310",
68
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.310",
69
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.310",
70
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.310",
71
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.310"
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-4pv47a2z.mjs",
89
- "core-bz5kkzv0.mjs",
90
- "core-c86d180z.mjs",
91
- "core-pzfwbvz7.mjs"
88
+ "core-azmey26z.mjs",
89
+ "core-jhgm58v5.mjs",
90
+ "core-qw4t51gr.mjs",
91
+ "core-x7q9bdvq.mjs"
92
92
  ],
93
- "claudeCodeVersion": "2.1.310"
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 closed — start the session with `query()`. One limit
365
- * in this version: keys that govern hooks (`hooks`, `disableAllHooks`,
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 — because the claimed folder's SessionStart hooks start with the
369
- * claim, before the overlay lands; give those to `prewarm()` in
370
- * `Options.settings`, where they are in force before any hook as on a cold
371
- * start. The rest of the overlay is in force before the prompt you pass to
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 or permission rules — but not hook settings, which
2841
- * would land after the claimed folder's SessionStart hooks have started; those
2842
- * go in `Options.settings` here), `appendSystemPrompt`, `title`, `agents`, and
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 will send on its next request — 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.
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.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.
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` are applied, so
9737
- * fields the model or the settings overlay decide (for example
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` or
9741
- * `settings_not_applied` (the claim itself took) they describe the claimed
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
- * was closed). In all of those your prompt has not run. The one rejection
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
- * Both `…_not_applied` errors carry `.claim` with the claim info.
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 …" early warnings are
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