codex-chatgpt-control 0.5.1-alpha.2 → 0.5.1-alpha.4

package/contracts/v1/fixtures/operation-recovery-observation.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": "chatgpt.browser_control.operation_recovery_observation.v1",
+  "target": {
+    "status": "matches"
+  },
+  "turn": {
+    "status": "owned_assistant_terminal",
+    "userTurnId": "user-turn-1",
+    "assistantTurnId": "assistant-turn-1",
+    "evidenceDigest": "hmac-sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
+  }
+}

package/contracts/v1/fixtures/operation-request.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "chatgpt.browser_control.operation_request.v1",
+  "operationId": "11111111-1111-4111-8111-111111111111",
+  "surface": "chat",
+  "prompt": "Summarize the attached report.",
+  "target": {
+    "type": "conversation_id",
+    "conversationId": "conversation-1"
+  },
+  "configuration": {
+    "experience": "chat",
+    "model": "model-family",
+    "modelVersion": "model-version",
+    "reasoning": "medium",
+    "mode": "default",
+    "tools": ["web"],
+    "additional": {
+      "temperatureHint": 0.2
+    }
+  },
+  "files": [
+    {
+      "path": "/tmp/example.txt",
+      "displayName": "example.txt"
+    }
+  ],
+  "capture": {
+    "responseContent": "metadata",
+    "responseFormat": "markdown",
+    "artifacts": "receipt_only"
+  },
+  "timeoutMs": 30000
+}

package/contracts/v1/fixtures/operation-state.json

@@ -0,0 +1,144 @@
+{
+  "schemaVersion": "chatgpt.browser_control.operation.v1",
+  "operationId": "11111111-1111-4111-8111-111111111111",
+  "requestDigest": "hmac-sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "surface": "chat",
+  "phase": "completed",
+  "mutationBoundary": "send_may_have_occurred",
+  "revision": 10,
+  "createdAt": "2026-08-16T00:00:00.000Z",
+  "updatedAt": "2026-08-16T00:00:03.000Z",
+  "capturePolicy": {
+    "responseContent": "metadata",
+    "responseFormat": "markdown",
+    "artifacts": "receipt_only"
+  },
+  "responseFormat": "markdown",
+  "target": {
+    "providerId": "chrome",
+    "browserId": "browser-1",
+    "tabId": "tab-1",
+    "coordinationScope": "process",
+    "canonicalThreadUrl": "https://chatgpt.com/c/sanitized",
+    "conversationId": "conversation-1",
+    "userTurnBaselineDigest": "hmac-sha256:1111111111111111111111111111111111111111111111111111111111111111",
+    "assistantTurnBaselineDigest": "hmac-sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "configurationReceiptDigest": "hmac-sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "evidenceProfile": {
+      "providerIdentity": "required",
+      "stableTabId": "required",
+      "stableConversationId": "required",
+      "stableUserTurnId": "required",
+      "authoritativeTabClaim": "unavailable",
+      "replacementTabRecovery": true
+    }
+  },
+  "actions": {
+    "33333333-3333-4333-8333-333333333333": {
+      "actionId": "33333333-3333-4333-8333-333333333333",
+      "kind": "send",
+      "repeatPolicy": "observe_only_after_intent",
+      "requestDigest": "hmac-sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "targetDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "intentRevision": 6,
+      "intentAt": "2026-08-16T00:00:01.000Z",
+      "outcome": "satisfied",
+      "receiptRevision": 7,
+      "receiptAt": "2026-08-16T00:00:02.000Z",
+      "evidenceDigest": "hmac-sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+    }
+  },
+  "ownershipBaseline": {
+    "schemaVersion": "chatgpt.browser_control.operation_ownership_baseline.v1",
+    "operationId": "11111111-1111-4111-8111-111111111111",
+    "requestDigest": "hmac-sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "actionId": "33333333-3333-4333-8333-333333333333",
+    "baseline": {
+      "schemaVersion": "chatgpt.browser_control.turn_ownership.v1",
+      "snapshotDigest": "hmac-sha256:1212121212121212121212121212121212121212121212121212121212121212",
+      "target": {
+        "provider": { "status": "available", "value": "chrome" },
+        "browser": { "status": "available", "value": "browser-1" },
+        "tab": { "status": "available", "value": "tab-1" },
+        "thread": { "status": "available", "value": "conversation-1" },
+        "conversation": { "status": "available", "value": "conversation-1" },
+        "canonicalThreadUrl": { "status": "available", "value": "https://chatgpt.com/c/sanitized" },
+        "authoritativeTabClaim": { "status": "unavailable", "reason": "not_exposed" },
+        "coordinationScope": "process"
+      },
+      "userTurns": [],
+      "assistantTurns": [],
+      "completeness": "complete"
+    },
+    "observedAt": "2026-08-16T00:00:01.000Z"
+  },
+  "ownershipBaselines": {
+    "33333333-3333-4333-8333-333333333333": {
+      "schemaVersion": "chatgpt.browser_control.operation_ownership_baseline.v1",
+      "operationId": "11111111-1111-4111-8111-111111111111",
+      "requestDigest": "hmac-sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "actionId": "33333333-3333-4333-8333-333333333333",
+      "baseline": {
+        "schemaVersion": "chatgpt.browser_control.turn_ownership.v1",
+        "snapshotDigest": "hmac-sha256:1212121212121212121212121212121212121212121212121212121212121212",
+        "target": {
+          "provider": { "status": "available", "value": "chrome" },
+          "browser": { "status": "available", "value": "browser-1" },
+          "tab": { "status": "available", "value": "tab-1" },
+          "thread": { "status": "available", "value": "conversation-1" },
+          "conversation": { "status": "available", "value": "conversation-1" },
+          "canonicalThreadUrl": { "status": "available", "value": "https://chatgpt.com/c/sanitized" },
+          "authoritativeTabClaim": { "status": "unavailable", "reason": "not_exposed" },
+          "coordinationScope": "process"
+        },
+        "userTurns": [],
+        "assistantTurns": [],
+        "completeness": "complete"
+      },
+      "observedAt": "2026-08-16T00:00:01.000Z"
+    }
+  },
+  "submissionWitnesses": {
+    "33333333-3333-4333-8333-333333333333": {
+      "schemaVersion": "chatgpt.browser_control.operation_submission_witness.v1",
+      "actionId": "33333333-3333-4333-8333-333333333333",
+      "actionKind": "send",
+      "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "baselineSnapshotDigest": "hmac-sha256:1212121212121212121212121212121212121212121212121212121212121212",
+      "postSendDeltaDigest": "hmac-sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "operationUserEvidenceDigest": "hmac-sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "userTurnId": "user-turn-1",
+      "observedAt": "2026-08-16T00:00:02.000Z"
+    }
+  },
+  "submissionWitness": {
+    "schemaVersion": "chatgpt.browser_control.operation_submission_witness.v1",
+    "actionId": "33333333-3333-4333-8333-333333333333",
+    "actionKind": "send",
+    "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "baselineSnapshotDigest": "hmac-sha256:1212121212121212121212121212121212121212121212121212121212121212",
+    "postSendDeltaDigest": "hmac-sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+    "operationUserEvidenceDigest": "hmac-sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "userTurnId": "user-turn-1",
+    "observedAt": "2026-08-16T00:00:02.000Z"
+  },
+  "receipt": {
+    "schemaVersion": "chatgpt.browser_control.operation_receipt.v1",
+    "operationId": "11111111-1111-4111-8111-111111111111",
+    "requestDigest": "hmac-sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "userTurnId": "user-turn-1",
+    "userTurnEvidenceDigest": "hmac-sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "assistantTurnId": "assistant-turn-1",
+    "ownershipEvidenceDigest": "hmac-sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "responseDigest": "hmac-sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+    "responseBytes": 64,
+    "responseFormat": "markdown",
+    "finishReason": "stop",
+    "contentAvailable": false,
+    "artifacts": [],
+    "completedAt": "2026-08-16T00:00:03.000Z"
+  }
+}

package/contracts/v1/fixtures/operation-submission-witness-event.json

@@ -0,0 +1,20 @@
+{
+  "schemaVersion": "chatgpt.browser_control.operation_event.v1",
+  "revision": 8,
+  "previousEventDigest": "hmac-sha256:7777777777777777777777777777777777777777777777777777777777777777",
+  "eventDigest": "hmac-sha256:8888888888888888888888888888888888888888888888888888888888888888",
+  "event": {
+    "type": "submission_witness",
+    "witness": {
+      "schemaVersion": "chatgpt.browser_control.operation_submission_witness.v1",
+      "actionId": "33333333-3333-4333-8333-333333333333",
+      "actionKind": "send",
+      "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "baselineSnapshotDigest": "hmac-sha256:1212121212121212121212121212121212121212121212121212121212121212",
+      "postSendDeltaDigest": "hmac-sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "operationUserEvidenceDigest": "hmac-sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "userTurnId": "user-turn-1",
+      "observedAt": "2026-08-16T00:00:02.000Z"
+    }
+  }
+}

package/contracts/v1/fixtures/operation-submission-witness.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": "chatgpt.browser_control.operation_submission_witness.v1",
+  "actionId": "33333333-3333-4333-8333-333333333333",
+  "actionKind": "send",
+  "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+  "baselineSnapshotDigest": "hmac-sha256:1212121212121212121212121212121212121212121212121212121212121212",
+  "postSendDeltaDigest": "hmac-sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+  "operationUserEvidenceDigest": "hmac-sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+  "userTurnId": "user-turn-1",
+  "observedAt": "2026-08-16T00:00:02.000Z"
+}

package/contracts/v1/fixtures/operation-submit-result.json

@@ -0,0 +1,16 @@
+{
+  "handle": {
+    "mutationBoundary": "send_may_have_occurred",
+    "operationId": "11111111-1111-4111-8111-111111111111",
+    "phase": "submitted",
+    "requestDigest": "hmac-sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "revision": 4,
+    "schemaVersion": "chatgpt.browser_control.operation_handle.v1",
+    "surface": "chat",
+    "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+  },
+  "operationId": "11111111-1111-4111-8111-111111111111",
+  "requestDigest": "hmac-sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "schemaVersion": "chatgpt.browser_control.operation_submit_result.v1",
+  "status": "accepted"
+}

package/contracts/v1/fixtures/operation-target-established-event.json

@@ -0,0 +1,21 @@
+{
+  "schemaVersion": "chatgpt.browser_control.operation_event.v1",
+  "revision": 5,
+  "previousEventDigest": "hmac-sha256:4444444444444444444444444444444444444444444444444444444444444444",
+  "eventDigest": "hmac-sha256:5555555555555555555555555555555555555555555555555555555555555555",
+  "event": {
+    "type": "target_established",
+    "establishment": {
+      "targetBindingDigest": "hmac-sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "anchorDigest": "hmac-sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "causalSendActionId": "33333333-3333-4333-8333-333333333333",
+      "conversationId": "conversation-new",
+      "canonicalThreadUrl": "https://chatgpt.com/c/conversation-new",
+      "userTurnId": "user-turn-1",
+      "userTurnEvidenceDigest": "hmac-sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "postSendDeltaDigest": "hmac-sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "evidenceDigest": "hmac-sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+      "observedAt": "2026-08-16T00:00:02.000Z"
+    }
+  }
+}

package/contracts/v1/manifest.json

@@ -1,11 +1,16 @@
 {
-  "contractVersion": "0.1.0",
+  "contractVersion": "0.2.0",
   "fixtures": [
     {
       "case": "backend_capabilities",
       "file": "backend-capabilities.json",
       "schema": "capabilities"
     },
+    {
+      "case": "backend_compatibility",
+      "file": "backend-compatibility.json",
+      "schema": "backendCompatibility"
+    },
     {
       "case": "backend_error_event_missing_stream_input",
       "file": "backend-error-event-missing-stream-input.json",
@@ -51,6 +56,21 @@
       "file": "doctor-scenario-preflight.json",
       "schema": "commandResult"
     },
+    {
+      "case": "download_blocked_by_browser",
+      "file": "download-blocked-by-browser.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "download_receipt_failed",
+      "file": "download-receipt-failed.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "download_receipt_timeout",
+      "file": "download-receipt-timeout.json",
+      "schema": "commandResult"
+    },
     {
       "case": "existing_tab_diagnostics_blocker",
       "file": "existing-tab-diagnostics-blocker.json",
@@ -71,6 +91,21 @@
       "file": "help-root.json",
       "schema": "backendResponse"
     },
+    {
+      "case": "journal_rpc_indeterminate",
+      "file": "journal-rpc-indeterminate.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "journal_rpc_unsupported_platform",
+      "file": "journal-rpc-unsupported-platform.json",
+      "schema": "commandResult"
+    },
+    {
+      "case": "journal_runtime_unavailable",
+      "file": "journal-runtime-unavailable.json",
+      "schema": "commandResult"
+    },
     {
       "case": "messages_stop_indeterminate",
       "file": "messages-stop-indeterminate.json",
@@ -96,6 +131,136 @@
       "file": "named-plan-two-turn.json",
       "schema": "sequencePlan"
     },
+    {
+      "case": "operation_action_prepared_event",
+      "file": "operation-action-prepared-event.json",
+      "schema": "operationEvent"
+    },
+    {
+      "case": "operation_action",
+      "file": "operation-action.json",
+      "schema": "operationAction"
+    },
+    {
+      "case": "operation_artifact_receipt",
+      "file": "operation-artifact-receipt.json",
+      "schema": "operationArtifactReceipt"
+    },
+    {
+      "case": "operation_artifact_transfer_intent_event",
+      "file": "operation-artifact-transfer-intent-event.json",
+      "schema": "operationEvent"
+    },
+    {
+      "case": "operation_artifact_transfer_receipt_event",
+      "file": "operation-artifact-transfer-receipt-event.json",
+      "schema": "operationEvent"
+    },
+    {
+      "case": "operation_artifact_transfer_state",
+      "file": "operation-artifact-transfer-state.json",
+      "schema": "operationState"
+    },
+    {
+      "case": "operation_blocker",
+      "file": "operation-blocker.json",
+      "schema": "operationBlocker"
+    },
+    {
+      "case": "operation_collect_request",
+      "file": "operation-collect-request.json",
+      "schema": "operationCollectRequest"
+    },
+    {
+      "case": "operation_collect_result",
+      "file": "operation-collect-result.json",
+      "schema": "operationCollectResult"
+    },
+    {
+      "case": "operation_control_receipt",
+      "file": "operation-control-receipt.json",
+      "schema": "operationControlReceipt"
+    },
+    {
+      "case": "operation_control_request",
+      "file": "operation-control-request.json",
+      "schema": "operationControlRequest"
+    },
+    {
+      "case": "operation_control_result",
+      "file": "operation-control-result.json",
+      "schema": "operationControlResult"
+    },
+    {
+      "case": "operation_event",
+      "file": "operation-event.json",
+      "schema": "operationEvent"
+    },
+    {
+      "case": "operation_handle",
+      "file": "operation-handle.json",
+      "schema": "operationHandle"
+    },
+    {
+      "case": "operation_inspect_request",
+      "file": "operation-inspect-request.json",
+      "schema": "operationInspectRequest"
+    },
+    {
+      "case": "operation_inspect_result",
+      "file": "operation-inspect-result.json",
+      "schema": "operationInspectResult"
+    },
+    {
+      "case": "operation_ownership_baseline_event",
+      "file": "operation-ownership-baseline-event.json",
+      "schema": "operationEvent"
+    },
+    {
+      "case": "operation_receipt",
+      "file": "operation-receipt.json",
+      "schema": "operationReceipt"
+    },
+    {
+      "case": "operation_recovery_decision",
+      "file": "operation-recovery-decision.json",
+      "schema": "operationRecovery"
+    },
+    {
+      "case": "operation_recovery_observation",
+      "file": "operation-recovery-observation.json",
+      "schema": "operationRecovery"
+    },
+    {
+      "case": "operation_request",
+      "file": "operation-request.json",
+      "schema": "operationRequest"
+    },
+    {
+      "case": "operation_state",
+      "file": "operation-state.json",
+      "schema": "operationState"
+    },
+    {
+      "case": "operation_submission_witness_event",
+      "file": "operation-submission-witness-event.json",
+      "schema": "operationEvent"
+    },
+    {
+      "case": "operation_submission_witness",
+      "file": "operation-submission-witness.json",
+      "schema": "operationSubmissionWitness"
+    },
+    {
+      "case": "operation_submit_result",
+      "file": "operation-submit-result.json",
+      "schema": "operationSubmitResult"
+    },
+    {
+      "case": "operation_target_established_event",
+      "file": "operation-target-established-event.json",
+      "schema": "operationEvent"
+    },
     {
       "case": "output_json_parse_success",
       "file": "output-json-parse-success.json",
@@ -279,12 +444,31 @@
   ],
   "schemas": {
     "agent": "schemas/agent.schema.json",
+    "backendCompatibility": "schemas/backend-compatibility.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",
+    "operationAction": "schemas/operation-action.schema.json",
+    "operationArtifactReceipt": "schemas/operation-artifact-receipt.schema.json",
+    "operationBlocker": "schemas/operation-blocker.schema.json",
+    "operationCollectRequest": "schemas/operation-collect-request.schema.json",
+    "operationCollectResult": "schemas/operation-collect-result.schema.json",
+    "operationControlReceipt": "schemas/operation-control-receipt.schema.json",
+    "operationControlRequest": "schemas/operation-control-request.schema.json",
+    "operationControlResult": "schemas/operation-control-result.schema.json",
+    "operationEvent": "schemas/operation-event.schema.json",
+    "operationHandle": "schemas/operation-handle.schema.json",
+    "operationInspectRequest": "schemas/operation-inspect-request.schema.json",
+    "operationInspectResult": "schemas/operation-inspect-result.schema.json",
+    "operationReceipt": "schemas/operation-receipt.schema.json",
+    "operationRecovery": "schemas/operation-recovery.schema.json",
+    "operationRequest": "schemas/operation-request.schema.json",
+    "operationState": "schemas/operation-state.schema.json",
+    "operationSubmissionWitness": "schemas/operation-submission-witness.schema.json",
+    "operationSubmitResult": "schemas/operation-submit-result.schema.json",
     "response": "schemas/response.schema.json",
     "runResult": "schemas/run-result.schema.json",
     "sequencePlan": "schemas/sequence-plan.schema.json",