@anthropic-ai/claude-agent-sdk 0.3.309 → 0.3.311

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.309",
2
+ "version": "2.1.311",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "1ce7e4ff2da8d4b0f5c15b291e4a9b54716970c2",
5
- "buildDate": "2026-10-22T19:32:59Z",
4
+ "commit": "e7d3b8365a0ffbe2f5dd032feb28e9fd9c7de025",
5
+ "buildDate": "2026-10-26T19:03:46Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "5eadc0009cdcdbc0d06e58110d7b2baf88ced6088b1c33a60a21217fe410619c",
10
- "size": 275923296
9
+ "checksum": "85d8c08707fcfd1e78ffa0204eefbc6ec9e4fe22f375fb2767ef85d957ed3161",
10
+ "size": 276185504
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "200e0d775ae55c040db3bb8db8de3e22efcddbd7e0abff5ab50dd10f6853425d",
15
- "size": 287157296
14
+ "checksum": "d34e1cb82015b050471a97574aa6ea6f698ecf3a97a61c980961f43ad9f838f5",
15
+ "size": 287420928
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "9796dd26899337f687739a0b39a7353b639f062a3436a7b941fcf19a1b757a9b",
20
- "size": 293331128
19
+ "checksum": "2e2496c9a8065df93acb0fca2d341f59a6b8777649b2e025ab8c9bcd5eef61f3",
20
+ "size": 293658808
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "4d704a8aecbe038affa3000f498ae17c1b4f753add8facb8764120affc99b658",
25
- "size": 293469552
24
+ "checksum": "86dc1fcc69498159eaf15f446613e847010f9036bfbbdffd4c49350be8489ada",
25
+ "size": 293776752
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "028ad6b4c0ed304a116eb1efa6f1d752630f6691aa70004a79406026a023b332",
30
- "size": 285493120
29
+ "checksum": "172150e3f9ea07e8e2e2e29862d7d9a25f5c234d8e909e4063df237665bf09b9",
30
+ "size": 285822152
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "0e35f4f665be93de03b383e22294e0e15860ae6f17e34be4851dfe7af732ceae",
35
- "size": 287137936
34
+ "checksum": "cd40dd327145ee47aa0deacd571801c1d782388f709d71242eee6b91de8ed11f",
35
+ "size": 287442392
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "5441781f2b6bbd07354b4a74560ee88c68c9bf05d6db3c7e24c452c91673dc53",
40
- "size": 298624160
39
+ "checksum": "966f4b2ce962298f5dee6a942e8c47c8f97392e69e728e622319a98b259c0680",
40
+ "size": 298870432
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "063f45f61dca573b76e378f06728dc4e8f1b8600905dbd19be6d210f8c882501",
45
- "size": 282697888
44
+ "checksum": "951b5d94bf2a5296db2c442784e68d18fa04dec2d7d2e805aa50e75d618aad5e",
45
+ "size": 282933920
46
46
  }
47
47
  },
48
48
  "sdkCompat": {
49
49
  "testedWrapperVersions": [
50
- "0.3.276",
51
- "0.3.277",
52
50
  "0.3.278",
53
51
  "0.3.280",
54
52
  "0.3.281",
package/manifest.zst.json CHANGED
@@ -1,62 +1,60 @@
1
1
  {
2
- "version": "2.1.309",
2
+ "version": "2.1.311",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "1ce7e4ff2da8d4b0f5c15b291e4a9b54716970c2",
5
- "buildDate": "2026-10-22T19:34:30Z",
4
+ "commit": "e7d3b8365a0ffbe2f5dd032feb28e9fd9c7de025",
5
+ "buildDate": "2026-10-26T19:05:12Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "614eb35bb650dee9cfa4a7821a60d5eab75fbcabe2c1b8aa408d2e93f06c1370",
10
- "size": 93159896,
9
+ "checksum": "68a55ab38088b10f213be752ac47e2d88e81cf8ac2bae3a31396b2cd6c9a91ec",
10
+ "size": 93380583,
11
11
  "bundle": {
12
- "checksum": "5af865b9901c3f7512d85aa78571966834c943e3143f1b82ef4d33ed89b7f0ba",
13
- "size": 93151388
12
+ "checksum": "75ff20c96ec39582035067231b6aa4a1b5830e53bcb1167f81f9639be0b2a842",
13
+ "size": 93383140
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "7426a8b80fe213e90b8e58682a54668aa7efe838939c9b2cab8d6089ab13befb",
19
- "size": 98568120,
18
+ "checksum": "066565c1d787345f945bace4f0cb2f2a41bf96800adabb0f0b0c3bb701af69d6",
19
+ "size": 98817523,
20
20
  "bundle": {
21
- "checksum": "300ae7409767b5bf31c77b466987278ee4493cfc82099ef4ad89841f7bfc71d4",
22
- "size": 98585917
21
+ "checksum": "84cb2ff289ac3316744057fa0786c641b74ca8733f0cf75d7bb2b604444d33bb",
22
+ "size": 98818787
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "a2f75e390c4afc3c610db69e7ff2587327f135f161cad5f088c2d0de6e5a9441",
28
- "size": 102438847
27
+ "checksum": "0b6291903c4dde17f456c8a8799a3101877321bd667aa78e793dc1fe0709893c",
28
+ "size": 102741700
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "e52289b95def16148c8d0a48b1ccc0d357429e73473a9a20ac0638fb7460a59b",
33
- "size": 103411745
32
+ "checksum": "d0c00b80761f3030f34cf0812266f6c6f8210ff9af7242f7c6c76c5600499caf",
33
+ "size": 103729711
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "0a94b79920b85f8284d09d73ac8536434e37576924b7c4c6a38fce7d378417c7",
38
- "size": 100788523
37
+ "checksum": "95f37a2808a40596f1fcc005f64eaaf7975d6a46c365876845d0909714c5a91b",
38
+ "size": 101084046
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "16c3f12d7c34922ca04a991244ec10645f6fbd4da809eb79f5f86bc8e660f1f1",
43
- "size": 101827875
42
+ "checksum": "edae71d077ea4f4c413981968cb864d3b7ab8a6010fec1dc309d7e7ba403bfec",
43
+ "size": 102122872
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "9078b9c1d466965d3faee8d13128f03d79b61794fb2130255ca1f5eab84e602c",
48
- "size": 106715810
47
+ "checksum": "f2966586f6f936a48b7025a8eb0604e0a1a241e4b5ea877db34e6443b10d6989",
48
+ "size": 106965057
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "1bfeb992f9659ef84307012c5da5735cdf05da6a81ced1bea60dbddae67ecdad",
53
- "size": 101912543
52
+ "checksum": "99648d7d1d66ff68f5238cbf59422e3db422e117863ecf02e13c4cea99179165",
53
+ "size": 102170242
54
54
  }
55
55
  },
56
56
  "sdkCompat": {
57
57
  "testedWrapperVersions": [
58
- "0.3.276",
59
- "0.3.277",
60
58
  "0.3.278",
61
59
  "0.3.280",
62
60
  "0.3.281",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.309",
3
+ "version": "0.3.311",
4
4
  "main": "sdk.mjs",
5
5
  "types": "sdk.d.ts",
6
6
  "exports": {
@@ -32,7 +32,7 @@
32
32
  }
33
33
  },
34
34
  "engines": {
35
- "node": ">=18.0.0"
35
+ "node": ">=18.14.0"
36
36
  },
37
37
  "type": "module",
38
38
  "author": "Anthropic <support@anthropic.com>",
@@ -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.309",
65
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.309",
66
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.309",
67
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.309",
68
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.309",
69
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.309",
70
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.309",
71
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.309"
64
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.311",
65
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.311",
66
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.311",
67
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.311",
68
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.311",
69
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.311",
70
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.311",
71
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.311"
72
72
  },
73
73
  "files": [
74
74
  "sdk.mjs",
@@ -85,10 +85,10 @@
85
85
  "extractFromBunfs.d.ts",
86
86
  "manifest.json",
87
87
  "manifest.zst.json",
88
- "core-1qw7dszx.mjs",
89
- "core-cz9sh4ze.mjs",
90
- "core-nmrdrt5c.mjs",
91
- "core-nxm5bcfb.mjs"
88
+ "core-0bjz4v5z.mjs",
89
+ "core-ptjgnrch.mjs",
90
+ "core-rbkmqzx3.mjs",
91
+ "core-zbftdwza.mjs"
92
92
  ],
93
- "claudeCodeVersion": "2.1.309"
93
+ "claudeCodeVersion": "2.1.311"
94
94
  }
package/sdk-tools.d.ts CHANGED
@@ -135,6 +135,7 @@ export type AgentOutput =
135
135
  } | null;
136
136
  fallback_credit?: unknown;
137
137
  };
138
+ toolsUsed?: string[];
138
139
  toolStats?: {
139
140
  readCount: number;
140
141
  searchCount: number;
@@ -689,6 +690,7 @@ export type ProjectsOutput =
689
690
  | {
690
691
  method: "project_info";
691
692
  notice?: string;
693
+ local_file?: string;
692
694
  name: string;
693
695
  description: string;
694
696
  instructions: string;
package/sdk.d.ts CHANGED
@@ -1227,6 +1227,7 @@ export declare type McpSdkServerConfig = {
1227
1227
  */
1228
1228
  timeout?: number;
1229
1229
 
1230
+
1230
1231
  /**
1231
1232
  * Per-tool permission policy the host declares for this server's tools (not the tool definitions passed to createSdkMcpServer). always_ask: the CLI asks the host (canUseTool or the permission prompt tool) before each call, even where an allow rule or allowedTools covers the tool, and under bypassPermissions outside a hosted remote session (CLAUDE_CODE_REMOTE); under dontAsk the call is denied; in auto mode the classifier decides, except that by default a tool annotated destructiveHint still asks. always_deny: calls are denied. always_allow and org_max_permission are ignored on sdk servers; grant allows with allowedTools or canUseTool. Read from initialize (sdkMcpServerConfigs) and from each mcp_set_servers entry that names the server. On the wire an entry without tools states no policy: on initialize the stored list and the rules stand; on mcp_set_servers the rules are replaced without them. The Agent SDK always re-sends the registered list. An entry whose policy is not one of the three asks; an entry without a string name is dropped and the rest apply; a value that is not a list reads as absent.
1232
1233
  */
@@ -1474,6 +1475,14 @@ export declare type ModelUsage = {
1474
1475
  thinkingTokens?: number;
1475
1476
  cacheReadInputTokens: number;
1476
1477
  cacheCreationInputTokens: number;
1478
+ /**
1479
+ * Cache writes with a 5-minute lifetime, already counted inside cacheCreationInputTokens. This and cacheCreationEphemeral1hInputTokens can add up to less than cacheCreationInputTokens, because a response that does not report how long its cache writes live adds to neither. costUSD prices those writes at the 5-minute rate. Counts only turns run on CLI versions that record this field: absent when none did, and an undercount when part of the session ran on an older version.
1480
+ */
1481
+ cacheCreationEphemeral5mInputTokens?: number;
1482
+ /**
1483
+ * Cache writes with a 1-hour lifetime, already counted inside cacheCreationInputTokens. costUSD prices them at the 1-hour rate when the model's price table has one. The built-in list prices do. A managed-settings modelPricing row does not: its one cache-write rate applies to both lifetimes. costUSD never uses the 1-hour rate for a response that a fallback model served after a refusal. Absent or an undercount in the same cases as cacheCreationEphemeral5mInputTokens.
1484
+ */
1485
+ cacheCreationEphemeral1hInputTokens?: number;
1477
1486
  webSearchRequests: number;
1478
1487
  costUSD: number;
1479
1488
  contextWindow: number;
@@ -4668,7 +4677,7 @@ declare type SDKControlInitializeRequest = {
4668
4677
  hooks?: Partial<Record<coreTypes.HookEvent, SDKHookCallbackMatcher[]>>;
4669
4678
  sdkMcpServers?: string[];
4670
4679
  /**
4671
- * Settings for the SDK-hosted MCP servers named in sdkMcpServers, keyed by server name. Sent as a separate field so a CLI that predates it ignores it; entries whose name is not in sdkMcpServers, and values that do not match this shape, are ignored rather than rejected. timeout and disableAutoBackground apply when the server is first registered; tools (the per-tool permission policy) adds its ask and deny rules on every initialize that names the server. An initialize never removes a rule; mcp_set_servers replaces them.
4680
+ * Settings for the SDK-hosted MCP servers named in sdkMcpServers, keyed by server name. Sent as a separate field so a CLI that predates it ignores it; entries whose name is not in sdkMcpServers, and values that do not match this shape, are ignored rather than rejected. timeout, disableAutoBackground and connectorId apply when the server is first registered; tools (the per-tool permission policy) adds its ask and deny rules on every initialize that names the server. An initialize never removes a rule; mcp_set_servers replaces them.
4672
4681
  */
4673
4682
  sdkMcpServerConfigs?: Record<string, {
4674
4683
  /**
@@ -4676,6 +4685,7 @@ declare type SDKControlInitializeRequest = {
4676
4685
  */
4677
4686
  timeout?: number;
4678
4687
 
4688
+
4679
4689
  /**
4680
4690
  * Per-tool permission policy the host declares for this server's tools (not the tool definitions passed to createSdkMcpServer). always_ask: the CLI asks the host (canUseTool or the permission prompt tool) before each call, even where an allow rule or allowedTools covers the tool, and under bypassPermissions outside a hosted remote session (CLAUDE_CODE_REMOTE); under dontAsk the call is denied; in auto mode the classifier decides, except that by default a tool annotated destructiveHint still asks. always_deny: calls are denied. always_allow and org_max_permission are ignored on sdk servers; grant allows with allowedTools or canUseTool. Read from initialize (sdkMcpServerConfigs) and from each mcp_set_servers entry that names the server. On the wire an entry without tools states no policy: on initialize the stored list and the rules stand; on mcp_set_servers the rules are replaced without them. The Agent SDK always re-sends the registered list. An entry whose policy is not one of the three asks; an entry without a string name is dropped and the rest apply; a value that is not a list reads as absent.
4681
4691
  */
@@ -5304,7 +5314,7 @@ declare type SDKControlSetColorRequest = {
5304
5314
  };
5305
5315
 
5306
5316
  /**
5307
- * Sets the maximum number of thinking tokens for extended thinking. When max_thinking_tokens is null, thinking resets to the session default: any mid-session budget override is cleared (back to the spawn-time budget, if one was set), and thinking stays off for sessions that have it disabled. When max_thinking_tokens is omitted, the budget is left as it is, so a request that only changes thinking_display can leave the field out. thinking_display optionally sets the thinking display mode for the rest of the session: a value replaces the session display mode, null clears that override so Claude Code's default display handling applies again, and when omitted the display mode from session start (--thinking-display) is kept. 'highlights' returns one short title per stretch of thinking instead of a prose summary. The API accepts it only from Claude Code sessions that Anthropic hosts; if the API rejects it, the session sends 'omitted' (no thinking text) in its place from then on. A request for 'highlights' gets an error reply after such a rejection, on Amazon Bedrock, Google Vertex AI or another provider to which Claude Code sends no first-party-only beta features, when experimental betas are off (CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS or organization policy), or on a Claude 3 model (except on Microsoft Foundry). The error names which of these it was; the display stays as it was, and max_thinking_tokens still applies when the request has it.
5317
+ * Sets the maximum number of thinking tokens for extended thinking. When max_thinking_tokens is null, thinking resets to the session default: any mid-session budget override is cleared (back to the spawn-time budget, if one was set), and thinking stays off for sessions that have it disabled. When max_thinking_tokens is omitted, the budget is left as it is, so a request that only changes thinking_display can leave the field out. thinking_display optionally sets the thinking display mode for the rest of the session: a value replaces the session display mode, null clears that override so Claude Code's default display handling applies again, and when omitted the display mode from session start (--thinking-display) is kept. 'highlights' returns one short title per stretch of thinking instead of a prose summary. The API accepts it only from Claude Code sessions that Anthropic hosts; if the API rejects it, the session sends 'omitted' (no thinking text) in its place from then on. A request for 'highlights' gets an error reply after such a rejection, when experimental betas are off (CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS or organization policy), on a Claude 3 model (except on Microsoft Foundry), or on Amazon Bedrock (Mantle included), Google Vertex AI or a Claude apps gateway (API provider "gateway") with a model released before Claude Opus 4.7. The error names which of these it was; the display stays as it was, and max_thinking_tokens still applies when the request has it.
5308
5318
  */
5309
5319
  declare type SDKControlSetMaxThinkingTokensRequest = {
5310
5320
  subtype: 'set_max_thinking_tokens';
@@ -5814,7 +5824,7 @@ export declare type SDKPermissionRuleEntry = {
5814
5824
  /**
5815
5825
  * Where the rule comes from. Mirrors PermissionRuleSource (permissionRuleLookup.ts PERMISSION_RULE_SOURCES); the parity test in test/cli/headlessControl/listPermissionRules.test.ts keeps the two aligned.
5816
5826
  */
5817
- source: 'userSettings' | 'projectSettings' | 'localSettings' | 'flagSettings' | 'policySettings' | 'cliArg' | 'command' | 'session' | 'toolsNarrowing' | 'mcpServerPolicy' | 'hostCredential';
5827
+ source: 'userSettings' | 'projectSettings' | 'localSettings' | 'flagSettings' | 'policySettings' | 'cliArg' | 'command' | 'session' | 'mcpMount' | 'toolsNarrowing' | 'mcpServerPolicy' | 'hostCredential';
5818
5828
  /**
5819
5829
  * The stored rule string VERBATIM, exactly as the session holds it. Two stored spellings that parse identically each get their own entry. Can carry invisible or control characters by design — escape at display.
5820
5830
  */
@@ -5974,6 +5984,9 @@ export declare type SDKResultError = {
5974
5984
  * Why this turn continued one that a worker restart interrupted. Such a turn is the automatic re-run of the interrupted turn (CLAUDE_CODE_RESUME_INTERRUPTED_TURN), or one that goes on from the answer to the permission prompt the new worker took over, or from that turn's tool calls still in flight. The value is the host's CLAUDE_CODE_RESUME_REASON when it set one (host_draining, checkpoint_restore, container_recreated, …), else 'interrupted_turn'. Present on such a headless turn's result, success or error, with or without an echo (a turn whose opening user prompt could not be vouched for still carries the reason); absent on every other turn (also one that goes on from the answer to any other permission prompt), on the Remote Control bridge's per-turn synthetic results, and from older producers.
5975
5985
  */
5976
5986
  resume_reason?: string;
5987
+
5988
+
5989
+
5977
5990
  terminal_reason?: TerminalReason;
5978
5991
 
5979
5992
  /**
@@ -6015,6 +6028,11 @@ export declare type SDKResultSuccess = {
6015
6028
 
6016
6029
 
6017
6030
 
6031
+
6032
+
6033
+
6034
+
6035
+
6018
6036
 
6019
6037
 
6020
6038
 
@@ -6045,6 +6063,9 @@ export declare type SDKResultSuccess = {
6045
6063
  warm_spare_claimed?: boolean;
6046
6064
 
6047
6065
  time_origin_ms?: number;
6066
+
6067
+
6068
+
6048
6069
  is_error: boolean;
6049
6070
  api_error_status?: number | null;
6050
6071
 
@@ -7935,6 +7956,12 @@ export declare interface Settings {
7935
7956
  * Whether to automatically update this marketplace and its installed plugins on startup
7936
7957
  */
7937
7958
  autoUpdate?: boolean;
7959
+ /**
7960
+ * Managed settings only: the plugins of this marketplace that an organization delivers with its own tier, by plugin name, each with the digests of its releases. A plugin also enabled and listed in prependPlugins or appendPlugins by managed settings the session vouches for loads its hooks module only from a folder that proves one of them, and is then seated in that tier; any other copy does not load. A digest is sha256- and the base64 SHA-256 of, for every regular file in the folder in UTF-16 code unit order of its path, not normalized, "f PATH" NUL BYTE-LENGTH NUL BYTES, with / in paths; .git, .in_use, .orphaned_at, .claude-plugin-link and .links_materialized at the root are left out. The plugin keeps its manifest at .claude-plugin/plugin.json and names one module in hooks/hooks.json. A string of any other form, or a list that is empty or of any other shape, matches no folder. A symbolic link, or a surface module, proves nothing. A proved plugin ships bundled with no install step: the digest covers the whole folder, node_modules included. A checkout whose line endings were converted proves nothing.
7961
+ */
7962
+ pluginDigests?: {
7963
+ [k: string]: string[];
7964
+ };
7938
7965
  };
7939
7966
  };
7940
7967
  /**
@@ -8187,6 +8214,12 @@ export declare interface Settings {
8187
8214
  * Whether to automatically update this marketplace and its installed plugins on startup
8188
8215
  */
8189
8216
  autoUpdate?: boolean;
8217
+ /**
8218
+ * Managed settings only: the plugins of this marketplace that an organization delivers with its own tier, by plugin name, each with the digests of its releases. A plugin also enabled and listed in prependPlugins or appendPlugins by managed settings the session vouches for loads its hooks module only from a folder that proves one of them, and is then seated in that tier; any other copy does not load. A digest is sha256- and the base64 SHA-256 of, for every regular file in the folder in UTF-16 code unit order of its path, not normalized, "f PATH" NUL BYTE-LENGTH NUL BYTES, with / in paths; .git, .in_use, .orphaned_at, .claude-plugin-link and .links_materialized at the root are left out. The plugin keeps its manifest at .claude-plugin/plugin.json and names one module in hooks/hooks.json. A string of any other form, or a list that is empty or of any other shape, matches no folder. A symbolic link, or a surface module, proves nothing. A proved plugin ships bundled with no install step: the digest covers the whole folder, node_modules included. A checkout whose line endings were converted proves nothing.
8219
+ */
8220
+ pluginDigests?: {
8221
+ [k: string]: string[];
8222
+ };
8190
8223
  };
8191
8224
  };
8192
8225
  /**