@verevoir/review 0.3.1 → 0.3.2

package/node_modules/@anthropic-ai/sdk/src/resources/beta/agents/agents.ts

@@ -0,0 +1,2344 @@
+import { APIResource } from '../../../core/resource';
+import * as BetaAPI from '../beta';
+import * as VersionsAPI from './versions';
+import { VersionListParams, Versions } from './versions';
+import * as SessionsAPI from '../sessions/sessions';
+import { APIPromise } from '../../../core/api-promise';
+import { PageCursor, type PageCursorParams, PagePromise } from '../../../core/pagination';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { startApiCallSpan } from '../../../internal/tracing';
+import { path } from '../../../internal/utils/path';
+
+export class Agents extends APIResource {
+  versions: VersionsAPI.Versions = new VersionsAPI.Versions(this._client);
+
+  /**
+   * Create Agent
+   *
+   * @example
+   * ```ts
+   * const betaManagedAgentsAgent =
+   *   await client.beta.agents.create({
+   *     model: 'claude-opus-5-5',
+   *     name: 'My First Agent',
+   *   });
+   * ```
+   */
+  create(params: AgentCreateParams, options?: RequestOptions): APIPromise<BetaManagedAgentsAgent> {
+    const { betas, workspace_id, ...body } = params;
+    return this._client.post('/v1/agents?beta=true', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
+        options?.headers,
+      ]),
+      __span: startApiCallSpan(this._client, 'anthropic.agents.create', options, {
+        route: '/v1/agents',
+        createdIDAttribute: 'gen_ai.agent.id',
+      }),
+    });
+  }
+
+  /**
+   * Get Agent
+   *
+   * @example
+   * ```ts
+   * const betaManagedAgentsAgent =
+   *   await client.beta.agents.retrieve(
+   *     'agent_011CZkYpogX7uDKUyvBTophP',
+   *   );
+   * ```
+   */
+  retrieve(
+    agentID: string,
+    params: AgentRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaManagedAgentsAgent> {
+    const { betas, workspace_id, ...query } = params ?? {};
+    return this._client.get(path`/v1/agents/${agentID}?beta=true`, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
+        options?.headers,
+      ]),
+      __span: startApiCallSpan(this._client, 'anthropic.agents.retrieve', options, {
+        route: '/v1/agents/{agent_id}',
+        queryParams: ['version'],
+        attributes: { 'gen_ai.agent.id': agentID },
+      }),
+    });
+  }
+
+  /**
+   * Update Agent
+   *
+   * @example
+   * ```ts
+   * const betaManagedAgentsAgent =
+   *   await client.beta.agents.update(
+   *     'agent_011CZkYpogX7uDKUyvBTophP',
+   *     { description: 'updated' },
+   *   );
+   * ```
+   */
+  update(
+    agentID: string,
+    params: AgentUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<BetaManagedAgentsAgent> {
+    const { betas, workspace_id, ...body } = params;
+    return this._client.post(path`/v1/agents/${agentID}?beta=true`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
+        options?.headers,
+      ]),
+      __span: startApiCallSpan(this._client, 'anthropic.agents.update', options, {
+        route: '/v1/agents/{agent_id}',
+        attributes: { 'gen_ai.agent.id': agentID },
+      }),
+    });
+  }
+
+  /**
+   * List Agents
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const betaManagedAgentsAgent of client.beta.agents.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: AgentListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BetaManagedAgentsAgentsPageCursor, BetaManagedAgentsAgent> {
+    const { betas, workspace_id, ...query } = params ?? {};
+    return this._client.getAPIList('/v1/agents?beta=true', PageCursor<BetaManagedAgentsAgent>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
+        options?.headers,
+      ]),
+      __span: startApiCallSpan(this._client, 'anthropic.agents.list', options, {
+        route: '/v1/agents',
+        queryParams: ['created_at[gte]', 'created_at[lte]', 'include_archived', 'limit', 'page'],
+      }),
+    });
+  }
+
+  /**
+   * Archive Agent
+   *
+   * @example
+   * ```ts
+   * const betaManagedAgentsAgent =
+   *   await client.beta.agents.archive(
+   *     'agent_011CZkYpogX7uDKUyvBTophP',
+   *   );
+   * ```
+   */
+  archive(
+    agentID: string,
+    params: AgentArchiveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaManagedAgentsAgent> {
+    const { betas, workspace_id } = params ?? {};
+    return this._client.post(path`/v1/agents/${agentID}/archive?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
+        options?.headers,
+      ]),
+      __span: startApiCallSpan(this._client, 'anthropic.agents.archive', options, {
+        route: '/v1/agents/{agent_id}/archive',
+        attributes: { 'gen_ai.agent.id': agentID },
+      }),
+    });
+  }
+}
+
+export type BetaManagedAgentsAgentsPageCursor = PageCursor<BetaManagedAgentsAgent>;
+
+/**
+ * Platform advisor roster entry: a model the session's primary thread may consult
+ * mid-turn.
+ */
+export interface BetaManagedAgentsAdvisor {
+  /**
+   * The advisor model id.
+   */
+  model: string;
+
+  type: 'advisor';
+}
+
+/**
+ * A Managed Agents `agent`.
+ */
+export interface BetaManagedAgentsAgent {
+  id: string;
+
+  /**
+   * When the agent was archived. Null if not archived.
+   */
+  archived_at: string | null;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  created_at: string;
+
+  description: string | null;
+
+  /**
+   * Execution principal for runs of this agent. Always present;
+   * `{"type": "service_account"}` when runs carry no customer-named principal.
+   */
+  execution_identity: BetaManagedAgentsExecutionIdentity;
+
+  mcp_servers: Array<BetaManagedAgentsMCPServerURLDefinition>;
+
+  metadata: { [key: string]: string };
+
+  /**
+   * Model identifier and configuration.
+   */
+  model: BetaManagedAgentsModelConfig;
+
+  /**
+   * Multiagent orchestration configuration. Null when the agent is single-threaded.
+   */
+  multiagent: SessionsAPI.BetaManagedAgentsMultiagent | null;
+
+  name: string;
+
+  skills: Array<BetaManagedAgentsAnthropicSkill | BetaManagedAgentsCustomSkill>;
+
+  system: string | null;
+
+  tools: Array<
+    BetaManagedAgentsAgentToolset20260401 | BetaManagedAgentsMCPToolset | BetaManagedAgentsCustomTool
+  >;
+
+  type: 'agent';
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  updated_at: string;
+
+  /**
+   * The agent's current version. Starts at 1 and increments when the agent is
+   * modified.
+   */
+  version: number;
+}
+
+/**
+ * A resolved agent reference with a concrete version.
+ */
+export interface BetaManagedAgentsAgentReference {
+  id: string;
+
+  type: 'agent';
+
+  version: number;
+}
+
+/**
+ * Configuration for a specific agent tool.
+ */
+export type BetaManagedAgentsAgentToolConfig =
+  | BetaManagedAgentsBashToolConfig
+  | BetaManagedAgentsEditToolConfig
+  | BetaManagedAgentsReadToolConfig
+  | BetaManagedAgentsWriteToolConfig
+  | BetaManagedAgentsGlobToolConfig
+  | BetaManagedAgentsGrepToolConfig
+  | BetaManagedAgentsWebFetchToolConfig
+  | BetaManagedAgentsWebSearchToolConfig;
+
+/**
+ * Configuration override for a specific tool within a toolset.
+ */
+export type BetaManagedAgentsAgentToolConfigParams =
+  | BetaManagedAgentsBashToolConfigParams
+  | BetaManagedAgentsEditToolConfigParams
+  | BetaManagedAgentsReadToolConfigParams
+  | BetaManagedAgentsWriteToolConfigParams
+  | BetaManagedAgentsGlobToolConfigParams
+  | BetaManagedAgentsGrepToolConfigParams
+  | BetaManagedAgentsWebFetchToolConfigParams
+  | BetaManagedAgentsWebSearchToolConfigParams;
+
+/**
+ * Resolved default configuration for agent tools.
+ */
+export interface BetaManagedAgentsAgentToolsetDefaultConfig {
+  enabled: boolean;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+}
+
+/**
+ * Default configuration for all tools in a toolset.
+ */
+export interface BetaManagedAgentsAgentToolsetDefaultConfigParams {
+  /**
+   * Whether tools are enabled and available to Claude by default. Defaults to true
+   * if not specified.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Default permission policy for tools. Controls whether tool calls are
+   * auto-approved or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+}
+
+export interface BetaManagedAgentsAgentToolset20260401 {
+  configs: Array<BetaManagedAgentsAgentToolConfig>;
+
+  /**
+   * Resolved default configuration for agent tools.
+   */
+  default_config: BetaManagedAgentsAgentToolsetDefaultConfig;
+
+  type: 'agent_toolset_20260401';
+}
+
+/**
+ * Input payload for the `bash` tool of the `agent_toolset_20260401` toolset. All
+ * fields are optional; a normal invocation supplies `command`, while
+ * `restart=true` (with no `command`) reboots the runner-side bash session.
+ */
+export interface BetaManagedAgentsAgentToolset20260401BashInput {
+  /**
+   * Shell command to execute. Omit only when `restart` is true.
+   */
+  command?: string;
+
+  /**
+   * When true, restart the persistent bash session instead of running a command.
+   * Subsequent calls without `restart` will run against the fresh session.
+   */
+  restart?: boolean;
+
+  /**
+   * Per-call timeout in milliseconds. Defaults to the runner-wide tool timeout when
+   * omitted or zero.
+   */
+  timeout_ms?: number;
+}
+
+/**
+ * Input payload for the `edit` tool. Performs a string replacement in the named
+ * file; by default `old_string` must occur exactly once.
+ */
+export interface BetaManagedAgentsAgentToolset20260401EditInput {
+  /**
+   * Path of the file to edit.
+   */
+  file_path: string;
+
+  /**
+   * Replacement text.
+   */
+  new_string: string;
+
+  /**
+   * Substring to find and replace.
+   */
+  old_string: string;
+
+  /**
+   * When true, replace every occurrence of `old_string` instead of requiring a
+   * unique match.
+   */
+  replace_all?: boolean;
+}
+
+/**
+ * Input payload for the `glob` tool. Returns paths matching a doublestar glob
+ * pattern, newest first.
+ */
+export interface BetaManagedAgentsAgentToolset20260401GlobInput {
+  /**
+   * Doublestar glob pattern (e.g. `** /*.go`). Absolute patterns are only permitted
+   * when the runner is configured to allow them.
+   */
+  pattern: string;
+
+  /**
+   * Optional directory root to search under. Defaults to the runner's working
+   * directory.
+   */
+  path?: string;
+}
+
+/**
+ * Input payload for the `grep` tool. Searches file contents for a regular
+ * expression, returning matching lines.
+ */
+export interface BetaManagedAgentsAgentToolset20260401GrepInput {
+  /**
+   * Regular expression to search for.
+   */
+  pattern: string;
+
+  /**
+   * Optional directory root to search under. Defaults to the runner's working
+   * directory.
+   */
+  path?: string;
+}
+
+/**
+ * Configuration for built-in agent tools. Use this to enable or disable groups of
+ * tools available to the agent.
+ */
+export interface BetaManagedAgentsAgentToolset20260401Params {
+  type: 'agent_toolset_20260401';
+
+  /**
+   * Per-tool configuration overrides.
+   */
+  configs?: Array<BetaManagedAgentsAgentToolConfigParams>;
+
+  /**
+   * Default configuration applied to all tools in this set.
+   */
+  default_config?: BetaManagedAgentsAgentToolsetDefaultConfigParams | null;
+}
+
+/**
+ * Input payload for the `read` tool. Reads file contents relative to the runner's
+ * working directory (or absolute when the runner permits).
+ */
+export interface BetaManagedAgentsAgentToolset20260401ReadInput {
+  /**
+   * Path of the file to read.
+   */
+  file_path: string;
+
+  /**
+   * Optional `[start_line, end_line]` 1-indexed inclusive range. When omitted the
+   * entire file is returned. `end_line` of 0 or negative means "to end of file".
+   */
+  view_range?: Array<number>;
+}
+
+/**
+ * Input payload for the `write` tool. Writes (overwriting) the entire file
+ * contents.
+ */
+export interface BetaManagedAgentsAgentToolset20260401WriteInput {
+  /**
+   * Full file contents to write.
+   */
+  content: string;
+
+  /**
+   * Path of the file to write.
+   */
+  file_path: string;
+}
+
+/**
+ * Tool calls are automatically approved without user confirmation.
+ */
+export interface BetaManagedAgentsAlwaysAllowPolicy {
+  type: 'always_allow';
+}
+
+/**
+ * Tool calls require user confirmation before execution.
+ */
+export interface BetaManagedAgentsAlwaysAskPolicy {
+  type: 'always_ask';
+}
+
+/**
+ * A resolved Anthropic-managed skill.
+ */
+export interface BetaManagedAgentsAnthropicSkill {
+  skill_id: string;
+
+  type: 'anthropic';
+
+  version: string;
+}
+
+/**
+ * An Anthropic-managed skill.
+ */
+export interface BetaManagedAgentsAnthropicSkillParams {
+  /**
+   * Identifier of the Anthropic skill (e.g., "xlsx").
+   */
+  skill_id: string;
+
+  type: 'anthropic';
+
+  /**
+   * Version to pin. Defaults to latest if omitted.
+   */
+  version?: string | null;
+}
+
+/**
+ * The server decides each tool call individually: it judges, from the tool, its
+ * input, and the session content so far, whether the call is safe to execute or
+ * high-risk, and evaluates it to allow when judged safe and to deny when judged
+ * high-risk. A call the server cannot reach a judgement on evaluates to ask.
+ */
+export interface BetaManagedAgentsAutoPolicy {
+  type: 'auto';
+}
+
+/**
+ * An AWS IAM role principal as returned in API responses.
+ */
+export interface BetaManagedAgentsAWSRoleExecutionIdentity {
+  /**
+   * The IAM role's ARN.
+   */
+  role_arn: string;
+
+  type: 'aws_role';
+}
+
+/**
+ * An AWS IAM role principal.
+ */
+export interface BetaManagedAgentsAWSRoleExecutionIdentityParams {
+  /**
+   * The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner".
+   * Maximum 2048 characters.
+   */
+  role_arn: string;
+
+  type: 'aws_role';
+}
+
+/**
+ * Configuration for the bash tool.
+ */
+export interface BetaManagedAgentsBashToolConfig {
+  enabled: boolean;
+
+  name: 'bash';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+
+  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 this tool. Controls whether tool calls are auto-approved
+   * or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+
+  type?: 'bash';
+}
+
+/**
+ * A resolved user-created custom skill.
+ */
+export interface BetaManagedAgentsCustomSkill {
+  skill_id: string;
+
+  type: 'custom';
+
+  version: string;
+}
+
+/**
+ * A user-created custom skill.
+ */
+export interface BetaManagedAgentsCustomSkillParams {
+  /**
+   * Tagged ID of the custom skill (e.g., "skill_01XJ5...").
+   */
+  skill_id: string;
+
+  type: 'custom';
+
+  /**
+   * Version to pin. Defaults to latest if omitted.
+   */
+  version?: string | null;
+}
+
+/**
+ * A custom tool as returned in API responses.
+ */
+export interface BetaManagedAgentsCustomTool {
+  description: string;
+
+  /**
+   * JSON Schema for custom tool input parameters.
+   */
+  input_schema: BetaManagedAgentsCustomToolInputSchema;
+
+  name: string;
+
+  type: 'custom';
+}
+
+/**
+ * JSON Schema for custom tool input parameters.
+ */
+export interface BetaManagedAgentsCustomToolInputSchema {
+  type: 'object';
+
+  properties?: { [key: string]: unknown } | null;
+
+  required?: Array<string> | null;
+
+  [k: string]: unknown;
+}
+
+/**
+ * A custom tool that is executed by the API client rather than the agent. When the
+ * agent calls this tool, an `agent.custom_tool_use` event is emitted and the
+ * session goes idle, waiting for the client to provide the result via a
+ * `user.custom_tool_result` event.
+ */
+export interface BetaManagedAgentsCustomToolParams {
+  /**
+   * Description of what the tool does, shown to the agent to help it decide when to
+   * use the tool.
+   */
+  description: string;
+
+  /**
+   * JSON Schema defining the expected input parameters for the tool.
+   */
+  input_schema: BetaManagedAgentsCustomToolInputSchema;
+
+  /**
+   * Unique name for the tool. 1-128 characters; letters, digits, underscores, and
+   * hyphens.
+   */
+  name: string;
+
+  type: 'custom';
+}
+
+/**
+ * Configuration for the edit tool.
+ */
+export interface BetaManagedAgentsEditToolConfig {
+  enabled: boolean;
+
+  name: 'edit';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+
+  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 this tool. Controls whether tool calls are auto-approved
+   * or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+
+  type?: 'edit';
+}
+
+/**
+ * High effort. Favors reasoning depth.
+ */
+export interface BetaManagedAgentsEffortHigh {
+  type: 'high';
+}
+
+/**
+ * Low effort. Favors latency over reasoning depth.
+ */
+export interface BetaManagedAgentsEffortLow {
+  type: 'low';
+}
+
+/**
+ * Maximum effort. Favors reasoning depth over latency.
+ */
+export interface BetaManagedAgentsEffortMax {
+  type: 'max';
+}
+
+/**
+ * Medium effort. Balances latency and reasoning depth.
+ */
+export interface BetaManagedAgentsEffortMedium {
+  type: 'medium';
+}
+
+/**
+ * Extra-high effort. Not all models accept this level.
+ */
+export interface BetaManagedAgentsEffortXhigh {
+  type: 'xhigh';
+}
+
+/**
+ * Execution principal for runs of this agent as returned in API responses.
+ */
+export type BetaManagedAgentsExecutionIdentity =
+  | BetaManagedAgentsAWSRoleExecutionIdentity
+  | BetaManagedAgentsServiceAccountExecutionIdentity;
+
+/**
+ * Execution principal for runs of this agent: `service_account` (the default) or
+ * `aws_role`.
+ */
+export type BetaManagedAgentsExecutionIdentityParams =
+  | BetaManagedAgentsAWSRoleExecutionIdentityParams
+  | BetaManagedAgentsServiceAccountExecutionIdentityParams;
+
+/**
+ * Configuration for the glob tool.
+ */
+export interface BetaManagedAgentsGlobToolConfig {
+  enabled: boolean;
+
+  name: 'glob';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+
+  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 this tool. Controls whether tool calls are auto-approved
+   * or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+
+  type?: 'glob';
+}
+
+/**
+ * Configuration for the grep tool.
+ */
+export interface BetaManagedAgentsGrepToolConfig {
+  enabled: boolean;
+
+  name: 'grep';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+
+  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 this tool. Controls whether tool calls are auto-approved
+   * or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+
+  type?: 'grep';
+}
+
+/**
+ * URL-based MCP server connection as returned in API responses.
+ */
+export interface BetaManagedAgentsMCPServerURLDefinition {
+  name: string;
+
+  type: 'url';
+
+  url: string;
+}
+
+/**
+ * Resolved configuration for a specific MCP tool.
+ */
+export interface BetaManagedAgentsMCPToolConfig {
+  enabled: boolean;
+
+  name: string;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+}
+
+/**
+ * Configuration override for a specific MCP tool.
+ */
+export interface BetaManagedAgentsMCPToolConfigParams {
+  /**
+   * Name of the MCP tool to configure. 1-128 characters.
+   */
+  name: string;
+
+  /**
+   * Whether this tool is enabled. Overrides the `default_config` setting.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Permission policy for this tool. Overrides the `default_config` setting.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+}
+
+export interface BetaManagedAgentsMCPToolset {
+  configs: Array<BetaManagedAgentsMCPToolConfig>;
+
+  /**
+   * Resolved default configuration for all tools from an MCP server.
+   */
+  default_config: BetaManagedAgentsMCPToolsetDefaultConfig;
+
+  mcp_server_name: string;
+
+  type: 'mcp_toolset';
+}
+
+/**
+ * Resolved default configuration for all tools from an MCP server.
+ */
+export interface BetaManagedAgentsMCPToolsetDefaultConfig {
+  enabled: boolean;
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+}
+
+/**
+ * Default configuration for all tools from an MCP server.
+ */
+export interface BetaManagedAgentsMCPToolsetDefaultConfigParams {
+  /**
+   * Whether tools are enabled by default. Defaults to true if not specified.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Default permission policy for tools from this server.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+}
+
+/**
+ * Configuration for tools from an MCP server defined in `mcp_servers`.
+ */
+export interface BetaManagedAgentsMCPToolsetParams {
+  /**
+   * Name of the MCP server. Must match a server name from the mcp_servers array.
+   * 1-255 characters.
+   */
+  mcp_server_name: string;
+
+  type: 'mcp_toolset';
+
+  /**
+   * Per-tool configuration overrides.
+   */
+  configs?: Array<BetaManagedAgentsMCPToolConfigParams>;
+
+  /**
+   * Default configuration for all tools from this server.
+   */
+  default_config?: BetaManagedAgentsMCPToolsetDefaultConfigParams | null;
+}
+
+/**
+ * The model that will power your agent.
+ *
+ * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+ * details and options.
+ */
+export type BetaManagedAgentsModel =
+  | 'claude-haiku-5-5'
+  | 'claude-sonnet-5-5'
+  | 'claude-opus-5-5'
+  | 'claude-fable-5-1'
+  | 'claude-sonnet-5'
+  | 'claude-fable-5'
+  | 'claude-opus-5'
+  | 'claude-opus-4-8'
+  | 'claude-opus-4-7'
+  | 'claude-opus-4-6'
+  | 'claude-sonnet-4-6'
+  | 'claude-haiku-4-5'
+  | 'claude-haiku-4-5-20251001'
+  | 'claude-opus-4-5'
+  | 'claude-opus-4-5-20251101'
+  | 'claude-sonnet-4-5'
+  | 'claude-sonnet-4-5-20250929'
+  | (string & {});
+
+/**
+ * Model identifier and configuration.
+ */
+export interface BetaManagedAgentsModelConfig {
+  /**
+   * The model that will power your agent.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  id: BetaManagedAgentsModel;
+
+  /**
+   * How hard Claude works on each inference call. One of `low`, `medium`, `high`,
+   * `xhigh`, `max`. Always present; resolved to the per-model default at save time
+   * when not supplied.
+   */
+  effort?:
+    | BetaManagedAgentsEffortLow
+    | BetaManagedAgentsEffortMedium
+    | BetaManagedAgentsEffortHigh
+    | BetaManagedAgentsEffortXhigh
+    | BetaManagedAgentsEffortMax;
+
+  /**
+   * Geographic region for model inference. When unset, requests fall through to the
+   * workspace's default_inference_geo.
+   */
+  inference_geo?: string;
+
+  /**
+   * Inference speed mode. `fast` provides significantly faster output token
+   * generation at premium pricing. Defaults to `standard`. Not all models support
+   * `fast`; invalid combinations are rejected at create time.
+   */
+  speed?: 'standard' | 'fast';
+}
+
+/**
+ * An object that defines additional configuration control over model use
+ */
+export interface BetaManagedAgentsModelConfigParams {
+  /**
+   * The model that will power your agent.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  id: BetaManagedAgentsModel;
+
+  /**
+   * How hard Claude works on each inference call. Accepts a bare level string
+   * (`"high"`) or `{"type": "high"}`. On create, omitting it resolves the per-model
+   * default; on update, omitting it leaves the stored value unchanged.
+   */
+  effort?:
+    | 'low'
+    | 'medium'
+    | 'high'
+    | 'xhigh'
+    | 'max'
+    | BetaManagedAgentsEffortLow
+    | BetaManagedAgentsEffortMedium
+    | BetaManagedAgentsEffortHigh
+    | BetaManagedAgentsEffortXhigh
+    | BetaManagedAgentsEffortMax
+    | null;
+
+  /**
+   * Geographic region for model inference. When unset, requests fall through to the
+   * workspace's default_inference_geo. On update, `model` is whole-object
+   * replacement — omitting inference_geo clears it.
+   */
+  inference_geo?: string | null;
+
+  /**
+   * Inference speed mode. Defaults to `standard`.
+   */
+  speed?: 'standard' | 'fast' | null;
+}
+
+/**
+ * Whether the session's primary thread can consult an advisor model.
+ */
+export type BetaManagedAgentsMultiagentAdvisor =
+  | BetaManagedAgentsMultiagentAdvisorEnabled
+  | BetaManagedAgentsMultiagentAdvisorDisabled;
+
+/**
+ * The agent has no advisor.
+ */
+export interface BetaManagedAgentsMultiagentAdvisorDisabled {
+  type: 'disabled';
+}
+
+/**
+ * The agent has no advisor.
+ */
+export interface BetaManagedAgentsMultiagentAdvisorDisabledParams {
+  type: 'disabled';
+}
+
+/**
+ * The session's primary thread can consult `model` mid-turn.
+ */
+export interface BetaManagedAgentsMultiagentAdvisorEnabled {
+  /**
+   * The advisor model id.
+   */
+  model: string;
+
+  type: 'enabled';
+}
+
+/**
+ * The session's primary thread can consult `model` mid-turn.
+ */
+export interface BetaManagedAgentsMultiagentAdvisorEnabledParams {
+  /**
+   * A Claude model id. The model must be permitted as an advisor for this agent's
+   * model.
+   */
+  model: string;
+
+  type: 'enabled';
+}
+
+/**
+ * Whether the session's primary thread can consult an advisor model.
+ */
+export type BetaManagedAgentsMultiagentAdvisorParams =
+  | BetaManagedAgentsMultiagentAdvisorEnabledParams
+  | BetaManagedAgentsMultiagentAdvisorDisabledParams;
+
+/**
+ * Resolved coordinator topology with a concrete agent roster.
+ */
+export interface BetaManagedAgentsMultiagentCoordinator {
+  /**
+   * Agents the coordinator may spawn as session threads, each resolved to a specific
+   * version.
+   */
+  agents: Array<BetaManagedAgentsAgentReference | BetaManagedAgentsAdvisor>;
+
+  type: 'coordinator';
+}
+
+/**
+ * A coordinator topology: the session's primary thread orchestrates work by
+ * spawning session threads, each running an agent drawn from the `agents` roster.
+ */
+export interface BetaManagedAgentsMultiagentCoordinatorParams {
+  /**
+   * Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is
+   * an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or
+   * `{"type":"self"}` to allow recursive self-invocation. Entries must reference
+   * distinct agents (after resolving `self` and string forms); at most one `self`.
+   * Referenced agents must exist, must not be archived, and must not themselves have
+   * `multiagent` set (depth limit 1).
+   */
+  agents: Array<SessionsAPI.BetaManagedAgentsMultiagentRosterEntryParams>;
+
+  type: 'coordinator';
+}
+
+/**
+ * Whether the agent can define inline agents. The agent defines an inline agent
+ * itself, in a workflow run's plan or when it spawns a session thread, and the
+ * inline agent is not saved.
+ */
+export type BetaManagedAgentsMultiagentInlineAgents =
+  | BetaManagedAgentsMultiagentInlineAgentsEnabled
+  | BetaManagedAgentsMultiagentInlineAgentsDisabled;
+
+/**
+ * The agent cannot define inline agents.
+ */
+export interface BetaManagedAgentsMultiagentInlineAgentsDisabled {
+  type: 'disabled';
+}
+
+/**
+ * The agent cannot define inline agents.
+ */
+export interface BetaManagedAgentsMultiagentInlineAgentsDisabledParams {
+  type: 'disabled';
+}
+
+/**
+ * The agent can define inline agents.
+ */
+export interface BetaManagedAgentsMultiagentInlineAgentsEnabled {
+  type: 'enabled';
+}
+
+/**
+ * The agent can define inline agents.
+ */
+export interface BetaManagedAgentsMultiagentInlineAgentsEnabledParams {
+  type: 'enabled';
+}
+
+/**
+ * Whether the agent can define inline agents. The agent defines an inline agent
+ * itself, in a workflow run's plan or when it spawns a session thread, and the
+ * inline agent is not saved.
+ */
+export type BetaManagedAgentsMultiagentInlineAgentsParams =
+  | BetaManagedAgentsMultiagentInlineAgentsEnabledParams
+  | BetaManagedAgentsMultiagentInlineAgentsDisabledParams;
+
+/**
+ * One agent in a `predefined_agents` list. It is an agent ID string, an `agent`
+ * reference with an optional `version`, or `self` for the agent that owns this
+ * configuration.
+ */
+export type BetaManagedAgentsMultiagentPredefinedAgentParams =
+  | string
+  | SessionsAPI.BetaManagedAgentsAgentParams
+  | BetaManagedAgentsMultiagentSelfParams;
+
+/**
+ * Sentinel roster entry meaning "the agent that owns this configuration". Resolved
+ * server-side to a concrete agent reference.
+ */
+export interface BetaManagedAgentsMultiagentSelfParams {
+  type: 'self';
+}
+
+/**
+ * Whether the agent can spawn session threads.
+ */
+export type BetaManagedAgentsMultiagentSubagents =
+  | BetaManagedAgentsMultiagentSubagentsEnabled
+  | BetaManagedAgentsMultiagentSubagentsDisabled;
+
+/**
+ * The agent cannot spawn session threads.
+ */
+export interface BetaManagedAgentsMultiagentSubagentsDisabled {
+  type: 'disabled';
+}
+
+/**
+ * The agent cannot spawn session threads.
+ */
+export interface BetaManagedAgentsMultiagentSubagentsDisabledParams {
+  type: 'disabled';
+}
+
+/**
+ * The agent can spawn session threads.
+ */
+export interface BetaManagedAgentsMultiagentSubagentsEnabled {
+  /**
+   * Whether the agent can define inline agents, which are not saved, when it spawns
+   * session threads.
+   */
+  inline_agents: BetaManagedAgentsMultiagentInlineAgents;
+
+  /**
+   * Predefined agents, which are saved agents that this agent can spawn as session
+   * threads, each resolved to a specific version.
+   */
+  predefined_agents: Array<BetaManagedAgentsAgentReference>;
+
+  type: 'enabled';
+}
+
+/**
+ * The agent can spawn session threads. Each thread runs a predefined agent, which
+ * is a saved agent in `predefined_agents`, or an inline agent, which the agent
+ * defines when it spawns the thread and which is not saved. If `inline_agents` is
+ * disabled, `predefined_agents` must name at least one agent.
+ */
+export interface BetaManagedAgentsMultiagentSubagentsEnabledParams {
+  type: 'enabled';
+
+  /**
+   * Whether the agent can define inline agents when it spawns session threads.
+   * Defaults to enabled.
+   */
+  inline_agents?: BetaManagedAgentsMultiagentInlineAgentsParams | null;
+
+  /**
+   * Predefined agents that this agent can spawn as session threads. At most 20.
+   * Defaults to null. Null and an empty list both mean no predefined agents. This
+   * list is separate from `workflows.predefined_agents`, and an agent in one list is
+   * not added to the other.
+   */
+  predefined_agents?: Array<BetaManagedAgentsMultiagentPredefinedAgentParams> | null;
+}
+
+/**
+ * Whether the agent can spawn session threads.
+ */
+export type BetaManagedAgentsMultiagentSubagentsParams =
+  | BetaManagedAgentsMultiagentSubagentsEnabledParams
+  | BetaManagedAgentsMultiagentSubagentsDisabledParams;
+
+/**
+ * Whether the agent can start workflow runs.
+ */
+export type BetaManagedAgentsMultiagentWorkflows =
+  | BetaManagedAgentsMultiagentWorkflowsEnabled
+  | BetaManagedAgentsMultiagentWorkflowsDisabled;
+
+/**
+ * The agent cannot start workflow runs.
+ */
+export interface BetaManagedAgentsMultiagentWorkflowsDisabled {
+  type: 'disabled';
+}
+
+/**
+ * The agent cannot start workflow runs.
+ */
+export interface BetaManagedAgentsMultiagentWorkflowsDisabledParams {
+  type: 'disabled';
+}
+
+/**
+ * The agent can start workflow runs.
+ */
+export interface BetaManagedAgentsMultiagentWorkflowsEnabled {
+  /**
+   * Whether a run's plan can define inline agents, which are not saved.
+   */
+  inline_agents: BetaManagedAgentsMultiagentInlineAgents;
+
+  /**
+   * Predefined agents, which are saved agents that a run's plan can use, each
+   * resolved to a specific version.
+   */
+  predefined_agents: Array<BetaManagedAgentsAgentReference>;
+
+  type: 'enabled';
+}
+
+/**
+ * The agent can start workflow runs. Each run follows a plan, a program that the
+ * agent writes. A plan can use predefined agents, which are the saved agents in
+ * `predefined_agents`, and inline agents, which it defines itself and which are
+ * not saved. If `inline_agents` is disabled, `predefined_agents` must name at
+ * least one agent.
+ */
+export interface BetaManagedAgentsMultiagentWorkflowsEnabledParams {
+  type: 'enabled';
+
+  /**
+   * Whether a run's plan can define inline agents. Defaults to enabled.
+   */
+  inline_agents?: BetaManagedAgentsMultiagentInlineAgentsParams | null;
+
+  /**
+   * Predefined agents that a run's plan can use. At most 20. Defaults to null. Null
+   * and an empty list both mean no predefined agents. This list is separate from
+   * `subagents.predefined_agents`, and an agent in one list is not added to the
+   * other.
+   */
+  predefined_agents?: Array<BetaManagedAgentsMultiagentPredefinedAgentParams> | null;
+}
+
+/**
+ * Whether the agent can start workflow runs.
+ */
+export type BetaManagedAgentsMultiagentWorkflowsParams =
+  | BetaManagedAgentsMultiagentWorkflowsEnabledParams
+  | BetaManagedAgentsMultiagentWorkflowsDisabledParams;
+
+/**
+ * Resolved multiagent configuration with three members, each enabled or disabled
+ * on its own.
+ */
+export interface BetaManagedAgentsMultiagent20261001 {
+  /**
+   * Whether the session's primary thread can consult an advisor model.
+   */
+  advisor: BetaManagedAgentsMultiagentAdvisor;
+
+  /**
+   * Whether the agent can spawn session threads.
+   */
+  subagents: BetaManagedAgentsMultiagentSubagents;
+
+  type: 'multiagent_20261001';
+
+  /**
+   * Whether the agent can start workflow runs.
+   */
+  workflows: BetaManagedAgentsMultiagentWorkflows;
+}
+
+/**
+ * Multiagent configuration with three members, each enabled or disabled on its
+ * own. On an update, if the agent's stored `multiagent` also has type
+ * `multiagent_20261001`, this configuration is merged into the stored one, level
+ * by level, instead of replacing it. A key that the update omits keeps its stored
+ * value. A key sent as null takes its default, on create as well, so
+ * `"workflows": null` enables workflows. An object sent with a `type` other than
+ * the stored one replaces the stored object, and the keys that it omits take their
+ * defaults. A `predefined_agents` list that is sent replaces the stored list.
+ * Every object that is sent needs its `type`, and an enabled `advisor` needs its
+ * `model`. Other validation applies to the merged result.
+ */
+export interface BetaManagedAgentsMultiagent20261001Params {
+  type: 'multiagent_20261001';
+
+  /**
+   * Whether the session's primary thread can consult an advisor model. Defaults to
+   * disabled.
+   */
+  advisor?: BetaManagedAgentsMultiagentAdvisorParams | null;
+
+  /**
+   * Whether the agent can spawn session threads. Defaults to enabled.
+   */
+  subagents?: BetaManagedAgentsMultiagentSubagentsParams | null;
+
+  /**
+   * Whether the agent can start workflow runs. Defaults to enabled.
+   */
+  workflows?: BetaManagedAgentsMultiagentWorkflowsParams | null;
+}
+
+/**
+ * Configuration for the read tool.
+ */
+export interface BetaManagedAgentsReadToolConfig {
+  enabled: boolean;
+
+  name: 'read';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+
+  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 this tool. Controls whether tool calls are auto-approved
+   * or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+
+  type?: 'read';
+}
+
+/**
+ * The Anthropic-managed service account as returned in API responses.
+ */
+export interface BetaManagedAgentsServiceAccountExecutionIdentity {
+  type: 'service_account';
+}
+
+/**
+ * The Anthropic-managed service account — the default execution principal. Carries
+ * no identifier.
+ */
+export interface BetaManagedAgentsServiceAccountExecutionIdentityParams {
+  type: 'service_account';
+}
+
+/**
+ * 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
+ * from `Session.agent`.
+ */
+export interface BetaManagedAgentsSessionThreadAgent {
+  id: string;
+
+  description: string | null;
+
+  /**
+   * Execution principal snapshotted from the agent at session creation. Always
+   * present; `{"type": "service_account"}` when runs carry no customer-named
+   * principal.
+   */
+  execution_identity: BetaManagedAgentsExecutionIdentity;
+
+  mcp_servers: Array<BetaManagedAgentsMCPServerURLDefinition>;
+
+  /**
+   * Model identifier and configuration.
+   */
+  model: BetaManagedAgentsModelConfig;
+
+  name: string;
+
+  skills: Array<BetaManagedAgentsAnthropicSkill | BetaManagedAgentsCustomSkill>;
+
+  system: string | null;
+
+  tools: Array<
+    BetaManagedAgentsAgentToolset20260401 | BetaManagedAgentsMCPToolset | BetaManagedAgentsCustomTool
+  >;
+
+  type: 'agent';
+
+  version: number;
+}
+
+/**
+ * Skill to load in the session container.
+ */
+export type BetaManagedAgentsSkillParams =
+  | BetaManagedAgentsAnthropicSkillParams
+  | BetaManagedAgentsCustomSkillParams;
+
+/**
+ * URL-based MCP server connection.
+ */
+export interface BetaManagedAgentsURLMCPServerParams {
+  /**
+   * Unique name for this server, referenced by mcp_toolset configurations. 1-255
+   * characters.
+   */
+  name: string;
+
+  type: 'url';
+
+  /**
+   * Endpoint URL for the MCP server.
+   */
+  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
+    | BetaManagedAgentsAutoPolicy;
+
+  type: 'web_fetch';
+
+  /**
+   * Which sources contribute URLs the tool may fetch, always in the object form.
+   * Null when not set, which allows every source.
+   */
+  url_sources: BetaManagedAgentsWebFetchURLSources | null;
+
+  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 this tool. Controls whether tool calls are auto-approved
+   * or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+
+  type?: 'web_fetch';
+
+  /**
+   * Which sources contribute URLs the tool may fetch. Omit to allow every source.
+   */
+  url_sources?: BetaManagedAgentsWebFetchURLSourcesParams | null;
+}
+
+/**
+ * Every URL from this source may be fetched. This is the default.
+ */
+export interface BetaManagedAgentsWebFetchURLSourceAll {
+  type: 'all';
+}
+
+/**
+ * Every tool's results contribute URLs that may be fetched, except the named
+ * tools' results.
+ */
+export interface BetaManagedAgentsWebFetchURLSourceExcept {
+  /**
+   * The tools whose results do not contribute. Between 1 and 128 entries, each with
+   * a different name. An empty list is rejected; use "all" to leave out no tool's
+   * results.
+   */
+  tools: Array<BetaManagedAgentsWebFetchURLSourceToolReference>;
+
+  type: 'except';
+}
+
+/**
+ * This source contributes no URLs that may be fetched.
+ */
+export interface BetaManagedAgentsWebFetchURLSourceNone {
+  type: 'none';
+}
+
+/**
+ * Only the named tools' results contribute URLs that may be fetched.
+ */
+export interface BetaManagedAgentsWebFetchURLSourceOnly {
+  /**
+   * The tools whose results contribute. Between 1 and 128 entries, each with a
+   * different name. An empty list is rejected; use "none" to allow no tool's
+   * results.
+   */
+  tools: Array<BetaManagedAgentsWebFetchURLSourceToolReference>;
+
+  type: 'only';
+}
+
+/**
+ * String form of a url_sources value that has no field other than its type: "all"
+ * means {"type": "all"} and "none" means {"type": "none"}.
+ */
+export type BetaManagedAgentsWebFetchURLSourceShorthand = 'all' | 'none';
+
+/**
+ * Which tools' results contribute URLs that may be fetched.
+ */
+export type BetaManagedAgentsWebFetchURLSourceToolFilter =
+  | BetaManagedAgentsWebFetchURLSourceAll
+  | BetaManagedAgentsWebFetchURLSourceNone
+  | BetaManagedAgentsWebFetchURLSourceOnly
+  | BetaManagedAgentsWebFetchURLSourceExcept;
+
+/**
+ * Which tools' results contribute URLs that may be fetched. Accepts the string
+ * "all" or "none", or an object whose type is "all", "none", "only" or "except".
+ * Responses use the object form.
+ */
+export type BetaManagedAgentsWebFetchURLSourceToolFilterParams =
+  | BetaManagedAgentsWebFetchURLSourceShorthand
+  | BetaManagedAgentsWebFetchURLSourceToolFilter;
+
+/**
+ * Names one tool in an only or except list.
+ */
+export interface BetaManagedAgentsWebFetchURLSourceToolReference {
+  /**
+   * Name of the tool. Compared exactly, so upper and lower case letters are
+   * different.
+   */
+  name: string;
+
+  /**
+   * Must be "tool_reference".
+   */
+  type: 'tool_reference';
+}
+
+/**
+ * Whether URLs in the text of user messages may be fetched.
+ */
+export type BetaManagedAgentsWebFetchURLSourceUserInput =
+  | BetaManagedAgentsWebFetchURLSourceAll
+  | BetaManagedAgentsWebFetchURLSourceNone;
+
+/**
+ * Whether URLs in the text of user messages may be fetched. Accepts the string
+ * "all" or "none", or the object {"type": "all"} or {"type": "none"}. Responses
+ * use the object form.
+ */
+export type BetaManagedAgentsWebFetchURLSourceUserInputParams =
+  | BetaManagedAgentsWebFetchURLSourceShorthand
+  | BetaManagedAgentsWebFetchURLSourceUserInput;
+
+/**
+ * Which sources contribute URLs the web_fetch tool may fetch. A key that is null
+ * was not set and allows every URL from that source.
+ */
+export interface BetaManagedAgentsWebFetchURLSources {
+  /**
+   * Which custom tools' results contribute URLs that may be fetched. Null when not
+   * set, which allows every custom tool's results.
+   */
+  client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter | null;
+
+  /**
+   * Which of the web_search and web_fetch tools' results contribute URLs that may be
+   * fetched. Null when not set, which allows both.
+   */
+  server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter | null;
+
+  /**
+   * Whether URLs in the text of user messages may be fetched. Null when not set,
+   * which allows them.
+   */
+  user_input: BetaManagedAgentsWebFetchURLSourceUserInput | null;
+}
+
+/**
+ * Which sources contribute URLs the web_fetch tool may fetch. When web_fetch is
+ * limited to URLs the conversation has already shown the model (in a user message,
+ * a custom tool's result, or an earlier web_search or web_fetch result), each key
+ * narrows one of those sources and defaults to "all". Setting all three keys to
+ * "none" is rejected.
+ */
+export interface BetaManagedAgentsWebFetchURLSourcesParams {
+  /**
+   * Which custom tools' results contribute URLs that may be fetched: "all" (the
+   * default), "none", or an only or except list. Each name in a list must be a
+   * custom tool in the same tools array.
+   */
+  client_tool_results?: BetaManagedAgentsWebFetchURLSourceToolFilterParams | null;
+
+  /**
+   * Which of the web_search and web_fetch tools' results contribute URLs that may be
+   * fetched: "all" (the default), "none", or an only or except list. Each name in a
+   * list must be "web_search" or "web_fetch".
+   */
+  server_tool_results?: BetaManagedAgentsWebFetchURLSourceToolFilterParams | null;
+
+  /**
+   * Whether URLs in the text of user messages may be fetched: "all" (the default) or
+   * "none".
+   */
+  user_input?: BetaManagedAgentsWebFetchURLSourceUserInputParams | null;
+}
+
+/**
+ * Configuration for the web_search tool.
+ */
+export interface BetaManagedAgentsWebSearchToolConfig {
+  enabled: boolean;
+
+  name: 'web_search';
+
+  /**
+   * Permission policy for tool execution.
+   */
+  permission_policy:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy;
+
+  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 this tool. Controls whether tool calls are auto-approved
+   * or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | 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
+    | BetaManagedAgentsAutoPolicy;
+
+  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 this tool. Controls whether tool calls are auto-approved
+   * or require confirmation.
+   */
+  permission_policy?:
+    | BetaManagedAgentsAlwaysAllowPolicy
+    | BetaManagedAgentsAlwaysAskPolicy
+    | BetaManagedAgentsAutoPolicy
+    | null;
+
+  type?: 'write';
+}
+
+export interface AgentCreateParams {
+  /**
+   * Body param: Model identifier. Accepts the
+   * [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
+   * e.g. `claude-opus-5-5`, or a `model_config` object for additional configuration
+   * control
+   */
+  model: BetaManagedAgentsModel | BetaManagedAgentsModelConfigParams;
+
+  /**
+   * Body param: Human-readable name for the agent.
+   */
+  name: string;
+
+  /**
+   * Body param: Description of what the agent does.
+   */
+  description?: string | null;
+
+  /**
+   * Body param: Execution principal for runs of this agent. Omitting it, sending
+   * null, or sending `{"type": "service_account"}` stores the default.
+   */
+  execution_identity?: BetaManagedAgentsExecutionIdentityParams | null;
+
+  /**
+   * Body param: MCP servers this agent connects to. Maximum 20. Names must be unique
+   * within the array. Every server must be referenced by an `mcp_toolset` in
+   * `tools`; unreferenced servers are rejected. See the
+   * [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
+   */
+  mcp_servers?: Array<BetaManagedAgentsURLMCPServerParams>;
+
+  /**
+   * Body param: Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars,
+   * values up to 512 chars.
+   */
+  metadata?: { [key: string]: string };
+
+  /**
+   * Body param: Multiagent orchestration configuration.
+   */
+  multiagent?: SessionsAPI.BetaManagedAgentsMultiagentParams | null;
+
+  /**
+   * Body param: Skills available to the agent.
+   */
+  skills?: Array<BetaManagedAgentsSkillParams>;
+
+  /**
+   * Body param: System prompt for the agent.
+   */
+  system?: string | null;
+
+  /**
+   * Body param: Tool configurations available to the agent. Maximum of 256 tools
+   * across all toolsets allowed.
+   */
+  tools?: Array<
+    | BetaManagedAgentsAgentToolset20260401Params
+    | BetaManagedAgentsMCPToolsetParams
+    | BetaManagedAgentsCustomToolParams
+  >;
+
+  /**
+   * Header param: This endpoint is in beta: requests must send
+   * `managed-agents-2026-04-01` in this header.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
+}
+
+export interface AgentRetrieveParams {
+  /**
+   * Query param: Agent version. Omit for the most recent version. Must be at least 1
+   * if specified.
+   */
+  version?: number;
+
+  /**
+   * Header param: This endpoint is in beta: requests must send
+   * `managed-agents-2026-04-01` in this header.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
+}
+
+export interface AgentUpdateParams {
+  /**
+   * Body param: Description. Omit to preserve; send empty string or null to clear.
+   */
+  description?: string | null;
+
+  /**
+   * Body param: Execution principal for runs of this agent. Full replacement. Omit
+   * to preserve; send null or `{"type": "service_account"}` to restore the default.
+   */
+  execution_identity?: BetaManagedAgentsExecutionIdentityParams | null;
+
+  /**
+   * Body param: MCP servers. Full replacement. Omit to preserve; send empty array or
+   * `null` to clear. Names must be unique. Maximum 20. Every server must be
+   * referenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced
+   * servers are rejected. See the
+   * [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
+   */
+  mcp_servers?: Array<BetaManagedAgentsURLMCPServerParams> | null;
+
+  /**
+   * Body param: Metadata patch. Set a key to a string to upsert it, or to null to
+   * delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up
+   * to 64 chars each) with values up to 512 chars.
+   */
+  metadata?: { [key: string]: string | null } | null;
+
+  /**
+   * Body param: Model identifier. Accepts the
+   * [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
+   * e.g. `claude-opus-5-5`, or a `model_config` object for additional configuration
+   * control. Omit to preserve. Cannot be cleared.
+   */
+  model?: BetaManagedAgentsModel | BetaManagedAgentsModelConfigParams;
+
+  /**
+   * Body param: Multiagent orchestration configuration. Full replacement. Omit to
+   * preserve; send null to clear.
+   */
+  multiagent?: SessionsAPI.BetaManagedAgentsMultiagentParams | null;
+
+  /**
+   * Body param: Human-readable name. Must be non-empty. Omit to preserve. Cannot be
+   * cleared.
+   */
+  name?: string;
+
+  /**
+   * Body param: Skills. Full replacement. Omit to preserve; send empty array or null
+   * to clear.
+   */
+  skills?: Array<BetaManagedAgentsSkillParams> | null;
+
+  /**
+   * Body param: System prompt. Omit to preserve; send empty string or null to clear.
+   */
+  system?: string | null;
+
+  /**
+   * Body param: Tool configurations available to the agent. Full replacement. Omit
+   * to preserve; send empty array or null to clear. Maximum of 256 tools across all
+   * toolsets allowed.
+   */
+  tools?: Array<
+    | BetaManagedAgentsAgentToolset20260401Params
+    | BetaManagedAgentsMCPToolsetParams
+    | BetaManagedAgentsCustomToolParams
+  > | null;
+
+  /**
+   * Body param: The agent's current version, used to prevent concurrent overwrites.
+   * Obtain this value from a create or retrieve response. Must be at least 1 if
+   * specified. When supplied, the request fails if it does not match the server's
+   * current version; omit to apply the update unconditionally.
+   */
+  version?: number;
+
+  /**
+   * Header param: This endpoint is in beta: requests must send
+   * `managed-agents-2026-04-01` in this header.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
+}
+
+export interface AgentListParams extends PageCursorParams {
+  /**
+   * Query param: Return agents created at or after this time (inclusive).
+   */
+  'created_at[gte]'?: string;
+
+  /**
+   * Query param: Return agents created at or before this time (inclusive).
+   */
+  'created_at[lte]'?: string;
+
+  /**
+   * Query param: Include archived agents in results. Defaults to false.
+   */
+  include_archived?: boolean;
+
+  /**
+   * Header param: This endpoint is in beta: requests must send
+   * `managed-agents-2026-04-01` in this header.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
+}
+
+export interface AgentArchiveParams {
+  /**
+   * This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this
+   * header.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Optional header to select the Workspace for this request. The value is a
+   * Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
+}
+
+Agents.Versions = Versions;
+
+export declare namespace Agents {
+  export {
+    type BetaManagedAgentsAdvisor as BetaManagedAgentsAdvisor,
+    type BetaManagedAgentsAgent as BetaManagedAgentsAgent,
+    type BetaManagedAgentsAgentReference as BetaManagedAgentsAgentReference,
+    type BetaManagedAgentsAgentToolConfig as BetaManagedAgentsAgentToolConfig,
+    type BetaManagedAgentsAgentToolConfigParams as BetaManagedAgentsAgentToolConfigParams,
+    type BetaManagedAgentsAgentToolsetDefaultConfig as BetaManagedAgentsAgentToolsetDefaultConfig,
+    type BetaManagedAgentsAgentToolsetDefaultConfigParams as BetaManagedAgentsAgentToolsetDefaultConfigParams,
+    type BetaManagedAgentsAgentToolset20260401 as BetaManagedAgentsAgentToolset20260401,
+    type BetaManagedAgentsAgentToolset20260401BashInput as BetaManagedAgentsAgentToolset20260401BashInput,
+    type BetaManagedAgentsAgentToolset20260401EditInput as BetaManagedAgentsAgentToolset20260401EditInput,
+    type BetaManagedAgentsAgentToolset20260401GlobInput as BetaManagedAgentsAgentToolset20260401GlobInput,
+    type BetaManagedAgentsAgentToolset20260401GrepInput as BetaManagedAgentsAgentToolset20260401GrepInput,
+    type BetaManagedAgentsAgentToolset20260401Params as BetaManagedAgentsAgentToolset20260401Params,
+    type BetaManagedAgentsAgentToolset20260401ReadInput as BetaManagedAgentsAgentToolset20260401ReadInput,
+    type BetaManagedAgentsAgentToolset20260401WriteInput as BetaManagedAgentsAgentToolset20260401WriteInput,
+    type BetaManagedAgentsAlwaysAllowPolicy as BetaManagedAgentsAlwaysAllowPolicy,
+    type BetaManagedAgentsAlwaysAskPolicy as BetaManagedAgentsAlwaysAskPolicy,
+    type BetaManagedAgentsAnthropicSkill as BetaManagedAgentsAnthropicSkill,
+    type BetaManagedAgentsAnthropicSkillParams as BetaManagedAgentsAnthropicSkillParams,
+    type BetaManagedAgentsAutoPolicy as BetaManagedAgentsAutoPolicy,
+    type BetaManagedAgentsAWSRoleExecutionIdentity as BetaManagedAgentsAWSRoleExecutionIdentity,
+    type BetaManagedAgentsAWSRoleExecutionIdentityParams as BetaManagedAgentsAWSRoleExecutionIdentityParams,
+    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 BetaManagedAgentsExecutionIdentity as BetaManagedAgentsExecutionIdentity,
+    type BetaManagedAgentsExecutionIdentityParams as BetaManagedAgentsExecutionIdentityParams,
+    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,
+    type BetaManagedAgentsMCPToolset as BetaManagedAgentsMCPToolset,
+    type BetaManagedAgentsMCPToolsetDefaultConfig as BetaManagedAgentsMCPToolsetDefaultConfig,
+    type BetaManagedAgentsMCPToolsetDefaultConfigParams as BetaManagedAgentsMCPToolsetDefaultConfigParams,
+    type BetaManagedAgentsMCPToolsetParams as BetaManagedAgentsMCPToolsetParams,
+    type BetaManagedAgentsModel as BetaManagedAgentsModel,
+    type BetaManagedAgentsModelConfig as BetaManagedAgentsModelConfig,
+    type BetaManagedAgentsModelConfigParams as BetaManagedAgentsModelConfigParams,
+    type BetaManagedAgentsMultiagentAdvisor as BetaManagedAgentsMultiagentAdvisor,
+    type BetaManagedAgentsMultiagentAdvisorDisabled as BetaManagedAgentsMultiagentAdvisorDisabled,
+    type BetaManagedAgentsMultiagentAdvisorDisabledParams as BetaManagedAgentsMultiagentAdvisorDisabledParams,
+    type BetaManagedAgentsMultiagentAdvisorEnabled as BetaManagedAgentsMultiagentAdvisorEnabled,
+    type BetaManagedAgentsMultiagentAdvisorEnabledParams as BetaManagedAgentsMultiagentAdvisorEnabledParams,
+    type BetaManagedAgentsMultiagentAdvisorParams as BetaManagedAgentsMultiagentAdvisorParams,
+    type BetaManagedAgentsMultiagentCoordinator as BetaManagedAgentsMultiagentCoordinator,
+    type BetaManagedAgentsMultiagentCoordinatorParams as BetaManagedAgentsMultiagentCoordinatorParams,
+    type BetaManagedAgentsMultiagentInlineAgents as BetaManagedAgentsMultiagentInlineAgents,
+    type BetaManagedAgentsMultiagentInlineAgentsDisabled as BetaManagedAgentsMultiagentInlineAgentsDisabled,
+    type BetaManagedAgentsMultiagentInlineAgentsDisabledParams as BetaManagedAgentsMultiagentInlineAgentsDisabledParams,
+    type BetaManagedAgentsMultiagentInlineAgentsEnabled as BetaManagedAgentsMultiagentInlineAgentsEnabled,
+    type BetaManagedAgentsMultiagentInlineAgentsEnabledParams as BetaManagedAgentsMultiagentInlineAgentsEnabledParams,
+    type BetaManagedAgentsMultiagentInlineAgentsParams as BetaManagedAgentsMultiagentInlineAgentsParams,
+    type BetaManagedAgentsMultiagentPredefinedAgentParams as BetaManagedAgentsMultiagentPredefinedAgentParams,
+    type BetaManagedAgentsMultiagentSelfParams as BetaManagedAgentsMultiagentSelfParams,
+    type BetaManagedAgentsMultiagentSubagents as BetaManagedAgentsMultiagentSubagents,
+    type BetaManagedAgentsMultiagentSubagentsDisabled as BetaManagedAgentsMultiagentSubagentsDisabled,
+    type BetaManagedAgentsMultiagentSubagentsDisabledParams as BetaManagedAgentsMultiagentSubagentsDisabledParams,
+    type BetaManagedAgentsMultiagentSubagentsEnabled as BetaManagedAgentsMultiagentSubagentsEnabled,
+    type BetaManagedAgentsMultiagentSubagentsEnabledParams as BetaManagedAgentsMultiagentSubagentsEnabledParams,
+    type BetaManagedAgentsMultiagentSubagentsParams as BetaManagedAgentsMultiagentSubagentsParams,
+    type BetaManagedAgentsMultiagentWorkflows as BetaManagedAgentsMultiagentWorkflows,
+    type BetaManagedAgentsMultiagentWorkflowsDisabled as BetaManagedAgentsMultiagentWorkflowsDisabled,
+    type BetaManagedAgentsMultiagentWorkflowsDisabledParams as BetaManagedAgentsMultiagentWorkflowsDisabledParams,
+    type BetaManagedAgentsMultiagentWorkflowsEnabled as BetaManagedAgentsMultiagentWorkflowsEnabled,
+    type BetaManagedAgentsMultiagentWorkflowsEnabledParams as BetaManagedAgentsMultiagentWorkflowsEnabledParams,
+    type BetaManagedAgentsMultiagentWorkflowsParams as BetaManagedAgentsMultiagentWorkflowsParams,
+    type BetaManagedAgentsMultiagent20261001 as BetaManagedAgentsMultiagent20261001,
+    type BetaManagedAgentsMultiagent20261001Params as BetaManagedAgentsMultiagent20261001Params,
+    type BetaManagedAgentsReadToolConfig as BetaManagedAgentsReadToolConfig,
+    type BetaManagedAgentsReadToolConfigParams as BetaManagedAgentsReadToolConfigParams,
+    type BetaManagedAgentsServiceAccountExecutionIdentity as BetaManagedAgentsServiceAccountExecutionIdentity,
+    type BetaManagedAgentsServiceAccountExecutionIdentityParams as BetaManagedAgentsServiceAccountExecutionIdentityParams,
+    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 BetaManagedAgentsWebFetchURLSourceAll as BetaManagedAgentsWebFetchURLSourceAll,
+    type BetaManagedAgentsWebFetchURLSourceExcept as BetaManagedAgentsWebFetchURLSourceExcept,
+    type BetaManagedAgentsWebFetchURLSourceNone as BetaManagedAgentsWebFetchURLSourceNone,
+    type BetaManagedAgentsWebFetchURLSourceOnly as BetaManagedAgentsWebFetchURLSourceOnly,
+    type BetaManagedAgentsWebFetchURLSourceShorthand as BetaManagedAgentsWebFetchURLSourceShorthand,
+    type BetaManagedAgentsWebFetchURLSourceToolFilter as BetaManagedAgentsWebFetchURLSourceToolFilter,
+    type BetaManagedAgentsWebFetchURLSourceToolFilterParams as BetaManagedAgentsWebFetchURLSourceToolFilterParams,
+    type BetaManagedAgentsWebFetchURLSourceToolReference as BetaManagedAgentsWebFetchURLSourceToolReference,
+    type BetaManagedAgentsWebFetchURLSourceUserInput as BetaManagedAgentsWebFetchURLSourceUserInput,
+    type BetaManagedAgentsWebFetchURLSourceUserInputParams as BetaManagedAgentsWebFetchURLSourceUserInputParams,
+    type BetaManagedAgentsWebFetchURLSources as BetaManagedAgentsWebFetchURLSources,
+    type BetaManagedAgentsWebFetchURLSourcesParams as BetaManagedAgentsWebFetchURLSourcesParams,
+    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,
+    type AgentUpdateParams as AgentUpdateParams,
+    type AgentListParams as AgentListParams,
+    type AgentArchiveParams as AgentArchiveParams,
+  };
+
+  export { Versions as Versions, type VersionListParams as VersionListParams };
+}