{"record":{"id":"be1118e017a2debd","repo":"openai/codex","slug":"sandbox-must-be-one-of-options","errorCode":null,"errorMessage":"sandbox must be one of: {options}","messagePattern":"sandbox must be one of: (.+?)","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"sdk/python/src/openai_codex/_sandbox.py","lineNumber":33,"sourceCode":"class Sandbox(str, Enum):\n    \"\"\"Preset filesystem access levels for threads and turns.\n\n    `read_only` allows file reads without writes. `workspace_write` is the\n    normal default for projects with a recorded trust decision and allows\n    writes inside the workspace and configured writable roots. `full_access`\n    removes filesystem access restrictions.\n    \"\"\"\n\n    read_only = \"read-only\"\n    workspace_write = \"workspace-write\"\n    full_access = \"full-access\"\n\n\ndef _require_sandbox(sandbox: Sandbox) -> None:\n    if isinstance(sandbox, Sandbox):\n        return\n    options = \", \".join(f\"Sandbox.{value.name}\" for value in Sandbox)\n    raise ValueError(f\"sandbox must be one of: {options}\")\n\n\ndef _sandbox_mode(sandbox: Sandbox | None) -> SandboxMode | None:\n    \"\"\"Translate a public preset to the thread lifecycle wire mode.\"\"\"\n    if sandbox is None:\n        return None\n    _require_sandbox(sandbox)\n\n    match sandbox:\n        case Sandbox.read_only:\n            return SandboxMode.read_only\n        case Sandbox.workspace_write:\n            return SandboxMode.workspace_write\n        case Sandbox.full_access:\n            return SandboxMode.danger_full_access\n        case _:\n            return _assert_never_sandbox(sandbox)\n","sourceCodeStart":15,"sourceCodeEnd":51,"githubUrl":"https://github.com/openai/codex/blob/339751715c64496cb86246bfb3935f40e309dd3d/sdk/python/src/openai_codex/_sandbox.py#L15-L51","documentation":"Error \"sandbox must be one of: {options}\" thrown in openai/codex.","triggerScenarios":"Thrown at sdk/python/src/openai_codex/_sandbox.py:33 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Pass one of the sandbox options listed in the message."],"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"}