openai/codex · error · RuntimeError

initialize response missing required metadata (user_agent={u

Error message

initialize response missing required metadata (user_agent={user_agent!r}, server_name={normalized_server_name!r}, server_version={normalized_server_version!r})

What it means

Error "initialize response missing required metadata (user_agent={user_agent!r}, server_name={normalized_server_name!r}, server_version={normalized_server_version!r})" thrown in openai/codex.

Source

Thrown at sdk/python/src/openai_codex/_initialize_metadata.py:40

    server_name: str | None = None
    server_version: str | None = None

    if server is not None:
        server_name = (server.name or "").strip() or None
        server_version = (server.version or "").strip() or None

    if (server_name is None or server_version is None) and user_agent:
        parsed_name, parsed_version = _split_user_agent(user_agent)
        if server_name is None:
            server_name = parsed_name
        if server_version is None:
            server_version = parsed_version

    normalized_server_name = (server_name or "").strip()
    normalized_server_version = (server_version or "").strip()
    if not user_agent or not normalized_server_name or not normalized_server_version:
        raise RuntimeError(
            "initialize response missing required metadata "
            f"(user_agent={user_agent!r}, server_name={normalized_server_name!r}, server_version={normalized_server_version!r})"
        )

    if server is None:
        payload.serverInfo = ServerInfo(
            name=normalized_server_name,
            version=normalized_server_version,
        )
    else:
        server.name = normalized_server_name
        server.version = normalized_server_version

    return payload

View on GitHub (pinned to 339751715c)

Solutions

1. Update the connected Codex runtime so its initialize response carries user_agent, server name, and server version metadata.

When it happens

Trigger: Thrown at sdk/python/src/openai_codex/_initialize_metadata.py:40 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of openai/codex@339751715c (2026-08-25). Data as JSON: /api/errors/23e1688ed9b3e36b. Report an issue: GitHub.