@claudexor/schema 3.10.5 → 3.12.0

package/generated/ControlRunDetail.schema.json

@@ -4,6 +4,190 @@
     "ControlRunDetail": {
       "type": "object",
       "properties": {
+        "attemptExecution": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "attemptId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Non-empty identifier string."
+              },
+              "harnessId": {
+                "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
+              },
+              "processing": {
+                "type": "object",
+                "properties": {
+                  "requested": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "standard",
+                          "fast",
+                          "economy"
+                        ],
+                        "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
+                  },
+                  "submitted": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/requested/anyOf/0"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
+                  },
+                  "submittedNative": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "minLength": 1,
+                        "pattern": "\\S",
+                        "description": "User-supplied string that must contain visible content, not just whitespace."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "User-supplied string that must contain visible content, not just whitespace."
+                  },
+                  "observed": {
+                    "type": "string",
+                    "enum": [
+                      "standard",
+                      "fast",
+                      "economy",
+                      "mixed",
+                      "unknown"
+                    ]
+                  },
+                  "observedNative": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0"
+                    }
+                  },
+                  "reason": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "User-supplied string that must contain visible content, not just whitespace."
+                  },
+                  "source": {
+                    "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0"
+                  }
+                },
+                "required": [
+                  "requested",
+                  "submitted",
+                  "submittedNative",
+                  "observed",
+                  "observedNative",
+                  "reason",
+                  "source"
+                ],
+                "additionalProperties": false,
+                "description": "Requested intent, submitted native control, and observed execution are independent facts. A submitted flag never proves observed service; mixed or missing session observations remain explicit."
+              },
+              "processingCostBasis": {
+                "type": "object",
+                "properties": {
+                  "nativeMode": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "User-supplied string that must contain visible content, not just whitespace."
+                  },
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "included",
+                      "paid_credits",
+                      "cash",
+                      "valuation",
+                      "unknown"
+                    ]
+                  },
+                  "source": {
+                    "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0"
+                  }
+                },
+                "required": [
+                  "nativeMode",
+                  "kind",
+                  "source"
+                ],
+                "additionalProperties": false,
+                "description": "Mode-qualified billing evidence for an existing cost record. Authentication alone does not establish included premium service; credits, cash, and token valuation stay distinct."
+              },
+              "usageCost": {
+                "type": "object",
+                "properties": {
+                  "cashUsd": {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "valuationUsd": {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "unknownUsd": {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "cashKnowledge": {
+                    "type": "string",
+                    "enum": [
+                      "exact",
+                      "estimated",
+                      "unknown"
+                    ],
+                    "description": "Quality of incremental-cash cost evidence for an operation."
+                  },
+                  "valuationKnowledge": {
+                    "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/usageCost/properties/cashKnowledge"
+                  }
+                },
+                "required": [
+                  "cashUsd",
+                  "valuationUsd",
+                  "unknownUsd",
+                  "cashKnowledge",
+                  "valuationKnowledge"
+                ],
+                "additionalProperties": false,
+                "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash."
+              }
+            },
+            "required": [
+              "attemptId",
+              "harnessId"
+            ],
+            "additionalProperties": false,
+            "description": "Compact projection of existing attempt execution and amount evidence."
+          }
+        },
         "summary": {
           "type": "object",
           "properties": {
@@ -18,9 +202,7 @@
             "parentRunId": {
               "anyOf": [
                 {
-                  "type": "string",
-                  "minLength": 1,
-                  "description": "Non-empty identifier string."
+                  "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                 },
                 {
                   "type": "null"
@@ -32,7 +214,7 @@
             "delegatedFromRunId": {
               "anyOf": [
                 {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                  "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                 },
                 {
                   "type": "null"
@@ -377,9 +559,7 @@
                     "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",
+                    "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0",
                     "description": "Per-reviewer model hint, passed to that harness only."
                   },
                   "effort": {
@@ -390,8 +570,12 @@
                     "description": "Per-reviewer effort hint, passed to that harness only."
                   },
                   "credentialProfileId": {
-                    "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/reviewerPanel/items/properties/model",
+                    "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0",
                     "description": "Per-reviewer credential profile id; explicit pins are strict and never fall back."
+                  },
+                  "processingPreference": {
+                    "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/requested/anyOf/0",
+                    "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
                   }
                 },
                 "required": [
@@ -414,7 +598,7 @@
                     "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/ControlRunDetail/properties/summary/properties/reviewerPanel/items/properties/model",
+                    "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0",
                     "description": "Optional human-readable reason for the approval."
                   }
                 },
@@ -905,13 +1089,14 @@
                   "type": "string",
                   "enum": [
                     "patch",
+                    "files",
                     "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."
+                  "description": "What the turn actually produced: a Git patch, directory files, an answer, a plan, a report, or nothing."
                 },
                 "diffStat": {
                   "anyOf": [
@@ -968,9 +1153,10 @@
                     "not_applied",
                     "applied",
                     "applied_review_blocked",
-                    "reverted"
+                    "reverted",
+                    "discarded"
                   ],
-                  "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.",
+                  "description": "Honest application state: not_applied (delivery pending), applied, applied_review_blocked, reverted, or discarded (remaining copied output deliberately not applied).",
                   "default": "not_applied"
                 },
                 "preTurnSha": {
@@ -1023,7 +1209,10 @@
                       "description": "Terminal lifecycle of the run."
                     },
                     "noChanges": {
-                      "type": "boolean",
+                      "type": [
+                        "boolean",
+                        "null"
+                      ],
                       "default": false,
                       "description": "True when the run finished without changing any files (the ex no_op fact)."
                     },
@@ -1245,7 +1434,7 @@
                     "order": {
                       "type": "array",
                       "items": {
-                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                        "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                       },
                       "default": [],
                       "description": "Final ranked order, harness ids."
@@ -1253,7 +1442,7 @@
                     "dropped": {
                       "type": "array",
                       "items": {
-                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                        "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                       },
                       "default": [],
                       "description": "Ids removed by paid_fallback or cooldown before ranking."
@@ -1362,7 +1551,7 @@
                   "envAllowlist": {
                     "type": "array",
                     "items": {
-                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/reviewerPanel/items/properties/model"
+                      "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0"
                     },
                     "default": [],
                     "description": "Non-secret parent environment names explicitly forwarded to the command."
@@ -1417,10 +1606,10 @@
                   "description": "Schema version of the artifact; bumped on breaking ABI changes."
                 },
                 "run_id": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                  "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                 },
                 "task_id": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                  "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                 },
                 "mode": {
                   "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/mode"
@@ -1444,6 +1633,7 @@
                             "report",
                             "plan",
                             "patch",
+                            "files",
                             "structured_output"
                           ]
                         },
@@ -1463,7 +1653,7 @@
                     "producer_attempt_id": {
                       "anyOf": [
                         {
-                          "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                          "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                         },
                         {
                           "type": "null"
@@ -1504,6 +1694,7 @@
                                 "report",
                                 "plan",
                                 "patch",
+                                "files",
                                 "structured_output",
                                 "diagnostic"
                               ],
@@ -1552,7 +1743,7 @@
                           "attempt_id": {
                             "anyOf": [
                               {
-                                "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                                "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                               },
                               {
                                 "type": "null"
@@ -1654,7 +1845,7 @@
                     "receipt_attempt_id": {
                       "anyOf": [
                         {
-                          "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                          "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                         },
                         {
                           "type": "null"
@@ -1683,7 +1874,7 @@
                     "blocker_ids": {
                       "type": "array",
                       "items": {
-                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                        "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                       },
                       "default": [],
                       "description": "Stable ids of accepted evidence-backed blocking findings."
@@ -1884,6 +2075,7 @@
                     "plan",
                     "summary",
                     "patch",
+                    "files",
                     "diagnostic",
                     "structured_output"
                   ],
@@ -2052,6 +2244,15 @@
         "budget": {
           "type": "object",
           "properties": {
+            "cashKnowledge": {
+              "type": "string",
+              "enum": [
+                "exact",
+                "estimated",
+                "unknown"
+              ],
+              "description": "Cash certainty from the ledger; explicit unknown keeps spendUsd null independently of valuation."
+            },
             "paidBudget": {
               "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/paidBudget",
               "default": {
@@ -2140,7 +2341,7 @@
                 "winner": {
                   "anyOf": [
                     {
-                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                      "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                     },
                     {
                       "type": "null"
@@ -2344,6 +2545,10 @@
                     {
                       "type": "object",
                       "properties": {
+                        "base_manifest_sha256": {
+                          "type": "string",
+                          "description": "Exact directory manifest verified; not a Git commit identifier."
+                        },
                         "attempted": {
                           "type": "boolean",
                           "description": "Whether the final verify was attempted."
@@ -2490,9 +2695,10 @@
                   "enum": [
                     "patch",
                     "new_repo",
-                    "report"
+                    "report",
+                    "files"
                   ],
-                  "description": "Kind of work product a run produces: a patch against the base tree, a newly created repository, or a report document."
+                  "description": "Kind of work product: Git patch, new repository, report, or complete directory file manifest with retained bytes."
                 },
                 "source_task_id": {
                   "type": "string",
@@ -2500,7 +2706,7 @@
                   "description": "Task the work product came from."
                 },
                 "producer_attempt_id": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0",
+                  "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId",
                   "description": "Attempt that produced it, when known."
                 },
                 "files": {
@@ -2524,7 +2730,7 @@
                 "source_task_id"
               ],
               "additionalProperties": false,
-              "description": "The deliverable a run produced (patch, new repo, or report), referenced by apply/delivery verbs."
+              "description": "The deliverable a run produced, referenced by apply/delivery verbs; files uses files.manifest and meta.manifest_sha256."
             },
             {
               "type": "null"
@@ -2781,7 +2987,7 @@
               "linked_acceptance_criteria": {
                 "type": "array",
                 "items": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                  "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
                 },
                 "default": [],
                 "description": "Ids of acceptance criteria this finding relates to."

package/generated/ControlRunListResponse.schema.json

@@ -394,6 +394,15 @@
                     "credentialProfileId": {
                       "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/reviewerPanel/items/properties/model",
                       "description": "Per-reviewer credential profile id; explicit pins are strict and never fall back."
+                    },
+                    "processingPreference": {
+                      "type": "string",
+                      "enum": [
+                        "standard",
+                        "fast",
+                        "economy"
+                      ],
+                      "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
                     }
                   },
                   "required": [
@@ -907,13 +916,14 @@
                     "type": "string",
                     "enum": [
                       "patch",
+                      "files",
                       "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."
+                    "description": "What the turn actually produced: a Git patch, directory files, an answer, a plan, a report, or nothing."
                   },
                   "diffStat": {
                     "anyOf": [
@@ -970,9 +980,10 @@
                       "not_applied",
                       "applied",
                       "applied_review_blocked",
-                      "reverted"
+                      "reverted",
+                      "discarded"
                     ],
-                    "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.",
+                    "description": "Honest application state: not_applied (delivery pending), applied, applied_review_blocked, reverted, or discarded (remaining copied output deliberately not applied).",
                     "default": "not_applied"
                   },
                   "preTurnSha": {
@@ -1025,7 +1036,10 @@
                         "description": "Terminal lifecycle of the run."
                       },
                       "noChanges": {
-                        "type": "boolean",
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
                         "default": false,
                         "description": "True when the run finished without changing any files (the ex no_op fact)."
                       },

package/generated/ControlRunStartRequest.schema.json

@@ -116,6 +116,22 @@
             "workspaceRoot": {
               "type": "string",
               "description": "Absolute existing execution workspace for a project-scoped delegated agent live run. The stable project identity remains scope.root."
+            },
+            "workspaceKind": {
+              "type": "string",
+              "enum": [
+                "git",
+                "directory"
+              ],
+              "description": "Explicit directory execution needs no Git initialization; omission preserves existing clients."
+            },
+            "scopePaths": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": "Agent-selected input footprint. Directory copies materialize this entire selection; direct runs need no whole-tree baseline."
             }
           },
           "additionalProperties": false,
@@ -169,6 +185,15 @@
           "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
           "description": "Requested reasoning effort."
         },
+        "processingPreference": {
+          "type": "string",
+          "enum": [
+            "standard",
+            "fast",
+            "economy"
+          ],
+          "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
+        },
         "efforts": {
           "type": "object",
           "additionalProperties": {
@@ -462,6 +487,10 @@
               "credentialProfileId": {
                 "$ref": "#/definitions/ControlRunStartRequest/properties/harnesses/items",
                 "description": "Per-reviewer credential profile id; explicit pins are strict and never fall back."
+              },
+              "processingPreference": {
+                "$ref": "#/definitions/ControlRunStartRequest/properties/processingPreference",
+                "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
               }
             },
             "required": [

package/generated/ControlRunSummary.schema.json

@@ -389,6 +389,15 @@
               "credentialProfileId": {
                 "$ref": "#/definitions/ControlRunSummary/properties/reviewerPanel/items/properties/model",
                 "description": "Per-reviewer credential profile id; explicit pins are strict and never fall back."
+              },
+              "processingPreference": {
+                "type": "string",
+                "enum": [
+                  "standard",
+                  "fast",
+                  "economy"
+                ],
+                "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
               }
             },
             "required": [
@@ -902,13 +911,14 @@
               "type": "string",
               "enum": [
                 "patch",
+                "files",
                 "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."
+              "description": "What the turn actually produced: a Git patch, directory files, an answer, a plan, a report, or nothing."
             },
             "diffStat": {
               "anyOf": [
@@ -965,9 +975,10 @@
                 "not_applied",
                 "applied",
                 "applied_review_blocked",
-                "reverted"
+                "reverted",
+                "discarded"
               ],
-              "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.",
+              "description": "Honest application state: not_applied (delivery pending), applied, applied_review_blocked, reverted, or discarded (remaining copied output deliberately not applied).",
               "default": "not_applied"
             },
             "preTurnSha": {
@@ -1020,7 +1031,10 @@
                   "description": "Terminal lifecycle of the run."
                 },
                 "noChanges": {
-                  "type": "boolean",
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
                   "default": false,
                   "description": "True when the run finished without changing any files (the ex no_op fact)."
                 },

package/generated/ControlThreadApplyResponse.schema.json

@@ -51,6 +51,12 @@
                 "applied": {
                   "type": "boolean"
                 },
+                "appliedPaths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
                 "branch": {
                   "type": "string"
                 },
@@ -86,6 +92,10 @@
                 "finalVerify": {
                   "type": "object",
                   "properties": {
+                    "base_manifest_sha256": {
+                      "type": "string",
+                      "description": "Exact directory manifest verified; not a Git commit identifier."
+                    },
                     "attempted": {
                       "type": "boolean",
                       "description": "Whether the final verify was attempted."