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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (191) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +27 -0
  3. package/contracts/v1/fixtures/backend-capabilities.json +40 -1
  4. package/contracts/v1/fixtures/backend-compatibility.json +21 -0
  5. package/contracts/v1/fixtures/backend-version.json +6 -1
  6. package/contracts/v1/fixtures/operation-action-prepared-event.json +42 -0
  7. package/contracts/v1/fixtures/operation-action.json +13 -0
  8. package/contracts/v1/fixtures/operation-artifact-receipt.json +14 -0
  9. package/contracts/v1/fixtures/operation-artifact-transfer-intent-event.json +24 -0
  10. package/contracts/v1/fixtures/operation-artifact-transfer-receipt-event.json +26 -0
  11. package/contracts/v1/fixtures/operation-artifact-transfer-state.json +178 -0
  12. package/contracts/v1/fixtures/operation-blocker.json +10 -0
  13. package/contracts/v1/fixtures/operation-collect-request.json +17 -0
  14. package/contracts/v1/fixtures/operation-collect-result.json +42 -0
  15. package/contracts/v1/fixtures/operation-control-receipt.json +13 -0
  16. package/contracts/v1/fixtures/operation-control-request.json +18 -0
  17. package/contracts/v1/fixtures/operation-control-result.json +31 -0
  18. package/contracts/v1/fixtures/operation-event.json +18 -0
  19. package/contracts/v1/fixtures/operation-handle.json +10 -0
  20. package/contracts/v1/fixtures/operation-inspect-request.json +13 -0
  21. package/contracts/v1/fixtures/operation-inspect-result.json +205 -0
  22. package/contracts/v1/fixtures/operation-ownership-baseline-event.json +34 -0
  23. package/contracts/v1/fixtures/operation-receipt.json +32 -0
  24. package/contracts/v1/fixtures/operation-recovery-decision.json +7 -0
  25. package/contracts/v1/fixtures/operation-recovery-observation.json +12 -0
  26. package/contracts/v1/fixtures/operation-request.json +33 -0
  27. package/contracts/v1/fixtures/operation-state.json +144 -0
  28. package/contracts/v1/fixtures/operation-submission-witness-event.json +20 -0
  29. package/contracts/v1/fixtures/operation-submission-witness.json +11 -0
  30. package/contracts/v1/fixtures/operation-submit-result.json +16 -0
  31. package/contracts/v1/fixtures/operation-target-established-event.json +21 -0
  32. package/contracts/v1/manifest.json +155 -1
  33. package/contracts/v1/parity-suite.json +96 -1
  34. package/contracts/v1/schemas/backend-compatibility.schema.json +65 -0
  35. package/contracts/v1/schemas/backend-request.schema.json +8 -2
  36. package/contracts/v1/schemas/capabilities.schema.json +81 -1
  37. package/contracts/v1/schemas/manifest.schema.json +57 -0
  38. package/contracts/v1/schemas/operation-action.schema.json +155 -0
  39. package/contracts/v1/schemas/operation-artifact-receipt.schema.json +89 -0
  40. package/contracts/v1/schemas/operation-blocker.schema.json +70 -0
  41. package/contracts/v1/schemas/operation-collect-request.schema.json +46 -0
  42. package/contracts/v1/schemas/operation-collect-result.schema.json +74 -0
  43. package/contracts/v1/schemas/operation-control-receipt.schema.json +108 -0
  44. package/contracts/v1/schemas/operation-control-request.schema.json +111 -0
  45. package/contracts/v1/schemas/operation-control-result.schema.json +112 -0
  46. package/contracts/v1/schemas/operation-event.schema.json +756 -0
  47. package/contracts/v1/schemas/operation-handle.schema.json +55 -0
  48. package/contracts/v1/schemas/operation-inspect-request.schema.json +42 -0
  49. package/contracts/v1/schemas/operation-inspect-result.schema.json +1662 -0
  50. package/contracts/v1/schemas/operation-receipt.schema.json +153 -0
  51. package/contracts/v1/schemas/operation-recovery.schema.json +314 -0
  52. package/contracts/v1/schemas/operation-request.schema.json +158 -0
  53. package/contracts/v1/schemas/operation-state.schema.json +691 -0
  54. package/contracts/v1/schemas/operation-submission-witness.schema.json +48 -0
  55. package/contracts/v1/schemas/operation-submit-result.schema.json +94 -0
  56. package/contracts/v1/surface-drift-policy.json +50 -0
  57. package/contracts/v1/vectors/operation-request-digest-v1.json +43 -0
  58. package/dist/codex-chatgpt-control-backend.mjs +43897 -9094
  59. package/dist/codex-chatgpt-control.bundle.mjs +46360 -10262
  60. package/dist/src/backend/client.d.ts +103 -2
  61. package/dist/src/backend/client.js +1436 -97
  62. package/dist/src/backend/compatibility.d.ts +12 -0
  63. package/dist/src/backend/compatibility.js +208 -0
  64. package/dist/src/backend/protocol.d.ts +84 -1
  65. package/dist/src/backend/protocol.js +31 -5
  66. package/dist/src/backend/runtime-identity.d.ts +10 -0
  67. package/dist/src/backend/runtime-identity.js +141 -0
  68. package/dist/src/backend/session.d.ts +10 -2
  69. package/dist/src/backend/session.js +478 -7
  70. package/dist/src/backend/stdio-server.d.ts +4 -1
  71. package/dist/src/backend/stdio-server.js +240 -28
  72. package/dist/src/browser/active-composer-file-input.d.ts +9 -0
  73. package/dist/src/browser/active-composer-file-input.js +33 -0
  74. package/dist/src/browser/attach.d.ts +4 -1
  75. package/dist/src/browser/attach.js +136 -28
  76. package/dist/src/browser/downloads.d.ts +2 -0
  77. package/dist/src/client.d.ts +38 -0
  78. package/dist/src/client.js +1222 -59
  79. package/dist/src/commands/configuration.js +13 -7
  80. package/dist/src/commands/doctor.d.ts +1 -1
  81. package/dist/src/commands/doctor.js +26 -3
  82. package/dist/src/commands/experience.js +35 -0
  83. package/dist/src/commands/files.js +4 -27
  84. package/dist/src/commands/modes.js +49 -17
  85. package/dist/src/commands/power-discovery.d.ts +130 -0
  86. package/dist/src/commands/power-discovery.js +627 -0
  87. package/dist/src/commands/project-sources.js +325 -31
  88. package/dist/src/commands/sequence.js +59 -32
  89. package/dist/src/commands/session.js +7 -2
  90. package/dist/src/commands/work.js +31 -0
  91. package/dist/src/errors.d.ts +9 -0
  92. package/dist/src/errors.js +22 -0
  93. package/dist/src/index.d.ts +6 -0
  94. package/dist/src/index.js +9 -0
  95. package/dist/src/operations/artifact-output.d.ts +69 -0
  96. package/dist/src/operations/artifact-output.js +1748 -0
  97. package/dist/src/operations/artifact-stream.d.ts +19 -0
  98. package/dist/src/operations/artifact-stream.js +35 -0
  99. package/dist/src/operations/artifact-transfer.d.ts +149 -0
  100. package/dist/src/operations/artifact-transfer.js +1312 -0
  101. package/dist/src/operations/browser-adapter.d.ts +161 -0
  102. package/dist/src/operations/browser-adapter.js +2023 -0
  103. package/dist/src/operations/browser-observation.d.ts +110 -0
  104. package/dist/src/operations/browser-observation.js +1208 -0
  105. package/dist/src/operations/browser-target.d.ts +103 -0
  106. package/dist/src/operations/browser-target.js +489 -0
  107. package/dist/src/operations/canonical.d.ts +4 -0
  108. package/dist/src/operations/canonical.js +412 -0
  109. package/dist/src/operations/chatgpt-runtime.d.ts +72 -0
  110. package/dist/src/operations/chatgpt-runtime.js +1150 -0
  111. package/dist/src/operations/client.d.ts +138 -0
  112. package/dist/src/operations/client.js +1143 -0
  113. package/dist/src/operations/collector.d.ts +195 -0
  114. package/dist/src/operations/collector.js +1039 -0
  115. package/dist/src/operations/control.d.ts +372 -0
  116. package/dist/src/operations/control.js +1498 -0
  117. package/dist/src/operations/file-identity.d.ts +33 -0
  118. package/dist/src/operations/file-identity.js +153 -0
  119. package/dist/src/operations/handle.d.ts +19 -0
  120. package/dist/src/operations/handle.js +727 -0
  121. package/dist/src/operations/index.d.ts +22 -0
  122. package/dist/src/operations/index.js +22 -0
  123. package/dist/src/operations/journal.d.ts +142 -0
  124. package/dist/src/operations/journal.js +1931 -0
  125. package/dist/src/operations/production-attachments.d.ts +116 -0
  126. package/dist/src/operations/production-attachments.js +1018 -0
  127. package/dist/src/operations/production-chatgpt-artifacts.d.ts +74 -0
  128. package/dist/src/operations/production-chatgpt-artifacts.js +1146 -0
  129. package/dist/src/operations/production-chatgpt-attachments.d.ts +71 -0
  130. package/dist/src/operations/production-chatgpt-attachments.js +1563 -0
  131. package/dist/src/operations/production-configuration.d.ts +42 -0
  132. package/dist/src/operations/production-configuration.js +1363 -0
  133. package/dist/src/operations/production-primitives.d.ts +53 -0
  134. package/dist/src/operations/production-primitives.js +1073 -0
  135. package/dist/src/operations/production-work-steer.d.ts +203 -0
  136. package/dist/src/operations/production-work-steer.js +1218 -0
  137. package/dist/src/operations/recovery.d.ts +80 -0
  138. package/dist/src/operations/recovery.js +174 -0
  139. package/dist/src/operations/runtime-adapter.d.ts +118 -0
  140. package/dist/src/operations/runtime-adapter.js +786 -0
  141. package/dist/src/operations/send-once.d.ts +224 -0
  142. package/dist/src/operations/send-once.js +1081 -0
  143. package/dist/src/operations/service.d.ts +281 -0
  144. package/dist/src/operations/service.js +2810 -0
  145. package/dist/src/operations/staging.d.ts +136 -0
  146. package/dist/src/operations/staging.js +630 -0
  147. package/dist/src/operations/state-machine.d.ts +29 -0
  148. package/dist/src/operations/state-machine.js +2047 -0
  149. package/dist/src/operations/submission.d.ts +423 -0
  150. package/dist/src/operations/submission.js +1676 -0
  151. package/dist/src/operations/turn-ownership.d.ts +202 -0
  152. package/dist/src/operations/turn-ownership.js +700 -0
  153. package/dist/src/operations/types.d.ts +454 -0
  154. package/dist/src/operations/types.js +20 -0
  155. package/dist/src/operations/wire-requests.d.ts +21 -0
  156. package/dist/src/operations/wire-requests.js +396 -0
  157. package/dist/src/operations/wire-results.d.ts +97 -0
  158. package/dist/src/operations/wire-results.js +818 -0
  159. package/dist/src/runner/responses.d.ts +3 -1
  160. package/dist/src/runner/responses.js +19 -1
  161. package/dist/src/runner/result.js +227 -55
  162. package/dist/src/runner/types.d.ts +12 -0
  163. package/dist/src/runtime/command-routing.d.ts +149 -0
  164. package/dist/src/runtime/command-routing.js +431 -0
  165. package/dist/src/runtime/coordinated-browser.d.ts +24 -0
  166. package/dist/src/runtime/coordinated-browser.js +315 -0
  167. package/dist/src/runtime/coordinated-page.d.ts +39 -0
  168. package/dist/src/runtime/coordinated-page.js +634 -0
  169. package/dist/src/runtime/operation-context.d.ts +142 -0
  170. package/dist/src/runtime/operation-context.js +410 -0
  171. package/dist/src/runtime/runtime-session.d.ts +95 -0
  172. package/dist/src/runtime/runtime-session.js +314 -0
  173. package/dist/src/runtime/tab-coordinator.d.ts +200 -0
  174. package/dist/src/runtime/tab-coordinator.js +1200 -0
  175. package/dist/src/runtime/value-boundaries.d.ts +18 -0
  176. package/dist/src/runtime/value-boundaries.js +49 -0
  177. package/dist/src/safety/untrusted-output.js +2 -1
  178. package/dist/src/scripts/backend-server.js +4 -1
  179. package/dist/src/scripts/live-smoke/harness.js +79 -7
  180. package/dist/src/scripts/live-smoke/scenarios.d.ts +28 -0
  181. package/dist/src/scripts/live-smoke/scenarios.js +110 -18
  182. package/dist/src/scripts/live-smoke/types.d.ts +3 -0
  183. package/dist/src/scripts/release-canary-module.js +17 -4
  184. package/dist/src/types.d.ts +38 -1
  185. package/package.json +1 -1
  186. package/references/2026-08-16-transactional-operations.md +459 -0
  187. package/references/agents-runner.md +34 -0
  188. package/references/backend-protocol.md +73 -0
  189. package/references/python-parity.md +72 -0
  190. package/references/responses-adapter.md +19 -0
  191. package/references/streaming.md +6 -0
@@ -0,0 +1,691 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://local.codex-chatgpt-control/contracts/v1/schemas/operation-state.schema.json",
4
+ "title": "Transactional browser operation durable state",
5
+ "description": "A redacted materialized operation state. The append-only journal is authoritative; this shape is safe to rebuild and contains no raw prompt, response, file content, or filesystem path.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": [
9
+ "schemaVersion",
10
+ "operationId",
11
+ "requestDigest",
12
+ "surface",
13
+ "phase",
14
+ "mutationBoundary",
15
+ "revision",
16
+ "createdAt",
17
+ "updatedAt",
18
+ "actions"
19
+ ],
20
+ "properties": {
21
+ "schemaVersion": { "const": "chatgpt.browser_control.operation.v1" },
22
+ "operationId": { "$ref": "#/$defs/uuid" },
23
+ "requestDigest": { "$ref": "#/$defs/digest" },
24
+ "surface": { "enum": ["chat", "work"] },
25
+ "phase": { "$ref": "#/$defs/phase" },
26
+ "mutationBoundary": { "$ref": "#/$defs/mutationBoundary" },
27
+ "revision": { "$ref": "#/$defs/revision" },
28
+ "createdAt": { "$ref": "#/$defs/instant" },
29
+ "updatedAt": { "$ref": "#/$defs/instant" },
30
+ "capturePolicy": { "$ref": "#/$defs/capturePolicy" },
31
+ "responseFormat": { "enum": ["markdown", "text"] },
32
+ "target": { "$ref": "#/$defs/target" },
33
+ "actions": {
34
+ "type": "object",
35
+ "propertyNames": { "$ref": "#/$defs/uuid" },
36
+ "additionalProperties": { "$ref": "#/$defs/action" }
37
+ },
38
+ "ownershipBaseline": { "$ref": "#/$defs/operationOwnershipBaseline" },
39
+ "ownershipBaselines": {
40
+ "type": "object",
41
+ "propertyNames": { "$ref": "#/$defs/uuid" },
42
+ "maxProperties": 64,
43
+ "additionalProperties": { "$ref": "#/$defs/operationOwnershipBaseline" }
44
+ },
45
+ "artifactTransfers": {
46
+ "type": "object",
47
+ "propertyNames": { "$ref": "#/$defs/uuid" },
48
+ "additionalProperties": { "$ref": "#/$defs/artifactTransferState" }
49
+ },
50
+ "submissionWitnesses": {
51
+ "type": "object",
52
+ "propertyNames": { "$ref": "#/$defs/uuid" },
53
+ "maxProperties": 64,
54
+ "additionalProperties": { "$ref": "#/$defs/submissionWitness" }
55
+ },
56
+ "submissionWitness": { "$ref": "#/$defs/submissionWitness" },
57
+ "lastBlocker": { "$ref": "#/$defs/blocker" },
58
+ "receipt": { "$ref": "#/$defs/receipt" }
59
+ },
60
+ "$defs": {
61
+ "capturePolicy": {
62
+ "type": "object",
63
+ "additionalProperties": false,
64
+ "required": ["responseContent", "responseFormat", "artifacts"],
65
+ "properties": {
66
+ "responseContent": { "enum": ["include", "metadata"] },
67
+ "responseFormat": { "enum": ["markdown", "text"] },
68
+ "artifacts": { "enum": ["receipt_only", "transfer"] }
69
+ }
70
+ },
71
+ "uuid": {
72
+ "type": "string",
73
+ "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
74
+ },
75
+ "digest": {
76
+ "type": "string",
77
+ "pattern": "^hmac-sha256:[0-9a-f]{64}$"
78
+ },
79
+ "instant": {
80
+ "type": "string",
81
+ "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$"
82
+ },
83
+ "revision": {
84
+ "type": "integer",
85
+ "minimum": 1,
86
+ "maximum": 9007199254740991
87
+ },
88
+ "opaqueId": {
89
+ "type": "string",
90
+ "minLength": 1,
91
+ "maxLength": 512,
92
+ "pattern": "^(?=.*\\S)[^\\u0000-\\u001f\\u007f]{1,512}$"
93
+ },
94
+ "code": {
95
+ "type": "string",
96
+ "pattern": "^[a-z][a-z0-9_]{0,63}$"
97
+ },
98
+ "phase": {
99
+ "enum": [
100
+ "prepared",
101
+ "handoff_pending",
102
+ "ready",
103
+ "send_pending",
104
+ "submitted",
105
+ "generating",
106
+ "capturing",
107
+ "completed",
108
+ "uncertain"
109
+ ]
110
+ },
111
+ "mutationBoundary": {
112
+ "enum": ["none", "handoff_may_have_occurred", "send_may_have_occurred", "control_may_have_occurred"]
113
+ },
114
+ "evidenceProfile": {
115
+ "type": "object",
116
+ "additionalProperties": false,
117
+ "required": [
118
+ "providerIdentity",
119
+ "stableTabId",
120
+ "stableConversationId",
121
+ "stableUserTurnId",
122
+ "authoritativeTabClaim",
123
+ "replacementTabRecovery"
124
+ ],
125
+ "properties": {
126
+ "providerIdentity": { "enum": ["required", "unavailable"] },
127
+ "stableTabId": { "enum": ["required", "unavailable"] },
128
+ "stableConversationId": { "enum": ["required", "unavailable"] },
129
+ "stableUserTurnId": { "enum": ["required", "unavailable"] },
130
+ "authoritativeTabClaim": { "enum": ["required", "unavailable"] },
131
+ "replacementTabRecovery": { "type": "boolean" }
132
+ }
133
+ },
134
+ "target": {
135
+ "type": "object",
136
+ "additionalProperties": false,
137
+ "required": ["providerId", "browserId", "tabId", "coordinationScope", "evidenceProfile"],
138
+ "properties": {
139
+ "providerId": { "$ref": "#/$defs/opaqueId" },
140
+ "browserId": { "$ref": "#/$defs/opaqueId" },
141
+ "tabId": { "$ref": "#/$defs/opaqueId" },
142
+ "coordinationScope": { "enum": ["process", "provider"] },
143
+ "tabClaimEvidenceDigest": { "$ref": "#/$defs/digest" },
144
+ "canonicalThreadUrl": {
145
+ "type": "string",
146
+ "minLength": 1,
147
+ "maxLength": 4096,
148
+ "pattern": "^https://[^?#]+$"
149
+ },
150
+ "conversationId": { "$ref": "#/$defs/opaqueId" },
151
+ "userTurnBaselineDigest": { "$ref": "#/$defs/digest" },
152
+ "assistantTurnBaselineDigest": { "$ref": "#/$defs/digest" },
153
+ "configurationReceiptDigest": { "$ref": "#/$defs/digest" },
154
+ "targetLifecycle": { "enum": ["fixed", "new_pending", "new_established"] },
155
+ "newTargetAnchorDigest": { "$ref": "#/$defs/digest" },
156
+ "blankTaskEvidenceDigest": { "$ref": "#/$defs/digest" },
157
+ "targetEstablishment": { "$ref": "#/$defs/targetEstablishmentRead" },
158
+ "evidenceProfile": { "$ref": "#/$defs/evidenceProfile" }
159
+ },
160
+ "allOf": [
161
+ {
162
+ "if": { "properties": { "coordinationScope": { "const": "provider" } }, "required": ["coordinationScope"] },
163
+ "then": {
164
+ "required": ["tabClaimEvidenceDigest"],
165
+ "properties": {
166
+ "tabClaimEvidenceDigest": { "$ref": "#/$defs/digest" },
167
+ "evidenceProfile": {
168
+ "type": "object",
169
+ "properties": { "authoritativeTabClaim": { "const": "required" } }
170
+ }
171
+ }
172
+ }
173
+ }
174
+ ,{
175
+ "if": { "type": "object", "properties": { "targetLifecycle": { "const": "new_pending" } }, "required": ["targetLifecycle"] },
176
+ "then": {
177
+ "type": "object",
178
+ "required": ["newTargetAnchorDigest", "blankTaskEvidenceDigest"],
179
+ "properties": {
180
+ "newTargetAnchorDigest": { "$ref": "#/$defs/digest" },
181
+ "blankTaskEvidenceDigest": { "$ref": "#/$defs/digest" }
182
+ }
183
+ }
184
+ },
185
+ {
186
+ "if": { "type": "object", "properties": { "targetLifecycle": { "const": "new_established" } }, "required": ["targetLifecycle"] },
187
+ "then": {
188
+ "type": "object",
189
+ "required": ["newTargetAnchorDigest", "blankTaskEvidenceDigest", "canonicalThreadUrl", "conversationId", "targetEstablishment"],
190
+ "properties": {
191
+ "newTargetAnchorDigest": { "$ref": "#/$defs/digest" },
192
+ "blankTaskEvidenceDigest": { "$ref": "#/$defs/digest" },
193
+ "canonicalThreadUrl": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^https://[^?#]+$" },
194
+ "conversationId": { "$ref": "#/$defs/opaqueId" },
195
+ "targetEstablishment": { "$ref": "#/$defs/targetEstablishment" }
196
+ }
197
+ }
198
+ },
199
+ {
200
+ "if": { "type": "object", "properties": { "targetLifecycle": { "const": "fixed" } }, "required": ["targetLifecycle"] },
201
+ "then": { "type": "object" }
202
+ }
203
+ ]
204
+ },
205
+ "targetEstablishmentRead": {
206
+ "type": "object",
207
+ "additionalProperties": false,
208
+ "required": [
209
+ "targetBindingDigest",
210
+ "anchorDigest",
211
+ "causalSendActionId",
212
+ "conversationId",
213
+ "canonicalThreadUrl",
214
+ "userTurnId",
215
+ "userTurnEvidenceDigest",
216
+ "evidenceDigest",
217
+ "observedAt"
218
+ ],
219
+ "properties": {
220
+ "targetBindingDigest": { "$ref": "#/$defs/digest" },
221
+ "anchorDigest": { "$ref": "#/$defs/digest" },
222
+ "causalSendActionId": { "$ref": "#/$defs/uuid" },
223
+ "conversationId": { "$ref": "#/$defs/opaqueId" },
224
+ "canonicalThreadUrl": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^https://[^?#]+$" },
225
+ "userTurnId": { "$ref": "#/$defs/opaqueId" },
226
+ "userTurnEvidenceDigest": { "$ref": "#/$defs/digest" },
227
+ "postSendDeltaDigest": { "$ref": "#/$defs/digest" },
228
+ "evidenceDigest": { "$ref": "#/$defs/digest" },
229
+ "observedAt": { "$ref": "#/$defs/instant" }
230
+ }
231
+ },
232
+ "targetEstablishment": {
233
+ "allOf": [
234
+ { "$ref": "#/$defs/targetEstablishmentRead" },
235
+ { "type": "object", "required": ["postSendDeltaDigest"], "properties": { "postSendDeltaDigest": { "$ref": "#/$defs/digest" } } }
236
+ ]
237
+ },
238
+ "submissionWitness": {
239
+ "type": "object",
240
+ "additionalProperties": false,
241
+ "required": [
242
+ "schemaVersion",
243
+ "actionId",
244
+ "actionKind",
245
+ "targetBindingDigest",
246
+ "baselineSnapshotDigest",
247
+ "postSendDeltaDigest",
248
+ "operationUserEvidenceDigest",
249
+ "observedAt"
250
+ ],
251
+ "properties": {
252
+ "schemaVersion": { "const": "chatgpt.browser_control.operation_submission_witness.v1" },
253
+ "actionId": { "$ref": "#/$defs/uuid" },
254
+ "actionKind": { "enum": ["send", "work_steer"] },
255
+ "targetBindingDigest": { "$ref": "#/$defs/digest" },
256
+ "baselineSnapshotDigest": { "$ref": "#/$defs/digest" },
257
+ "postSendDeltaDigest": { "$ref": "#/$defs/digest" },
258
+ "operationUserEvidenceDigest": { "$ref": "#/$defs/digest" },
259
+ "userTurnId": { "$ref": "#/$defs/opaqueId" },
260
+ "observedAt": { "$ref": "#/$defs/instant" }
261
+ }
262
+ },
263
+ "operationOwnershipBaseline": {
264
+ "type": "object",
265
+ "additionalProperties": false,
266
+ "required": ["schemaVersion", "operationId", "requestDigest", "targetBindingDigest", "actionId", "baseline", "observedAt"],
267
+ "properties": {
268
+ "schemaVersion": { "const": "chatgpt.browser_control.operation_ownership_baseline.v1" },
269
+ "operationId": { "$ref": "#/$defs/uuid" },
270
+ "requestDigest": { "$ref": "#/$defs/digest" },
271
+ "targetBindingDigest": { "$ref": "#/$defs/digest" },
272
+ "actionId": { "$ref": "#/$defs/uuid" },
273
+ "baseline": { "$ref": "#/$defs/ownershipBaseline" },
274
+ "observedAt": { "$ref": "#/$defs/instant" }
275
+ }
276
+ },
277
+ "ownershipBaseline": {
278
+ "type": "object",
279
+ "additionalProperties": false,
280
+ "required": ["schemaVersion", "snapshotDigest", "target", "userTurns", "assistantTurns", "completeness"],
281
+ "properties": {
282
+ "schemaVersion": { "const": "chatgpt.browser_control.turn_ownership.v1" },
283
+ "snapshotDigest": { "$ref": "#/$defs/digest" },
284
+ "target": { "$ref": "#/$defs/ownershipTarget" },
285
+ "userTurns": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/ownershipTurn" } },
286
+ "assistantTurns": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/ownershipTurn" } },
287
+ "completeness": { "const": "complete" }
288
+ }
289
+ },
290
+ "artifactTransferState": {
291
+ "type": "object",
292
+ "additionalProperties": false,
293
+ "required": ["intent"],
294
+ "properties": {
295
+ "intent": { "$ref": "#/$defs/artifactTransferIntent" },
296
+ "receipt": { "$ref": "#/$defs/artifactTransferReceipt" }
297
+ }
298
+ },
299
+ "artifactTransferIntent": {
300
+ "type": "object",
301
+ "additionalProperties": false,
302
+ "required": [
303
+ "schemaVersion", "operationId", "requestDigest", "targetBindingDigest", "assistantTurnId",
304
+ "sourceIdentityDigest", "kind", "ordinal", "transferActionId", "destinationIdentityDigest",
305
+ "actionKind", "repeatPolicy", "intentAt"
306
+ ],
307
+ "properties": {
308
+ "schemaVersion": { "const": "chatgpt.browser_control.artifact_transfer_intent.v1" },
309
+ "operationId": { "$ref": "#/$defs/uuid" },
310
+ "requestDigest": { "$ref": "#/$defs/digest" },
311
+ "targetBindingDigest": { "$ref": "#/$defs/digest" },
312
+ "assistantTurnId": { "$ref": "#/$defs/opaqueId" },
313
+ "sourceIdentityDigest": { "$ref": "#/$defs/digest" },
314
+ "kind": { "enum": ["file", "image", "other"] },
315
+ "ordinal": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
316
+ "transferActionId": { "$ref": "#/$defs/uuid" },
317
+ "destinationIdentityDigest": { "$ref": "#/$defs/digest" },
318
+ "actionKind": { "const": "local_output_commit" },
319
+ "repeatPolicy": { "const": "reconcile_local_effect" },
320
+ "intentAt": { "$ref": "#/$defs/instant" }
321
+ }
322
+ },
323
+ "artifactTransferReceipt": {
324
+ "type": "object",
325
+ "additionalProperties": false,
326
+ "required": [
327
+ "schemaVersion", "operationId", "requestDigest", "targetBindingDigest", "assistantTurnId",
328
+ "sourceIdentityDigest", "kind", "ordinal", "transferActionId", "destinationIdentityDigest",
329
+ "status", "observedAt"
330
+ ],
331
+ "properties": {
332
+ "schemaVersion": { "const": "chatgpt.browser_control.artifact_transfer_receipt.v1" },
333
+ "operationId": { "$ref": "#/$defs/uuid" },
334
+ "requestDigest": { "$ref": "#/$defs/digest" },
335
+ "targetBindingDigest": { "$ref": "#/$defs/digest" },
336
+ "assistantTurnId": { "$ref": "#/$defs/opaqueId" },
337
+ "sourceIdentityDigest": { "$ref": "#/$defs/digest" },
338
+ "kind": { "enum": ["file", "image", "other"] },
339
+ "ordinal": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
340
+ "transferActionId": { "$ref": "#/$defs/uuid" },
341
+ "destinationIdentityDigest": { "$ref": "#/$defs/digest" },
342
+ "outputKey": { "$ref": "#/$defs/outputKey" },
343
+ "bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
344
+ "sha256": { "$ref": "#/$defs/sha256" },
345
+ "status": { "enum": ["transferred", "partial", "blocked"] },
346
+ "blockerCode": { "$ref": "#/$defs/code" },
347
+ "observedAt": { "$ref": "#/$defs/instant" }
348
+ },
349
+ "allOf": [
350
+ {
351
+ "if": { "properties": { "status": { "const": "transferred" } }, "required": ["status"] },
352
+ "then": {
353
+ "required": ["outputKey", "bytes", "sha256"],
354
+ "properties": {
355
+ "outputKey": { "$ref": "#/$defs/outputKey" },
356
+ "bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
357
+ "sha256": { "$ref": "#/$defs/sha256" },
358
+ "blockerCode": false
359
+ }
360
+ }
361
+ },
362
+ {
363
+ "if": { "properties": { "status": { "enum": ["partial", "blocked"] } }, "required": ["status"] },
364
+ "then": { "required": ["blockerCode"] }
365
+ }
366
+ ]
367
+ },
368
+ "ownershipTarget": {
369
+ "type": "object",
370
+ "additionalProperties": false,
371
+ "required": ["provider", "browser", "tab", "thread", "conversation", "canonicalThreadUrl", "authoritativeTabClaim", "coordinationScope"],
372
+ "properties": {
373
+ "provider": { "$ref": "#/$defs/ownershipIdentity" },
374
+ "browser": { "$ref": "#/$defs/ownershipIdentity" },
375
+ "tab": { "$ref": "#/$defs/ownershipIdentity" },
376
+ "thread": { "$ref": "#/$defs/ownershipIdentity" },
377
+ "conversation": { "$ref": "#/$defs/ownershipIdentity" },
378
+ "canonicalThreadUrl": { "$ref": "#/$defs/ownershipUrlIdentity" },
379
+ "authoritativeTabClaim": { "$ref": "#/$defs/ownershipIdentity" },
380
+ "coordinationScope": { "enum": ["process", "provider"] }
381
+ }
382
+ },
383
+ "ownershipIdentity": {
384
+ "oneOf": [
385
+ {
386
+ "type": "object",
387
+ "additionalProperties": false,
388
+ "required": ["status", "value"],
389
+ "properties": { "status": { "const": "available" }, "value": { "$ref": "#/$defs/opaqueId" } }
390
+ },
391
+ {
392
+ "type": "object",
393
+ "additionalProperties": false,
394
+ "required": ["status", "reason"],
395
+ "properties": { "status": { "const": "unavailable" }, "reason": { "enum": ["not_exposed", "not_observed", "redacted"] } }
396
+ }
397
+ ]
398
+ },
399
+ "ownershipUrlIdentity": {
400
+ "oneOf": [
401
+ {
402
+ "type": "object",
403
+ "additionalProperties": false,
404
+ "required": ["status", "value"],
405
+ "properties": {
406
+ "status": { "const": "available" },
407
+ "value": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^https://[^?#]+$" }
408
+ }
409
+ },
410
+ {
411
+ "type": "object",
412
+ "additionalProperties": false,
413
+ "required": ["status", "reason"],
414
+ "properties": { "status": { "const": "unavailable" }, "reason": { "enum": ["not_exposed", "not_observed", "redacted"] } }
415
+ }
416
+ ]
417
+ },
418
+ "ownershipTurn": {
419
+ "type": "object",
420
+ "additionalProperties": false,
421
+ "required": ["evidenceDigest", "structureDigest", "ordinal"],
422
+ "properties": {
423
+ "stableId": { "$ref": "#/$defs/opaqueId" },
424
+ "evidenceDigest": { "$ref": "#/$defs/digest" },
425
+ "structureDigest": { "$ref": "#/$defs/digest" },
426
+ "ordinal": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
427
+ "parentStableId": { "$ref": "#/$defs/opaqueId" },
428
+ "branchStableId": { "$ref": "#/$defs/opaqueId" },
429
+ "state": { "enum": ["generating", "terminal"] },
430
+ "artifactEvidenceDigests": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/digest" } }
431
+ }
432
+ },
433
+ "actionKind": {
434
+ "enum": [
435
+ "status_read",
436
+ "configuration_set",
437
+ "tool_set",
438
+ "composer_set",
439
+ "power_discovery",
440
+ "power_select",
441
+ "file_handoff",
442
+ "send",
443
+ "work_steer",
444
+ "stop",
445
+ "download",
446
+ "local_output_commit",
447
+ "clipboard_capture_restore"
448
+ ]
449
+ },
450
+ "repeatPolicy": {
451
+ "enum": [
452
+ "read_only",
453
+ "reconcile_set_to_value",
454
+ "reconcile_local_effect",
455
+ "observe_only_after_intent"
456
+ ]
457
+ },
458
+ "action": {
459
+ "type": "object",
460
+ "additionalProperties": false,
461
+ "required": ["actionId", "kind", "repeatPolicy", "requestDigest", "intentRevision", "intentAt"],
462
+ "properties": {
463
+ "actionId": { "$ref": "#/$defs/uuid" },
464
+ "kind": { "$ref": "#/$defs/actionKind" },
465
+ "repeatPolicy": { "$ref": "#/$defs/repeatPolicy" },
466
+ "requestDigest": { "$ref": "#/$defs/digest" },
467
+ "parentActionId": { "$ref": "#/$defs/uuid" },
468
+ "targetDigest": { "$ref": "#/$defs/digest" },
469
+ "intentRevision": { "$ref": "#/$defs/revision" },
470
+ "intentAt": { "$ref": "#/$defs/instant" },
471
+ "outcome": { "enum": ["satisfied", "not_satisfied", "uncertain"] },
472
+ "receiptRevision": { "$ref": "#/$defs/revision" },
473
+ "receiptAt": { "$ref": "#/$defs/instant" },
474
+ "evidenceDigest": { "$ref": "#/$defs/digest" },
475
+ "blockerCode": { "$ref": "#/$defs/code" }
476
+ },
477
+ "allOf": [
478
+ {
479
+ "if": { "required": ["outcome"], "properties": { "outcome": { "enum": ["satisfied", "not_satisfied", "uncertain"] } } },
480
+ "then": {
481
+ "required": ["receiptRevision", "receiptAt"],
482
+ "properties": {
483
+ "receiptRevision": { "$ref": "#/$defs/revision" },
484
+ "receiptAt": { "$ref": "#/$defs/instant" }
485
+ }
486
+ }
487
+ },
488
+ {
489
+ "if": { "required": ["receiptRevision"], "properties": { "receiptRevision": { "$ref": "#/$defs/revision" } } },
490
+ "then": {
491
+ "required": ["outcome", "receiptAt"],
492
+ "properties": {
493
+ "outcome": { "enum": ["satisfied", "not_satisfied", "uncertain"] },
494
+ "receiptAt": { "$ref": "#/$defs/instant" }
495
+ }
496
+ }
497
+ },
498
+ {
499
+ "if": { "required": ["receiptAt"] },
500
+ "then": {
501
+ "required": ["outcome", "receiptRevision"],
502
+ "properties": {
503
+ "outcome": { "enum": ["satisfied", "not_satisfied", "uncertain"] },
504
+ "receiptRevision": { "$ref": "#/$defs/revision" }
505
+ }
506
+ }
507
+ },
508
+ {
509
+ "if": { "required": ["evidenceDigest"], "properties": { "evidenceDigest": { "$ref": "#/$defs/digest" } } },
510
+ "then": {
511
+ "required": ["outcome"],
512
+ "properties": { "outcome": { "enum": ["satisfied", "not_satisfied", "uncertain"] } }
513
+ }
514
+ },
515
+ {
516
+ "if": { "required": ["blockerCode"], "properties": { "blockerCode": { "$ref": "#/$defs/code" } } },
517
+ "then": {
518
+ "required": ["outcome"],
519
+ "properties": { "outcome": { "enum": ["not_satisfied", "uncertain"] } }
520
+ }
521
+ },
522
+ {
523
+ "if": { "properties": { "outcome": { "const": "satisfied" } }, "required": ["outcome"] },
524
+ "then": {
525
+ "required": ["evidenceDigest"],
526
+ "properties": { "evidenceDigest": { "$ref": "#/$defs/digest" } }
527
+ }
528
+ },
529
+ {
530
+ "if": { "properties": { "kind": { "not": { "const": "status_read" } } }, "required": ["kind"] },
531
+ "then": {
532
+ "required": ["targetDigest"],
533
+ "properties": { "targetDigest": { "$ref": "#/$defs/digest" } }
534
+ }
535
+ },
536
+ {
537
+ "if": { "properties": { "kind": { "enum": ["status_read", "power_discovery"] } }, "required": ["kind"] },
538
+ "then": { "properties": { "repeatPolicy": { "const": "read_only" } } }
539
+ },
540
+ {
541
+ "if": { "properties": { "kind": { "enum": ["configuration_set", "tool_set", "composer_set", "power_select"] } }, "required": ["kind"] },
542
+ "then": { "properties": { "repeatPolicy": { "const": "reconcile_set_to_value" } } }
543
+ },
544
+ {
545
+ "if": { "properties": { "kind": { "enum": ["file_handoff", "send", "work_steer", "stop"] } }, "required": ["kind"] },
546
+ "then": { "properties": { "repeatPolicy": { "const": "observe_only_after_intent" } } }
547
+ },
548
+ {
549
+ "if": { "properties": { "kind": { "enum": ["download", "local_output_commit", "clipboard_capture_restore"] } }, "required": ["kind"] },
550
+ "then": { "properties": { "repeatPolicy": { "const": "reconcile_local_effect" } } }
551
+ }
552
+ ]
553
+ },
554
+ "blocker": {
555
+ "type": "object",
556
+ "additionalProperties": false,
557
+ "required": ["code", "messageDigest", "recoverable", "observedAt"],
558
+ "properties": {
559
+ "code": { "$ref": "#/$defs/code" },
560
+ "messageDigest": { "$ref": "#/$defs/digest" },
561
+ "recoverable": { "type": "boolean" },
562
+ "observedAt": { "$ref": "#/$defs/instant" }
563
+ }
564
+ },
565
+ "receipt": {
566
+ "type": "object",
567
+ "additionalProperties": false,
568
+ "required": [
569
+ "schemaVersion",
570
+ "operationId",
571
+ "requestDigest",
572
+ "targetBindingDigest",
573
+ "userTurnId",
574
+ "userTurnEvidenceDigest",
575
+ "assistantTurnId",
576
+ "ownershipEvidenceDigest",
577
+ "finishReason",
578
+ "contentAvailable",
579
+ "artifacts",
580
+ "completedAt"
581
+ ],
582
+ "properties": {
583
+ "schemaVersion": { "const": "chatgpt.browser_control.operation_receipt.v1" },
584
+ "operationId": { "$ref": "#/$defs/uuid" },
585
+ "requestDigest": { "$ref": "#/$defs/digest" },
586
+ "targetBindingDigest": { "$ref": "#/$defs/digest" },
587
+ "userTurnId": { "$ref": "#/$defs/opaqueId" },
588
+ "userTurnEvidenceDigest": { "$ref": "#/$defs/digest" },
589
+ "assistantTurnId": { "$ref": "#/$defs/opaqueId" },
590
+ "ownershipEvidenceDigest": { "$ref": "#/$defs/digest" },
591
+ "responseDigest": { "$ref": "#/$defs/digest" },
592
+ "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
593
+ "responseFormat": { "enum": ["markdown", "text"] },
594
+ "finishReason": {
595
+ "type": "string",
596
+ "minLength": 1,
597
+ "maxLength": 128,
598
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
599
+ },
600
+ "contentAvailable": { "type": "boolean" },
601
+ "artifacts": {
602
+ "type": "array",
603
+ "items": { "$ref": "#/$defs/artifact" },
604
+ "maxItems": 32
605
+ },
606
+ "completedAt": { "$ref": "#/$defs/instant" }
607
+ },
608
+ "dependentRequired": {
609
+ "responseDigest": ["responseBytes"],
610
+ "responseBytes": ["responseDigest"]
611
+ },
612
+ "allOf": [
613
+ {
614
+ "if": { "properties": { "contentAvailable": { "const": true } }, "required": ["contentAvailable"] },
615
+ "then": {
616
+ "required": ["responseDigest", "responseBytes"],
617
+ "properties": {
618
+ "responseDigest": { "$ref": "#/$defs/digest" },
619
+ "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
620
+ }
621
+ }
622
+ }
623
+ ]
624
+ },
625
+ "artifact": {
626
+ "type": "object",
627
+ "additionalProperties": false,
628
+ "required": ["schemaVersion", "operationId", "artifactKey", "assistantTurnId", "sourceIdentityDigest", "kind", "ordinal", "status"],
629
+ "properties": {
630
+ "schemaVersion": { "const": "chatgpt.browser_control.operation_artifact_receipt.v1" },
631
+ "operationId": { "$ref": "#/$defs/uuid" },
632
+ "artifactKey": { "$ref": "#/$defs/opaqueKey" },
633
+ "assistantTurnId": { "$ref": "#/$defs/opaqueId" },
634
+ "sourceIdentityDigest": { "$ref": "#/$defs/digest" },
635
+ "kind": { "enum": ["file", "image", "other"] },
636
+ "ordinal": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
637
+ "outputKey": { "$ref": "#/$defs/outputKey" },
638
+ "mimeType": {
639
+ "type": "string",
640
+ "minLength": 1,
641
+ "maxLength": 127,
642
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+/-]{0,126}$"
643
+ },
644
+ "bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
645
+ "sha256": { "$ref": "#/$defs/sha256" },
646
+ "status": { "enum": ["available", "transferred", "partial", "blocked"] },
647
+ "blockerCode": { "$ref": "#/$defs/code" }
648
+ },
649
+ "allOf": [
650
+ {
651
+ "if": { "properties": { "status": { "const": "transferred" } }, "required": ["status"] },
652
+ "then": {
653
+ "required": ["outputKey", "bytes", "sha256"],
654
+ "properties": {
655
+ "outputKey": { "$ref": "#/$defs/outputKey" },
656
+ "bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
657
+ "sha256": { "$ref": "#/$defs/sha256" }
658
+ }
659
+ }
660
+ },
661
+ {
662
+ "if": { "properties": { "status": { "enum": ["partial", "blocked"] } }, "required": ["status"] },
663
+ "then": {
664
+ "required": ["blockerCode"],
665
+ "properties": { "blockerCode": { "$ref": "#/$defs/code" } }
666
+ }
667
+ },
668
+ {
669
+ "if": { "properties": { "status": { "enum": ["available", "transferred"] } }, "required": ["status"] },
670
+ "then": { "not": { "required": ["blockerCode"] } }
671
+ }
672
+ ]
673
+ },
674
+ "opaqueKey": {
675
+ "type": "string",
676
+ "minLength": 1,
677
+ "maxLength": 128,
678
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
679
+ },
680
+ "outputKey": {
681
+ "type": "string",
682
+ "minLength": 1,
683
+ "maxLength": 128,
684
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
685
+ },
686
+ "sha256": {
687
+ "type": "string",
688
+ "pattern": "^[0-9a-f]{64}$"
689
+ }
690
+ }
691
+ }