@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operate-allowed-action.schema.json

@@ -0,0 +1,181 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-allowed-action.schema.json",
+  "x-openplanr-contract": { "id": "operate-allowed-action", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 allowed action",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["tool", "arguments", "label", "effect"],
+  "properties": {
+    "tool": { "type": "string", "enum": ["operate.cycle.start", "operate.cycle.get", "operate.cycle.resume", "operate.assignment.claim", "operate.assignment.submit", "operate.artifact.get", "operate.review.get", "operate.review.submit", "operate.action.approve", "operate.action.execute", "operate.action.rollback", "operate.recovery.inspect", "operate.recovery.restore", "operate.recovery.clear-stale-lock"] },
+    "arguments": {},
+    "label": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" }
+    },
+    "effect": { "type": "string", "enum": ["read-only", "machine-local-write", "project-write", "provider-call", "external-effect", "destructive"] }
+  },
+  "oneOf": [
+    { "title": "operate.cycle.start", "properties": { "tool": { "const": "operate.cycle.start" }, "arguments": { "$ref": "#/$defs/cycleStartArguments" }, "effect": { "const": "project-write" } } },
+    { "title": "operate.cycle.get", "properties": { "tool": { "const": "operate.cycle.get" }, "arguments": { "$ref": "#/$defs/cycleIdentityArguments" }, "effect": { "const": "read-only" } } },
+    { "title": "operate.cycle.resume", "properties": { "tool": { "const": "operate.cycle.resume" }, "arguments": { "$ref": "#/$defs/cycleIdentityArguments" }, "effect": { "const": "project-write" } } },
+    { "title": "operate.assignment.claim", "properties": { "tool": { "const": "operate.assignment.claim" }, "arguments": { "$ref": "#/$defs/assignmentClaimArguments" }, "effect": { "const": "machine-local-write" } } },
+    { "title": "operate.assignment.submit", "properties": { "tool": { "const": "operate.assignment.submit" }, "arguments": { "$ref": "#/$defs/assignmentSubmitArguments" }, "effect": { "const": "machine-local-write" } } },
+    { "title": "operate.artifact.get", "properties": { "tool": { "const": "operate.artifact.get" }, "arguments": { "$ref": "#/$defs/artifactGetArguments" }, "effect": { "const": "read-only" } } },
+    { "title": "operate.review.get", "properties": { "tool": { "const": "operate.review.get" }, "arguments": { "$ref": "#/$defs/reviewIdentityArguments" }, "effect": { "const": "read-only" } } },
+    { "title": "operate.review.submit", "properties": { "tool": { "const": "operate.review.submit" }, "arguments": { "$ref": "#/$defs/reviewSubmitArguments" }, "effect": { "const": "project-write" } } },
+    { "title": "operate.action.approve", "properties": { "tool": { "const": "operate.action.approve" }, "arguments": { "$ref": "#/$defs/actionApproveArguments" }, "effect": { "const": "project-write" } } },
+    { "title": "operate.action.execute", "properties": { "tool": { "const": "operate.action.execute" }, "arguments": { "$ref": "#/$defs/actionExecuteArguments" }, "effect": { "const": "project-write" } } },
+    { "title": "operate.action.rollback", "properties": { "tool": { "const": "operate.action.rollback" }, "arguments": { "$ref": "#/$defs/actionRollbackArguments" }, "effect": { "const": "project-write" } } },
+    { "title": "operate.recovery.inspect", "properties": { "tool": { "const": "operate.recovery.inspect" }, "arguments": { "type": "object", "additionalProperties": false }, "effect": { "const": "read-only" } } },
+    { "title": "operate.recovery.restore", "properties": { "tool": { "const": "operate.recovery.restore" }, "arguments": { "type": "object", "additionalProperties": false, "required": ["generation"], "properties": { "generation": { "$ref": "#/$defs/nonPlaceholder" } } }, "effect": { "const": "destructive" } } },
+    { "title": "operate.recovery.clear-stale-lock", "properties": { "tool": { "const": "operate.recovery.clear-stale-lock" }, "arguments": { "type": "object", "additionalProperties": false }, "effect": { "const": "machine-local-write" } } }
+  ],
+  "$defs": {
+    "cycleStartArguments": {
+      "type": "object", "additionalProperties": false, "required": ["scope", "focus", "trigger", "mode", "ownerActorId"],
+      "properties": {
+        "scope": {
+          "type": "object", "additionalProperties": false, "required": ["scopeId", "domainId", "domainVersion"],
+          "properties": {
+            "scopeId": { "$ref": "#/$defs/nonPlaceholder" },
+            "domainId": { "$ref": "#/$defs/nonPlaceholder" },
+            "domainVersion": { "allOf": [{ "$ref": "#/$defs/nonPlaceholder" }, { "maxLength": 64 }] }
+          }
+        },
+        "focus": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/nonPlaceholder" } },
+        "trigger": {
+          "type": "object", "additionalProperties": false, "required": ["kind"],
+          "properties": { "kind": { "const": "manual" } }
+        },
+        "mode": { "type": "string", "enum": ["standard", "preview"] },
+        "ownerActorId": { "$ref": "#/$defs/nonPlaceholder" },
+        "deliveryRoute": { "type": "string", "enum": ["contained-execution", "planning-work", "human-external", "observe-only"] }
+      }
+    },
+    "cycleIdentityArguments": {
+      "type": "object", "additionalProperties": false, "required": ["cycleId"],
+      "properties": { "cycleId": { "$ref": "#/$defs/nonPlaceholder" } }
+    },
+    "assignmentClaimArguments": {
+      "type": "object", "additionalProperties": false, "required": ["assignmentId", "actor"],
+      "properties": {
+        "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actor": { "$ref": "#/$defs/publicActor" }
+      }
+    },
+    "assignmentSubmitArguments": {
+      "type": "object", "additionalProperties": false, "required": ["assignmentId", "submissionId", "actor", "mediaType", "encoding", "contentBase64"],
+      "properties": {
+        "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "submissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actor": { "$ref": "#/$defs/publicActor" },
+        "mediaType": { "$ref": "#/$defs/nonPlaceholder" },
+        "encoding": { "type": "string", "enum": ["utf-8", "binary"] },
+        "contentBase64": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }
+      }
+    },
+    "artifactGetArguments": {
+      "type": "object", "additionalProperties": false, "required": ["artifactId", "representation", "actor", "scope", "assignmentId"],
+      "properties": {
+        "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "representation": { "type": "string", "enum": ["raw", "canonical", "metadata", "decoded-json"] },
+        "actor": { "$ref": "#/$defs/publicActor" },
+        "scope": { "$ref": "#/$defs/scope" },
+        "assignmentId": { "type": ["string", "null"], "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }
+      },
+      "allOf": [{
+        "if": { "properties": { "actor": { "properties": { "kind": { "const": "agent" } }, "required": ["kind"] } }, "required": ["actor"] },
+        "then": { "properties": { "assignmentId": { "type": "string" } } }
+      }]
+    },
+    "reviewIdentityArguments": {
+      "type": "object", "additionalProperties": false, "required": ["reviewId", "cycleId", "actor", "scope"],
+      "properties": {
+        "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "cycleId": { "type": "string", "pattern": "^cyc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actor": { "$ref": "#/$defs/humanActor" },
+        "scope": { "$ref": "#/$defs/scope" }
+      }
+    },
+    "reviewSubmitArguments": {
+      "type": "object", "additionalProperties": false, "required": ["reviewId", "cycleId", "actor", "scope", "disposition", "workDispositions"],
+      "properties": {
+        "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "cycleId": { "type": "string", "pattern": "^cyc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actor": { "$ref": "#/$defs/humanActor" },
+        "scope": { "$ref": "#/$defs/scope" },
+        "disposition": { "type": "string", "enum": ["approved", "changes_requested", "rejected", "cancelled"] },
+        "workDispositions": { "type": "array", "maxItems": 1024, "uniqueItems": true, "items": { "$ref": "operating-review.schema.json#/$defs/workDisposition" } }
+      }
+    },
+    "actionIdentity": {
+      "type": "object", "additionalProperties": false, "required": ["actionId", "revision", "actionHash"],
+      "properties": {
+        "actionId": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "revision": { "type": "integer", "minimum": 1 },
+        "actionHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "actionApproveArguments": {
+      "type": "object", "additionalProperties": false, "required": ["action", "decision"],
+      "properties": {
+        "action": { "$ref": "#/$defs/actionIdentity" }, "decision": { "enum": ["approved", "rejected", "deferred"] },
+        "rollback": {
+          "type": "object", "additionalProperties": false,
+          "required": ["rollbackPlanId", "planHash", "originalOperationId", "executionResultId", "expectedTargetHash"],
+          "properties": {
+            "rollbackPlanId": { "type": "string", "pattern": "^rbp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+            "planHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+            "originalOperationId": { "type": "string", "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+            "executionResultId": { "type": "string", "pattern": "^xres_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+            "expectedTargetHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+          }
+        }
+      }
+    },
+    "actionExecuteArguments": {
+      "type": "object", "additionalProperties": false, "required": ["action"],
+      "properties": { "action": { "$ref": "#/$defs/actionIdentity" } }
+    },
+    "actionRollbackArguments": {
+      "type": "object", "additionalProperties": false, "required": ["action", "originalOperationId", "rollbackPlanId"],
+      "properties": {
+        "action": { "$ref": "#/$defs/actionIdentity" }, "originalOperationId": { "type": "string", "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "rollbackPlanId": { "type": "string", "pattern": "^rbp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }
+      }
+    },
+    "publicActor": {
+      "type": "object", "additionalProperties": false, "required": ["actorId", "kind", "runtime"],
+      "properties": {
+        "actorId": { "$ref": "#/$defs/nonPlaceholder" },
+        "kind": { "type": "string", "enum": ["agent", "human"] },
+        "runtime": { "$ref": "#/$defs/nonPlaceholder" }
+      }
+    },
+    "humanActor": {
+      "type": "object", "additionalProperties": false, "required": ["actorId", "kind", "runtime"],
+      "properties": {
+        "actorId": { "$ref": "#/$defs/nonPlaceholder" },
+        "kind": { "const": "human" },
+        "runtime": { "$ref": "#/$defs/nonPlaceholder" }
+      }
+    },
+    "scope": {
+      "type": "object", "additionalProperties": false, "required": ["scopeId", "domainId", "domainVersion"],
+      "properties": {
+        "scopeId": { "$ref": "#/$defs/nonPlaceholder" },
+        "domainId": { "$ref": "#/$defs/nonPlaceholder" },
+        "domainVersion": { "allOf": [{ "$ref": "#/$defs/nonPlaceholder" }, { "maxLength": 64 }] }
+      }
+    },
+    "nonPlaceholder": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" }
+    }
+  }
+}

package/schemas/v2.0.0/operate-api-envelope.schema.json

@@ -0,0 +1,225 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-api-envelope.schema.json",
+  "x-openplanr-contract": { "id": "operate-api-envelope", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 API envelope",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["ok", "operation", "allowedActions"],
+  "properties": {
+    "ok": { "type": "boolean" },
+    "operation": { "$ref": "#/$defs/toolName" },
+    "data": {},
+    "error": { "$ref": "#/$defs/error" },
+    "allowedActions": { "type": "array", "items": { "$ref": "operate-allowed-action.schema.json" } }
+  },
+  "oneOf": [
+    { "title": "cycle.start success", "$ref": "#/$defs/cycleStartSuccess" },
+    { "title": "cycle.get success", "$ref": "#/$defs/cycleGetSuccess" },
+    { "title": "cycle.resume success", "$ref": "#/$defs/cycleResumeSuccess" },
+    { "title": "assignment.claim success", "$ref": "#/$defs/assignmentClaimSuccess" },
+    { "title": "assignment.submit success", "$ref": "#/$defs/assignmentSubmitSuccess" },
+    { "title": "artifact.get success", "$ref": "#/$defs/artifactGetSuccess" },
+    { "title": "review.get success", "$ref": "#/$defs/reviewGetSuccess" },
+    { "title": "review.submit success", "$ref": "#/$defs/reviewSubmitSuccess" },
+    { "title": "action.approve success", "$ref": "#/$defs/actionApproveSuccess" },
+    { "title": "action.execute success", "$ref": "#/$defs/actionExecuteSuccess" },
+    { "title": "action.rollback success", "$ref": "#/$defs/actionRollbackSuccess" },
+    { "title": "recovery.inspect success", "$ref": "#/$defs/recoveryInspectSuccess" },
+    { "title": "failure", "required": ["error"], "properties": { "ok": { "const": false } }, "not": { "required": ["data"] } }
+  ],
+  "$defs": {
+    "toolName": { "type": "string", "enum": ["operate.cycle.start", "operate.cycle.get", "operate.cycle.resume", "operate.assignment.claim", "operate.assignment.submit", "operate.artifact.get", "operate.review.get", "operate.review.submit", "operate.action.approve", "operate.action.execute", "operate.action.rollback", "operate.recovery.inspect", "operate.recovery.restore", "operate.recovery.clear-stale-lock"] },
+    "error": {
+      "type": "object", "additionalProperties": false, "required": ["code", "message", "retryable", "context"],
+      "properties": {
+        "code": { "type": "string", "enum": ["ARTIFACT_NOT_FOUND", "ARTIFACT_HASH_MISMATCH", "ANCESTRY_MISMATCH", "ASSIGNMENT_ALREADY_CLAIMED", "ASSIGNMENT_ALREADY_SUBMITTED", "ASSIGNMENT_NOT_AVAILABLE", "CAPABILITY_DENIED", "CONCURRENT_MODIFICATION", "CONTRACT_VERSION_UNSUPPORTED", "CONSENT_REQUIRED", "CYCLE_NOT_FOUND", "CYCLE_TERMINAL", "DOMAIN_CONTRACT_UNSUPPORTED", "EVIDENCE_LOCATOR_INVALID", "EVIDENCE_PROVIDER_UNAVAILABLE", "EVIDENCE_RESOLUTION_FAILED", "EVIDENCE_RESOLVER_UNAVAILABLE", "EVIDENCE_RESOLVER_UNREGISTERED", "EVIDENCE_RESOLVER_VERSION_UNSUPPORTED", "EVIDENCE_SOURCE_SCOPE_MISMATCH", "LINE_RANGE_INVALID", "OBJECT_TYPE_MISMATCH", "OPERATING_PROVIDER_INPUT_INVALID", "OPERATING_PROVIDER_UNAVAILABLE", "OPERATING_SCOPE_INVALID", "PATH_NOT_FOUND", "REVIEW_NOT_AUTHORIZED", "REVIEW_NOT_FOUND", "REVIEW_NOT_PENDING", "RESULT_CONTRACT_INVALID", "REVISION_NOT_FOUND", "SECRET_DETECTED", "SENSITIVITY_BLOCKED", "SOURCE_NOT_FOUND", "SOURCE_STALE", "SOURCE_UNTRACKED", "STATE_TRANSITION_INVALID", "SUBMISSION_ID_CONFLICT", "UNSUPPORTED_EVIDENCE_KIND", "ACTION_NOT_FOUND", "ACTION_REVISION_MISMATCH", "POLICY_EVALUATION_REJECTED", "POLICY_EVALUATION_DEFERRED", "POLICY_PROHIBITED", "APPROVAL_REQUIRED", "APPROVAL_INVALID", "APPROVAL_EXPIRED", "CAPABILITY_UNAVAILABLE", "CAPABILITY_GRANT_INVALID", "CAPABILITY_GRANT_CONSUMED", "CAPABILITY_PROVIDER_UNAVAILABLE", "POLICY_PROVIDER_UNAVAILABLE", "EXECUTOR_UNAVAILABLE", "OPERATION_CONFLICT", "OPERATION_UNCERTAIN", "ROLLBACK_NOT_ELIGIBLE"] },
+        "message": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "retryable": { "type": "boolean" },
+        "context": { "$ref": "#/$defs/safeErrorContext" }
+      }
+    },
+    "successBase": { "required": ["data"], "properties": { "ok": { "const": true } }, "not": { "required": ["error"] } },
+    "cycleStartSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.cycle.start" }, "data": { "$ref": "#/$defs/cycleView" } } }] },
+    "cycleGetSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.cycle.get" }, "data": { "$ref": "#/$defs/cycleView" } } }] },
+    "cycleResumeSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.cycle.resume" }, "data": { "$ref": "#/$defs/cycleView" } } }] },
+    "assignmentClaimSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.assignment.claim" }, "data": { "$ref": "#/$defs/assignmentClaim" } } }] },
+    "assignmentSubmitSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.assignment.submit" }, "data": { "$ref": "#/$defs/submissionAcceptance" } } }] },
+    "artifactGetSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.artifact.get" }, "data": { "$ref": "#/$defs/artifactRepresentation" } } }] },
+    "reviewGetSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.review.get" }, "data": { "$ref": "operating-review-read.schema.json" } } }] },
+    "reviewSubmitSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.review.submit" }, "data": { "$ref": "operating-review-receipt.schema.json" } } }] },
+    "actionApproveSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.action.approve" }, "data": { "$ref": "#/$defs/actionApproval" } } }] },
+    "actionExecuteSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.action.execute" }, "data": { "$ref": "operating-governed-operation.schema.json" } } }] },
+    "actionRollbackSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.action.rollback" }, "data": { "$ref": "operating-governed-operation.schema.json" } } }] },
+    "recoveryInspectSuccess": { "allOf": [{ "$ref": "#/$defs/successBase" }, { "properties": { "operation": { "const": "operate.recovery.inspect" }, "data": { "$ref": "#/$defs/recoveryInspection" } } }] },
+    "actionApproval": { "type": "object", "additionalProperties": false, "required": ["action", "evaluation", "requirements", "approvals"], "properties": { "action": { "$ref": "operating-action.schema.json" }, "evaluation": { "$ref": "operating-policy-evaluation.schema.json" }, "requirements": { "type": "array", "items": { "$ref": "operating-approval-requirement.schema.json" } }, "approvals": { "type": "array", "items": { "$ref": "operating-approval-record.schema.json" } } } },
+    "cycleView": {
+      "type": "object", "additionalProperties": false,
+      "required": ["cycle", "progress", "availableAssignments", "acceptedArtifactIds", "persistentWork", "actions"],
+      "properties": {
+        "cycle": { "$ref": "operating-cycle.schema.json" },
+        "progress": {
+          "type": "object", "additionalProperties": false,
+          "required": ["total", "pending", "available", "active", "submitted", "validated", "rejected", "terminal"],
+          "properties": {
+            "total": { "type": "integer", "minimum": 0 }, "pending": { "type": "integer", "minimum": 0 }, "available": { "type": "integer", "minimum": 0 }, "active": { "type": "integer", "minimum": 0 }, "submitted": { "type": "integer", "minimum": 0 }, "validated": { "type": "integer", "minimum": 0 }, "rejected": { "type": "integer", "minimum": 0 }, "terminal": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "availableAssignments": { "type": "array", "items": { "$ref": "operating-assignment.schema.json" } },
+        "acceptedArtifactIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } },
+        "persistentWork": {
+          "type": "object", "additionalProperties": false, "required": ["ledger", "cycleLinks"],
+          "properties": {
+            "ledger": { "$ref": "operating-work-ledger.schema.json" },
+            "cycleLinks": { "type": "array", "items": { "$ref": "operating-work-ledger.schema.json#/$defs/cycleLink" } }
+          }
+        },
+        "actions": { "type": "array", "items": { "$ref": "operate-allowed-action.schema.json" } }
+      }
+    },
+    "reviewSubmit": {
+      "type": "object", "additionalProperties": false,
+      "required": ["review", "cycle"],
+      "properties": {
+        "review": { "$ref": "operating-review.schema.json" },
+        "cycle": { "$ref": "operating-cycle.schema.json" }
+      }
+    },
+    "assignmentClaim": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assignment", "submissionId", "capabilities"],
+      "properties": {
+        "assignment": {
+          "allOf": [
+            { "$ref": "operating-assignment.schema.json" },
+            { "properties": { "state": { "const": "running" } }, "required": ["state"] }
+          ]
+        },
+        "capabilities": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+        "submissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }
+      }
+    },
+    "submissionAcceptance": {
+      "type": "object", "additionalProperties": false,
+      "required": ["accepted", "artifactId", "rawHash", "sizeBytes", "assignmentState"],
+      "properties": {
+        "accepted": { "const": true },
+        "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "rawHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "sizeBytes": { "type": "integer", "minimum": 0 },
+        "assignmentState": { "const": "validated" }
+      }
+    },
+    "contractRef": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaId", "schemaVersion", "mediaType", "encoding", "maxBytes"],
+      "properties": {
+        "schemaId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "schemaVersion": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "mediaType": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "encoding": { "type": "string", "enum": ["utf-8", "binary"] },
+        "maxBytes": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "safeErrorContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "operation": { "$ref": "#/$defs/safeToken" },
+        "cycleId": { "$ref": "#/$defs/safeToken" },
+        "assignmentId": { "$ref": "#/$defs/safeToken" },
+        "submissionId": { "$ref": "#/$defs/safeToken" },
+        "submissionState": { "$ref": "#/$defs/safeToken" },
+        "reviewId": { "$ref": "#/$defs/safeToken" },
+        "state": { "$ref": "#/$defs/safeToken" },
+        "maxBytes": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "safeToken": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" }
+    },
+    "artifactRepresentation": {
+      "type": "object", "additionalProperties": false, "required": ["metadata", "representation"],
+      "properties": {
+        "metadata": { "$ref": "operating-artifact.schema.json" },
+        "representation": { "type": "string", "enum": ["raw", "canonical", "metadata", "decoded-json"] },
+        "contentBase64": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" },
+        "contentJson": {}
+      },
+      "oneOf": [
+        { "title": "raw bytes", "required": ["contentBase64"], "properties": { "representation": { "const": "raw" } }, "not": { "required": ["contentJson"] } },
+        { "title": "canonical bytes", "required": ["contentBase64"], "properties": { "representation": { "const": "canonical" } }, "not": { "required": ["contentJson"] } },
+        { "title": "metadata only", "properties": { "representation": { "const": "metadata" } }, "not": { "anyOf": [{ "required": ["contentBase64"] }, { "required": ["contentJson"] }] } },
+        {
+          "title": "verified decoded JSON",
+          "required": ["contentJson"],
+          "properties": {
+            "representation": { "const": "decoded-json" },
+            "metadata": {
+              "allOf": [
+                { "$ref": "operating-artifact.schema.json" },
+                { "properties": { "mediaType": { "const": "application/json" }, "encoding": { "const": "utf-8" } } }
+              ]
+            }
+          },
+          "not": { "required": ["contentBase64"] }
+        }
+      ]
+    },
+    "recoveryInspection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "currentGeneration",
+        "recoverableGeneration",
+        "generationCount",
+        "reason",
+        "allowedRecovery",
+        "lock",
+        "integrityBoundary"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["healthy", "empty", "corrupt", "incompatible", "locked", "repairable"]
+        },
+        "currentGeneration": { "type": "string", "minLength": 1 },
+        "recoverableGeneration": { "type": ["string", "null"], "minLength": 1 },
+        "generationCount": { "type": "integer", "minimum": 0 },
+        "reason": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "allowedRecovery": {
+          "type": "string",
+          "enum": ["none", "clear-stale-lock", "restore-generation"]
+        },
+        "lock": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "ownerPid", "nonce", "expiresAt", "reason"],
+          "properties": {
+            "status": { "type": "string", "enum": ["absent", "active", "stale"] },
+            "ownerPid": { "type": ["integer", "null"], "minimum": 0 },
+            "nonce": { "type": ["string", "null"], "minLength": 1 },
+            "expiresAt": { "type": ["string", "null"], "format": "date-time" },
+            "reason": { "type": "string", "maxLength": 2048 }
+          }
+        },
+        "integrityBoundary": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["model", "detects", "authenticity", "outsideBoundary", "futureRequirement"],
+          "properties": {
+            "model": { "type": "string", "minLength": 1 },
+            "detects": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+            "authenticity": { "type": "string", "minLength": 1 },
+            "outsideBoundary": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+            "futureRequirement": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operate-capability-provider-registration.schema.json",
+  "x-openplanr-contract": { "id": "operate-capability-provider-registration", "version": "2.0.0" }, "title": "OpenPlanr Operate 2.0 capability provider registration",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "capabilities", "supportedActionKinds", "supportedDomains", "supportedTargetKinds", "effectCeiling", "inputContract", "outputContract", "errorContract", "errorCodes", "timeoutPolicy", "retryPolicy", "idempotency", "reconciliation", "health", "versionCompatibility", "provenance", "conformanceDigest", "implementation", "fallback"],
+  "properties": {
+    "kind": { "const": "operate-capability-provider-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" },
+    "capabilities": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/versionedId" } }, "supportedActionKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/versionedId" } }, "supportedDomains": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "supportedTargetKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "effectCeiling": { "$ref": "#/$defs/effect" },
+    "inputContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-action" } } }] }, "outputContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-capability-availability" } } }] }, "errorContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operate-api-envelope" } } }] },
+    "errorCodes": { "$ref": "#/$defs/errorCodes" }, "timeoutPolicy": { "$ref": "#/$defs/timeoutPolicy" }, "retryPolicy": { "$ref": "#/$defs/retryPolicy" }, "idempotency": { "$ref": "#/$defs/idempotency" }, "reconciliation": { "$ref": "#/$defs/reconciliation" }, "health": { "$ref": "#/$defs/health" }, "versionCompatibility": { "$ref": "#/$defs/versionCompatibility" },
+    "provenance": { "$ref": "#/$defs/provenance" }, "conformanceDigest": { "$ref": "#/$defs/hash" }, "implementation": { "$ref": "#/$defs/implementation" }, "fallback": { "$ref": "#/$defs/fallback" }
+  }, "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "effect": { "enum": ["read-only", "machine-local-write", "project-write", "provider-call", "external-effect"] }, "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } }, "contract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "$ref": "#/$defs/id" }, "schemaVersion": { "const": "2.0.0" } } },
+    "errorCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" } },
+    "timeoutPolicy": { "type": "object", "additionalProperties": false, "required": ["timeoutMs", "onTimeout"], "properties": { "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 300000 }, "onTimeout": { "const": "fail-closed" } } },
+    "retryPolicy": { "type": "object", "additionalProperties": false, "required": ["maxAttempts", "backoff", "retryableErrorCodes"], "properties": { "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 3 }, "backoff": { "enum": ["none", "fixed"] }, "retryableErrorCodes": { "$ref": "#/$defs/errorCodes" } } },
+    "idempotency": { "type": "object", "additionalProperties": false, "required": ["keySource", "replay", "intrinsicallyIdempotent"], "properties": { "keySource": { "const": "runtime-derived-request-fingerprint" }, "replay": { "const": "return-recorded-result" }, "intrinsicallyIdempotent": { "type": "boolean" } } },
+    "reconciliation": {
+      "type": "object", "additionalProperties": false, "required": ["supported", "mode"],
+      "properties": { "supported": { "type": "boolean" }, "mode": { "enum": ["none", "deterministic"] } },
+      "oneOf": [
+        { "properties": { "supported": { "const": false }, "mode": { "const": "none" } } },
+        { "properties": { "supported": { "const": true }, "mode": { "const": "deterministic" } } }
+      ]
+    },
+    "health": { "type": "object", "additionalProperties": false, "required": ["status", "checkedAt", "expiresAt", "healthHash"], "properties": { "status": { "enum": ["available", "degraded", "unavailable"] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "healthHash": { "$ref": "#/$defs/hash" } } },
+    "versionCompatibility": { "type": "object", "additionalProperties": false, "required": ["protocolVersion", "minimumRuntimeVersion", "maximumRuntimeVersion"], "properties": { "protocolVersion": { "const": "2.0.0" }, "minimumRuntimeVersion": { "$ref": "#/$defs/version" }, "maximumRuntimeVersion": { "type": ["string", "null"], "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" } } },
+    "provenance": { "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"], "properties": { "packageName": { "$ref": "#/$defs/id" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/hash" } } }, "implementation": { "type": "object", "additionalProperties": false, "required": ["source", "id"], "properties": { "source": { "enum": ["built-in", "public-optional", "external"] }, "id": { "$ref": "#/$defs/id" } } }, "fallback": { "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"], "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "CAPABILITY_PROVIDER_UNAVAILABLE" } } }
+  }
+}