@claudexor/schema 1.0.0 → 2.0.0

package/generated/ControlRunListResponse.schema.json

@@ -0,0 +1,797 @@
+{
+  "$ref": "#/definitions/ControlRunListResponse",
+  "definitions": {
+    "ControlRunListResponse": {
+      "type": "object",
+      "properties": {
+        "runs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "jobId": {
+                "type": "string",
+                "description": "Daemon job id backing the run."
+              },
+              "runId": {
+                "type": "string",
+                "description": "Run id."
+              },
+              "taskId": {
+                "type": "string",
+                "description": "Task id, when allocated."
+              },
+              "state": {
+                "type": "string",
+                "enum": [
+                  "queued",
+                  "running",
+                  "blocked",
+                  "succeeded",
+                  "no_op",
+                  "ungated",
+                  "review_not_run",
+                  "failed",
+                  "cancelled",
+                  "interrupted_unknown",
+                  "cost_unverifiable",
+                  "exhausted_overshoot",
+                  "exhausted",
+                  "not_converged",
+                  "stuck_no_progress"
+                ],
+                "description": "Control-plane run state: queued/running while live, then an honest success, block, failure, interruption, cost, exhaustion, non-convergence, or cancellation terminal."
+              },
+              "runDir": {
+                "type": "string",
+                "description": "On-disk run artifact directory."
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message, when the run failed."
+              },
+              "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",
+                          "budget",
+                          "policy",
+                          "cancelled",
+                          "internal",
+                          "unknown"
+                        ],
+                        "default": "unknown",
+                        "description": "Typed failure category (validation, project, auth, harness, budget, policy, cancelled, internal, unknown)."
+                      },
+                      "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 failure record; null unless the run failed.",
+                "default": null
+              },
+              "project": {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "project",
+                      "none"
+                    ],
+                    "default": "none",
+                    "description": "Whether the run was anchored to a project."
+                  },
+                  "root": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Project root, when anchored."
+                  },
+                  "projectName": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Project display name, when anchored."
+                  },
+                  "context": {
+                    "type": "string",
+                    "enum": [
+                      "off",
+                      "auto"
+                    ],
+                    "default": "off",
+                    "description": "Project context depth used for the run."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Project metadata projected onto a run summary.",
+                "default": {}
+              },
+              "mode": {
+                "type": "string",
+                "enum": [
+                  "ask",
+                  "plan",
+                  "audit",
+                  "agent",
+                  "orchestrate"
+                ],
+                "description": "Canonical run mode: ask, plan, and audit are read-only; agent writes; orchestrate is the autonomous coordinator intent. Engine strategies (race, attempts, swarm, create) are flags on a mode, not modes."
+              },
+              "strategy": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "enum": [
+                      "race",
+                      "attempts",
+                      "until_clean",
+                      "swarm",
+                      "create"
+                    ]
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Engine strategy flag on the mode (race width / attempt caps / until-clean / swarm / create); flags, not modes."
+              },
+              "prompt": {
+                "type": "string",
+                "description": "The user's prompt for the run."
+              },
+              "harnesses": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Harness pool the run used."
+              },
+              "primaryHarness": {
+                "type": "string",
+                "description": "Primary harness the run preferred."
+              },
+              "routingGoal": {
+                "type": "string",
+                "enum": [
+                  "auto",
+                  "quality",
+                  "economy"
+                ],
+                "description": "Routing objective: pace expiring quota, choose the highest declared quality tier, or minimize incremental paid spend."
+              },
+              "model": {
+                "type": "string",
+                "description": "Scalar model requested for the run."
+              },
+              "reviewerPanel": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "harness": {
+                      "type": "string",
+                      "minLength": 1,
+                      "pattern": "\\S",
+                      "description": "Explicit reviewer harness id; repeated harness ids are allowed so one provider can review through multiple requested models."
+                    },
+                    "model": {
+                      "type": "string",
+                      "minLength": 1,
+                      "pattern": "\\S",
+                      "description": "Per-reviewer model hint, passed to that harness only."
+                    },
+                    "effort": {
+                      "type": "string",
+                      "enum": [
+                        "low",
+                        "medium",
+                        "high",
+                        "xhigh",
+                        "max"
+                      ],
+                      "description": "Per-reviewer effort hint, passed to that harness only."
+                    }
+                  },
+                  "required": [
+                    "harness"
+                  ],
+                  "additionalProperties": false,
+                  "description": "One reviewer of an explicit reviewer panel."
+                },
+                "description": "Explicit reviewer panel used for the run."
+              },
+              "protectedPathApprovals": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string",
+                      "minLength": 1,
+                      "pattern": "\\S",
+                      "description": "Glob approved by the operator/user for this run; consumed only by the auto-protected gate/test path policy, not by built-in critical-path gates."
+                    },
+                    "reason": {
+                      "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/reviewerPanel/items/properties/model",
+                      "description": "Optional human-readable reason for the approval."
+                    }
+                  },
+                  "required": [
+                    "path"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Per-run typed operator approval allowing changes under an auto-protected gate/test path."
+                },
+                "description": "Per-run protected-path approvals supplied."
+              },
+              "n": {
+                "type": "integer",
+                "description": "Race width, when the run was a race."
+              },
+              "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": "Explicit incremental-cash budget for the run."
+              },
+              "spendUsd": {
+                "type": [
+                  "number",
+                  "null"
+                ],
+                "description": "Settled spend in USD; null when unknown."
+              },
+              "spendEstimated": {
+                "type": "boolean",
+                "description": "True when spend is token-derived rather than natively reported."
+              },
+              "access": {
+                "type": "string",
+                "enum": [
+                  "readonly",
+                  "workspace_write",
+                  "full",
+                  "external_sandbox_full",
+                  "inherit_native"
+                ],
+                "description": "Access profile of the run: the effective profile when known, else the requested one (prefer requestedAccess/effectiveAccess)."
+              },
+              "requestedAccess": {
+                "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/access",
+                "description": "Access profile the caller requested."
+              },
+              "effectiveAccess": {
+                "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/access",
+                "description": "Access profile actually enforced by the engine."
+              },
+              "externalContextPolicy": {
+                "type": "string",
+                "enum": [
+                  "off",
+                  "auto",
+                  "cached",
+                  "live"
+                ],
+                "description": "Requested web policy for the run."
+              },
+              "webRequired": {
+                "type": "boolean",
+                "description": "Whether the run required web evidence."
+              },
+              "webMode": {
+                "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/externalContextPolicy",
+                "description": "Web policy actually executed by the selected route."
+              },
+              "webEvidence": {
+                "type": "object",
+                "properties": {
+                  "required": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Whether the run required web evidence."
+                  },
+                  "mode": {
+                    "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/externalContextPolicy",
+                    "default": "auto",
+                    "description": "Requested external-context policy for the run."
+                  },
+                  "effectiveMode": {
+                    "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/externalContextPolicy",
+                    "default": "auto",
+                    "description": "Policy the selected route actually executed (disclosed upgrades, e.g. cached to live)."
+                  },
+                  "attempted": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Whether any web activity was attempted."
+                  },
+                  "satisfied": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Whether the web-evidence requirement was satisfied."
+                  },
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "none",
+                      "attempted",
+                      "satisfied",
+                      "failed",
+                      "unverified"
+                    ],
+                    "default": "none",
+                    "description": "Web-evidence verdict for the run."
+                  },
+                  "tool": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Web tool that produced the evidence, when any."
+                  },
+                  "target": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Redacted target (query/url) of the web activity, when any."
+                  },
+                  "errorSummary": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Redacted error detail when web activity failed."
+                  },
+                  "rawDetailRef": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Artifact path holding the raw (redacted) evidence detail."
+                  },
+                  "available": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "False when the run predates the telemetry artifact; surfaces must render \"telemetry unavailable\"."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Web evidence projected onto a run summary from the telemetry artifact.",
+                "default": {}
+              },
+              "requestRequirements": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "capability": {
+                      "type": "string",
+                      "const": "browser"
+                    },
+                    "harness_id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "eligible": {
+                      "type": "boolean"
+                    },
+                    "requested": {
+                      "type": "boolean"
+                    },
+                    "effective": {
+                      "type": "boolean"
+                    },
+                    "reason": {
+                      "type": "string",
+                      "enum": [
+                        "not_requested",
+                        "effective",
+                        "manifest_unsupported",
+                        "web_policy_off",
+                        "access_profile_incompatible"
+                      ]
+                    },
+                    "evidence_refs": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "default": []
+                    }
+                  },
+                  "required": [
+                    "capability",
+                    "harness_id",
+                    "eligible",
+                    "requested",
+                    "effective",
+                    "reason"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Preflight resolution of one requested capability on one selected harness lane."
+                },
+                "default": [],
+                "description": "Engine-computed requested/effective capability receipts for selected harness lanes."
+              },
+              "toolPermissionPolicy": {
+                "type": "object",
+                "additionalProperties": {},
+                "description": "Tool allow/deny policy applied to the run."
+              },
+              "outputReadyState": {
+                "type": "string",
+                "enum": [
+                  "pending",
+                  "finalizing",
+                  "ready",
+                  "diagnostic"
+                ],
+                "description": "Whether a terminal run also has a loaded user-facing output artifact: pending (not yet), finalizing (being produced), ready (loaded), diagnostic (only diagnostic output).",
+                "default": "pending"
+              },
+              "toolWarningsTotal": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0,
+                "description": "Non-blocking tool warnings projected from the telemetry artifact."
+              },
+              "result": {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "patch",
+                      "answer",
+                      "plan",
+                      "report",
+                      "none"
+                    ],
+                    "default": "none",
+                    "description": "What the turn actually produced: a patch, an answer, a plan (no files changed), a report, or nothing."
+                  },
+                  "diffStat": {
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "files": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "description": "Files changed."
+                          },
+                          "additions": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "description": "Lines added."
+                          },
+                          "deletions": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "description": "Lines deleted."
+                          }
+                        },
+                        "required": [
+                          "files",
+                          "additions",
+                          "deletions"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "default": null,
+                    "description": "Diff statistics; null unless a patch exists."
+                  },
+                  "blockers": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "default": 0,
+                    "description": "Count of accepted blocking review findings."
+                  },
+                  "adopted": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "True when the live in-place tree was mutated this turn (regardless of review); null when unknown."
+                  },
+                  "applyState": {
+                    "type": "string",
+                    "enum": [
+                      "not_applied",
+                      "applied",
+                      "applied_review_blocked",
+                      "reverted"
+                    ],
+                    "description": "Honest application state of a run's changes: not_applied (no in-place mutation), applied (applied and review clean), applied_review_blocked (applied but review blocked/unconverged), or reverted.",
+                    "default": "not_applied"
+                  },
+                  "preTurnSha": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Tree SHA before this turn mutated the in-place tree (revert restore target)."
+                  },
+                  "postTurnSha": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Tree SHA right after this turn's mutation; revert refuses if the working tree has diverged from this since."
+                  },
+                  "revertAnchorId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "GC-independent revert anchor."
+                  },
+                  "revertable": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Revert metadata is available so a Revert affordance may be offered; not a live-safe guarantee — the server re-checks tree divergence at revert time."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Honest terminal outcome of a run (what the turn actually did), projected from the work product and answer artifacts.",
+                "default": {}
+              },
+              "waitingOnUser": {
+                "type": "boolean",
+                "default": false,
+                "description": "True while at least one interactive question is awaiting the user's answer."
+              },
+              "route": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "requestedModel": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "Model requested for the run."
+                      },
+                      "observedModel": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "Model the harness stream actually reported."
+                      },
+                      "harnessId": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "Harness that ran the final attempt."
+                      },
+                      "verified": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "True only when an observed model was actually reported by the harness stream — never inferred from the request."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "description": "Run-level route evidence projected from telemetry (requested vs observed model)."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Route evidence from telemetry; null when no telemetry exists (legacy runs).",
+                "default": null
+              },
+              "tests": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "program": {
+                      "type": "string",
+                      "minLength": 1,
+                      "pattern": "\\S",
+                      "description": "Executable invoked directly without an implicit shell."
+                    },
+                    "args": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "default": [],
+                      "description": "Exact argv passed to the executable."
+                    },
+                    "cwd": {
+                      "type": "string",
+                      "description": "Optional project-relative working directory for the command."
+                    },
+                    "envAllowlist": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/reviewerPanel/items/properties/model"
+                      },
+                      "default": [],
+                      "description": "Non-secret parent environment names explicitly forwarded to the command."
+                    }
+                  },
+                  "required": [
+                    "program"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Canonical deterministic command invocation; no implicit shell parsing."
+                },
+                "description": "Typed argv gates."
+              },
+              "specId": {
+                "type": "string",
+                "description": "SpecPack id the run was held to."
+              },
+              "specHash": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Content hash of the SpecPack the run was held to."
+              },
+              "createdAt": {
+                "type": "string",
+                "description": "When the run was created."
+              },
+              "startedAt": {
+                "type": "string",
+                "description": "When the run started."
+              },
+              "finishedAt": {
+                "type": "string",
+                "description": "When the run finished."
+              }
+            },
+            "required": [
+              "jobId",
+              "runId",
+              "state"
+            ],
+            "additionalProperties": false,
+            "description": "Run summary row served by GET /runs and embedded in run detail: state, routing, budget, policies, and honest outcome."
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false,
+      "description": "All durable run summaries visible to the daemon."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}