@claudexor/schema 1.0.0

package/generated/RouteFallbackPayload.schema.json

@@ -0,0 +1,79 @@
+{
+  "$ref": "#/definitions/RouteFallbackPayload",
+  "definitions": {
+    "RouteFallbackPayload": {
+      "type": "object",
+      "properties": {
+        "from_harness": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Harness the route fell back from."
+        },
+        "to_harness": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Harness the route fell back to."
+        },
+        "from_auth_mode": {
+          "type": "string",
+          "enum": [
+            "local_session",
+            "api_key",
+            "unknown"
+          ],
+          "description": "Auth mode before the switch.",
+          "default": "unknown"
+        },
+        "to_auth_mode": {
+          "$ref": "#/definitions/RouteFallbackPayload/properties/from_auth_mode",
+          "default": "unknown",
+          "description": "Auth mode after the switch."
+        },
+        "reason": {
+          "type": "string",
+          "enum": [
+            "quota_exhausted",
+            "money_exhausted",
+            "subscription_exhausted",
+            "rate_limited",
+            "harness_error",
+            "stall",
+            "web_evidence_unsatisfied",
+            "fallback_model",
+            "not_portable",
+            "auth_unavailable",
+            "readiness_preferred",
+            "manual"
+          ],
+          "description": "Typed reason an auto-fallback (route/auth switch) or session re-host happened, driven by typed budget/quota signals and events, never by regex over prose.",
+          "default": "manual"
+        },
+        "attempt_id": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Attempt the fallback happened in, when known."
+        },
+        "error_summary": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Redacted error detail that triggered the fallback."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Typed payload for route.fallback.* events, validated before being stamped onto the RunEvent payload so a fallback/auth-switch is always evidence-backed."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RouteProof.schema.json

@@ -0,0 +1,111 @@
+{
+  "$ref": "#/definitions/RouteProof",
+  "definitions": {
+    "RouteProof": {
+      "type": "object",
+      "properties": {
+        "requested": {
+          "type": "object",
+          "properties": {
+            "harness_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Harness the route was requested on."
+            },
+            "provider_family": {
+              "type": "string",
+              "enum": [
+                "openai",
+                "anthropic",
+                "google",
+                "cursor",
+                "opencode",
+                "xai",
+                "local",
+                "unknown"
+              ],
+              "description": "Vendor/provider family a harness routes to, used for route-diversity reasoning; open-ended via \"unknown\"."
+            },
+            "model_hint": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Model requested for the route; null = harness default."
+            }
+          },
+          "required": [
+            "harness_id",
+            "provider_family"
+          ],
+          "additionalProperties": false,
+          "description": "What was requested."
+        },
+        "observed": {
+          "type": "object",
+          "properties": {
+            "provider": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Provider actually observed; null when no evidence."
+            },
+            "model_id": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Model actually observed; null when no evidence."
+            },
+            "evidence_source": {
+              "type": "string",
+              "enum": [
+                "stream_event",
+                "metadata",
+                "model_catalog",
+                "transcript",
+                "unavailable"
+              ],
+              "description": "Where the observed model/provider evidence came from: a stream event, response metadata, the model catalog, the transcript, or nowhere.",
+              "default": "unavailable"
+            }
+          },
+          "additionalProperties": false,
+          "description": "What was actually observed."
+        },
+        "diversity_against": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Non-empty identifier string."
+          },
+          "default": [],
+          "description": "Harness ids this route was required to be diverse against."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "verified",
+            "accepted_model_arg",
+            "unverified",
+            "same_model_fallback"
+          ],
+          "description": "How strongly the executed route is proven: verified (observed evidence matches the request), accepted_model_arg (the requested model arg was accepted without stream evidence), unverified, or same_model_fallback (a fallback landed on the same model)."
+        }
+      },
+      "required": [
+        "requested",
+        "observed",
+        "status"
+      ],
+      "additionalProperties": false,
+      "description": "Records requested vs observed harness/model routing, so multi-model claims cannot silently collapse onto one model."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunControl.schema.json

@@ -0,0 +1,51 @@
+{
+  "$ref": "#/definitions/RunControl",
+  "definitions": {
+    "RunControl": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "cancel"
+          ],
+          "description": "Control verb: cancel the run."
+        },
+        "target": {
+          "type": "object",
+          "properties": {
+            "attemptId": {
+              "type": "string",
+              "description": "Attempt to target; omitted = the whole run."
+            },
+            "harnessId": {
+              "type": "string",
+              "description": "Harness to target."
+            },
+            "sessionId": {
+              "type": "string",
+              "description": "Session to target."
+            },
+            "requestId": {
+              "type": "string",
+              "description": "Specific request to target."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Optional narrowing of what a run control verb targets.",
+          "default": {}
+        },
+        "reason": {
+          "type": "string",
+          "description": "Human-readable reason for the control."
+        }
+      },
+      "required": [
+        "kind"
+      ],
+      "additionalProperties": false,
+      "description": "A control verb (cancel) aimed at a run or a narrower target inside it."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunEvent.schema.json

@@ -0,0 +1,103 @@
+{
+  "$ref": "#/definitions/RunEvent",
+  "definitions": {
+    "RunEvent": {
+      "type": "object",
+      "properties": {
+        "seq": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "Monotonic per-run sequence stamped at emit time; the durable SSE cursor and snapshot fence. Optional only for pre-v0.8.0 artifacts."
+        },
+        "ts": {
+          "type": "string",
+          "description": "Event timestamp."
+        },
+        "run_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Run the event belongs to."
+        },
+        "task_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Task the run belongs to."
+        },
+        "thread_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Thread this run is a turn of, when any."
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "run.created",
+            "task.contract.created",
+            "context.pack.created",
+            "project.git.initialized",
+            "budget.lease.created",
+            "budget.observation",
+            "policy.web.upgraded",
+            "harness.started",
+            "harness.event",
+            "harness.completed",
+            "route.fallback.started",
+            "route.fallback.completed",
+            "route.fallback.exhausted",
+            "route.transient.detected",
+            "route.transient.retry_scheduled",
+            "route.transient.exhausted",
+            "route.fallback.auth_switched",
+            "session.rebound",
+            "interaction.requested",
+            "interaction.answered",
+            "interaction.timeout",
+            "interaction.answer_discarded",
+            "plan.progress",
+            "budget.quota_pressure",
+            "output.ready",
+            "gate.started",
+            "gate.completed",
+            "review.started",
+            "reviewer.started",
+            "reviewer.first_event",
+            "reviewer.auth_switched",
+            "reviewer.completed",
+            "reviewer.timed_out",
+            "reviewer.failed",
+            "finding.revalidated",
+            "synthesis.started",
+            "arbitration.completed",
+            "work_product.emitted",
+            "work_product.adopted",
+            "orchestrate.subrun.started",
+            "orchestrate.step.done",
+            "orchestrate.step.blocked",
+            "control.requested",
+            "control.applied",
+            "control.rejected",
+            "run.blocked",
+            "run.completed",
+            "run.failed"
+          ],
+          "description": "Type of an append-only run event, covering run lifecycle, contract/context creation, budget, routing fallbacks, harness activity, interactions, gates, review, arbitration, work products, orchestrate steps, and control verbs."
+        },
+        "payload": {
+          "type": "object",
+          "additionalProperties": {},
+          "default": {},
+          "description": "Event-type-specific payload."
+        }
+      },
+      "required": [
+        "ts",
+        "run_id",
+        "task_id",
+        "type"
+      ],
+      "additionalProperties": false,
+      "description": "Append-only run event record (one JSONL line in the run's event log)."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunFailure.schema.json

@@ -0,0 +1,98 @@
+{
+  "$ref": "#/definitions/RunFailure",
+  "definitions": {
+    "RunFailure": {
+      "type": "object",
+      "properties": {
+        "phase": {
+          "type": "string",
+          "default": "unknown",
+          "description": "Pipeline phase where the failure happened."
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "validation",
+            "project",
+            "auth",
+            "harness_unavailable",
+            "harness_error",
+            "budget",
+            "policy",
+            "cancelled",
+            "internal",
+            "unknown"
+          ],
+          "default": "unknown",
+          "description": "Typed failure category (validation, project, auth, harness, budget, policy, cancelled, internal, unknown)."
+        },
+        "harnessId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Harness involved in the failure, when known."
+        },
+        "attemptId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Attempt involved in the failure, when known."
+        },
+        "safeMessage": {
+          "type": "string",
+          "description": "Redacted human-readable failure message."
+        },
+        "rawDetailRef": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Artifact path holding the raw (redacted) failure detail."
+        },
+        "logRefs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Log artifact paths relevant to the failure."
+        },
+        "eventRefs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Event references relevant to the failure."
+        },
+        "runDir": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Run artifact directory."
+        },
+        "nextActions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Suggested operator next actions."
+        }
+      },
+      "required": [
+        "safeMessage"
+      ],
+      "additionalProperties": false,
+      "description": "Typed failure record for a run: phase, category, evidence references, and suggested next actions."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}