@effect/ai-anthropic 4.0.0-beta.71 → 4.0.0-beta.73

package/src/AnthropicTool.ts

@@ -100,7 +100,7 @@ export type AnthropicTool =
 // =============================================================================
 
 /**
- * Anthropic Bash tool (2024-10-22 version).
+ * Defines the Anthropic Bash tool (2024-10-22 version).
  *
  * **When to use**
  *
@@ -130,7 +130,7 @@ export const Bash_20241022 = Tool.providerDefined({
 })
 
 /**
- * Anthropic Bash tool (2025-01-24 version).
+ * Defines the Anthropic Bash tool (2025-01-24 version).
  *
  * **When to use**
  *
@@ -438,7 +438,7 @@ export type CodeExecution_20250825_Parameters = typeof CodeExecution_20250825_Pa
 // -----------------------------------------------------------------------------
 
 /**
- * Anthropic Code Execution tool (2025-05-22 version).
+ * Defines the Anthropic Code Execution tool (2025-05-22 version).
  *
  * **When to use**
  *
@@ -466,7 +466,7 @@ export const CodeExecution_20250522 = Tool.providerDefined({
 })
 
 /**
- * Anthropic Code Execution tool (2025-08-25 version).
+ * Defines the Anthropic Code Execution tool (2025-08-25 version).
  *
  * **When to use**
  *
@@ -523,14 +523,14 @@ export const CodeExecution_20250825 = Tool.providerDefined({
  *
  * This schema validates tuple shape only and does not check display bounds.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const Coordinate = Schema.Tuple([Schema.Number, Schema.Number])
 /**
  * An `[x, y]` screen coordinate in pixels.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type Coordinate = typeof Coordinate.Type
@@ -547,54 +547,54 @@ export type Coordinate = typeof Coordinate.Type
  * This schema validates four numbers only and does not check coordinate ordering
  * or display bounds.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const Region = Schema.Tuple([Schema.Number, Schema.Number, Schema.Number, Schema.Number])
 /**
  * An `[x1, y1, x2, y2]` screen region in pixels, from top-left to bottom-right.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type Region = typeof Region.Type
 
 /**
- * Scroll direction literal: `"up"`, `"down"`, `"left"`, or `"right"`.
+ * Schema for scroll direction literals: `"up"`, `"down"`, `"left"`, or `"right"`.
  *
  * @see {@link ComputerUseScrollAction} for the action payload that consumes this schema
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ScrollDirection = Schema.Literals(["up", "down", "left", "right"])
 /**
  * Direction used by computer-use scroll actions: `"up"`, `"down"`, `"left"`, or `"right"`.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ScrollDirection = typeof ScrollDirection.Type
 
 /**
- * Modifier key literal.
+ * Schema for modifier key literals.
  *
  * **Details**
  *
  * Allowed values are `"alt"`, `"ctrl"`, `"meta"`, and `"shift"`.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ModifierKey = Schema.Literals(["alt", "ctrl", "meta", "shift"])
 /**
- * Modifier key literal.
+ * Modifier key literals.
  *
  * **Details**
  *
  * Allowed values are `"alt"`, `"ctrl"`, `"meta"`, and `"shift"`.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ModifierKey = typeof ModifierKey.Type
@@ -643,7 +643,7 @@ const ComputerUse_20251124_Args = Schema.Struct({
  * @see {@link TypeAction} for entering ordinary text strings
  * @see {@link ComputerUseHoldKeyAction} for holding a key for a duration
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseKeyAction = Schema.Struct({
@@ -666,7 +666,7 @@ export const ComputerUseKeyAction = Schema.Struct({
  * `text` is typed as `string`; the paired schema does not validate
  * provider-specific key names or key combinations.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseKeyAction = typeof ComputerUseKeyAction.Type
@@ -694,7 +694,7 @@ export type ComputerUseKeyAction = typeof ComputerUseKeyAction.Type
  * @see {@link ComputerUseDoubleClickAction} for performing a double click
  * @see {@link ComputerUseMouseMoveAction} for moving the mouse without clicking
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseLeftClickAction = Schema.Struct({
@@ -708,7 +708,7 @@ export const ComputerUseLeftClickAction = Schema.Struct({
 /**
  * Computer-use action payload for performing a left click, optionally at a specific coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseLeftClickAction = typeof ComputerUseLeftClickAction.Type
@@ -733,7 +733,7 @@ export type ComputerUseLeftClickAction = typeof ComputerUseLeftClickAction.Type
  * does not validate that the point falls within the configured display
  * dimensions.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseMouseMoveAction = Schema.Struct({
@@ -746,7 +746,7 @@ export const ComputerUseMouseMoveAction = Schema.Struct({
 /**
  * Computer-use action payload for moving the mouse cursor to a specific coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseMouseMoveAction = typeof ComputerUseMouseMoveAction.Type
@@ -766,7 +766,7 @@ export type ComputerUseMouseMoveAction = typeof ComputerUseMouseMoveAction.Type
  *
  * @see {@link ComputerUseZoomAction} for requesting a zoomed-in screenshot of a specific screen region with the 2025-11-24 computer-use tool
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseScreenshotAction = Schema.Struct({
@@ -775,7 +775,7 @@ export const ComputerUseScreenshotAction = Schema.Struct({
 /**
  * Computer-use action payload for capturing the current display.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseScreenshotAction = typeof ComputerUseScreenshotAction.Type
@@ -795,7 +795,7 @@ export type ComputerUseScreenshotAction = typeof ComputerUseScreenshotAction.Typ
  *
  * @see {@link ComputerUseKeyAction} for key presses and keyboard shortcuts
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const TypeAction = Schema.Struct({
@@ -813,7 +813,7 @@ export const TypeAction = Schema.Struct({
  * The payload uses `action: "type"` and a `text` string containing the text to
  * enter.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type TypeAction = typeof TypeAction.Type
@@ -852,7 +852,7 @@ const ComputerUse_20241022_Actions = Schema.Union([
  *
  * @see {@link ComputerUseLeftClickAction} for performing a single left click
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseDoubleClickAction = Schema.Struct({
@@ -866,13 +866,13 @@ export const ComputerUseDoubleClickAction = Schema.Struct({
 /**
  * Computer-use action payload for performing a double click, optionally at a specific coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseDoubleClickAction = typeof ComputerUseDoubleClickAction.Type
 
 /**
- * Hold a key for a specified duration during computer-use execution.
+ * Keeps a key pressed for a specified duration during computer-use execution.
  *
  * **When to use**
  *
@@ -893,7 +893,7 @@ export type ComputerUseDoubleClickAction = typeof ComputerUseDoubleClickAction.T
  * @see {@link ComputerUseKeyAction} for pressing a key or key combination without holding it
  * @see {@link ComputerUseWaitAction} for pausing between actions without holding a key
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseHoldKeyAction = Schema.Struct({
@@ -921,7 +921,7 @@ export const ComputerUseHoldKeyAction = Schema.Struct({
  *
  * @see {@link ComputerUseKeyAction} for a single key press or key combination without a hold duration
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseHoldKeyAction = typeof ComputerUseHoldKeyAction.Type
@@ -948,7 +948,7 @@ export type ComputerUseHoldKeyAction = typeof ComputerUseHoldKeyAction.Type
  * @see {@link ComputerUseLeftMouseDownAction} for starting a manual drag sequence
  * @see {@link ComputerUseLeftMouseUpAction} for ending a manual drag sequence
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseLeftClickDragAction = Schema.Struct({
@@ -965,19 +965,20 @@ export const ComputerUseLeftClickDragAction = Schema.Struct({
 /**
  * Computer-use action payload for dragging from a start coordinate to an end coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseLeftClickDragAction = typeof ComputerUseLeftClickDragAction.Type
 
 /**
- * Press the left mouse button down (without releasing).
+ * Starts a left mouse button press without releasing it.
  *
  * **When to use**
  *
- * Use when you use this for fine-grained click control.
+ * Use when constructing a manual click or drag sequence that should press and
+ * hold the left mouse button before a later release.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseLeftMouseDownAction = Schema.Struct({
@@ -991,19 +992,20 @@ export const ComputerUseLeftMouseDownAction = Schema.Struct({
 /**
  * Computer-use action payload for pressing and holding the left mouse button, optionally at a specific coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseLeftMouseDownAction = typeof ComputerUseLeftMouseDownAction.Type
 
 /**
- * Release the left mouse button.
+ * Releases the left mouse button.
  *
  * **When to use**
  *
- * Use when you use this for fine-grained click control.
+ * Use when constructing a manual click or drag sequence that should release the
+ * left mouse button after it was previously held down.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseLeftMouseUpAction = Schema.Struct({
@@ -1017,7 +1019,7 @@ export const ComputerUseLeftMouseUpAction = Schema.Struct({
 /**
  * Computer-use action payload for releasing the left mouse button, optionally at a specific coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseLeftMouseUpAction = typeof ComputerUseLeftMouseUpAction.Type
@@ -1044,7 +1046,7 @@ export type ComputerUseLeftMouseUpAction = typeof ComputerUseLeftMouseUpAction.T
  * @see {@link ComputerUseLeftClickAction} for primary-button clicks
  * @see {@link ComputerUseRightClickAction} for secondary-button clicks
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseMiddleClickAction = Schema.Struct({
@@ -1058,7 +1060,7 @@ export const ComputerUseMiddleClickAction = Schema.Struct({
 /**
  * Computer-use action payload for performing a middle click, optionally at a specific coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseMiddleClickAction = typeof ComputerUseMiddleClickAction.Type
@@ -1081,7 +1083,7 @@ export type ComputerUseMiddleClickAction = typeof ComputerUseMiddleClickAction.T
  * @see {@link ComputerUseLeftClickAction} for the corresponding left-click action
  * @see {@link ComputerUseMiddleClickAction} for the corresponding middle-click action
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseRightClickAction = Schema.Struct({
@@ -1095,7 +1097,7 @@ export const ComputerUseRightClickAction = Schema.Struct({
 /**
  * Computer-use action payload for performing a right click, optionally at a specific coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseRightClickAction = typeof ComputerUseRightClickAction.Type
@@ -1120,7 +1122,7 @@ export type ComputerUseRightClickAction = typeof ComputerUseRightClickAction.Typ
  * @see {@link ComputerUse_20250124} for the tool version that accepts this action
  * @see {@link ScrollDirection} for the accepted direction literals
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseScrollAction = Schema.Struct({
@@ -1142,7 +1144,7 @@ export const ComputerUseScrollAction = Schema.Struct({
 /**
  * Computer-use action payload for scrolling by a specified amount in a specified direction, optionally from a coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseScrollAction = typeof ComputerUseScrollAction.Type
@@ -1169,7 +1171,7 @@ export type ComputerUseScrollAction = typeof ComputerUseScrollAction.Type
  * @see {@link ComputerUseDoubleClickAction} for the two-click variant
  * @see {@link ComputerUseLeftClickAction} for a single left click
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseTripleClickAction = Schema.Struct({
@@ -1183,7 +1185,7 @@ export const ComputerUseTripleClickAction = Schema.Struct({
 /**
  * Computer-use action payload for performing a triple click, optionally at a specific coordinate.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseTripleClickAction = typeof ComputerUseTripleClickAction.Type
@@ -1209,7 +1211,7 @@ export type ComputerUseTripleClickAction = typeof ComputerUseTripleClickAction.T
  * @see {@link ComputerUseHoldKeyAction} for another duration-based computer-use action
  * @see {@link ComputerUse_20250124} for the tool version that accepts this action
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseWaitAction = Schema.Struct({
@@ -1222,7 +1224,7 @@ export const ComputerUseWaitAction = Schema.Struct({
 /**
  * Computer-use action payload for pausing for a specified duration.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseWaitAction = typeof ComputerUseWaitAction.Type
@@ -1246,7 +1248,7 @@ const ComputerUse_20250124_Actions = Schema.Union([
 // -----------------------------------------------------------------------------
 
 /**
- * Zoom into a specific region of the screen at full resolution.
+ * Zooms into a specific region of the screen at full resolution.
  *
  * **Details**
  *
@@ -1260,7 +1262,7 @@ const ComputerUse_20250124_Actions = Schema.Union([
  * @see {@link ComputerUse_20251124} for the tool version that accepts this action
  * @see {@link ComputerUseScreenshotAction} for capturing the full screen instead
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUseZoomAction = Schema.Struct({
@@ -1280,7 +1282,7 @@ export const ComputerUseZoomAction = Schema.Struct({
  * `region` is only a four-number tuple and does not validate corner ordering or
  * display bounds.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export type ComputerUseZoomAction = typeof ComputerUseZoomAction.Type
@@ -1295,14 +1297,14 @@ const ComputerUse_20251124_Actions = Schema.Union([
 // -----------------------------------------------------------------------------
 
 /**
- * Computer use tool for Claude 3.5 Sonnet v2 (deprecated).
+ * Defines the deprecated computer-use tool for Claude 3.5 Sonnet v2.
  *
  * **Details**
  *
  * Requires the "computer-use-2024-10-22" beta header.
  * Basic actions only: screenshot, left_click, type, key, mouse_move.
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUse_20241022 = Tool.providerDefined({
@@ -1316,7 +1318,7 @@ export const ComputerUse_20241022 = Tool.providerDefined({
 })
 
 /**
- * Computer use tool for Claude 4 models and Claude Sonnet 3.7.
+ * Defines the computer-use tool for Claude 4 models and Claude Sonnet 3.7.
  *
  * **When to use**
  *
@@ -1333,7 +1335,7 @@ export const ComputerUse_20241022 = Tool.providerDefined({
  * @see {@link ComputerUse_20241022} for the older basic action set
  * @see {@link ComputerUse_20251124} for the newer zoom-capable version
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUse_20250124 = Tool.providerDefined({
@@ -1347,7 +1349,7 @@ export const ComputerUse_20250124 = Tool.providerDefined({
 })
 
 /**
- * Computer use tool for Claude Opus 4.5 only.
+ * Defines the computer-use tool for Claude Opus 4.5 only.
  *
  * **When to use**
  *
@@ -1367,7 +1369,7 @@ export const ComputerUse_20250124 = Tool.providerDefined({
  * @see {@link ComputerUse_20250124} for the previous action set without zoom
  * @see {@link ComputerUseZoomAction} for the zoom action payload
  *
- * @category Computer Use
+ * @category computer use
  * @since 4.0.0
  */
 export const ComputerUse_20251124 = Tool.providerDefined({
@@ -1389,7 +1391,7 @@ export const ComputerUse_20251124 = Tool.providerDefined({
 // -----------------------------------------------------------------------------
 
 /**
- * A `[start, end]` line range for viewing file contents.
+ * Defines a `[start, end]` line range for viewing file contents.
  *
  * **When to use**
  *
@@ -1405,7 +1407,7 @@ export const ComputerUse_20251124 = Tool.providerDefined({
  * @see {@link MemoryViewCommand} for memory view payloads that use this range
  * @see {@link TextEditorViewCommand} for text editor view payloads that use this range
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export const ViewRange = Schema.Tuple([Schema.Number, Schema.Number])
@@ -1416,7 +1418,7 @@ export const ViewRange = Schema.Tuple([Schema.Number, Schema.Number])
  *
  * Use when typing `view_range` for memory or text editor view commands.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export type ViewRange = typeof ViewRange.Type
@@ -1432,7 +1434,7 @@ export type ViewRange = typeof ViewRange.Type
  *
  * The payload contains `command: "create"` and a `path` string.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export const MemoryCreateCommand = Schema.Struct({
@@ -1445,7 +1447,7 @@ export const MemoryCreateCommand = Schema.Struct({
 /**
  * Memory tool command payload for creating a new file at a path.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export type MemoryCreateCommand = typeof MemoryCreateCommand.Type
@@ -1453,7 +1455,7 @@ export type MemoryCreateCommand = typeof MemoryCreateCommand.Type
 /**
  * Schema for a memory command that deletes a file or directory.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export const MemoryDeleteCommand = Schema.Struct({
@@ -1466,7 +1468,7 @@ export const MemoryDeleteCommand = Schema.Struct({
 /**
  * Memory tool command payload for deleting a file or directory at a path.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export type MemoryDeleteCommand = typeof MemoryDeleteCommand.Type
@@ -1486,7 +1488,7 @@ export type MemoryDeleteCommand = typeof MemoryDeleteCommand.Type
  * @see {@link Memory_20250818} for the provider-defined tool that consumes this command
  * @see {@link MemoryStrReplaceCommand} for replacing existing text instead
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export const MemoryInsertCommand = Schema.Struct({
@@ -1507,7 +1509,7 @@ export const MemoryInsertCommand = Schema.Struct({
 /**
  * Memory tool command payload for inserting text at a specific line in a file.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export type MemoryInsertCommand = typeof MemoryInsertCommand.Type
@@ -1520,7 +1522,7 @@ export type MemoryInsertCommand = typeof MemoryInsertCommand.Type
  * The payload uses `command: "rename"` and requires `old_path` as the current
  * path plus `new_path` as the new destination path.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export const MemoryRenameCommand = Schema.Struct({
@@ -1537,7 +1539,7 @@ export const MemoryRenameCommand = Schema.Struct({
 /**
  * Memory tool command payload for renaming or moving a file or directory.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export type MemoryRenameCommand = typeof MemoryRenameCommand.Type
@@ -1557,7 +1559,7 @@ export type MemoryRenameCommand = typeof MemoryRenameCommand.Type
  *
  * @see {@link Memory_20250818} for the provider-defined tool that consumes this command
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export const MemoryStrReplaceCommand = Schema.Struct({
@@ -1578,7 +1580,7 @@ export const MemoryStrReplaceCommand = Schema.Struct({
 /**
  * Memory tool command payload for replacing text in a file.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export type MemoryStrReplaceCommand = typeof MemoryStrReplaceCommand.Type
@@ -1591,7 +1593,7 @@ export type MemoryStrReplaceCommand = typeof MemoryStrReplaceCommand.Type
  * When used on a file, returns file contents optionally limited by `view_range`.
  * When used on a directory, lists contents.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export const MemoryViewCommand = Schema.Struct({
@@ -1608,7 +1610,7 @@ export const MemoryViewCommand = Schema.Struct({
 /**
  * Memory tool command payload for viewing a file or directory, optionally with a file line range.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export type MemoryViewCommand = typeof MemoryViewCommand.Type
@@ -1627,14 +1629,14 @@ const Memory_20250818_Commands = Schema.Union([
 // -----------------------------------------------------------------------------
 
 /**
- * Memory tool for persistent file operations across conversations.
+ * Defines the 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.
  *
- * @category Memory
+ * @category memory
  * @since 4.0.0
  */
 export const Memory_20250818 = Tool.providerDefined({
@@ -1654,7 +1656,7 @@ export const Memory_20250818 = Tool.providerDefined({
 // -----------------------------------------------------------------------------
 
 /**
- * View the contents of a file or list directory contents.
+ * Reads the contents of a file or lists directory contents.
  *
  * **When to use**
  *
@@ -1670,7 +1672,7 @@ export const Memory_20250818 = Tool.providerDefined({
  *
  * @see {@link CodeExecutionTextEditorView} for the code-execution variant without `view_range`
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditorViewCommand = Schema.Struct({
@@ -1693,7 +1695,7 @@ export const TextEditorViewCommand = Schema.Struct({
  * `view_range` is a 1-indexed `[start, end]` tuple where `-1` means through
  * the end of the file.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export type TextEditorViewCommand = typeof TextEditorViewCommand.Type
@@ -1715,7 +1717,7 @@ export type TextEditorViewCommand = typeof TextEditorViewCommand.Type
  *
  * Fails if the file already exists. Parent directories must exist.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditorCreateCommand = Schema.Struct({
@@ -1736,13 +1738,13 @@ export const TextEditorCreateCommand = Schema.Struct({
  *
  * The command fails if the file already exists or if parent directories are missing.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export type TextEditorCreateCommand = typeof TextEditorCreateCommand.Type
 
 /**
- * Replace a specific string in a file with a new string.
+ * Replaces a specific string in a file with a new string.
  *
  * **When to use**
  *
@@ -1762,7 +1764,7 @@ export type TextEditorCreateCommand = typeof TextEditorCreateCommand.Type
  * @see {@link TextEditorViewCommand} for reading contents before choosing `old_str`
  * @see {@link CodeExecutionTextEditorStrReplace} for the code-execution variant
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditorStrReplaceCommand = Schema.Struct({
@@ -1788,20 +1790,20 @@ export const TextEditorStrReplaceCommand = Schema.Struct({
  * The `old_str` must match exactly, including whitespace and indentation, and
  * must be unique in the file.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export type TextEditorStrReplaceCommand = typeof TextEditorStrReplaceCommand.Type
 
 /**
- * Insert text at a specific line number in a file.
+ * Inserts text at a specific line number in a file.
  *
  * **Details**
  *
  * Inserts the new text after the specified line number. Use `0` to insert at
  * the beginning of the file; other values are 1-indexed.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditorInsertCommand = Schema.Struct({
@@ -1822,13 +1824,13 @@ export const TextEditorInsertCommand = Schema.Struct({
 /**
  * Text editor command payload for inserting text after a specific line number in a file.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export type TextEditorInsertCommand = typeof TextEditorInsertCommand.Type
 
 /**
- * Undo the last edit made to a file.
+ * Undoes the last edit made to a file.
  *
  * **Details**
  *
@@ -1841,7 +1843,7 @@ export type TextEditorInsertCommand = typeof TextEditorInsertCommand.Type
  * `text_editor_20250124`, but not in `text_editor_20250429` or
  * `text_editor_20250728`.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditorUndoEditCommand = Schema.Struct({
@@ -1859,7 +1861,7 @@ export const TextEditorUndoEditCommand = Schema.Struct({
  * Available for `text_editor_20241022` and `text_editor_20250124`, but not for
  * `text_editor_20250429` or `text_editor_20250728`.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export type TextEditorUndoEditCommand = typeof TextEditorUndoEditCommand.Type
@@ -1896,7 +1898,7 @@ const TextEditor_StrReplaceBasedEdit_Args = Schema.Struct({
 // -----------------------------------------------------------------------------
 
 /**
- * Text editor tool for Claude 3.5 Sonnet (deprecated).
+ * Defines the deprecated text editor tool for Claude 3.5 Sonnet.
  *
  * **When to use**
  *
@@ -1911,7 +1913,7 @@ const TextEditor_StrReplaceBasedEdit_Args = Schema.Struct({
  * @see {@link TextEditor_20250124} for the newer `str_replace_editor` version
  * @see {@link TextEditor_20250728} for the Claude 4 `str_replace_based_edit_tool` line
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditor_20241022 = Tool.providerDefined({
@@ -1924,7 +1926,7 @@ export const TextEditor_20241022 = Tool.providerDefined({
 })
 
 /**
- * Text editor tool for Claude Sonnet 3.7 (deprecated model).
+ * Defines the text editor tool for deprecated Claude Sonnet 3.7.
  *
  * **When to use**
  *
@@ -1939,7 +1941,7 @@ export const TextEditor_20241022 = Tool.providerDefined({
  * @see {@link TextEditor_20241022} for the older `str_replace_editor` version
  * @see {@link TextEditor_20250429} for the Claude 4 `str_replace_based_edit_tool` line
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditor_20250124 = Tool.providerDefined({
@@ -1952,7 +1954,7 @@ export const TextEditor_20250124 = Tool.providerDefined({
 })
 
 /**
- * Text editor tool for Claude 4 models using Anthropic's `str_replace_based_edit_tool`.
+ * Defines the text editor tool for Claude 4 models using Anthropic's `str_replace_based_edit_tool`.
  *
  * **When to use**
  *
@@ -1970,7 +1972,7 @@ export const TextEditor_20250124 = Tool.providerDefined({
  * @see {@link TextEditor_20250124} for the previous `str_replace_editor` version
  * @see {@link TextEditor_20250728} for the later Claude 4 text editor version
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditor_20250429 = Tool.providerDefined({
@@ -1984,7 +1986,7 @@ export const TextEditor_20250429 = Tool.providerDefined({
 })
 
 /**
- * Text editor tool for Claude 4 models.
+ * Defines the text editor tool for Claude 4 models.
  *
  * **Details**
  *
@@ -1995,7 +1997,7 @@ export const TextEditor_20250429 = Tool.providerDefined({
  *
  * This version does not support the `undo_edit` command.
  *
- * @category Text Editor
+ * @category text editor
  * @since 4.0.0
  */
 export const TextEditor_20250728 = Tool.providerDefined({
@@ -2017,7 +2019,7 @@ export const TextEditor_20250728 = Tool.providerDefined({
 // -----------------------------------------------------------------------------
 
 /**
- * User location for localizing search results.
+ * Describes user location for localizing search results.
  *
  * **When to use**
  *
@@ -2063,7 +2065,7 @@ export const WebSearchUserLocation = Schema.Struct({
 // -----------------------------------------------------------------------------
 
 /**
- * Configuration arguments for the web search tool.
+ * Defines configuration arguments for the web search tool.
  *
  * **When to use**
  *
@@ -2161,7 +2163,7 @@ export type WebSearchParameters = typeof WebSearchParameters.Type
 // -----------------------------------------------------------------------------
 
 /**
- * Web search tool for Claude models.
+ * Defines the web search tool for Claude models.
  *
  * **When to use**
  *
@@ -2197,7 +2199,7 @@ export const WebSearch_20250305 = Tool.providerDefined({
 // -----------------------------------------------------------------------------
 
 /**
- * Citation configuration for web fetch.
+ * Defines citation configuration for web fetch.
  *
  * **When to use**
  *
@@ -2239,7 +2241,7 @@ export type WebFetchCitationsConfig = typeof WebFetchCitationsConfig.Type
 // -----------------------------------------------------------------------------
 
 /**
- * Configuration arguments for the web fetch tool.
+ * Defines configuration arguments for the web fetch tool.
  *
  * **When to use**
  *
@@ -2358,7 +2360,7 @@ export type WebFetchParameters = typeof WebFetchParameters.Type
 // -----------------------------------------------------------------------------
 
 /**
- * Web fetch tool for Claude models.
+ * Defines the web fetch tool for Claude models.
  *
  * **When to use**
  *
@@ -2394,14 +2396,14 @@ export const WebFetch_20250910 = Tool.providerDefined({
 // -----------------------------------------------------------------------------
 
 /**
- * Input parameters for regex-based tool search.
+ * Schema for regex-based tool search input parameters.
  *
  * **Details**
  *
  * Claude constructs regex patterns using Python's `re.search()` syntax.
  * Maximum query length: 200 characters.
  *
- * @category Tool Search
+ * @category tool search
  * @since 4.0.0
  */
 export const ToolSearchRegexParameters = Schema.Struct({
@@ -2418,13 +2420,13 @@ export const ToolSearchRegexParameters = Schema.Struct({
  * Claude constructs regex patterns using Python's `re.search()` syntax.
  * Maximum query length: 200 characters.
  *
- * @category Tool Search
+ * @category tool search
  * @since 4.0.0
  */
 export type ToolSearchRegexParameters = typeof ToolSearchRegexParameters.Type
 
 /**
- * Input parameters for BM25/natural language tool search.
+ * Defines input parameters for BM25/natural language tool search.
  *
  * **When to use**
  *
@@ -2438,7 +2440,7 @@ export type ToolSearchRegexParameters = typeof ToolSearchRegexParameters.Type
  *
  * @see {@link ToolSearchBM25_20251119} for the provider-defined tool that consumes these parameters
  *
- * @category Tool Search
+ * @category tool search
  * @since 4.0.0
  */
 export const ToolSearchBM25Parameters = Schema.Struct({
@@ -2450,7 +2452,7 @@ export const ToolSearchBM25Parameters = Schema.Struct({
 /**
  * Type of the parameters Claude supplies when invoking BM25 natural-language Anthropic tool search.
  *
- * @category Tool Search
+ * @category tool search
  * @since 4.0.0
  */
 export type ToolSearchBM25Parameters = typeof ToolSearchBM25Parameters.Type
@@ -2460,7 +2462,7 @@ export type ToolSearchBM25Parameters = typeof ToolSearchBM25Parameters.Type
 // -----------------------------------------------------------------------------
 
 /**
- * Regex-based tool search for Claude models.
+ * Defines regex-based tool search for Claude models.
  *
  * **Details**
  *
@@ -2469,7 +2471,7 @@ export type ToolSearchBM25Parameters = typeof ToolSearchBM25Parameters.Type
  * argument names, and argument descriptions.
  * Requires the "advanced-tool-use-2025-11-20" beta header.
  *
- * @category Tool Search
+ * @category tool search
  * @since 4.0.0
  */
 export const ToolSearchRegex_20251119 = Tool.providerDefined({
@@ -2482,7 +2484,7 @@ export const ToolSearchRegex_20251119 = Tool.providerDefined({
 })
 
 /**
- * BM25/natural language tool search for Claude models.
+ * Defines BM25/natural language tool search for Claude models.
  *
  * **When to use**
  *
@@ -2498,7 +2500,7 @@ export const ToolSearchRegex_20251119 = Tool.providerDefined({
  *
  * @see {@link ToolSearchRegex_20251119} for the regex-pattern alternative
  *
- * @category Tool Search
+ * @category tool search
  * @since 4.0.0
  */
 export const ToolSearchBM25_20251119 = Tool.providerDefined({