@claudexor/schema 3.1.1 → 3.2.0

package/generated/ControlRunDetail.schema.json

@@ -15,6 +15,87 @@
               "type": "string",
               "description": "Run id."
             },
+            "parentRunId": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Non-empty identifier string."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Parent/follow-up run id, when any.",
+              "default": null
+            },
+            "delegatedFromRunId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Claudexor Delegate parent run id; null for ordinary runs and native vendor subagents.",
+              "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": "Durable Delegate requested/effective/used receipt projected from engine telemetry; null when legacy telemetry has no receipt.",
+              "default": null
+            },
             "taskId": {
               "type": "string",
               "description": "Task id, when allocated."
@@ -77,15 +158,16 @@
                             "estimate_headroom",
                             "unknown_paid_in_flight",
                             "budget_overshoot",
-                            "cost_unverifiable"
+                            "cost_unverifiable",
+                            "delegation_child_drain_timeout"
                           ],
-                          "description": "Machine-readable failure sub-code within a RunFailure category (today the typed budget-denial reasons produced by the budget ledger)."
+                          "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 (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.",
+                      "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": {
@@ -365,7 +447,7 @@
             },
             "spendEstimated": {
               "type": "boolean",
-              "description": "True when spend is token-derived rather than natively reported."
+              "description": "True when settled cash is estimated rather than exact."
             },
             "inputTokens": {
               "anyOf": [
@@ -496,6 +578,14 @@
                       ],
                       "default": null
                     },
+                    "profileId": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Credential profile the deciding attempt ran under; null = engine-default credentials."
+                    },
                     "modelMismatch": {
                       "anyOf": [
                         {
@@ -662,7 +752,8 @@
                     "type": "string",
                     "enum": [
                       "browser",
-                      "path_deny"
+                      "path_deny",
+                      "delegation"
                     ]
                   },
                   "harness_id": {
@@ -686,6 +777,7 @@
                       "manifest_unsupported",
                       "web_policy_off",
                       "access_profile_incompatible",
+                      "runtime_unavailable",
                       "postdiff_only"
                     ]
                   },
@@ -899,6 +991,7 @@
                             "wall_clock_exceeded",
                             "user_cancelled",
                             "crash_interrupted",
+                            "workspace_unavailable",
                             "input_required",
                             "work_incomplete",
                             "context_capacity_exhausted",
@@ -933,7 +1026,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",
@@ -1006,7 +1099,7 @@
             "waitingOnUser": {
               "type": "boolean",
               "default": false,
-              "description": "True while at least one interactive question is awaiting the user's answer."
+              "description": "True while at least one interactive question awaits answer, timeout, run-terminal, or interruption release."
             },
             "route": {
               "anyOf": [
@@ -1073,9 +1166,7 @@
                     "order": {
                       "type": "array",
                       "items": {
-                        "type": "string",
-                        "minLength": 1,
-                        "description": "Non-empty identifier string."
+                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
                       },
                       "default": [],
                       "description": "Final ranked order, harness ids."
@@ -1083,7 +1174,7 @@
                     "dropped": {
                       "type": "array",
                       "items": {
-                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
+                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
                       },
                       "default": [],
                       "description": "Ids removed by paid_fallback or cooldown before ranking."
@@ -1096,6 +1187,8 @@
                         "quality_tier",
                         "expiring_quota_slack",
                         "all_incremental_cash_unknown",
+                        "delegate_effective_first",
+                        "explicit_primary",
                         "declared_order"
                       ],
                       "description": "Typed decisive reason the pool ranked the way it did (QA-034)."
@@ -1225,6 +1318,429 @@
           "additionalProperties": false,
           "description": "Run summary row served by GET /runs and embedded in run detail: state, routing, budget, policies, and honest outcome."
         },
+        "children": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlRunDetail/properties/summary"
+          },
+          "maxItems": 8,
+          "default": [],
+          "description": "Direct Claudexor Delegate child runs, projected from persisted delegatedFromRunId lineage for reload-safe flat rows."
+        },
+        "runFacts": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "schema_version": {
+                  "type": "number",
+                  "const": 2,
+                  "description": "Schema version of the artifact; bumped on breaking ABI changes."
+                },
+                "run_id": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                },
+                "task_id": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                },
+                "mode": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/mode"
+                },
+                "outcome": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/outcomeFacts/anyOf/0"
+                },
+                "deliverable": {
+                  "type": "object",
+                  "properties": {
+                    "present": {
+                      "type": "boolean",
+                      "description": "Whether the canonical primary deliverable exists."
+                    },
+                    "kind": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "answer",
+                            "report",
+                            "plan",
+                            "patch",
+                            "structured_output"
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Kind of canonical primary deliverable; null when none exists."
+                    },
+                    "path": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "description": "Run-relative path of the canonical primary deliverable; null when absent."
+                    },
+                    "producer_attempt_id": {
+                      "anyOf": [
+                        {
+                          "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Attempt that produced the deliverable, when known.",
+                      "default": null
+                    }
+                  },
+                  "required": [
+                    "present",
+                    "kind",
+                    "path"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Canonical primary-output presence and identity for a terminal run."
+                },
+                "presentation": {
+                  "type": "object",
+                  "properties": {
+                    "state": {
+                      "type": "string",
+                      "enum": [
+                        "ready",
+                        "diagnostic"
+                      ],
+                      "description": "Terminal output readiness decided by the last valid output.ready receipt."
+                    },
+                    "primary": {
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "kind": {
+                              "type": "string",
+                              "enum": [
+                                "answer",
+                                "report",
+                                "plan",
+                                "patch",
+                                "structured_output",
+                                "diagnostic"
+                              ],
+                              "description": "Presentation kind of the terminal primary artifact."
+                            },
+                            "path": {
+                              "type": "string",
+                              "minLength": 1,
+                              "description": "Normalized run-relative path of the terminal primary artifact."
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "path"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Primary user-facing artifact selected once during terminal preparation."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Selected terminal primary artifact, or null when the receipt announces readiness without a primary deliverable."
+                    }
+                  },
+                  "required": [
+                    "state",
+                    "primary"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Immutable terminal output state and primary artifact. Absent only on legacy RunFacts receipts."
+                },
+                "participants": {
+                  "type": "object",
+                  "properties": {
+                    "planners": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Number of participants whose canonical role is planner."
+                    },
+                    "attempts": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "attempt_id": {
+                            "anyOf": [
+                              {
+                                "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Attempt id when the participant owns an orchestrator attempt; null for reviewer-panel members."
+                          },
+                          "harness_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Harness that served this participant role."
+                          },
+                          "role": {
+                            "type": "string",
+                            "enum": [
+                              "planner",
+                              "merge",
+                              "candidate",
+                              "scout",
+                              "reducer",
+                              "reviewer"
+                            ],
+                            "description": "Canonical role of one participant in the terminal run graph."
+                          },
+                          "deliverable_present": {
+                            "type": "boolean",
+                            "default": false,
+                            "description": "Whether this participant produced the deliverable its role requested."
+                          },
+                          "status": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "success",
+                                  "success_with_warnings",
+                                  "blocked",
+                                  "failed"
+                                ],
+                                "description": "Terminal outcome recorded for one run participant."
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Participant outcome when recorded; null for artifact-only reviewer membership.",
+                            "default": null
+                          }
+                        },
+                        "required": [
+                          "attempt_id",
+                          "harness_id",
+                          "role"
+                        ],
+                        "additionalProperties": false,
+                        "description": "One role-labelled participant in the terminal run graph."
+                      },
+                      "default": [],
+                      "description": "Role-labelled participant roster."
+                    }
+                  },
+                  "required": [
+                    "planners"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Terminal participant graph plus its planner-lane count."
+                },
+                "gates": {
+                  "type": "object",
+                  "properties": {
+                    "configured": {
+                      "type": "boolean",
+                      "description": "Whether the frozen task configured deterministic gates."
+                    },
+                    "required": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Number of configured required gates."
+                    },
+                    "total": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Total configured deterministic gates."
+                    },
+                    "executed": {
+                      "type": "boolean",
+                      "description": "Whether the terminal attempt executed the gate set."
+                    },
+                    "state": {
+                      "type": "string",
+                      "enum": [
+                        "not_configured",
+                        "passed",
+                        "failed",
+                        "skipped"
+                      ],
+                      "description": "Terminal state of the configured deterministic gate set."
+                    },
+                    "receipt_attempt_id": {
+                      "anyOf": [
+                        {
+                          "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Attempt whose gate receipt decides this projection; null when no gates executed.",
+                      "default": null
+                    }
+                  },
+                  "required": [
+                    "configured",
+                    "required",
+                    "total",
+                    "executed",
+                    "state"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Canonical gate configuration and terminal receipt projection."
+                },
+                "review": {
+                  "type": "object",
+                  "properties": {
+                    "state": {
+                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/outcomeFacts/anyOf/0/properties/review"
+                    },
+                    "blocker_ids": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                      },
+                      "default": [],
+                      "description": "Stable ids of accepted evidence-backed blocking findings."
+                    },
+                    "blockers": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Number of blocking findings."
+                    }
+                  },
+                  "required": [
+                    "state",
+                    "blockers"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Canonical terminal review verdict and blocking-finding identity."
+                },
+                "apply": {
+                  "type": "object",
+                  "properties": {
+                    "eligibility": {
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "eligible": {
+                              "type": "boolean",
+                              "description": "True when the apply gate would accept this run's patch right now."
+                            },
+                            "state": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "description": "The gate's apply-eligibility classification (e.g. needs_review | not_verified | no_changes | ok) when known."
+                            },
+                            "reason": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "description": "The gate's refusal text when not eligible (null when eligible)."
+                            },
+                            "requiredAction": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "description": "Honest guidance for what actually unblocks apply (typed operator decision, add gates, re-run, or nothing to apply)."
+                            }
+                          },
+                          "required": [
+                            "eligible",
+                            "state",
+                            "reason",
+                            "requiredAction"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Derived apply-gate verdict for a run's WorkProduct (single producer in the delivery gate)."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Delivery-gate eligibility at terminalization; null when nothing is applyable.",
+                      "default": null
+                    },
+                    "operator_decision_present": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Whether a valid operator decision was present when the receipt was finalized."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "Terminal apply eligibility and operator-decision state."
+                },
+                "required_actions": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "enum": [
+                          "provide_required_input",
+                          "complete_incomplete_work",
+                          "resolve_review_block",
+                          "fix_failed_checks",
+                          "record_operator_decision"
+                        ],
+                        "description": "Stable machine id for a required operator action on a blocked terminal run."
+                      },
+                      "detail": {
+                        "type": "string",
+                        "description": "Human-readable guidance for this action (English-only, INV-141)."
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "detail"
+                    ],
+                    "additionalProperties": false,
+                    "description": "One typed required operator action derived from a run's terminal outcome facts."
+                  },
+                  "default": [],
+                  "description": "Typed actions required to unblock this terminal outcome."
+                },
+                "generated_at": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "When this immutable terminal receipt was finalized."
+                }
+              },
+              "required": [
+                "schema_version",
+                "run_id",
+                "task_id",
+                "mode",
+                "outcome",
+                "deliverable",
+                "participants",
+                "gates",
+                "review",
+                "apply",
+                "generated_at"
+              ],
+              "additionalProperties": false,
+              "description": "Validated immutable terminal facts for one run."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Validated terminal RunFacts receipt; null while active or unavailable.",
+          "default": null
+        },
         "outcomeBanner": {
           "type": [
             "string",
@@ -1480,7 +1996,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",
@@ -1524,7 +2040,7 @@
                 "winner": {
                   "anyOf": [
                     {
-                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
+                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
                     },
                     {
                       "type": "null"
@@ -1664,7 +2180,7 @@
                     "estimated": {
                       "type": "boolean",
                       "default": false,
-                      "description": "True when any of the spend is token-derived rather than natively reported."
+                      "description": "True when settled cash is estimated rather than exact."
                     },
                     "cash_usd": {
                       "type": [
@@ -1681,6 +2197,15 @@
                       ],
                       "default": null,
                       "description": "Settled subscription-equivalent valuation in USD (includes the reviewer panel); null when unknown."
+                    },
+                    "valuation_knowledge": {
+                      "type": "string",
+                      "enum": [
+                        "exact",
+                        "estimated",
+                        "unknown"
+                      ],
+                      "description": "Certainty of valuation_usd, independent from the settled-cash estimated flag. Absent only on legacy decisions."
                     }
                   },
                   "additionalProperties": false,
@@ -1874,13 +2399,9 @@
                   "description": "Task the work product came from."
                 },
                 "producer_attempt_id": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items",
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0",
                   "description": "Attempt that produced it, when known."
                 },
-                "evidence_dir": {
-                  "type": "string",
-                  "description": "Directory holding run evidence artifacts."
-                },
                 "files": {
                   "type": "object",
                   "additionalProperties": {
@@ -2104,42 +2625,7 @@
         "applyEligibility": {
           "anyOf": [
             {
-              "type": "object",
-              "properties": {
-                "eligible": {
-                  "type": "boolean",
-                  "description": "True when the apply gate would accept this run's patch right now."
-                },
-                "state": {
-                  "type": [
-                    "string",
-                    "null"
-                  ],
-                  "description": "The gate's apply-eligibility classification (e.g. needs_review | not_verified | no_changes | ok) when known."
-                },
-                "reason": {
-                  "type": [
-                    "string",
-                    "null"
-                  ],
-                  "description": "The gate's refusal text when not eligible (null when eligible)."
-                },
-                "requiredAction": {
-                  "type": [
-                    "string",
-                    "null"
-                  ],
-                  "description": "Honest guidance for what actually unblocks apply (typed operator decision, add gates, re-run, or nothing to apply)."
-                }
-              },
-              "required": [
-                "eligible",
-                "state",
-                "reason",
-                "requiredAction"
-              ],
-              "additionalProperties": false,
-              "description": "Derived apply-gate verdict for a run's WorkProduct (single producer in the delivery gate)."
+              "$ref": "#/definitions/ControlRunDetail/properties/runFacts/anyOf/0/properties/apply/properties/eligibility/anyOf/0"
             },
             {
               "type": "null"
@@ -2194,7 +2680,7 @@
               "linked_acceptance_criteria": {
                 "type": "array",
                 "items": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
                 },
                 "default": [],
                 "description": "Ids of acceptance criteria this finding relates to."
@@ -2706,30 +3192,7 @@
         "requiredActions": {
           "type": "array",
           "items": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "enum": [
-                  "provide_required_input",
-                  "complete_incomplete_work",
-                  "resolve_review_block",
-                  "fix_failed_checks",
-                  "record_operator_decision"
-                ],
-                "description": "Stable machine id for a required operator action on a blocked terminal run."
-              },
-              "detail": {
-                "type": "string",
-                "description": "Human-readable guidance for this action (English-only, INV-141)."
-              }
-            },
-            "required": [
-              "id",
-              "detail"
-            ],
-            "additionalProperties": false,
-            "description": "One typed required operator action derived from a run's terminal outcome facts."
+            "$ref": "#/definitions/ControlRunDetail/properties/runFacts/anyOf/0/properties/required_actions/items"
           },
           "default": [],
           "description": "Stable-id required operator actions for a succeeded-but-blocked run (GH #29); empty for clean/decided/failed runs."