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

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",
@@ -96,6 +101,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 +414,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",

package/contracts/v1/parity-suite.json

@@ -1,12 +1,13 @@
 {
   "schemaVersion": "chatgpt.browser_control.parity_suite.v1",
-  "contractVersion": "0.1.0",
+  "contractVersion": "0.2.0",
   "surfaces": [
     {
       "id": "backend-protocol",
       "summary": "Backend request, response, event, capability, and protocol-error envelopes.",
       "fixtures": [
         "backend-capabilities.json",
+        "backend-compatibility.json",
         "backend-error-event-missing-stream-input.json",
         "backend-error-missing-run-input.json",
         "backend-runner-plan-request.json",
@@ -309,6 +310,66 @@
         "references/2026-07-16-chat-work-surfaces.md",
         "../../README.md"
       ]
+    },
+    {
+      "id": "transactional-operations-contract",
+      "summary": "Versioned transactional operation requests, handles, state, action intent, recovery, blockers, terminal ownership, artifact receipts, and strict result envelopes.",
+      "fixtures": [
+        "operation-action.json",
+        "operation-artifact-receipt.json",
+        "operation-artifact-transfer-intent-event.json",
+        "operation-artifact-transfer-receipt-event.json",
+        "operation-artifact-transfer-state.json",
+        "operation-blocker.json",
+        "operation-collect-request.json",
+        "operation-control-receipt.json",
+        "operation-control-request.json",
+        "operation-collect-result.json",
+        "operation-control-result.json",
+        "operation-action-prepared-event.json",
+        "operation-event.json",
+        "operation-ownership-baseline-event.json",
+        "operation-handle.json",
+        "operation-inspect-request.json",
+        "operation-inspect-result.json",
+        "operation-receipt.json",
+        "operation-recovery-decision.json",
+        "operation-recovery-observation.json",
+        "operation-request.json",
+        "operation-state.json",
+        "operation-submission-witness.json",
+        "operation-submission-witness-event.json",
+        "operation-target-established-event.json",
+        "operation-submit-result.json"
+      ],
+      "sourceFiles": [
+        "src/operations/types.ts",
+        "src/operations/state-machine.ts",
+        "src/operations/artifact-transfer.ts",
+        "src/operations/turn-ownership.ts",
+        "src/operations/submission.ts",
+        "src/operations/journal.ts",
+        "src/operations/handle.ts",
+        "src/operations/recovery.ts",
+        "src/operations/wire-results.ts"
+      ],
+      "nodeTests": [
+        "tests/unit/operations-state-machine.test.ts",
+        "tests/unit/operations-artifact-transfer.test.ts",
+        "tests/unit/operations-turn-ownership.test.ts",
+        "tests/unit/operations-durable-baseline.test.ts",
+        "tests/unit/operations-submission.test.ts",
+        "tests/unit/operations-handle.test.ts",
+        "tests/unit/operations-recovery.test.ts",
+        "tests/unit/operations-wire-results.test.ts"
+      ],
+      "pythonTests": [
+        "tests/test_operation_models.py"
+      ],
+      "docs": [
+        "references/2026-08-16-transactional-operations.md",
+        "references/backend-protocol.md"
+      ]
     }
   ],
   "backendCommands": {
@@ -333,6 +394,12 @@
       "pythonTests": ["tests/test_cross_language_conformance.py", "tests/test_backend_client.py"],
       "docs": ["references/backend-protocol.md", "references/python-parity.md"]
     },
+    "backend.hello": {
+      "surface": "backend-protocol",
+      "nodeTests": ["tests/unit/backend-dispatch.test.ts", "tests/unit/backend-protocol.test.ts", "tests/unit/backend-client.test.ts"],
+      "pythonTests": ["tests/test_cross_language_conformance.py", "tests/test_backend_client.py"],
+      "docs": ["references/backend-protocol.md", "references/python-parity.md"]
+    },
     "runner.run": {
       "surface": "runner-results-streams",
       "fixtures": ["run-basic-success.json", "runner-budget-blocker.json", "run-browser-bridge-blocker.json"],
@@ -627,6 +694,34 @@
       "pythonTests": ["tests/test_primitives.py", "tests/test_async_client.py"],
       "docs": ["references/backend-protocol.md", "references/troubleshooting.md", "references/python-parity.md"]
     },
+    "operations.submit": {
+      "surface": "transactional-operations-contract",
+      "fixtures": ["operation-request.json", "operation-submit-result.json"],
+      "nodeTests": ["tests/unit/backend-client.test.ts", "tests/unit/backend-dispatch.test.ts", "tests/unit/operations-wire-results.test.ts"],
+      "pythonTests": ["tests/test_operations_client.py", "tests/test_backend_client.py"],
+      "docs": ["references/backend-protocol.md", "references/python-parity.md", "references/2026-08-16-transactional-operations.md"]
+    },
+    "operations.collect": {
+      "surface": "transactional-operations-contract",
+      "fixtures": ["operation-collect-request.json", "operation-collect-result.json"],
+      "nodeTests": ["tests/unit/backend-client.test.ts", "tests/unit/backend-dispatch.test.ts", "tests/unit/operations-wire-requests.test.ts", "tests/unit/operations-wire-results.test.ts"],
+      "pythonTests": ["tests/test_operations_client.py", "tests/test_operation_models.py", "tests/test_backend_client.py"],
+      "docs": ["references/backend-protocol.md", "references/python-parity.md", "references/2026-08-16-transactional-operations.md"]
+    },
+    "operations.inspect": {
+      "surface": "transactional-operations-contract",
+      "fixtures": ["operation-inspect-request.json", "operation-inspect-result.json"],
+      "nodeTests": ["tests/unit/backend-client.test.ts", "tests/unit/backend-dispatch.test.ts", "tests/unit/operations-wire-results.test.ts"],
+      "pythonTests": ["tests/test_operations_client.py", "tests/test_backend_client.py"],
+      "docs": ["references/backend-protocol.md", "references/python-parity.md", "references/2026-08-16-transactional-operations.md"]
+    },
+    "operations.control": {
+      "surface": "transactional-operations-contract",
+      "fixtures": ["operation-control-request.json", "operation-control-result.json"],
+      "nodeTests": ["tests/unit/backend-client.test.ts", "tests/unit/backend-dispatch.test.ts", "tests/unit/operations-wire-results.test.ts"],
+      "pythonTests": ["tests/test_operations_client.py", "tests/test_backend_client.py"],
+      "docs": ["references/backend-protocol.md", "references/python-parity.md", "references/2026-08-16-transactional-operations.md"]
+    },
     "messages.waitAndRead": {
       "surface": "workflows-primitives-diagnostics",
       "fixtures": ["command-descriptors.json", "workflow-ask-success.json"],

package/contracts/v1/schemas/backend-compatibility.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://local.codex-chatgpt-control/contracts/v1/schemas/backend-compatibility.schema.json",
+  "title": "Negotiated backend compatibility report",
+  "description": "A bounded, redacted report retained by the lifecycle-owned backend transport.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "mode", "warnings"],
+  "properties": {
+    "schemaVersion": {
+      "const": "chatgpt.browser_control.backend_compatibility.v1"
+    },
+    "status": {
+      "enum": ["compatible", "warning", "unknown", "blocked"]
+    },
+    "mode": {
+      "enum": ["multiplexed", "single-flight", "legacy", "unknown"]
+    },
+    "protocolVersion": { "$ref": "#/$defs/text" },
+    "backendSessionId": { "$ref": "#/$defs/text" },
+    "packageName": { "$ref": "#/$defs/text" },
+    "packageVersion": { "$ref": "#/$defs/text" },
+    "runtime": { "$ref": "#/$defs/text" },
+    "runtimeVersion": { "$ref": "#/$defs/text" },
+    "buildDigest": { "$ref": "#/$defs/text" },
+    "warnings": {
+      "type": "array",
+      "maxItems": 16,
+      "items": { "$ref": "#/$defs/warning" }
+    }
+  },
+  "$defs": {
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?=.*\\S)[^\\u0000-\\u001f\\u007f]{1,512}$"
+    },
+    "warning": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": {
+          "enum": [
+            "package_name_mismatch",
+            "package_version_mismatch",
+            "runtime_mismatch",
+            "runtime_version_mismatch",
+            "build_digest_mismatch",
+            "provenance_unknown",
+            "legacy_backend",
+            "negotiation_rejected"
+          ]
+        },
+        "field": {
+          "enum": ["packageName", "packageVersion", "runtime", "runtimeVersion", "buildDigest"]
+        },
+        "expected": { "$ref": "#/$defs/text" },
+        "received": { "$ref": "#/$defs/text" },
+        "message": { "$ref": "#/$defs/text" }
+      }
+    }
+  }
+}

package/contracts/v1/schemas/backend-request.schema.json

@@ -6,12 +6,13 @@
   "additionalProperties": false,
   "properties": {
     "schemaVersion": { "const": "chatgpt.browser_control.backend_request.v1" },
-    "requestId": { "type": "string", "minLength": 1 },
+    "requestId": { "type": "string", "minLength": 1, "maxLength": 4096 },
     "command": {
       "enum": [
         "backend.version",
         "backend.health",
         "backend.capabilities",
+        "backend.hello",
         "runner.run",
         "runner.plan",
         "runner.stream",
@@ -53,6 +54,7 @@
         "messages.wait",
         "messages.readLatest",
         "messages.status",
+        "messages.stop",
         "messages.waitAndRead",
         "artifacts.listLatest",
         "artifacts.wait",
@@ -66,7 +68,11 @@
         "modes.set",
         "modes.get",
         "tools.select",
-        "response.copy"
+        "response.copy",
+        "operations.submit",
+        "operations.collect",
+        "operations.inspect",
+        "operations.control"
       ]
     },
     "payload": {

package/contracts/v1/schemas/capabilities.schema.json

@@ -2,10 +2,37 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://local.codex-chatgpt-control/contracts/v1/capabilities.schema.json",
   "type": "object",
-  "required": ["protocolVersion", "commands", "transports", "streaming"],
+  "required": [
+    "protocolVersion",
+    "backendSessionId",
+    "packageName",
+    "packageVersion",
+    "runtime",
+    "runtimeVersion",
+    "buildDigest",
+    "supportedProtocolVersions",
+    "commands",
+    "transports",
+    "streaming",
+    "requestIds",
+    "multiplexing",
+    "cancellation",
+    "tabs"
+  ],
   "additionalProperties": false,
   "properties": {
     "protocolVersion": { "const": "chatgpt.browser_control.backend_request.v1" },
+    "backendSessionId": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "packageName": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "packageVersion": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "runtime": { "const": "node" },
+    "runtimeVersion": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "buildDigest": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "supportedProtocolVersions": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
     "commands": {
       "type": "array",
       "minItems": 1,
@@ -28,6 +55,59 @@
         },
         "tokenDeltas": { "const": false }
       }
+    },
+    "requestIds": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["required", "scope"],
+      "properties": {
+        "required": { "type": "boolean" },
+        "scope": { "enum": ["connection", "process", "none"] }
+      }
+    },
+    "multiplexing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["unary", "streams"],
+      "properties": {
+        "unary": { "type": "boolean" },
+        "streams": { "type": "boolean" }
+      }
+    },
+    "cancellation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["supported", "requests", "streams"],
+      "properties": {
+        "supported": { "type": "boolean" },
+        "requests": { "type": "boolean" },
+        "streams": { "type": "boolean" }
+      }
+    },
+    "tabs": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "stableProviderIdentity",
+        "stableBrowserIdentity",
+        "stableTabIdentity",
+        "coordinationScope",
+        "authoritativeClaim",
+        "fencing",
+        "concurrentTabs"
+      ],
+      "properties": {
+        "stableProviderIdentity": { "type": "boolean" },
+        "stableBrowserIdentity": { "type": "boolean" },
+        "stableTabIdentity": { "type": "boolean" },
+        "coordinationScope": { "enum": ["none", "process", "provider"] },
+        "authoritativeClaim": { "type": "boolean" },
+        "fencing": { "type": "boolean" },
+        "concurrentTabs": { "type": "boolean" },
+        "stableIdentity": { "type": "boolean" },
+        "coordination": { "type": "boolean" },
+        "concurrent": { "type": "boolean" }
+      }
     }
   }
 }

package/contracts/v1/schemas/manifest.schema.json

@@ -21,7 +21,26 @@
         "backendRequest",
         "backendResponse",
         "backendEvent",
+        "backendCompatibility",
         "capabilities",
+        "operationAction",
+        "operationArtifactReceipt",
+        "operationBlocker",
+        "operationCollectRequest",
+        "operationControlReceipt",
+        "operationControlRequest",
+        "operationEvent",
+        "operationHandle",
+        "operationInspectRequest",
+        "operationReceipt",
+        "operationRecovery",
+        "operationRequest",
+        "operationState",
+        "operationSubmissionWitness",
+        "operationSubmitResult",
+        "operationCollectResult",
+        "operationInspectResult",
+        "operationControlResult",
         "surfaceProfile"
       ],
       "additionalProperties": false,
@@ -36,7 +55,26 @@
         "backendRequest": { "type": "string", "minLength": 1 },
         "backendResponse": { "type": "string", "minLength": 1 },
         "backendEvent": { "type": "string", "minLength": 1 },
+        "backendCompatibility": { "type": "string", "minLength": 1 },
         "capabilities": { "type": "string", "minLength": 1 },
+        "operationAction": { "type": "string", "minLength": 1 },
+        "operationArtifactReceipt": { "type": "string", "minLength": 1 },
+        "operationBlocker": { "type": "string", "minLength": 1 },
+        "operationCollectRequest": { "type": "string", "minLength": 1 },
+        "operationControlReceipt": { "type": "string", "minLength": 1 },
+        "operationControlRequest": { "type": "string", "minLength": 1 },
+        "operationEvent": { "type": "string", "minLength": 1 },
+        "operationHandle": { "type": "string", "minLength": 1 },
+        "operationInspectRequest": { "type": "string", "minLength": 1 },
+        "operationReceipt": { "type": "string", "minLength": 1 },
+        "operationRecovery": { "type": "string", "minLength": 1 },
+        "operationRequest": { "type": "string", "minLength": 1 },
+        "operationState": { "type": "string", "minLength": 1 },
+        "operationSubmissionWitness": { "type": "string", "minLength": 1 },
+        "operationSubmitResult": { "type": "string", "minLength": 1 },
+        "operationCollectResult": { "type": "string", "minLength": 1 },
+        "operationInspectResult": { "type": "string", "minLength": 1 },
+        "operationControlResult": { "type": "string", "minLength": 1 },
         "surfaceProfile": { "type": "string", "minLength": 1 }
       }
     },
@@ -60,7 +98,26 @@
               "backendRequest",
               "backendResponse",
               "backendEvent",
+              "backendCompatibility",
               "capabilities",
+              "operationAction",
+              "operationArtifactReceipt",
+              "operationBlocker",
+              "operationCollectRequest",
+              "operationControlReceipt",
+              "operationControlRequest",
+              "operationEvent",
+              "operationHandle",
+              "operationInspectRequest",
+              "operationReceipt",
+              "operationRecovery",
+              "operationRequest",
+              "operationState",
+              "operationSubmissionWitness",
+              "operationSubmitResult",
+              "operationCollectResult",
+              "operationInspectResult",
+              "operationControlResult",
               "surfaceProfile"
             ]
           },