@anthropic-ai/claude-agent-sdk 0.3.258 → 0.3.260

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/manifest.json CHANGED
@@ -1,54 +1,52 @@
1
1
  {
2
- "version": "2.1.258",
2
+ "version": "2.1.260",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "b3cd543a1f6fcdf4d8fabc0f5e5538d2ee7f38e1",
5
- "buildDate": "2026-09-01T22:02:56Z",
4
+ "commit": "e51f681183f733dbe9a81bf35921c786ee26dbc6",
5
+ "buildDate": "2026-09-03T19:51:05Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "b63136194160791c27cfa7b0403060d85eb0752991625fde8c09f9acacb17c78",
10
- "size": 199027600
9
+ "checksum": "3c269f66801028823e24a63ced9fdd3988cb86cf85fccd9f03f87e463b9d3e3c",
10
+ "size": 198289440
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "c857db5cd712865623bd61e806cf3f7e8e279c9e5c7c0af5eca06ca6717fc7fb",
15
- "size": 207778640
14
+ "checksum": "2d791b1bff2bc36419de09e1f2226c076b40b0717ee43108928938f622ea9b77",
15
+ "size": 207051744
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "43dc490af55262edcb3e9b1cb315de22cc09ccb08bd52a4c39bc5eabaa63100f",
20
- "size": 215014736
19
+ "checksum": "9811afb5f97224c2c5d3d0ee1e8c316117d298d5ec3e095d5ff0c1dd0e889ca5",
20
+ "size": 214228392
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "704f1334ac65d3e89e1c6c1d7663293ad786a6166afdb71b5075337df630f976",
25
- "size": 215473560
24
+ "checksum": "7a2fdc74b6836ea3d183f665b869f0ee3baebc9713cbebffe5838da4ea7bd82e",
25
+ "size": 214687216
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "d3bef6ba403fe3efba684fa93e1bb26bc7a08c054bd516639d54e77c77bb9821",
30
- "size": 207894168
29
+ "checksum": "414fea0ef7bf774b7b1d1a42635ce176b6fc5ec80912303557307f1e04aca621",
30
+ "size": 207173272
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "e74a226cf174d911664aff982486c55ca770d9c00007e52e86b13d10bae72af3",
35
- "size": 209493960
34
+ "checksum": "08a7ca9c07d88af26d3ea53ed59a27bf74d8827b2f3e01d329f1fd2ae42ceaaa",
35
+ "size": 208703440
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "22f5f3a44093e14c75a4d1c8ce25c730b21dd634318fbe3268e9057d12b17c41",
40
- "size": 218507936
39
+ "checksum": "ab5fe6cb800a9faf3df1cc0f6bcb71f097296b302a16b576ca906446a22fea71",
40
+ "size": 217771680
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "42675c431b6014ad7243fea0ed0e371045dedc89d94aac81a9a0f528e644ed97",
45
- "size": 209548960
44
+ "checksum": "40c1dfef976a6c4df772c75d73cb313773d3bbfcb8ce8d05fd2965afec3718b5",
45
+ "size": 208821920
46
46
  }
47
47
  },
48
48
  "sdkCompat": {
49
49
  "testedWrapperVersions": [
50
- "0.3.217",
51
- "0.3.218",
52
50
  "0.3.219",
53
51
  "0.3.220",
54
52
  "0.3.221",
package/manifest.zst.json CHANGED
@@ -1,62 +1,60 @@
1
1
  {
2
- "version": "2.1.258",
2
+ "version": "2.1.260",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "b3cd543a1f6fcdf4d8fabc0f5e5538d2ee7f38e1",
5
- "buildDate": "2026-09-01T22:04:05Z",
4
+ "commit": "e51f681183f733dbe9a81bf35921c786ee26dbc6",
5
+ "buildDate": "2026-09-03T19:52:17Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "ee83f6743e0e5f60ec1456ea813851c625051241f7bc55d607faafe44cf4bc82",
10
- "size": 65811873,
9
+ "checksum": "90c8e9f337f7461b7582862f35ce22f89ad13b8d529c150f2969e8fa6d3bf020",
10
+ "size": 65758751,
11
11
  "bundle": {
12
- "checksum": "412f0b36da7cff5b20e7d856c939b449449583ee0971e9217c54972d1dfb4df3",
13
- "size": 65814874
12
+ "checksum": "7639b52c3ff28116f770e198ffb9760f9ecd44632a7c2a0ff0200c4dcf1dd038",
13
+ "size": 65759778
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "160aa9a06afcb80c293ecd4e42ea62adb67e471bed6b9a813504f26b96978034",
19
- "size": 69876596,
18
+ "checksum": "6f85206e0365f2edbcaff94058802d627d5c48d585d5630cf71e5fe1515f3e00",
19
+ "size": 69805574,
20
20
  "bundle": {
21
- "checksum": "575203804ea01ddd3c12226c7c9cdcd068f1d039c732e22916297d438944510c",
22
- "size": 69878203
21
+ "checksum": "e81267bb7ff923e2b5d2b61dbe6e0767e2783dd88e306e0a1f308b8477cab96f",
22
+ "size": 69807328
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "31768a9f65e58e48a3cacf7fce069bb6d7bd707cdb49874af2cb19b9d05af671",
28
- "size": 75035372
27
+ "checksum": "cfd17d6812c2bd7c2e9c4bc028786e5619db2962a17ac10b77667a3ff1148877",
28
+ "size": 74961889
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "88207a58aee5a82e47db834ce81111200ad8fae9ea9abe2ff1ff9773d6a2100a",
33
- "size": 75670149
32
+ "checksum": "ad1c0b3f2de334f4bcb4a783c275b1af7a5945c0c955a9c7352cf4fa0666a7ec",
33
+ "size": 75589735
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "6658622d769ad18dfbc1e70ea0056e34e88e258b15769e9c63c6c444cb83625a",
38
- "size": 73516216
37
+ "checksum": "b483ac78a8f2169a744703f273ed24b302baf8b671c92897a7611f107f6c3920",
38
+ "size": 73440071
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "d357e596364fb922923e5db2b3877d3d7ba4a1b9d2f44f44879efa103bf459a0",
43
- "size": 74188445
42
+ "checksum": "0d4231f3bafbc88f26899e54c246638659feccfb7e8be7b0d02078b58bdd4039",
43
+ "size": 74103087
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "94c7203fbeaa42f67dba3e7aabc544b1356dcec76bf830693948e99f4e4f21bc",
48
- "size": 78074015
47
+ "checksum": "664d2c6ca08afcd030100ddaddb80c5764bc517a4df407d819e6839bcc5edca8",
48
+ "size": 78005064
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "28eb7de6beb1adc3bc628426eada6aabd9592d42b66174cc419f64cb208f0127",
53
- "size": 74810598
52
+ "checksum": "f38cd767f8aef8c0eec1a09bf1f636bf9c6b8589d133c80be54a3ec9798a0f18",
53
+ "size": 74742830
54
54
  }
55
55
  },
56
56
  "sdkCompat": {
57
57
  "testedWrapperVersions": [
58
- "0.3.217",
59
- "0.3.218",
60
58
  "0.3.219",
61
59
  "0.3.220",
62
60
  "0.3.221",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.258",
3
+ "version": "0.3.260",
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.258",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.258",
62
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.258",
63
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.258",
64
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.258",
65
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.258",
66
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.258",
67
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.258"
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.260",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.260",
62
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.260",
63
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.260",
64
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.260",
65
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.260",
66
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.260",
67
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.260"
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.258"
83
+ "claudeCodeVersion": "2.1.260"
84
84
  }
package/sdk-tools.d.ts CHANGED
@@ -443,6 +443,8 @@ export type ArtifactOutput =
443
443
  read?: string;
444
444
  };
445
445
  warnings?: string[];
446
+ publishesRemaining?: number;
447
+ publishesResetAt?: number;
446
448
  contract?: string;
447
449
  updated?: boolean;
448
450
  audience?: string;
@@ -575,6 +577,7 @@ export type ArtifactOutput =
575
577
  max_bytes: number;
576
578
  };
577
579
  next?: string;
580
+ cowritten?: true;
578
581
  };
579
582
  }
580
583
  | {
@@ -584,6 +587,7 @@ export type ArtifactOutput =
584
587
  size_bytes: number;
585
588
  content_type: string;
586
589
  sha256: string;
590
+ cowritten?: true;
587
591
  };
588
592
  }
589
593
  | {
@@ -2904,7 +2908,7 @@ export interface ProposeSkillsInput {
2904
2908
  */
2905
2909
  target?: string;
2906
2910
  /**
2907
- * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
2911
+ * One short sentence saying when to use this skill: aim for under 200 characters, never more than 1024. Shown on the review card and saved as the skill's description, which is what decides when the skill is used. For an improvement, reuse the existing skill's description unless the change alters when the skill applies.
2908
2912
  */
2909
2913
  description: string;
2910
2914
  /**
@@ -2929,7 +2933,7 @@ export interface ProposeSkillsInput {
2929
2933
  */
2930
2934
  target?: string;
2931
2935
  /**
2932
- * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
2936
+ * One short sentence saying when to use this skill: aim for under 200 characters, never more than 1024. Shown on the review card and saved as the skill's description, which is what decides when the skill is used. For an improvement, reuse the existing skill's description unless the change alters when the skill applies.
2933
2937
  */
2934
2938
  description: string;
2935
2939
  /**
@@ -2952,7 +2956,7 @@ export interface ProposeSkillsInput {
2952
2956
  */
2953
2957
  target?: string;
2954
2958
  /**
2955
- * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
2959
+ * One short sentence saying when to use this skill: aim for under 200 characters, never more than 1024. Shown on the review card and saved as the skill's description, which is what decides when the skill is used. For an improvement, reuse the existing skill's description unless the change alters when the skill applies.
2956
2960
  */
2957
2961
  description: string;
2958
2962
  /**
@@ -2977,7 +2981,7 @@ export interface ProposeSkillsInput {
2977
2981
  */
2978
2982
  target?: string;
2979
2983
  /**
2980
- * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
2984
+ * One short sentence saying when to use this skill: aim for under 200 characters, never more than 1024. Shown on the review card and saved as the skill's description, which is what decides when the skill is used. For an improvement, reuse the existing skill's description unless the change alters when the skill applies.
2981
2985
  */
2982
2986
  description: string;
2983
2987
  /**
@@ -3000,7 +3004,7 @@ export interface ProposeSkillsInput {
3000
3004
  */
3001
3005
  target?: string;
3002
3006
  /**
3003
- * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
3007
+ * One short sentence saying when to use this skill: aim for under 200 characters, never more than 1024. Shown on the review card and saved as the skill's description, which is what decides when the skill is used. For an improvement, reuse the existing skill's description unless the change alters when the skill applies.
3004
3008
  */
3005
3009
  description: string;
3006
3010
  /**
@@ -3023,7 +3027,7 @@ export interface ProposeSkillsInput {
3023
3027
  */
3024
3028
  target?: string;
3025
3029
  /**
3026
- * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
3030
+ * One short sentence saying when to use this skill: aim for under 200 characters, never more than 1024. Shown on the review card and saved as the skill's description, which is what decides when the skill is used. For an improvement, reuse the existing skill's description unless the change alters when the skill applies.
3027
3031
  */
3028
3032
  description: string;
3029
3033
  /**
@@ -3055,6 +3059,7 @@ export interface ArtifactInput {
3055
3059
  | "publish"
3056
3060
  | "list"
3057
3061
  | "read"
3062
+ | "list_types"
3058
3063
  | "watch"
3059
3064
  | "unwatch"
3060
3065
  | "status"
package/sdk.d.ts CHANGED
@@ -1848,6 +1848,15 @@ export declare type Options = {
1848
1848
  * will be routed through this MCP tool instead of the default handler.
1849
1849
  */
1850
1850
  permissionPromptToolName?: string;
1851
+ /**
1852
+ * Who answers permission prompts. `'host'` (default): this process, through
1853
+ * `canUseTool` or `permissionPromptToolName`. `'none'`: nobody — the
1854
+ * permission mode (including auto mode's classifier), rules and hooks still
1855
+ * decide, and anything that would otherwise prompt is denied immediately
1856
+ * with a message telling Claude the session has no approval surface;
1857
+ * `canUseTool` is never called.
1858
+ */
1859
+ permissionPrompts?: 'host' | 'none';
1851
1860
  /**
1852
1861
  * Load plugins for this session. Plugins provide custom commands, agents,
1853
1862
  * skills, and hooks that extend Claude Code's capabilities.
@@ -3023,7 +3032,7 @@ export declare type RewindFilesResult = {
3023
3032
  insertions?: number;
3024
3033
  deletions?: number;
3025
3034
  /**
3026
- * Count of tracked files NOT restored or deleted because a symlink, hard link, or other non-regular file was detected at the tracked path, its parent directory no longer resolves to where it pointed when the checkpoint was taken, or its backup could not be safely read. Only populated by a real (non-dryRun) rewind — on a dryRun response the field is never set and the preview counts do not reflect link-safety refusals. Absent or 0 on a real rewind means no link-safety refusals occurred; other per-file failures (for example a missing backup file) are logged and reported in telemetry but are not counted here.
3035
+ * Count of tracked files NOT restored or deleted because a symlink, hard link, or other non-regular file was detected at the tracked path, its parent directory no longer resolves to where it pointed when the checkpoint was taken, or its backup could not be safely read. Only populated by a real (non-dryRun) rewind — on a dryRun response the field is never set and the preview counts do not reflect link-safety refusals. Absent or 0 on a real rewind means no link-safety refusals occurred; other per-file failures (for example a missing backup file) are not counted here; they are reported in telemetry, and when every differing file fails to restore the rewind itself fails (canRewind: false).
3027
3036
  */
3028
3037
  skippedLinks?: number;
3029
3038
  };
@@ -3283,6 +3292,10 @@ export declare type SDKAssistantMessage = {
3283
3292
  * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on the turn's FIRST reply frame only — the first assistant message in complete-message mode; with --include-partial-messages the stamp normally rides the first non-ping stream event instead (see SDKPartialAssistantMessage), and a turn that produces no stream events still stamps its first assistant message — so a consumer can bind the reply to the send it answers without waiting for the result. Wrapper-level sibling — never inside `message.content` — so it is not replayed to the model. Absent on every later frame of the turn, on subagent frames (parent_tool_use_id set), on synthetic/scheduled (meta) turns, on turns without a client uuid, and from older producers.
3284
3293
  */
3285
3294
  user_message_uuid?: string;
3295
+ /**
3296
+ * Client uuids of every user message whose prompt this turn has consumed so far, in consumption order — all members of a prompt batch the host merged into this one turn (several messages sent close together run as one turn whose user_message_uuid is the LAST member's), so a consumer that sent any of them can bind this reply to its own send by finding its uuid anywhere in the list. Always contains user_message_uuid; at most 64 entries. Present exactly when user_message_uuid is, on the same first reply frame only; absent from older producers (fall back to user_message_uuid).
3297
+ */
3298
+ user_message_uuids?: string[];
3286
3299
  /**
3287
3300
  * This turn continued the preceding truncated assistant turn inside its trailing signed thinking block (max-output-tokens recovery). Its thinking signatures are cumulative over that preceding thinking-only turn, so a history replayed through the bridge must carry this flag back for the normalizer to keep the run's prefix on the wire. Wrapper-level sibling — never inside `message.content` — so it is not replayed to the model.
3288
3301
  */
@@ -3304,6 +3317,7 @@ export declare type SDKAssistantMessage = {
3304
3317
  */
3305
3318
  task_description?: string;
3306
3319
 
3320
+
3307
3321
  /**
3308
3322
  * ISO timestamp of when this content block finished on the originating process. One API assistant turn may produce several assistant messages sharing a message.id, each with its own timestamp. Uses the originating host's clock, so it's for display only; do not order messages by this field. Older emitters omit it; consumers should fall back to receive time.
3309
3323
  */
@@ -4759,6 +4773,10 @@ export declare type SDKPartialAssistantMessage = {
4759
4773
  * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on the turn's FIRST non-ping stream event only (the frame that triggers the turn's initial ack) so a consumer can bind the reply stream to the send it answers without waiting for the result. Absent on every later stream event of the turn, on synthetic/scheduled (meta) turns, on turns without a client uuid, and from older producers.
4760
4774
  */
4761
4775
  user_message_uuid?: string;
4776
+ /**
4777
+ * Client uuids of every user message whose prompt this turn has consumed so far, in consumption order — all members of a prompt batch the host merged into this one turn (several messages sent close together run as one turn whose user_message_uuid is the LAST member's), so a consumer that sent any of them can bind this reply to its own send by finding its uuid anywhere in the list. Always contains user_message_uuid; at most 64 entries. Present exactly when user_message_uuid is, on the same first non-ping stream event only; absent from older producers (fall back to user_message_uuid).
4778
+ */
4779
+ user_message_uuids?: string[];
4762
4780
  };
4763
4781
 
4764
4782
  export declare type SDKPermissionDenial = {
@@ -4903,6 +4921,10 @@ export declare type SDKResultError = {
4903
4921
  * Client uuid of the user message that triggered this turn (submitMessage options.uuid), echoed back so a consumer can link this error result to the send it answers — the same join key the success variant echoes, carried alone (error turns have no request_sent_wall_ms to report). A delivery-failure result from the remote-session client echoes the failed send's queue key, which is client-minted when the host sent no uuid of its own. Absent on synthetic/scheduled (meta) turns, on turns without a client uuid, on session-scoped failures with no single triggering send (a crashed worker's zeroed result), and from older producers.
4904
4922
  */
4905
4923
  user_message_uuid?: string;
4924
+ /**
4925
+ * Client uuids of every user message whose prompt this turn consumed, in consumption order — all members of a prompt batch the host merged into this one turn (several messages sent close together run as one turn whose user_message_uuid is the LAST member's), then any queued user message folded into the running turn between tool rounds, once taken off the queue — so a consumer that sent any of them can bind this result to its own send by finding its uuid anywhere in the list. Always contains user_message_uuid; at most 64 entries; can be longer than the list on the turn's first reply frame. Present when a headless turn that ran echoes user_message_uuid; absent on delivery-failure and zeroed results and from older producers (fall back to user_message_uuid).
4926
+ */
4927
+ user_message_uuids?: string[];
4906
4928
  terminal_reason?: TerminalReason;
4907
4929
  fast_mode_state?: FastModeState;
4908
4930
  fast_mode_disabled_reason?: FastModeDisabledReason;
@@ -4925,7 +4947,12 @@ export declare type SDKResultSuccess = {
4925
4947
  ttft_stream_ms?: number;
4926
4948
  time_to_request_ms?: number;
4927
4949
  user_message_uuid?: string;
4950
+ user_message_uuids?: string[];
4928
4951
  request_sent_wall_ms?: number;
4952
+ first_content_frame_ms?: number;
4953
+ first_stream_post_ms?: number;
4954
+ first_stream_post_ack_ms?: number;
4955
+ first_stream_post_wall_ms?: number;
4929
4956
  time_to_request_from_spawn_ms?: number;
4930
4957
  warm_spare_claimed?: boolean;
4931
4958
  time_origin_ms?: number;
@@ -5158,6 +5185,9 @@ export declare type SDKTaskProgressMessage = {
5158
5185
  duration_ms: number;
5159
5186
  };
5160
5187
  last_tool_name?: string;
5188
+ /**
5189
+ * A one-line status for the task's row. For a local_agent task it is the model-generated progress summary (only when the agentProgressSummaries option is on); for a backgrounded mcp_task it is the MCP server's own bounded status message, emitted once per change without any option. Render it when present regardless of task type.
5190
+ */
5161
5191
  summary?: string;
5162
5192
 
5163
5193
  uuid: UUID;
@@ -5227,6 +5257,10 @@ export declare type SDKThinkingTokensMessage = {
5227
5257
  subtype: 'thinking_tokens';
5228
5258
  estimated_tokens: number;
5229
5259
  estimated_tokens_delta: number;
5260
+ /**
5261
+ * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on every thinking_tokens frame of a headless (stream-json / Agent SDK) turn so a consumer can attribute thinking progress to the send it answers before any reply frame arrives. Absent on synthetic/scheduled (meta) turns, on turns without a client uuid, on Remote Control (interactive terminal) sessions, and from older producers.
5262
+ */
5263
+ user_message_uuid?: string;
5230
5264
  uuid: UUID;
5231
5265
  session_id: string;
5232
5266
  };
@@ -5888,7 +5922,15 @@ export declare interface Settings {
5888
5922
  */
5889
5923
  disableBundledSkills?: boolean;
5890
5924
  /**
5891
- * Enterprise allowlist of MCP servers that can be used. Applies to all scopes including enterprise servers from managed-mcp.json. If undefined, all servers are allowed. If empty array, no servers are allowed. Denylist takes precedence - if a server is on both lists, it is denied.
5925
+ * MCP servers the organization provides to every user, keyed by server name, each with the .mcp.json entry shape; only "http" and "sse" servers are accepted (nothing that names a program to run, no ${VAR} references). Honored from managed settings only; users cannot remove them, deniedMcpServers still applies, and they need no allowedMcpServers entry. Not read in Claude Desktop's Code tab on a third-party deployment or in Cowork sessions, where Claude Desktop supplies and locks the session's MCP servers itself.
5926
+ */
5927
+ managedMcpServers?: {
5928
+ [k: string]: {
5929
+ [k: string]: unknown;
5930
+ };
5931
+ };
5932
+ /**
5933
+ * Enterprise allowlist of the MCP servers users may use. Governs servers users add (user, project and local config, --mcp-config, agent frontmatter, plugins, claude.ai connectors); servers the organization itself delivers (managedMcpServers, and managed-mcp.json entries that use no ${VAR} expansion) are allowed without being listed; a managed-mcp.json entry that uses ${VAR} expansion is still checked against this list. If undefined, all servers are allowed. If empty array, users can use no servers of their own. Denylist takes precedence - if a server is on both lists, it is denied.
5892
5934
  */
5893
5935
  allowedMcpServers?: {
5894
5936
  /**
@@ -7481,7 +7523,7 @@ export declare interface Settings {
7481
7523
  */
7482
7524
  parentSettingsBehavior?: 'first-wins' | 'merge';
7483
7525
  /**
7484
- * 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 and arrays union, except fallbackModel, the restriction allowlists allowedMcpServers, availableModels, strictKnownMarketplaces and allowedChannelPlugins, and sandbox.credentials.awsPairs and sandbox.ripgrep (the highest source that sets one owns it whole) and the auth pins forceLoginOrgUUID, forceLoginMethod and forceLoginGatewayUrl (highest source only). 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.
7526
+ * 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 and arrays union, except fallbackModel, the restriction allowlists allowedMcpServers, availableModels, strictKnownMarketplaces and allowedChannelPlugins, and sandbox.credentials.awsPairs and sandbox.ripgrep (the highest source that sets one owns it whole), managedMcpServers (server names union; a name set by two sources takes the higher source's whole entry) and the auth pins forceLoginOrgUUID, forceLoginMethod and forceLoginGatewayUrl (highest source only). 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.
7485
7527
  */
7486
7528
  managedSourcesBehavior?: 'first-wins' | 'merge';
7487
7529
  /**
@@ -7993,6 +8035,7 @@ export declare interface Settings {
7993
8035
  * Disable auto mode
7994
8036
  */
7995
8037
  disableAutoMode?: 'disable';
8038
+
7996
8039
  /**
7997
8040
  * SSH connection configurations for remote environments. Typically set in managed settings by enterprise administrators to pre-configure SSH connections for team members.
7998
8041
  */
@@ -8112,6 +8155,7 @@ export declare interface Settings {
8112
8155
  * Start Remote Control bridge automatically each session
8113
8156
  */
8114
8157
  remoteControlAtStartup?: boolean;
8158
+
8115
8159
  /**
8116
8160
  * Require explicit approval before SendMessage can reach a peer session on another machine via Remote Control
8117
8161
  */
@@ -8494,6 +8538,7 @@ export declare type ToolConfig = {
8494
8538
  * @default 'markdown'
8495
8539
  */
8496
8540
  previewFormat?: 'markdown' | 'html';
8541
+
8497
8542
  };
8498
8543
  };
8499
8544