@claudexor/schema 3.9.7 → 3.10.0

package/generated/ControlModelOperationDetail.schema.json

@@ -0,0 +1,464 @@
+{
+  "$ref": "#/definitions/ControlModelOperationDetail",
+  "definitions": {
+    "ControlModelOperationDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "queued",
+            "running",
+            "succeeded",
+            "failed",
+            "cancelled",
+            "interrupted"
+          ],
+          "description": "Run lifecycle: queued, running, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks, review, delivery) is orthogonal."
+        },
+        "createdAt": {
+          "type": "string",
+          "minLength": 1,
+          "description": "ISO-8601 timestamp string."
+        },
+        "startedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "ISO-8601 timestamp string."
+        },
+        "finishedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "ISO-8601 timestamp string."
+        },
+        "dispatch": {
+          "type": "object",
+          "properties": {
+            "state": {
+              "type": "string",
+              "enum": [
+                "not_started",
+                "started",
+                "response_received",
+                "unknown"
+              ]
+            },
+            "startedAt": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "ISO-8601 timestamp string."
+            },
+            "route": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "source": {
+                      "$ref": "#/definitions/ControlModelOperationDetail/properties/id"
+                    },
+                    "credentialProfileId": {
+                      "$ref": "#/definitions/ControlModelOperationDetail/properties/id"
+                    },
+                    "accountFingerprint": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "model": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "source",
+                    "credentialProfileId",
+                    "accountFingerprint",
+                    "model"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Selected route at dispatch; a result records the actually observed model, or null."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Selected route at dispatch; a result records the actually observed model, or null."
+            }
+          },
+          "required": [
+            "state",
+            "startedAt",
+            "route"
+          ],
+          "additionalProperties": false,
+          "description": "Started means the physical send may have begun, not proof the upstream accepted it."
+        },
+        "response": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "state": {
+                  "type": "string",
+                  "const": "absent"
+                }
+              },
+              "required": [
+                "state"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "state": {
+                  "type": "string",
+                  "const": "ready"
+                },
+                "ref": {
+                  "type": "object",
+                  "properties": {
+                    "resourceId": {
+                      "$ref": "#/definitions/ControlModelOperationDetail/properties/id"
+                    },
+                    "sha256": {
+                      "type": "string",
+                      "pattern": "^sha256:[a-f0-9]{64}$"
+                    },
+                    "sizeBytes": {
+                      "type": "integer",
+                      "minimum": 0
+                    }
+                  },
+                  "required": [
+                    "resourceId",
+                    "sha256",
+                    "sizeBytes"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Digest-bound model-purpose resource; never an Agent attachment."
+                },
+                "readyAt": {
+                  "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
+                },
+                "expiresAt": {
+                  "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
+                }
+              },
+              "required": [
+                "state",
+                "ref",
+                "readyAt",
+                "expiresAt"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "state": {
+                  "type": "string",
+                  "const": "acknowledged"
+                },
+                "ref": {
+                  "$ref": "#/definitions/ControlModelOperationDetail/properties/response/anyOf/1/properties/ref"
+                },
+                "releasedAt": {
+                  "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
+                }
+              },
+              "required": [
+                "state",
+                "ref",
+                "releasedAt"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "state": {
+                  "type": "string",
+                  "const": "expired"
+                },
+                "ref": {
+                  "$ref": "#/definitions/ControlModelOperationDetail/properties/response/anyOf/1/properties/ref"
+                },
+                "releasedAt": {
+                  "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
+                }
+              },
+              "required": [
+                "state",
+                "ref",
+                "releasedAt"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "description": "Result GET does not acknowledge delivery. Acknowledged/expired bytes never cause another generation."
+        },
+        "usage": {
+          "type": "object",
+          "properties": {
+            "input_tokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "output_tokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "cached_input_tokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "cache_write_tokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "reasoning_tokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            }
+          },
+          "additionalProperties": false,
+          "description": "Provider-reported counters for one generation; missing counters remain null."
+        },
+        "cost": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "knowledge": {
+                  "type": "string",
+                  "enum": [
+                    "exact",
+                    "estimated",
+                    "unknown"
+                  ],
+                  "description": "Quality of incremental-cash cost evidence for an operation."
+                },
+                "billing": {
+                  "type": "string",
+                  "enum": [
+                    "proven_zero",
+                    "subscription_entitlement",
+                    "metered",
+                    "unknown"
+                  ],
+                  "description": "What is actually known about incremental billing; a native credential route alone never proves entitlement or zero cost."
+                },
+                "source": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "provenance": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "minItems": 1
+                },
+                "estimatedUsd": {
+                  "anyOf": [
+                    {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "cashUsd": {
+                  "anyOf": [
+                    {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "valuationUsd": {
+                  "anyOf": [
+                    {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "valuationKnowledge": {
+                  "$ref": "#/definitions/ControlModelOperationDetail/properties/cost/anyOf/0/properties/knowledge",
+                  "default": "unknown",
+                  "description": "Quality of incremental-cash cost evidence for an operation."
+                }
+              },
+              "required": [
+                "knowledge",
+                "billing",
+                "source",
+                "provenance"
+              ],
+              "additionalProperties": false,
+              "description": "Incremental cash and token valuation are independent; subscription credentials alone never invent a cash receipt."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Incremental cash and token valuation are independent; subscription credentials alone never invent a cash receipt."
+        },
+        "problem": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "message": {
+                  "type": "string"
+                },
+                "retryable": {
+                  "type": "boolean"
+                },
+                "fieldErrors": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "default": {}
+                },
+                "requiredActions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "default": []
+                },
+                "evidenceRefs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "default": []
+                },
+                "context": {
+                  "type": "object",
+                  "additionalProperties": {},
+                  "default": {},
+                  "description": "Typed route-specific recovery context; never a duplicate error message."
+                }
+              },
+              "required": [
+                "code",
+                "message",
+                "retryable"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "state",
+        "createdAt",
+        "startedAt",
+        "finishedAt",
+        "dispatch",
+        "response",
+        "usage",
+        "cost",
+        "problem"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlModelSourcesResponse.schema.json

@@ -0,0 +1,44 @@
+{
+  "$ref": "#/definitions/ControlModelSourcesResponse",
+  "definitions": {
+    "ControlModelSourcesResponse": {
+      "type": "object",
+      "properties": {
+        "sources": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Non-empty identifier string."
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "User-supplied string that must contain visible content, not just whitespace."
+              },
+              "credentialHarness": {
+                "$ref": "#/definitions/ControlModelSourcesResponse/properties/sources/items/properties/id"
+              }
+            },
+            "required": [
+              "id",
+              "label",
+              "credentialHarness"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "sources"
+      ],
+      "additionalProperties": false,
+      "description": "Available raw model transports, distinct from agent harness inventory."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlResource.schema.json

@@ -9,6 +9,11 @@
           "minLength": 1,
           "description": "Non-empty identifier string."
         },
+        "purpose": {
+          "type": "string",
+          "const": "model",
+          "description": "Immutable model-operation purpose; absent means a legacy or ordinary attachment."
+        },
         "kind": {
           "type": "string",
           "enum": [

package/generated/ControlRunAgainDraft.schema.json

@@ -188,6 +188,10 @@
               },
               "description": "Harness-scoped effort map (harness id to effort); an entry here wins over the scalar effort and the per-harness settings default."
             },
+            "review": {
+              "type": "boolean",
+              "description": "Agent model review: ordinary runs default off; true selects an automatic panel. Explicit reviewer controls, best-of and untilClean request review. Capped attempts default to review unless explicitly false."
+            },
             "reviewerModels": {
               "type": "object",
               "additionalProperties": {

package/generated/ControlRunDetail.schema.json

@@ -361,6 +361,10 @@
               "type": "string",
               "description": "Scalar model requested for the run."
             },
+            "review": {
+              "type": "boolean",
+              "description": "Resolved model-review intent; absent on historical runs that retain review-required semantics."
+            },
             "reviewerPanel": {
               "type": "array",
               "items": {
@@ -998,6 +1002,10 @@
                       "description": "Review axis: approved (clean cross-family verified review), blocked (open accepted findings), or not_run.",
                       "default": "not_run"
                     },
+                    "review_requested": {
+                      "type": "boolean",
+                      "description": "Frozen model-review intent. False permits an honestly unreviewed result; absent historical records retain the review requirement."
+                    },
                     "reason": {
                       "anyOf": [
                         {
@@ -2279,10 +2287,11 @@
                   "type": "string",
                   "enum": [
                     "none",
+                    "deterministic_checks",
                     "cross_family_review",
                     "both"
                   ],
-                  "description": "What backed an applyable outcome: none (non-applyable), cross_family_review (a clean cross-family verified review), or both (deterministic gates and that review).",
+                  "description": "Verification evidence: none, deterministic_checks, cross_family_review (clean and verified), or both. An intentionally unreviewed result can be applicable without verification evidence.",
                   "default": "none"
                 },
                 "final_verify": {

package/generated/ControlRunListResponse.schema.json

@@ -363,6 +363,10 @@
                 "type": "string",
                 "description": "Scalar model requested for the run."
               },
+              "review": {
+                "type": "boolean",
+                "description": "Resolved model-review intent; absent on historical runs that retain review-required semantics."
+              },
               "reviewerPanel": {
                 "type": "array",
                 "items": {
@@ -1000,6 +1004,10 @@
                         "description": "Review axis: approved (clean cross-family verified review), blocked (open accepted findings), or not_run.",
                         "default": "not_run"
                       },
+                      "review_requested": {
+                        "type": "boolean",
+                        "description": "Frozen model-review intent. False permits an honestly unreviewed result; absent historical records retain the review requirement."
+                      },
                       "reason": {
                         "anyOf": [
                           {

package/generated/ControlRunStartRequest.schema.json

@@ -180,6 +180,10 @@
           },
           "description": "Harness-scoped effort map (harness id to effort); an entry here wins over the scalar effort and the per-harness settings default."
         },
+        "review": {
+          "type": "boolean",
+          "description": "Agent model review: ordinary runs default off; true selects an automatic panel. Explicit reviewer controls, best-of and untilClean request review. Capped attempts default to review unless explicitly false."
+        },
         "reviewerModels": {
           "type": "object",
           "additionalProperties": {

package/generated/ControlRunSummary.schema.json

@@ -358,6 +358,10 @@
           "type": "string",
           "description": "Scalar model requested for the run."
         },
+        "review": {
+          "type": "boolean",
+          "description": "Resolved model-review intent; absent on historical runs that retain review-required semantics."
+        },
         "reviewerPanel": {
           "type": "array",
           "items": {
@@ -995,6 +999,10 @@
                   "description": "Review axis: approved (clean cross-family verified review), blocked (open accepted findings), or not_run.",
                   "default": "not_run"
                 },
+                "review_requested": {
+                  "type": "boolean",
+                  "description": "Frozen model-review intent. False permits an honestly unreviewed result; absent historical records retain the review requirement."
+                },
                 "reason": {
                   "anyOf": [
                     {

package/generated/ControlThreadDetail.schema.json

@@ -528,6 +528,10 @@
                                 "description": "Review axis: approved (clean cross-family verified review), blocked (open accepted findings), or not_run.",
                                 "default": "not_run"
                               },
+                              "review_requested": {
+                                "type": "boolean",
+                                "description": "Frozen model-review intent. False permits an honestly unreviewed result; absent historical records retain the review requirement."
+                              },
                               "reason": {
                                 "anyOf": [
                                   {

package/generated/ControlThreadTurnRequest.schema.json

@@ -98,6 +98,10 @@
           },
           "description": "Harness-scoped effort map (harness id to effort); an entry here wins over the scalar effort and the per-harness settings default."
         },
+        "review": {
+          "type": "boolean",
+          "description": "Agent model review: ordinary runs default off; true selects an automatic panel. Explicit reviewer controls, best-of and untilClean request review. Capped attempts default to review unless explicitly false."
+        },
         "reviewerModels": {
           "type": "object",
           "additionalProperties": {

package/generated/ControlUploadCreateRequest.schema.json

@@ -4,6 +4,11 @@
     "ControlUploadCreateRequest": {
       "type": "object",
       "properties": {
+        "purpose": {
+          "type": "string",
+          "const": "model",
+          "description": "Model-operation payload, never an Agent attachment; absent preserves attachment semantics."
+        },
         "kind": {
           "type": "string",
           "enum": [