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

Replace {name} placeholders in `template`, quoting each value with `quoter`. Placeholder names are looked up in `values`. Raises: Ke

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

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

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

Add one or more messages to the conversation history. This invalidates the cached tool response, i.e. if tools were already called, then they

Close the owned ``httpx.Client`` if we created one.

The accumulated content blocks, in start order.

Create a new memory file with the specified content.

The outcome once the hop's stream is fully consumed (or cut early).

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

Read and decode the JSON response content.

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.

Update the parameters for the next API call. This invalidates any cached tool responses. Args: params (ParsedMessageCrea

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.

Reduce an archive entry's Unix mode to ``0o755`` if it is executable, ``0o644`` otherwise. Skill bundles can ship executable scripts (e.g. ``

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).

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

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()``.

Parse a credentials-file ``expires_at`` field into Unix seconds.

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

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

Convert MCP ``CallToolResult`` to a value suitable for returning from ``call()``.

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

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

Feed one hop's SSE events through `reader`, yielding the frames to forward.

Feed one hop's SSE events through `reader`, yielding the frames to forward. The outcome is read from `reader.finish()` afterwards — async generat

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.