@anthropic-ai/claude-agent-sdk 0.3.270 → 0.3.272

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.270",
2
+ "version": "2.1.272",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "97ecbf7abeb4170dcfd26c4d4b397afd9015030e",
5
- "modsCommit": "536a2e23d9e28586f81f17b3535281b5f2995a70",
6
- "buildDate": "2026-09-12T18:17:55Z",
4
+ "commit": "013cad548b76e5d315ae72da82dce47cd7c99678",
5
+ "modsCommit": "f4ceeecabff13e814dc4302620e2da1a688e47f8",
6
+ "buildDate": "2026-09-14T23:03:38Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude",
10
- "checksum": "a506b6d970a4cf44f6abdb53a81ddcd5d3b0ce042a95c502fe9d1f946bdb8807",
11
- "size": 207500480
10
+ "checksum": "195e24e8e1f9bf46f1eaee72d434a33e18f9f5796f29a6348a00d16c5f8aee75",
11
+ "size": 210702192
12
12
  },
13
13
  "darwin-x64": {
14
14
  "binary": "claude",
15
- "checksum": "b3ee3237a019b8a5abb3008f1c7ddd46295a0e6e65ab94545a79c9b997dc8928",
16
- "size": 216316928
15
+ "checksum": "6377b8e95ecbf90fd6b91e543b3c23e1b23c9c968b2acb7ad460ce5573d3e41c",
16
+ "size": 219487840
17
17
  },
18
18
  "linux-arm64": {
19
19
  "binary": "claude",
20
- "checksum": "7bf9f33acc124df9abccf6f2366397a82a740378d535fa12d426fa77fdbc9946",
21
- "size": 223862184
20
+ "checksum": "214a90efdd16ee0ea81132ffecced588dba394d178cc494f285ba04b5288c8de",
21
+ "size": 227074288
22
22
  },
23
23
  "linux-x64": {
24
24
  "binary": "claude",
25
- "checksum": "3a624a5a7cd79bbad4d32bd7db36f1197ecf458bc5bf1e2aed81834a01ad3ef0",
26
- "size": 223981040
25
+ "checksum": "d81396a668eb76fbddb49a2a5841f1b5d7af96b4c1f6500ced92f2c988f5bcd4",
26
+ "size": 227115320
27
27
  },
28
28
  "linux-arm64-musl": {
29
29
  "binary": "claude",
30
- "checksum": "067b322dfca0ed81521b562ef05825e8be282eeb5c83441e4be824415572dbc0",
31
- "size": 216545032
30
+ "checksum": "226928f89d344b80f5f32aa13b79cba8816c0a7fb0b43c8b3b47c8840f11d580",
31
+ "size": 219625120
32
32
  },
33
33
  "linux-x64-musl": {
34
34
  "binary": "claude",
35
- "checksum": "38f98338ff23afce49c66c83ac57ea238f84e7f4e8c17ae7cc74b3eeaee9a299",
36
- "size": 217894976
35
+ "checksum": "e30bb3ac07c4f1c3f63b47312e9a73ba6875256b7768c4cdb784d2b179417489",
36
+ "size": 221036504
37
37
  },
38
38
  "win32-x64": {
39
39
  "binary": "claude.exe",
40
- "checksum": "fd7f35ec7761195ab5ba4eff423e48a78a7849e78f60d93ec31256cdb1a9ec7e",
41
- "size": 227051168
40
+ "checksum": "cd8d8d33e549ba5973428bcf18310164227d68ca756925242c47d3b0d48bf4dc",
41
+ "size": 230228640
42
42
  },
43
43
  "win32-arm64": {
44
44
  "binary": "claude.exe",
45
- "checksum": "fda3cff248cfe4536f7ecf04b363a360fe4caba8bdedeb8d37fc0d80428d7894",
46
- "size": 218256032
45
+ "checksum": "e8fbdb138cb3b438929286f234663f98fe0a914d77d6c8589a51f3ecf8915462",
46
+ "size": 221452448
47
47
  }
48
48
  },
49
49
  "sdkCompat": {
50
50
  "testedWrapperVersions": [
51
- "0.3.229",
52
- "0.3.231",
53
51
  "0.3.232",
54
52
  "0.3.233",
55
53
  "0.3.234",
@@ -77,7 +75,9 @@
77
75
  "0.3.266",
78
76
  "0.3.267",
79
77
  "0.3.268",
80
- "0.3.269"
78
+ "0.3.269",
79
+ "0.3.270",
80
+ "0.3.271"
81
81
  ],
82
82
  "harnessSchema": 1
83
83
  }
package/manifest.zst.json CHANGED
@@ -1,63 +1,61 @@
1
1
  {
2
- "version": "2.1.270",
2
+ "version": "2.1.272",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "97ecbf7abeb4170dcfd26c4d4b397afd9015030e",
5
- "modsCommit": "536a2e23d9e28586f81f17b3535281b5f2995a70",
6
- "buildDate": "2026-09-12T18:18:59Z",
4
+ "commit": "013cad548b76e5d315ae72da82dce47cd7c99678",
5
+ "modsCommit": "f4ceeecabff13e814dc4302620e2da1a688e47f8",
6
+ "buildDate": "2026-09-14T23:04:39Z",
7
7
  "platforms": {
8
8
  "darwin-arm64": {
9
9
  "binary": "claude.zst",
10
- "checksum": "1b67468576dfe09f1975c5ddf2e10898e7632124995d68fb8b94545422cd8588",
11
- "size": 68224840,
10
+ "checksum": "9bc86af289b3acd06d88ecdc6fab53e2c3590467984639d251aa28ca1d589f66",
11
+ "size": 69282560,
12
12
  "bundle": {
13
- "checksum": "00e61c22a32dda2f56adcde562ea868e650abfd1b6af996a166d7a9896ec26ef",
14
- "size": 68228599
13
+ "checksum": "0f1472f473c0b0397efcb71906931bf14aac14d1487290c8dcfeeb4380123d1b",
14
+ "size": 69289478
15
15
  }
16
16
  },
17
17
  "darwin-x64": {
18
18
  "binary": "claude.zst",
19
- "checksum": "9e40f35e95a1abc6e4e42405bfd98cfceaab644488c69240b59b6955144115f5",
20
- "size": 72355319,
19
+ "checksum": "ceaee8ea1f6e3c7f468cd6e486367f6b129a1b76899b086b83ad7ccb1608b0b8",
20
+ "size": 73437901,
21
21
  "bundle": {
22
- "checksum": "95daa6cb8a9612d9ef35f71891dc10330fc86fc1e83e4eb778b8e76609c79ca5",
23
- "size": 72351007
22
+ "checksum": "6aecf0d1b0668278f0027d07bb5ce190aac1da74c1417113f87961f49584b28e",
23
+ "size": 73438431
24
24
  }
25
25
  },
26
26
  "linux-arm64": {
27
27
  "binary": "claude.zst",
28
- "checksum": "606c2f83c39682f6b4a6ff474b496de5911065951e5a72bcd951469e25dd811d",
29
- "size": 77422861
28
+ "checksum": "cc54fca24f7dec6ed921996121ae65e435cadbb50d256850e1cc70f3ae8b02e2",
29
+ "size": 78477860
30
30
  },
31
31
  "linux-x64": {
32
32
  "binary": "claude.zst",
33
- "checksum": "59c056cd321c131eb211f6e90f4b9812dd24820357169f2ec9ca6a4b51d89d9c",
34
- "size": 78038652
33
+ "checksum": "ef2c2de4f3464443e55e91b8552d67459e92f98b691198d1888de3bd49baaf4d",
34
+ "size": 79104422
35
35
  },
36
36
  "linux-arm64-musl": {
37
37
  "binary": "claude.zst",
38
- "checksum": "040a816864ab8059ef75e6929464cb6ba15545a47f7ee7ed3f8d4a4618e17823",
39
- "size": 75885941
38
+ "checksum": "4c704bfab338332a6ea08b34fd57d2a961db55a16513252abfa6058160bb8bda",
39
+ "size": 76932867
40
40
  },
41
41
  "linux-x64-musl": {
42
42
  "binary": "claude.zst",
43
- "checksum": "953773d54d4e7381830104821e120967e0b96254e78f28315f672368b59505a7",
44
- "size": 76529820
43
+ "checksum": "9bc829d18b604f36764f53436ce3c5340de26e657f7c38367074cf28da41f159",
44
+ "size": 77594510
45
45
  },
46
46
  "win32-x64": {
47
47
  "binary": "claude.exe.zst",
48
- "checksum": "2afb47ea1b1fe0bb224ddded3ddccf6303baac06f0f76c2921706c8bb9506d64",
49
- "size": 80423657
48
+ "checksum": "f6b1c5f9c3a457d2aad026084ad459d8695a3d546be8b6ca972140b2ed7c0e31",
49
+ "size": 81487963
50
50
  },
51
51
  "win32-arm64": {
52
52
  "binary": "claude.exe.zst",
53
- "checksum": "065bef2eb62e52e36ee80856ff03bcf542d71deac88a598c3fa10f5b46c9ba66",
54
- "size": 77193327
53
+ "checksum": "bb01dee14a4084375e712bdcb467c591b7dfa9674b905bbcf66b5cd3d8c69376",
54
+ "size": 78223647
55
55
  }
56
56
  },
57
57
  "sdkCompat": {
58
58
  "testedWrapperVersions": [
59
- "0.3.229",
60
- "0.3.231",
61
59
  "0.3.232",
62
60
  "0.3.233",
63
61
  "0.3.234",
@@ -85,7 +83,9 @@
85
83
  "0.3.266",
86
84
  "0.3.267",
87
85
  "0.3.268",
88
- "0.3.269"
86
+ "0.3.269",
87
+ "0.3.270",
88
+ "0.3.271"
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.270",
3
+ "version": "0.3.272",
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.270",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.270",
62
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.270",
63
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.270",
64
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.270",
65
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.270",
66
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.270",
67
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.270"
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.272",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.272",
62
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.272",
63
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.272",
64
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.272",
65
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.272",
66
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.272",
67
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.272"
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.270"
83
+ "claudeCodeVersion": "2.1.272"
84
84
  }
package/sdk-tools.d.ts CHANGED
@@ -2910,13 +2910,9 @@ export interface MonitorInput {
2910
2910
  */
2911
2911
  description: string;
2912
2912
  /**
2913
- * Kill the monitor after this deadline. Default 300000ms, max 3600000ms. Ignored when persistent is true.
2913
+ * Kill the monitor after this deadline. Default 300000ms. Deadlines above 1800000ms are capped to 1800000ms. You are notified at expiry and can re-arm.
2914
2914
  */
2915
2915
  timeout_ms: number;
2916
- /**
2917
- * Run for the lifetime of the session (no timeout). Use for session-length watches like PR monitoring or log tails. Stop with TaskStop.
2918
- */
2919
- persistent: boolean;
2920
2916
  /**
2921
2917
  * Shell command or script. Each stdout line is an event; exit ends the watch.
2922
2918
  */
@@ -3092,7 +3088,7 @@ export interface ProposeGoalInput {
3092
3088
  }
3093
3089
  export interface ArtifactInput {
3094
3090
  /**
3095
- * 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 **To read an existing artifact's content**. 'watch', 'unwatch', and 'status' manage live-update subscriptions that notify a session when an artifact is republished elsewhere, and those aren't available in this session: 'watch' only reports that — no republish notification reaches this session — 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.
3091
+ * 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 that notify a session when an artifact is republished elsewhere, and those aren't available in this session: 'watch' only reports that — no republish notification reaches this session — 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.
3096
3092
  */
3097
3093
  action?:
3098
3094
  | "publish"
@@ -3151,7 +3147,7 @@ export interface ArtifactInput {
3151
3147
  */
3152
3148
  force?: boolean;
3153
3149
  /**
3154
- * read_asset: directory to save the file into (default: the working directory); the file is named by the asset id plus the extension for its type.
3150
+ * 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.
3155
3151
  */
3156
3152
  out_dir?: string;
3157
3153
  /**
package/sdk.d.ts CHANGED
@@ -77,6 +77,10 @@ export declare type AgentDefinition = {
77
77
  * Run this agent as a background task (non-blocking, fire-and-forget) when invoked
78
78
  */
79
79
  background?: boolean;
80
+ /**
81
+ * Run this agent without the user, project and local CLAUDE.md instruction files when it runs as a subagent; managed policy files are kept. For agents that take everything they need from the delegation prompt. No effect on the main session agent.
82
+ */
83
+ omitClaudeMd?: boolean;
80
84
  /**
81
85
  * Scope for auto-loading agent memory files. 'user' - ~/.claude/agent-memory/<agentType>/, 'project' - .claude/agent-memory/<agentType>/, 'local' - .claude/agent-memory-local/<agentType>/
82
86
  */
@@ -1681,6 +1685,7 @@ export declare type Options = {
1681
1685
  */
1682
1686
  perTaskStopAffordance?: boolean;
1683
1687
 
1688
+
1684
1689
  /**
1685
1690
  * When false, disables session persistence to disk. Sessions will not be
1686
1691
  * saved to ~/.claude/projects/ and cannot be resumed later. Useful for
@@ -3406,6 +3411,7 @@ export declare type SDKAssistantMessage = {
3406
3411
 
3407
3412
 
3408
3413
 
3414
+
3409
3415
  };
3410
3416
 
3411
3417
  export declare type SDKAssistantMessageError = 'authentication_failed' | 'oauth_org_not_allowed' | 'account_on_hold' | 'verification_required' | 'billing_error' | 'rate_limit' | 'overloaded' | 'invalid_request' | 'model_not_found' | 'server_error' | 'unknown' | 'max_output_tokens' | 'cloud_credential_error';
@@ -3878,6 +3884,10 @@ declare type SDKControlGetHooksListingResponse = {
3878
3884
  * Hooks configured in managed settings (they run even under a non-managed disableAllHooks).
3879
3885
  */
3880
3886
  policyHookCount: number;
3887
+ /**
3888
+ * Present when a managed settings source exists but could not be read: what the organization configured is unknown, so edit_hook refuses every edit (fail-closed) and a host locks its editing controls, as it does under the three locks above.
3889
+ */
3890
+ policyUnreadable?: true;
3881
3891
  };
3882
3892
  /**
3883
3893
  * Present only when the session runs under --safe-mode.
@@ -4212,6 +4222,7 @@ declare type SDKControlInitializeRequest = {
4212
4222
  * Declares that this consumer renders a per-task stop control wired to the `stop_task` control request, so the user can stop an individual background task. When declared, an interrupt on an open-input (interactive stream-json) session spares running background agents/workflows (Stop only aborts the turn). Closed-input exception: a one-shot run (string prompt / -p closes stdin) still kills hold-back tasks at the held-result release regardless of the declaration — with stdin closed, a stop_task control could never be delivered, so the fail-closed kill stands. ABSENCE also fails closed: the interrupt kills background tasks, since the user would otherwise have no way to stop a runaway one. First-attached-client-wins on multi-client sessions; later initializes do not change it.
4213
4223
  */
4214
4224
  perTaskStopAffordance?: boolean;
4225
+
4215
4226
  /**
4216
4227
  * Plugins to load for the session, in the same shape as the SDK `plugins` option: the stdin form of one --plugin-dir flag per entry (--plugin-dir-no-mcp when skipMcpDiscovery is set), so the launch command line does not grow with the plugin count. Loaded only by a CLI launched with --await-initialize, which reads this request during startup before any plugin work. Without that flag, on a repeated initialize, or over a remote session transport the field loads nothing; plugins_applied in the response reports whether the listed plugins are in fact loaded.
4217
4228
  */
@@ -6330,7 +6341,7 @@ export declare interface Settings {
6330
6341
  replaceBuiltInOptions?: boolean;
6331
6342
  };
6332
6343
  /**
6333
- * Price usage at your organization's contracted rates instead of list price. Affects every spend figure Claude Code reports — /cost, the status line, the SDK total_cost_usd, --max-budget-usd, and the OpenTelemetry cost metric and events — which remain USD estimates, not an invoice (the per-Mtok price labels in /model stay at list). "overrides" maps a model ID to its USD-per-million-token rates (input, output, cacheRead, cacheWrite — all four required, each 0 to 10000; cacheWrite prices both 5-minute and 1-hour cache writes). A matching row is charged exactly as written; fast-mode and US-data-residency surcharges are not added on top. A key Claude Code itself uses for a built-in model — its ID such as "claude-sonnet-4-6", or its first-party, Bedrock (any or no region prefix), Vertex or Foundry ID — covers every dated and provider form of that model; any other key — a gateway model alias, or a spelling Claude Code does not itself use — matches that model ID only (case-insensitive), and such an exact match wins over a built-in row. On Bedrock an application inference profile is matched by its backing model. An invalid row or multiplier is reported and skipped; the rest still apply. "multiplier" in (0, 1] scales every computed cost, overridden or not (0.85 = 85% of the price). Only honored from managed settings (server-managed, MDM / OS policy, or managed-settings.json), or — when none of those sets it — when supplied by a host application that manages the model provider; ignored in user, project, local and --settings sources.
6344
+ * Price usage at your organization's contracted rates instead of list price. Affects every spend figure Claude Code reports — /cost, the status line, the SDK total_cost_usd, --max-budget-usd, and the OpenTelemetry cost metric and events — which remain USD estimates, not an invoice (the per-Mtok price labels in /model stay at list). "overrides" maps a model ID to its USD-per-million-token rates (input, output, cacheRead, cacheWrite — all four required, each 0 to 10000; cacheWrite prices both 5-minute and 1-hour cache writes). A matching row is charged exactly as written; fast-mode and US-data-residency surcharges are not added on top. A key Claude Code itself uses for a built-in model — its ID such as "claude-sonnet-4-6", or its first-party, Bedrock (any or no region prefix), Vertex or Foundry ID — covers every dated and provider form of that model; any other key — a gateway model alias, or a spelling Claude Code does not itself use — matches that model ID only (case-insensitive), and such an exact match wins over a built-in row. On Bedrock an application inference profile is matched by its backing model. An invalid row or multiplier is reported and skipped; the rest still apply. "multiplier" in (0, 10] scales every computed cost, overridden or not (0.85 = 85% of the price, 1.2 = 120%). Only honored from managed settings (server-managed, MDM / OS policy, or managed-settings.json), or — when none of those sets it — when supplied by a host application that manages the model provider; ignored in user, project, local and --settings sources.
6334
6345
  */
6335
6346
  modelPricing?: {
6336
6347
  multiplier?: number;
@@ -6661,7 +6672,7 @@ export declare interface Settings {
6661
6672
  */
6662
6673
  enableWorkflows?: boolean;
6663
6674
  /**
6664
- * Advisory size guideline for the dynamic workflows Claude writes: "small" aims for fewer than 5 agents, "medium" (the default) fewer than 15, "large" fewer than 50, and "unrestricted" sends no guideline. A value here — including from managed settings — takes precedence over the "Dynamic workflow size" choice in /config, and that /config row is hidden while a settings file provides the key. This is a guideline, not an enforced limit.
6675
+ * Advisory size guideline for the dynamic workflows Claude writes: "small" aims for fewer than 5 agents, "medium" fewer than 10, "large" fewer than 50, and "unrestricted" sends no guideline. Unset defaults to "medium", or "small" on Pro plans. A value here — including from managed settings — takes precedence over the "Dynamic workflow size" choice in /config, and that /config row is hidden while a settings file provides the key. This is a guideline, not an enforced limit.
6665
6676
  */
6666
6677
  workflowSizeGuideline?: 'unrestricted' | 'small' | 'medium' | 'large';
6667
6678
  /**