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

Fold mid-conversation ``tool_removal`` / ``tool_addition`` blocks over the locally runnable ``tool_names``. Only ``role: "system"`` messages

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

True for a 4xx that retrying will not fix (bad key, missing resource). Aligns with the core client's ``_should_retry`` policy: 408 / 409 / 429 ar

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.

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

If the credential provider supports ``bind_base_url``, pass it the client's resolved ``base_url`` so the token exchange and API calls hit the

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

Path to ``<config_dir>/configs/<profile>.json`` (non-secret, 0644).

Convert an `APIResponse` / `AsyncAPIResponse` into the equivalent `LegacyAPIResponse`.

The refusal's minted credit token; only the beta surface carries one.

The retry's `fallback_credit_token`, in the object form. `best_effort` keeps the retry serving even when redemption fails — a bare string wou

The `usage.iterations` entries a declined hop contributes to the chain. The hop's refusal self-reports its iterations: adopt them, retyped to

Whether the given `cast_to` asks for the `APIResponse` wrapper itself.

The per-item body shared by :meth:`run`'s poll loop and :meth:`handle_item`. Runs a :class:`SessionToolRunner` for the work item's session wh

True if the user wrote a non-empty ``active_config`` pointer file. This is an explicit opt-in signal equivalent to setting ``ANTHROPIC_PROFILE``:

Infer the AWS region from the environment variables or from the boto3 session if available.

Whether calling the given object returns a coroutine. Unlike `inspect.iscoroutinefunction(obj)` this also handles class instances that define