@claudexor/schema 3.1.2 → 3.3.7-rc.0

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,147 @@
           "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",
+                        "subscription_window_exhausted",
+                        "delegated_home_unavailable",
+                        "delegated_confinement_unavailable",
+                        "delegated_evidence_incomplete"
+                      ],
+                      "description": "Machine-readable failure sub-code within a RunFailure category (budget-denial reasons, Delegate child-drain timeout, a spent subscription quota window whose reopen time is RunFailure.resetsAt, and the delegated-run confinement refusals: missing scoped home, no OS-enforced boundary on this host, incomplete applied evidence)."
+                    },
+                    {
+                      "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."
+                },
+                "resetsAt": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "format": "date-time"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null,
+                  "description": "When the refused window reopens (a spent subscription quota window), or null when the failure has no such time. Callers schedule a retry off this field, never off safeMessage."
+                },
+                "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 +419,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": [
             {

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#"
+}