Function build_stream_config

libs/code/deepagents_code/config.py:1467–1560

Build the LangGraph stream config dict. Stamps the shared `coding-agent-v1` trace-metadata contract (LSEN-277) via `build_coding_agent_metadata` — identity block, plugin/runtime versions, turn markers, and repo/git/cwd attribution — onto `metadata`. Metadata set here propagates trac

(
    thread_id: str,
    assistant_id: str | None,
    *,
    sandbox_type: str | None = None,
    turn_id: str | None = None,
    turn_number: int | None = None,
)

def build_stream_config(
    thread_id: str,
    assistant_id: str | None,
    *,
    sandbox_type: str | None = None,
    turn_id: str | None = None,
    turn_number: int | None = None,
) -> RunnableConfig:
    """Build the LangGraph stream config dict.

    Stamps the shared `coding-agent-v1` trace-metadata contract (LSEN-277) via
    `build_coding_agent_metadata` — identity block, plugin/runtime versions,
    turn markers, and repo/git/cwd attribution — onto `metadata`. Metadata set
    here propagates trace-wide to every run in the graph (root, llm, tool, and
    subagent subgraphs), which is exactly what the contract's "always" and
    "where-known" keys require, so the helper output is stamped once here.

    Scope-restricted contract keys are deliberately not emitted. `approval_policy`
    (root/interrupted only) and `ls_subagent_id` / `ls_subagent_type` (subagent
    only) cannot live in this trace-wide metadata: LangGraph propagates each key
    to all descendant runs (per-key config merge, langgraph#7926 /
    deepagents#3634), so they would leak onto run types outside their contract
    `appliesTo` set and fail validation. This runtime exposes no clean
    per-run-type metadata seam to scope them, so they are omitted by design
    rather than leaked. (Subagent runs still inherit the parent/root `thread_id`
    and all required keys, satisfying the contract's grouping rule.)

    Also injects the dcode version into `metadata["lc_versions"]` so LangSmith
    traces can be correlated with specific releases. `create_deep_agent` supplies
    the SDK version through the compiled graph config, and LangChain merges
    nested metadata dictionaries so both versions survive at stream time.

    Also records `dcode_client_deepagents_version` as a dcode-client diagnostic.
    This describes the Deep Agents package installed alongside the TUI, which
    can differ from a remote graph's Deep Agents runtime version.

    Args:
        thread_id: The app session thread identifier. Set both on
            `configurable.thread_id` and as the top-level `metadata.thread_id`
            used by the contract for grouping turns.
        assistant_id: The dcode agent identifier, if any. When set, it is
            surfaced in trace metadata under `dcode_agent_name` and
            `agent_name`.
        sandbox_type: Sandbox provider name for trace metadata, or `None` if no
            sandbox is active.
        turn_id: Stable per-turn id for the current user prompt, or `None`.
        turn_number: 1-based per-thread turn index, or `None`.

    Returns:
        Config dict with `configurable` and `metadata` keys.
    """
    from datetime import UTC, datetime

    try:
        cwd = str(Path.cwd())
    except OSError:
        logger.warning("Could not determine working directory", exc_info=True)
        cwd = ""