@claudexor/schema 3.0.4 → 3.1.0

package/generated/McpRunHandleResult.schema.json

@@ -109,7 +109,11 @@
                         "stuck_no_progress",
                         "wall_clock_exceeded",
                         "user_cancelled",
-                        "crash_interrupted"
+                        "crash_interrupted",
+                        "input_required",
+                        "work_incomplete",
+                        "context_capacity_exhausted",
+                        "work_report_contract"
                       ],
                       "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
                     },
@@ -119,6 +123,82 @@
                   ],
                   "description": "Typed reason qualifying a non-clean terminal; null on a clean success.",
                   "default": null
+                },
+                "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, orthogonal to lifecycle; a needs_input/incomplete state vetoes applyability and exit 0. Absent on runs with no work_report transport."
                 }
               },
               "required": [
@@ -221,6 +301,211 @@
           ],
           "description": "Derived plan readiness (plan runs only, D17); null otherwise.",
           "default": null
+        },
+        "council": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "requested": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Requested member count (n; 2..4)."
+                },
+                "drafted": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Members whose draft survived to the merge."
+                },
+                "degraded": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True when fewer members drafted than requested (failures disclosed per member)."
+                },
+                "mergedBy": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Harness that produced the unified plan (the primary); null if the merge failed."
+                },
+                "members": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "harnessId": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Harness that drafted (or merged) this member's plan."
+                      },
+                      "role": {
+                        "type": "string",
+                        "enum": [
+                          "primary",
+                          "member"
+                        ],
+                        "description": "primary = the merger that synthesizes the unified plan; member = draft only."
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "drafted",
+                          "failed",
+                          "merged"
+                        ],
+                        "description": "drafted = draft landed; merged = this member produced the unified plan; failed."
+                      },
+                      "error": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "First redacted draft error; null unless the member failed."
+                      }
+                    },
+                    "required": [
+                      "harnessId",
+                      "role",
+                      "status"
+                    ],
+                    "additionalProperties": false,
+                    "description": "One council member's role and draft/merge outcome."
+                  },
+                  "default": [],
+                  "description": "Per-member role and outcome."
+                }
+              },
+              "required": [
+                "requested",
+                "drafted"
+              ],
+              "additionalProperties": false,
+              "description": "Council membership + merge disclosure for a --council plan run."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Council membership + merge disclosure (QA-023b); null for solo/non-plan runs.",
+          "default": null
+        },
+        "budget": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "paidBudget": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "unlimited"
+                        }
+                      },
+                      "required": [
+                        "kind"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "finite"
+                        },
+                        "maxUsd": {
+                          "type": "number",
+                          "minimum": 0
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "maxUsd"
+                      ],
+                      "additionalProperties": false
+                    }
+                  ],
+                  "description": "Incremental-cash budget: explicitly unlimited or a finite non-negative USD cap.",
+                  "default": {
+                    "kind": "unlimited"
+                  }
+                },
+                "spendUsd": {
+                  "type": [
+                    "number",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "CASH spend so far in USD; null when unknown."
+                },
+                "valuationUsd": {
+                  "type": [
+                    "number",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Subscription valuation in USD (separate from billed cash); null when unknown — never a fabricated $0 (QA-023c)."
+                },
+                "valuationKnowledge": {
+                  "type": "string",
+                  "enum": [
+                    "exact",
+                    "estimated",
+                    "unknown"
+                  ],
+                  "default": "unknown",
+                  "description": "Confidence of valuationUsd: 'estimated' when token-derived, 'unknown' when no usage was reported (valuationUsd is then null), 'exact' when natively priced."
+                },
+                "remainingUsd": {
+                  "type": [
+                    "number",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Remaining budget in USD; null when no cap or unknown spend."
+                },
+                "estimated": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True when spend is token-derived rather than natively reported."
+                },
+                "source": {
+                  "type": "string",
+                  "enum": [
+                    "decision",
+                    "events",
+                    "settings",
+                    "unknown"
+                  ],
+                  "default": "unknown",
+                  "description": "Where the snapshot came from: the decision record, live events, settings, or unknown."
+                },
+                "evidence": {
+                  "type": "string",
+                  "enum": [
+                    "complete",
+                    "incomplete",
+                    "unavailable"
+                  ],
+                  "description": "Integrity of the canonical events this spend fallback read: 'incomplete' when malformed/non-object event lines were skipped, 'unavailable' when the events file was unreadable, else 'complete'. A non-complete value means the projected spend may disagree with disk truth.",
+                  "default": "complete"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Budget snapshot for a run: cap, spend, and provenance."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Run budget snapshot (cash + subscription valuation, QA-023c); null when unavailable.",
+          "default": null
         }
       },
       "required": [

package/generated/McpRunToolResult.schema.json

@@ -85,7 +85,11 @@
                         "stuck_no_progress",
                         "wall_clock_exceeded",
                         "user_cancelled",
-                        "crash_interrupted"
+                        "crash_interrupted",
+                        "input_required",
+                        "work_incomplete",
+                        "context_capacity_exhausted",
+                        "work_report_contract"
                       ],
                       "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
                     },
@@ -95,6 +99,82 @@
                   ],
                   "description": "Typed reason qualifying a non-clean terminal; null on a clean success.",
                   "default": null
+                },
+                "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, orthogonal to lifecycle; a needs_input/incomplete state vetoes applyability and exit 0. Absent on runs with no work_report transport."
                 }
               },
               "required": [
@@ -196,6 +276,96 @@
           ],
           "description": "Derived plan readiness for plan tools (D17); null for non-plan tools.",
           "default": null
+        },
+        "council": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "requested": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Requested member count (n; 2..4)."
+                },
+                "drafted": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Members whose draft survived to the merge."
+                },
+                "degraded": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True when fewer members drafted than requested (failures disclosed per member)."
+                },
+                "mergedBy": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Harness that produced the unified plan (the primary); null if the merge failed."
+                },
+                "members": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "harnessId": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Harness that drafted (or merged) this member's plan."
+                      },
+                      "role": {
+                        "type": "string",
+                        "enum": [
+                          "primary",
+                          "member"
+                        ],
+                        "description": "primary = the merger that synthesizes the unified plan; member = draft only."
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "drafted",
+                          "failed",
+                          "merged"
+                        ],
+                        "description": "drafted = draft landed; merged = this member produced the unified plan; failed."
+                      },
+                      "error": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "First redacted draft error; null unless the member failed."
+                      }
+                    },
+                    "required": [
+                      "harnessId",
+                      "role",
+                      "status"
+                    ],
+                    "additionalProperties": false,
+                    "description": "One council member's role and draft/merge outcome."
+                  },
+                  "default": [],
+                  "description": "Per-member role and outcome."
+                }
+              },
+              "required": [
+                "requested",
+                "drafted"
+              ],
+              "additionalProperties": false,
+              "description": "Council membership + merge disclosure for a --council plan run."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Council membership + merge disclosure (QA-023b); null for solo/non-plan tools or deferred handles.",
+          "default": null
         }
       },
       "required": [

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,12 @@
             "council.member.failed",
             "council.merged",
             "budget.quota_pressure",
+            "delegation.belt.unavailable",
             "output.ready",
             "gate.started",
             "gate.completed",
             "review.started",
+            "review.skipped",
             "reviewer.started",
             "reviewer.first_event",
             "reviewer.auth_switched",
@@ -86,7 +90,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": [