@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/bridge.mjs +95 -102
- package/browser-sdk.js +39 -42
- package/manifest.json +19 -19
- package/manifest.zst.json +23 -23
- package/package.json +10 -10
- package/sdk-tools.d.ts +36 -14
- package/sdk.d.ts +70 -9
- package/sdk.mjs +49 -49
package/manifest.json
CHANGED
|
@@ -1,47 +1,47 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.1.
|
|
3
|
-
"commit": "
|
|
4
|
-
"buildDate": "2026-07-
|
|
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": "
|
|
9
|
-
"size":
|
|
8
|
+
"checksum": "e6fd52c0c72ff83663bf3cbfc833b45faaba2b9a9952863279dc3cfc1a0492b6",
|
|
9
|
+
"size": 231708784
|
|
10
10
|
},
|
|
11
11
|
"darwin-x64": {
|
|
12
12
|
"binary": "claude",
|
|
13
|
-
"checksum": "
|
|
14
|
-
"size":
|
|
13
|
+
"checksum": "b0a4dd56a91b24e18c9f83b50a7f19989ecbaba3d2ae4bf6f3f95f4033a87371",
|
|
14
|
+
"size": 241100240
|
|
15
15
|
},
|
|
16
16
|
"linux-arm64": {
|
|
17
17
|
"binary": "claude",
|
|
18
|
-
"checksum": "
|
|
19
|
-
"size":
|
|
18
|
+
"checksum": "434ab85cd215ef7d5cd7afc1d02c0a95c0521357d8819f70ca77b6b4b1c5273d",
|
|
19
|
+
"size": 248101616
|
|
20
20
|
},
|
|
21
21
|
"linux-x64": {
|
|
22
22
|
"binary": "claude",
|
|
23
|
-
"checksum": "
|
|
24
|
-
"size":
|
|
23
|
+
"checksum": "26e42a3268979f0c5a3b6c0f375b15dd7decfaae4bb02774390d6a23f4cd51ad",
|
|
24
|
+
"size": 251300664
|
|
25
25
|
},
|
|
26
26
|
"linux-arm64-musl": {
|
|
27
27
|
"binary": "claude",
|
|
28
|
-
"checksum": "
|
|
29
|
-
"size":
|
|
28
|
+
"checksum": "b47ec4c6f9b6b1e5987f333e28b01a949c9a8c1198f47be336bab2507a772fd6",
|
|
29
|
+
"size": 241349816
|
|
30
30
|
},
|
|
31
31
|
"linux-x64-musl": {
|
|
32
32
|
"binary": "claude",
|
|
33
|
-
"checksum": "
|
|
34
|
-
"size":
|
|
33
|
+
"checksum": "c461c6251cd2f6ebe4dc4c5f0823a404f1722b7dc7ccb0937ce7bc6e5dc5866f",
|
|
34
|
+
"size": 245985664
|
|
35
35
|
},
|
|
36
36
|
"win32-x64": {
|
|
37
37
|
"binary": "claude.exe",
|
|
38
|
-
"checksum": "
|
|
39
|
-
"size":
|
|
38
|
+
"checksum": "575a3d2b88d1a4a8df3ee71aaabdc7074f72ab1d22371caa6e61656bbee5c995",
|
|
39
|
+
"size": 241591968
|
|
40
40
|
},
|
|
41
41
|
"win32-arm64": {
|
|
42
42
|
"binary": "claude.exe",
|
|
43
|
-
"checksum": "
|
|
44
|
-
"size":
|
|
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.
|
|
3
|
-
"commit": "
|
|
4
|
-
"buildDate": "2026-07-
|
|
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": "
|
|
9
|
-
"size":
|
|
8
|
+
"checksum": "1da7ad1b3a7be70975d8360031b5477b106bbe4dfc2feeb8e1d48f164bc9a18e",
|
|
9
|
+
"size": 47426979,
|
|
10
10
|
"bundle": {
|
|
11
|
-
"checksum": "
|
|
12
|
-
"size":
|
|
11
|
+
"checksum": "5a11aa187f68623998c32458022abca9e861835e1055e9b6ba970a20b9e7beaa",
|
|
12
|
+
"size": 47424141
|
|
13
13
|
}
|
|
14
14
|
},
|
|
15
15
|
"darwin-x64": {
|
|
16
16
|
"binary": "claude.zst",
|
|
17
|
-
"checksum": "
|
|
18
|
-
"size":
|
|
17
|
+
"checksum": "f00c668c751026622356e4538dfe1c2e82bb805ea2897dc4b1417e09231ee24d",
|
|
18
|
+
"size": 51787215,
|
|
19
19
|
"bundle": {
|
|
20
|
-
"checksum": "
|
|
21
|
-
"size":
|
|
20
|
+
"checksum": "f0110970ba1b72f8a99b178012cba729ce2ba7e45562809ea01fa09736a7eb28",
|
|
21
|
+
"size": 51792780
|
|
22
22
|
}
|
|
23
23
|
},
|
|
24
24
|
"linux-arm64": {
|
|
25
25
|
"binary": "claude.zst",
|
|
26
|
-
"checksum": "
|
|
27
|
-
"size":
|
|
26
|
+
"checksum": "e78ce96b7e249b6aea461c9fe34d40f0cd87ca0573bbe63510ab8dd37c69fdf6",
|
|
27
|
+
"size": 56534877
|
|
28
28
|
},
|
|
29
29
|
"linux-x64": {
|
|
30
30
|
"binary": "claude.zst",
|
|
31
|
-
"checksum": "
|
|
32
|
-
"size":
|
|
31
|
+
"checksum": "aa54a5ed5888911c3316197b5bab96187eb09335076e3afef6d4c70facf27e98",
|
|
32
|
+
"size": 57790527
|
|
33
33
|
},
|
|
34
34
|
"linux-arm64-musl": {
|
|
35
35
|
"binary": "claude.zst",
|
|
36
|
-
"checksum": "
|
|
37
|
-
"size":
|
|
36
|
+
"checksum": "9580ea92b0176047258a018d7288b3ce2541848dc1c8481cc038bf6b2c369f55",
|
|
37
|
+
"size": 55212819
|
|
38
38
|
},
|
|
39
39
|
"linux-x64-musl": {
|
|
40
40
|
"binary": "claude.zst",
|
|
41
|
-
"checksum": "
|
|
42
|
-
"size":
|
|
41
|
+
"checksum": "ceb7cfd3cd93cbc759d71f2d6f59ffd0a3fd8a6defd8730e84cfa7d0e3e6b30e",
|
|
42
|
+
"size": 56594084
|
|
43
43
|
},
|
|
44
44
|
"win32-x64": {
|
|
45
45
|
"binary": "claude.exe.zst",
|
|
46
|
-
"checksum": "
|
|
47
|
-
"size":
|
|
46
|
+
"checksum": "29da768777633fd390b93c948d9104cb6a034c76aa7f039182d5e56ae947bbda",
|
|
47
|
+
"size": 57917911
|
|
48
48
|
},
|
|
49
49
|
"win32-arm64": {
|
|
50
50
|
"binary": "claude.exe.zst",
|
|
51
|
-
"checksum": "
|
|
52
|
-
"size":
|
|
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.
|
|
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.
|
|
61
|
-
"@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.
|
|
62
|
-
"@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.
|
|
63
|
-
"@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.
|
|
64
|
-
"@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.
|
|
65
|
-
"@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.
|
|
66
|
-
"@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.
|
|
67
|
-
"@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.
|
|
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.
|
|
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
|
-
|
|
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:
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
*/
|