@verevoir/review 0.3.0 → 0.3.2

package/node_modules/@anthropic-ai/sdk/resources/beta/agents/agents.d.mts

@@ -0,0 +1,1632 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as BetaAPI from "../beta.mjs";
+import * as VersionsAPI from "./versions.mjs";
+import { VersionListParams, Versions } from "./versions.mjs";
+import * as SessionsAPI from "../sessions/sessions.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { PageCursor, type PageCursorParams, PagePromise } from "../../../core/pagination.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Agents extends APIResource {
+    versions: VersionsAPI.Versions;
+    /**
+     * 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>;
+    /**
+     * Get Agent
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsAgent =
+     *   await client.beta.agents.retrieve(
+     *     'agent_011CZkYpogX7uDKUyvBTophP',
+     *   );
+     * ```
+     */
+    retrieve(agentID: string, params?: AgentRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<BetaManagedAgentsAgent>;
+    /**
+     * Update Agent
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsAgent =
+     *   await client.beta.agents.update(
+     *     'agent_011CZkYpogX7uDKUyvBTophP',
+     *     { description: 'updated' },
+     *   );
+     * ```
+     */
+    update(agentID: string, params: AgentUpdateParams, options?: RequestOptions): APIPromise<BetaManagedAgentsAgent>;
+    /**
+     * 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>;
+    /**
+     * Archive Agent
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsAgent =
+     *   await client.beta.agents.archive(
+     *     'agent_011CZkYpogX7uDKUyvBTophP',
+     *   );
+     * ```
+     */
+    archive(agentID: string, params?: AgentArchiveParams | null | undefined, options?: RequestOptions): APIPromise<BetaManagedAgentsAgent>;
+}
+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;
+}
+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 };
+}
+//# sourceMappingURL=agents.d.mts.map