@anthropic-ai/sdk 0.118.0 → 0.120.0

package/src/lib/tools/BetaRunnableTool.ts

@@ -74,9 +74,16 @@ export type BetaRunnableTool<Input = any> = BetaClientRunnableToolType & {
   close?: () => Promisable<void>;
 };
 
-/** The name the model calls a tool by: `mcp_server_name` for MCP toolsets, `name` for everything else. */
+/**
+ * The name the model calls a tool by: `mcp_server_name` for MCP toolsets, `type` for nameless server
+ * toolsets (browser/computer), `name` for everything else.
+ */
 export function toolName(tool: BetaToolUnion | BetaRunnableTool): string {
-  return 'name' in tool ? tool.name : tool.mcp_server_name;
+  return (
+    'name' in tool ? tool.name
+    : 'mcp_server_name' in tool ? tool.mcp_server_name
+    : tool.type
+  );
 }
 
 /** Tool-result content for a thrown value: a {@link ToolError}'s own content, otherwise `Error: <message>`. */

package/src/lib/tools/BetaToolRunner.ts

@@ -492,7 +492,12 @@ async function generateToolResponse(
   const available = availableToolNames(params);
   const toolResults = await Promise.all(
     toolUseBlocks.map(async (toolUse) => {
-      const tool = params.tools.find((t) => ('name' in t ? t.name : t.mcp_server_name) === toolUse.name);
+      const tool = params.tools.find(
+        (t) =>
+          ('name' in t ? t.name
+          : 'mcp_server_name' in t ? t.mcp_server_name
+          : t.type) === toolUse.name,
+      );
       // A `tool_removal` is only a hint to the model, which may still emit a tool_use for a
       // withdrawn tool — treat those exactly like a tool that was never defined.
       if (!tool || !('run' in tool) || !available.has(toolUse.name)) {

package/src/resources/beta/agents/agents.ts

@@ -231,40 +231,28 @@ export interface BetaManagedAgentsAgentReference {
 /**
  * Configuration for a specific agent tool.
  */
-export interface BetaManagedAgentsAgentToolConfig {
-  enabled: boolean;
-
-  /**
-   * Built-in agent tool identifier.
-   */
-  name: 'bash' | 'edit' | 'read' | 'write' | 'glob' | 'grep' | 'web_fetch' | 'web_search';
-
-  /**
-   * Permission policy for tool execution.
-   */
-  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
-}
+export type BetaManagedAgentsAgentToolConfig =
+  | BetaManagedAgentsBashToolConfig
+  | BetaManagedAgentsEditToolConfig
+  | BetaManagedAgentsReadToolConfig
+  | BetaManagedAgentsWriteToolConfig
+  | BetaManagedAgentsGlobToolConfig
+  | BetaManagedAgentsGrepToolConfig
+  | BetaManagedAgentsWebFetchToolConfig
+  | BetaManagedAgentsWebSearchToolConfig;
 
 /**
  * Configuration override for a specific tool within a toolset.
  */
-export interface BetaManagedAgentsAgentToolConfigParams {
-  /**
-   * Built-in agent tool identifier.
-   */
-  name: 'bash' | 'edit' | 'read' | 'write' | 'glob' | 'grep' | 'web_fetch' | 'web_search';
-
-  /**
-   * Whether this tool is enabled and available to Claude. Overrides the
-   * default_config setting.
-   */
-  enabled?: boolean | null;
-
-  /**
-   * Permission policy for tool execution.
-   */
-  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
-}
+export type BetaManagedAgentsAgentToolConfigParams =
+  | BetaManagedAgentsBashToolConfigParams
+  | BetaManagedAgentsEditToolConfigParams
+  | BetaManagedAgentsReadToolConfigParams
+  | BetaManagedAgentsWriteToolConfigParams
+  | BetaManagedAgentsGlobToolConfigParams
+  | BetaManagedAgentsGrepToolConfigParams
+  | BetaManagedAgentsWebFetchToolConfigParams
+  | BetaManagedAgentsWebSearchToolConfigParams;
 
 /**
  * Resolved default configuration for agent tools.
@@ -484,6 +472,45 @@ export interface BetaManagedAgentsAnthropicSkillParams {
   version?: string | null;
 }
 
+/**
+ * Configuration for the bash tool.
+ */
+export interface BetaManagedAgentsBashToolConfig {
+  enabled: boolean;
+
+  name: 'bash';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
+
+  type: 'bash';
+}
+
+/**
+ * Configuration override for the bash tool.
+ */
+export interface BetaManagedAgentsBashToolConfigParams {
+  /**
+   * Must be "bash".
+   */
+  name: 'bash';
+
+  /**
+   * Whether this tool is enabled and available to Claude. Overrides the
+   * default_config setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
+
+  type?: 'bash';
+}
+
 /**
  * A resolved user-created custom skill.
  */
@@ -568,6 +595,45 @@ export interface BetaManagedAgentsCustomToolParams {
   type: 'custom';
 }
 
+/**
+ * Configuration for the edit tool.
+ */
+export interface BetaManagedAgentsEditToolConfig {
+  enabled: boolean;
+
+  name: 'edit';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
+
+  type: 'edit';
+}
+
+/**
+ * Configuration override for the edit tool.
+ */
+export interface BetaManagedAgentsEditToolConfigParams {
+  /**
+   * Must be "edit".
+   */
+  name: 'edit';
+
+  /**
+   * Whether this tool is enabled and available to Claude. Overrides the
+   * default_config setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
+
+  type?: 'edit';
+}
+
 /**
  * High effort. Favors reasoning depth.
  */
@@ -603,6 +669,84 @@ export interface BetaManagedAgentsEffortXhigh {
   type: 'xhigh';
 }
 
+/**
+ * Configuration for the glob tool.
+ */
+export interface BetaManagedAgentsGlobToolConfig {
+  enabled: boolean;
+
+  name: 'glob';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
+
+  type: 'glob';
+}
+
+/**
+ * Configuration override for the glob tool.
+ */
+export interface BetaManagedAgentsGlobToolConfigParams {
+  /**
+   * Must be "glob".
+   */
+  name: 'glob';
+
+  /**
+   * Whether this tool is enabled and available to Claude. Overrides the
+   * default_config setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
+
+  type?: 'glob';
+}
+
+/**
+ * Configuration for the grep tool.
+ */
+export interface BetaManagedAgentsGrepToolConfig {
+  enabled: boolean;
+
+  name: 'grep';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
+
+  type: 'grep';
+}
+
+/**
+ * Configuration override for the grep tool.
+ */
+export interface BetaManagedAgentsGrepToolConfigParams {
+  /**
+   * Must be "grep".
+   */
+  name: 'grep';
+
+  /**
+   * Whether this tool is enabled and available to Claude. Overrides the
+   * default_config setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
+
+  type?: 'grep';
+}
+
 /**
  * URL-based MCP server connection as returned in API responses.
  */
@@ -854,6 +998,45 @@ export interface BetaManagedAgentsMultiagentSelfParams {
   type: 'self';
 }
 
+/**
+ * Configuration for the read tool.
+ */
+export interface BetaManagedAgentsReadToolConfig {
+  enabled: boolean;
+
+  name: 'read';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
+
+  type: 'read';
+}
+
+/**
+ * Configuration override for the read tool.
+ */
+export interface BetaManagedAgentsReadToolConfigParams {
+  /**
+   * Must be "read".
+   */
+  name: 'read';
+
+  /**
+   * Whether this tool is enabled and available to Claude. Overrides the
+   * default_config setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
+
+  type?: 'read';
+}
+
 /**
  * Resolved `agent` definition for a single `session_thread`. Snapshot of the agent
  * at thread creation time. The multiagent roster is not repeated here; read it
@@ -911,6 +1094,211 @@ export interface BetaManagedAgentsURLMCPServerParams {
   url: string;
 }
 
+/**
+ * Approximate user location for search result localization.
+ */
+export interface BetaManagedAgentsUserLocation {
+  /**
+   * Location precision. Only "approximate" is supported.
+   */
+  type: 'approximate';
+
+  /**
+   * City name.
+   */
+  city?: string | null;
+
+  /**
+   * Two-letter ISO 3166-1 country code, uppercase.
+   */
+  country?: string | null;
+
+  /**
+   * Region or state name.
+   */
+  region?: string | null;
+
+  /**
+   * IANA timezone identifier, e.g. "America/Los_Angeles".
+   */
+  timezone?: string | null;
+}
+
+/**
+ * Configuration for the web_fetch tool.
+ */
+export interface BetaManagedAgentsWebFetchToolConfig {
+  enabled: boolean;
+
+  name: 'web_fetch';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
+
+  type: 'web_fetch';
+
+  allowed_domains?: Array<string>;
+
+  blocked_domains?: Array<string>;
+
+  max_content_tokens?: number | null;
+}
+
+/**
+ * Configuration override for the web_fetch tool.
+ */
+export interface BetaManagedAgentsWebFetchToolConfigParams {
+  /**
+   * Must be "web_fetch".
+   */
+  name: 'web_fetch';
+
+  /**
+   * Only fetch URLs whose host is one of these domains or a subdomain of one. Each
+   * entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At
+   * most 64 entries; an empty list is rejected (omit the field instead). Cannot be
+   * combined with blocked_domains.
+   */
+  allowed_domains?: Array<string>;
+
+  /**
+   * Never fetch URLs whose host is one of these domains or a subdomain of one. Each
+   * entry is a plain hostname like "ads.example.com" (no scheme, port, or path). At
+   * most 64 entries; an empty list is rejected (omit the field instead). Cannot be
+   * combined with allowed_domains.
+   */
+  blocked_domains?: Array<string>;
+
+  /**
+   * Whether this tool is enabled and available to Claude. Overrides the
+   * default_config setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Maximum number of tokens of fetched text content to include in context per call.
+   * Does not apply to binary content such as PDFs.
+   */
+  max_content_tokens?: number | null;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
+
+  type?: 'web_fetch';
+}
+
+/**
+ * Configuration for the web_search tool.
+ */
+export interface BetaManagedAgentsWebSearchToolConfig {
+  enabled: boolean;
+
+  name: 'web_search';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
+
+  type: 'web_search';
+
+  allowed_domains?: Array<string>;
+
+  blocked_domains?: Array<string>;
+
+  /**
+   * Approximate user location for search result localization.
+   */
+  user_location?: BetaManagedAgentsUserLocation | null;
+}
+
+/**
+ * Configuration override for the web_search tool.
+ */
+export interface BetaManagedAgentsWebSearchToolConfigParams {
+  /**
+   * Must be "web_search".
+   */
+  name: 'web_search';
+
+  /**
+   * Only return search results whose host is one of these domains or a subdomain of
+   * one. Each entry is a plain hostname like "docs.example.com" (no scheme or port;
+   * an optional path suffix is accepted). At most 64 entries; an empty list is
+   * rejected (omit the field instead). Cannot be combined with blocked_domains.
+   */
+  allowed_domains?: Array<string>;
+
+  /**
+   * Never return search results whose host is one of these domains or a subdomain of
+   * one. Each entry is a plain hostname like "ads.example.com" (no scheme or port;
+   * an optional path suffix is accepted). At most 64 entries; an empty list is
+   * rejected (omit the field instead). Cannot be combined with allowed_domains.
+   */
+  blocked_domains?: Array<string>;
+
+  /**
+   * Whether this tool is enabled and available to Claude. Overrides the
+   * default_config setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
+
+  type?: 'web_search';
+
+  /**
+   * Approximate user location for search result localization.
+   */
+  user_location?: BetaManagedAgentsUserLocation | null;
+}
+
+/**
+ * Configuration for the write tool.
+ */
+export interface BetaManagedAgentsWriteToolConfig {
+  enabled: boolean;
+
+  name: 'write';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy;
+
+  type: 'write';
+}
+
+/**
+ * Configuration override for the write tool.
+ */
+export interface BetaManagedAgentsWriteToolConfigParams {
+  /**
+   * Must be "write".
+   */
+  name: 'write';
+
+  /**
+   * Whether this tool is enabled and available to Claude. Overrides the
+   * default_config setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | null;
+
+  type?: 'write';
+}
+
 export interface AgentCreateParams {
   /**
    * Body param: Model identifier. Accepts the
@@ -1121,16 +1509,24 @@ export declare namespace Agents {
     type BetaManagedAgentsAlwaysAskPolicy as BetaManagedAgentsAlwaysAskPolicy,
     type BetaManagedAgentsAnthropicSkill as BetaManagedAgentsAnthropicSkill,
     type BetaManagedAgentsAnthropicSkillParams as BetaManagedAgentsAnthropicSkillParams,
+    type BetaManagedAgentsBashToolConfig as BetaManagedAgentsBashToolConfig,
+    type BetaManagedAgentsBashToolConfigParams as BetaManagedAgentsBashToolConfigParams,
     type BetaManagedAgentsCustomSkill as BetaManagedAgentsCustomSkill,
     type BetaManagedAgentsCustomSkillParams as BetaManagedAgentsCustomSkillParams,
     type BetaManagedAgentsCustomTool as BetaManagedAgentsCustomTool,
     type BetaManagedAgentsCustomToolInputSchema as BetaManagedAgentsCustomToolInputSchema,
     type BetaManagedAgentsCustomToolParams as BetaManagedAgentsCustomToolParams,
+    type BetaManagedAgentsEditToolConfig as BetaManagedAgentsEditToolConfig,
+    type BetaManagedAgentsEditToolConfigParams as BetaManagedAgentsEditToolConfigParams,
     type BetaManagedAgentsEffortHigh as BetaManagedAgentsEffortHigh,
     type BetaManagedAgentsEffortLow as BetaManagedAgentsEffortLow,
     type BetaManagedAgentsEffortMax as BetaManagedAgentsEffortMax,
     type BetaManagedAgentsEffortMedium as BetaManagedAgentsEffortMedium,
     type BetaManagedAgentsEffortXhigh as BetaManagedAgentsEffortXhigh,
+    type BetaManagedAgentsGlobToolConfig as BetaManagedAgentsGlobToolConfig,
+    type BetaManagedAgentsGlobToolConfigParams as BetaManagedAgentsGlobToolConfigParams,
+    type BetaManagedAgentsGrepToolConfig as BetaManagedAgentsGrepToolConfig,
+    type BetaManagedAgentsGrepToolConfigParams as BetaManagedAgentsGrepToolConfigParams,
     type BetaManagedAgentsMCPServerURLDefinition as BetaManagedAgentsMCPServerURLDefinition,
     type BetaManagedAgentsMCPToolConfig as BetaManagedAgentsMCPToolConfig,
     type BetaManagedAgentsMCPToolConfigParams as BetaManagedAgentsMCPToolConfigParams,
@@ -1144,9 +1540,18 @@ export declare namespace Agents {
     type BetaManagedAgentsMultiagentCoordinator as BetaManagedAgentsMultiagentCoordinator,
     type BetaManagedAgentsMultiagentCoordinatorParams as BetaManagedAgentsMultiagentCoordinatorParams,
     type BetaManagedAgentsMultiagentSelfParams as BetaManagedAgentsMultiagentSelfParams,
+    type BetaManagedAgentsReadToolConfig as BetaManagedAgentsReadToolConfig,
+    type BetaManagedAgentsReadToolConfigParams as BetaManagedAgentsReadToolConfigParams,
     type BetaManagedAgentsSessionThreadAgent as BetaManagedAgentsSessionThreadAgent,
     type BetaManagedAgentsSkillParams as BetaManagedAgentsSkillParams,
     type BetaManagedAgentsURLMCPServerParams as BetaManagedAgentsURLMCPServerParams,
+    type BetaManagedAgentsUserLocation as BetaManagedAgentsUserLocation,
+    type BetaManagedAgentsWebFetchToolConfig as BetaManagedAgentsWebFetchToolConfig,
+    type BetaManagedAgentsWebFetchToolConfigParams as BetaManagedAgentsWebFetchToolConfigParams,
+    type BetaManagedAgentsWebSearchToolConfig as BetaManagedAgentsWebSearchToolConfig,
+    type BetaManagedAgentsWebSearchToolConfigParams as BetaManagedAgentsWebSearchToolConfigParams,
+    type BetaManagedAgentsWriteToolConfig as BetaManagedAgentsWriteToolConfig,
+    type BetaManagedAgentsWriteToolConfigParams as BetaManagedAgentsWriteToolConfigParams,
     type BetaManagedAgentsAgentsPageCursor as BetaManagedAgentsAgentsPageCursor,
     type AgentCreateParams as AgentCreateParams,
     type AgentRetrieveParams as AgentRetrieveParams,

package/src/resources/beta/agents/index.ts

@@ -21,16 +21,24 @@ export {
   type BetaManagedAgentsAlwaysAskPolicy,
   type BetaManagedAgentsAnthropicSkill,
   type BetaManagedAgentsAnthropicSkillParams,
+  type BetaManagedAgentsBashToolConfig,
+  type BetaManagedAgentsBashToolConfigParams,
   type BetaManagedAgentsCustomSkill,
   type BetaManagedAgentsCustomSkillParams,
   type BetaManagedAgentsCustomTool,
   type BetaManagedAgentsCustomToolInputSchema,
   type BetaManagedAgentsCustomToolParams,
+  type BetaManagedAgentsEditToolConfig,
+  type BetaManagedAgentsEditToolConfigParams,
   type BetaManagedAgentsEffortHigh,
   type BetaManagedAgentsEffortLow,
   type BetaManagedAgentsEffortMax,
   type BetaManagedAgentsEffortMedium,
   type BetaManagedAgentsEffortXhigh,
+  type BetaManagedAgentsGlobToolConfig,
+  type BetaManagedAgentsGlobToolConfigParams,
+  type BetaManagedAgentsGrepToolConfig,
+  type BetaManagedAgentsGrepToolConfigParams,
   type BetaManagedAgentsMCPServerURLDefinition,
   type BetaManagedAgentsMCPToolConfig,
   type BetaManagedAgentsMCPToolConfigParams,
@@ -44,9 +52,18 @@ export {
   type BetaManagedAgentsMultiagentCoordinator,
   type BetaManagedAgentsMultiagentCoordinatorParams,
   type BetaManagedAgentsMultiagentSelfParams,
+  type BetaManagedAgentsReadToolConfig,
+  type BetaManagedAgentsReadToolConfigParams,
   type BetaManagedAgentsSessionThreadAgent,
   type BetaManagedAgentsSkillParams,
   type BetaManagedAgentsURLMCPServerParams,
+  type BetaManagedAgentsUserLocation,
+  type BetaManagedAgentsWebFetchToolConfig,
+  type BetaManagedAgentsWebFetchToolConfigParams,
+  type BetaManagedAgentsWebSearchToolConfig,
+  type BetaManagedAgentsWebSearchToolConfigParams,
+  type BetaManagedAgentsWriteToolConfig,
+  type BetaManagedAgentsWriteToolConfigParams,
   type AgentCreateParams,
   type AgentRetrieveParams,
   type AgentUpdateParams,