@anthropic-ai/claude-agent-sdk 0.3.195 → 0.3.197

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,47 +1,47 @@
1
1
  {
2
- "version": "2.1.195",
3
- "commit": "4603aa3f2ea164bd0974f82eb413ae7acc99a7ee",
4
- "buildDate": "2026-06-26T01:56:37Z",
2
+ "version": "2.1.197",
3
+ "commit": "c8fd8048f30950a21d28734718275aa7e97f5143",
4
+ "buildDate": "2026-06-29T19:16:30Z",
5
5
  "platforms": {
6
6
  "darwin-arm64": {
7
7
  "binary": "claude",
8
- "checksum": "8b45adad93f336ab95f33e714494b19fd3377a494eb05c122c8677bc895876ad",
9
- "size": 224682640
8
+ "checksum": "8cc0c4d1e4eb1dca3b0cc92ab02ee3505de764e023f8c901761c167b72041fb8",
9
+ "size": 227251472
10
10
  },
11
11
  "darwin-x64": {
12
12
  "binary": "claude",
13
- "checksum": "7eb8716e6d6e6a278d13158793529336290837fca457facfec656f1b1a287c60",
14
- "size": 234066032
13
+ "checksum": "5e8a57cc7a92377f0744fa4c79191cf93d4b26c79cb919b07a407511fed1be26",
14
+ "size": 235288016
15
15
  },
16
16
  "linux-arm64": {
17
17
  "binary": "claude",
18
- "checksum": "b02279999058dc80a0e1c5d39463d1545a178615492f84139aac8d61214a7e9a",
19
- "size": 241154800
18
+ "checksum": "fb48473c467c27615ac799a754f4ef0b68c363e4596cefbb59c3815d51a0cc8a",
19
+ "size": 242334448
20
20
  },
21
21
  "linux-x64": {
22
22
  "binary": "claude",
23
- "checksum": "8323e70125063147a4478b957745d835a87e5e72ffd25b838ea9a841c03e6a37",
24
- "size": 244276024
23
+ "checksum": "f54e69cbc89b2da61a415700af7ff52a147e862517d4f1b0eecf768448cf7f83",
24
+ "size": 245517112
25
25
  },
26
26
  "linux-arm64-musl": {
27
27
  "binary": "claude",
28
- "checksum": "52713b5f7690764b3b4742807b1a6fab24ce5e01dabf82964b97f519e8f9e7fe",
29
- "size": 234403000
28
+ "checksum": "acb885610ba06d90c46206ded9b14121bc30e96affecbfb3c37d511bf02af2bd",
29
+ "size": 235582648
30
30
  },
31
31
  "linux-x64-musl": {
32
32
  "binary": "claude",
33
- "checksum": "63a2b3291369ff85e970c0cfd3767bb48065071ec12fb2d0055387ccde511541",
34
- "size": 238977408
33
+ "checksum": "2f610c0f81341052426981b5dc59277a33e6ec3df924071b24edbc05e6a096dc",
34
+ "size": 240202112
35
35
  },
36
36
  "win32-x64": {
37
37
  "binary": "claude.exe",
38
- "checksum": "3ef7fb7b16e169739640fe2903ee7011cff8b43d2dbb15f9badc9b11cfad18a3",
39
- "size": 234930336
38
+ "checksum": "038bd9fe90c60304601e19751269a50d62925c541dd6a2b3da5274549e9416ee",
39
+ "size": 236121248
40
40
  },
41
41
  "win32-arm64": {
42
42
  "binary": "claude.exe",
43
- "checksum": "038fb49213c0ac828b5a8a1f31cf510753d7e7891e9ae4596673a602cff251f5",
44
- "size": 229410464
43
+ "checksum": "8d2baeaf77b0e79ea33cf5ce78a37e64804c3a26d63d35355a830fda404a4f61",
44
+ "size": 230588064
45
45
  }
46
46
  }
47
47
  }
package/manifest.zst.json CHANGED
@@ -1,55 +1,55 @@
1
1
  {
2
- "version": "2.1.195",
3
- "commit": "4603aa3f2ea164bd0974f82eb413ae7acc99a7ee",
4
- "buildDate": "2026-06-26T01:58:22Z",
2
+ "version": "2.1.197",
3
+ "commit": "c8fd8048f30950a21d28734718275aa7e97f5143",
4
+ "buildDate": "2026-06-29T19:18:17Z",
5
5
  "platforms": {
6
6
  "darwin-arm64": {
7
7
  "binary": "claude.zst",
8
- "checksum": "edd737e0b727d846b333abea409fe41b288d93a61b57c9436ba5936a95777524",
9
- "size": 46324238,
8
+ "checksum": "9b11f0d6c9ce73434bf75440eb19f339c47e099da6d53c481cda1a9c6e693a7d",
9
+ "size": 47889227,
10
10
  "bundle": {
11
- "checksum": "dadeba60923e54e98dc5a1a391be77839fb7f23bf1e66d69988daa951caf5e57",
12
- "size": 46316695
11
+ "checksum": "c921aa65eb8f10a3f387a86526f97b94dee721f26b741dadf0d2357ac376c437",
12
+ "size": 47903450
13
13
  }
14
14
  },
15
15
  "darwin-x64": {
16
16
  "binary": "claude.zst",
17
- "checksum": "d2b1b1ca02bf3f15d90e63c645c12e854cd9b860bc134278b9f5be2ccdc9ad51",
18
- "size": 50621837,
17
+ "checksum": "a1dc9d160ae29aff4373dec60623111080fe2c645a21f25c96dd2b443ee184e6",
18
+ "size": 50919995,
19
19
  "bundle": {
20
- "checksum": "42b85b75f832b0e1ab2c2e27e7f7bdc3f7d754f26a9b09aee1ab8a3ca641ead8",
21
- "size": 50626429
20
+ "checksum": "f2d6011db80732e4f0850d5c27e0ce83bb4d2c4a66374072134232214dddedab",
21
+ "size": 50915693
22
22
  }
23
23
  },
24
24
  "linux-arm64": {
25
25
  "binary": "claude.zst",
26
- "checksum": "92790e9ac5e82011b13603fdc6cbd169f4404a7294dba096bfd53d4d148418ea",
27
- "size": 55414570
26
+ "checksum": "e5f4307ad01f9720878ce4088331f33722cdd610aaa1d0026260ca9ced498030",
27
+ "size": 55692187
28
28
  },
29
29
  "linux-x64": {
30
30
  "binary": "claude.zst",
31
- "checksum": "502eb0186d3f2af31fc1eff3a89d440ce682cb941a09ab9f95828635e2e6cdcf",
32
- "size": 56663286
31
+ "checksum": "bbb773dbaaa24c20d564ae83ce906d9b676c3ccb8f092176722bcbc5016d957b",
32
+ "size": 56956227
33
33
  },
34
34
  "linux-arm64-musl": {
35
35
  "binary": "claude.zst",
36
- "checksum": "6d318ddec8dc6bbab324ae0b70231160721f608c837a92a449c24359db87971a",
37
- "size": 54087314
36
+ "checksum": "55464849825a33e23de886656a1b7e2bdaa0edc21854c88f9e5468ac97997f1d",
37
+ "size": 54362236
38
38
  },
39
39
  "linux-x64-musl": {
40
40
  "binary": "claude.zst",
41
- "checksum": "9ea3130f98bcdfa9651ce487c415787928e5392568b391628be2da4aa62f0ba2",
42
- "size": 55471929
41
+ "checksum": "506a64a81005e1cd7b4b540061b10f6de62297a456a47070894faa994e1cf5eb",
42
+ "size": 55764001
43
43
  },
44
44
  "win32-x64": {
45
45
  "binary": "claude.exe.zst",
46
- "checksum": "b1d4cfecfb3c5c617cf0c4f52406cee1f7f5c7c39ad73009c92e351066ca52f1",
47
- "size": 56797947
46
+ "checksum": "e5a97e820e244ddfef2f3fd61e7dbc15daed49615ab9ec7f7946256aca565456",
47
+ "size": 57090391
48
48
  },
49
49
  "win32-arm64": {
50
50
  "binary": "claude.exe.zst",
51
- "checksum": "7ada1c6de7e4111a7bc128389f96f013af57997f39efb46d35759ed5ce2e5ab6",
52
- "size": 54835024
51
+ "checksum": "e75b4797151ea6eba808d353759b28a22d6c1cf12cc327f349fdeef414607ecc",
52
+ "size": 55093687
53
53
  }
54
54
  }
55
55
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.195",
3
+ "version": "0.3.197",
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.195",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.195",
62
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.195",
63
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.195",
64
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.195",
65
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.195",
66
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.195",
67
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.195"
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.197",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.197",
62
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.197",
63
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.197",
64
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.197",
65
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.197",
66
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.197",
67
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.197"
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.195"
83
+ "claudeCodeVersion": "2.1.197"
84
84
  }
package/sdk-tools.d.ts CHANGED
@@ -24,6 +24,7 @@ export type ToolInputSchemas =
24
24
  | NotebookEditInput
25
25
  | ReadMcpResourceDirInput
26
26
  | ReadMcpResourceInput
27
+ | ReportFindingsInput
27
28
  | TodoWriteInput
28
29
  | WebFetchInput
29
30
  | WebSearchInput
@@ -63,6 +64,7 @@ export type ToolOutputSchemas =
63
64
  | NotebookEditOutput
64
65
  | ReadMcpResourceDirOutput
65
66
  | ReadMcpResourceOutput
67
+ | ReportFindingsOutput
66
68
  | TodoWriteOutput
67
69
  | WebFetchOutput
68
70
  | WebSearchOutput
@@ -687,6 +689,43 @@ export interface ReadMcpResourceInput {
687
689
  */
688
690
  uri: string;
689
691
  }
692
+ export interface ReportFindingsInput {
693
+ /**
694
+ * Effort level the review ran at
695
+ */
696
+ level?: "low" | "medium" | "high" | "xhigh" | "max";
697
+ /**
698
+ * Verified findings, most-severe first; empty if none survived
699
+ *
700
+ * @maxItems 32
701
+ */
702
+ findings: {
703
+ /**
704
+ * Repo-relative path of the file the finding is in
705
+ */
706
+ file: string;
707
+ /**
708
+ * 1-indexed line the finding anchors to
709
+ */
710
+ line?: number;
711
+ /**
712
+ * One-sentence statement of the defect
713
+ */
714
+ summary: string;
715
+ /**
716
+ * Concrete inputs/state → wrong output/crash
717
+ */
718
+ failure_scenario: string;
719
+ /**
720
+ * Set when a verify pass ran; absent on inline-only reviews
721
+ */
722
+ verdict?: "CONFIRMED" | "PLAUSIBLE";
723
+ /**
724
+ * Set ONLY when re-reporting after applying fixes: what happened to this finding
725
+ */
726
+ outcome?: "fixed" | "skipped" | "no_change_needed";
727
+ }[];
728
+ }
690
729
  export interface TodoWriteInput {
691
730
  /**
692
731
  * The updated todo list
@@ -2526,6 +2565,10 @@ export interface ArtifactInput {
2526
2565
  * Browser-tab icon: one or two emoji (e.g. "📊"). No markup. Keep stable across redeploys; change only on a hard topic pivot.
2527
2566
  */
2528
2567
  favicon: string;
2568
+ /**
2569
+ * One-sentence subtitle shown on the gallery card. Say what the page is or does.
2570
+ */
2571
+ description?: string;
2529
2572
  /**
2530
2573
  * Short human-readable name for this version, max 60 chars (e.g. "fixed-background"). Shown in the version picker. Not a description — keep it to a few words.
2531
2574
  */
@@ -2920,6 +2963,45 @@ export interface ReadMcpResourceOutput {
2920
2963
  */
2921
2964
  error?: string;
2922
2965
  }
2966
+ export interface ReportFindingsOutput {
2967
+ /**
2968
+ * Number of findings reported
2969
+ */
2970
+ count: number;
2971
+ /**
2972
+ * Effort level the review ran at
2973
+ */
2974
+ level?: "low" | "medium" | "high" | "xhigh" | "max";
2975
+ /**
2976
+ * Echoed for the result body
2977
+ */
2978
+ findings: {
2979
+ /**
2980
+ * Repo-relative path of the file the finding is in
2981
+ */
2982
+ file: string;
2983
+ /**
2984
+ * 1-indexed line the finding anchors to
2985
+ */
2986
+ line?: number;
2987
+ /**
2988
+ * One-sentence statement of the defect
2989
+ */
2990
+ summary: string;
2991
+ /**
2992
+ * Concrete inputs/state → wrong output/crash
2993
+ */
2994
+ failure_scenario: string;
2995
+ /**
2996
+ * Set when a verify pass ran; absent on inline-only reviews
2997
+ */
2998
+ verdict?: "CONFIRMED" | "PLAUSIBLE";
2999
+ /**
3000
+ * Set ONLY when re-reporting after applying fixes: what happened to this finding
3001
+ */
3002
+ outcome?: "fixed" | "skipped" | "no_change_needed";
3003
+ }[];
3004
+ }
2923
3005
  export interface TodoWriteOutput {
2924
3006
  /**
2925
3007
  * The todo list before the update
package/sdk.d.ts CHANGED
@@ -157,6 +157,10 @@ export declare type BaseHookInput = {
157
157
  session_id: string;
158
158
  transcript_path: string;
159
159
  cwd: string;
160
+ /**
161
+ * UUID correlating a user prompt with all subsequent events until the next prompt. Same value emitted on OpenTelemetry events as the `prompt.id` attribute, so hook output can be joined to OTel events at prompt grain. Absent until the first user input of the process lifetime.
162
+ */
163
+ prompt_id?: string;
160
164
  permission_mode?: string;
161
165
  /**
162
166
  * Subagent identifier. Present only when the hook fires from within a subagent (e.g., a tool called by an AgentTool worker). Absent for the main thread, even in --agent sessions. Use this field (not agent_type) to distinguish subagent calls from main-thread calls.
@@ -492,7 +496,7 @@ export declare function deleteSession(_sessionId: string, _options?: SessionMuta
492
496
  * - `'low'` — Minimal thinking, fastest responses
493
497
  * - `'medium'` — Moderate thinking
494
498
  * - `'high'` — Deep reasoning (default)
495
- * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+; falls back to `'high'` elsewhere)
499
+ * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+, Sonnet 5; falls back to `'high'` elsewhere)
496
500
  * - `'max'` — Maximum effort (select models only)
497
501
  */
498
502
  export declare type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
@@ -1164,6 +1168,10 @@ export declare type ModelInfo = {
1164
1168
  * Model identifier to use in API calls
1165
1169
  */
1166
1170
  value: string;
1171
+ /**
1172
+ * Canonical wire model id this row's `value` resolves to (e.g. 'sonnet' → 'claude-sonnet-5'). Lets hosts match a persisted explicit id against the alias row that covers it.
1173
+ */
1174
+ resolvedModel?: string;
1167
1175
  /**
1168
1176
  * Human-readable display name
1169
1177
  */
@@ -1193,6 +1201,7 @@ export declare type ModelInfo = {
1193
1201
  */
1194
1202
  supportsAutoMode?: boolean;
1195
1203
 
1204
+
1196
1205
  };
1197
1206
 
1198
1207
  export declare type ModelUsage = {
@@ -1581,8 +1590,8 @@ export declare type Options = {
1581
1590
  * - `'low'` — Minimal thinking, fastest responses
1582
1591
  * - `'medium'` — Moderate thinking
1583
1592
  * - `'high'` — Deep reasoning (default)
1584
- * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+)
1585
- * - `'max'` — Maximum effort (Fable 5, Opus 4.6+, Sonnet 4.6)
1593
+ * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+, Sonnet 5)
1594
+ * - `'max'` — Maximum effort (Fable 5, Opus 4.6+, Sonnet 4.6+)
1586
1595
  *
1587
1596
  * @see https://docs.anthropic.com/en/docs/build-with-claude/effort
1588
1597
  */
@@ -1633,7 +1642,7 @@ export declare type Options = {
1633
1642
  mcpServers?: Record<string, McpServerConfig>;
1634
1643
  /**
1635
1644
  * Claude model to use. Defaults to the CLI default model.
1636
- * Examples: 'claude-sonnet-4-6', 'claude-opus-4-8', 'claude-fable-5'
1645
+ * Examples: 'claude-sonnet-5', 'claude-opus-4-8', 'claude-fable-5'
1637
1646
  */
1638
1647
  model?: string;
1639
1648
  /**
@@ -1789,7 +1798,7 @@ export declare type Options = {
1789
1798
  *
1790
1799
  * @example Inline settings object
1791
1800
  * ```typescript
1792
- * settings: { model: 'claude-sonnet-4-6', permissions: { allow: ['Bash(*)'] } }
1801
+ * settings: { model: 'claude-sonnet-5', permissions: { allow: ['Bash(*)'] } }
1793
1802
  * ```
1794
1803
  *
1795
1804
  * @example Path to settings file
@@ -2783,6 +2792,7 @@ export declare type SDKCompactBoundaryMessage = {
2783
2792
  trigger: 'manual' | 'auto';
2784
2793
  pre_tokens: number;
2785
2794
  post_tokens?: number;
2795
+
2786
2796
  duration_ms?: number;
2787
2797
 
2788
2798
 
@@ -4854,7 +4864,7 @@ export declare interface Settings {
4854
4864
  */
4855
4865
  timeout?: number;
4856
4866
  /**
4857
- * Model to use for this prompt hook (e.g., "claude-sonnet-4-6"). If not specified, uses the default small fast model.
4867
+ * Model to use for this prompt hook (e.g., "claude-sonnet-5"). If not specified, uses the default small fast model.
4858
4868
  */
4859
4869
  model?: string;
4860
4870
  /**
@@ -4887,7 +4897,7 @@ export declare interface Settings {
4887
4897
  */
4888
4898
  timeout?: number;
4889
4899
  /**
4890
- * Model to use for this agent hook (e.g., "claude-sonnet-4-6"). If not specified, uses Haiku.
4900
+ * Model to use for this agent hook (e.g., "claude-sonnet-5"). If not specified, uses Haiku.
4891
4901
  */
4892
4902
  model?: string;
4893
4903
  /**
@@ -5012,6 +5022,10 @@ export declare interface Settings {
5012
5022
  * Disable the Artifact tool (also via CLAUDE_CODE_DISABLE_ARTIFACT).
5013
5023
  */
5014
5024
  disableArtifact?: boolean;
5025
+ /**
5026
+ * Enable or disable the Artifact tool for this user. Unset = default by plan once the feature is available.
5027
+ */
5028
+ enableArtifact?: boolean;
5015
5029
  /**
5016
5030
  * Enable or disable the Workflows feature for this user. Unset = default by plan once the feature is available.
5017
5031
  */
@@ -6039,6 +6053,7 @@ export declare interface Settings {
6039
6053
  prefersReducedMotion?: boolean;
6040
6054
 
6041
6055
 
6056
+
6042
6057
  /**
6043
6058
  * Enable auto-memory for this project. When false, Claude will not read from or write to the auto-memory directory.
6044
6059
  */