@anthropic-ai/claude-agent-sdk 0.3.277 → 0.3.280

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,55 +1,53 @@
1
1
  {
2
- "version": "2.1.277",
2
+ "version": "2.1.280",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "97305f0832e6b778bb99e69b4f5f1438e3905624",
5
- "modsCommit": "31a3b00bef145a0393d9dbf840a98674fec07712",
6
- "buildDate": "2026-09-18T15:47:59Z",
4
+ "commit": "80abbfe7d7232280011ff01a21ae3338f4c6e372",
5
+ "modsCommit": "8187baaaafb3a9ada02d3d6fb4e8d68587aef6b0",
6
+ "buildDate": "2026-09-21T20:55:27Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude",
10
- "checksum": "73d6a2a55c46907e49bd8bb7608e134333bd71173351ee16ddce7d7db9914b9c",
11
- "size": 217662576
10
+ "checksum": "387a5c5dcdbb815085edf0baf79591f9d8894efe922bceaf3d75b1b08055229d",
11
+ "size": 217254576
12
12
  },
13
13
  "darwin-x64": {
14
14
  "binary": "claude",
15
- "checksum": "82b74d616e360cdff37dd1cecdf03e6bdfaa02411d914faac7af22a273a3132d",
16
- "size": 226488928
15
+ "checksum": "c1d32d87630482250633208ab77855429b24010ae3086a7ff7539b57b93168d4",
16
+ "size": 225565024
17
17
  },
18
18
  "linux-arm64": {
19
19
  "binary": "claude",
20
- "checksum": "242c4d743beabc822edd8f247101bb800b4036c69e74b9e2a1adb120dfe46f5d",
21
- "size": 234021104
20
+ "checksum": "92f2b4fd05d0bdcf7b9a0d4e0ecef4a1e4b368b290cd8fd07cff9a50013f45a2",
21
+ "size": 233103352
22
22
  },
23
23
  "linux-x64": {
24
24
  "binary": "claude",
25
- "checksum": "722210f05ba494d8f6df69423c4d4f2960900f7a007d0532851c7a36e375cab7",
26
- "size": 234082616
25
+ "checksum": "1e08503dbdf3c2cb0d706d32f3408277388d1c76ef108673e8fe42c1b322925b",
26
+ "size": 233709640
27
27
  },
28
28
  "linux-arm64-musl": {
29
29
  "binary": "claude",
30
- "checksum": "79a1c804e39ec34c44a14cf66c0a0af570bd9e4bc58c3e6a63db3746e34d0b42",
31
- "size": 226637472
30
+ "checksum": "6a9f349dccd1c74ab854f1877c5ebdf074998571d0177e26c1f7f46f29e0f971",
31
+ "size": 225457992
32
32
  },
33
33
  "linux-x64-musl": {
34
34
  "binary": "claude",
35
- "checksum": "297f6ac78b70b365ee1e4ffce1841916e31541a4ff625427363c39cd0da245f0",
36
- "size": 227999704
35
+ "checksum": "8d25ffbf600882d7b985706cc10ea45995060637ed009b5700b65e162bb00b96",
36
+ "size": 227467360
37
37
  },
38
38
  "win32-x64": {
39
39
  "binary": "claude.exe",
40
- "checksum": "c800bc865f08cdfa27a47b2134beb86258a64c1ca817de67514b6981811fe964",
41
- "size": 237195936
40
+ "checksum": "0e4195524b73eb77efbdf3e2b36de5322a29f0ca575dfd2d9b4f946b1d425469",
41
+ "size": 237100192
42
42
  },
43
43
  "win32-arm64": {
44
44
  "binary": "claude.exe",
45
- "checksum": "e315ec5fc16695c60e9ba31a25a568d273b720293a90ff384277c3cf2e7315ad",
46
- "size": 228420256
45
+ "checksum": "f49980314f4c0418079979723ffd6c0d00d57e60b26fd95c53e53155ed913bdf",
46
+ "size": 225107104
47
47
  }
48
48
  },
49
49
  "sdkCompat": {
50
50
  "testedWrapperVersions": [
51
- "0.3.238",
52
- "0.3.239",
53
51
  "0.3.240",
54
52
  "0.3.241",
55
53
  "0.3.242",
@@ -77,7 +75,9 @@
77
75
  "0.3.273",
78
76
  "0.3.274",
79
77
  "0.3.275",
80
- "0.3.276"
78
+ "0.3.276",
79
+ "0.3.277",
80
+ "0.3.278"
81
81
  ],
82
82
  "harnessSchema": 1
83
83
  }
package/manifest.zst.json CHANGED
@@ -1,63 +1,61 @@
1
1
  {
2
- "version": "2.1.277",
2
+ "version": "2.1.280",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "97305f0832e6b778bb99e69b4f5f1438e3905624",
5
- "modsCommit": "31a3b00bef145a0393d9dbf840a98674fec07712",
6
- "buildDate": "2026-09-18T15:49:17Z",
4
+ "commit": "80abbfe7d7232280011ff01a21ae3338f4c6e372",
5
+ "modsCommit": "8187baaaafb3a9ada02d3d6fb4e8d68587aef6b0",
6
+ "buildDate": "2026-09-21T20:56:45Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude.zst",
10
- "checksum": "b38ef37f90ba98786fc44f288cf890bec9f62810d8be07aa491d8f6172ec9c6a",
11
- "size": 71675515,
10
+ "checksum": "214fafd9d60bc0397cb68747b765ab752be4b53303c176ad885c4cafbe30826f",
11
+ "size": 72900982,
12
12
  "bundle": {
13
- "checksum": "f9cabb053a8ead7c298bded6d843d08e4d5194d0e4c3f0551571bea526d2d425",
14
- "size": 71676812
13
+ "checksum": "5882f558c44d569dd35047588143a536711d4e415bebf94da1543a25e5bc5898",
14
+ "size": 72903461
15
15
  }
16
16
  },
17
17
  "darwin-x64": {
18
18
  "binary": "claude.zst",
19
- "checksum": "bee1d852faf037f2673af4a74f35f7c43ce8c00d0ef296c212401f55d62d1818",
20
- "size": 75868790,
19
+ "checksum": "2b5ca074d02ea5dd507db0a90ba55847e297061ca3e987ddc49ea89ae0ff2e7e",
20
+ "size": 77008555,
21
21
  "bundle": {
22
- "checksum": "7e10c4e982d5a5d500b7038f21956e167d1df4ecdbfc9d913c21db723ca8f9c9",
23
- "size": 75866802
22
+ "checksum": "bf78bfd5af2400f39d21378198f689c3856d7a11aeb9919b012f27143e946cbf",
23
+ "size": 77013965
24
24
  }
25
25
  },
26
26
  "linux-arm64": {
27
27
  "binary": "claude.zst",
28
- "checksum": "e8d9ef094114b18e679bf19430fa6e8726f29e0edb6cc1369180a8fb5ef89697",
29
- "size": 80841084
28
+ "checksum": "6a01f30418f35122a672ccf74bed64aba5119ad47c71548a3b447cc9fec48c81",
29
+ "size": 82030081
30
30
  },
31
31
  "linux-x64": {
32
32
  "binary": "claude.zst",
33
- "checksum": "5c7be0316eeedcf76211ef5f090e18871669dc81d556078ce9fa4e79376ce2aa",
34
- "size": 81464550
33
+ "checksum": "27910e2ae704d8f2e8024897d8fdf1e7710807baf4f6982c0e3797c058315384",
34
+ "size": 82761570
35
35
  },
36
36
  "linux-arm64-musl": {
37
37
  "binary": "claude.zst",
38
- "checksum": "de011da024068e61a0dcc94a0da78f2ef49a5e471fd74debbb62abc44723b5e0",
39
- "size": 79290399
38
+ "checksum": "32dbe8a94da9689791688e0febfb88c39897ad67f055853e7ae1b6d11c4b4e39",
39
+ "size": 80444179
40
40
  },
41
41
  "linux-x64-musl": {
42
42
  "binary": "claude.zst",
43
- "checksum": "01a115bd0fb502ba934d8a4a731a4f04d5d8fddc5c2136e245048dbaa03af1d6",
44
- "size": 79950042
43
+ "checksum": "2b2e206987e357997bf5c06baf697379b5980a7cc6f1462ca70a6757ece58890",
44
+ "size": 81193598
45
45
  },
46
46
  "win32-x64": {
47
47
  "binary": "claude.exe.zst",
48
- "checksum": "f37b992dd447254ffb602df6678aeb55342af0fc74588c75790384fd940558e8",
49
- "size": 83858446
48
+ "checksum": "cb50dbe5b595b52925d753b10d5907748a4137e7f0bff84d03ea60cd9a28eaf9",
49
+ "size": 85069447
50
50
  },
51
51
  "win32-arm64": {
52
52
  "binary": "claude.exe.zst",
53
- "checksum": "57a18f5f0a703cc6abf295097fd4ed3df15b92e8befe9d9522036f82ce1790da",
54
- "size": 80627656
53
+ "checksum": "705dccf9d924d471e32efa19157283da2cdd0b8cfc71d7e0a9e3ec4d13ac381b",
54
+ "size": 81530251
55
55
  }
56
56
  },
57
57
  "sdkCompat": {
58
58
  "testedWrapperVersions": [
59
- "0.3.238",
60
- "0.3.239",
61
59
  "0.3.240",
62
60
  "0.3.241",
63
61
  "0.3.242",
@@ -85,7 +83,9 @@
85
83
  "0.3.273",
86
84
  "0.3.274",
87
85
  "0.3.275",
88
- "0.3.276"
86
+ "0.3.276",
87
+ "0.3.277",
88
+ "0.3.278"
89
89
  ],
90
90
  "harnessSchema": 1
91
91
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.277",
3
+ "version": "0.3.280",
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.277",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.277",
62
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.277",
63
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.277",
64
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.277",
65
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.277",
66
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.277",
67
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.277"
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.280",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.280",
62
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.280",
63
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.280",
64
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.280",
65
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.280",
66
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.280",
67
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.280"
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.277"
83
+ "claudeCodeVersion": "2.1.280"
84
84
  }
package/sdk.d.ts CHANGED
@@ -1206,6 +1206,10 @@ export declare type McpServerStatus = {
1206
1206
  destructive?: boolean;
1207
1207
  openWorld?: boolean;
1208
1208
  };
1209
+ /**
1210
+ * The MCP Apps (SEP-1865) members of the tool's `_meta`, for a host that renders the tool's `ui://` resource, under the keys the server used: `ui` (an object: `resourceUri`, a `ui://` string; `visibility`, an array of 'model' | 'app'; and any other member the server sent) and the deprecated flat `ui/resourceUri` (a `ui://` string). Validated and size-bounded; every other `_meta` key is withheld. Present only on a tool that declares one, from CLIs that advertise `mcp_tool_ui_meta_v1`.
1211
+ */
1212
+ _meta?: Record<string, unknown>;
1209
1213
  }[];
1210
1214
 
1211
1215
  };
@@ -1795,6 +1799,30 @@ export declare type Options = {
1795
1799
  * subagent conversation is forwarded so consumers can render a nested transcript.
1796
1800
  */
1797
1801
  forwardSubagentText?: boolean;
1802
+ /**
1803
+ * Send every user message with `client_composed: true`, so the CLI delivers
1804
+ * the prompt text as written: no `@path` file-mention expansion and no
1805
+ * slash-command dispatch. Use when prompt text is assembled from content
1806
+ * the end user did not type. Covers string prompts, streamed messages and
1807
+ * `Query.streamInput()`. While the option is on there is no per-message
1808
+ * opt-out; for per-turn control, leave it off and set `client_composed: true`
1809
+ * on individual streamed messages instead.
1810
+ *
1811
+ * On current CLIs a turn delivered this way also skips the CLI's turn-start
1812
+ * attachment pass as a whole: `@server:resource` MCP mentions are not
1813
+ * expanded either, and the prompt is sent without the context the CLI
1814
+ * normally attaches alongside it (nested `CLAUDE.md` and rules files, skill
1815
+ * and tool listings, and the CLI's other per-turn reminders). The pass the
1816
+ * CLI runs between tool calls is unaffected, so most of that context arrives
1817
+ * after the turn's first tool call rather than with the prompt. Narrowing
1818
+ * the skip to `@path` expansion and slash-command dispatch alone is
1819
+ * CLI-side follow-up work.
1820
+ *
1821
+ * Requires Claude Code 2.1.248 or later; older CLIs ignore the field.
1822
+ *
1823
+ * @default false
1824
+ */
1825
+ verbatimPrompts?: boolean;
1798
1826
  /**
1799
1827
  * Controls Claude's thinking/reasoning behavior.
1800
1828
  *
@@ -2711,6 +2739,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2711
2739
  }>;
2712
2740
 
2713
2741
 
2742
+
2714
2743
  /**
2715
2744
  * Change the model used for subsequent responses.
2716
2745
  * Only available in streaming input mode.
@@ -2873,6 +2902,13 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2873
2902
  skipBehaviors?: boolean;
2874
2903
  }): Promise<SDKControlGetUsageResponse>;
2875
2904
 
2905
+
2906
+
2907
+
2908
+
2909
+
2910
+
2911
+
2876
2912
  /**
2877
2913
  * Read a file from the session's filesystem for the remote sidebar
2878
2914
  * viewer. Path is resolved against cwd and gated by the same
@@ -2887,6 +2923,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2887
2923
  maxBytes?: number;
2888
2924
  encoding?: 'utf-8' | 'base64';
2889
2925
  }): Promise<SDKControlReadFileResponse | null>;
2926
+
2890
2927
  /**
2891
2928
  * Reload plugins from disk and return the refreshed commands, agents,
2892
2929
  * plugins, and MCP server status.
@@ -2970,6 +3007,19 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2970
3007
  * @param enabled - Whether the server should be enabled
2971
3008
  */
2972
3009
  toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;
3010
+ /**
3011
+ * Read one MCP Apps (SEP-1865) UI resource from a connected MCP server the
3012
+ * CLI itself dialed, so the host can render a tool's widget. `uri` must use
3013
+ * the `ui://` scheme, typically the `_meta.ui.resourceUri` a tool
3014
+ * declares. The contents are untrusted third-party HTML: render them
3015
+ * sandboxed. Requires a CLI that advertises `mcp_read_resource_v1` in
3016
+ * `system/init.capabilities`. Throws on failure.
3017
+ *
3018
+ * @param serverName - The server's name, as `mcpServerStatus()` reports it
3019
+ * @param uri - A `ui://` resource URI
3020
+ * @alpha
3021
+ */
3022
+ readMcpResource(serverName: string, uri: string): Promise<SDKControlMcpReadResourceResponse>;
2973
3023
 
2974
3024
 
2975
3025
 
@@ -3448,6 +3498,7 @@ export declare type SDKAssistantMessage = {
3448
3498
  task_description?: string;
3449
3499
 
3450
3500
 
3501
+
3451
3502
  /**
3452
3503
  * 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.
3453
3504
  */
@@ -4296,6 +4347,7 @@ declare type SDKControlInitializeRequest = {
4296
4347
  plugins?: coreTypes.SdkPluginConfig[];
4297
4348
 
4298
4349
 
4350
+
4299
4351
  };
4300
4352
 
4301
4353
  /**
@@ -4453,6 +4505,40 @@ declare type SDKControlMcpMessageRequest = {
4453
4505
  message: JSONRPCMessage;
4454
4506
  };
4455
4507
 
4508
+ /**
4509
+ * Reads one MCP Apps (SEP-1865) UI resource — a `ui://` URI, typically the `_meta.ui.resourceUri` a tool declares — from a connected MCP server the CLI itself dialed, with `resources/read`, for a host that renders it. Read-only and no model turn. The reply is untrusted third-party content (HTML): render it sandboxed. SDK-type MCP servers (config.type === "sdk") are rejected — they are caller-provided, so the caller can read them directly. Errors name the cause: a non-ui:// URI, an unknown server, a server that managed policy blocks, that is disabled or that the project has not approved (the refusals mcp_reconnect gives), a server that is not connected (failed, pending or needs-auth: send mcp_reconnect; a connected server, or one still listed from the discovery cache, is read through the same connect path a tool call takes), a response over the size limit, or the server's own resources/read error. Refused on a lane that redacts what it persists (a Remote Control bridge worker, a tenant worker) and by the client of a cloud-hosted session. Advertised as `mcp_read_resource_v1` in system/init.capabilities.
4510
+ */
4511
+ declare type SDKControlMcpReadResourceRequest = {
4512
+ subtype: 'mcp_read_resource';
4513
+ /**
4514
+ * Server name, as mcp_status reports it (not normalized).
4515
+ */
4516
+ serverName: string;
4517
+ /**
4518
+ * The resource to read. Must use the ui:// scheme; any other URI is refused.
4519
+ */
4520
+ uri: string;
4521
+ };
4522
+
4523
+ /**
4524
+ * The server's resources/read result for an mcp_read_resource request.
4525
+ */
4526
+ export declare type SDKControlMcpReadResourceResponse = {
4527
+ contents: {
4528
+ uri: string;
4529
+ mimeType?: string;
4530
+ text?: string;
4531
+ /**
4532
+ * Base64, for a binary item.
4533
+ */
4534
+ blob?: string;
4535
+ /**
4536
+ * The content item's own `_meta`, as the server sent it (MCP Apps puts the resource's `ui.csp` and `ui.permissions` here).
4537
+ */
4538
+ _meta?: Record<string, unknown>;
4539
+ }[];
4540
+ };
4541
+
4456
4542
  /**
4457
4543
  * Reconnects a disconnected or failed MCP server.
4458
4544
  */
@@ -4696,7 +4782,7 @@ export declare type SDKControlRequest = {
4696
4782
 
4697
4783
  };
4698
4784
 
4699
- declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlListModelsRequest | SDKControlGetUsageRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlRegisterRepoRootRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlReloadOutputStylesRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlGetHooksListingRequest | SDKControlUpdateSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlListPermissionRulesRequest;
4785
+ declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlListModelsRequest | SDKControlGetUsageRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlRegisterRepoRootRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlReloadOutputStylesRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlGetHooksListingRequest | SDKControlUpdateSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlListPermissionRulesRequest | SDKControlMcpReadResourceRequest;
4700
4786
 
4701
4787
  /**
4702
4788
  * Progress for a long-running client-originated control_request (currently only side_question), correlated by request_id. status 'started' means the worker accepted the request and launched the work; 'api_retry' carries the same retry counters as SDKAPIRetryMessage and is present only for that status.
@@ -5063,9 +5149,13 @@ export declare type SDKMessageOrigin = {
5063
5149
  } | {
5064
5150
  kind: 'task-notification';
5065
5151
  /**
5066
- * Present when the delivery is the fired stored prompt of a scheduled task/routine ('scheduled-trigger', stamped from server-asserted provenance; the schedule attests storage, not authorship) or a coordinator co-member SendMessage delivery ('peer-send-message': model-authored text from another of the same user's sessions, verified by the server-stamped receiver co-membership — task-notification for prompt authority, but distinguishable so the receive-side crossSessionInbound setting can apply to it). The harness frames a scheduled-trigger delivery as the session's assigned task instead of the generic background-notification frame. Absent on webhook, PR-steward, plugin, and background-event deliveries.
5152
+ * Present when the delivery is the fired stored prompt of a scheduled task/routine ('scheduled-trigger', stamped from server-asserted provenance, or declared by a local host for its own scheduled runs; the schedule attests storage, not authorship) or a coordinator co-member SendMessage delivery ('peer-send-message': model-authored text from another of the same user's sessions, verified by the server-stamped receiver co-membership — task-notification for prompt authority, but distinguishable so the receive-side crossSessionInbound setting can apply to it). The harness frames a scheduled-trigger delivery as the session's assigned task instead of the generic background-notification frame. Absent on webhook, PR-steward, plugin, and background-event deliveries.
5067
5153
  */
5068
5154
  subkind?: 'scheduled-trigger' | 'peer-send-message' | 'projects-relay';
5155
+ /**
5156
+ * On a 'scheduled-trigger' delivery, why it fired: a short lowercase token such as 'scheduled', 'manual', 'retry', 'catch_up' or 'api'. Set by the server for cloud routines, or declared by a local host for its own scheduled runs, which is honored only in a process the host started with CLAUDE_CODE_HOST_SCHEDULED_RUN=1 (a local host's value is kept only if it is 1 to 32 lowercase letters or underscores); absent when neither sent one.
5157
+ */
5158
+ fireReason?: string;
5069
5159
  } | {
5070
5160
  kind: 'coordinator';
5071
5161
  } | {
@@ -5926,7 +6016,10 @@ export declare type SDKUserMessage = {
5926
6016
  timestamp?: string;
5927
6017
 
5928
6018
 
5929
-
6019
+ /**
6020
+ * The client composed this turn from content the user did not type; the CLI delivers its text as written, with no `@path` file-mention expansion and no slash-command dispatch. On current CLIs the turn-start attachment pass is skipped as a whole: `@server:resource` MCP mentions are not expanded either, and the prompt is sent without the context the CLI normally attaches alongside it (nested `CLAUDE.md` and rules files, skill and tool listings, reminders); the pass the CLI runs between tool calls is unaffected.
6021
+ */
6022
+ client_composed?: true;
5930
6023
 
5931
6024
 
5932
6025
 
@@ -5945,6 +6038,10 @@ export declare type SDKUserMessage = {
5945
6038
  * 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`.
5946
6039
  */
5947
6040
  pasted_content?: MessageParam['content'][];
6041
+ /**
6042
+ * Text the user pasted that is still in `message.content` where they put it: each entry one paste. The prompt is not changed by the host; the CLI may wrap each entry in `<pasted_content>` tags where it still stands in the last text block. For a paste the host took out of `message`, use `pasted_content` instead.
6043
+ */
6044
+ inline_pastes?: string[];
5948
6045
  session_id?: string;
5949
6046
  /**
5950
6047
  * Subagent type that produced this message.
@@ -6007,7 +6104,10 @@ export declare type SDKUserMessageReplay = {
6007
6104
  timestamp?: string;
6008
6105
 
6009
6106
 
6010
-
6107
+ /**
6108
+ * The client composed this turn from content the user did not type; the CLI delivers its text as written, with no `@path` file-mention expansion and no slash-command dispatch. On current CLIs the turn-start attachment pass is skipped as a whole: `@server:resource` MCP mentions are not expanded either, and the prompt is sent without the context the CLI normally attaches alongside it (nested `CLAUDE.md` and rules files, skill and tool listings, reminders); the pass the CLI runs between tool calls is unaffected.
6109
+ */
6110
+ client_composed?: true;
6011
6111
 
6012
6112
 
6013
6113
 
@@ -6818,7 +6918,7 @@ export declare interface Settings {
6818
6918
  location?: string;
6819
6919
  };
6820
6920
  /**
6821
- * Disable all hooks and statusLine execution
6921
+ * Disable all hooks and statusLine execution: the hooks defined in settings files and by installed plugins. Features built into Claude Code are not hooks in this sense and keep working; each has its own switch.
6822
6922
  */
6823
6923
  disableAllHooks?: boolean;
6824
6924
  /**
@@ -6878,7 +6978,7 @@ export declare interface Settings {
6878
6978
  */
6879
6979
  respondToBashCommands?: boolean;
6880
6980
  /**
6881
- * When true (and set in managed settings), only hooks from managed settings run. User, project, and local hooks are ignored.
6981
+ * When true (and set in managed settings), only hooks from managed settings and from plugins that managed settings enable run. User, project, and local hooks and the hooks of plugins the user installed are ignored. Features built into Claude Code are not hooks in this sense and keep working.
6882
6982
  */
6883
6983
  allowManagedHooksOnly?: boolean;
6884
6984
  /**
@@ -9146,7 +9246,7 @@ export declare type SyncHookJSONOutput = {
9146
9246
  * element of a `string[]` `systemPrompt`, or as a line of its own in a
9147
9247
  * `--system-prompt` string, to opt in; content before it gets global
9148
9248
  * cache scope, content after does not. See `splitSysPromptPrefix` in
9149
- * `src/utils/api.ts`.
9249
+ * `src/services/api/requestAttribution.ts`.
9150
9250
  */
9151
9251
  export declare const SYSTEM_PROMPT_DYNAMIC_BOUNDARY = "__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__";
9152
9252