@anthropic-ai/claude-agent-sdk 0.3.274 → 0.3.276

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.274",
2
+ "version": "2.1.276",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "1efcc1361e649ab98800b43a7df307043397a9ba",
5
- "modsCommit": "744fb6ab02aca7c50c43f1676a870cff184e1fca",
6
- "buildDate": "2026-09-16T21:56:00Z",
4
+ "commit": "bc0a4292e0472d227ceecb07d892ab1a777a4926",
5
+ "modsCommit": "68ac8bbf0245b615b41517bf8f2b2f35af1ae31d",
6
+ "buildDate": "2026-09-18T00:49:31Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude",
10
- "checksum": "3509913f9d1576316c8845b88837f8fd3bbbcf26625833ac82cfb6b8985da94a",
11
- "size": 214149552
10
+ "checksum": "9de364db11a410d53cbbb0f6b1f18c66c90053efc9a63370072856d10db66329",
11
+ "size": 215643408
12
12
  },
13
13
  "darwin-x64": {
14
14
  "binary": "claude",
15
- "checksum": "b18e8c9d7666d8987a174ac65e0019f4ba6befa73d2f75c05cbe92e5093431eb",
16
- "size": 222955360
15
+ "checksum": "cf0b4af7bce5d991a577d1150e86d45b7b83ef57cdb0384044ca54661ded24c6",
16
+ "size": 224441440
17
17
  },
18
18
  "linux-arm64": {
19
19
  "binary": "claude",
20
- "checksum": "2db904daea17addff9de557ba26a725916888aa7b546e2c5dd989c20d9d49ab3",
21
- "size": 230482160
20
+ "checksum": "e9ac3df956083645578a382ad64ec304468666e362c33bfdefd803cd6ff596b0",
21
+ "size": 231989488
22
22
  },
23
23
  "linux-x64": {
24
24
  "binary": "claude",
25
- "checksum": "15e2d05148f801b5774032faad87e624ecd172e9903288bda448b892eb58fa07",
26
- "size": 230580536
25
+ "checksum": "8a56c8a14bd3cb246e2bdb7e60aefe0f609bff78c8bbcc5ea6b1817c111c6145",
26
+ "size": 232059192
27
27
  },
28
28
  "linux-arm64-musl": {
29
29
  "binary": "claude",
30
- "checksum": "5d50bd99667904879d95142dbd604b24d0273c13fb79f3abc2346cb00048049f",
31
- "size": 223098528
30
+ "checksum": "fa56170180251debb60b2f10f3d27311738d907553f717b4f961fe72848856c1",
31
+ "size": 224605856
32
32
  },
33
33
  "linux-x64-musl": {
34
34
  "binary": "claude",
35
- "checksum": "9f64fb9e79752c676234087573f05a794e2a8fbd49c91482c6567be258752e15",
36
- "size": 224501720
35
+ "checksum": "396c3914f3e25b6c66535a55ea06ce9927896ffb7cd25f368c703e06373ff97e",
36
+ "size": 225980376
37
37
  },
38
38
  "win32-x64": {
39
39
  "binary": "claude.exe",
40
- "checksum": "4e4c1746aff835bb05e5ed14cda72d21ee6fbda4147aa99b3135718614da117e",
41
- "size": 233691808
40
+ "checksum": "a863895d829a246d97c1b881fae85593aab97b5b7ea5436ad964798f5f48a022",
41
+ "size": 235169440
42
42
  },
43
43
  "win32-arm64": {
44
44
  "binary": "claude.exe",
45
- "checksum": "da93e462c34ec86efee80c70ac791d3232ed98bd44c6abbafb1b5ffa2a9185c4",
46
- "size": 224916128
45
+ "checksum": "a0edbfbb634837d52b6408562419b487a62c61557d32d018c78142e5471555d9",
46
+ "size": 226394272
47
47
  }
48
48
  },
49
49
  "sdkCompat": {
50
50
  "testedWrapperVersions": [
51
- "0.3.235",
52
- "0.3.236",
53
51
  "0.3.237",
54
52
  "0.3.238",
55
53
  "0.3.239",
@@ -77,7 +75,9 @@
77
75
  "0.3.270",
78
76
  "0.3.271",
79
77
  "0.3.272",
80
- "0.3.273"
78
+ "0.3.273",
79
+ "0.3.274",
80
+ "0.3.275"
81
81
  ],
82
82
  "harnessSchema": 1
83
83
  }
package/manifest.zst.json CHANGED
@@ -1,63 +1,61 @@
1
1
  {
2
- "version": "2.1.274",
2
+ "version": "2.1.276",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "1efcc1361e649ab98800b43a7df307043397a9ba",
5
- "modsCommit": "744fb6ab02aca7c50c43f1676a870cff184e1fca",
6
- "buildDate": "2026-09-16T21:57:10Z",
4
+ "commit": "bc0a4292e0472d227ceecb07d892ab1a777a4926",
5
+ "modsCommit": "68ac8bbf0245b615b41517bf8f2b2f35af1ae31d",
6
+ "buildDate": "2026-09-18T00:50:49Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude.zst",
10
- "checksum": "7b1d7e51232bf46da0ad4d84d3c9821933275b3712111c4a94c18c4ede8e9694",
11
- "size": 70548622,
10
+ "checksum": "c152f199101ffb6a197fa79f3c1617f2e4ad72d9dd4ccef36559696bc6fbbf60",
11
+ "size": 71019331,
12
12
  "bundle": {
13
- "checksum": "e655712248ebb48efe48daf7c8920be45989d77fcd4c9b812bf7e259393a95a6",
14
- "size": 70550725
13
+ "checksum": "38d7c719597489b2b79069161d3b9e93b907f5e44b97cd44e479f0742a9eaa1e",
14
+ "size": 71024230
15
15
  }
16
16
  },
17
17
  "darwin-x64": {
18
18
  "binary": "claude.zst",
19
- "checksum": "90b036a45b6d99de8b01051148953617060fd464e9f1f18996f3799e57e8f198",
20
- "size": 74720985,
19
+ "checksum": "a7c803a21afc1f0e14aac3819de14a031cc259212de04ac14831c2ecac019f5b",
20
+ "size": 75199422,
21
21
  "bundle": {
22
- "checksum": "17faafe638136427f4d719d7ea060298ee7e6f3e38803f4809c26556dd0efc1b",
23
- "size": 74724749
22
+ "checksum": "49e425e56529477345458b2ed194eeddb24f9af457ae48e0a5895669343a3b62",
23
+ "size": 75199821
24
24
  }
25
25
  },
26
26
  "linux-arm64": {
27
27
  "binary": "claude.zst",
28
- "checksum": "5873a7beb9793643b9c0287f5873ea507e92f33477b1bbb86f0451caaf08b8fd",
29
- "size": 79737410
28
+ "checksum": "2e0040597f5723fdc0608d11f84674e734a3bae0a3b23b7a0712c99e0d5fb5d8",
29
+ "size": 80195460
30
30
  },
31
31
  "linux-x64": {
32
32
  "binary": "claude.zst",
33
- "checksum": "ea049d5d46d5e6deaaadef9549f45879917d39a196d912c99bd3981a0cfdc7d8",
34
- "size": 80357615
33
+ "checksum": "0b2e7bfc53a34b64d03af28509f7803623efb02a7be598509981f937fe2849a8",
34
+ "size": 80820724
35
35
  },
36
36
  "linux-arm64-musl": {
37
37
  "binary": "claude.zst",
38
- "checksum": "21b69fbc9fdc9021317dcd6fc236c38216664e6def4a5127d40e3c2434db59fb",
39
- "size": 78191631
38
+ "checksum": "660a62b76eac08fcc1c86ac0450f9a3689c80af4d4da3ed762efde999db7b9c6",
39
+ "size": 78648975
40
40
  },
41
41
  "linux-x64-musl": {
42
42
  "binary": "claude.zst",
43
- "checksum": "0bd16f3afb6b87b06ca70f80f17a6436da6acb4310c08b7453dcdf1a62913a70",
44
- "size": 78856280
43
+ "checksum": "48e9423690734c4f5718eba6fea0c516bceee0c53b7522ec374aed65556aa082",
44
+ "size": 79312653
45
45
  },
46
46
  "win32-x64": {
47
47
  "binary": "claude.exe.zst",
48
- "checksum": "37f1c37f19824b021cbc043076d6db4aa2e4ff5a4327812c40a3ad85243659aa",
49
- "size": 82752486
48
+ "checksum": "497143079a9c781ec15adf8ac682ac8cc4d8db80844ce7051c102c765308526c",
49
+ "size": 83217487
50
50
  },
51
51
  "win32-arm64": {
52
52
  "binary": "claude.exe.zst",
53
- "checksum": "936419143051d84621a3d84cef019d0498d40fc00d2fc1f5a6d3672aac1224fb",
54
- "size": 79501465
53
+ "checksum": "d805fed8cbe7f1919b8f2b4bcb3718c426dda4ac1b5695555a69d0cc9a6a053a",
54
+ "size": 79954588
55
55
  }
56
56
  },
57
57
  "sdkCompat": {
58
58
  "testedWrapperVersions": [
59
- "0.3.235",
60
- "0.3.236",
61
59
  "0.3.237",
62
60
  "0.3.238",
63
61
  "0.3.239",
@@ -85,7 +83,9 @@
85
83
  "0.3.270",
86
84
  "0.3.271",
87
85
  "0.3.272",
88
- "0.3.273"
86
+ "0.3.273",
87
+ "0.3.274",
88
+ "0.3.275"
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.274",
3
+ "version": "0.3.276",
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.274",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.274",
62
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.274",
63
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.274",
64
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.274",
65
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.274",
66
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.274",
67
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.274"
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.276",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.276",
62
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.276",
63
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.276",
64
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.276",
65
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.276",
66
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.276",
67
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.276"
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.274"
83
+ "claudeCodeVersion": "2.1.276"
84
84
  }
package/sdk-tools.d.ts CHANGED
@@ -447,6 +447,9 @@ export type ArtifactOutput =
447
447
  publishesResetAt?: number;
448
448
  contract?: string;
449
449
  updated?: boolean;
450
+ icon?: string;
451
+ faviconSent?: true;
452
+ iconDropped?: true;
450
453
  audience?: string;
451
454
  seq?: number;
452
455
  unchanged?: true;
@@ -459,9 +462,12 @@ export type ArtifactOutput =
459
462
  favicon?: string;
460
463
  updatedAt?: string;
461
464
  rel?: "mine" | "shared";
465
+ external?: true;
466
+ role?: "editor" | "commenter" | "reader" | "viewer";
462
467
  }[];
463
468
  truncated?: boolean;
464
469
  scope?: "shared" | "all";
470
+ external_listed?: true;
465
471
  }
466
472
  | {
467
473
  read: {
@@ -561,6 +567,58 @@ export type ArtifactOutput =
561
567
  file_name: string;
562
568
  };
563
569
  }
570
+ | {
571
+ written?: {
572
+ url: string;
573
+ };
574
+ asset_uploads: {
575
+ url: string;
576
+ /**
577
+ * @minItems 1
578
+ * @maxItems 25
579
+ */
580
+ results: [
581
+ (
582
+ | {
583
+ file_path: string;
584
+ status: "uploaded";
585
+ id: string;
586
+ url: string;
587
+ size_bytes: number;
588
+ content_type: string;
589
+ sha256?: string;
590
+ file_name: string;
591
+ }
592
+ | {
593
+ file_path: string;
594
+ status: "failed" | "not_attempted";
595
+ reason: string;
596
+ message: string;
597
+ may_be_stored?: true;
598
+ }
599
+ ),
600
+ ...(
601
+ | {
602
+ file_path: string;
603
+ status: "uploaded";
604
+ id: string;
605
+ url: string;
606
+ size_bytes: number;
607
+ content_type: string;
608
+ sha256?: string;
609
+ file_name: string;
610
+ }
611
+ | {
612
+ file_path: string;
613
+ status: "failed" | "not_attempted";
614
+ reason: string;
615
+ message: string;
616
+ may_be_stored?: true;
617
+ }
618
+ )[]
619
+ ];
620
+ };
621
+ }
564
622
  | {
565
623
  asset_list: {
566
624
  url: string;
@@ -3091,7 +3149,7 @@ export interface ProposeGoalInput {
3091
3149
  }
3092
3150
  export interface ArtifactInput {
3093
3151
  /**
3094
- * Omit (or 'publish') to publish file_path. 'list' enumerates artifacts — the user's own by default, see `scope`; only `limit` and `scope` may accompany it. 'read' returns the content of the published artifact at `url` (raw HTML for the user's own; an isolated summary, steered by the optional `prompt`, for one shared with them, though a page published in this session's own Slack channel can come back in full as untrusted content) — see **Calls**. 'watch', 'unwatch', and 'status' manage live-update subscriptions through which a session keeps track of new versions of an artifact published elsewhere, and those aren't available in this session: 'watch' only reports that — this session does not keep track of new versions — and 'status' lists this session's artifact watches (pass `url` to check one). 'upload_asset' adds one local media, PDF, font, or text file to an existing artifact — pass `url` and `file_path`. 'list_assets' lists the files in an artifact's asset store (pass `url`; `after` continues a listing), 'read_asset' saves one of them to a local file named by its id (pass `url` and `asset_id`, optionally `out_dir`), and 'delete_asset' permanently removes one (pass `url` and `asset_id`). See **Artifact assets** above.
3152
+ * Omit (or 'publish') to publish file_path. 'list' enumerates artifacts — the user's own by default, see `scope`; only `limit` and `scope` may accompany it. 'read' returns the content of the published artifact at `url` (raw HTML for the user's own; an isolated summary, steered by the optional `prompt`, for one someone else owns, though a page published in this session's own Slack channel can come back in full as untrusted content) — see **Calls**. 'watch', 'unwatch', and 'status' manage live-update subscriptions through which a session keeps track of new versions of an artifact published elsewhere, and those aren't available in this session: 'watch' only reports that — this session does not keep track of new versions — and 'status' lists this session's artifact watches (pass `url` to check one). 'upload_asset' adds one local media, PDF, font, or text file to an existing artifact — pass `url` and `file_path` (or `file_paths` for several in one call). 'list_assets' lists the files in an artifact's asset store (pass `url`; `after` continues a listing), 'read_asset' saves one of them to a local file named by its id (pass `url` and `asset_id`, optionally `out_dir`), and 'delete_asset' permanently removes one (pass `url` and `asset_id`). See **Artifact assets** above.
3095
3153
  */
3096
3154
  action?:
3097
3155
  | "publish"
@@ -3110,11 +3168,11 @@ export interface ArtifactInput {
3110
3168
  */
3111
3169
  file_path?: string;
3112
3170
  /**
3113
- * The artifact's emoji: one or two emoji (e.g. "📊"). No markup. Required on a page's first publish; omit on a redeploy (same file path this session, or `url`) to keep the artifact's emoji — pass a new one only when the user asks.
3171
+ * Deprecated; omit it. Use `icon`.
3114
3172
  */
3115
3173
  favicon?: string;
3116
3174
  /**
3117
- * Optional. One short generic word for the artifact's tab icon, such as chart, calendar, recipe, code or map — a plain signifier, not a product or brand name. Omit when republishing to keep the current icon.
3175
+ * One short generic word for the artifact's browser-tab icon, such as chart, calendar, recipe, code or map — a plain signifier, not a product or brand name. Include it on every page's first publish; omit when republishing to keep the current icon, and pass a new one only when the user asks.
3118
3176
  */
3119
3177
  icon?: string;
3120
3178
  /**
@@ -3122,7 +3180,7 @@ export interface ArtifactInput {
3122
3180
  */
3123
3181
  limit?: number;
3124
3182
  /**
3125
- * list only: 'mine' (default) lists artifacts the user owns — the only ones the update flow can target; 'shared' lists artifacts other people shared with the user (read-only); 'all' lists both. Rows are labeled (mine)/(shared) whenever scope is not 'mine'.
3183
+ * list only: 'mine' (default) lists artifacts the user owns; 'shared' lists artifacts other people shared with the user; 'all' lists both. Rows are labeled (mine)/(shared) whenever scope is not 'mine'.
3126
3184
  */
3127
3185
  scope?: "mine" | "shared" | "all";
3128
3186
  /**
@@ -3138,7 +3196,7 @@ export interface ArtifactInput {
3138
3196
  */
3139
3197
  label?: string;
3140
3198
  /**
3141
- * Existing artifact URL to update in place. Pass whenever the user wants to update an artifact this conversation did not publish — "update my artifact", "keep the same link", a pasted artifact URL — and find the URL with action: "list" or ask the user for the link if you don't have it; without this, the publish creates a separate artifact instead of updating the existing one. Omit for new artifacts and same-conversation redeploys. Must be an artifact the user owns. For 'read' and the other url-addressed actions: the artifact to act on.
3199
+ * Existing artifact URL to update in place. Pass whenever the user wants to update an artifact this conversation did not publish — "update my artifact", "keep the same link", a pasted artifact URL — and find the URL with action: "list" or ask the user for the link if you don't have it; without this, the publish creates a separate artifact instead of updating the existing one. Omit for new artifacts and same-conversation redeploys. Must be an artifact the user owns or was given edit access to (a read of it says "writer"). For 'read' and the other url-addressed actions: the artifact to act on.
3142
3200
  */
3143
3201
  url?: string;
3144
3202
  /**
@@ -3153,6 +3211,13 @@ export interface ArtifactInput {
3153
3211
  * read_asset: directory to save into — default: this artifact’s folder in your scratchpad directory, where saving needs no approval and which you can Read from. read_asset names the file by the asset id plus the extension for its type; saving to any directory other than the default is an ordinary file save the user may be asked to approve.
3154
3212
  */
3155
3213
  out_dir?: string;
3214
+ /**
3215
+ * upload_asset: several local image, video, PDF, font, stylesheet or script files in place of `file_path`, up to 25 in one call, all into the artifact that `url` names; one approval covers the call, and the result lists each file's id and url, or why it was not uploaded. A CSV, Markdown, JSON or plain-text file, a symbolic or hard link, and a file outside the working directory each go in a call of their own with `file_path`.
3216
+ *
3217
+ * @minItems 1
3218
+ * @maxItems 25
3219
+ */
3220
+ file_paths?: [string, ...string[]];
3156
3221
  /**
3157
3222
  * read_asset and delete_asset: the asset's id (32 hex characters), from a list_assets or upload_asset result.
3158
3223
  */
@@ -4071,10 +4136,6 @@ export interface REPLOutput {
4071
4136
  * True on an async-dispatch receipt or refusal: the script was handed to the async dispatcher (queued — outcome arrives later as a poll event — or refused at the queue cap), so this Output carries no execution output and resume replay must skip the block
4072
4137
  */
4073
4138
  asyncDispatched?: boolean;
4074
- /**
4075
- * Names of tools registered during this execution
4076
- */
4077
- registeredTools?: string[];
4078
4139
  /**
4079
4140
  * Images returned by inner Read calls — surfaced as image content blocks
4080
4141
  */
package/sdk.d.ts CHANGED
@@ -773,7 +773,12 @@ export declare function forkSession(_sessionId: string, _options?: ForkSessionOp
773
773
  * Options for forking a session into a new branch.
774
774
  */
775
775
  export declare type ForkSessionOptions = SessionMutationOptions & {
776
- /** Slice transcript up to this message UUID (inclusive). If omitted, full copy. */
776
+ /**
777
+ * Slice transcript up to the message whose `uuid` field equals this value
778
+ * (inclusive). If omitted, full copy. Obtain the value from
779
+ * {@link SessionMessage.uuid} via `getSessionMessages()`, or from the
780
+ * `uuid` you supplied on a streamed {@link SDKUserMessage}.
781
+ */
777
782
  upToMessageId?: string;
778
783
  /** Custom title for the fork. If omitted, derives from original title + " (fork)". */
779
784
  title?: string;
@@ -1177,6 +1182,7 @@ export declare type McpServerStatus = {
1177
1182
  * Error message (available when status is 'failed')
1178
1183
  */
1179
1184
  error?: string;
1185
+
1180
1186
  /**
1181
1187
  * Server configuration (includes URL for HTTP/SSE servers)
1182
1188
  */
@@ -1451,6 +1457,16 @@ export declare type Options = {
1451
1457
  * Paths should be absolute.
1452
1458
  */
1453
1459
  additionalDirectories?: string[];
1460
+ /**
1461
+ * The trusted checkout `cwd` is a worktree of. Project settings (hooks,
1462
+ * permissions), `.mcp.json`, the `.claude` config trees (commands, agents,
1463
+ * skills, workflows, routines, output-styles; a routine cannot be
1464
+ * activated with it)
1465
+ * and `CLAUDE_PROJECT_DIR` come from here instead of `cwd`, so whatever
1466
+ * the branch checked out in `cwd` carries is not what the session runs.
1467
+ * Absolute path.
1468
+ */
1469
+ projectConfigRoot?: string;
1454
1470
  /**
1455
1471
  * Agent name for the main thread. When specified, the agent's system prompt,
1456
1472
  * tool restrictions, and model will be applied to the main conversation.
@@ -4484,6 +4500,7 @@ declare type SDKControlPermissionRequest = {
4484
4500
  * Structured discriminator for why auto-mode escalated. Lets SDK hosts make policy (e.g. auto-deny safetyCheck) without parsing decision_reason text. For compound bash commands this is "subcommandResults" even when a safetyCheck is nested inside — check classifier_approvable for that case, and see decision_reason: for this variant it carries the nested safety check's warning text.
4485
4501
  */
4486
4502
  decision_reason_type?: 'rule' | 'mode' | 'subcommandResults' | 'permissionPromptTool' | 'hook' | 'asyncAgent' | 'sandboxOverride' | 'workingDir' | 'safetyCheck' | 'classifier' | 'other';
4503
+
4487
4504
  /**
4488
4505
  * 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.
4489
4506
  */
@@ -5190,6 +5207,7 @@ export declare type SDKPermissionDeniedMessage = {
5190
5207
  * Discriminator from PermissionDecisionReason (e.g. 'classifier', 'asyncAgent', 'mode', 'rule').
5191
5208
  */
5192
5209
  decision_reason_type?: string;
5210
+
5193
5211
  /**
5194
5212
  * Human-readable reason from the deciding component, when available.
5195
5213
  */
@@ -7009,9 +7027,17 @@ export declare interface Settings {
7009
7027
  } | {
7010
7028
  source: 'npm';
7011
7029
  /**
7012
- * NPM package containing marketplace.json
7030
+ * npm package containing marketplace.json (e.g. "\@acme/claude-marketplace"). In strictKnownMarketplaces / blockedMarketplaces an entry also governs plugins installed straight from the npm marketplace (`<package>\@npm`): an exact package name matches that package, and "\@acme/*" matches every package under the scope.
7013
7031
  */
7014
7032
  package: string;
7033
+ /**
7034
+ * Version or range to fetch (e.g. "1.4.0", "^1.4"); defaults to the latest dist-tag
7035
+ */
7036
+ version?: string;
7037
+ /**
7038
+ * Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
7039
+ */
7040
+ registry?: string;
7015
7041
  } | {
7016
7042
  source: 'file';
7017
7043
  /**
@@ -7253,9 +7279,17 @@ export declare interface Settings {
7253
7279
  } | {
7254
7280
  source: 'npm';
7255
7281
  /**
7256
- * NPM package containing marketplace.json
7282
+ * npm package containing marketplace.json (e.g. "\@acme/claude-marketplace"). In strictKnownMarketplaces / blockedMarketplaces an entry also governs plugins installed straight from the npm marketplace (`<package>\@npm`): an exact package name matches that package, and "\@acme/*" matches every package under the scope.
7257
7283
  */
7258
7284
  package: string;
7285
+ /**
7286
+ * Version or range to fetch (e.g. "1.4.0", "^1.4"); defaults to the latest dist-tag
7287
+ */
7288
+ version?: string;
7289
+ /**
7290
+ * Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
7291
+ */
7292
+ registry?: string;
7259
7293
  } | {
7260
7294
  source: 'file';
7261
7295
  /**
@@ -7492,9 +7526,17 @@ export declare interface Settings {
7492
7526
  } | {
7493
7527
  source: 'npm';
7494
7528
  /**
7495
- * NPM package containing marketplace.json
7529
+ * npm package containing marketplace.json (e.g. "\@acme/claude-marketplace"). In strictKnownMarketplaces / blockedMarketplaces an entry also governs plugins installed straight from the npm marketplace (`<package>\@npm`): an exact package name matches that package, and "\@acme/*" matches every package under the scope.
7496
7530
  */
7497
7531
  package: string;
7532
+ /**
7533
+ * Version or range to fetch (e.g. "1.4.0", "^1.4"); defaults to the latest dist-tag
7534
+ */
7535
+ version?: string;
7536
+ /**
7537
+ * Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
7538
+ */
7539
+ registry?: string;
7498
7540
  } | {
7499
7541
  source: 'file';
7500
7542
  /**
@@ -7721,9 +7763,17 @@ export declare interface Settings {
7721
7763
  } | {
7722
7764
  source: 'npm';
7723
7765
  /**
7724
- * NPM package containing marketplace.json
7766
+ * npm package containing marketplace.json (e.g. "\@acme/claude-marketplace"). In strictKnownMarketplaces / blockedMarketplaces an entry also governs plugins installed straight from the npm marketplace (`<package>\@npm`): an exact package name matches that package, and "\@acme/*" matches every package under the scope.
7725
7767
  */
7726
7768
  package: string;
7769
+ /**
7770
+ * Version or range to fetch (e.g. "1.4.0", "^1.4"); defaults to the latest dist-tag
7771
+ */
7772
+ version?: string;
7773
+ /**
7774
+ * Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
7775
+ */
7776
+ registry?: string;
7727
7777
  } | {
7728
7778
  source: 'file';
7729
7779
  /**
@@ -7950,9 +8000,17 @@ export declare interface Settings {
7950
8000
  } | {
7951
8001
  source: 'npm';
7952
8002
  /**
7953
- * NPM package containing marketplace.json
8003
+ * npm package containing marketplace.json (e.g. "\@acme/claude-marketplace"). In strictKnownMarketplaces / blockedMarketplaces an entry also governs plugins installed straight from the npm marketplace (`<package>\@npm`): an exact package name matches that package, and "\@acme/*" matches every package under the scope.
7954
8004
  */
7955
8005
  package: string;
8006
+ /**
8007
+ * Version or range to fetch (e.g. "1.4.0", "^1.4"); defaults to the latest dist-tag
8008
+ */
8009
+ version?: string;
8010
+ /**
8011
+ * Registry URL. When adding a marketplace: a one-off registry override (otherwise your npm configuration decides). In a policy entry: the origin and path prefix the package's RESOLVED tarball URL must fall under (e.g. "https://npm.example.com/api/npm/internal/").
8012
+ */
8013
+ registry?: string;
7956
8014
  } | {
7957
8015
  source: 'file';
7958
8016
  /**
@@ -9060,10 +9118,11 @@ export declare type SyncHookJSONOutput = {
9060
9118
  /**
9061
9119
  * Marker string that splits a custom `systemPrompt` into a static prefix
9062
9120
  * (eligible for cross-session prompt caching) and a dynamic suffix
9063
- * (session-specific, not globally cached). Include this literal as a
9064
- * standalone element of a `string[]` `systemPrompt` to opt in; blocks
9065
- * before it get global cache scope, blocks after do not. See
9066
- * `splitSysPromptPrefix` in `src/utils/api.ts`.
9121
+ * (session-specific, not globally cached). Include it as a standalone
9122
+ * element of a `string[]` `systemPrompt`, or as a line of its own in a
9123
+ * `--system-prompt` string, to opt in; content before it gets global
9124
+ * cache scope, content after does not. See `splitSysPromptPrefix` in
9125
+ * `src/utils/api.ts`.
9067
9126
  */
9068
9127
  export declare const SYSTEM_PROMPT_DYNAMIC_BOUNDARY = "__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__";
9069
9128