@claudexor/schema 3.0.4 → 3.1.1

package/generated/HarnessStatusDto.schema.json

@@ -344,21 +344,76 @@
                       "default": false,
                       "description": "The harness can constrain its final message to a caller-supplied JSON Schema (native structured-output flag)."
                     },
+                    "work_report_transport": {
+                      "type": "string",
+                      "enum": [
+                        "constrained",
+                        "validated",
+                        "unsupported"
+                      ],
+                      "default": "unsupported",
+                      "description": "How the harness carries the D-16 WorkReport envelope: constrained (native schema transport), validated (whole-answer JSON), or unsupported (work_state stays unverified)."
+                    },
+                    "structured_output_channel": {
+                      "type": "string",
+                      "enum": [
+                        "side_tool",
+                        "final_message"
+                      ],
+                      "default": "final_message",
+                      "description": "Where a schema-constrained answer surfaces: side_tool (rides a tool; final message stays markdown) or final_message (constrains the final message itself)."
+                    },
                     "effort_levels": {
                       "type": "array",
                       "items": {
                         "type": "string",
-                        "enum": [
-                          "low",
-                          "medium",
-                          "high",
-                          "xhigh",
-                          "max"
-                        ],
-                        "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+                        "minLength": 1,
+                        "maxLength": 32,
+                        "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
+                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
                       },
                       "default": [],
-                      "description": "Ordered (weakest to strongest) reasoning-effort levels this harness actually accepts; empty means effort is not a tunable surface."
+                      "description": "Ordered (weakest to strongest) reasoning-effort levels this harness accepts across all its models; empty means effort is not a tunable surface."
+                    },
+                    "model_effort_levels": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "object",
+                        "properties": {
+                          "levels": {
+                            "type": "array",
+                            "items": {
+                              "$ref": "#/definitions/HarnessStatusDto/properties/manifest/anyOf/0/properties/capabilities/properties/effort_levels/items"
+                            },
+                            "default": [],
+                            "description": "Ordered (weakest to strongest) reasoning-effort levels this model advertises, in the vendor's own order."
+                          },
+                          "default": {
+                            "anyOf": [
+                              {
+                                "$ref": "#/definitions/HarnessStatusDto/properties/manifest/anyOf/0/properties/capabilities/properties/effort_levels/items"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "The effort level the vendor uses for this model when none is requested.",
+                            "default": null
+                          }
+                        },
+                        "additionalProperties": false,
+                        "description": "Reasoning-effort vocabulary a single model advertises."
+                      },
+                      "default": {},
+                      "description": "Per-model advertised reasoning-effort vocabulary keyed by model id; a model absent here falls back to the harness-wide effort_levels union."
+                    },
+                    "effort_levels_verified_against": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Vendor CLI version the effort ladders were last verified against; null = never verified / not applicable."
                     },
                     "known_models": {
                       "type": "array",

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/ProjectConfig.schema.json

@@ -112,6 +112,32 @@
           "additionalProperties": false,
           "default": {},
           "description": "Safe project routing preference; paid fallback remains user-global."
+        },
+        "constraints": {
+          "type": "object",
+          "properties": {
+            "protected_paths": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "allOf": [
+                  {
+                    "pattern": "\\S"
+                  },
+                  {
+                    "pattern": "^(?!\\/)(?![A-Za-z]:)(?!.*\\\\)(?!.*\\0)(?!.*\\/\\/)(?!.*\\/$)(?!.*(?:^|\\/)\\.\\.?(?:\\/|$))\\S(?:.*\\S)?$"
+                  }
+                ],
+                "description": "Canonical repo-relative glob whose matching changes require human approval before apply."
+              },
+              "default": [],
+              "description": "Restriction-only repo-relative globs whose matching changes require a human decision before apply; empty by default."
+            }
+          },
+          "additionalProperties": false,
+          "default": {},
+          "description": "Safe project restrictions that can only narrow what an unattended run may apply."
         }
       },
       "additionalProperties": false,