@anthropic-ai/claude-agent-sdk 0.3.198 → 0.3.200

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,47 +1,47 @@
1
1
  {
2
- "version": "2.1.198",
3
- "commit": "b80c496480ebf28e6dfe755cf0b8e3dd1d7cba1f",
4
- "buildDate": "2026-07-01T06:17:25Z",
2
+ "version": "2.1.200",
3
+ "commit": "ac4f1e473e794cd41c8b6b2a2a991c0f57dcc1e2",
4
+ "buildDate": "2026-07-03T03:51:04Z",
5
5
  "platforms": {
6
6
  "darwin-arm64": {
7
7
  "binary": "claude",
8
- "checksum": "ab6f7ee109816ede414f7c285446633f805b623aa609f425609a64266451d61e",
9
- "size": 229328464
8
+ "checksum": "e6fd52c0c72ff83663bf3cbfc833b45faaba2b9a9952863279dc3cfc1a0492b6",
9
+ "size": 231708784
10
10
  },
11
11
  "darwin-x64": {
12
12
  "binary": "claude",
13
- "checksum": "280b6cfc60dacc4caed31af1249e53c259c01759556e60633944c02405c82dd0",
14
- "size": 238706000
13
+ "checksum": "b0a4dd56a91b24e18c9f83b50a7f19989ecbaba3d2ae4bf6f3f95f4033a87371",
14
+ "size": 241100240
15
15
  },
16
16
  "linux-arm64": {
17
17
  "binary": "claude",
18
- "checksum": "99b50a6f2b1f3ef07bcaf1e58a2f9883c470c84e428afa321972b1aa20372e9a",
19
- "size": 245742320
18
+ "checksum": "434ab85cd215ef7d5cd7afc1d02c0a95c0521357d8819f70ca77b6b4b1c5273d",
19
+ "size": 248101616
20
20
  },
21
21
  "linux-x64": {
22
22
  "binary": "claude",
23
- "checksum": "7066af42a5fe93038c13af5072d4c034dc3928092cb121fdd892c76b94b6b84d",
24
- "size": 248900408
23
+ "checksum": "26e42a3268979f0c5a3b6c0f375b15dd7decfaae4bb02774390d6a23f4cd51ad",
24
+ "size": 251300664
25
25
  },
26
26
  "linux-arm64-musl": {
27
27
  "binary": "claude",
28
- "checksum": "88cb391085e419457569bcc57a672f734f30b424e17df7323f3bbb421238e801",
29
- "size": 238990520
28
+ "checksum": "b47ec4c6f9b6b1e5987f333e28b01a949c9a8c1198f47be336bab2507a772fd6",
29
+ "size": 241349816
30
30
  },
31
31
  "linux-x64-musl": {
32
32
  "binary": "claude",
33
- "checksum": "42892159a03bee492926b616b1270313544f7a52b68d32cb680e91984a4c6659",
34
- "size": 243589504
33
+ "checksum": "c461c6251cd2f6ebe4dc4c5f0823a404f1722b7dc7ccb0937ce7bc6e5dc5866f",
34
+ "size": 245985664
35
35
  },
36
36
  "win32-x64": {
37
37
  "binary": "claude.exe",
38
- "checksum": "6afd07cb03aa981c5e918808f53a1e2b729015b695122a944f6e41aaf5393933",
39
- "size": 239292064
38
+ "checksum": "575a3d2b88d1a4a8df3ee71aaabdc7074f72ab1d22371caa6e61656bbee5c995",
39
+ "size": 241591968
40
40
  },
41
41
  "win32-arm64": {
42
42
  "binary": "claude.exe",
43
- "checksum": "10a6d21332f674c87f52b1dc09926945d0169f1bb82aced84ada100639ab70bc",
44
- "size": 233758880
43
+ "checksum": "a97e4f76ec7480cb534f7cdb990b2e26321882a779efaa51536f72f09c435da9",
44
+ "size": 236058784
45
45
  }
46
46
  }
47
47
  }
package/manifest.zst.json CHANGED
@@ -1,55 +1,55 @@
1
1
  {
2
- "version": "2.1.198",
3
- "commit": "b80c496480ebf28e6dfe755cf0b8e3dd1d7cba1f",
4
- "buildDate": "2026-07-01T06:19:10Z",
2
+ "version": "2.1.200",
3
+ "commit": "ac4f1e473e794cd41c8b6b2a2a991c0f57dcc1e2",
4
+ "buildDate": "2026-07-03T03:52:50Z",
5
5
  "platforms": {
6
6
  "darwin-arm64": {
7
7
  "binary": "claude.zst",
8
- "checksum": "7bc5ee873344f53ca0ea0d7ae48c77c3787aa8f437d5aeb33a6a6d83ab8d813f",
9
- "size": 47036104,
8
+ "checksum": "1da7ad1b3a7be70975d8360031b5477b106bbe4dfc2feeb8e1d48f164bc9a18e",
9
+ "size": 47426979,
10
10
  "bundle": {
11
- "checksum": "e84cec46ebd581937b5128e7be4f3e8788b13947bf4040a699d3404478f4bc57",
12
- "size": 47034441
11
+ "checksum": "5a11aa187f68623998c32458022abca9e861835e1055e9b6ba970a20b9e7beaa",
12
+ "size": 47424141
13
13
  }
14
14
  },
15
15
  "darwin-x64": {
16
16
  "binary": "claude.zst",
17
- "checksum": "b70b7a3d9f3fdb675e119bca0c1632d810aacdefadee1da5e82ebb77cbabd124",
18
- "size": 51377668,
17
+ "checksum": "f00c668c751026622356e4538dfe1c2e82bb805ea2897dc4b1417e09231ee24d",
18
+ "size": 51787215,
19
19
  "bundle": {
20
- "checksum": "c8eb65cce724f80d4467c9850e0643cbab91e1d66fa88b21ea17f398c7835d50",
21
- "size": 51390885
20
+ "checksum": "f0110970ba1b72f8a99b178012cba729ce2ba7e45562809ea01fa09736a7eb28",
21
+ "size": 51792780
22
22
  }
23
23
  },
24
24
  "linux-arm64": {
25
25
  "binary": "claude.zst",
26
- "checksum": "4d9f42ab338ead6a6e9b9738a6d1ec7ba9a0737acbc8cf7f09099172b6ff16d7",
27
- "size": 56120743
26
+ "checksum": "e78ce96b7e249b6aea461c9fe34d40f0cd87ca0573bbe63510ab8dd37c69fdf6",
27
+ "size": 56534877
28
28
  },
29
29
  "linux-x64": {
30
30
  "binary": "claude.zst",
31
- "checksum": "dc7986a7fad5958bfe4bf9eaf14936da2bafb283de7b80ca3e2e1878620873fe",
32
- "size": 57376892
31
+ "checksum": "aa54a5ed5888911c3316197b5bab96187eb09335076e3afef6d4c70facf27e98",
32
+ "size": 57790527
33
33
  },
34
34
  "linux-arm64-musl": {
35
35
  "binary": "claude.zst",
36
- "checksum": "55c5691e89c947a04777a7e2711c7bfe1589cf1783ff47ae25ad277bef9f4aeb",
37
- "size": 54805858
36
+ "checksum": "9580ea92b0176047258a018d7288b3ce2541848dc1c8481cc038bf6b2c369f55",
37
+ "size": 55212819
38
38
  },
39
39
  "linux-x64-musl": {
40
40
  "binary": "claude.zst",
41
- "checksum": "d0eecbaa59489d9282fbfccabf010feadb3c212e6a40b7e3e112d1c07c6cf300",
42
- "size": 56180603
41
+ "checksum": "ceb7cfd3cd93cbc759d71f2d6f59ffd0a3fd8a6defd8730e84cfa7d0e3e6b30e",
42
+ "size": 56594084
43
43
  },
44
44
  "win32-x64": {
45
45
  "binary": "claude.exe.zst",
46
- "checksum": "f9ce31065214cba9a1838b4eafd00f004002389a1ee87c45ca00d901fbc03129",
47
- "size": 57521925
46
+ "checksum": "29da768777633fd390b93c948d9104cb6a034c76aa7f039182d5e56ae947bbda",
47
+ "size": 57917911
48
48
  },
49
49
  "win32-arm64": {
50
50
  "binary": "claude.exe.zst",
51
- "checksum": "f4c7b7c80da3f07dea7d13530eeea321db4380a9da4bc1a1010c13e7e8ea6736",
52
- "size": 55546586
51
+ "checksum": "65b793dd65af500cff48844054222d578a4709a71af34b4f51e665c264d177b6",
52
+ "size": 55956930
53
53
  }
54
54
  }
55
55
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.198",
3
+ "version": "0.3.200",
4
4
  "main": "sdk.mjs",
5
5
  "types": "sdk.d.ts",
6
6
  "exports": {
@@ -57,14 +57,14 @@
57
57
  "zod": "^4.0.0"
58
58
  },
59
59
  "optionalDependencies": {
60
- "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.198",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.198",
62
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.198",
63
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.198",
64
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.198",
65
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.198",
66
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.198",
67
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.198"
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.200",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.200",
62
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.200",
63
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.200",
64
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.200",
65
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.200",
66
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.200",
67
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.200"
68
68
  },
69
69
  "files": [
70
70
  "sdk.mjs",
@@ -80,5 +80,5 @@
80
80
  "manifest.json",
81
81
  "manifest.zst.json"
82
82
  ],
83
- "claudeCodeVersion": "2.1.198"
83
+ "claudeCodeVersion": "2.1.200"
84
84
  }
package/sdk-tools.d.ts CHANGED
@@ -29,6 +29,7 @@ export type ToolInputSchemas =
29
29
  | WebFetchInput
30
30
  | WebSearchInput
31
31
  | AskUserQuestionInput
32
+ | ClaudeDesignInput
32
33
  | ProjectsInput
33
34
  | EnterPlanModeInput
34
35
  | TaskCreateInput
@@ -87,6 +88,7 @@ export type ToolOutputSchemas =
87
88
  | CronDeleteOutput
88
89
  | CronListOutput
89
90
  | PushNotificationOutput
91
+ | ClaudeDesignOutput
90
92
  | ProjectsOutput;
91
93
  export type AgentOutput =
92
94
  | {
@@ -304,6 +306,10 @@ export type FileReadOutput =
304
306
  */
305
307
  filePath: string;
306
308
  };
309
+ /**
310
+ * Set when the dedup matched a startup-seeded entry (CLAUDE.md / nested memory) rather than a prior Read tool_result
311
+ */
312
+ source?: "seeded";
307
313
  };
308
314
  export type ListMcpResourcesOutput = {
309
315
  /**
@@ -364,9 +370,6 @@ export type ProjectsOutput =
364
370
  knowledge: {
365
371
  knowledge_size: number;
366
372
  max_knowledge_size: number;
367
- search_threshold: number | null;
368
- rag_active: boolean;
369
- remaining_budget: number | null;
370
373
  };
371
374
  }
372
375
  | {
@@ -395,13 +398,7 @@ export type ProjectsOutput =
395
398
  path: string;
396
399
  doc_uuid: string;
397
400
  replaced: boolean;
398
- knowledge: {
399
- knowledge_size: number;
400
- max_knowledge_size: number;
401
- search_threshold: number | null;
402
- rag_active: boolean;
403
- remaining_budget: number | null;
404
- };
401
+ present_to_user?: boolean;
405
402
  }
406
403
  | {
407
404
  method: "project_delete";
@@ -716,6 +713,10 @@ export interface ReportFindingsInput {
716
713
  * Concrete inputs/state → wrong output/crash
717
714
  */
718
715
  failure_scenario: string;
716
+ /**
717
+ * Short kebab-case slug of the finding type, e.g. "correctness", "simplification", "efficiency", "test-coverage"
718
+ */
719
+ category?: string;
719
720
  /**
720
721
  * Set when a verify pass ran; absent on inline-only reviews
721
722
  */
@@ -2337,6 +2338,18 @@ export interface AskUserQuestionInput {
2337
2338
  source?: string;
2338
2339
  };
2339
2340
  }
2341
+ export interface ClaudeDesignInput {
2342
+ /**
2343
+ * Claude Design action to perform. Call with "list" first to discover the available operations and their argument schemas.
2344
+ */
2345
+ operation: string;
2346
+ /**
2347
+ * Action input object (server-validated). Pass {} for operations that take no input.
2348
+ */
2349
+ arguments: {
2350
+ [k: string]: unknown;
2351
+ };
2352
+ }
2340
2353
  export interface ProjectsInput {
2341
2354
  method: "project_info" | "project_read" | "project_search" | "project_write" | "project_delete";
2342
2355
  /**
@@ -2352,9 +2365,9 @@ export interface ProjectsInput {
2352
2365
  */
2353
2366
  local_path?: string;
2354
2367
  /**
2355
- * project_write: bypass the chat-injection budget guard. Set only when the write is genuinely worth degrading chat to retrieval mode for everyone in the project.
2368
+ * project_write: true marks this doc as the file the user needs to see the deliverable they asked for or must act on. Defaults to false; leave it unset for routine saves, notes, and bulk writes.
2356
2369
  */
2357
- force?: boolean;
2370
+ present_to_user?: boolean;
2358
2371
  /**
2359
2372
  * project_search: knowledge-base query
2360
2373
  */
@@ -2992,6 +3005,10 @@ export interface ReportFindingsOutput {
2992
3005
  * Concrete inputs/state → wrong output/crash
2993
3006
  */
2994
3007
  failure_scenario: string;
3008
+ /**
3009
+ * Short kebab-case slug of the finding type, e.g. "correctness", "simplification", "efficiency", "test-coverage"
3010
+ */
3011
+ category?: string;
2995
3012
  /**
2996
3013
  * Set when a verify pass ran; absent on inline-only reviews
2997
3014
  */
@@ -3484,10 +3501,15 @@ export interface PushNotificationOutput {
3484
3501
  pushSent?: boolean;
3485
3502
  localSent?: boolean;
3486
3503
  disabledReason?: "config_off" | "user_present" | "no_transport";
3487
- idleSec?: number;
3488
- hasFocus?: boolean;
3489
3504
  /**
3490
3505
  * ISO timestamp captured at tool execution on the emitting process. Optional — resumed sessions replay pre-sentAt outputs verbatim.
3491
3506
  */
3492
3507
  sentAt?: string;
3493
3508
  }
3509
+ export interface ClaudeDesignOutput {
3510
+ operation: string;
3511
+ content: {
3512
+ [k: string]: unknown;
3513
+ }[];
3514
+ isError?: boolean;
3515
+ }
package/sdk.d.ts CHANGED
@@ -89,6 +89,14 @@ export declare type AgentDefinition = {
89
89
  * Permission mode controlling how tool executions are handled
90
90
  */
91
91
  permissionMode?: PermissionMode;
92
+ /**
93
+ * Agent type auto-spawned as a background observer whenever this agent runs. The observer receives read-only activity digests and reports via the ObserverReport tool; it never participates in the task.
94
+ */
95
+ observer?: string;
96
+ /**
97
+ * Supplemental postamble appended (after the harness-owned default) to each activity digest sent to the observer. Blank values are ignored.
98
+ */
99
+ observerMessage?: string;
92
100
  };
93
101
 
94
102
  /**
@@ -188,6 +196,12 @@ export declare type BaseOutputFormat = {
188
196
  /**
189
197
  * Permission callback function for controlling tool usage.
190
198
  * Called before each tool execution to determine if it should be allowed.
199
+ *
200
+ * Return `null` ONLY after the consumer has already sent the
201
+ * control_response out-of-band (e.g. a signed HTTP POST echoing
202
+ * `requestId`); the SDK will skip its own transport write. Fail-closed: an
203
+ * accidental null means no control_response is sent and the tool stays
204
+ * blocked indefinitely — permission prompts have no park deadline.
191
205
  */
192
206
  export declare type CanUseTool = (toolName: string, input: Record<string, unknown>, options: {
193
207
  /** Signaled if the operation should be aborted. */
@@ -231,7 +245,13 @@ export declare type CanUseTool = (toolName: string, input: Record<string, unknow
231
245
  toolUseID: string;
232
246
  /** If running within the context of a sub-agent, the sub-agent's ID. */
233
247
  agentID?: string;
234
- }) => Promise<PermissionResult>;
248
+ /**
249
+ * The control_request envelope's `request_id`. A control_response sent
250
+ * out-of-band (e.g. a signed HTTP POST instead of the SDK's WS write)
251
+ * must echo this value for the worker to match it.
252
+ */
253
+ requestId: string;
254
+ }) => Promise<PermissionResult | null>;
235
255
 
236
256
  export declare type ConfigChangeHookInput = BaseHookInput & {
237
257
  hook_event_name: 'ConfigChange';
@@ -2240,6 +2260,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2240
2260
  setMcpPermissionModeOverride(serverName: string, mode: 'default' | 'auto' | null): Promise<{
2241
2261
  warning?: string;
2242
2262
  }>;
2263
+
2243
2264
  /**
2244
2265
  * Change the model used for subsequent responses.
2245
2266
  * Only available in streaming input mode.
@@ -2421,6 +2442,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2421
2442
 
2422
2443
 
2423
2444
 
2445
+
2424
2446
  /**
2425
2447
  * Reconnect an MCP server by name.
2426
2448
  * Throws on failure.
@@ -2617,8 +2639,13 @@ declare const SandboxCredentialsConfigSchema: () => z.ZodOptional<z.ZodObject<{
2617
2639
  }, z.core.$strip>>>;
2618
2640
  envVars: z.ZodOptional<z.ZodArray<z.ZodObject<{
2619
2641
  name: z.ZodString;
2620
- mode: z.ZodLiteral<"deny">;
2642
+ mode: z.ZodEnum<{
2643
+ deny: "deny";
2644
+ mask: "mask";
2645
+ }>;
2646
+ injectHosts: z.ZodOptional<z.ZodArray<z.ZodString>>;
2621
2647
  }, z.core.$strip>>>;
2648
+ allowPlaintextInject: z.ZodOptional<z.ZodBoolean>;
2622
2649
  }, z.core.$strip>>;
2623
2650
 
2624
2651
  export declare type SandboxFilesystemConfig = NonNullable<z.infer<ReturnType<typeof SandboxFilesystemConfigSchema>>>;
@@ -2696,8 +2723,13 @@ declare const SandboxSettingsSchema: () => z.ZodObject<{
2696
2723
  }, z.core.$strip>>>;
2697
2724
  envVars: z.ZodOptional<z.ZodArray<z.ZodObject<{
2698
2725
  name: z.ZodString;
2699
- mode: z.ZodLiteral<"deny">;
2726
+ mode: z.ZodEnum<{
2727
+ deny: "deny";
2728
+ mask: "mask";
2729
+ }>;
2730
+ injectHosts: z.ZodOptional<z.ZodArray<z.ZodString>>;
2700
2731
  }, z.core.$strip>>>;
2732
+ allowPlaintextInject: z.ZodOptional<z.ZodBoolean>;
2701
2733
  }, z.core.$strip>>;
2702
2734
  ignoreViolations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
2703
2735
  enableWeakerNestedSandbox: z.ZodOptional<z.ZodBoolean>;
@@ -3387,6 +3419,10 @@ declare type SDKControlPermissionRequest = {
3387
3419
  tool_use_id: string;
3388
3420
  agent_id?: string;
3389
3421
  description?: string;
3422
+ /**
3423
+ * True when the tool's approval card IS the user-interaction surface (Tool.requiresUserInteraction()). SDK hosts must not offer one-tap Approve/Deny for these — the user has to open the session and respond on the card itself.
3424
+ */
3425
+ requires_user_interaction?: boolean;
3390
3426
  };
3391
3427
 
3392
3428
  /**
@@ -3476,7 +3512,7 @@ export declare type SDKControlRequest = {
3476
3512
  request: SDKControlRequestInner;
3477
3513
  };
3478
3514
 
3479
- declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlListModelsRequest | SDKControlGetUsageRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlGetWorkspaceDiffRequest | SDKControlGetPlanRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlRegisterRepoRootRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlSetMcpPermissionModeOverrideRequest | SDKControlRewindConversationRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlStageFileRequest | SDKControlAddDirectoryRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlHostAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
3515
+ declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlListModelsRequest | SDKControlGetUsageRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlGetWorkspaceDiffRequest | SDKControlGetPlanRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlRegisterRepoRootRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlSetMcpPermissionModeOverrideRequest | SDKControlRewindConversationRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlStageFileRequest | SDKControlAddDirectoryRequest | SDKControlSetCwdRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlHostAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
3480
3516
 
3481
3517
  /**
3482
3518
  * Requests the SDK consumer to render a tool-driven blocking dialog and return the user choice. Used by tools that previously rendered Ink JSX via setToolJSX with an onDone callback.
@@ -3756,8 +3792,14 @@ export declare type SDKMessageOrigin = {
3756
3792
  kind: 'task-notification';
3757
3793
  } | {
3758
3794
  kind: 'coordinator';
3795
+ } | {
3796
+ kind: 'observer';
3797
+ from: string;
3798
+ senderTaskId: string;
3759
3799
  } | {
3760
3800
  kind: 'auto-continuation';
3801
+ } | {
3802
+ kind: 'observer-activity';
3761
3803
  };
3762
3804
 
3763
3805
  /**
@@ -4701,7 +4743,7 @@ export declare interface Settings {
4701
4743
  */
4702
4744
  ask?: string[];
4703
4745
  /**
4704
- * Default permission mode when Claude Code needs access
4746
+ * Default permission mode when Claude Code needs access ('manual' is accepted as an alias for 'default')
4705
4747
  */
4706
4748
  defaultMode?: 'acceptEdits' | 'auto' | 'bypassPermissions' | 'default' | 'dontAsk' | 'plan';
4707
4749
  /**
@@ -5813,7 +5855,7 @@ export declare interface Settings {
5813
5855
  httpProxyPort?: number;
5814
5856
  socksProxyPort?: number;
5815
5857
  /**
5816
- * [EXPERIMENTAL] Enable in-process TLS termination so the per-request filter can see HTTPS request bodies. Provide a CA cert+key, or omit both to have sandbox-runtime generate an ephemeral one for the session.
5858
+ * [EXPERIMENTAL] Enable in-process TLS termination so the per-request filter can see HTTPS request bodies. Provide a CA cert+key, or omit both to have sandbox-runtime generate an ephemeral one for the session. Only honored from user, managed/policy, or CLI (`--settings`) settings — project settings (.claude/settings.json and .claude/settings.local.json) are ignored.
5817
5859
  */
5818
5860
  tlsTerminate?: {
5819
5861
  caCertPath?: string;
@@ -5857,7 +5899,7 @@ export declare interface Settings {
5857
5899
  mode: 'deny';
5858
5900
  }[];
5859
5901
  /**
5860
- * Environment variables to protect. `deny` unsets the variable for sandboxed commands.
5902
+ * Environment variables to protect. `deny` unsets the variable for sandboxed commands; `mask` substitutes a sentinel inside the sandbox and injects the real value at the proxy.
5861
5903
  */
5862
5904
  envVars?: {
5863
5905
  /**
@@ -5865,10 +5907,18 @@ export declare interface Settings {
5865
5907
  */
5866
5908
  name: string;
5867
5909
  /**
5868
- * Access mode for this environment variable. Only `deny` is supported.
5910
+ * Access mode for this environment variable. `deny` unsets the variable for sandboxed commands; `mask` shows sandboxed commands a sentinel value and the host proxy swaps sentinel→real on egress to `injectHosts`.
5869
5911
  */
5870
- mode: 'deny';
5912
+ mode: 'deny' | 'mask';
5913
+ /**
5914
+ * Optional narrowing of where the proxy substitutes this credential. Only meaningful when mode is `mask`; accepted but ignored for `deny`. If unset, defaults to `network.allowedDomains` — the credential is injected at every reachable host. Each entry must be reachable via `network.allowedDomains` (sandbox-runtime validates this).
5915
+ */
5916
+ injectHosts?: string[];
5871
5917
  }[];
5918
+ /**
5919
+ * Allow sentinel→real substitution on the plain-HTTP proxy path. Defaults to false: without TLS termination the upstream identity is unverified and the credential travels in cleartext. Set only for trusted-network test fixtures. Only honored from user, managed/policy, or CLI (`--settings`) settings — project settings (.claude/settings.json and .claude/settings.local.json) are ignored.
5920
+ */
5921
+ allowPlaintextInject?: boolean;
5872
5922
  };
5873
5923
  ignoreViolations?: {
5874
5924
  [k: string]: string[];
@@ -5967,6 +6017,10 @@ export declare interface Settings {
5967
6017
  * When true, the plan-approval dialog offers a "clear context" option. Defaults to false.
5968
6018
  */
5969
6019
  showClearContextOnPlanAccept?: boolean;
6020
+ /**
6021
+ * Idle time before Claude's questions auto-continue with any answers selected so far. Defaults to never — auto-continue only runs when explicitly set to 60s/5m/10m.
6022
+ */
6023
+ askUserQuestionTimeout?: '60s' | '5m' | '10m' | 'never';
5970
6024
  /**
5971
6025
  * Name of an agent (built-in or custom) to use for the main thread. Applies the agent's system prompt, tool restrictions, and model.
5972
6026
  */
@@ -6577,6 +6631,13 @@ export declare interface Transport {
6577
6631
  * Each transport handles its own protocol and error checking
6578
6632
  */
6579
6633
  readMessages(): AsyncGenerator<StdoutMessage, void, unknown>;
6634
+ /**
6635
+ * Register a request_id whose control_response the caller will await
6636
+ * out-of-band via Query.awaitControlResponse. Transports that see
6637
+ * per-frame source (multi-client fan-out) SHOULD drop non-worker
6638
+ * control_responses matching this id — only the worker may answer.
6639
+ */
6640
+ expectControlResponse?(requestId: string): void;
6580
6641
  /**
6581
6642
  * End the input stream
6582
6643
  */