@anthropic-ai/claude-agent-sdk 0.3.283 → 0.3.284

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,53 @@
1
1
  {
2
- "version": "2.1.283",
2
+ "version": "2.1.284",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "4631ccd7cfe41e69bc72d3b5b9dc7282536e4985",
5
- "modsCommit": "684ffc4da0eaaddcafa61842dc719c6a8febc5c2",
6
- "buildDate": "2026-09-25T01:39:37Z",
4
+ "commit": "2b8ce618c24de26410e4bdfc4e1d592accd61f61",
5
+ "modsCommit": "7779afb12e3635f46f56ec823979d68350ae000b",
6
+ "buildDate": "2026-09-28T02:36:51Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude",
10
- "checksum": "d8cb1e5c79684cc12a8bfc813e3a2073406921b6245744b3009be3ab5651d21e",
11
- "size": 225036032
10
+ "checksum": "50a14c2f50f56668380fdda490167f1d3630d5cc18fb8aed3073c2c7ea7314fe",
11
+ "size": 226563088
12
12
  },
13
13
  "darwin-x64": {
14
14
  "binary": "claude",
15
- "checksum": "c896d2aee12ff4d95861033d9730d3d22dc19e4f32779134d3399ef3dfb0e77a",
16
- "size": 233458384
15
+ "checksum": "79441b868935a11ed0630b2ee59327eda9f6a93bb8d470bd6633c03df76d2135",
16
+ "size": 235010944
17
17
  },
18
18
  "linux-arm64": {
19
19
  "binary": "claude",
20
- "checksum": "346d294f0103d6fc0de11ac953579b5c62dfa90698a4cfc486b6f927c615e697",
21
- "size": 240902136
20
+ "checksum": "3dd0f96d7ada463152d20300186f6cfc6ab94b57e218f49e3ac86db42ac695a6",
21
+ "size": 242409464
22
22
  },
23
23
  "linux-x64": {
24
24
  "binary": "claude",
25
- "checksum": "1859583ce32920595c61ef868bee52e1b1594f7486db209935e01f1e5e804ae2",
26
- "size": 241556664
25
+ "checksum": "5cd90aabd83f8a15136c35aa37bb1d92b348993573316643dc3fe4e04afbf88f",
26
+ "size": 243059896
27
27
  },
28
28
  "linux-arm64-musl": {
29
29
  "binary": "claude",
30
- "checksum": "7e607db312a84ed8d7e17c34be93accad5f79366c5a043758ba8de95fdb5d070",
31
- "size": 233256768
30
+ "checksum": "d8bce5724ecd1e6930ddf5f4cef7cebb0cd3e50b4f5d5158b30a53f81824f982",
31
+ "size": 234764096
32
32
  },
33
33
  "linux-x64-musl": {
34
34
  "binary": "claude",
35
- "checksum": "bed45d96869935e0fa4674d5099fd3e724162d5234b601771e7418beb699c5a8",
36
- "size": 235311192
35
+ "checksum": "1c5e4d7431c1e70c45efdce69ea74c2c9a2ad309f16555f7dc563f4743d978a0",
36
+ "size": 236810328
37
37
  },
38
38
  "win32-x64": {
39
39
  "binary": "claude.exe",
40
- "checksum": "9dbe16dafed59da5cdabbfe11ad0335738c753fad794989b47f9446accd6de3a",
41
- "size": 244960928
40
+ "checksum": "0416631e846f743110da5282409776fa1313e65f33a588aae066eaf8db0fda7d",
41
+ "size": 246480032
42
42
  },
43
43
  "win32-arm64": {
44
44
  "binary": "claude.exe",
45
- "checksum": "1d0aaa255e3b9ba304840f260f4993b98f10516d3aa5b7d60ecd3392cca34df4",
46
- "size": 232505504
45
+ "checksum": "8a968e1500576eea43d04d7cffd40cf39b1c83e5b443522bafe0e92e50d6a389",
46
+ "size": 234005152
47
47
  }
48
48
  },
49
49
  "sdkCompat": {
50
50
  "testedWrapperVersions": [
51
- "0.3.243",
52
51
  "0.3.245",
53
52
  "0.3.246",
54
53
  "0.3.247",
@@ -77,7 +76,8 @@
77
76
  "0.3.277",
78
77
  "0.3.278",
79
78
  "0.3.280",
80
- "0.3.281"
79
+ "0.3.281",
80
+ "0.3.282"
81
81
  ],
82
82
  "harnessSchema": 1
83
83
  }
package/manifest.zst.json CHANGED
@@ -1,62 +1,61 @@
1
1
  {
2
- "version": "2.1.283",
2
+ "version": "2.1.284",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "4631ccd7cfe41e69bc72d3b5b9dc7282536e4985",
5
- "modsCommit": "684ffc4da0eaaddcafa61842dc719c6a8febc5c2",
6
- "buildDate": "2026-09-25T01:40:44Z",
4
+ "commit": "2b8ce618c24de26410e4bdfc4e1d592accd61f61",
5
+ "modsCommit": "7779afb12e3635f46f56ec823979d68350ae000b",
6
+ "buildDate": "2026-09-28T02:38:01Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude.zst",
10
- "checksum": "485d6883c023368800626e0d1f2e4382c3e1bdc760fae12cb2f6e3054f218eec",
11
- "size": 75461598,
10
+ "checksum": "ed26ee9ccbf05b2dfa3c8abf52348b78b00274304824ad1eeaf9d88366fa70ae",
11
+ "size": 75450868,
12
12
  "bundle": {
13
- "checksum": "f22ac793e83fbaa4ec74a1194c98c4f9c8cd808cfa2a238aecb561a342420b3e",
14
- "size": 75465975
13
+ "checksum": "e8e2eb9333a6b949199ceba0bbb203ae7c15822cfb284ffa8998818136cccc83",
14
+ "size": 75472329
15
15
  }
16
16
  },
17
17
  "darwin-x64": {
18
18
  "binary": "claude.zst",
19
- "checksum": "2ac2ccd98433c2727de1b7142dd808f355e7764fa573ab891666f496a3a669ee",
20
- "size": 79614241,
19
+ "checksum": "28f05c4cbd49a8192e2ea6535a3bc55c11f6bb8f15d1b5932785291d0eb52d81",
20
+ "size": 79633391,
21
21
  "bundle": {
22
- "checksum": "7a9ef7b6b7ccdb343c3c2c160efc1984bda9f9f446bca97603008cfdfe99835f",
23
- "size": 79613206
22
+ "checksum": "f520ee6863b8241cadd4ce746cdd23a54ca66023f7ce26635e74033ad2296d5f",
23
+ "size": 79631029
24
24
  }
25
25
  },
26
26
  "linux-arm64": {
27
27
  "binary": "claude.zst",
28
- "checksum": "7ff80952f5cf74fa593432ec19fc7bef1b4461b365092fe2b6c6060d4fbad1ec",
29
- "size": 84571156
28
+ "checksum": "6e31b86de3952594441b4ef91c1f5079c1385b0169a9df351dd2762bb2336d23",
29
+ "size": 84564981
30
30
  },
31
31
  "linux-x64": {
32
32
  "binary": "claude.zst",
33
- "checksum": "94345861e88be3d67a8393494f98f5b1c67604c14ccd4ef3c7a51e3643fa25eb",
34
- "size": 85309419
33
+ "checksum": "5021d631dacbd516603a779b3cf2463085470417a838b6a0835f77fa44d23f0a",
34
+ "size": 85305499
35
35
  },
36
36
  "linux-arm64-musl": {
37
37
  "binary": "claude.zst",
38
- "checksum": "12ab758aca002744a1364328536d0b30d510707262d9eb116390a14b269a3c79",
39
- "size": 82977461
38
+ "checksum": "6ea61bf336a2f4077313e6d28a527bcb27c197557fdca3236bc2b54fe08afaf7",
39
+ "size": 82964275
40
40
  },
41
41
  "linux-x64-musl": {
42
42
  "binary": "claude.zst",
43
- "checksum": "118b07bbe50b9ca5ab303ed070fb5d065696c413ae62f9dc1c8f64f2c9d824ec",
44
- "size": 83744817
43
+ "checksum": "f7c3c7007c94943cd2a18d0bfbccf5b1b71e34b2657ba28b60e39e21cced9e73",
44
+ "size": 83735595
45
45
  },
46
46
  "win32-x64": {
47
47
  "binary": "claude.exe.zst",
48
- "checksum": "b201734251f1d6470a65453192422d1b03d6f3a5c1365b43dc7d2b65cd135233",
49
- "size": 87607368
48
+ "checksum": "43ca996effd9a70a475693a68331f3a943c3e179c4457a23be45c1858e400db8",
49
+ "size": 87601305
50
50
  },
51
51
  "win32-arm64": {
52
52
  "binary": "claude.exe.zst",
53
- "checksum": "302ac016e1f3487b87945596388d38cf9b2974597375ec24447278d5019e7c6e",
54
- "size": 83948914
53
+ "checksum": "4d0079df92f51d3e8caf6ecc9c0dac52201d0e392764e246729b9eb7ee56de14",
54
+ "size": 83931586
55
55
  }
56
56
  },
57
57
  "sdkCompat": {
58
58
  "testedWrapperVersions": [
59
- "0.3.243",
60
59
  "0.3.245",
61
60
  "0.3.246",
62
61
  "0.3.247",
@@ -85,7 +84,8 @@
85
84
  "0.3.277",
86
85
  "0.3.278",
87
86
  "0.3.280",
88
- "0.3.281"
87
+ "0.3.281",
88
+ "0.3.282"
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.283",
3
+ "version": "0.3.284",
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.283",
65
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.283",
66
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.283",
67
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.283",
68
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.283",
69
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.283",
70
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.283",
71
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.283"
64
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.284",
65
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.284",
66
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.284",
67
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.284",
68
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.284",
69
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.284",
70
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.284",
71
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.284"
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-3mr1yqt9.mjs",
89
- "core-rg0sgcv0.mjs"
88
+ "core-3ctbshc7.mjs",
89
+ "core-eg2e19h0.mjs"
90
90
  ],
91
- "claudeCodeVersion": "2.1.283"
91
+ "claudeCodeVersion": "2.1.284"
92
92
  }
package/sdk-tools.d.ts CHANGED
@@ -3165,7 +3165,7 @@ export interface ArtifactInput {
3165
3165
  */
3166
3166
  label?: string;
3167
3167
  /**
3168
- * 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.
3168
+ * An existing artifact's claude.ai link (claude.ai/artifact/{id} or claude.ai/code/artifact/{uuid}; a chat, project or session link is not one) 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"). Before publishing to an artifact this conversation has neither read nor published, read it (action: "read") and build on what comes back; a publish sent without that read is refused. A refusal that hands you the live version counts as that read: merge your edits into that version and publish that; never resend the refused content unchanged. For 'read' and the other url-addressed actions: the artifact to act on.
3169
3169
  */
3170
3170
  url?: string;
3171
3171
  /**
package/sdk.d.ts CHANGED
@@ -679,11 +679,7 @@ export declare type DirectoryAddedHookInput = BaseHookInput & {
679
679
  /**
680
680
  * Effort level for controlling how much thinking/reasoning Claude applies.
681
681
  *
682
- * - `'low'` — Minimal thinking, fastest responses
683
- * - `'medium'` — Moderate thinking
684
- * - `'high'` — Deep reasoning (default)
685
- * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+, Sonnet 5; falls back to `'high'` elsewhere)
686
- * - `'max'` — Maximum effort (select models only)
682
+ * @see https://platform.claude.com/docs/en/build-with-claude/effort
687
683
  */
688
684
  export declare type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
689
685
 
@@ -1905,12 +1901,6 @@ export declare type Options = {
1905
1901
  * Controls how much effort Claude puts into its response.
1906
1902
  * Works with adaptive thinking to guide thinking depth.
1907
1903
  *
1908
- * - `'low'` — Minimal thinking, fastest responses
1909
- * - `'medium'` — Moderate thinking
1910
- * - `'high'` — Deep reasoning (default)
1911
- * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+, Sonnet 5)
1912
- * - `'max'` — Maximum effort (Fable 5, Opus 4.6+, Sonnet 4.6+)
1913
- *
1914
1904
  * @see https://platform.claude.com/docs/en/build-with-claude/effort
1915
1905
  */
1916
1906
  effort?: EffortLevel;
@@ -2933,6 +2923,11 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2933
2923
  * main-thread agent, and `ultracode` to off with the current effort kept.
2934
2924
  * Only available in streaming input mode.
2935
2925
  *
2926
+ * `ultracode: true` or `false` turns ultracode on or off and leaves the
2927
+ * effort level alone. An `effortLevel` that moves the session to a
2928
+ * different level, sent without an `ultracode` key, also turns ultracode
2929
+ * off; send both keys to change the level and keep it on.
2930
+ *
2936
2931
  * @param settings - A partial settings object to merge into the flag
2937
2932
  * settings. `effortLevel` also accepts `'max'` (never written to settings
2938
2933
  * files, so the persisted {@link Settings.effortLevel} excludes it): it is
@@ -4539,6 +4534,7 @@ export declare type SDKControlInitializeResponse = {
4539
4534
 
4540
4535
 
4541
4536
 
4537
+
4542
4538
  };
4543
4539
 
4544
4540
  /**
@@ -5318,6 +5314,7 @@ export declare type SDKMessageOrigin = {
5318
5314
  * 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.
5319
5315
  */
5320
5316
  fireReason?: string;
5317
+
5321
5318
  } | {
5322
5319
  kind: 'coordinator';
5323
5320
  } | {
@@ -7178,7 +7175,7 @@ export declare interface Settings {
7178
7175
  */
7179
7176
  httpHookAllowedEnvVars?: string[];
7180
7177
  /**
7181
- * When true (and set in managed settings), permission rules from user, project, local, and --settings files and allow rules from --allowedTools are ignored; only managed settings can add allow rules through settings. The allowed-tools frontmatter of skills and custom commands from user, project, and --add-dir sources, and of plugins Claude Code adopts from a .claude-plugin manifest inside those skills directories, is ignored too; other plugins and managed and bundled skills keep theirs. --disallowedTools, skill disallowed-tools, and other deny and ask rules from the command line or the current session still apply.
7178
+ * When true (and set in managed settings), permission rules from user, project, local, and --settings files and allow rules from --allowedTools are ignored; only managed settings can add allow rules through settings. The allowed-tools frontmatter of skills and custom commands from user, project, and --add-dir sources, and of plugins no managed setting vouches for, is ignored too. Plugins keep theirs only on an admin-backed channel: host-delivered --plugin-dir plugins, the official marketplace registered from its unpinned anthropics source, claude.ai-synced plugins Anthropic attests, the saved login organization's claude.ai-hosted marketplaces, marketplaces whose registered source managed extraKnownMarketplaces declares or an exact or owner-pinned (owner/*) strictKnownMarketplaces entry names at the path it pins (an npm marketplace source only when the registration and the declared entry pin the same registry, and a settings marketplace source only when every nested npm plugin entry pins one on a bare package name — unpinned, the package resolves through the member's own npm config, and a non-bare spelling packs as an exotic spec the pin does not bind, so nothing an entry names is what was fetched), and npm-direct (package\@npm) plugins whose recorded resolution a registry-pinned managed npm strictKnownMarketplaces entry names (host and path patterns and enabledPlugins ids do not vouch); managed and bundled skills keep theirs. --disallowedTools, skill disallowed-tools, and other deny and ask rules from the command line or the current session still apply.
7182
7179
  */
7183
7180
  allowManagedPermissionRulesOnly?: boolean;
7184
7181
  /**
@@ -7347,7 +7344,7 @@ export declare interface Settings {
7347
7344
  */
7348
7345
  version?: string;
7349
7346
  /**
7350
- * 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/").
7347
+ * 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/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
7351
7348
  */
7352
7349
  registry?: string;
7353
7350
  } | {
@@ -7391,7 +7388,7 @@ export declare interface Settings {
7391
7388
  */
7392
7389
  name: string;
7393
7390
  /**
7394
- * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
7391
+ * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
7395
7392
  */
7396
7393
  source: string | {
7397
7394
  source: 'npm';
@@ -7599,7 +7596,7 @@ export declare interface Settings {
7599
7596
  */
7600
7597
  version?: string;
7601
7598
  /**
7602
- * 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/").
7599
+ * 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/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
7603
7600
  */
7604
7601
  registry?: string;
7605
7602
  } | {
@@ -7643,7 +7640,7 @@ export declare interface Settings {
7643
7640
  */
7644
7641
  name: string;
7645
7642
  /**
7646
- * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
7643
+ * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
7647
7644
  */
7648
7645
  source: string | {
7649
7646
  source: 'npm';
@@ -7846,7 +7843,7 @@ export declare interface Settings {
7846
7843
  */
7847
7844
  version?: string;
7848
7845
  /**
7849
- * 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/").
7846
+ * 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/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
7850
7847
  */
7851
7848
  registry?: string;
7852
7849
  } | {
@@ -7890,7 +7887,7 @@ export declare interface Settings {
7890
7887
  */
7891
7888
  name: string;
7892
7889
  /**
7893
- * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
7890
+ * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
7894
7891
  */
7895
7892
  source: string | {
7896
7893
  source: 'npm';
@@ -8083,7 +8080,7 @@ export declare interface Settings {
8083
8080
  */
8084
8081
  version?: string;
8085
8082
  /**
8086
- * 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/").
8083
+ * 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/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
8087
8084
  */
8088
8085
  registry?: string;
8089
8086
  } | {
@@ -8127,7 +8124,7 @@ export declare interface Settings {
8127
8124
  */
8128
8125
  name: string;
8129
8126
  /**
8130
- * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
8127
+ * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
8131
8128
  */
8132
8129
  source: string | {
8133
8130
  source: 'npm';
@@ -8320,7 +8317,7 @@ export declare interface Settings {
8320
8317
  */
8321
8318
  version?: string;
8322
8319
  /**
8323
- * 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/").
8320
+ * 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/"); under allowManagedPermissionRulesOnly, an npm marketplace keeps plugin allowed-tools only when both the entry and the registration pin this same registry.
8324
8321
  */
8325
8322
  registry?: string;
8326
8323
  } | {
@@ -8364,7 +8361,7 @@ export declare interface Settings {
8364
8361
  */
8365
8362
  name: string;
8366
8363
  /**
8367
- * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.
8364
+ * Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against. Under allowManagedPermissionRulesOnly, a settings marketplace keeps its plugins' allowed-tools only when every npm entry here pins a `registry` on a bare package name; unpinned, the package resolves through the member's own npm config, and a non-bare spelling (an `npm:` alias, a `name\@range`, a URL or git spec) packs as an exotic spec the pin does not bind — either way the marketplace vouches no tool grants.
8368
8365
  */
8369
8366
  source: string | {
8370
8367
  source: 'npm';
@@ -8868,7 +8865,7 @@ export declare interface Settings {
8868
8865
  };
8869
8866
  };
8870
8867
  /**
8871
- * Enable ultracode for the session: xhigh effort plus standing dynamic-workflow orchestration. Session-scoped — typically provided via --settings or the apply_flag_settings control request; interactive toggles never persist it. Requires workflows to be enabled and an xhigh-capable model.
8868
+ * Enable ultracode for the session: standing dynamic-workflow orchestration at any effort level. Session-scoped — typically provided via --settings or the apply_flag_settings control request; interactive toggles never persist it. Requires workflows to be enabled and a model that supports ultracode.
8872
8869
  */
8873
8870
  ultracode?: boolean;
8874
8871
  /**