owlrunkit 0.13.0

package/scripts/runkit-contract/schemas/resource-preflight-request-v1.schema.json

@@ -0,0 +1,178 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/resource-preflight-request-v1.json",
+  "title": "OwlCoda RunKit Resource Preflight Request V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "preflightId",
+    "verificationPlanPath",
+    "verificationPlanSha256",
+    "policy",
+    "observations",
+    "workloads"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitResourcePreflightRequestV1" },
+    "preflightId": { "$ref": "#/$defs/identifier" },
+    "verificationPlanPath": { "type": "string", "minLength": 1 },
+    "verificationPlanSha256": { "$ref": "#/$defs/sha256" },
+    "policy": { "$ref": "#/$defs/policy" },
+    "observations": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/observation" }
+    },
+    "workloads": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/workload" }
+    }
+  },
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+    },
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "unknownPolicy": { "enum": ["fail_open", "fail_closed"] },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["gateMode", "maxObservationAgeMs", "unknownHandling", "limits"],
+      "properties": {
+        "gateMode": { "enum": ["model_required", "model_optional"] },
+        "maxObservationAgeMs": { "type": "integer", "minimum": 1 },
+        "unknownHandling": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["availability", "quota", "resetTime", "pricing"],
+          "properties": {
+            "availability": { "$ref": "#/$defs/unknownPolicy" },
+            "quota": { "$ref": "#/$defs/unknownPolicy" },
+            "resetTime": { "$ref": "#/$defs/unknownPolicy" },
+            "pricing": { "$ref": "#/$defs/unknownPolicy" }
+          }
+        },
+        "limits": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "maxCalls": { "type": "integer", "minimum": 0 },
+            "maxTotalTokens": { "type": "integer", "minimum": 0 },
+            "maxElapsedMs": { "type": "integer", "minimum": 0 },
+            "maxCostUsd": { "type": "number", "minimum": 0 }
+          }
+        }
+      }
+    },
+    "unknown": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "reason"],
+      "properties": {
+        "status": { "const": "unknown" },
+        "reason": { "type": "string", "minLength": 1 }
+      }
+    },
+    "knownInteger": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "value"],
+      "properties": {
+        "status": { "const": "known" },
+        "value": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "knownTimestamp": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "value"],
+      "properties": {
+        "status": { "const": "known" },
+        "value": { "type": "string", "format": "date-time" }
+      }
+    },
+    "observation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["providerId", "modelId", "adapter", "availability", "quota", "pricing"],
+      "properties": {
+        "providerId": { "$ref": "#/$defs/identifier" },
+        "modelId": { "$ref": "#/$defs/identifier" },
+        "adapter": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "kind", "evidenceRef", "evidenceSha256", "observedAt"],
+          "properties": {
+            "id": { "$ref": "#/$defs/identifier" },
+            "kind": { "enum": ["owlcoda_runtime", "provider_api", "project_declared"] },
+            "evidenceRef": { "type": "string", "minLength": 1 },
+            "evidenceSha256": { "$ref": "#/$defs/sha256" },
+            "observedAt": { "type": "string", "format": "date-time" }
+          }
+        },
+        "availability": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["status"],
+              "properties": { "status": { "const": "available" } }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["status", "reason"],
+              "properties": {
+                "status": { "enum": ["unavailable", "unknown"] },
+                "reason": { "type": "string", "minLength": 1 }
+              }
+            }
+          ]
+        },
+        "quota": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["remainingCalls", "remainingTokens", "resetAt"],
+          "properties": {
+            "remainingCalls": { "oneOf": [{ "$ref": "#/$defs/knownInteger" }, { "$ref": "#/$defs/unknown" }] },
+            "remainingTokens": { "oneOf": [{ "$ref": "#/$defs/knownInteger" }, { "$ref": "#/$defs/unknown" }] },
+            "resetAt": { "oneOf": [{ "$ref": "#/$defs/knownTimestamp" }, { "$ref": "#/$defs/unknown" }] }
+          }
+        },
+        "pricing": {
+          "oneOf": [
+            { "$ref": "#/$defs/unknown" },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["status", "currency", "inputPerMillion", "outputPerMillion"],
+              "properties": {
+                "status": { "const": "known" },
+                "currency": { "const": "USD" },
+                "inputPerMillion": { "type": "number", "minimum": 0 },
+                "outputPerMillion": { "type": "number", "minimum": 0 }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "workload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "providerId", "modelId", "calls", "inputTokens", "outputTokens", "elapsedMs"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "providerId": { "$ref": "#/$defs/identifier" },
+        "modelId": { "$ref": "#/$defs/identifier" },
+        "calls": { "type": "integer", "minimum": 1 },
+        "inputTokens": { "type": "integer", "minimum": 0 },
+        "outputTokens": { "type": "integer", "minimum": 0 },
+        "elapsedMs": { "type": "integer", "minimum": 0 },
+        "coveredByReceiptId": { "$ref": "#/$defs/identifier" }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/resource-preflight-v1.schema.json

@@ -0,0 +1,153 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/resource-preflight-v1.json",
+  "title": "OwlCoda RunKit Resource Preflight V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "runId",
+    "preflightId",
+    "sequence",
+    "evaluatedAt",
+    "validUntil",
+    "requestSha256",
+    "verificationPlan",
+    "policy",
+    "receiptReuse",
+    "estimate",
+    "resources",
+    "decision",
+    "authorizationGranted",
+    "gitAuthorization",
+    "releaseAuthorization"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitResourcePreflightV1" },
+    "runId": { "$ref": "#/$defs/identifier" },
+    "preflightId": { "$ref": "#/$defs/identifier" },
+    "sequence": { "type": "integer", "minimum": 1 },
+    "evaluatedAt": { "type": "string", "format": "date-time" },
+    "validUntil": { "type": ["string", "null"], "format": "date-time" },
+    "requestSha256": { "$ref": "#/$defs/sha256" },
+    "verificationPlan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "planId"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "sha256": { "$ref": "#/$defs/sha256" },
+        "planId": { "$ref": "#/$defs/identifier" }
+      }
+    },
+    "policy": { "$ref": "resource-preflight-request-v1.schema.json#/$defs/policy" },
+    "receiptReuse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["verificationPlanId", "reusableReceiptIds", "appliedReceiptIds"],
+      "properties": {
+        "verificationPlanId": { "$ref": "#/$defs/identifier" },
+        "reusableReceiptIds": { "$ref": "#/$defs/identifierArray" },
+        "appliedReceiptIds": { "$ref": "#/$defs/identifierArray" }
+      }
+    },
+    "estimate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "plannedWorkloads",
+        "reusedWorkloads",
+        "pendingWorkloads",
+        "calls",
+        "inputTokens",
+        "outputTokens",
+        "totalTokens",
+        "elapsedMs",
+        "cost"
+      ],
+      "properties": {
+        "plannedWorkloads": { "$ref": "#/$defs/nonNegativeInteger" },
+        "reusedWorkloads": { "$ref": "#/$defs/nonNegativeInteger" },
+        "pendingWorkloads": { "$ref": "#/$defs/nonNegativeInteger" },
+        "calls": { "$ref": "#/$defs/nonNegativeInteger" },
+        "inputTokens": { "$ref": "#/$defs/nonNegativeInteger" },
+        "outputTokens": { "$ref": "#/$defs/nonNegativeInteger" },
+        "totalTokens": { "$ref": "#/$defs/nonNegativeInteger" },
+        "elapsedMs": { "$ref": "#/$defs/nonNegativeInteger" },
+        "cost": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["status", "valueUsd"],
+              "properties": {
+                "status": { "const": "known" },
+                "valueUsd": { "type": "number", "minimum": 0 }
+              }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["status", "knownSubtotalUsd", "unknownResources"],
+              "properties": {
+                "status": { "const": "unknown" },
+                "knownSubtotalUsd": { "type": "number", "minimum": 0 },
+                "unknownResources": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "resources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["providerId", "modelId", "adapter", "availability", "quota", "pricing", "demand"],
+        "properties": {
+          "providerId": { "$ref": "#/$defs/identifier" },
+          "modelId": { "$ref": "#/$defs/identifier" },
+          "adapter": { "$ref": "resource-preflight-request-v1.schema.json#/$defs/observation/properties/adapter" },
+          "availability": { "$ref": "resource-preflight-request-v1.schema.json#/$defs/observation/properties/availability" },
+          "quota": { "$ref": "resource-preflight-request-v1.schema.json#/$defs/observation/properties/quota" },
+          "pricing": { "$ref": "resource-preflight-request-v1.schema.json#/$defs/observation/properties/pricing" },
+          "demand": { "$ref": "#/$defs/demand" }
+        }
+      }
+    },
+    "decision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "blockers", "warnings", "nextAllowedAction"],
+      "properties": {
+        "status": { "enum": ["ready_for_model_execution", "ready_without_model_execution", "blocked_by_resource"] },
+        "blockers": { "$ref": "#/$defs/stringArray" },
+        "warnings": { "$ref": "#/$defs/stringArray" },
+        "nextAllowedAction": { "enum": ["begin_model_execution", "continue_without_model_calls", "pause_at_deterministic_stage"] }
+      }
+    },
+    "authorizationGranted": { "const": false },
+    "gitAuthorization": { "const": false },
+    "releaseAuthorization": { "const": false }
+  },
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nonNegativeInteger": { "type": "integer", "minimum": 0 },
+    "identifierArray": { "type": "array", "items": { "$ref": "#/$defs/identifier" }, "uniqueItems": true },
+    "stringArray": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+    "demand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["calls", "inputTokens", "outputTokens", "totalTokens", "elapsedMs"],
+      "properties": {
+        "calls": { "$ref": "#/$defs/nonNegativeInteger" },
+        "inputTokens": { "$ref": "#/$defs/nonNegativeInteger" },
+        "outputTokens": { "$ref": "#/$defs/nonNegativeInteger" },
+        "totalTokens": { "$ref": "#/$defs/nonNegativeInteger" },
+        "elapsedMs": { "$ref": "#/$defs/nonNegativeInteger" }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/resume-attempt-v1.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/resume-attempt-v1.json",
+  "title": "OwlCoda RunKit Resume Attempt V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "resumeId",
+    "mode",
+    "runId",
+    "sourceRunId",
+    "reason",
+    "parentGoal",
+    "parentCloseout",
+    "inheritedEvidence",
+    "nextAllowedAction",
+    "requiredWorkflow",
+    "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitResumeAttemptV1" },
+    "resumeId": { "type": "string", "minLength": 1 },
+    "mode": { "enum": ["same_execution", "continuation"] },
+    "runId": { "type": "string", "minLength": 1 },
+    "sourceRunId": { "type": "string", "minLength": 1 },
+    "reason": { "type": "string", "minLength": 1 },
+    "parentGoal": { "$ref": "#/$defs/artifactRef" },
+    "parentCloseout": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["decision", "path", "sha256"],
+          "properties": {
+            "decision": { "enum": ["accepted", "rejected", "blocked"] },
+            "path": { "type": "string", "minLength": 1 },
+            "sha256": { "$ref": "#/$defs/sha256" }
+          }
+        }
+      ]
+    },
+    "inheritedEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["coverageIndexPath", "coverageIndexSha256", "reusableReceiptIds"],
+      "properties": {
+        "coverageIndexPath": { "type": "string", "minLength": 1 },
+        "coverageIndexSha256": { "$ref": "#/$defs/sha256" },
+        "reusableReceiptIds": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        }
+      }
+    },
+    "nextAllowedAction": { "const": "acquire_writer_lease" },
+    "requiredWorkflow": {
+      "const": [
+        "acquire_writer_lease",
+        "prepare_or_replace_delivery_packet",
+        "verify_plan"
+      ]
+    },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "artifactRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/resume-request-v1.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/resume-request-v1.json",
+  "title": "OwlCoda RunKit Resume Request V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "resumeId", "continuationRunId", "reason", "coverage"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitResumeRequestV1" },
+    "resumeId": { "type": "string", "minLength": 1 },
+    "continuationRunId": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "string", "minLength": 1 }
+      ]
+    },
+    "reason": { "type": "string", "minLength": 1 },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["coverageId", "sources"],
+      "properties": {
+        "coverageId": { "type": "string", "minLength": 1 },
+        "sources": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/coverageSource" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "coverageSource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["gateInputPath", "gateInputSha256", "commandBindings", "dependencyBindings"],
+      "properties": {
+        "gateInputPath": { "type": "string", "minLength": 1 },
+        "gateInputSha256": { "$ref": "#/$defs/sha256" },
+        "commandBindings": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["receiptCommandId", "profileId", "commandId"],
+            "properties": {
+              "receiptCommandId": { "type": "string", "minLength": 1 },
+              "profileId": { "type": "string", "minLength": 1 },
+              "commandId": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "dependencyBindings": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["dependencyId", "source"],
+            "properties": {
+              "dependencyId": { "type": "string", "minLength": 1 },
+              "source": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["kind", "identity"],
+                "properties": {
+                  "kind": { "enum": ["lockfile", "fixture", "material_input"] },
+                  "identity": { "type": "string", "minLength": 1 }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/snapshot-v1.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/snapshot-v1.json",
+  "title": "OwlCoda RunKit Snapshot V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "snapshotId", "status", "mode", "targetRoot", "verificationContextFingerprint", "repositoryBefore", "repositoryAfter", "command", "authorizationGranted"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitSnapshotV1" },
+    "runId": { "type": "string", "minLength": 1 },
+    "snapshotId": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["snapshot_passed", "snapshot_failed", "invalidated_by_target_write"] },
+    "mode": { "enum": ["project", "foreign_readonly"] },
+    "targetRoot": { "type": "string", "minLength": 1 },
+    "verificationContextFingerprint": { "$ref": "#/$defs/sha256" },
+    "repositoryBefore": { "$ref": "#/$defs/repositoryState" },
+    "repositoryAfter": { "$ref": "#/$defs/repositoryState" },
+    "command": { "$ref": "#/$defs/command" },
+    "visual": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["automationManifestPath", "resultPath", "result", "issues"],
+      "properties": {
+        "automationManifestPath": { "type": "string", "minLength": 1 },
+        "resultPath": { "type": "string", "minLength": 1 },
+        "result": { "type": ["object", "null"] },
+        "issues": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "fileMap": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/sha256" }
+    },
+    "repositoryState": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["head", "statusMode", "statusSha256", "statusByteCount", "statusEntryCount", "selectedFiles", "manifestFingerprint"],
+      "properties": {
+        "head": { "type": "string", "minLength": 1 },
+        "statusMode": { "const": "porcelain-v1-z-untracked-all-runkit-excluded" },
+        "statusSha256": { "$ref": "#/$defs/sha256" },
+        "statusByteCount": { "type": "integer", "minimum": 0 },
+        "statusEntryCount": { "type": "integer", "minimum": 0 },
+        "selectedFiles": { "$ref": "#/$defs/fileMap" },
+        "manifestFingerprint": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "command": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["startedAt", "endedAt", "durationMs", "exitCode", "stdoutPath", "stdoutSha256", "stdoutLineCount", "stderrPath", "stderrSha256", "stderrLineCount", "evidence"],
+      "properties": {
+        "startedAt": { "type": "string", "minLength": 1 },
+        "endedAt": { "type": "string", "minLength": 1 },
+        "durationMs": { "type": "integer", "minimum": 0 },
+        "exitCode": { "type": "integer" },
+        "stdoutPath": { "type": "string", "minLength": 1 },
+        "stdoutSha256": { "$ref": "#/$defs/sha256" },
+        "stdoutLineCount": { "type": "integer", "minimum": 0 },
+        "stderrPath": { "type": "string", "minLength": 1 },
+        "stderrSha256": { "$ref": "#/$defs/sha256" },
+        "stderrLineCount": { "type": "integer", "minimum": 0 },
+        "evidence": { "$ref": "replayable-evidence-v1.schema.json" }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/verification-context-v1.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/verification-context-v1.json",
+  "title": "OwlCoda RunKit Verification Context V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "reusePolicy", "platform", "toolchains", "lockfiles", "fixtures", "services", "environment"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitVerificationContextV1" },
+    "reusePolicy": { "enum": ["portable", "platform_bound", "environment_bound"] },
+    "platform": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["os", "arch"],
+          "properties": {
+            "os": { "type": "string", "minLength": 1 },
+            "arch": { "type": "string", "minLength": 1 }
+          }
+        }
+      ]
+    },
+    "toolchains": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/nameVersion" }
+    },
+    "lockfiles": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/pathHash" }
+    },
+    "fixtures": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/idHash" }
+    },
+    "services": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "identity"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "identity": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "environment": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "valueSha256"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "valueSha256": { "$ref": "#/$defs/sha256" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nameVersion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 }
+      }
+    },
+    "pathHash": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "idHash": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "sha256"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    }
+  }
+}