@effect/ai-anthropic 4.0.0-beta.7 → 4.0.0-beta.70

package/dist/AnthropicTool.js

@@ -4,7 +4,7 @@
  * Provides tools that are natively supported by Anthropic's API, including
  * Bash, Code Execution, Computer Use, Memory, and Text Editor functionality.
  *
- * @since 1.0.0
+ * @since 4.0.0
  */
 import * as Schema from "effect/Schema";
 import * as Tool from "effect/unstable/ai/Tool";
@@ -15,11 +15,13 @@ import * as Generated from "./Generated.js";
 /**
  * Anthropic Bash tool (2024-10-22 version).
  *
+ * **Details**
+ *
  * Allows the model to execute bash commands in a sandboxed environment.
  * Requires the "computer-use-2024-10-22" beta header.
  *
- * @since 1.0.0
  * @category Bash
+ * @since 4.0.0
  */
 export const Bash_20241022 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.bash_20241022",
@@ -35,11 +37,13 @@ export const Bash_20241022 = /*#__PURE__*/Tool.providerDefined({
 /**
  * Anthropic Bash tool (2025-01-24 version).
  *
+ * **Details**
+ *
  * Allows the model to execute bash commands in a sandboxed environment.
  * Requires the "computer-use-2025-01-24" beta header.
  *
- * @since 1.0.0
  * @category Bash
+ * @since 4.0.0
  */
 export const Bash_20250124 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.bash_20250124",
@@ -59,10 +63,10 @@ export const Bash_20250124 = /*#__PURE__*/Tool.providerDefined({
 // Code Execution 20250522 Parameters
 // -----------------------------------------------------------------------------
 /**
- * Programmatic tool call execution parameter.
+ * Schema for a code execution request that asks Anthropic to run source code as a programmatic tool call.
  *
- * @since 1.0.0
  * @category Code Execution
+ * @since 4.0.0
  */
 export const CodeExecutionProgrammaticToolCall = /*#__PURE__*/Schema.Struct({
   type: /*#__PURE__*/Schema.Literal("programmatic-tool-call"),
@@ -72,10 +76,10 @@ export const CodeExecutionProgrammaticToolCall = /*#__PURE__*/Schema.Struct({
   code: Schema.String
 });
 /**
- * Bash code execution parameter.
+ * Schema for a code execution request that runs a bash command.
  *
- * @since 1.0.0
  * @category Code Execution
+ * @since 4.0.0
  */
 export const CodeExecutionBashCommand = /*#__PURE__*/Schema.Struct({
   type: /*#__PURE__*/Schema.Literal("bash_code_execution"),
@@ -87,8 +91,8 @@ export const CodeExecutionBashCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Text editor view command for code execution.
  *
- * @since 1.0.0
  * @category Code Execution
+ * @since 4.0.0
  */
 export const CodeExecutionTextEditorView = /*#__PURE__*/Schema.Struct({
   type: /*#__PURE__*/Schema.Literal("text_editor_code_execution"),
@@ -101,8 +105,8 @@ export const CodeExecutionTextEditorView = /*#__PURE__*/Schema.Struct({
 /**
  * Text editor create command for code execution.
  *
- * @since 1.0.0
  * @category Code Execution
+ * @since 4.0.0
  */
 export const CodeExecutionTextEditorCreate = /*#__PURE__*/Schema.Struct({
   type: /*#__PURE__*/Schema.Literal("text_editor_code_execution"),
@@ -119,8 +123,8 @@ export const CodeExecutionTextEditorCreate = /*#__PURE__*/Schema.Struct({
 /**
  * Text editor str_replace command for code execution.
  *
- * @since 1.0.0
  * @category Code Execution
+ * @since 4.0.0
  */
 export const CodeExecutionTextEditorStrReplace = /*#__PURE__*/Schema.Struct({
   type: /*#__PURE__*/Schema.Literal("text_editor_code_execution"),
@@ -143,10 +147,10 @@ const CodeExecution_20250522_Parameters = /*#__PURE__*/Schema.Union([CodeExecuti
 // Code Execution 20250825 Parameters
 // -----------------------------------------------------------------------------
 /**
- * Simple code execution parameter.
+ * Schema for the 2025-08-25 code execution tool input, containing the code to execute.
  *
- * @since 1.0.0
  * @category Code Execution
+ * @since 4.0.0
  */
 export const CodeExecution_20250825_Parameters = /*#__PURE__*/Schema.Struct({
   /**
@@ -160,12 +164,14 @@ export const CodeExecution_20250825_Parameters = /*#__PURE__*/Schema.Struct({
 /**
  * Anthropic Code Execution tool (2025-05-22 version).
  *
+ * **Details**
+ *
  * Allows the model to execute code in a sandboxed environment with support
  * for multiple execution types including programmatic tool calls, bash
  * execution, and text editor operations.
  *
- * @since 1.0.0
  * @category Code Execution
+ * @since 4.0.0
  */
 export const CodeExecution_20250522 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.code_execution_20250522",
@@ -178,10 +184,12 @@ export const CodeExecution_20250522 = /*#__PURE__*/Tool.providerDefined({
 /**
  * Anthropic Code Execution tool (2025-08-25 version).
  *
+ * **Details**
+ *
  * Allows the model to execute code in a sandboxed environment.
  *
- * @since 1.0.0
  * @category Code Execution
+ * @since 4.0.0
  */
 export const CodeExecution_20250825 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.code_execution_20250825",
@@ -200,29 +208,29 @@ export const CodeExecution_20250825 = /*#__PURE__*/Tool.providerDefined({
 /**
  * An `[x, y]` pixel position.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const Coordinate = /*#__PURE__*/Schema.Tuple([Schema.Number, Schema.Number]);
 /**
  * A `[x1, y1, x2, y2]` position defining top-left and bottom-right corners.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const Region = /*#__PURE__*/Schema.Tuple([Schema.Number, Schema.Number, Schema.Number, Schema.Number]);
 /**
  * The direction of the scroll for scroll actions.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ScrollDirection = /*#__PURE__*/Schema.Literals(["up", "down", "left", "right"]);
 /**
  * Modifier keys that can be held during click/scroll actions.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ModifierKey = /*#__PURE__*/Schema.Literals(["alt", "ctrl", "meta", "shift"]);
 // -----------------------------------------------------------------------------
@@ -254,8 +262,8 @@ const ComputerUse_20251124_Args = /*#__PURE__*/Schema.Struct({
 /**
  * Press a key or key combination (e.g. `"Return"`, `"ctrl+c"`, `"ctrl+s"`).
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseKeyAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("key"),
@@ -267,8 +275,8 @@ export const ComputerUseKeyAction = /*#__PURE__*/Schema.Struct({
 /**
  * Perform a left click at the current mouse position or the specified coordinates.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseLeftClickAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("left_click"),
@@ -281,8 +289,8 @@ export const ComputerUseLeftClickAction = /*#__PURE__*/Schema.Struct({
 /**
  * Move the mouse cursor to the specified coordinates.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseMouseMoveAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("mouse_move"),
@@ -294,8 +302,8 @@ export const ComputerUseMouseMoveAction = /*#__PURE__*/Schema.Struct({
 /**
  * Capture the current display.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseScreenshotAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("screenshot")
@@ -303,8 +311,8 @@ export const ComputerUseScreenshotAction = /*#__PURE__*/Schema.Struct({
 /**
  * Type a text string.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const TypeAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("type"),
@@ -320,8 +328,8 @@ const ComputerUse_20241022_Actions = /*#__PURE__*/Schema.Union([ComputerUseKeyAc
 /**
  * Perform a double click.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseDoubleClickAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("double_click"),
@@ -332,10 +340,10 @@ export const ComputerUseDoubleClickAction = /*#__PURE__*/Schema.Struct({
   coordinate: /*#__PURE__*/Schema.optional(Coordinate)
 });
 /**
- * Holds a key while performing other actions.
+ * Hold a key for a specified duration during computer-use execution.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseHoldKeyAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("hold_key"),
@@ -351,8 +359,8 @@ export const ComputerUseHoldKeyAction = /*#__PURE__*/Schema.Struct({
 /**
  * Click and drag from start coordinate to end coordinate.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseLeftClickDragAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("left_click_drag"),
@@ -368,10 +376,12 @@ export const ComputerUseLeftClickDragAction = /*#__PURE__*/Schema.Struct({
 /**
  * Press the left mouse button down (without releasing).
  *
- * Used for fine-grained click control.
+ * **When to use**
+ *
+ * Use this for fine-grained click control.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseLeftMouseDownAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("left_mouse_down"),
@@ -384,10 +394,12 @@ export const ComputerUseLeftMouseDownAction = /*#__PURE__*/Schema.Struct({
 /**
  * Release the left mouse button.
  *
- * Used for fine-grained click control.
+ * **When to use**
+ *
+ * Use this for fine-grained click control.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseLeftMouseUpAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("left_mouse_up"),
@@ -400,8 +412,8 @@ export const ComputerUseLeftMouseUpAction = /*#__PURE__*/Schema.Struct({
 /**
  * Perform a middle click.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseMiddleClickAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("middle_click"),
@@ -414,8 +426,8 @@ export const ComputerUseMiddleClickAction = /*#__PURE__*/Schema.Struct({
 /**
  * Perform a right click.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseRightClickAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("right_click"),
@@ -428,8 +440,8 @@ export const ComputerUseRightClickAction = /*#__PURE__*/Schema.Struct({
 /**
  * Scroll a given amount in a specified direction.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseScrollAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("scroll"),
@@ -450,8 +462,8 @@ export const ComputerUseScrollAction = /*#__PURE__*/Schema.Struct({
 /**
  * Perform a triple click.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseTripleClickAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("triple_click"),
@@ -464,8 +476,8 @@ export const ComputerUseTripleClickAction = /*#__PURE__*/Schema.Struct({
 /**
  * Pause between performing actions.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseWaitAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("wait"),
@@ -481,10 +493,12 @@ const ComputerUse_20250124_Actions = /*#__PURE__*/Schema.Union([...ComputerUse_2
 /**
  * Zoom into a specific region of the screen at full resolution.
  *
+ * **Details**
+ *
  * Requires `enableZoom: true` in the tool definition.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUseZoomAction = /*#__PURE__*/Schema.Struct({
   action: /*#__PURE__*/Schema.Literal("zoom"),
@@ -501,12 +515,13 @@ const ComputerUse_20251124_Actions = /*#__PURE__*/Schema.Union([...ComputerUse_2
 /**
  * Computer use tool for Claude 3.5 Sonnet v2 (deprecated).
  *
- * Requires the "computer-use-2024-10-22" beta header.
+ * **Details**
  *
+ * Requires the "computer-use-2024-10-22" beta header.
  * Basic actions only: screenshot, left_click, type, key, mouse_move.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUse_20241022 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.computer_use_20241022",
@@ -520,14 +535,15 @@ export const ComputerUse_20241022 = /*#__PURE__*/Tool.providerDefined({
 /**
  * Computer use tool for Claude 4 models and Claude Sonnet 3.7.
  *
- * Requires the "computer-use-2025-01-24" beta header.
+ * **Details**
  *
+ * Requires the "computer-use-2025-01-24" beta header.
  * Includes basic actions plus enhanced actions: scroll, left_click_drag,
  * right_click, middle_click, double_click, triple_click, left_mouse_down,
  * left_mouse_up, hold_key, wait.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUse_20250124 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.computer_20250124",
@@ -541,13 +557,14 @@ export const ComputerUse_20250124 = /*#__PURE__*/Tool.providerDefined({
 /**
  * Computer use tool for Claude Opus 4.5 only.
  *
- * Requires the "computer-use-2025-11-24" beta header.
+ * **Details**
  *
+ * Requires the "computer-use-2025-11-24" beta header.
  * Includes all actions from computer_20250124 plus the zoom action for
  * detailed screen region inspection. Requires `enableZoom: true` in args.
  *
- * @since 1.0.0
  * @category Computer Use
+ * @since 4.0.0
  */
 export const ComputerUse_20251124 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.computer_20251124",
@@ -567,13 +584,14 @@ export const ComputerUse_20251124 = /*#__PURE__*/Tool.providerDefined({
 /**
  * A `[start, end]` line range for viewing file contents.
  *
- * Lines are 1-indexed. Use -1 for end to read to end of file.
+ * **Details**
  *
- * @example [1, 50]    // View lines 1-50
- * @example [100, -1]  // View from line 100 to end of file
+ * Lines are 1-indexed. Use -1 for end to read to the end of the file. For
+ * example, `[1, 50]` views lines 1-50 and `[100, -1]` views from line 100 to
+ * the end of the file.
  *
- * @since 1.0.0
  * @category Memory
+ * @since 4.0.0
  */
 export const ViewRange = /*#__PURE__*/Schema.Tuple([Schema.Number, Schema.Number]);
 // -----------------------------------------------------------------------------
@@ -582,8 +600,8 @@ export const ViewRange = /*#__PURE__*/Schema.Tuple([Schema.Number, Schema.Number
 /**
  * Creates a new file.
  *
- * @since 1.0.0
  * @category Memory
+ * @since 4.0.0
  */
 export const MemoryCreateCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("create"),
@@ -595,8 +613,8 @@ export const MemoryCreateCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Delete a file or directory.
  *
- * @since 1.0.0
  * @category Memory
+ * @since 4.0.0
  */
 export const MemoryDeleteCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("delete"),
@@ -608,8 +626,8 @@ export const MemoryDeleteCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Insert text at a specific line.
  *
- * @since 1.0.0
  * @category Memory
+ * @since 4.0.0
  */
 export const MemoryInsertCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("insert"),
@@ -629,8 +647,8 @@ export const MemoryInsertCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Rename or move a file or directory.
  *
- * @since 1.0.0
  * @category Memory
+ * @since 4.0.0
  */
 export const MemoryRenameCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("rename"),
@@ -646,8 +664,8 @@ export const MemoryRenameCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Replace text in a file.
  *
- * @since 1.0.0
  * @category Memory
+ * @since 4.0.0
  */
 export const MemoryStrReplaceCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("str_replace"),
@@ -667,8 +685,8 @@ export const MemoryStrReplaceCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Shows directory contents or file contents with optional line ranges.
  *
- * @since 1.0.0
  * @category Memory
+ * @since 4.0.0
  */
 export const MemoryViewCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("view"),
@@ -688,11 +706,13 @@ const Memory_20250818_Commands = /*#__PURE__*/Schema.Union([MemoryCreateCommand,
 /**
  * Memory tool for persistent file operations across conversations.
  *
+ * **Details**
+ *
  * Provides commands for creating, viewing, editing, renaming, and deleting
  * files within the model's memory space.
  *
- * @since 1.0.0
  * @category Memory
+ * @since 4.0.0
  */
 export const Memory_20250818 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.memory_20250818",
@@ -710,11 +730,13 @@ export const Memory_20250818 = /*#__PURE__*/Tool.providerDefined({
 /**
  * View the contents of a file or list directory contents.
  *
- * When used on a file: Returns the file contents, optionally limited to a line range.
- * When used on a directory: Lists all files and subdirectories.
+ * **Details**
+ *
+ * When used on a file, returns the file contents, optionally limited to a line
+ * range. When used on a directory, lists all files and subdirectories.
  *
- * @since 1.0.0
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditorViewCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("view"),
@@ -731,10 +753,12 @@ export const TextEditorViewCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Create a new file with specified content.
  *
- * Will fail if the file already exists. Parent directories must exist.
+ * **Gotchas**
+ *
+ * Fails if the file already exists. Parent directories must exist.
  *
- * @since 1.0.0
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditorCreateCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("create"),
@@ -750,11 +774,13 @@ export const TextEditorCreateCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Replace a specific string in a file with a new string.
  *
+ * **Gotchas**
+ *
  * The `old_str` must match exactly (including whitespace and indentation)
  * and must be unique in the file.
  *
- * @since 1.0.0
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditorStrReplaceCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("str_replace"),
@@ -774,10 +800,12 @@ export const TextEditorStrReplaceCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Insert text at a specific line number in a file.
  *
+ * **Details**
+ *
  * Inserts the new text AFTER the specified line number.
  *
- * @since 1.0.0
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditorInsertCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("insert"),
@@ -797,13 +825,17 @@ export const TextEditorInsertCommand = /*#__PURE__*/Schema.Struct({
 /**
  * Undo the last edit made to a file.
  *
+ * **Details**
+ *
  * Reverts the most recent str_replace, insert, or create operation on the file.
  *
- * NOTE: This command is available in text_editor_20241022 and text_editor_20250124,
- * but NOT in text_editor_20250728 (Claude 4 models).
+ * **Gotchas**
+ *
+ * This command is available in text_editor_20241022 and text_editor_20250124,
+ * but not in text_editor_20250728 (Claude 4 models).
  *
- * @since 1.0.0
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditorUndoEditCommand = /*#__PURE__*/Schema.Struct({
   command: /*#__PURE__*/Schema.Literal("undo_edit"),
@@ -830,10 +862,12 @@ const TextEditor_StrReplaceBasedEdit_Args = /*#__PURE__*/Schema.Struct({
 /**
  * Text editor tool for Claude 3.5 Sonnet (deprecated).
  *
+ * **Details**
+ *
  * Requires the "computer-use-2024-10-22" beta header.
  *
- * @since 1.0.0
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditor_20241022 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.text_editor_20241022",
@@ -846,8 +880,12 @@ export const TextEditor_20241022 = /*#__PURE__*/Tool.providerDefined({
 /**
  * Text editor tool for Claude Sonnet 3.7 (deprecated model).
  *
- * @since 1.0.0
+ * **Details**
+ *
+ * Requires the "computer-use-2025-01-24" beta header.
+ *
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditor_20250124 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.text_editor_20250124",
@@ -858,12 +896,18 @@ export const TextEditor_20250124 = /*#__PURE__*/Tool.providerDefined({
   success: Schema.String
 });
 /**
- * Text editor tool for Claude 4 models.
+ * Text editor tool for Claude 4 models using Anthropic's `str_replace_based_edit_tool`.
  *
- * NOTE: This version does NOT support the `undo_edit` command.
+ * **Details**
+ *
+ * Requires the "computer-use-2025-01-24" beta header.
+ *
+ * **Gotchas**
+ *
+ * This version does not support the `undo_edit` command.
  *
- * @since 1.0.0
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditor_20250429 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.text_editor_20250429",
@@ -877,10 +921,12 @@ export const TextEditor_20250429 = /*#__PURE__*/Tool.providerDefined({
 /**
  * Text editor tool for Claude 4 models.
  *
- * NOTE: This version does NOT support the `undo_edit` command.
+ * **Gotchas**
+ *
+ * This version does not support the `undo_edit` command.
  *
- * @since 1.0.0
  * @category Text Editor
+ * @since 4.0.0
  */
 export const TextEditor_20250728 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.text_editor_20250728",
@@ -900,11 +946,13 @@ export const TextEditor_20250728 = /*#__PURE__*/Tool.providerDefined({
 /**
  * User location for localizing search results.
  *
+ * **When to use**
+ *
  * Providing location helps return more relevant results for location-dependent
  * queries like weather, local businesses, events, etc.
  *
- * @since 1.0.0
  * @category Web Search
+ * @since 4.0.0
  */
 export const WebSearchUserLocation = /*#__PURE__*/Schema.Struct({
   /**
@@ -934,8 +982,8 @@ export const WebSearchUserLocation = /*#__PURE__*/Schema.Struct({
 /**
  * Configuration arguments for the web search tool.
  *
- * @since 1.0.0
  * @category Web Search
+ * @since 4.0.0
  */
 export const WebSearch_20250305_Args = /*#__PURE__*/Schema.Struct({
   /**
@@ -965,8 +1013,8 @@ export const WebSearch_20250305_Args = /*#__PURE__*/Schema.Struct({
 /**
  * Input parameters for a web search.
  *
- * @since 1.0.0
  * @category Web Search
+ * @since 4.0.0
  */
 export const WebSearchParameters = /*#__PURE__*/Schema.Struct({
   /**
@@ -980,13 +1028,14 @@ export const WebSearchParameters = /*#__PURE__*/Schema.Struct({
 /**
  * Web search tool for Claude models.
  *
+ * **Details**
+ *
  * Enables Claude to search the web for real-time information. This is a
  * server-side tool executed by Anthropic's infrastructure.
- *
  * Generally available (no beta header required).
  *
- * @since 1.0.0
  * @category Web Search
+ * @since 4.0.0
  */
 export const WebSearch_20250305 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.web_search_20250305",
@@ -1006,8 +1055,8 @@ export const WebSearch_20250305 = /*#__PURE__*/Tool.providerDefined({
 /**
  * Citation configuration for web fetch.
  *
- * @since 1.0.0
  * @category Web Fetch
+ * @since 4.0.0
  */
 export const WebFetchCitationsConfig = /*#__PURE__*/Schema.Struct({
   /**
@@ -1021,8 +1070,8 @@ export const WebFetchCitationsConfig = /*#__PURE__*/Schema.Struct({
 /**
  * Configuration arguments for the web fetch tool.
  *
- * @since 1.0.0
  * @category Web Fetch
+ * @since 4.0.0
  */
 export const WebFetch_20250910_Args = /*#__PURE__*/Schema.Struct({
   /**
@@ -1056,8 +1105,8 @@ export const WebFetch_20250910_Args = /*#__PURE__*/Schema.Struct({
 /**
  * Input parameters for a web fetch.
  *
- * @since 1.0.0
  * @category Web Fetch
+ * @since 4.0.0
  */
 export const WebFetchParameters = /*#__PURE__*/Schema.Struct({
   /**
@@ -1072,13 +1121,14 @@ export const WebFetchParameters = /*#__PURE__*/Schema.Struct({
 /**
  * Web fetch tool for Claude models.
  *
+ * **Details**
+ *
  * Allows Claude to retrieve full content from web pages and PDF documents.
  * This is a server-side tool executed by Anthropic's infrastructure.
- *
  * Requires the "web-fetch-2025-09-10" beta header.
  *
- * @since 1.0.0
  * @category Web Fetch
+ * @since 4.0.0
  */
 export const WebFetch_20250910 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.web_fetch_20250910",
@@ -1098,11 +1148,13 @@ export const WebFetch_20250910 = /*#__PURE__*/Tool.providerDefined({
 /**
  * Input parameters for regex-based tool search.
  *
+ * **Details**
+ *
  * Claude constructs regex patterns using Python's `re.search()` syntax.
  * Maximum query length: 200 characters.
  *
- * @since 1.0.0
  * @category Tool Search
+ * @since 4.0.0
  */
 export const ToolSearchRegexParameters = /*#__PURE__*/Schema.Struct({
   /**
@@ -1113,8 +1165,8 @@ export const ToolSearchRegexParameters = /*#__PURE__*/Schema.Struct({
 /**
  * Input parameters for BM25/natural language tool search.
  *
- * @since 1.0.0
  * @category Tool Search
+ * @since 4.0.0
  */
 export const ToolSearchBM25Parameters = /*#__PURE__*/Schema.Struct({
   /**
@@ -1128,14 +1180,15 @@ export const ToolSearchBM25Parameters = /*#__PURE__*/Schema.Struct({
 /**
  * Regex-based tool search for Claude models.
  *
+ * **Details**
+ *
  * Claude constructs regex patterns using Python's `re.search()` syntax to
  * find tools. The regex is matched against tool names, descriptions,
  * argument names, and argument descriptions.
- *
  * Requires the "advanced-tool-use-2025-11-20" beta header.
  *
- * @since 1.0.0
  * @category Tool Search
+ * @since 4.0.0
  */
 export const ToolSearchRegex_20251119 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.tool_search_tool_regex_20251119",
@@ -1148,14 +1201,15 @@ export const ToolSearchRegex_20251119 = /*#__PURE__*/Tool.providerDefined({
 /**
  * BM25/natural language tool search for Claude models.
  *
+ * **Details**
+ *
  * Claude uses natural language queries to search for tools using the
  * BM25 algorithm. The search is performed against tool names, descriptions,
  * argument names, and argument descriptions.
- *
  * Requires the "advanced-tool-use-2025-11-20" beta header.
  *
- * @since 1.0.0
  * @category Tool Search
+ * @since 4.0.0
  */
 export const ToolSearchBM25_20251119 = /*#__PURE__*/Tool.providerDefined({
   id: "anthropic.tool_search_tool_bm25_20251119",