@claudexor/schema 3.1.1 → 3.2.0

package/generated/McpRunHandleResult.schema.json

@@ -110,6 +110,7 @@
                         "wall_clock_exceeded",
                         "user_cancelled",
                         "crash_interrupted",
+                        "workspace_unavailable",
                         "input_required",
                         "work_incomplete",
                         "context_capacity_exhausted",
@@ -144,7 +145,7 @@
                         "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)."
+                      "description": "Provenance of a WorkReport: constrained (native schema transport), validated (instructed terminal metadata), or absent (no transport could carry one — a disclosed absence, not a failure)."
                     },
                     "required_inputs": {
                       "type": "array",
@@ -214,6 +215,130 @@
           "description": "The D8 terminal outcome axes (checks/review/reason/noChanges), when terminal.",
           "default": null
         },
+        "failure": {
+          "anyOf": [
+            {
+              "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",
+                    "config_error",
+                    "budget",
+                    "policy",
+                    "cancelled",
+                    "internal",
+                    "unknown"
+                  ],
+                  "default": "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",
+                        "delegation_child_drain_timeout"
+                      ],
+                      "description": "Machine-readable failure sub-code within a RunFailure category (budget-denial reasons and Delegate child-drain timeout)."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Machine-readable failure sub-code within the category; null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+                  "default": null
+                },
+                "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."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed terminal failure detail and recovery actions; null for non-failed runs.",
+          "default": null
+        },
         "outcomeBanner": {
           "type": [
             "string",
@@ -473,7 +598,7 @@
                 "estimated": {
                   "type": "boolean",
                   "default": false,
-                  "description": "True when spend is token-derived rather than natively reported."
+                  "description": "True when settled cash is estimated rather than exact; subscription valuation confidence is reported separately."
                 },
                 "source": {
                   "type": "string",
@@ -506,6 +631,116 @@
           ],
           "description": "Run budget snapshot (cash + subscription valuation, QA-023c); null when unavailable.",
           "default": null
+        },
+        "parentRunId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Server-owned ordinary parent/follow-up run id, when present."
+        },
+        "delegatedFromRunId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Claudexor Delegate parent id; null for ordinary runs and native subagents."
+        },
+        "delegation": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "requested": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "effective": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "used": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "reason": {
+                  "type": "string",
+                  "enum": [
+                    "pending",
+                    "not_requested",
+                    "injected_unused",
+                    "used",
+                    "runtime_unavailable",
+                    "manifest_unsupported",
+                    "access_profile_incompatible",
+                    "partially_degraded",
+                    "startup_failed"
+                  ],
+                  "default": "not_requested"
+                },
+                "remediation": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                }
+              },
+              "additionalProperties": false,
+              "description": "Engine-owned Delegate requested/effective/used receipt; surfaces project it without parsing model output."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed Delegate receipt; null when unavailable or legacy.",
+          "default": null
+        },
+        "detailProblem": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Stable machine code of the detail problem, if any."
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Human-readable description of the detail problem."
+                },
+                "retryable": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "description": "Whether retrying the detail read may help."
+                }
+              },
+              "required": [
+                "code",
+                "message",
+                "retryable"
+              ],
+              "additionalProperties": false,
+              "description": "Typed failure of a post-run detail read whose durable run result still survives."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed post-terminal detail-read problem (the durable run handle survives); null when the detail read succeeded.",
+          "default": null
         }
       },
       "required": [

package/generated/McpRunToolResult.schema.json

@@ -86,6 +86,7 @@
                         "wall_clock_exceeded",
                         "user_cancelled",
                         "crash_interrupted",
+                        "workspace_unavailable",
                         "input_required",
                         "work_incomplete",
                         "context_capacity_exhausted",
@@ -120,7 +121,7 @@
                         "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)."
+                      "description": "Provenance of a WorkReport: constrained (native schema transport), validated (instructed terminal metadata), or absent (no transport could carry one — a disclosed absence, not a failure)."
                     },
                     "required_inputs": {
                       "type": "array",
@@ -190,6 +191,130 @@
           "description": "The D8 terminal outcome axes (checks/review/reason/noChanges); null for non-terminal or read-only routes.",
           "default": null
         },
+        "failure": {
+          "anyOf": [
+            {
+              "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",
+                    "config_error",
+                    "budget",
+                    "policy",
+                    "cancelled",
+                    "internal",
+                    "unknown"
+                  ],
+                  "default": "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",
+                        "delegation_child_drain_timeout"
+                      ],
+                      "description": "Machine-readable failure sub-code within a RunFailure category (budget-denial reasons and Delegate child-drain timeout)."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Machine-readable failure sub-code within the category; null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+                  "default": null
+                },
+                "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."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed terminal failure detail and recovery actions; null for non-failed runs.",
+          "default": null
+        },
         "applyEligibility": {
           "anyOf": [
             {
@@ -277,6 +402,45 @@
           "description": "Derived plan readiness for plan tools (D17); null for non-plan tools.",
           "default": null
         },
+        "detailProblem": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Stable machine code of the detail problem, if any."
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Human-readable description of the detail problem."
+                },
+                "retryable": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "description": "Whether retrying the detail read may help."
+                }
+              },
+              "required": [
+                "code",
+                "message",
+                "retryable"
+              ],
+              "additionalProperties": false,
+              "description": "Typed failure of a post-run detail read whose durable run result still survives."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed post-terminal detail-read problem (the run result survives; its detail projections are absent for this reason); null when the detail read succeeded.",
+          "default": null
+        },
         "council": {
           "anyOf": [
             {
@@ -366,6 +530,75 @@
           ],
           "description": "Council membership + merge disclosure (QA-023b); null for solo/non-plan tools or deferred handles.",
           "default": null
+        },
+        "parentRunId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null
+        },
+        "delegatedFromRunId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null
+        },
+        "delegation": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "requested": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "effective": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "used": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "reason": {
+                  "type": "string",
+                  "enum": [
+                    "pending",
+                    "not_requested",
+                    "injected_unused",
+                    "used",
+                    "runtime_unavailable",
+                    "manifest_unsupported",
+                    "access_profile_incompatible",
+                    "partially_degraded",
+                    "startup_failed"
+                  ],
+                  "default": "not_requested"
+                },
+                "remediation": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                }
+              },
+              "additionalProperties": false,
+              "description": "Engine-owned Delegate requested/effective/used receipt; surfaces project it without parsing model output."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Engine-owned Delegate requested/effective/used receipt; surfaces project it without parsing model output.",
+          "default": null
         }
       },
       "required": [

package/generated/OutputReadyPayload.schema.json

@@ -0,0 +1,44 @@
+{
+  "$ref": "#/definitions/OutputReadyPayload",
+  "definitions": {
+    "OutputReadyPayload": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "answer",
+            "report",
+            "plan",
+            "summary",
+            "patch",
+            "structured_output",
+            "artifact"
+          ],
+          "description": "Kind of materialized output announced by this receipt."
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Run-relative path of the materialized output artifact."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "ready",
+            "diagnostic"
+          ],
+          "default": "ready",
+          "description": "Whether the announced artifact is normal output or diagnostic output."
+        }
+      },
+      "required": [
+        "kind",
+        "path"
+      ],
+      "additionalProperties": false,
+      "description": "Validated payload of an output.ready run event."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunEvent.schema.json

@@ -69,6 +69,7 @@
             "council.merged",
             "budget.quota_pressure",
             "delegation.belt.unavailable",
+            "delegation.belt.degraded",
             "output.ready",
             "gate.started",
             "gate.completed",