{"record":{"id":"23e1688ed9b3e36b","repo":"openai/codex","slug":"initialize-response-missing-required-metadata-use","errorCode":null,"errorMessage":"initialize response missing required metadata (user_agent={user_agent!r}, server_name={normalized_server_name!r}, server_version={normalized_server_version!r})","messagePattern":"initialize response missing required metadata \\(user_agent=(.+?), server_name=(.+?), server_version=(.+?)\\)","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"sdk/python/src/openai_codex/_initialize_metadata.py","lineNumber":40,"sourceCode":"\n    server_name: str | None = None\n    server_version: str | None = None\n\n    if server is not None:\n        server_name = (server.name or \"\").strip() or None\n        server_version = (server.version or \"\").strip() or None\n\n    if (server_name is None or server_version is None) and user_agent:\n        parsed_name, parsed_version = _split_user_agent(user_agent)\n        if server_name is None:\n            server_name = parsed_name\n        if server_version is None:\n            server_version = parsed_version\n\n    normalized_server_name = (server_name or \"\").strip()\n    normalized_server_version = (server_version or \"\").strip()\n    if not user_agent or not normalized_server_name or not normalized_server_version:\n        raise RuntimeError(\n            \"initialize response missing required metadata \"\n            f\"(user_agent={user_agent!r}, server_name={normalized_server_name!r}, server_version={normalized_server_version!r})\"\n        )\n\n    if server is None:\n        payload.serverInfo = ServerInfo(\n            name=normalized_server_name,\n            version=normalized_server_version,\n        )\n    else:\n        server.name = normalized_server_name\n        server.version = normalized_server_version\n\n    return payload\n","sourceCodeStart":22,"sourceCodeEnd":55,"githubUrl":"https://github.com/openai/codex/blob/339751715c64496cb86246bfb3935f40e309dd3d/sdk/python/src/openai_codex/_initialize_metadata.py#L22-L55","documentation":"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.","triggerScenarios":"Thrown at sdk/python/src/openai_codex/_initialize_metadata.py:40 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Update the connected Codex runtime so its initialize response carries user_agent, server name, and server version metadata."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"339751715c64496cb86246bfb3935f40e309dd3d","analyzedAt":"2026-08-25T05:35:09.876Z","schemaVersion":2},"datasetVersion":"2026-08-25T06:17:31.827Z"}