@anthropic-ai/claude-agent-sdk 0.3.311 → 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,53 +1,52 @@
1
1
  {
2
- "version": "2.1.311",
2
+ "version": "2.1.312",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "e7d3b8365a0ffbe2f5dd032feb28e9fd9c7de025",
5
- "buildDate": "2026-10-26T19:03:46Z",
4
+ "commit": "f375cd85d4f70920de17ce3a4ad646e18834e833",
5
+ "buildDate": "2026-10-27T17:16:03Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "85d8c08707fcfd1e78ffa0204eefbc6ec9e4fe22f375fb2767ef85d957ed3161",
10
- "size": 276185504
9
+ "checksum": "6b5ec691195e551b02c41df9f7d723f4ea61eaa03c2df90acefe3736f1aeb620",
10
+ "size": 275988512
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "d34e1cb82015b050471a97574aa6ea6f698ecf3a97a61c980961f43ad9f838f5",
15
- "size": 287420928
14
+ "checksum": "9534770e162cfd6e39301d9ab775affce214df032a68484085bdbab966a7f8cf",
15
+ "size": 287239296
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "2e2496c9a8065df93acb0fca2d341f59a6b8777649b2e025ab8c9bcd5eef61f3",
20
- "size": 293658808
19
+ "checksum": "dc4af28917455e009d26704b82a438353a06149e825b6cdf782908b2d28661f5",
20
+ "size": 293462200
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "86dc1fcc69498159eaf15f446613e847010f9036bfbbdffd4c49350be8489ada",
25
- "size": 293776752
24
+ "checksum": "4f4178ce41d83e23341ebfbaecdbcf8ea6bf7baea0690025abe49eeec3a5d01d",
25
+ "size": 293592432
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "172150e3f9ea07e8e2e2e29862d7d9a25f5c234d8e909e4063df237665bf09b9",
30
- "size": 285822152
29
+ "checksum": "62555d1d87e4fff49298b70f306ef851fa167fc58b179958680f7c4d407a8c5c",
30
+ "size": 285625544
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "cd40dd327145ee47aa0deacd571801c1d782388f709d71242eee6b91de8ed11f",
35
- "size": 287442392
34
+ "checksum": "78adef63924b762580b039c9ff0dd2ae44eb06171d467db62fd9040442505f76",
35
+ "size": 287258072
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "966f4b2ce962298f5dee6a942e8c47c8f97392e69e728e622319a98b259c0680",
40
- "size": 298870432
39
+ "checksum": "6099672ebe5dcb518b67d1d32dde1e3360bc6bee1dae7f8d28a69c49acc7c865",
40
+ "size": 298690208
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "951b5d94bf2a5296db2c442784e68d18fa04dec2d7d2e805aa50e75d618aad5e",
45
- "size": 282933920
44
+ "checksum": "2bde7020ff94a52b59fa4c0c14f81558d3c5180848b2d85069b6efcad0415a4f",
45
+ "size": 282754208
46
46
  }
47
47
  },
48
48
  "sdkCompat": {
49
49
  "testedWrapperVersions": [
50
- "0.3.278",
51
50
  "0.3.280",
52
51
  "0.3.281",
53
52
  "0.3.282",
package/manifest.zst.json CHANGED
@@ -1,61 +1,60 @@
1
1
  {
2
- "version": "2.1.311",
2
+ "version": "2.1.312",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "e7d3b8365a0ffbe2f5dd032feb28e9fd9c7de025",
5
- "buildDate": "2026-10-26T19:05:12Z",
4
+ "commit": "f375cd85d4f70920de17ce3a4ad646e18834e833",
5
+ "buildDate": "2026-10-27T17:17:45Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "68a55ab38088b10f213be752ac47e2d88e81cf8ac2bae3a31396b2cd6c9a91ec",
10
- "size": 93380583,
9
+ "checksum": "7d759495d011057b6e8b8ee911c5be3cd36e9491c71a4ab194a425cdb1418073",
10
+ "size": 93329610,
11
11
  "bundle": {
12
- "checksum": "75ff20c96ec39582035067231b6aa4a1b5830e53bcb1167f81f9639be0b2a842",
13
- "size": 93383140
12
+ "checksum": "1ff759dda10f393e0194f29a890c12798619bebbb471bf512ccae254eed6a186",
13
+ "size": 93329934
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "066565c1d787345f945bace4f0cb2f2a41bf96800adabb0f0b0c3bb701af69d6",
19
- "size": 98817523,
18
+ "checksum": "14e650c4383c00c23cdb2ff9e5b277d6248031adfbbaf1208876edb692b7dd3f",
19
+ "size": 98769361,
20
20
  "bundle": {
21
- "checksum": "84cb2ff289ac3316744057fa0786c641b74ca8733f0cf75d7bb2b604444d33bb",
22
- "size": 98818787
21
+ "checksum": "b2a050e9a9fc570ac0334cbad4dc7c46091b97a3a71bdeffdec83c91530aef84",
22
+ "size": 98760451
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "0b6291903c4dde17f456c8a8799a3101877321bd667aa78e793dc1fe0709893c",
28
- "size": 102741700
27
+ "checksum": "863ee1d2a91a39ee22fa13322582e4c3fb45bfb4739b22ec7e396dde694d8581",
28
+ "size": 102731812
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "d0c00b80761f3030f34cf0812266f6c6f8210ff9af7242f7c6c76c5600499caf",
33
- "size": 103729711
32
+ "checksum": "6fb9e329947c003740be888f98db1aecaa238d6c7d9ceef8581eb71d5a59480b",
33
+ "size": 103703105
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "95f37a2808a40596f1fcc005f64eaaf7975d6a46c365876845d0909714c5a91b",
38
- "size": 101084046
37
+ "checksum": "5e8714a8944f6771325a8b2bd641bcdca7bcc632d60b4b965f8c716db989a6cc",
38
+ "size": 101059126
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "edae71d077ea4f4c413981968cb864d3b7ab8a6010fec1dc309d7e7ba403bfec",
43
- "size": 102122872
42
+ "checksum": "122b51ddadc68c6afc8deb4d7bda82fcb5e1d49e5994c3eed750a5d6428ab6a4",
43
+ "size": 102078647
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "f2966586f6f936a48b7025a8eb0604e0a1a241e4b5ea877db34e6443b10d6989",
48
- "size": 106965057
47
+ "checksum": "c5e376352bf2b0e56592358ba3b2943d3de7b351f750c2340f0675fe88148038",
48
+ "size": 106918151
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "99648d7d1d66ff68f5238cbf59422e3db422e117863ecf02e13c4cea99179165",
53
- "size": 102170242
52
+ "checksum": "dc3fd34fc9d523e6a94702e051998db52afd1d647132f61fd3daa246022ffcf9",
53
+ "size": 102110572
54
54
  }
55
55
  },
56
56
  "sdkCompat": {
57
57
  "testedWrapperVersions": [
58
- "0.3.278",
59
58
  "0.3.280",
60
59
  "0.3.281",
61
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.311",
3
+ "version": "0.3.312",
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.311",
65
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.311",
66
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.311",
67
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.311",
68
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.311",
69
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.311",
70
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.311",
71
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.311"
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-0bjz4v5z.mjs",
89
- "core-ptjgnrch.mjs",
90
- "core-rbkmqzx3.mjs",
91
- "core-zbftdwza.mjs"
88
+ "core-azmey26z.mjs",
89
+ "core-jhgm58v5.mjs",
90
+ "core-qw4t51gr.mjs",
91
+ "core-x7q9bdvq.mjs"
92
92
  ],
93
- "claudeCodeVersion": "2.1.311"
93
+ "claudeCodeVersion": "2.1.312"
94
94
  }
package/sdk-tools.d.ts CHANGED
@@ -3978,6 +3978,10 @@ export interface AskUserQuestionOutput {
3978
3978
  * Free-text notes the user added to their selection.
3979
3979
  */
3980
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";
3981
3985
  };
3982
3986
  };
3983
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;
@@ -2845,9 +2851,9 @@ export declare type PreToolUseHookSpecificOutput = {
2845
2851
  *
2846
2852
  * What a claim can set ({@link ClaimOptions}): `cwd`, `additionalDirectories`,
2847
2853
  * `model`, `permissionMode`, `maxThinkingTokens`, a flag-settings overlay
2848
- * (`settings`, e.g. effort or permission rules — but not hook settings, which
2849
- * would land after the claimed folder's SessionStart hooks have started; those
2850
- * 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
2851
2857
  * three environment variables (`CLAUDE_CODE_OAUTH_TOKEN`,
2852
2858
  * `CLAUDE_CODE_SESSION_ACCESS_TOKEN`, `CLAUDE_CODE_HOST_SESSION_ID`). Everything
2853
2859
  * else — the executable, `settingSources`, `env` the process reads at
@@ -5074,6 +5080,7 @@ declare type SDKControlPermissionRequest = {
5074
5080
 
5075
5081
 
5076
5082
 
5083
+
5077
5084
  };
5078
5085
 
5079
5086
  /**
@@ -6032,6 +6039,9 @@ export declare type SDKResultSuccess = {
6032
6039
 
6033
6040
 
6034
6041
 
6042
+
6043
+
6044
+
6035
6045
 
6036
6046
 
6037
6047
 
@@ -6268,7 +6278,7 @@ export declare type SDKSystemMessage = {
6268
6278
  fast_mode_disabled_reason?: FastModeDisabledReason;
6269
6279
 
6270
6280
  /**
6271
- * 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.
6272
6282
  */
6273
6283
  effort?: ('low' | 'medium' | 'high' | 'xhigh' | 'max') | null;
6274
6284
 
@@ -6277,7 +6287,7 @@ export declare type SDKSystemMessage = {
6277
6287
  */
6278
6288
  view_mode?: 'focus' | 'default';
6279
6289
  /**
6280
- * 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.
6281
6291
  */
6282
6292
  capabilities?: string[];
6283
6293
 
@@ -7166,6 +7176,10 @@ export declare interface Settings {
7166
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.
7167
7177
  */
7168
7178
  blockReadsOutsideWorkingDirectories?: boolean;
7179
+ /**
7180
+ * Disable auto mode
7181
+ */
7182
+ disableAutoMode?: 'disable';
7169
7183
  /**
7170
7184
  * Additional directories to include in the permission scope
7171
7185
  */
@@ -9041,7 +9055,7 @@ export declare interface Settings {
9041
9055
  */
9042
9056
  allowLocalBinding?: boolean;
9043
9057
  /**
9044
- * 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.
9045
9059
  */
9046
9060
  allowMachLookup?: string[];
9047
9061
  /**
@@ -9675,6 +9689,39 @@ export declare interface Settings {
9675
9689
  * Allow Claude to push proactive mobile notifications
9676
9690
  */
9677
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
+ };
9678
9725
  /**
9679
9726
  * Prevent claude-cli:// protocol handler registration with the OS
9680
9727
  */
@@ -9764,12 +9811,12 @@ export declare interface SpareProcess extends AsyncDisposable {
9764
9811
  * agents, commands and output styles, the claimed permission mode — as they
9765
9812
  * would after a cold `query()` in that folder (the folder's `availableModels`
9766
9813
  * narrows the model list as it does there). One limit: that snapshot is
9767
- * taken as part of the claim, before `model` and `settings` are applied, so
9768
- * 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
9769
9816
  * `fast_mode_state`, `output_style`, the remote-control defaults, an
9770
9817
  * `availableModels` in the overlay) may not reflect them yet. After a refused claim the reads
9771
- * keep describing the parked process; after `option_not_applied` or
9772
- * `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
9773
9820
  * session.
9774
9821
  *
9775
9822
  * @throws when called a second time, when the spare was closed or has
@@ -9793,10 +9840,12 @@ export declare interface SpareProcess extends AsyncDisposable {
9793
9840
  * when the spare exited or was closed before a claim (`spare_exited` /
9794
9841
  * `spare_closed`), or when the `settings` overlay was refused
9795
9842
  * (`settings_not_applied: …`; the prompt was never sent and the process
9796
- * 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
9797
9844
  * after which it does run is `option_not_applied: …`: `model` or
9798
9845
  * `maxThinkingTokens` was not accepted and the session runs without it.
9799
- * 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.
9800
9849
  * `permissionMode` is part of the claim itself and fails closed: see
9801
9850
  * {@link ClaimOptions}.
9802
9851
  */
@@ -10210,12 +10259,12 @@ export declare const USAGE_LIMIT_ERROR_PREFIXES: readonly ["You've hit your", "Y
10210
10259
  *
10211
10260
  * @alpha
10212
10261
  */
10213
- 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'];
10214
10263
 
10215
10264
  /**
10216
10265
  * Approaching-limit warnings (severity:'warning'). Footer/toast only; these
10217
- * never arrive as API errors. ("Approaching …" early warnings are
10218
- * 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
10219
10268
  * <RateLimitMessage> styling; see the generator-coverage tests.)
10220
10269
  *
10221
10270
  * @alpha