@claudexor/schema 3.0.4 → 3.1.1

package/generated/RoutePoolDegradedPayload.schema.json

@@ -0,0 +1,79 @@
+{
+  "$ref": "#/definitions/RoutePoolDegradedPayload",
+  "definitions": {
+    "RoutePoolDegradedPayload": {
+      "type": "object",
+      "properties": {
+        "requested_harnesses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The pool the resolver considered (explicit ids or auto-derived)."
+        },
+        "effective_harnesses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Distinct harnesses that actually route, in attempt order."
+        },
+        "requested_n": {
+          "type": "integer",
+          "description": "The requested candidate width for this run."
+        },
+        "effective_n": {
+          "type": "integer",
+          "description": "Distinct candidates that will run; never inflated by duplication."
+        },
+        "dropped_lanes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "harness_id": {
+                "type": "string",
+                "description": "The dropped lane's harness id."
+              },
+              "stage": {
+                "type": "string",
+                "enum": [
+                  "discovery",
+                  "settings",
+                  "credential",
+                  "doctor",
+                  "capability",
+                  "access",
+                  "web",
+                  "attachment"
+                ],
+                "description": "The routing stage at which an auto-pool lane was dropped."
+              },
+              "detail": {
+                "type": "string",
+                "description": "Redacted human reason the lane was dropped."
+              }
+            },
+            "required": [
+              "harness_id",
+              "stage",
+              "detail"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Every lane excluded from the auto pool, with its typed stage and reason."
+        }
+      },
+      "required": [
+        "requested_harnesses",
+        "effective_harnesses",
+        "requested_n",
+        "effective_n",
+        "dropped_lanes"
+      ],
+      "additionalProperties": false,
+      "description": "Typed payload for route.pool.degraded: the requested-vs-effective route receipt for an auto pool that dropped lanes or clamped width, validated before being stamped onto the RunEvent payload."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunEvent.schema.json

@@ -35,6 +35,7 @@
             "task.contract.created",
             "context.pack.created",
             "project.git.initialized",
+            "project.claude_bridge.created",
             "budget.lease.created",
             "budget.observation",
             "budget.cash",
@@ -53,6 +54,7 @@
             "route.transient.exhausted",
             "route.fallback.auth_switched",
             "route.primary.diverged",
+            "route.pool.degraded",
             "session.continuity",
             "interaction.requested",
             "interaction.answered",
@@ -66,10 +68,13 @@
             "council.member.failed",
             "council.merged",
             "budget.quota_pressure",
+            "delegation.belt.unavailable",
             "output.ready",
             "gate.started",
             "gate.completed",
+            "review.preflight",
             "review.started",
+            "review.skipped",
             "reviewer.started",
             "reviewer.first_event",
             "reviewer.auth_switched",
@@ -86,7 +91,9 @@
             "control.rejected",
             "run.blocked",
             "run.completed",
-            "run.failed"
+            "run.failed",
+            "run.continuation",
+            "run.continuation.denied"
           ],
           "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, and control verbs."
         },

package/generated/RunFailure.schema.json

@@ -17,6 +17,7 @@
             "auth",
             "harness_unavailable",
             "harness_error",
+            "config_error",
             "budget",
             "policy",
             "cancelled",
@@ -24,7 +25,28 @@
             "unknown"
           ],
           "default": "unknown",
-          "description": "Typed failure category (validation, project, auth, harness, budget, policy, cancelled, internal, unknown)."
+          "description": "Typed failure category (validation, project, auth, harness, config, budget, policy, cancelled, internal, unknown). config_error is a settings/routing misconfiguration (e.g. quality routing with no comparable tier), corrected by changing configuration, not by re-auth or waiting for a harness."
+        },
+        "code": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "finite_zero",
+                "hard_cap",
+                "estimate_headroom",
+                "unknown_paid_in_flight",
+                "budget_overshoot",
+                "cost_unverifiable"
+              ],
+              "description": "Machine-readable failure sub-code within a RunFailure category (today the typed budget-denial reasons produced by the budget ledger)."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Machine-readable failure sub-code within the category (today the typed budget-denial reason from the ledger); null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+          "default": null
         },
         "harnessId": {
           "type": [

package/generated/RunTelemetry.schema.json

@@ -135,6 +135,16 @@
               "description": "Web-evidence verdict for an attempt/run: none (no web activity), attempted, satisfied (required evidence produced), failed, or unverified.",
               "default": "none"
             },
+            "verification": {
+              "type": "string",
+              "enum": [
+                "verified",
+                "dispatched",
+                "none"
+              ],
+              "default": "none",
+              "description": "Retrieval strength of the web evidence: verified (typed retrieval), dispatched (completed but no typed outcome), or none."
+            },
             "tool": {
               "type": [
                 "string",
@@ -320,6 +330,9 @@
                   "status": {
                     "$ref": "#/definitions/RunTelemetry/properties/web/properties/status"
                   },
+                  "verification": {
+                    "$ref": "#/definitions/RunTelemetry/properties/web/properties/verification"
+                  },
                   "tool": {
                     "$ref": "#/definitions/RunTelemetry/properties/web/properties/tool"
                   },
@@ -430,7 +443,26 @@
                         "unknown"
                       ],
                       "default": "unknown",
-                      "description": "Kind of transient failure."
+                      "description": "Fine-grained kind of transient failure (adapter-declared)."
+                    },
+                    "category": {
+                      "type": "string",
+                      "enum": [
+                        "timeout",
+                        "rate_limited",
+                        "auth_failed",
+                        "capability_refused",
+                        "process_crash",
+                        "config_error",
+                        "unknown_harness_error"
+                      ],
+                      "description": "Typed failure category (GH #31) the retry policy and required-actions read; orthogonal to kind.",
+                      "default": "unknown_harness_error"
+                    },
+                    "retryable": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Whether the classified category is retryable (the centralized retry-policy gate)."
                     },
                     "retry_delay_ms": {
                       "anyOf": [
@@ -444,6 +476,34 @@
                       ],
                       "default": null,
                       "description": "Suggested retry delay in milliseconds, when reported."
+                    },
+                    "http_status": {
+                      "anyOf": [
+                        {
+                          "type": "integer"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "default": null,
+                      "description": "Vendor HTTP status code disclosed by the error, when any; null otherwise."
+                    },
+                    "signal": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Process termination signal (e.g. SIGKILL) when a crash killed the child; null otherwise."
+                    },
+                    "adapter_code": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Vendor/adapter error-category code passed verbatim as evidence; null when none."
                     }
                   },
                   "additionalProperties": false,
@@ -478,6 +538,11 @@
                     "default": false,
                     "description": "True when required web evidence was not satisfied."
                   },
+                  "delegation_belt_unavailable": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "True when --delegate requested the belt but the injected MCP server failed to become operational (QA-024); blocks a silent clean success."
+                  },
                   "tool_warnings_count": {
                     "type": "integer",
                     "minimum": 0,
@@ -494,12 +559,163 @@
                     ],
                     "description": "Outcome of one attempt: success, success_with_warnings, blocked, or failed.",
                     "default": "success"
+                  },
+                  "work_state": {
+                    "type": "object",
+                    "properties": {
+                      "state": {
+                        "type": "string",
+                        "enum": [
+                          "completed",
+                          "needs_input",
+                          "incomplete",
+                          "unverified"
+                        ],
+                        "description": "Folded work state: the WorkReport state, or unverified when no report was obtainable (transport unsupported / lane gated)."
+                      },
+                      "source": {
+                        "type": "string",
+                        "enum": [
+                          "constrained",
+                          "validated",
+                          "absent"
+                        ],
+                        "description": "Provenance of a WorkReport: constrained (native schema transport), validated (whole-answer JSON), or absent (no transport could carry one — a disclosed absence, not a failure)."
+                      },
+                      "required_inputs": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "kind": {
+                              "type": "string",
+                              "enum": [
+                                "file",
+                                "context",
+                                "credential",
+                                "permission",
+                                "decision",
+                                "external_dependency"
+                              ],
+                              "description": "Category of a missing input a needs_input/incomplete report lists: a file, additional context, a credential, a permission, a human decision, or an external dependency."
+                            },
+                            "locator": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "maxLength": 512
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "default": null,
+                              "description": "Concrete pointer to the missing thing (path/url/name); null when unnameable."
+                            },
+                            "description": {
+                              "type": "string",
+                              "maxLength": 1024,
+                              "description": "Human-readable description of what is needed and why."
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "description"
+                          ],
+                          "additionalProperties": false,
+                          "description": "One blocking input a needs_input/incomplete WorkReport lists."
+                        },
+                        "maxItems": 16,
+                        "description": "Carried through from a needs_input/incomplete WorkReport for honest disclosure."
+                      }
+                    },
+                    "required": [
+                      "state",
+                      "source"
+                    ],
+                    "additionalProperties": false,
+                    "description": "D-16 model-attested work outcome for the attempt (from its WorkReport), orthogonal to status; absent when the route has no work_report transport."
                   }
                 },
                 "additionalProperties": false,
                 "description": "Contract/outcome truth for one attempt; tool errors are tracked separately from deliverable production.",
                 "default": {}
               },
+              "delegation_belt": {
+                "type": "object",
+                "properties": {
+                  "requested": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "A Claudexor delegation belt MCP server was injected into this attempt's sandbox."
+                  },
+                  "server_name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "The injected belt MCP server name (as the harness reports it); null when unknown."
+                  },
+                  "ready": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "The harness reported the injected belt MCP server as connected/ready."
+                  },
+                  "failed": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "The harness reported the injected belt MCP server as failed to start."
+                  },
+                  "tool_evidence": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "At least one belt tool (mcp__<server>__*) was actually invoked in this attempt."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Runtime readiness receipt for the injected Claudexor delegation belt on one attempt (QA-024)."
+              },
+              "browser": {
+                "type": "object",
+                "properties": {
+                  "requested": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "The engine armed (injected) the browser MCP for this attempt."
+                  },
+                  "server_name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "The injected browser MCP server name; null when not armed."
+                  },
+                  "attempted": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "At least one browser MCP tool call (matched to the injected server) occurred."
+                  },
+                  "satisfied": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "At least one browser MCP tool call succeeded (trusted live-web activity)."
+                  },
+                  "failed": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "A browser MCP tool call failed and was not superseded by a success."
+                  },
+                  "unused": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "The browser was armed but never called while generic web evidence satisfied the run (disclosure only; not a failure)."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Runtime browser-MCP evidence for one attempt (QA-040)."
+              },
               "usage": {
                 "type": "object",
                 "properties": {
@@ -685,6 +901,165 @@
           "default": null,
           "description": "Auth route receipt: requested preference, disclosed effective route/source, deterministic reason, and the disclosing attempt; surfaces project it verbatim."
         },
+        "routing_rationale": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "goal": {
+                  "type": "string",
+                  "enum": [
+                    "auto",
+                    "quality",
+                    "economy"
+                  ],
+                  "description": "Routing objective: pace expiring quota, choose the highest declared quality tier, or minimize incremental paid spend."
+                },
+                "paid_fallback": {
+                  "type": "string",
+                  "enum": [
+                    "never",
+                    "when_unavailable",
+                    "allowed_within_cap"
+                  ],
+                  "description": "When a route with incremental paid spend may be used."
+                },
+                "order": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/RunTelemetry/properties/final_attempt_id/anyOf/0"
+                  },
+                  "default": [],
+                  "description": "Final ranked order, harness ids."
+                },
+                "dropped": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/RunTelemetry/properties/final_attempt_id/anyOf/0"
+                  },
+                  "default": [],
+                  "description": "Ids removed by paid_fallback or cooldown before ranking."
+                },
+                "reason": {
+                  "type": "string",
+                  "enum": [
+                    "subscription_entitlement_first",
+                    "lowest_incremental_cash",
+                    "quality_tier",
+                    "expiring_quota_slack",
+                    "all_incremental_cash_unknown",
+                    "declared_order"
+                  ],
+                  "description": "Typed decisive reason the pool ranked the way it did (QA-034)."
+                },
+                "entries": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "harness_id": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Candidate harness id."
+                      },
+                      "billing_knowledge": {
+                        "type": "string",
+                        "enum": [
+                          "proven_zero",
+                          "subscription_entitlement",
+                          "metered",
+                          "unknown"
+                        ],
+                        "description": "Effective billing knowledge used to rank it."
+                      },
+                      "incremental_cost_usd": {
+                        "anyOf": [
+                          {
+                            "type": "number",
+                            "minimum": 0
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "default": null,
+                        "description": "Known incremental cash cost, when any; null when unknown."
+                      },
+                      "eligible": {
+                        "type": "boolean",
+                        "description": "Whether the candidate survived paid_fallback/cooldown filtering."
+                      }
+                    },
+                    "required": [
+                      "harness_id",
+                      "billing_knowledge",
+                      "eligible"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Per-candidate billing/cost tuple in the routing rationale (QA-034)."
+                  },
+                  "default": []
+                }
+              },
+              "required": [
+                "goal",
+                "paid_fallback",
+                "reason"
+              ],
+              "additionalProperties": false,
+              "description": "Typed routing rationale recorded once at pool ordering (QA-034)."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed routing rationale recorded once at pool ordering (QA-034); null on legacy artifacts or when no ranking was computed.",
+          "default": null
+        },
+        "deep_scan_synthesis": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "succeeded",
+                    "failed",
+                    "skipped"
+                  ],
+                  "description": "succeeded = reducer merged the scouts; failed = honest raw bundle; skipped = single report, no merge."
+                },
+                "reducer_attempt_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "The reducer attempt id (roster/cost visible); null when no reducer attempt ran."
+                },
+                "reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Why the reducer failed or was skipped; null on a clean merge."
+                }
+              },
+              "required": [
+                "status"
+              ],
+              "additionalProperties": false,
+              "description": "Deep-scan reducer outcome: whether the scout reports were merged into a real synthesis, degraded to an honest raw bundle, or skipped as a single report."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Deep-scan reducer outcome (#27); null on non-deep-scan runs and legacy artifacts.",
+          "default": null
+        },
         "generated_at": {
           "type": "string",
           "minLength": 1,

package/generated/StructuredOutputConformance.schema.json

@@ -0,0 +1,83 @@
+{
+  "$ref": "#/definitions/StructuredOutputConformance",
+  "definitions": {
+    "StructuredOutputConformance": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 2,
+          "description": "Schema version of the artifact; bumped on breaking ABI changes."
+        },
+        "schema_dialect": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "draft-07",
+                "draft-2020-12"
+              ],
+              "description": "JSON Schema dialect selected for structured-output validation."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Dialect used to compile and validate the caller schema; null only for legacy receipts.",
+          "default": null
+        },
+        "schema_hash": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "description": "Content hash in algo:hex form, e.g. \"sha256:abcd...\"."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Stable hash of the original caller schema; null only for legacy receipts written before schema identity was recorded.",
+          "default": null
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "passed",
+            "failed"
+          ],
+          "description": "Whether the final answer conformed to the run's output schema."
+        },
+        "reason": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Why conformance failed (missing/unparsable answer, validator errors); null on pass."
+        },
+        "output_path": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Artifact path of the materialized structured output: final/output.json when conformant, final/output.invalid.json when parsed but non-conformant; null when the answer never parsed."
+        },
+        "generated_at": {
+          "type": "string",
+          "minLength": 1,
+          "description": "When the receipt was generated."
+        }
+      },
+      "required": [
+        "schema_version",
+        "status",
+        "generated_at"
+      ],
+      "additionalProperties": false,
+      "description": "Structured-output conformance receipt (final/structured_output.yaml): the single engine validator's verdict on the final answer."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}