@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operate-review-bound-submission.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-review-bound-submission.schema.json",
+  "x-openplanr-contract": { "id": "operate-review-bound-submission", "version": "1.0.0" },
+  "title": "OpenPlanr owner-bound Review submission",
+  "description": "Additive wrapper that binds one exact advertised Review choice and optional owner note to the source Event head without changing the legacy operate.review.submit tool arguments.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "expectedReadEventHead", "choiceId",
+    "choiceHash", "submitArguments", "note", "boundSubmissionHash"
+  ],
+  "properties": {
+    "kind": { "const": "operate-review-bound-submission" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "expectedReadEventHead": { "$ref": "operating-review-read.schema.json#/$defs/eventHead" },
+    "choiceId": { "$ref": "operating-review-read.schema.json#/$defs/dispositionChoice/properties/choiceId" },
+    "choiceHash": { "$ref": "operating-review-read.schema.json#/$defs/hash" },
+    "submitArguments": { "$ref": "operating-review-read.schema.json#/$defs/reviewSubmitArguments" },
+    "note": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^\\S(?:[\\s\\S]*\\S)?$" }
+      ]
+    },
+    "boundSubmissionHash": { "$ref": "operating-review-read.schema.json#/$defs/hash" }
+  }
+}

package/schemas/v2.0.0/operate-review-display-workspace.schema.json

@@ -0,0 +1,390 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-review-display-workspace.schema.json",
+  "x-openplanr-contract": { "id": "operate-review-display-workspace", "version": "1.0.0" },
+  "title": "OpenPlanr browser-verifiable owner Review display workspace",
+  "description": "Access-safe, content-hashed projection over either one verified pending operating-review-read or one immutable terminal operating-review-receipt and its exact actor-bound experience view.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "payload", "integrity"],
+  "properties": {
+    "kind": { "const": "operate-review-display-workspace" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "payload": { "$ref": "#/$defs/workspace" },
+    "integrity": { "$ref": "#/$defs/integrity" }
+  },
+  "$defs": {
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok", "kind", "schemaVersion", "protocolVersion", "readOnly", "mutationEnabled",
+        "scopeId", "domainId", "domainVersion", "cycleId", "reviewId", "actorId", "accessLevel",
+        "generatedAt", "sourceArtifactKind", "sourceArtifactHash", "sourceEventHead", "sourceReadEventHead",
+        "sourceViewHash", "status", "reasonCodes", "data"
+      ],
+      "properties": {
+        "ok": { "const": true },
+        "kind": { "const": "operate-review-workspace" },
+        "schemaVersion": { "const": "1.0.0" },
+        "protocolVersion": { "const": "2.0.0" },
+        "readOnly": { "const": true },
+        "mutationEnabled": { "type": "boolean" },
+        "scopeId": { "$ref": "operate-experience-view.schema.json#/$defs/id" },
+        "domainId": { "$ref": "operate-experience-view.schema.json#/$defs/id" },
+        "domainVersion": { "$ref": "operate-experience-view.schema.json#/$defs/version" },
+        "cycleId": { "$ref": "operating-review-read.schema.json#/$defs/cycleId" },
+        "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actorId": { "$ref": "operate-experience-view.schema.json#/$defs/id" },
+        "accessLevel": { "$ref": "operate-experience-view.schema.json#/$defs/accessLevel" },
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "sourceArtifactKind": { "enum": ["operating-review-read", "operating-review-receipt"] },
+        "sourceArtifactHash": { "$ref": "operate-experience-view.schema.json#/$defs/hash" },
+        "sourceEventHead": { "$ref": "operate-experience-view.schema.json#/$defs/eventHead" },
+        "sourceReadEventHead": { "$ref": "operate-experience-view.schema.json#/$defs/eventHead" },
+        "sourceViewHash": { "$ref": "operate-experience-view.schema.json#/$defs/hash" },
+        "status": { "enum": ["ready", "read-only", "stale", "partial", "blocked", "offline", "terminal"] },
+        "reasonCodes": {
+          "type": "array", "maxItems": 128, "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{0,127}$" }
+        },
+        "data": { "$ref": "#/$defs/data" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "sourceArtifactKind": { "const": "operating-review-read" } }, "required": ["sourceArtifactKind"] },
+          "then": {
+            "properties": {
+              "status": { "not": { "const": "terminal" } },
+              "data": {
+                "properties": {
+                  "review": { "properties": { "state": { "const": "pending" }, "disposition": { "type": "null" } }, "required": ["state", "disposition"] },
+                  "choices": { "minItems": 1 },
+                  "terminalDisposition": { "type": "null" }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "sourceArtifactKind": { "const": "operating-review-receipt" } }, "required": ["sourceArtifactKind"] },
+          "then": {
+            "properties": {
+              "status": { "const": "terminal" },
+              "mutationEnabled": { "const": false },
+              "reasonCodes": { "contains": { "const": "REVIEW_TERMINAL" } },
+              "data": {
+                "properties": {
+                  "review": { "properties": { "state": { "enum": ["approved", "changes_requested", "rejected", "cancelled"] } }, "required": ["state"] },
+                  "choices": { "maxItems": 0 },
+                  "terminalDisposition": { "$ref": "#/$defs/terminalDisposition" },
+                  "capability": {
+                    "properties": { "available": { "const": false }, "actions": { "maxItems": 0 } },
+                    "required": ["available", "actions"]
+                  }
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "data": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "review", "policyBinding", "executiveSummary", "recommendation", "choices", "findings", "dissent",
+        "uncertainty", "gaps", "claims", "evidence", "omissions", "traceMatrix", "truthSummary", "terminalDisposition", "capability"
+      ],
+      "properties": {
+        "review": { "$ref": "operating-review.schema.json" },
+        "policyBinding": { "$ref": "#/$defs/policyBinding" },
+        "executiveSummary": { "$ref": "#/$defs/executiveSummary" },
+        "recommendation": { "$ref": "#/$defs/recommendation" },
+        "choices": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/choice" } },
+        "findings": { "type": "array", "maxItems": 256, "items": { "$ref": "operating-review-read.schema.json#/$defs/findingSummary" } },
+        "dissent": { "type": "array", "maxItems": 256, "items": { "$ref": "operating-review-read.schema.json#/$defs/dissentSummary" } },
+        "uncertainty": { "type": "array", "maxItems": 2048, "items": { "$ref": "#/$defs/uncertainty" } },
+        "gaps": { "type": "array", "maxItems": 2048, "items": { "$ref": "operating-review-read.schema.json#/$defs/gapSummary" } },
+        "claims": { "type": "array", "maxItems": 4096, "items": { "$ref": "operate-experience-view.schema.json#/$defs/claim" } },
+        "evidence": { "type": "array", "maxItems": 4096, "items": { "$ref": "operate-experience-view.schema.json#/$defs/evidence" } },
+        "omissions": { "type": "array", "maxItems": 4096, "items": { "$ref": "#/$defs/omission" } },
+        "traceMatrix": {
+          "oneOf": [
+            { "type": "null" },
+            { "$ref": "operating-trace-matrix.schema.json" }
+          ]
+        },
+        "truthSummary": { "$ref": "#/$defs/sharedTruthSummary" },
+        "terminalDisposition": {
+          "oneOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/terminalDisposition" }
+          ]
+        },
+        "capability": { "$ref": "#/$defs/capability" }
+      }
+    },
+    "policyBinding": {
+      "type": "object", "additionalProperties": false,
+      "required": ["sourceContract", "ownerActorId", "actorMatchesOwner", "authorityBoundary", "externalEffectsAuthorized"],
+      "properties": {
+        "sourceContract": {
+          "type": "object", "additionalProperties": false, "required": ["id", "version"],
+          "properties": { "id": { "const": "operating-review" }, "version": { "const": "2.0.0" } }
+        },
+        "ownerActorId": { "$ref": "operate-experience-view.schema.json#/$defs/id" },
+        "actorMatchesOwner": { "type": "boolean" },
+        "authorityBoundary": { "const": "review-only" },
+        "externalEffectsAuthorized": { "const": false }
+      }
+    },
+    "executiveSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["text", "decisionCount", "actionCount", "findingCount", "dissentCount", "gapCount", "uncertaintyCount"],
+      "properties": {
+        "text": { "$ref": "operating-review-read.schema.json#/$defs/text" },
+        "decisionCount": { "type": "integer", "minimum": 0 },
+        "actionCount": { "type": "integer", "minimum": 0 },
+        "findingCount": { "type": "integer", "minimum": 0 },
+        "dissentCount": { "type": "integer", "minimum": 0 },
+        "gapCount": { "type": "integer", "minimum": 0 },
+        "uncertaintyCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "recommendation": {
+      "oneOf": [
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["status", "items", "absence"],
+          "properties": {
+            "status": { "const": "available" },
+            "items": { "type": "array", "minItems": 1, "maxItems": 256, "items": { "$ref": "operating-review-read.schema.json#/$defs/decisionSummary" } },
+            "absence": { "type": "null" }
+          }
+        },
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["status", "items", "absence"],
+          "properties": {
+            "status": { "const": "absent" },
+            "items": { "type": "array", "maxItems": 0 },
+            "absence": { "$ref": "#/$defs/unavailableReason" }
+          }
+        }
+      ]
+    },
+    "choice": {
+      "type": "object", "additionalProperties": false,
+      "required": ["choiceId", "choiceHash", "label", "submitArguments", "consequence", "reversibility", "requiredDispositions"],
+      "properties": {
+        "choiceId": { "$ref": "operating-review-read.schema.json#/$defs/dispositionChoice/properties/choiceId" },
+        "choiceHash": { "$ref": "operate-experience-view.schema.json#/$defs/hash" },
+        "label": { "$ref": "operating-review-read.schema.json#/$defs/title" },
+        "submitArguments": { "$ref": "operating-review-read.schema.json#/$defs/reviewSubmitArguments" },
+        "consequence": { "$ref": "operating-review-read.schema.json#/$defs/text" },
+        "reversibility": { "enum": ["immutable-review-event", "separately-governed-follow-on"] },
+        "requiredDispositions": {
+          "type": "array", "maxItems": 1024, "uniqueItems": true,
+          "items": { "$ref": "operating-review.schema.json#/$defs/workDisposition" }
+        }
+      }
+    },
+    "uncertainty": {
+      "type": "object", "additionalProperties": false,
+      "required": ["uncertaintyId", "sourceKind", "sourceId", "statement"],
+      "properties": {
+        "uncertaintyId": { "$ref": "operate-experience-view.schema.json#/$defs/id" },
+        "sourceKind": { "enum": ["decision", "claim", "evidence", "gap"] },
+        "sourceId": { "$ref": "operate-experience-view.schema.json#/$defs/id" },
+        "statement": { "$ref": "operating-review-read.schema.json#/$defs/text" }
+      }
+    },
+    "omission": {
+      "type": "object", "additionalProperties": false,
+      "required": ["kind", "subject", "count", "subjectIds", "reasonCode"],
+      "properties": {
+        "kind": { "enum": ["restricted", "absent"] },
+        "subject": { "enum": ["evidence", "claim", "seat", "source"] },
+        "count": { "type": "integer", "minimum": 1 },
+        "subjectIds": { "type": "array", "maxItems": 4096, "uniqueItems": true, "items": { "$ref": "operate-experience-view.schema.json#/$defs/id" } },
+        "reasonCode": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{0,127}$" }
+      }
+    },
+    "sharedTruthSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["kind", "schemaVersion", "sourceEventHead", "sourceViewHash", "stages", "proof", "seats", "evidence", "claims", "verification", "attention", "omissions"],
+      "properties": {
+        "kind": { "const": "operate-shared-truth-summary" },
+        "schemaVersion": { "const": "1.0.0" },
+        "sourceEventHead": { "$ref": "operate-experience-view.schema.json#/$defs/eventHead" },
+        "sourceViewHash": { "$ref": "operate-experience-view.schema.json#/$defs/hash" },
+        "stages": { "$ref": "#/$defs/stageCounts" },
+        "proof": { "$ref": "#/$defs/proofCounts" },
+        "seats": { "$ref": "#/$defs/seatCounts" },
+        "evidence": { "$ref": "#/$defs/evidenceCounts" },
+        "claims": { "$ref": "#/$defs/claimCounts" },
+        "verification": { "$ref": "#/$defs/verificationCounts" },
+        "attention": { "$ref": "#/$defs/attentionCounts" },
+        "omissions": { "$ref": "#/$defs/summaryOmissions" }
+      }
+    },
+    "stageCounts": {
+      "type": "object", "additionalProperties": false,
+      "required": ["cycles", "total", "complete", "current", "available", "waiting", "blocked", "failed", "skipped", "uncertain", "revisited", "byStage"],
+      "properties": {
+        "cycles": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 },
+        "complete": { "type": "integer", "minimum": 0 }, "current": { "type": "integer", "minimum": 0 },
+        "available": { "type": "integer", "minimum": 0 }, "waiting": { "type": "integer", "minimum": 0 },
+        "blocked": { "type": "integer", "minimum": 0 }, "failed": { "type": "integer", "minimum": 0 },
+        "skipped": { "type": "integer", "minimum": 0 }, "uncertain": { "type": "integer", "minimum": 0 },
+        "revisited": { "type": "integer", "minimum": 0 },
+        "byStage": {
+          "type": "array", "minItems": 7, "maxItems": 7,
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["id", "complete", "current", "available", "waiting", "blocked", "failed", "skipped", "uncertain", "revisited"],
+            "properties": {
+              "id": { "enum": ["observe", "understand", "decide", "govern", "act", "verify", "learn"] },
+              "complete": { "type": "integer", "minimum": 0 }, "current": { "type": "integer", "minimum": 0 },
+              "available": { "type": "integer", "minimum": 0 }, "waiting": { "type": "integer", "minimum": 0 },
+              "blocked": { "type": "integer", "minimum": 0 }, "failed": { "type": "integer", "minimum": 0 },
+              "skipped": { "type": "integer", "minimum": 0 }, "uncertain": { "type": "integer", "minimum": 0 },
+              "revisited": { "type": "integer", "minimum": 0 }
+            }
+          }
+        }
+      }
+    },
+    "proofCounts": {
+      "type": "object", "additionalProperties": false,
+      "required": ["status", "linkedEvidence", "restrictedEvidence", "resolvedClaims", "unresolvedClaims", "verifiedOutcomes", "unverifiedOutcomes", "reasonCodes"],
+      "properties": {
+        "status": { "enum": ["verified", "unverified", "partial", "not-required"] },
+        "linkedEvidence": { "type": "integer", "minimum": 0 }, "restrictedEvidence": { "type": "integer", "minimum": 0 },
+        "resolvedClaims": { "type": "integer", "minimum": 0 }, "unresolvedClaims": { "type": "integer", "minimum": 0 },
+        "verifiedOutcomes": { "type": "integer", "minimum": 0 }, "unverifiedOutcomes": { "type": "integer", "minimum": 0 },
+        "reasonCodes": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{0,127}$" } }
+      }
+    },
+    "seatCounts": {
+      "type": "object", "additionalProperties": false,
+      "required": ["total", "terminal", "validated", "rejected", "failed", "abandoned", "active", "pending", "typedAbsences"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 }, "terminal": { "type": "integer", "minimum": 0 },
+        "validated": { "type": "integer", "minimum": 0 }, "rejected": { "type": "integer", "minimum": 0 },
+        "failed": { "type": "integer", "minimum": 0 },
+        "abandoned": { "type": "integer", "minimum": 0 }, "active": { "type": "integer", "minimum": 0 },
+        "pending": { "type": "integer", "minimum": 0 }, "typedAbsences": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "evidenceCounts": {
+      "type": "object", "additionalProperties": false,
+      "required": ["total", "available", "restricted", "current", "historical", "stale", "linked", "omitted"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 }, "available": { "type": "integer", "minimum": 0 },
+        "restricted": { "type": "integer", "minimum": 0 }, "current": { "type": "integer", "minimum": 0 },
+        "historical": { "type": "integer", "minimum": 0 }, "stale": { "type": "integer", "minimum": 0 },
+        "linked": { "type": "integer", "minimum": 0 }, "omitted": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "claimCounts": {
+      "type": "object", "additionalProperties": false,
+      "required": ["total", "supported", "contradicted", "uncertain", "unknown", "restricted"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 }, "supported": { "type": "integer", "minimum": 0 },
+        "contradicted": { "type": "integer", "minimum": 0 }, "uncertain": { "type": "integer", "minimum": 0 },
+        "unknown": { "type": "integer", "minimum": 0 }, "restricted": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "verificationCounts": {
+      "type": "object", "additionalProperties": false,
+      "required": ["total", "verified", "unverified", "notRequired", "insufficientEvidence"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 }, "verified": { "type": "integer", "minimum": 0 },
+        "unverified": { "type": "integer", "minimum": 0 }, "notRequired": { "type": "integer", "minimum": 0 },
+        "insufficientEvidence": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "attentionCounts": {
+      "type": "object", "additionalProperties": false,
+      "required": ["total", "blocking", "actionable", "unavailable"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 }, "blocking": { "type": "integer", "minimum": 0 },
+        "actionable": { "type": "integer", "minimum": 0 }, "unavailable": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "summaryOmissions": {
+      "type": "object", "additionalProperties": false,
+      "required": ["total", "restricted", "absent", "reasonCodes"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 }, "restricted": { "type": "integer", "minimum": 0 },
+        "absent": { "type": "integer", "minimum": 0 },
+        "reasonCodes": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{0,127}$" } }
+      }
+    },
+    "terminalDisposition": {
+      "type": "object", "additionalProperties": false,
+      "required": [
+        "receiptId", "decision", "appliedChoiceId", "appliedChoiceHash", "appliedWorkDispositions",
+        "readEventHead", "eventHead", "committedAt"
+      ],
+      "properties": {
+        "receiptId": { "type": "string", "pattern": "^rrc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "decision": { "enum": ["approved", "changes_requested", "rejected", "cancelled"] },
+        "appliedChoiceId": { "$ref": "operating-review-read.schema.json#/$defs/dispositionChoice/properties/choiceId" },
+        "appliedChoiceHash": { "$ref": "operate-experience-view.schema.json#/$defs/hash" },
+        "appliedWorkDispositions": {
+          "type": "array", "maxItems": 1024, "uniqueItems": true,
+          "items": { "$ref": "operating-review.schema.json#/$defs/workDisposition" }
+        },
+        "readEventHead": { "$ref": "operate-experience-view.schema.json#/$defs/eventHead" },
+        "eventHead": { "$ref": "operate-experience-view.schema.json#/$defs/eventHead" },
+        "committedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "capability": {
+      "oneOf": [
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["available", "actions", "reason"],
+          "properties": {
+            "available": { "const": true },
+            "actions": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "operate-experience-view.schema.json#/$defs/boundAllowedAction" } },
+            "reason": { "type": "null" }
+          }
+        },
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["available", "actions", "reason"],
+          "properties": {
+            "available": { "const": false },
+            "actions": { "type": "array", "maxItems": 0 },
+            "reason": { "$ref": "#/$defs/unavailableReason" }
+          }
+        }
+      ]
+    },
+    "unavailableReason": {
+      "type": "object", "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{0,127}$" },
+        "message": { "$ref": "operating-review-read.schema.json#/$defs/title" }
+      }
+    },
+    "integrity": {
+      "type": "object", "additionalProperties": false,
+      "required": ["algorithm", "domain", "sourceArtifactKind", "sourceViewHash", "sourceArtifactHash", "contentHash"],
+      "properties": {
+        "algorithm": { "const": "sha-256-jcs" },
+        "domain": { "const": "openplanr:operate-review-display-workspace:1.0.0" },
+        "sourceArtifactKind": { "enum": ["operating-review-read", "operating-review-receipt"] },
+        "sourceViewHash": { "$ref": "operate-experience-view.schema.json#/$defs/hash" },
+        "sourceArtifactHash": { "$ref": "operate-experience-view.schema.json#/$defs/hash" },
+        "contentHash": { "$ref": "operate-experience-view.schema.json#/$defs/hash" }
+      }
+    }
+  }
+}

package/schemas/v2.0.0/operate-snapshot-provider-registration.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-snapshot-provider-registration.schema.json",
+  "x-openplanr-contract": { "id": "operate-snapshot-provider-registration", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 snapshot provider declaration",
+  "description": "A data-only, non-authorizing descriptor for a public built-in that returns an accepted-input snapshot candidate. It cannot name executable code, a connection, a credential, or an effect.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "supportedDomains", "inputContract", "outputContract", "accessMode", "returnSemantics", "errorCodes", "provenance", "conformanceDigest", "implementation", "fallback"],
+  "properties": {
+    "kind": { "const": "operate-snapshot-provider-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" }, "supportedDomains": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/domain" } }, "inputContract": { "$ref": "#/$defs/inputContract" }, "outputContract": { "$ref": "#/$defs/outputContract" }, "accessMode": { "enum": ["accepted-input-only", "declared-read-only"] }, "returnSemantics": { "const": "candidate" }, "errorCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["OPERATING_PROVIDER_INPUT_INVALID", "OPERATING_PROVIDER_UNAVAILABLE"] } }, "provenance": { "$ref": "#/$defs/provenance" }, "conformanceDigest": { "$ref": "#/$defs/hash" }, "implementation": { "$ref": "#/$defs/builtIn" }, "fallback": { "$ref": "#/$defs/fallback" }
+  },
+  "$defs": {
+    "builtIn": { "type": "object", "additionalProperties": false, "required": ["kind", "id"], "properties": { "kind": { "const": "built-in" }, "id": { "$ref": "#/$defs/id" } } }, "domain": { "type": "object", "additionalProperties": false, "required": ["apiDomainId", "domainContractId", "domainContractVersion"], "properties": { "apiDomainId": { "$ref": "#/$defs/id" }, "domainContractId": { "$ref": "#/$defs/id" }, "domainContractVersion": { "$ref": "#/$defs/version" } } }, "fallback": { "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"], "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "OPERATING_PROVIDER_UNAVAILABLE" } } }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "inputContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "enum": ["operating-artifact", "operating-snapshot"] }, "schemaVersion": { "const": "2.0.0" } } }, "outputContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "const": "operating-snapshot" }, "schemaVersion": { "const": "2.0.0" } } }, "provenance": { "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"], "properties": { "packageName": { "$ref": "#/$defs/id" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/hash" } } }, "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" }
+  }
+}