codex-chatgpt-control 0.1.0-alpha.1

package/contracts/v1/fixtures/runner-budget-blocker.json

@@ -0,0 +1,106 @@
+{
+  "result": {
+    "activeAgentName": "budget-agent",
+    "blocker": {
+      "code": "run_budget_exceeded",
+      "fieldPath": "limits",
+      "kind": "confirmation",
+      "message": "Workflow \"agent-run:budget-agent\" exceeds ChatGPT browser-control run budget: prompts 1/0. Ask the user to confirm a bounded exception.",
+      "remediation": [
+        {
+          "instruction": "Ask the user to approve this specific over-budget run, or reduce the number of prompts, thread opens, or message reads.",
+          "label": "Confirm bounded run",
+          "userActionRequired": true
+        }
+      ],
+      "resumable": true
+    },
+    "context": {
+      "timestamp": "2026-06-06T00:00:00.000Z"
+    },
+    "data": {
+      "outputText": ""
+    },
+    "interruptions": [
+      {
+        "blocker": {
+          "code": "run_budget_exceeded",
+          "fieldPath": "limits",
+          "kind": "confirmation",
+          "message": "Workflow \"agent-run:budget-agent\" exceeds ChatGPT browser-control run budget: prompts 1/0. Ask the user to confirm a bounded exception.",
+          "remediation": [
+            {
+              "instruction": "Ask the user to approve this specific over-budget run, or reduce the number of prompts, thread opens, or message reads.",
+              "label": "Confirm bounded run",
+              "userActionRequired": true
+            }
+          ],
+          "resumable": true
+        },
+        "fieldPath": "limits",
+        "fix": {
+          "steps": [
+            "Ask the user to approve this specific over-budget run, or reduce the number of prompts, thread opens, or message reads."
+          ],
+          "summary": "Resolve the reported blocker before resuming."
+        },
+        "id": "interruption_fixed",
+        "message": "Workflow \"agent-run:budget-agent\" exceeds ChatGPT browser-control run budget: prompts 1/0. Ask the user to confirm a bounded exception.",
+        "resume": {
+          "stateId": "interruption_fixed",
+          "supported": true
+        },
+        "status": "needs_confirmation",
+        "type": "approval_required"
+      }
+    ],
+    "lastAgentName": "budget-agent",
+    "newItems": [
+      {
+        "blocker": {
+          "code": "run_budget_exceeded",
+          "fieldPath": "limits",
+          "kind": "confirmation",
+          "message": "Workflow \"agent-run:budget-agent\" exceeds ChatGPT browser-control run budget: prompts 1/0. Ask the user to confirm a bounded exception.",
+          "remediation": [
+            {
+              "instruction": "Ask the user to approve this specific over-budget run, or reduce the number of prompts, thread opens, or message reads.",
+              "label": "Confirm bounded run",
+              "userActionRequired": true
+            }
+          ],
+          "resumable": true
+        },
+        "type": "run.blocked"
+      }
+    ],
+    "ok": false,
+    "output": [
+      {
+        "blocker": {
+          "code": "run_budget_exceeded",
+          "fieldPath": "limits",
+          "kind": "confirmation",
+          "message": "Workflow \"agent-run:budget-agent\" exceeds ChatGPT browser-control run budget: prompts 1/0. Ask the user to confirm a bounded exception.",
+          "remediation": [
+            {
+              "instruction": "Ask the user to approve this specific over-budget run, or reduce the number of prompts, thread opens, or message reads.",
+              "label": "Confirm bounded run",
+              "userActionRequired": true
+            }
+          ],
+          "resumable": true
+        },
+        "type": "run.blocked"
+      }
+    ],
+    "output_text": "",
+    "state": {
+      "id": "interruption_fixed",
+      "resumable": true
+    },
+    "status": "needs_confirmation",
+    "warnings": []
+  },
+  "schemaVersion": "chatgpt.browser_control.run_result.v1"
+}

package/contracts/v1/fixtures/runner-full-agent-config.json

@@ -0,0 +1,50 @@
+{
+  "defaults": {
+    "read": {
+      "format": "markdown"
+    },
+    "report": {
+      "enabled": false
+    },
+    "thread": {
+      "type": "new"
+    },
+    "wait": {
+      "pollMs": 0,
+      "stableMs": 0,
+      "timeoutMs": 100
+    }
+  },
+  "guardrails": [
+    {
+      "name": "no hidden prompt claims",
+      "scope": "input"
+    },
+    {
+      "name": "redact report previews",
+      "scope": "report"
+    }
+  ],
+  "instructions": "Use visible ChatGPT browser control honestly.",
+  "instructionsMode": "visible_prefix",
+  "kind": "chatgpt_browser_agent",
+  "metadata": {
+    "fixture": "runner_full_agent_config",
+    "stability": "deterministic"
+  },
+  "name": "parity-reviewer",
+  "output": {
+    "onParseError": "error",
+    "parse": "json",
+    "sample": {
+      "verdict": "ok"
+    }
+  },
+  "tools": [
+    {
+      "command": "tools.select",
+      "name": "web search",
+      "risk": "medium"
+    }
+  ]
+}

package/contracts/v1/fixtures/runner-input-items-and-files-plan.json

@@ -0,0 +1,53 @@
+{
+  "name": "agent-run:file-agent",
+  "policy": {
+    "returnPartial": true,
+    "stopOnError": true
+  },
+  "steps": [
+    {
+      "command": "session.bootstrap",
+      "id": "bootstrap"
+    },
+    {
+      "command": "threads.new",
+      "id": "new"
+    },
+    {
+      "args": {
+        "model": "auto"
+      },
+      "command": "modes.set",
+      "id": "mode"
+    },
+    {
+      "args": {
+        "ifUnavailable": "skip",
+        "tool": "web_search"
+      },
+      "command": "tools.select",
+      "id": "tool1"
+    },
+    {
+      "args": {
+        "paths": [
+          "/tmp/contract-fixtures/handoff.md",
+          "/tmp/contract-fixtures/context.json"
+        ]
+      },
+      "command": "files.attach",
+      "id": "attach"
+    },
+    {
+      "args": {
+        "read": {
+          "format": "markdown"
+        },
+        "text": "<chatgpt_browser_agent>\nAgent name: file-agent\nInstructions:\nUse the attached file context.\n</chatgpt_browser_agent>\n\n<user_request>\n<visible_instructions>\nUse concise bullets.\n</visible_instructions>\n\nReview the implementation handoff.\n\nAttached file context: SDK parity handoff.\n</user_request>",
+        "wait": false
+      },
+      "command": "messages.ask",
+      "id": "ask"
+    }
+  ]
+}

package/contracts/v1/fixtures/runner-metadata-only-plan.json

@@ -0,0 +1,31 @@
+{
+  "name": "agent-run:metadata-agent",
+  "policy": {
+    "returnPartial": true,
+    "stopOnError": true
+  },
+  "steps": [
+    {
+      "command": "session.bootstrap",
+      "id": "bootstrap"
+    },
+    {
+      "args": {
+        "conversationId": "conv_metadata_123"
+      },
+      "command": "threads.open",
+      "id": "open"
+    },
+    {
+      "args": {
+        "read": {
+          "format": "markdown"
+        },
+        "text": "Summarize visible-only behavior.",
+        "wait": true
+      },
+      "command": "messages.ask",
+      "id": "ask"
+    }
+  ]
+}

package/contracts/v1/fixtures/runner-visible-prefix-plan.json

@@ -0,0 +1,28 @@
+{
+  "name": "agent-run:visible-prefix-agent",
+  "policy": {
+    "returnPartial": true,
+    "stopOnError": true
+  },
+  "steps": [
+    {
+      "command": "session.bootstrap",
+      "id": "bootstrap"
+    },
+    {
+      "command": "threads.new",
+      "id": "new"
+    },
+    {
+      "args": {
+        "read": {
+          "format": "markdown"
+        },
+        "text": "<chatgpt_browser_agent>\nAgent name: visible-prefix-agent\nInstructions:\nAnswer with terse implementation guidance.\n</chatgpt_browser_agent>\n\n<user_request>\nAssess the SDK architecture.\n</user_request>",
+        "wait": true
+      },
+      "command": "messages.ask",
+      "id": "ask"
+    }
+  ]
+}

package/contracts/v1/fixtures/runner-visible-setup-plan.json

@@ -0,0 +1,37 @@
+{
+  "name": "agent-run:visible-setup-agent",
+  "policy": {
+    "returnPartial": true,
+    "stopOnError": true
+  },
+  "steps": [
+    {
+      "command": "session.bootstrap",
+      "id": "bootstrap"
+    },
+    {
+      "command": "threads.new",
+      "id": "new"
+    },
+    {
+      "args": {
+        "read": false,
+        "text": "<chatgpt_browser_agent>\nAgent name: visible-setup-agent\nInstructions:\nMaintain a careful review checklist.\n</chatgpt_browser_agent>\n\nAcknowledge these visible setup instructions briefly, then wait for the next user request.",
+        "wait": true
+      },
+      "command": "messages.ask",
+      "id": "agent_setup"
+    },
+    {
+      "args": {
+        "read": {
+          "format": "markdown"
+        },
+        "text": "Review parity gates.",
+        "wait": true
+      },
+      "command": "messages.ask",
+      "id": "ask"
+    }
+  ]
+}

package/contracts/v1/fixtures/stream-basic.ndjson

@@ -0,0 +1,3 @@
+{"type":"run_item_stream_event","name":"thread_opened","item":{"type":"thread.opened","thread":{"url":"https://chatgpt.com/c/example-stream","conversationId":"example-stream"}}}
+{"type":"run_item_stream_event","name":"message_completed","item":{"type":"message.completed","role":"assistant","output_text":"hi","format":"markdown"}}
+{"type":"completed","result":{"ok":true,"status":"ok","output_text":"hi","finalOutput":"hi","output":[],"newItems":[],"interruptions":[],"state":{"id":"state-stream-basic","resumable":false},"activeAgentName":"reviewer","lastAgentName":"reviewer","warnings":[],"context":{"timestamp":"2026-06-05T00:00:00.000Z"}}}

package/contracts/v1/fixtures/stream-blocked.ndjson

@@ -0,0 +1,2 @@
+{"item":{"blocker":{"code":"codex_chrome_bridge_unavailable","kind":"browser_bridge_unavailable","message":"Codex cannot access the ChatGPT browser bridge from this backend process. In an ordinary shell this is expected; for a live Codex Chrome run, bootstrap the Chrome plugin runtime with setupBrowserRuntime({ globals: globalThis }) before using globalThis.agent.","remediation":[{"instruction":"Treat browser_bridge_unavailable from a plain shell as an expected protocol/blocker-path result, not proof that Chrome, ChatGPT, or the Codex extension is broken.","label":"Ordinary shell","userActionRequired":false},{"instruction":"For a live run, initialize the Chrome plugin runtime in node_repl with setupBrowserRuntime({ globals: globalThis }), then set globalThis.browser = await agent.browsers.get(\"extension\") before calling createChatGPT({ agent: globalThis.agent }).","label":"Codex Chrome bootstrap","userActionRequired":false},{"instruction":"For Python browser-bridge smokes, keep the bridge-hosted Node backend JS execution alive and run scripts/http_stdio_relay.mjs with CHATGPT_BROWSER_BACKEND_HTTP_URL; a plain Python-spawned Node subprocess cannot inherit globalThis.agent.","label":"Python live bridge","userActionRequired":false},{"instruction":"If this command was already running inside a bootstrapped bridge host, verify the Codex Chrome extension is installed and enabled, then restart Chrome or Codex before retrying.","label":"Extension availability","userActionRequired":true}],"resumable":false},"type":"run.blocked"},"name":"run_blocked","requestId":"req_runner_stream","schemaVersion":"chatgpt.browser_control.backend_event.v1","type":"run_item_stream_event"}
+{"requestId":"req_runner_stream","result":{"activeAgentName":"reviewer","blocker":{"code":"codex_chrome_bridge_unavailable","kind":"browser_bridge_unavailable","message":"Codex cannot access the ChatGPT browser bridge from this backend process. In an ordinary shell this is expected; for a live Codex Chrome run, bootstrap the Chrome plugin runtime with setupBrowserRuntime({ globals: globalThis }) before using globalThis.agent.","remediation":[{"instruction":"Treat browser_bridge_unavailable from a plain shell as an expected protocol/blocker-path result, not proof that Chrome, ChatGPT, or the Codex extension is broken.","label":"Ordinary shell","userActionRequired":false},{"instruction":"For a live run, initialize the Chrome plugin runtime in node_repl with setupBrowserRuntime({ globals: globalThis }), then set globalThis.browser = await agent.browsers.get(\"extension\") before calling createChatGPT({ agent: globalThis.agent }).","label":"Codex Chrome bootstrap","userActionRequired":false},{"instruction":"For Python browser-bridge smokes, keep the bridge-hosted Node backend JS execution alive and run scripts/http_stdio_relay.mjs with CHATGPT_BROWSER_BACKEND_HTTP_URL; a plain Python-spawned Node subprocess cannot inherit globalThis.agent.","label":"Python live bridge","userActionRequired":false},{"instruction":"If this command was already running inside a bootstrapped bridge host, verify the Codex Chrome extension is installed and enabled, then restart Chrome or Codex before retrying.","label":"Extension availability","userActionRequired":true}]},"context":{"timestamp":"2026-06-06T00:00:00.000Z"},"data":{"outputText":""},"error":{"message":"Codex cannot access the ChatGPT browser bridge from this backend process. In an ordinary shell this is expected; for a live Codex Chrome run, bootstrap the Chrome plugin runtime with setupBrowserRuntime({ globals: globalThis }) before using globalThis.agent.","name":"BrowserBridgeUnavailableError","recoverable":true},"interruptions":[{"blocker":{"code":"codex_chrome_bridge_unavailable","kind":"browser_bridge_unavailable","message":"Codex cannot access the ChatGPT browser bridge from this backend process. In an ordinary shell this is expected; for a live Codex Chrome run, bootstrap the Chrome plugin runtime with setupBrowserRuntime({ globals: globalThis }) before using globalThis.agent.","remediation":[{"instruction":"Treat browser_bridge_unavailable from a plain shell as an expected protocol/blocker-path result, not proof that Chrome, ChatGPT, or the Codex extension is broken.","label":"Ordinary shell","userActionRequired":false},{"instruction":"For a live run, initialize the Chrome plugin runtime in node_repl with setupBrowserRuntime({ globals: globalThis }), then set globalThis.browser = await agent.browsers.get(\"extension\") before calling createChatGPT({ agent: globalThis.agent }).","label":"Codex Chrome bootstrap","userActionRequired":false},{"instruction":"For Python browser-bridge smokes, keep the bridge-hosted Node backend JS execution alive and run scripts/http_stdio_relay.mjs with CHATGPT_BROWSER_BACKEND_HTTP_URL; a plain Python-spawned Node subprocess cannot inherit globalThis.agent.","label":"Python live bridge","userActionRequired":false},{"instruction":"If this command was already running inside a bootstrapped bridge host, verify the Codex Chrome extension is installed and enabled, then restart Chrome or Codex before retrying.","label":"Extension availability","userActionRequired":true}],"resumable":false},"command":"session.bootstrap","fix":{"steps":["Treat browser_bridge_unavailable from a plain shell as an expected protocol/blocker-path result, not proof that Chrome, ChatGPT, or the Codex extension is broken.","For a live run, initialize the Chrome plugin runtime in node_repl with setupBrowserRuntime({ globals: globalThis }), then set globalThis.browser = await agent.browsers.get(\"extension\") before calling createChatGPT({ agent: globalThis.agent }).","For Python browser-bridge smokes, keep the bridge-hosted Node backend JS execution alive and run scripts/http_stdio_relay.mjs with CHATGPT_BROWSER_BACKEND_HTTP_URL; a plain Python-spawned Node subprocess cannot inherit globalThis.agent.","If this command was already running inside a bootstrapped bridge host, verify the Codex Chrome extension is installed and enabled, then restart Chrome or Codex before retrying."],"summary":"Resolve the reported blocker before resuming."},"id":"interruption_fixed","message":"Codex cannot access the ChatGPT browser bridge from this backend process. In an ordinary shell this is expected; for a live Codex Chrome run, bootstrap the Chrome plugin runtime with setupBrowserRuntime({ globals: globalThis }) before using globalThis.agent.","resume":{"reason":"The underlying browser-control command did not mark this blocker as resumable.","supported":false},"status":"partial","type":"unsupported"}],"lastAgentName":"reviewer","newItems":[{"blocker":{"code":"codex_chrome_bridge_unavailable","kind":"browser_bridge_unavailable","message":"Codex cannot access the ChatGPT browser bridge from this backend process. In an ordinary shell this is expected; for a live Codex Chrome run, bootstrap the Chrome plugin runtime with setupBrowserRuntime({ globals: globalThis }) before using globalThis.agent.","remediation":[{"instruction":"Treat browser_bridge_unavailable from a plain shell as an expected protocol/blocker-path result, not proof that Chrome, ChatGPT, or the Codex extension is broken.","label":"Ordinary shell","userActionRequired":false},{"instruction":"For a live run, initialize the Chrome plugin runtime in node_repl with setupBrowserRuntime({ globals: globalThis }), then set globalThis.browser = await agent.browsers.get(\"extension\") before calling createChatGPT({ agent: globalThis.agent }).","label":"Codex Chrome bootstrap","userActionRequired":false},{"instruction":"For Python browser-bridge smokes, keep the bridge-hosted Node backend JS execution alive and run scripts/http_stdio_relay.mjs with CHATGPT_BROWSER_BACKEND_HTTP_URL; a plain Python-spawned Node subprocess cannot inherit globalThis.agent.","label":"Python live bridge","userActionRequired":false},{"instruction":"If this command was already running inside a bootstrapped bridge host, verify the Codex Chrome extension is installed and enabled, then restart Chrome or Codex before retrying.","label":"Extension availability","userActionRequired":true}],"resumable":false},"type":"run.blocked"}],"ok":false,"output":[{"blocker":{"code":"codex_chrome_bridge_unavailable","kind":"browser_bridge_unavailable","message":"Codex cannot access the ChatGPT browser bridge from this backend process. In an ordinary shell this is expected; for a live Codex Chrome run, bootstrap the Chrome plugin runtime with setupBrowserRuntime({ globals: globalThis }) before using globalThis.agent.","remediation":[{"instruction":"Treat browser_bridge_unavailable from a plain shell as an expected protocol/blocker-path result, not proof that Chrome, ChatGPT, or the Codex extension is broken.","label":"Ordinary shell","userActionRequired":false},{"instruction":"For a live run, initialize the Chrome plugin runtime in node_repl with setupBrowserRuntime({ globals: globalThis }), then set globalThis.browser = await agent.browsers.get(\"extension\") before calling createChatGPT({ agent: globalThis.agent }).","label":"Codex Chrome bootstrap","userActionRequired":false},{"instruction":"For Python browser-bridge smokes, keep the bridge-hosted Node backend JS execution alive and run scripts/http_stdio_relay.mjs with CHATGPT_BROWSER_BACKEND_HTTP_URL; a plain Python-spawned Node subprocess cannot inherit globalThis.agent.","label":"Python live bridge","userActionRequired":false},{"instruction":"If this command was already running inside a bootstrapped bridge host, verify the Codex Chrome extension is installed and enabled, then restart Chrome or Codex before retrying.","label":"Extension availability","userActionRequired":true}],"resumable":false},"type":"run.blocked"}],"output_text":"","state":{"id":"run_fixed","resumable":false},"status":"partial","steps":[{"command":"session.bootstrap","endedAt":"2026-06-06T00:00:00.000Z","id":"bootstrap","ok":false,"startedAt":"2026-06-06T00:00:00.000Z","status":"blocked","warnings":[]}],"warnings":[]},"schemaVersion":"chatgpt.browser_control.backend_event.v1","type":"completed"}

package/contracts/v1/fixtures/stream-submitted-completed.ndjson

@@ -0,0 +1,3 @@
+{"item":{"preview":"Return the word done.","redacted":true,"role":"user","type":"message.submitted"},"name":"message_submitted","requestId":"req_runner_stream","schemaVersion":"chatgpt.browser_control.backend_event.v1","type":"run_item_stream_event"}
+{"item":{"format":"markdown","output_text":"done","role":"assistant","type":"message.completed"},"name":"message_completed","requestId":"req_runner_stream","schemaVersion":"chatgpt.browser_control.backend_event.v1","type":"run_item_stream_event"}
+{"requestId":"req_runner_stream","result":{"activeAgentName":"stream-agent","context":{"assistantTurnCount":1,"timestamp":"2026-06-06T00:00:00.000Z","title":"ChatGPT","turnCount":2,"url":"https://chatgpt.com/"},"data":{"finalOutput":"done","outputText":"done","thread":{"title":"ChatGPT","url":"https://chatgpt.com/"}},"finalOutput":"done","interruptions":[],"lastAgentName":"stream-agent","newItems":[{"preview":"Return the word done.","redacted":true,"role":"user","type":"message.submitted"},{"format":"markdown","output_text":"done","role":"assistant","type":"message.completed"}],"ok":true,"output":[{"preview":"Return the word done.","redacted":true,"role":"user","type":"message.submitted"},{"format":"markdown","output_text":"done","role":"assistant","type":"message.completed"}],"output_text":"done","state":{"id":"run_fixed","resumable":false,"thread":{"title":"ChatGPT","url":"https://chatgpt.com/"}},"status":"ok","steps":[{"command":"session.bootstrap","dataPreview":{"browserName":"chrome","loggedIn":true,"tabId":"unknown","url":"https://chatgpt.com/"},"endedAt":"2026-06-06T00:00:00.000Z","id":"bootstrap","ok":true,"startedAt":"2026-06-06T00:00:00.000Z","status":"ok","warnings":[]},{"command":"threads.new","dataPreview":{"title":"ChatGPT","url":"https://chatgpt.com/"},"endedAt":"2026-06-06T00:00:00.000Z","id":"new","ok":true,"startedAt":"2026-06-06T00:00:00.000Z","status":"ok","warnings":[]},{"command":"messages.ask","dataPreview":{"complete":true,"prompt":"Return the word done.","responseText":"done","title":"ChatGPT"},"endedAt":"2026-06-06T00:00:00.000Z","id":"ask","ok":true,"startedAt":"2026-06-06T00:00:00.000Z","status":"ok","warnings":[]}],"warnings":[]},"schemaVersion":"chatgpt.browser_control.backend_event.v1","type":"completed"}

package/contracts/v1/fixtures/workflow-ask-success.json

@@ -0,0 +1,67 @@
+{
+  "result": {
+    "context": {
+      "assistantTurnCount": 1,
+      "timestamp": "2026-06-06T00:00:00.000Z",
+      "title": "ChatGPT",
+      "turnCount": 2,
+      "url": "https://chatgpt.com/"
+    },
+    "data": {
+      "complete": true,
+      "prompt": "Reply with hi.",
+      "responseText": "hi",
+      "title": "ChatGPT"
+    },
+    "ok": true,
+    "output_text": "hi",
+    "status": "ok",
+    "steps": [
+      {
+        "command": "session.bootstrap",
+        "dataPreview": {
+          "browserName": "chrome",
+          "loggedIn": true,
+          "tabId": "unknown",
+          "url": "https://chatgpt.com/"
+        },
+        "endedAt": "2026-06-06T00:00:00.000Z",
+        "id": "bootstrap",
+        "ok": true,
+        "startedAt": "2026-06-06T00:00:00.000Z",
+        "status": "ok",
+        "warnings": []
+      },
+      {
+        "command": "threads.new",
+        "dataPreview": {
+          "title": "ChatGPT",
+          "url": "https://chatgpt.com/"
+        },
+        "endedAt": "2026-06-06T00:00:00.000Z",
+        "id": "new",
+        "ok": true,
+        "startedAt": "2026-06-06T00:00:00.000Z",
+        "status": "ok",
+        "warnings": []
+      },
+      {
+        "command": "messages.ask",
+        "dataPreview": {
+          "complete": true,
+          "prompt": "Reply with hi.",
+          "responseText": "hi",
+          "title": "ChatGPT"
+        },
+        "endedAt": "2026-06-06T00:00:00.000Z",
+        "id": "ask",
+        "ok": true,
+        "startedAt": "2026-06-06T00:00:00.000Z",
+        "status": "ok",
+        "warnings": []
+      }
+    ],
+    "warnings": []
+  },
+  "schemaVersion": "chatgpt.browser_control.command_result.v1"
+}

package/contracts/v1/manifest.json

@@ -0,0 +1,210 @@
+{
+  "contractVersion": "0.1.0",
+  "fixtures": [
+    {
+      "case": "backend_capabilities",
+      "file": "backend-capabilities.json",
+      "schema": "capabilities"
+    },
+    {
+      "case": "backend_error_event_missing_stream_input",
+      "file": "backend-error-event-missing-stream-input.json",
+      "schema": "backendEvent"
+    },
+    {
+      "case": "backend_error_missing_run_input",
+      "file": "backend-error-missing-run-input.json",
+      "schema": "backendResponse"
+    },
+    {
+      "case": "backend_runner_plan_request",
+      "file": "backend-runner-plan-request.json",
+      "schema": "backendRequest"
+    },
+    {
+      "case": "backend_version",
+      "file": "backend-version.json",
+      "schema": "backendResponse"
+    },
+    {
+      "case": "command_descriptors",
+      "file": "command-descriptors.json",
+      "schema": "backendResponse"
+    },
+    {
+      "case": "describe_runner_run",
+      "file": "describe-runner-run.json",
+      "schema": "commandDescriptor"
+    },
+    {
+      "case": "doctor_bridge_upload",
+      "file": "doctor-bridge-upload.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "help_root",
+      "file": "help-root.json",
+      "schema": "backendResponse"
+    },
+    {
+      "case": "named_plan_two_turn",
+      "file": "named-plan-two-turn.json",
+      "schema": "sequencePlan"
+    },
+    {
+      "case": "output_json_parse_success",
+      "file": "output-json-parse-success.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "primitive_bootstrap_blocker",
+      "file": "primitive-bootstrap-blocker.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "report_redaction_default",
+      "file": "report-redaction-default.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "reports_create_redacted",
+      "file": "reports-create-redacted.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "reports_summarize_redacted",
+      "file": "reports-summarize-redacted.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "responses_basic_success",
+      "file": "responses-basic-success.json",
+      "schema": "response"
+    },
+    {
+      "case": "responses_hidden_instructions_unsupported",
+      "file": "responses-hidden-instructions-unsupported.json",
+      "schema": "response"
+    },
+    {
+      "case": "responses_unknown_field_unsupported",
+      "file": "responses-unknown-field-unsupported.json",
+      "schema": "response"
+    },
+    {
+      "case": "responses_unsupported_previous_response_id",
+      "file": "responses-unsupported-previous-response-id.json",
+      "schema": "response"
+    },
+    {
+      "case": "responses_unsupported_temperature",
+      "file": "responses-unsupported-temperature.json",
+      "schema": "response"
+    },
+    {
+      "case": "run_basic_success",
+      "file": "run-basic-success.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "run_browser_bridge_blocker",
+      "file": "run-browser-bridge-blocker.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "run_file_attach_success",
+      "file": "run-file-attach-success.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "run_report_redacted",
+      "file": "run-report-redacted.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "run_selector_drift_blocker",
+      "file": "run-selector-drift-blocker.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "run_timeout_partial",
+      "file": "run-timeout-partial.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "run_two_turn_success",
+      "file": "run-two-turn-success.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "run_upload_permission_blocker",
+      "file": "run-upload-permission-blocker.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "runner_budget_blocker",
+      "file": "runner-budget-blocker.json",
+      "schema": "runResult"
+    },
+    {
+      "case": "runner_full_agent_config",
+      "file": "runner-full-agent-config.json",
+      "schema": "agent"
+    },
+    {
+      "case": "runner_input_items_and_files",
+      "file": "runner-input-items-and-files-plan.json",
+      "schema": "sequencePlan"
+    },
+    {
+      "case": "runner_metadata_only_plan",
+      "file": "runner-metadata-only-plan.json",
+      "schema": "sequencePlan"
+    },
+    {
+      "case": "runner_visible_prefix_plan",
+      "file": "runner-visible-prefix-plan.json",
+      "schema": "sequencePlan"
+    },
+    {
+      "case": "runner_visible_setup_plan",
+      "file": "runner-visible-setup-plan.json",
+      "schema": "sequencePlan"
+    },
+    {
+      "case": "stream_basic",
+      "file": "stream-basic.ndjson",
+      "schema": "streamEvent"
+    },
+    {
+      "case": "stream_blocked",
+      "file": "stream-blocked.ndjson",
+      "schema": "backendEvent"
+    },
+    {
+      "case": "stream_submitted_completed",
+      "file": "stream-submitted-completed.ndjson",
+      "schema": "backendEvent"
+    },
+    {
+      "case": "workflow_ask_success",
+      "file": "workflow-ask-success.json",
+      "schema": "commandResult"
+    }
+  ],
+  "schemas": {
+    "agent": "schemas/agent.schema.json",
+    "backendEvent": "schemas/backend-event.schema.json",
+    "backendRequest": "schemas/backend-request.schema.json",
+    "backendResponse": "schemas/backend-response.schema.json",
+    "capabilities": "schemas/capabilities.schema.json",
+    "commandDescriptor": "schemas/command-descriptor.schema.json",
+    "commandResult": "schemas/command-result.schema.json",
+    "response": "schemas/response.schema.json",
+    "runResult": "schemas/run-result.schema.json",
+    "sequencePlan": "schemas/sequence-plan.schema.json",
+    "streamEvent": "schemas/stream-event.schema.json"
+  },
+  "schemaVersion": "chatgpt.browser_control.contract_manifest.v1",
+  "wireCase": "camelCaseWithDocumentedAliases"
+}