engineering-behavior-observatory 0.2.1

package/schemas/aggregation.v1.json

@@ -0,0 +1,293 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:ebo:schema:aggregation:v1",
+  "$defs": {
+    "identifier": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": ".*\\S.*" },
+    "path": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": ".*\\S.*" },
+    "derivedSource": {
+      "type": "object", "additionalProperties": false, "required": ["bundleRoot", "path"],
+      "properties": { "bundleRoot": { "$ref": "#/$defs/path" }, "path": { "$ref": "#/$defs/path" } }
+    },
+    "eligibilityGate": {
+      "type": "object", "additionalProperties": false, "required": ["request", "report"],
+      "properties": { "request": { "$ref": "#/$defs/path" }, "report": { "$ref": "#/$defs/path" } }
+    },
+    "dimension": { "enum": ["task", "model", "harness", "trial", "capture-qualification"] },
+    "filters": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "task": { "$ref": "#/$defs/identifier" },
+        "model": { "$ref": "#/$defs/identifier" },
+        "harness": { "$ref": "#/$defs/identifier" },
+        "trial": { "$ref": "#/$defs/identifier" },
+        "capture-qualification": { "$ref": "#/$defs/identifier" }
+      }
+    },
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "sources", "groupBy", "selectedAttemptPolicy", "recurrence", "comparisons"],
+      "properties": {
+        "schemaVersion": { "const": "ebo.aggregation-request/v1" },
+        "sources": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["corpusRoot", "corpusIndex", "observationSets", "assertions", "calibrations"],
+          "properties": {
+            "corpusRoot": { "$ref": "#/$defs/path" },
+            "corpusIndex": { "$ref": "#/$defs/path" },
+            "observationSets": { "type": "array", "maxItems": 100000, "items": { "$ref": "#/$defs/derivedSource" } },
+            "assertions": { "type": "array", "maxItems": 100000, "items": { "$ref": "#/$defs/derivedSource" } },
+            "calibrations": {
+              "type": "array",
+              "maxItems": 100000,
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["selection", "history"],
+                "properties": { "selection": { "$ref": "#/$defs/path" }, "history": { "$ref": "#/$defs/path" } }
+              }
+            }
+          }
+        },
+        "groupBy": { "type": "array", "maxItems": 5, "uniqueItems": true, "items": { "$ref": "#/$defs/dimension" } },
+        "selectedAttemptPolicy": { "enum": ["all-attempts", "latest-attempt-per-run"] },
+        "recurrence": {
+          "type": "object", "additionalProperties": false, "required": ["minimumOccurrences"],
+          "properties": { "minimumOccurrences": { "type": "integer", "minimum": 2 } }
+        },
+        "comparisons": {
+          "type": "array",
+          "maxItems": 100000,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "measure", "left", "right", "matchBy", "eligibilityGates"],
+            "properties": {
+              "id": { "$ref": "#/$defs/identifier" },
+              "measure": { "$ref": "#/$defs/identifier" },
+              "left": { "$ref": "#/$defs/filters" },
+              "right": { "$ref": "#/$defs/filters" },
+              "matchBy": { "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "$ref": "#/$defs/dimension" } },
+              "eligibilityGates": { "type": "array", "minItems": 1, "maxItems": 100000, "items": { "$ref": "#/$defs/eligibilityGate" } }
+            }
+          }
+        }
+      }
+    },
+    "quantity": {
+      "type": "object", "additionalProperties": false, "required": ["value", "unit"],
+      "properties": { "value": { "type": "number" }, "unit": { "$ref": "#/$defs/identifier" } }
+    },
+    "exclusion": {
+      "type": "object", "additionalProperties": false, "required": ["reason", "count", "unit"],
+      "properties": { "reason": { "$ref": "#/$defs/identifier" }, "count": { "type": "integer", "minimum": 0 }, "unit": { "$ref": "#/$defs/identifier" } }
+    },
+    "measurement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "numerator", "denominator", "exclusions"],
+      "properties": {
+        "status": { "enum": ["available", "unavailable"] },
+        "numerator": { "$ref": "#/$defs/quantity" },
+        "denominator": { "$ref": "#/$defs/quantity" },
+        "rate": { "type": "number" },
+        "exclusions": { "type": "array", "maxItems": 100000, "items": { "$ref": "#/$defs/exclusion" } },
+        "reason": { "$ref": "#/$defs/identifier" }
+      },
+      "allOf": [
+        { "if": { "properties": { "status": { "const": "available" } } }, "then": { "required": ["rate"] } },
+        { "if": { "properties": { "status": { "const": "unavailable" } } }, "then": { "required": ["reason"], "not": { "required": ["rate"] } } }
+      ]
+    },
+    "metric": {
+      "type": "object", "additionalProperties": false, "required": ["id", "population", "claimStatus", "measurement"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "population": { "enum": ["run", "attempt", "operation", "assertion", "reviewed-assertion"] },
+        "claimStatus": { "enum": ["descriptive", "unavailable"] },
+        "measurement": { "$ref": "#/$defs/measurement" }
+      }
+    },
+    "sourceLineage": {
+      "type": "object", "additionalProperties": false,
+      "required": ["requestDigest", "corpusIndexDigest", "manifests", "observationSets", "assertions", "calibrations", "comparisonGates"],
+      "properties": {
+        "requestDigest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" },
+        "corpusIndexDigest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" },
+        "manifests": {
+          "type": "array", "maxItems": 100000,
+          "items": { "type": "object", "additionalProperties": false, "required": ["runId", "attemptId", "digest"], "properties": {
+            "runId": { "$ref": "#/$defs/identifier" }, "attemptId": { "$ref": "#/$defs/identifier" }, "digest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" }
+          } }
+        },
+        "observationSets": {
+          "type": "array", "maxItems": 100000,
+          "items": { "type": "object", "additionalProperties": false, "required": ["runId", "attemptId", "digest"], "properties": {
+            "runId": { "$ref": "#/$defs/identifier" }, "attemptId": { "$ref": "#/$defs/identifier" }, "digest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" }
+          } }
+        },
+        "assertions": {
+          "type": "array", "maxItems": 100000,
+          "items": { "type": "object", "additionalProperties": false, "required": ["runId", "attemptId", "id", "digest"], "properties": {
+            "runId": { "$ref": "#/$defs/identifier" }, "attemptId": { "$ref": "#/$defs/identifier" }, "id": { "$ref": "#/$defs/identifier" }, "digest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" }
+          } }
+        },
+        "calibrations": {
+          "type": "array", "maxItems": 100000,
+          "items": { "type": "object", "additionalProperties": false, "required": ["selectionDigest", "historyDigest"], "properties": {
+            "selectionDigest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" }, "historyDigest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" }
+          } }
+        },
+        "comparisonGates": {
+          "type": "array", "maxItems": 100000,
+          "items": { "type": "object", "additionalProperties": false, "required": ["requestDigest", "reportDigest"], "properties": {
+            "requestDigest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" }, "reportDigest": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/digest" }
+          } }
+        }
+      }
+    },
+    "behaviorAggregate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["behavior","rubric","evaluator","population","assessments","assertions"],
+      "properties": {
+        "behavior": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["vocabularyVersion","categoryId","dimensionId"],
+          "properties": {
+            "vocabularyVersion": {"$ref":"#/$defs/identifier"},
+            "categoryId": {"$ref":"#/$defs/identifier"},
+            "dimensionId": {"$ref":"#/$defs/identifier"}
+          }
+        },
+        "rubric": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id","version"],
+          "properties": {"id":{"$ref":"#/$defs/identifier"},"version":{"$ref":"#/$defs/identifier"}}
+        },
+        "evaluator": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id","version"],
+          "properties": {
+            "id": {"$ref":"#/$defs/identifier"},
+            "version": {"$ref":"#/$defs/identifier"},
+            "configurationDigest": {"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}
+          }
+        },
+        "population": {"const":"confirmed-attempt-dimension"},
+        "assessments": {
+          "type": "array",
+          "minItems": 4,
+          "maxItems": 4,
+          "allOf": [
+            {"contains":{"properties":{"assessment":{"const":"constructive"}},"required":["assessment"]},"minContains":1,"maxContains":1},
+            {"contains":{"properties":{"assessment":{"const":"adverse"}},"required":["assessment"]},"minContains":1,"maxContains":1},
+            {"contains":{"properties":{"assessment":{"const":"mixed"}},"required":["assessment"]},"minContains":1,"maxContains":1},
+            {"contains":{"properties":{"assessment":{"const":"context-dependent"}},"required":["assessment"]},"minContains":1,"maxContains":1}
+          ],
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["assessment","measurement"],
+            "properties": {
+              "assessment": {"enum":["constructive","adverse","mixed","context-dependent"]},
+              "measurement": {"$ref":"#/$defs/measurement"}
+            }
+          }
+        },
+        "assertions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["runId","attemptId","id","digest","reviewOutcome","disputed","included"],
+            "properties": {
+              "runId": {"$ref":"#/$defs/identifier"},
+              "attemptId": {"$ref":"#/$defs/identifier"},
+              "id": {"$ref":"#/$defs/identifier"},
+              "digest": {"$ref":"urn:ebo:schema:normalization-integrity:v1#/$defs/digest"},
+              "reviewOutcome": {"enum":["confirmed","rejected","unresolved","unreviewed","judge-abstained"]},
+              "disputed": {"type":"boolean"},
+              "included": {"type":"boolean"}
+            }
+          }
+        }
+      }
+    },
+    "report": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "policy", "sourcePopulation", "sourceLineage", "groups", "comparisons", "limitations"],
+      "properties": {
+        "schemaVersion": { "const": "ebo.aggregation-report/v1" },
+        "policy": {
+          "type": "object", "additionalProperties": false, "required": ["groupBy", "selectedAttemptPolicy", "recurrence"],
+          "properties": {
+            "groupBy": { "type": "array", "maxItems": 5, "uniqueItems": true, "items": { "$ref": "#/$defs/dimension" } },
+            "selectedAttemptPolicy": { "enum": ["all-attempts", "latest-attempt-per-run"] },
+            "recurrence": {
+              "type": "object", "additionalProperties": false, "required": ["minimumOccurrences", "establishesCausality", "establishesStatisticalSignificance"],
+              "properties": {
+                "minimumOccurrences": { "type": "integer", "minimum": 2 },
+                "establishesCausality": { "const": false },
+                "establishesStatisticalSignificance": { "const": false }
+              }
+            }
+          }
+        },
+        "sourcePopulation": {
+          "type": "object", "additionalProperties": false, "required": ["uniqueRuns", "uniqueAttempts", "selectedAttempts", "duplicateInputsIgnored"],
+          "properties": {
+            "uniqueRuns": { "type": "integer", "minimum": 0 }, "uniqueAttempts": { "type": "integer", "minimum": 0 },
+            "selectedAttempts": { "type": "integer", "minimum": 0 }, "duplicateInputsIgnored": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "sourceLineage": { "$ref": "#/$defs/sourceLineage" },
+        "groups": {
+          "type": "array", "maxItems": 100000,
+          "items": {
+            "type": "object", "additionalProperties": false, "required": ["dimensions", "metrics", "variations"],
+            "properties": {
+              "dimensions": { "$ref": "#/$defs/filters" },
+              "behaviors": { "type": "array", "items": { "$ref": "#/$defs/behaviorAggregate" } },
+              "metrics": { "type": "array", "maxItems": 100000, "items": { "$ref": "#/$defs/metric" } },
+              "variations": {
+                "type": "array", "maxItems": 2,
+                "items": {
+                  "type": "object", "additionalProperties": false, "required": ["measure", "distribution", "claimStatus"],
+                  "properties": {
+                    "measure": { "enum": ["terminal-state", "verifier-status"] },
+                    "distribution": { "type": "array", "items": { "$ref": "#/$defs/metric" } },
+                    "claimStatus": { "enum": ["no-variation", "case-study", "recurring-description", "unavailable"] }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "comparisons": {
+          "type": "array", "maxItems": 100000,
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["id", "measure", "eligibility", "matchedDifference", "differingMatchedUnits", "claimStatus", "limitations"],
+            "properties": {
+              "id": { "$ref": "#/$defs/identifier" }, "measure": { "$ref": "#/$defs/identifier" },
+              "eligibility": { "type": "array", "minItems": 1, "maxItems": 100000, "items": { "$ref": "urn:ebo:schema:normalization-integrity:v1#/$defs/comparisonReportV2" } },
+              "matchedDifference": { "$ref": "#/$defs/measurement" },
+              "differingMatchedUnits": { "type": "integer", "minimum": 0 },
+              "claimStatus": { "enum": ["no-difference", "case-study", "recurring-description", "unavailable"] },
+              "limitations": { "type": "array", "items": { "$ref": "#/$defs/identifier" } }
+            }
+          }
+        },
+        "limitations": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/identifier" } }
+      }
+    }
+  },
+  "oneOf": [{ "$ref": "#/$defs/request" }, { "$ref": "#/$defs/report" }]
+}

package/schemas/behavior-assertions.v1.json

@@ -0,0 +1,220 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:ebo:schema:behavior-assertions:v1",
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": ".*\\S.*"
+    },
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 8192,
+      "pattern": ".*\\S.*"
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "versionedIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "version": { "$ref": "#/$defs/identifier" }
+      }
+    },
+    "evaluatorIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "version": { "$ref": "#/$defs/identifier" },
+        "configurationDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "dimension": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "name": { "$ref": "#/$defs/identifier" }
+      }
+    },
+    "category": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name", "dimensions"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "name": { "$ref": "#/$defs/identifier" },
+        "dimensions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/dimension" }
+        }
+      }
+    },
+    "vocabulary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "version", "categories"],
+      "properties": {
+        "schemaVersion": { "const": "ebo.behavior-vocabulary/v1" },
+        "version": { "$ref": "#/$defs/identifier" },
+        "categories": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/category" }
+        }
+      }
+    },
+    "citation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["eventId", "nativeReference"],
+      "properties": {
+        "eventId": { "$ref": "#/$defs/identifier" },
+        "nativeReference": { "$ref": "urn:ebo:schema:uniform-events:v1#/$defs/nativeReference" }
+      }
+    },
+    "assessedJudgment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["disposition", "assessment", "confidence", "rationale", "alternativeExplanation", "citations"],
+      "properties": {
+        "disposition": { "const": "assessed" },
+        "assessment": { "enum": ["constructive", "adverse", "mixed", "context-dependent"] },
+        "confidence": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["value", "scale"],
+          "properties": {
+            "value": { "type": "number", "minimum": 0, "maximum": 1 },
+            "scale": { "const": "evaluator-reported-0-to-1" }
+          }
+        },
+        "rationale": { "$ref": "#/$defs/text" },
+        "alternativeExplanation": { "$ref": "#/$defs/text" },
+        "citations": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 256,
+          "items": { "$ref": "#/$defs/citation" }
+        }
+      }
+    },
+    "abstainedJudgment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["disposition", "reason", "rationale", "alternativeExplanation", "citations"],
+      "properties": {
+        "disposition": { "const": "abstained" },
+        "reason": { "$ref": "#/$defs/text" },
+        "missingEvidenceCapability": {
+          "type": "string",
+          "pattern": "^(?:family:(?:message|model-request|tool|context|permission|delegation|artifact|validation|runtime|outcome)|evidence:(?:nativeOrder|nativeTime|parentage|content))$"
+        },
+        "rationale": { "$ref": "#/$defs/text" },
+        "alternativeExplanation": { "$ref": "#/$defs/text" },
+        "citations": {
+          "type": "array",
+          "maxItems": 256,
+          "items": { "$ref": "#/$defs/citation" }
+        }
+      }
+    },
+    "assertion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "id", "runId", "attemptId", "dataset", "behavior", "rubric", "evaluator", "judgment"],
+      "properties": {
+        "schemaVersion": { "const": "ebo.behavior-assertion/v1" },
+        "id": { "$ref": "#/$defs/identifier" },
+        "runId": { "$ref": "#/$defs/identifier" },
+        "attemptId": { "$ref": "#/$defs/identifier" },
+        "dataset": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["schemaVersion", "digest"],
+          "properties": {
+            "schemaVersion": { "const": "ebo.normalized-dataset/v1" },
+            "digest": { "$ref": "#/$defs/digest" }
+          }
+        },
+        "behavior": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["vocabularyVersion", "categoryId", "dimensionId"],
+          "properties": {
+            "vocabularyVersion": { "$ref": "#/$defs/identifier" },
+            "categoryId": { "$ref": "#/$defs/identifier" },
+            "dimensionId": { "$ref": "#/$defs/identifier" }
+          }
+        },
+        "rubric": { "$ref": "#/$defs/versionedIdentity" },
+        "evaluator": { "$ref": "#/$defs/evaluatorIdentity" },
+        "judgment": {
+          "oneOf": [
+            { "$ref": "#/$defs/assessedJudgment" },
+            { "$ref": "#/$defs/abstainedJudgment" }
+          ]
+        }
+      }
+    },
+    "assertionBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "schemaVersion", "digest"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "schemaVersion": { "const": "ebo.behavior-assertion/v1" },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "reviewer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id"],
+      "properties": {
+        "kind": { "const": "human" },
+        "id": { "$ref": "#/$defs/identifier" }
+      }
+    },
+    "review": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "id", "assertion", "state"],
+      "properties": {
+        "schemaVersion": { "const": "ebo.behavior-review/v1" },
+        "id": { "$ref": "#/$defs/identifier" },
+        "assertion": { "$ref": "#/$defs/assertionBinding" },
+        "state": { "enum": ["proposed", "confirmed", "disputed", "rejected", "insufficient-evidence"] },
+        "reviewer": { "$ref": "#/$defs/reviewer" },
+        "rationale": { "$ref": "#/$defs/text" }
+      },
+      "allOf": [
+        {
+          "if": {
+            "required": ["state"],
+            "properties": { "state": { "const": "proposed" } }
+          },
+          "then": { "not": { "required": ["reviewer"] } },
+          "else": { "required": ["reviewer", "rationale"] }
+        }
+      ]
+    }
+  },
+  "oneOf": [
+    { "$ref": "#/$defs/vocabulary" },
+    { "$ref": "#/$defs/assertion" },
+    { "$ref": "#/$defs/review" }
+  ]
+}

package/schemas/deepseek-runtime-composition.v1.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ebo.dev/schemas/deepseek-runtime-composition.v1.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "launch", "workspaceCwd", "runtime", "route", "cordis", "patches", "plugins", "environment", "telemetry"],
+  "properties": {
+    "schemaVersion": { "const": "ebo.deepseek-runtime-composition/v1" },
+    "id": { "$ref": "#/$defs/nonempty" },
+    "launch": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["command", "args", "processCwd", "profile", "runtimeArtifact"],
+      "properties": {
+        "command": { "$ref": "#/$defs/nonempty" },
+        "args": {
+          "type": "array",
+          "minItems": 3,
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/nonempty" }
+        },
+        "processCwd": { "$ref": "#/$defs/nonempty" },
+        "profile": { "$ref": "#/$defs/nonempty" },
+        "dshHome": { "$ref": "#/$defs/nonempty" },
+        "runtimeArtifact": { "$ref": "#/$defs/fileReference" }
+      }
+    },
+    "workspaceCwd": { "$ref": "#/$defs/nonempty" },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["clientPackage", "clientVersion", "protocolPackage", "protocolVersion"],
+      "properties": {
+        "clientPackage": { "const": "@deepseek-ai/dsh-sdk-client" },
+        "clientVersion": { "$ref": "#/$defs/nonempty" },
+        "protocolPackage": { "const": "@deepseek-ai/dsh-sdk-protocol" },
+        "protocolVersion": { "$ref": "#/$defs/nonempty" }
+      }
+    },
+    "route": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider", "model"],
+      "properties": {
+        "provider": { "$ref": "#/$defs/nonempty" },
+        "model": { "$ref": "#/$defs/nonempty" },
+        "maxTokens": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }
+      }
+    },
+    "cordis": { "$ref": "#/$defs/fileReference" },
+    "patches": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 32,
+      "items": { "$ref": "#/$defs/fileReference" }
+    },
+    "plugins": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 128,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name"],
+        "properties": {
+          "name": { "$ref": "#/$defs/nonempty" },
+          "configuration": { "$ref": "#/$defs/fileReference" }
+        }
+      }
+    },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "allowedKeys", "secretKeys"],
+      "properties": {
+        "mode": { "const": "replace" },
+        "allowedKeys": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/envKey" }
+        },
+        "secretKeys": {
+          "type": "array",
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/envKey" }
+        }
+      }
+    },
+    "telemetry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "nativeSpans"],
+      "properties": {
+        "status": { "enum": ["enabled", "disabled"] },
+        "nativeSpans": { "enum": ["available", "unsupported", "not-checked"] },
+        "artifact": { "$ref": "#/$defs/fileReference" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "status": { "const": "disabled" } }, "required": ["status"] },
+          "then": { "properties": { "nativeSpans": { "const": "unsupported" } }, "not": { "required": ["artifact"] } }
+        }
+      ]
+    }
+  },
+  "$defs": {
+    "nonempty": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": ".*\\S.*" },
+    "envKey": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$", "maxLength": 255 },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "fileReference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["locator", "digest"],
+      "properties": {
+        "locator": { "$ref": "#/$defs/nonempty" },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}