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

package/contracts/v1/schemas/operation-submission-witness.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://local.codex-chatgpt-control/contracts/v1/schemas/operation-submission-witness.schema.json",
+  "title": "Transactional browser operation submission witness",
+  "description": "A redacted immutable proof binding the sole Send or Work steer intent to the exact post-Send user-turn evidence.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "actionId",
+    "actionKind",
+    "targetBindingDigest",
+    "baselineSnapshotDigest",
+    "postSendDeltaDigest",
+    "operationUserEvidenceDigest",
+    "observedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "chatgpt.browser_control.operation_submission_witness.v1" },
+    "actionId": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+    },
+    "actionKind": { "enum": ["send", "work_steer"] },
+    "targetBindingDigest": { "$ref": "#/$defs/digest" },
+    "baselineSnapshotDigest": { "$ref": "#/$defs/digest" },
+    "postSendDeltaDigest": { "$ref": "#/$defs/digest" },
+    "operationUserEvidenceDigest": { "$ref": "#/$defs/digest" },
+    "userTurnId": { "$ref": "#/$defs/opaqueId" },
+    "observedAt": { "$ref": "#/$defs/instant" }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^hmac-sha256:[0-9a-f]{64}$"
+    },
+    "opaqueId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?=.*\\S)[^\\u0000-\\u001f\\u007f]{1,512}$"
+    },
+    "instant": {
+      "type": "string",
+      "pattern": "^(?!\\d{4}-02-(?:30|31)T)(?!\\d{4}-(?:04|06|09|11)-31T)\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}Z$"
+    }
+  }
+}

package/contracts/v1/schemas/operation-submit-result.schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://local.codex-chatgpt-control/contracts/v1/schemas/operation-submit-result.schema.json",
+  "title": "Transactional browser operation submit result",
+  "description": "A strict versioned submit envelope. Every result represents an existing durable operation and therefore carries the current handle; raw request content is never present.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "operationId", "requestDigest", "handle"],
+  "properties": {
+    "schemaVersion": { "const": "chatgpt.browser_control.operation_submit_result.v1" },
+    "status": { "enum": ["accepted", "completed", "blocked", "uncertain"] },
+    "operationId": { "$ref": "#/$defs/uuid" },
+    "requestDigest": { "$ref": "#/$defs/digest" },
+    "handle": { "$ref": "#/$defs/handle" },
+    "receipt": { "$ref": "#/$defs/receipt" },
+    "blocker": { "$ref": "#/$defs/blocker" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "completed" } }, "required": ["status"] },
+      "then": { "required": ["receipt"], "properties": { "receipt": { "$ref": "#/$defs/receipt" }, "blocker": false } }
+    },
+    {
+      "if": { "properties": { "status": { "enum": ["blocked", "uncertain"] } }, "required": ["status"] },
+      "then": { "required": ["blocker"], "properties": { "blocker": { "$ref": "#/$defs/blocker" }, "receipt": false } }
+    },
+    {
+      "if": { "properties": { "status": { "const": "accepted" } }, "required": ["status"] },
+      "then": { "properties": { "receipt": false, "blocker": false } }
+    }
+  ],
+  "$defs": {
+    "uuid": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+    "digest": { "type": "string", "pattern": "^hmac-sha256:[0-9a-f]{64}$" },
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "instant": { "type": "string", "pattern": "^(?!\\d{4}-02-(?:30|31)T)(?!\\d{4}-(?:04|06|09|11)-31T)\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}Z$" },
+    "opaqueId": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^(?=.*\\S)[^\\u0000-\\u001f\\u007f]{1,512}$" },
+    "handle": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaVersion", "operationId", "requestDigest", "surface", "revision", "phase", "mutationBoundary"],
+      "properties": {
+        "schemaVersion": { "const": "chatgpt.browser_control.operation_handle.v1" },
+        "operationId": { "$ref": "#/$defs/uuid" }, "requestDigest": { "$ref": "#/$defs/digest" },
+        "surface": { "enum": ["chat", "work"] }, "revision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "phase": { "$ref": "#/$defs/phase" }, "mutationBoundary": { "$ref": "#/$defs/boundary" },
+        "targetBindingDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "phase": { "enum": ["prepared", "handoff_pending", "ready", "send_pending", "submitted", "generating", "capturing", "completed", "uncertain"] },
+    "boundary": { "enum": ["none", "handoff_may_have_occurred", "send_may_have_occurred", "control_may_have_occurred"] },
+    "artifact": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaVersion", "operationId", "artifactKey", "assistantTurnId", "sourceIdentityDigest", "kind", "ordinal", "status"],
+      "properties": {
+        "schemaVersion": { "const": "chatgpt.browser_control.operation_artifact_receipt.v1" }, "operationId": { "$ref": "#/$defs/uuid" },
+        "artifactKey": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$" },
+        "assistantTurnId": { "$ref": "#/$defs/opaqueId" }, "sourceIdentityDigest": { "$ref": "#/$defs/digest" },
+        "kind": { "enum": ["file", "image", "other"] }, "ordinal": { "type": "integer", "minimum": 0, "maximum": 31 },
+        "outputKey": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$" },
+        "mimeType": { "type": "string", "minLength": 1, "maxLength": 127, "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+/-]{0,126}$" },
+        "bytes": { "type": "integer", "minimum": 0, "maximum": 8388608 }, "sha256": { "$ref": "#/$defs/sha256" },
+        "status": { "enum": ["available", "transferred", "partial", "blocked"] }, "blockerCode": { "$ref": "#/$defs/code" }
+      },
+      "allOf": [
+        { "if": { "properties": { "status": { "const": "transferred" } }, "required": ["status"] }, "then": { "required": ["outputKey", "bytes", "sha256"], "properties": { "outputKey": { "type": "string" }, "bytes": { "type": "integer" }, "sha256": { "$ref": "#/$defs/sha256" } } } },
+        { "if": { "properties": { "status": { "enum": ["partial", "blocked"] } }, "required": ["status"] }, "then": { "required": ["blockerCode"], "properties": { "blockerCode": { "$ref": "#/$defs/code" } } } },
+        { "if": { "properties": { "status": { "enum": ["available", "transferred"] } }, "required": ["status"] }, "then": { "properties": { "blockerCode": false } } }
+      ]
+    },
+    "receipt": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaVersion", "operationId", "requestDigest", "targetBindingDigest", "userTurnId", "userTurnEvidenceDigest", "assistantTurnId", "ownershipEvidenceDigest", "finishReason", "contentAvailable", "artifacts", "completedAt"],
+      "properties": {
+        "schemaVersion": { "const": "chatgpt.browser_control.operation_receipt.v1" }, "operationId": { "$ref": "#/$defs/uuid" }, "requestDigest": { "$ref": "#/$defs/digest" }, "targetBindingDigest": { "$ref": "#/$defs/digest" },
+        "userTurnId": { "$ref": "#/$defs/opaqueId" }, "userTurnEvidenceDigest": { "$ref": "#/$defs/digest" }, "assistantTurnId": { "$ref": "#/$defs/opaqueId" }, "ownershipEvidenceDigest": { "$ref": "#/$defs/digest" },
+        "responseDigest": { "$ref": "#/$defs/digest" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 8388608 }, "responseFormat": { "enum": ["markdown", "text"] },
+        "finishReason": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$" }, "contentAvailable": { "type": "boolean" },
+        "artifacts": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/artifact" } }, "completedAt": { "$ref": "#/$defs/instant" }
+      },
+      "dependentRequired": { "responseDigest": ["responseBytes"], "responseBytes": ["responseDigest"] },
+      "allOf": [{ "if": { "properties": { "contentAvailable": { "const": true } }, "required": ["contentAvailable"] }, "then": { "required": ["responseDigest", "responseBytes"], "properties": { "responseDigest": { "$ref": "#/$defs/digest" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 8388608 } } } }]
+    },
+    "code": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" },
+    "blocker": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaVersion", "code", "recoverable", "operationId", "requestDigest", "phase", "mutationBoundary", "message"],
+      "properties": {
+        "schemaVersion": { "const": "chatgpt.browser_control.operation_blocker.v1" }, "code": { "$ref": "#/$defs/code" }, "recoverable": { "type": "boolean" },
+        "operationId": { "$ref": "#/$defs/uuid" }, "requestDigest": { "$ref": "#/$defs/digest" }, "phase": { "$ref": "#/$defs/phase" }, "mutationBoundary": { "$ref": "#/$defs/boundary" },
+        "message": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^[A-Za-z0-9][A-Za-z0-9 .,:;'()\\-]{0,511}$" }
+      }
+    }
+  }
+}

package/contracts/v1/surface-drift-policy.json

@@ -16,6 +16,11 @@
       "date": "2026-06-10",
       "reason": "Backend metadata command used by protocol clients, not a user-facing SDK command descriptor."
     },
+    {
+      "command": "backend.hello",
+      "date": "2026-08-16",
+      "reason": "Backend handshake metadata command used by transport negotiation, not a user-facing SDK command descriptor."
+    },
     {
       "command": "runner.plan",
       "date": "2026-06-10",
@@ -70,6 +75,26 @@
       "command": "help",
       "date": "2026-06-10",
       "reason": "Command-discovery metadata command that returns help text; it is not itself a public descriptor."
+    },
+    {
+      "command": "operations.submit",
+      "date": "2026-08-16",
+      "reason": "Transactional operation protocol command exposed through the typed operations facade, not the legacy command descriptor registry."
+    },
+    {
+      "command": "operations.collect",
+      "date": "2026-08-16",
+      "reason": "Transactional operation protocol command exposed through the typed operations facade, not the legacy command descriptor registry."
+    },
+    {
+      "command": "operations.inspect",
+      "date": "2026-08-16",
+      "reason": "Transactional operation protocol command exposed through the typed operations facade, not the legacy command descriptor registry."
+    },
+    {
+      "command": "operations.control",
+      "date": "2026-08-16",
+      "reason": "Transactional operation protocol command exposed through the typed operations facade, not the legacy command descriptor registry."
     }
   ],
   "descriptorBackendCommandExemptions": [
@@ -126,6 +151,31 @@
       "command": "backend.version",
       "date": "2026-06-10",
       "reason": "Python exposes the generic BackendClient.request path for backend.version; health and capabilities have dedicated facades."
+    },
+    {
+      "command": "backend.hello",
+      "date": "2026-08-16",
+      "reason": "Python can use the generic BackendClient.request path while the typed hello diagnostics facade is completed in the parity lane."
+    },
+    {
+      "command": "operations.submit",
+      "date": "2026-08-16",
+      "reason": "Python OperationsClient routes this command through a bounded module constant; the static facade scanner cannot infer constant values."
+    },
+    {
+      "command": "operations.collect",
+      "date": "2026-08-16",
+      "reason": "Python OperationsClient routes this command through a bounded module constant; the static facade scanner cannot infer constant values."
+    },
+    {
+      "command": "operations.inspect",
+      "date": "2026-08-16",
+      "reason": "Python OperationsClient routes this command through a bounded module constant; the static facade scanner cannot infer constant values."
+    },
+    {
+      "command": "operations.control",
+      "date": "2026-08-16",
+      "reason": "Python OperationsClient routes this command through a bounded module constant; the static facade scanner cannot infer constant values."
     }
   ],
   "generatedBlockerDocs": [

package/contracts/v1/vectors/operation-request-digest-v1.json

@@ -0,0 +1,43 @@
+{
+  "schemaVersion": "chatgpt.browser_control.operation_request_digest_vector.v1",
+  "keyHex": "1111111111111111111111111111111111111111111111111111111111111111",
+  "input": {
+    "operationId": "123e4567-e89b-42d3-a456-426614174000",
+    "surface": "chat",
+    "target": {
+      "type": "conversation_id",
+      "conversationId": "fixture-conversation"
+    },
+    "prompt": "Fixture prompt.",
+    "configuration": {
+      "effort": "High",
+      "model": "Fixture Model"
+    },
+    "tools": [
+      "search"
+    ],
+    "files": [
+      {
+        "displayName": "fixture.txt",
+        "bytes": 12,
+        "contentSha256": "abababababababababababababababababababababababababababababababab"
+      }
+    ],
+    "capturePolicy": {
+      "responseContent": "metadata",
+      "responseFormat": "markdown",
+      "artifacts": "transfer",
+      "outputDirectory": "/ignored-by-request-identity"
+    },
+    "behavior": {
+      "existingTab": true
+    }
+  },
+  "expected": {
+    "canonicalInput": "{\"behavior\":{\"existingTab\":true},\"capturePolicy\":{\"artifacts\":\"transfer\",\"responseContent\":\"metadata\",\"responseFormat\":\"markdown\"},\"configuration\":{\"effort\":\"High\",\"model\":\"Fixture Model\"},\"files\":[{\"bytes\":12,\"contentDigest\":\"hmac-sha256:416895599948182096b0bd5f39f3e39ef81e98471569cb001dac1aaeff429e9b\",\"displayNameDigest\":\"hmac-sha256:da8ab313a5f0c9d3dcd227826d8f1e1c12c450d94659e4add5596c05bb0e50e4\"}],\"operationId\":\"123e4567-e89b-42d3-a456-426614174000\",\"prompt\":{\"bytes\":15,\"digest\":\"hmac-sha256:bc599d7caf5f2108976533e17d21b94c20c26ca65f64430a0bed1543f107cd08\"},\"schemaVersion\":\"chatgpt.browser_control.operation_request_identity.v1\",\"surface\":\"chat\",\"target\":{\"conversationId\":\"fixture-conversation\",\"type\":\"conversation_id\"},\"tools\":[\"search\"]}",
+    "promptDigest": "hmac-sha256:bc599d7caf5f2108976533e17d21b94c20c26ca65f64430a0bed1543f107cd08",
+    "displayNameDigest": "hmac-sha256:da8ab313a5f0c9d3dcd227826d8f1e1c12c450d94659e4add5596c05bb0e50e4",
+    "contentDigest": "hmac-sha256:416895599948182096b0bd5f39f3e39ef81e98471569cb001dac1aaeff429e9b",
+    "requestDigest": "hmac-sha256:040c070ecbf1a649f21523187cb183d4036e283cbc2556aa2916261aca7dc1ba"
+  }
+}