Resolve the config directory. ``ANTHROPIC_CONFIG_DIR`` env var → platform default. Platform defaults: * Linux & macOS: ``~/.config/ant

If the given type is an `Annotated` type then it is returned, if not `None` is returned. This also unwraps the type when applicable, e.g. `Requir

``json.dumps`` with ``SecretStr`` values unwrapped at dump time. Returns bytes so call sites can pass the result inline (request content, ``o

Truncate a token-endpoint error body for safe inclusion in an exception.

base_url precedence: top-level config field → bound (the owning client's base_url, via :meth:`bind_base_url`) → default. Validated aga

Resolve a configured cap to an effective size limit. ``not_given`` selects ``default``; ``None`` disables the size check (uncapped); a positi

The synthetic `fallback` content block marking one model boundary.

Detach the frames chained onto ``err`` before raising from it. Foreign frames (json decoder, httpx transport) hold raw payloads — request bod

Transform the given data against the expected type. Args: annotation: The direct type annotation given to the particular piece of data.

Inverse of :func:`_wrap_secret_fields` for a single value; pass-through for values that were never wrapped (absent or non-string fields).

Reject profile names that could escape the config directory. Profile names come from user-controlled sources (``ANTHROPIC_PROFILE``, the ``ac

Wrap the secret fields of a parsed JSON object in ``SecretStr``. Called at every boundary where credential material enters SDK code. Tracebac

(Re)start the idle countdown from now and wake the watchdog. Deferred while any gated call is held or in flight — stopping then would

Convert an MCP tool to an async runnable tool for ``tool_runner()``. Example:: from anthropic.lib.tools.mcp import async_mcp_tool

Adopt the owning client's ``base_url`` as a fallback for the token exchange. Slots between the config file's own ``base_url`` field and

Close the underlying HTTPX client. The client will *not* be usable after this.

Create a new client instance re-using the same options given to the current client with optional overriding.

Create a new client instance re-using the same options given to the current client with optional overriding.

Create a new memory file with the specified content.

Perform a single RFC 7523 ``jwt-bearer`` exchange and return the resulting :class:`AccessToken`. This is a one-shot convenience wrapper aroun

Convert MCP resource contents to a file tuple for ``files.upload()``. Returns a ``(filename, content_bytes, mime_type)`` tuple compatible with

Read and return the binary response content.

Drop one hold; the last release applies any deferred arm. Once nothing gated is held or in flight, a deferred ``end_turn`` countdown

Render an exception raised by a tool as tool-result content. A :class:`ToolError` carries its own structured content; anything else is render

Resolve the active profile name. ``ANTHROPIC_PROFILE`` env var → ``<config_dir>/active_config`` pointer file → ``"default"`` literal. The res

The request's JSON body when this middleware applies to it, `None` otherwise.

Return the single top-level directory shared by every archive entry, or ``""`` if the entries don't all live under one common directory. Skil

Transform the given data against the expected type. Args: annotation: The direct type annotation given to the particular piece of data.

Atomic write to the credentials file (NOT the config file). ``data`` may hold :class:`SecretStr` token values (see :meth:`_read_crede

Prepare, build and send a single HTTP attempt. Returns the response regardless of its status code, along with the prepared options it

Prepare, build and send a single HTTP attempt. Returns the response regardless of its status code, along with the prepared options it

The tool names currently available, after applying any mid-conversation ``tool_removal`` / ``tool_addition`` blocks. Removal is only

Return the provider this client should exchange tokens through. See :class:`BaseURLBoundProvider`; any other provider (plain callables, custo

Return ``path`` with ``.``/``..`` collapsed lexically and every symlink followed, or raise ``OSError`` — the same outcome on every supported Pytho

Release any resources owned by a credential provider, if it exposes ``close()``.