Class CLIContext

libs/code/deepagents_code/_cli_context.py:47–96

Client-facing builder for the per-run graph context payload. Callers populate this and pass it via `context=` to `astream`/`ainvoke`. `ConfigurableModelMiddleware` and the `interrupt_on` `when` predicate read it from `request.runtime.context`. In-process LangGraph coerces it into `C

class CLIContext(TypedDict, total=False):
    """Client-facing builder for the per-run graph context payload.

    Callers populate this and pass it via `context=` to `astream`/`ainvoke`.
    `ConfigurableModelMiddleware` and the `interrupt_on` `when` predicate read
    it from `request.runtime.context`. In-process LangGraph coerces it into
    `CLIContextSchema` (the registered `context_schema`); over the API it stays
    a plain dict — which is why consumers handle both shapes.
    """

    model: str | None
    """Model spec to swap at runtime (e.g. `'provider:model'`)."""

    model_params: dict[str, Any]
    """Invocation params (e.g. `temperature`, `max_tokens`) to merge
    into `model_settings`."""

    auto_approve: bool
    """Whether gated tool calls should skip the human-approval interrupt.

    Sourced from the client session (not graph state) so the model cannot
    self-approve by writing state. The `interrupt_on` `when` predicate reads
    this to suppress interrupts at the source when "approve always" is on,
    avoiding the interrupt-then-auto-resolve round-trip.
    """

    approval_mode_key: str | None
    """Store key for the live approval-mode control record.

    The TUI updates this record when the user toggles approval mode mid-run.
    The server-side interrupt predicate reads it from the LangGraph Store on
    each gated tool call so auto-to-manual changes can take effect before the
    current stream returns.
    """

    thread_id: str | None
    """LangGraph thread ID for the active conversation.

    Mirrors `config.configurable.thread_id` into runtime context for model-call
    middleware that needs per-request session identity, including Fireworks
    session-affinity headers.
    """

    blocked_goal_retry_context: str | None
    """One-turn model context for retrying a previously blocked goal.

    This is intentionally carried in runtime context instead of the user
    message so it is not parsed as a file mention or checkpointed as human
    input.
    """