@anthropic-ai/claude-agent-sdk 0.3.296 → 0.3.300
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 +82 -120
- package/browser-sdk.js +86 -94
- package/core-3fs8zete.mjs +35 -0
- package/core-5kpyasem.mjs +52 -0
- package/core.mjs +18 -18
- package/manifest.json +21 -23
- package/manifest.zst.json +25 -27
- package/package.json +12 -12
- package/sdk-tools.d.ts +13 -0
- package/sdk.d.ts +43 -7
- package/sdk.mjs +98 -77
- package/core-2haqfy07.mjs +0 -33
- package/core-a92dt75k.mjs +0 -40
package/manifest.json
CHANGED
|
@@ -1,56 +1,52 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.1.
|
|
2
|
+
"version": "2.1.300",
|
|
3
3
|
"manifestSignatureEnforcement": "flag",
|
|
4
|
-
"commit": "
|
|
5
|
-
"buildDate": "2026-10-
|
|
4
|
+
"commit": "c6733ae1276880507ca0c5b053ae18fb0df090d6",
|
|
5
|
+
"buildDate": "2026-10-14T13:29:53Z",
|
|
6
6
|
"platforms": {
|
|
7
7
|
"darwin-arm64": {
|
|
8
8
|
"binary": "claude",
|
|
9
|
-
"checksum": "
|
|
10
|
-
"size":
|
|
9
|
+
"checksum": "475517caa611e3318a2f298fa071287ec98955538df78c58f709ecc01e5ae2d3",
|
|
10
|
+
"size": 249556880
|
|
11
11
|
},
|
|
12
12
|
"darwin-x64": {
|
|
13
13
|
"binary": "claude",
|
|
14
|
-
"checksum": "
|
|
15
|
-
"size":
|
|
14
|
+
"checksum": "5824fc36863e70bbd070491bb9359e217d3f17b38c45697c085b31a3a67356b3",
|
|
15
|
+
"size": 259416272
|
|
16
16
|
},
|
|
17
17
|
"linux-arm64": {
|
|
18
18
|
"binary": "claude",
|
|
19
|
-
"checksum": "
|
|
20
|
-
"size":
|
|
19
|
+
"checksum": "ae2295ae2da156936bf5831ab01971ce924d0c9a0af174e28d96fffa8d5fa0a6",
|
|
20
|
+
"size": 266264568
|
|
21
21
|
},
|
|
22
22
|
"linux-x64": {
|
|
23
23
|
"binary": "claude",
|
|
24
|
-
"checksum": "
|
|
25
|
-
"size":
|
|
24
|
+
"checksum": "674deba0bba9aee479f4503c438b49303b6fdd304b9a471b14977aaec5215453",
|
|
25
|
+
"size": 266972344
|
|
26
26
|
},
|
|
27
27
|
"linux-arm64-musl": {
|
|
28
28
|
"binary": "claude",
|
|
29
|
-
"checksum": "
|
|
30
|
-
"size":
|
|
29
|
+
"checksum": "267fecafb9df3dc1ef93f01ea936742455151d38b9bceebc4c12b531df827a2c",
|
|
30
|
+
"size": 258422872
|
|
31
31
|
},
|
|
32
32
|
"linux-x64-musl": {
|
|
33
33
|
"binary": "claude",
|
|
34
|
-
"checksum": "
|
|
35
|
-
"size":
|
|
34
|
+
"checksum": "426e7b0a3726d656babc943a92392eb3653377587658a240ab442d19e4eef3c9",
|
|
35
|
+
"size": 260587880
|
|
36
36
|
},
|
|
37
37
|
"win32-x64": {
|
|
38
38
|
"binary": "claude.exe",
|
|
39
|
-
"checksum": "
|
|
40
|
-
"size":
|
|
39
|
+
"checksum": "56810a111c01dcd218b42727c23fd8763be42320038b1adcac93cf599fac2de2",
|
|
40
|
+
"size": 270863520
|
|
41
41
|
},
|
|
42
42
|
"win32-arm64": {
|
|
43
43
|
"binary": "claude.exe",
|
|
44
|
-
"checksum": "
|
|
45
|
-
"size":
|
|
44
|
+
"checksum": "fef0df9c7f72b2d7d0c26b1702f4646113be2c45a5b40eb5bbb7c93f5cbd5f8b",
|
|
45
|
+
"size": 257010848
|
|
46
46
|
}
|
|
47
47
|
},
|
|
48
48
|
"sdkCompat": {
|
|
49
49
|
"testedWrapperVersions": [
|
|
50
|
-
"0.3.261",
|
|
51
|
-
"0.3.263",
|
|
52
|
-
"0.3.265",
|
|
53
|
-
"0.3.266",
|
|
54
50
|
"0.3.267",
|
|
55
51
|
"0.3.268",
|
|
56
52
|
"0.3.269",
|
|
@@ -66,6 +62,8 @@
|
|
|
66
62
|
"0.3.280",
|
|
67
63
|
"0.3.281",
|
|
68
64
|
"0.3.282",
|
|
65
|
+
"0.3.283",
|
|
66
|
+
"0.3.284",
|
|
69
67
|
"0.3.285"
|
|
70
68
|
],
|
|
71
69
|
"harnessSchema": 1
|
package/manifest.zst.json
CHANGED
|
@@ -1,64 +1,60 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.1.
|
|
2
|
+
"version": "2.1.300",
|
|
3
3
|
"manifestSignatureEnforcement": "flag",
|
|
4
|
-
"commit": "
|
|
5
|
-
"buildDate": "2026-10-
|
|
4
|
+
"commit": "c6733ae1276880507ca0c5b053ae18fb0df090d6",
|
|
5
|
+
"buildDate": "2026-10-14T13:31:05Z",
|
|
6
6
|
"platforms": {
|
|
7
7
|
"darwin-arm64": {
|
|
8
8
|
"binary": "claude.zst",
|
|
9
|
-
"checksum": "
|
|
10
|
-
"size":
|
|
9
|
+
"checksum": "5f19cc8fef7b1387f4b71691213b5aadc62d9157a78014287f3002ce8642cc23",
|
|
10
|
+
"size": 83582341,
|
|
11
11
|
"bundle": {
|
|
12
|
-
"checksum": "
|
|
13
|
-
"size":
|
|
12
|
+
"checksum": "f53c2f9a3934eeebf8b7c86990e2c08b9ec046623941daea91d80a1f58a5d197",
|
|
13
|
+
"size": 83578473
|
|
14
14
|
}
|
|
15
15
|
},
|
|
16
16
|
"darwin-x64": {
|
|
17
17
|
"binary": "claude.zst",
|
|
18
|
-
"checksum": "
|
|
19
|
-
"size":
|
|
18
|
+
"checksum": "0bf82ce30e45f97b271db94af3a6877b72f658f570cea4dfac66741708a7737d",
|
|
19
|
+
"size": 88318346,
|
|
20
20
|
"bundle": {
|
|
21
|
-
"checksum": "
|
|
22
|
-
"size":
|
|
21
|
+
"checksum": "5e4397e2736e9b9e40de94251d9c621e4fe8bcfc460dec98312090002db750f3",
|
|
22
|
+
"size": 88323146
|
|
23
23
|
}
|
|
24
24
|
},
|
|
25
25
|
"linux-arm64": {
|
|
26
26
|
"binary": "claude.zst",
|
|
27
|
-
"checksum": "
|
|
28
|
-
"size":
|
|
27
|
+
"checksum": "1f87b1a7838056aaf69c2b819c0b6b118ac713e0e2ba6c0a768aa531c7c5e8d0",
|
|
28
|
+
"size": 92840828
|
|
29
29
|
},
|
|
30
30
|
"linux-x64": {
|
|
31
31
|
"binary": "claude.zst",
|
|
32
|
-
"checksum": "
|
|
33
|
-
"size":
|
|
32
|
+
"checksum": "ca1608ae4e85017c5408c85a3778410add7dd796324acfd0eef3ad707268d5d6",
|
|
33
|
+
"size": 93676652
|
|
34
34
|
},
|
|
35
35
|
"linux-arm64-musl": {
|
|
36
36
|
"binary": "claude.zst",
|
|
37
|
-
"checksum": "
|
|
38
|
-
"size":
|
|
37
|
+
"checksum": "f006bb2458db1d50c5c956b47864bc708823c132345d94dd8a10e8d5e0b2ffd8",
|
|
38
|
+
"size": 91194411
|
|
39
39
|
},
|
|
40
40
|
"linux-x64-musl": {
|
|
41
41
|
"binary": "claude.zst",
|
|
42
|
-
"checksum": "
|
|
43
|
-
"size":
|
|
42
|
+
"checksum": "0f5c6b4abe1d772642f85d52a4a05c79bbe7fd83bd0a551d1d0cfabbcc30ef53",
|
|
43
|
+
"size": 92091262
|
|
44
44
|
},
|
|
45
45
|
"win32-x64": {
|
|
46
46
|
"binary": "claude.exe.zst",
|
|
47
|
-
"checksum": "
|
|
48
|
-
"size":
|
|
47
|
+
"checksum": "78ed93dd777f073ef3a5961457775091d152d17c65823c40a86fc9bf55cb113a",
|
|
48
|
+
"size": 96203531
|
|
49
49
|
},
|
|
50
50
|
"win32-arm64": {
|
|
51
51
|
"binary": "claude.exe.zst",
|
|
52
|
-
"checksum": "
|
|
53
|
-
"size":
|
|
52
|
+
"checksum": "ca0cb24c68d402e8b3caa7a0daa38992cec05ac1076a4ebf709983aa608bb665",
|
|
53
|
+
"size": 92145199
|
|
54
54
|
}
|
|
55
55
|
},
|
|
56
56
|
"sdkCompat": {
|
|
57
57
|
"testedWrapperVersions": [
|
|
58
|
-
"0.3.261",
|
|
59
|
-
"0.3.263",
|
|
60
|
-
"0.3.265",
|
|
61
|
-
"0.3.266",
|
|
62
58
|
"0.3.267",
|
|
63
59
|
"0.3.268",
|
|
64
60
|
"0.3.269",
|
|
@@ -74,6 +70,8 @@
|
|
|
74
70
|
"0.3.280",
|
|
75
71
|
"0.3.281",
|
|
76
72
|
"0.3.282",
|
|
73
|
+
"0.3.283",
|
|
74
|
+
"0.3.284",
|
|
77
75
|
"0.3.285"
|
|
78
76
|
],
|
|
79
77
|
"harnessSchema": 1
|
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.300",
|
|
4
4
|
"main": "sdk.mjs",
|
|
5
5
|
"types": "sdk.d.ts",
|
|
6
6
|
"exports": {
|
|
@@ -61,14 +61,14 @@
|
|
|
61
61
|
"zod": "^4.0.0"
|
|
62
62
|
},
|
|
63
63
|
"optionalDependencies": {
|
|
64
|
-
"@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.
|
|
65
|
-
"@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.
|
|
66
|
-
"@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.
|
|
67
|
-
"@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.
|
|
68
|
-
"@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.
|
|
69
|
-
"@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.
|
|
70
|
-
"@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.
|
|
71
|
-
"@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.
|
|
64
|
+
"@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.300",
|
|
65
|
+
"@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.300",
|
|
66
|
+
"@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.300",
|
|
67
|
+
"@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.300",
|
|
68
|
+
"@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.300",
|
|
69
|
+
"@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.300",
|
|
70
|
+
"@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.300",
|
|
71
|
+
"@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.300"
|
|
72
72
|
},
|
|
73
73
|
"files": [
|
|
74
74
|
"sdk.mjs",
|
|
@@ -85,8 +85,8 @@
|
|
|
85
85
|
"extractFromBunfs.d.ts",
|
|
86
86
|
"manifest.json",
|
|
87
87
|
"manifest.zst.json",
|
|
88
|
-
"core-
|
|
89
|
-
"core-
|
|
88
|
+
"core-3fs8zete.mjs",
|
|
89
|
+
"core-5kpyasem.mjs"
|
|
90
90
|
],
|
|
91
|
-
"claudeCodeVersion": "2.1.
|
|
91
|
+
"claudeCodeVersion": "2.1.300"
|
|
92
92
|
}
|
package/sdk-tools.d.ts
CHANGED
|
@@ -447,6 +447,7 @@ export type ArtifactOutput =
|
|
|
447
447
|
publishesResetAt?: number;
|
|
448
448
|
contract?: string;
|
|
449
449
|
updated?: boolean;
|
|
450
|
+
owned?: boolean;
|
|
450
451
|
icon?: string;
|
|
451
452
|
faviconSent?: true;
|
|
452
453
|
iconDropped?: true;
|
|
@@ -484,6 +485,7 @@ export type ArtifactOutput =
|
|
|
484
485
|
durationMs: number;
|
|
485
486
|
title?: string;
|
|
486
487
|
};
|
|
488
|
+
owned?: boolean;
|
|
487
489
|
artifactRead?: {
|
|
488
490
|
slug: string;
|
|
489
491
|
ver?: string;
|
|
@@ -564,6 +566,7 @@ export type ArtifactOutput =
|
|
|
564
566
|
written?: {
|
|
565
567
|
url: string;
|
|
566
568
|
};
|
|
569
|
+
owned?: boolean;
|
|
567
570
|
asset_upload: {
|
|
568
571
|
id: string;
|
|
569
572
|
url: string;
|
|
@@ -577,6 +580,7 @@ export type ArtifactOutput =
|
|
|
577
580
|
written?: {
|
|
578
581
|
url: string;
|
|
579
582
|
};
|
|
583
|
+
owned?: boolean;
|
|
580
584
|
asset_uploads: {
|
|
581
585
|
url: string;
|
|
582
586
|
/**
|
|
@@ -667,6 +671,7 @@ export type ArtifactOutput =
|
|
|
667
671
|
written?: {
|
|
668
672
|
url: string;
|
|
669
673
|
};
|
|
674
|
+
owned?: boolean;
|
|
670
675
|
asset_delete: {
|
|
671
676
|
id: string;
|
|
672
677
|
deleted: boolean;
|
|
@@ -4176,6 +4181,10 @@ export interface CronCreateOutput {
|
|
|
4176
4181
|
humanSchedule: string;
|
|
4177
4182
|
recurring: boolean;
|
|
4178
4183
|
durable?: boolean;
|
|
4184
|
+
/**
|
|
4185
|
+
* Epoch ms of the job's next run, the scheduler's per-job offset included
|
|
4186
|
+
*/
|
|
4187
|
+
nextFireAt?: number;
|
|
4179
4188
|
}
|
|
4180
4189
|
export interface CronDeleteOutput {
|
|
4181
4190
|
id: string;
|
|
@@ -4188,6 +4197,10 @@ export interface CronListOutput {
|
|
|
4188
4197
|
prompt: string;
|
|
4189
4198
|
recurring?: boolean;
|
|
4190
4199
|
durable?: boolean;
|
|
4200
|
+
/**
|
|
4201
|
+
* Epoch ms of the job's next run, the scheduler's per-job offset included
|
|
4202
|
+
*/
|
|
4203
|
+
nextFireAt?: number;
|
|
4191
4204
|
}[];
|
|
4192
4205
|
}
|
|
4193
4206
|
export interface PushNotificationOutput {
|
package/sdk.d.ts
CHANGED
|
@@ -283,6 +283,7 @@ export declare type CanUseTool = (toolName: string, input: Record<string, unknow
|
|
|
283
283
|
toolUseID: string;
|
|
284
284
|
/** If running within the context of a sub-agent, the sub-agent's ID. */
|
|
285
285
|
agentID?: string;
|
|
286
|
+
|
|
286
287
|
/**
|
|
287
288
|
* The control_request envelope's `request_id`. A control_response sent
|
|
288
289
|
* out-of-band (e.g. a signed HTTP POST instead of the SDK's WS write)
|
|
@@ -1432,6 +1433,7 @@ export declare type ModelInfo = {
|
|
|
1432
1433
|
supportsAutoMode?: boolean;
|
|
1433
1434
|
|
|
1434
1435
|
|
|
1436
|
+
|
|
1435
1437
|
};
|
|
1436
1438
|
|
|
1437
1439
|
export declare type ModelUsage = {
|
|
@@ -2770,6 +2772,7 @@ export declare type PreToolUseHookSpecificOutput = {
|
|
|
2770
2772
|
permissionDecisionReason?: string;
|
|
2771
2773
|
updatedInput?: Record<string, unknown>;
|
|
2772
2774
|
additionalContext?: string;
|
|
2775
|
+
|
|
2773
2776
|
};
|
|
2774
2777
|
|
|
2775
2778
|
/**
|
|
@@ -3712,6 +3715,7 @@ export declare type SDKAssistantMessage = {
|
|
|
3712
3715
|
|
|
3713
3716
|
|
|
3714
3717
|
|
|
3718
|
+
|
|
3715
3719
|
};
|
|
3716
3720
|
|
|
3717
3721
|
export declare type SDKAssistantMessageError = 'authentication_failed' | 'oauth_org_not_allowed' | 'account_on_hold' | 'verification_required' | 'billing_error' | 'rate_limit' | 'overloaded' | 'invalid_request' | 'model_not_found' | 'server_error' | 'unknown' | 'max_output_tokens' | 'cloud_credential_error';
|
|
@@ -3911,7 +3915,7 @@ declare type SDKControlBackgroundTasksRequest = {
|
|
|
3911
3915
|
};
|
|
3912
3916
|
|
|
3913
3917
|
/**
|
|
3914
|
-
* Drops a pending async user message from the command queue by uuid. No-op if already dequeued for execution.
|
|
3918
|
+
* Drops a pending async user message from the command queue by uuid. No-op if already dequeued for execution. Also a no-op, on a worker that recognises held messages, for the queued re-run of an interrupted turn while that re-run also answers for other client messages, which cancelling it would close though nobody withdrew them; see the response.
|
|
3915
3919
|
*/
|
|
3916
3920
|
declare type SDKControlCancelAsyncMessageRequest = {
|
|
3917
3921
|
subtype: 'cancel_async_message';
|
|
@@ -3940,6 +3944,10 @@ declare type SDKControlElicitationRequest = {
|
|
|
3940
3944
|
url?: string;
|
|
3941
3945
|
elicitation_id?: string;
|
|
3942
3946
|
requested_schema?: Record<string, unknown>;
|
|
3947
|
+
/**
|
|
3948
|
+
* requested_schema.properties' top-level keys in the order the MCP server listed them; absent for URL mode and when the schema has no properties object. For a host whose transport keeps no JSON object key order (a protobuf Struct, say). Names that look like array indices ("0", "1", …) come first, in JavaScript's object key order.
|
|
3949
|
+
*/
|
|
3950
|
+
property_order?: string[];
|
|
3943
3951
|
/**
|
|
3944
3952
|
* Permission-display title from the MCP server's _meta['anthropic/permissionDisplay']. Mirrors can_use_tool.title so SDK consumers can render elicitation-driven permission prompts with structured headers instead of parsing `message`.
|
|
3945
3953
|
*/
|
|
@@ -4398,7 +4406,7 @@ export declare type SDKControlGetUsageResponse = {
|
|
|
4398
4406
|
* Behavioral characteristics of local usage. Categories overlap — this is not a partition, so percentages do not sum to 100.
|
|
4399
4407
|
*/
|
|
4400
4408
|
behaviors: {
|
|
4401
|
-
key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron';
|
|
4409
|
+
key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron' | 'max_effort' | 'workflow' | 'always_on_context' | 'large_tool_results';
|
|
4402
4410
|
/**
|
|
4403
4411
|
* Share of the weighted local usage attributed to this behavior, 0-100.
|
|
4404
4412
|
*/
|
|
@@ -4453,7 +4461,7 @@ export declare type SDKControlGetUsageResponse = {
|
|
|
4453
4461
|
* Behavioral characteristics of local usage. Categories overlap — this is not a partition, so percentages do not sum to 100.
|
|
4454
4462
|
*/
|
|
4455
4463
|
behaviors: {
|
|
4456
|
-
key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron';
|
|
4464
|
+
key: 'cache_miss' | 'long_context' | 'subagent_heavy' | 'high_parallel' | 'cron' | 'max_effort' | 'workflow' | 'always_on_context' | 'large_tool_results';
|
|
4457
4465
|
/**
|
|
4458
4466
|
* Share of the weighted local usage attributed to this behavior, 0-100.
|
|
4459
4467
|
*/
|
|
@@ -4610,6 +4618,7 @@ export declare type SDKControlInitializeResponse = {
|
|
|
4610
4618
|
*/
|
|
4611
4619
|
plugins_applied?: boolean;
|
|
4612
4620
|
|
|
4621
|
+
|
|
4613
4622
|
/**
|
|
4614
4623
|
* What became of each entry of this initialize's sdkMcpServerManifests, keyed by sdk server name, for the entries whose name is in sdkMcpServers. 'parked': kept for the connect that follows this reply, which answers the server's MCP initialize and first tools/list from it (a later failure to replay shows up as live mcp_message frames, as when no entry was sent). 'already_connected': this CLI already had a live client for the server. 'protocol_version_mismatch': initializeResult.protocolVersion is not the version this CLI's client requests. 'malformed': the entry is not of the documented shape, reported whether or not manifests were honoured (every name in sdkMcpServers gets this when the field itself is not an object); or an honoured entry is past the limits this CLI sets on a live answer. 'not_honoured': the CLI did not use the entry: manifests or remote manifests are switched off in this CLI, the session service has not told this remote-session worker in the last five minutes that only the account owning the session can send events to it, or the request reached such a worker other than over its session stream (nothing for the host to change in any of these cases); or this CLI had read as many tool lists as it allows in a minute (send it again later); or it came over the session stream without sdkMcpServerManifestsOrigin or on a frame too old to trust (the host's to fix). Absent when the request carried no sdkMcpServerManifests or named no sdkMcpServers, and on CLIs that predate the field.
|
|
4615
4624
|
*/
|
|
@@ -4658,13 +4667,13 @@ declare type SDKControlInterruptRequest = {
|
|
|
4658
4667
|
*/
|
|
4659
4668
|
export declare type SDKControlInterruptResponse = {
|
|
4660
4669
|
/**
|
|
4661
|
-
* Uuids of async user messages that survive this interrupt: commands still in the queue, plus any batch already dequeued for the imminent turn but not yet reachable by the abort. An interrupt — plain or cancel_queued:true — that lands during the FIRST-command prewait window (before the first turn of the session has armed a controller) is additionally LATCHED, scoped to the user-intent work pending at that instant — the batch already dequeued and parked for the imminent turn, plus the user-intent main-thread commands then in the queue (the work this list enumerates): the first turn to arm that carries any of that doomed work starts already aborted, exactly once, so the listed prewait batch is delivered into an immediately-aborted turn, its frames and result flowing through the normal abort path, instead of running to completion. A turn carrying none of it arms live and leaves the latch waiting: a system delivery turn (for example a replayed host event), or a prompt enqueued after the interrupt — post-interrupt work is never coalesced with the doomed work and never dies to the latch, so the Stop kills exactly what this receipt listed. The latch is released when the doomed work is retired without arming: if a parked prewait batch is entirely cancelled, the latch is released even when other queued commands remain (those arm and run normally); with nothing parked, it is released once none of the doomed commands remains queued — work enqueued after the interrupt neither holds it up nor is aborted by it. Survivors that ride any later turn run normally. These WILL run (subject to that latch) unless cancelled first (or unless the request set cancel_queued:true, in which case every uuid-stamped survivor this process holds is removed, emitted a terminal `cancelled` synchronously, and listed under `cancelled` instead — leaving here only what a client driving a hosted session can no longer recall: a send already in flight to that session, or the first prompt the session was created with; a send that client still holds on its own machine behind a send gate (it waits there until that session is ready to take it) has not gone out, so it is withdrawn and listed under `cancelled` like a queued one, and cancel_async_message can withdraw it too, while a plain interrupt leaves it held and lists it here). Cancellation granularity: uuids still in the queue are individually cancellable via cancel_async_message; once a batch is dequeued and coalesced into one turn, cancelling a NON-representative member uuid is a no-op (its content still runs), while cancelling the batch-representative uuid drops the WHOLE coalesced batch — in both cases the cancel response reports cancelled:false because the message was no longer in the queue. Coverage caveats: only uuid-STAMPED messages appear (a message enqueued without a uuid still runs but is never listed, so [] does not mean "nothing will run"); only main-thread messages are listed (subagent-addressed messages are out of scope); and the list may include internally-enqueued uuids the client never sent (cron triggers, auto-resume continuations) — ignore unknown uuids rather than treating them as an error. Ordering: on a clean interrupt this receipt is written before the interrupted turn result; a turn that crashes during interrupt handling emits its error result on a direct-write path that may precede the receipt. Snapshot is taken synchronously with abort processing — probing the queue after the interrupted result instead always loses the race against the drain loop, which starts the next queued turn immediately.
|
|
4670
|
+
* Uuids of async user messages that survive this interrupt: commands still in the queue, plus any batch already dequeued for the imminent turn but not yet reachable by the abort. An interrupt — plain or cancel_queued:true — that lands during the FIRST-command prewait window (before the first turn of the session has armed a controller) is additionally LATCHED, scoped to the user-intent work pending at that instant — the batch already dequeued and parked for the imminent turn, plus the user-intent main-thread commands then in the queue (the work this list enumerates): the first turn to arm that carries any of that doomed work starts already aborted, exactly once, so the listed prewait batch is delivered into an immediately-aborted turn, its frames and result flowing through the normal abort path, instead of running to completion. A turn carrying none of it arms live and leaves the latch waiting: a system delivery turn (for example a replayed host event), or a prompt enqueued after the interrupt — post-interrupt work is never coalesced with the doomed work and never dies to the latch, so the Stop kills exactly what this receipt listed. The latch is released when the doomed work is retired without arming: if a parked prewait batch is entirely cancelled, the latch is released even when other queued commands remain (those arm and run normally); with nothing parked, it is released once none of the doomed commands remains queued — work enqueued after the interrupt neither holds it up nor is aborted by it. Survivors that ride any later turn run normally. These WILL run (subject to that latch) unless cancelled first (or unless the request set cancel_queued:true, in which case every uuid-stamped survivor this process holds is removed, emitted a terminal `cancelled` synchronously, and listed under `cancelled` instead — leaving here only what a client driving a hosted session can no longer recall: a send already in flight to that session, or the first prompt the session was created with; a send that client still holds on its own machine behind a send gate (it waits there until that session is ready to take it) has not gone out, so it is withdrawn and listed under `cancelled` like a queued one, and cancel_async_message can withdraw it too, while a plain interrupt leaves it held and lists it here). Cancellation granularity: uuids still in the queue are individually cancellable via cancel_async_message (the re-run of an interrupted turn that also answers for other client messages only if this interrupt was for it; see the response to that request); once a batch is dequeued and coalesced into one turn, cancelling a NON-representative member uuid is a no-op (its content still runs), while cancelling the batch-representative uuid drops the WHOLE coalesced batch — in both cases the cancel response reports cancelled:false because the message was no longer in the queue. Coverage caveats: only uuid-STAMPED messages appear (a message enqueued without a uuid still runs but is never listed, so [] does not mean "nothing will run"); only main-thread messages are listed (subagent-addressed messages are out of scope); and the list may include internally-enqueued uuids the client never sent (cron triggers, auto-resume continuations) — ignore unknown uuids rather than treating them as an error. Ordering: on a clean interrupt this receipt is written before the interrupted turn result; a turn that crashes during interrupt handling emits its error result on a direct-write path that may precede the receipt. Snapshot is taken synchronously with abort processing — probing the queue after the interrupted result instead always loses the race against the drain loop, which starts the next queued turn immediately.
|
|
4662
4671
|
*/
|
|
4663
4672
|
still_queued: string[];
|
|
4664
4673
|
|
|
4665
4674
|
|
|
4666
4675
|
/**
|
|
4667
|
-
* Present only when the request set cancel_queued:true — uuids of main-thread commands cancelled by this interrupt: every survivor that would otherwise have appeared under `still_queued`, including any uuid that was mid-fold at the interrupt instant (this request also aborts, so the fold never delivers it). Each listed uuid has been removed (queue-resident) or marked cancel-pending (the first-command prewait window, closed by the drain loop's backstop) and emits a terminal 'cancelled' lifecycle synchronously at the first such interrupt (a repeat interrupt over the same parked batch re-lists the uuid idempotently without re-emitting); none will run. Same coverage caveats as `still_queued` (uuid-stamped main-thread only; internally-enqueued uuids may appear). Advertised by the `interrupt_cancel_queued_v1` capability.
|
|
4676
|
+
* Present only when the request set cancel_queued:true — uuids of main-thread commands cancelled by this interrupt: every survivor that would otherwise have appeared under `still_queued`, including any uuid that was mid-fold at the interrupt instant (this request also aborts, so the fold never delivers it). Each listed uuid has been removed (queue-resident) or marked cancel-pending (the first-command prewait window, closed by the drain loop's backstop) and emits a terminal 'cancelled' lifecycle synchronously at the first such interrupt (a repeat interrupt over the same parked batch re-lists the uuid idempotently without re-emitting); none will run. Where one of them is the re-run of an interrupted turn that also answered for other client messages whose re-sent copies had been set aside for it, those messages' uuids are listed behind the commands' too: they were in no queue and never under `still_queued`, each has its terminal 'cancelled' lifecycle, and a repeat interrupt does not list them again. Same coverage caveats as `still_queued` (uuid-stamped main-thread only; internally-enqueued uuids may appear). Advertised by the `interrupt_cancel_queued_v1` capability.
|
|
4668
4677
|
*/
|
|
4669
4678
|
cancelled?: string[];
|
|
4670
4679
|
};
|
|
@@ -4843,6 +4852,8 @@ declare type SDKControlPermissionRequest = {
|
|
|
4843
4852
|
*/
|
|
4844
4853
|
decision_reason_type?: 'rule' | 'mode' | 'subcommandResults' | 'permissionPromptTool' | 'hook' | 'asyncAgent' | 'sandboxOverride' | 'workingDir' | 'safetyCheck' | 'classifier' | 'other';
|
|
4845
4854
|
|
|
4855
|
+
|
|
4856
|
+
|
|
4846
4857
|
/**
|
|
4847
4858
|
* Set when a safetyCheck is present anywhere in the decision reason (including nested inside subcommandResults for compound bash). false = at least one safety check requires manual approval (e.g. Windows path bypass, dangerous rm); true = all safety checks MAY be classifier-approved (e.g. sensitive-file paths). Absent when no safetyCheck is involved.
|
|
4848
4859
|
*/
|
|
@@ -4867,9 +4878,10 @@ declare type SDKControlPermissionRequest = {
|
|
|
4867
4878
|
display_name?: string;
|
|
4868
4879
|
tool_use_id: string;
|
|
4869
4880
|
agent_id?: string;
|
|
4881
|
+
|
|
4870
4882
|
description?: string;
|
|
4871
4883
|
/**
|
|
4872
|
-
* True when one-tap Approve/Deny must not be offered: the tool's approval card IS the user-interaction surface (Tool.requiresUserInteraction()
|
|
4884
|
+
* True when one-tap Approve/Deny must not be offered: the tool's approval card IS the user-interaction surface (Tool.requiresUserInteraction(): the user responds on the card itself), OR the pending ask is localDisplayOnly (its consent disclosure cannot ride this wire and only the local dialog renders it), OR the auto-mode classifier blocked the call and it was handed to a person (decision_reason_type 'classifier' on a person-only ask), which no stored grant or automatic approval may answer, OR the SDK host worded the ask (title and description are its consent copy, which a push cannot carry whole). In each case the user has to open the session to answer.
|
|
4873
4885
|
*/
|
|
4874
4886
|
requires_user_interaction?: boolean;
|
|
4875
4887
|
|
|
@@ -5143,6 +5155,7 @@ declare type SDKControlSetPermissionModeRequest = {
|
|
|
5143
5155
|
*/
|
|
5144
5156
|
mode: coreTypes.PermissionMode;
|
|
5145
5157
|
|
|
5158
|
+
|
|
5146
5159
|
};
|
|
5147
5160
|
|
|
5148
5161
|
/**
|
|
@@ -5306,6 +5319,7 @@ export declare type SDKInformationalMessage = {
|
|
|
5306
5319
|
* Opaque feature tag on a line a host may treat specially; absent on ordinary lines. Hosts ignore values they do not know.
|
|
5307
5320
|
*/
|
|
5308
5321
|
tag?: string;
|
|
5322
|
+
|
|
5309
5323
|
uuid: UUID;
|
|
5310
5324
|
session_id: string;
|
|
5311
5325
|
};
|
|
@@ -5418,6 +5432,11 @@ export declare type SDKMessageOrigin = {
|
|
|
5418
5432
|
* Kernel-verified pid of the process that connected to this session's cross-session messaging socket, read from the connection (SO_PEERCRED / LOCAL_PEERPID) — never from the payload. This identifies the CONNECTING process, which for relayed traffic (e.g. a daemon forwarding on another session's behalf) is the relay, not the message's author. Key sender identity on this, never on `from`: `from` is sender-authored and kept only for reply routing, so it is forgeable by any same-user process. Absent when unverifiable (Windows, non-UDS ingress) — never a wrong value. Pids are recyclable: provenance, not an authentication token.
|
|
5419
5433
|
*/
|
|
5420
5434
|
verifiedPeerPid?: number;
|
|
5435
|
+
|
|
5436
|
+
|
|
5437
|
+
|
|
5438
|
+
|
|
5439
|
+
|
|
5421
5440
|
} | {
|
|
5422
5441
|
kind: 'task-notification';
|
|
5423
5442
|
/**
|
|
@@ -5433,6 +5452,7 @@ export declare type SDKMessageOrigin = {
|
|
|
5433
5452
|
* On a background task's own notification: the run_id its task_* events carried, as of when the notification was queued. Not part of the text the model reads.
|
|
5434
5453
|
*/
|
|
5435
5454
|
runId?: string;
|
|
5455
|
+
|
|
5436
5456
|
} | {
|
|
5437
5457
|
kind: 'coordinator';
|
|
5438
5458
|
} | {
|
|
@@ -5772,6 +5792,7 @@ export declare type SDKResultError = {
|
|
|
5772
5792
|
*/
|
|
5773
5793
|
resume_reason?: string;
|
|
5774
5794
|
terminal_reason?: TerminalReason;
|
|
5795
|
+
|
|
5775
5796
|
/**
|
|
5776
5797
|
* Delivery sequence of this result within the run: how many results the run numbered before this one, starting at 0, in the order the process writes them. A result held back while background work finishes is numbered when it is finally written, not when its text was produced; a result whose write fails still consumes its number, so a gap in a stream-json sequence means a result was lost. Distinct from num_turns, which counts model round-trips within one turn. Numbered by the process that hosts the run (`claude -p`, stream-json): a local client relaying a cloud session passes the cloud session's numbering through and its own locally built error results carry none; the in-process engine surface does not number yet. Absent from older producers.
|
|
5777
5798
|
*/
|
|
@@ -5804,6 +5825,16 @@ export declare type SDKResultSuccess = {
|
|
|
5804
5825
|
|
|
5805
5826
|
|
|
5806
5827
|
|
|
5828
|
+
|
|
5829
|
+
|
|
5830
|
+
|
|
5831
|
+
|
|
5832
|
+
|
|
5833
|
+
|
|
5834
|
+
|
|
5835
|
+
|
|
5836
|
+
|
|
5837
|
+
|
|
5807
5838
|
user_message_uuid?: string;
|
|
5808
5839
|
user_message_uuids?: string[];
|
|
5809
5840
|
resume_reason?: string;
|
|
@@ -5835,6 +5866,7 @@ export declare type SDKResultSuccess = {
|
|
|
5835
5866
|
api_error_status?: number | null;
|
|
5836
5867
|
|
|
5837
5868
|
|
|
5869
|
+
|
|
5838
5870
|
num_turns: number;
|
|
5839
5871
|
result: string;
|
|
5840
5872
|
stop_reason: string | null;
|
|
@@ -5860,6 +5892,7 @@ export declare type SDKResultSuccess = {
|
|
|
5860
5892
|
structured_output?: unknown;
|
|
5861
5893
|
deferred_tool_use?: SDKDeferredToolUse;
|
|
5862
5894
|
terminal_reason?: TerminalReason;
|
|
5895
|
+
|
|
5863
5896
|
/**
|
|
5864
5897
|
* Delivery sequence of this result within the run: how many results the run numbered before this one, starting at 0, in the order the process writes them. A result held back while background work finishes is numbered when it is finally written, not when its text was produced; a result whose write fails still consumes its number, so a gap in a stream-json sequence means a result was lost. Distinct from num_turns, which counts model round-trips within one turn. Numbered by the process that hosts the run (`claude -p`, stream-json): a local client relaying a cloud session passes the cloud session's numbering through and its own locally built error results carry none; the in-process engine surface does not number yet. Absent from older producers.
|
|
5865
5898
|
*/
|
|
@@ -6377,6 +6410,7 @@ export declare type SDKUserMessage = {
|
|
|
6377
6410
|
|
|
6378
6411
|
|
|
6379
6412
|
|
|
6413
|
+
|
|
6380
6414
|
uuid?: UUID;
|
|
6381
6415
|
/**
|
|
6382
6416
|
* Content the user pasted into the prompt rather than typed: each entry a string or an array of content blocks. The CLI appends the text of each entry after the typed text, in order, and may wrap it in `<pasted_content>` tags. Blocks other than text are ignored; send images and documents in `message.content`. A list of over 1,000 entries and blocks in all is ignored.
|
|
@@ -6471,6 +6505,7 @@ export declare type SDKUserMessageReplay = {
|
|
|
6471
6505
|
|
|
6472
6506
|
|
|
6473
6507
|
|
|
6508
|
+
|
|
6474
6509
|
uuid: UUID;
|
|
6475
6510
|
session_id: string;
|
|
6476
6511
|
isReplay: true;
|
|
@@ -8690,7 +8725,7 @@ export declare interface Settings {
|
|
|
8690
8725
|
*/
|
|
8691
8726
|
parentSettingsBehavior?: 'first-wins' | 'merge';
|
|
8692
8727
|
/**
|
|
8693
|
-
* Controls how the managed settings sources compose. "first-wins" (default): the highest-priority source present (server-managed > MDM (managed plist / HKLM) > managed-settings.json) is the managed tier alone. "merge": every present source deep-merges with fixed precedence server-managed > MDM > managed-settings.json — scalars take the highest source's value (a restrictive boolean or enum — the allowManaged*Only locks, the disable* switches, the sandbox lock family — takes the strictest value any source sets) and arrays union, except fallbackModel, the restriction allowlists allowedMcpServers, allowedProviders, availableModels, strictKnownMarketplaces and allowedChannelPlugins, and sandbox.credentials.awsPairs and sandbox.ripgrep (the highest source that sets one owns it whole), modelOverrides (the whole map of the highest source that sets it, dropped when that source sits below the one that sets availableModels), managedMcpServers (server names union; a name set by two sources takes the higher source's whole entry), and the keys taken from the highest source only: the auth pins forceLoginOrgUUID, forceLoginMethod, forceLoginGatewayUrl and gatewayInternalNetworks, the credential helpers apiKeyHelper, awsAuthRefresh, awsCredentialExport, gcpAuthRefresh, otelHeadersHelper and proxyAuthHelper, modelPicker, permissions.defaultMode, parentSettingsBehavior and the policyHelper configuration (env keeps its own per-key union). Honored only from the highest-priority source present; enable it only when every lower source is admin-controlled, since lower sources then contribute entries such as permissions.allow. HKCU and --managed-settings never take part in the merge.
|
|
8728
|
+
* Controls how the managed settings sources compose. "first-wins" (default): the highest-priority source present (server-managed > MDM (managed plist / HKLM) > managed-settings.json) is the managed tier alone. "merge": every present source deep-merges with fixed precedence server-managed > MDM > managed-settings.json — scalars take the highest source's value (a restrictive boolean or enum — the allowManaged*Only locks, the disable* switches, the sandbox lock family — takes the strictest value any source sets) and arrays union, except fallbackModel, the restriction allowlists allowedMcpServers, allowedProviders, availableModels, strictKnownMarketplaces and allowedChannelPlugins, and sandbox.credentials.awsPairs and sandbox.ripgrep (the highest source that sets one owns it whole), modelOverrides (the whole map of the highest source that sets it, dropped when that source sits below the one that sets availableModels), managedMcpServers (server names union; a name set by two sources takes the higher source's whole entry), and the keys taken from the highest source only: the auth pins forceLoginOrgUUID, forceLoginMethod, forceLoginGatewayUrl and gatewayInternalNetworks, the credential helpers apiKeyHelper, awsAuthRefresh, awsCredentialExport, gcpAuthRefresh, otelHeadersHelper and proxyAuthHelper, modelPicker, permissions.defaultMode, parentSettingsBehavior and the policyHelper configuration (env keeps its own per-key union). In both modes, a forceLoginOrgUUID, or a forceLoginMethod of claudeai or console, that this machine's own MDM policy or managed settings file sets applies ahead of server-managed settings. Honored only from the highest-priority source present; enable it only when every lower source is admin-controlled, since lower sources then contribute entries such as permissions.allow. HKCU and --managed-settings never take part in the merge.
|
|
8694
8729
|
*/
|
|
8695
8730
|
managedSourcesBehavior?: 'first-wins' | 'merge';
|
|
8696
8731
|
/**
|
|
@@ -9449,6 +9484,7 @@ export declare type SlashCommand = {
|
|
|
9449
9484
|
* True when the command is Claude Code's own; absent for a command defined by a user, project, plugin or MCP server. Rows can share a name: when a marked row carries it, /name runs that one, and an unmarked row is the one /name runs only when no marked row shares its name. The marker describes the row's name, not its aliases: a typed alias runs a command that has it as its name, when one exists, whatever this marker says.
|
|
9450
9485
|
*/
|
|
9451
9486
|
builtin?: boolean;
|
|
9487
|
+
|
|
9452
9488
|
};
|
|
9453
9489
|
|
|
9454
9490
|
/**
|