@claudexor/schema 3.19.0 → 3.22.0

package/generated/ControlThreadDetail.schema.json

@@ -20,6 +20,21 @@
               "default": null,
               "description": "Thread title; null until set."
             },
+            "folder": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120,
+                  "description": "User-visible thread folder name."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Optional sidebar folder; null means ungrouped.",
+              "default": null
+            },
             "repoRoot": {
               "type": [
                 "string",
@@ -131,7 +146,7 @@
                 "null"
               ],
               "default": null,
-              "description": "When trash retention expires."
+              "description": "Restore deadline, then auto-purge."
             },
             "runIds": {
               "type": "array",
@@ -582,7 +597,7 @@
                                       "incomplete",
                                       "unverified"
                                     ],
-                                    "description": "Folded work state: the WorkReport state, or unverified when no report was obtainable (transport unsupported / lane gated)."
+                                    "description": "Folded work state: the WorkReport state, or unverified when no valid report was obtained (transport unsupported / lane gated, or an instructed footer missing or broken)."
                                   },
                                   "source": {
                                     "type": "string",
@@ -638,6 +653,19 @@
                                     },
                                     "maxItems": 16,
                                     "description": "Carried through from a needs_input/incomplete WorkReport for honest disclosure."
+                                  },
+                                  "unverified_reason": {
+                                    "type": "string",
+                                    "enum": [
+                                      "footer_missing",
+                                      "footer_not_json",
+                                      "footer_not_object",
+                                      "report_missing",
+                                      "report_malformed",
+                                      "report_contradictory",
+                                      "legacy_output_invalid"
+                                    ],
+                                    "description": "Present only with state unverified on a validated (instructed footer) source: the disclosed cause of the missing report."
                                   }
                                 },
                                 "required": [

package/generated/ControlThreadListResponse.schema.json

@@ -22,6 +22,21 @@
                 "default": null,
                 "description": "Thread title; null until set."
               },
+              "folder": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "User-visible thread folder name."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Optional sidebar folder; null means ungrouped.",
+                "default": null
+              },
               "repoRoot": {
                 "type": [
                   "string",
@@ -133,7 +148,7 @@
                   "null"
                 ],
                 "default": null,
-                "description": "When trash retention expires."
+                "description": "Restore deadline, then auto-purge."
               },
               "runIds": {
                 "type": "array",

package/generated/ControlThreadTurnRequest.schema.json

@@ -320,6 +320,10 @@
           },
           "description": "Typed per-run approvals for changing auto-protected gate/test paths; does not bypass built-in critical/security path human gates."
         },
+        "continueModelInherited": {
+          "type": "boolean",
+          "description": "Internal continuation model provenance; direct POST /runs rejects it."
+        },
         "planRunId": {
           "type": "string",
           "minLength": 1,

package/generated/ControlThreadUpdateRequest.schema.json

@@ -8,6 +8,20 @@
           "type": "string",
           "description": "New thread title."
         },
+        "folder": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120,
+              "description": "User-visible thread folder name."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New sidebar folder; null moves the thread to ungrouped."
+        },
         "state": {
           "type": "string",
           "enum": [
@@ -68,7 +82,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Request body for PATCH /threads/:id: rename, archive, or switch sticky routing."
+      "description": "Request body for PATCH /threads/:id: rename, file into a sidebar folder, archive, or switch sticky routing."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/DecisionRecord.schema.json

@@ -107,7 +107,7 @@
                     "incomplete",
                     "unverified"
                   ],
-                  "description": "Folded work state: the WorkReport state, or unverified when no report was obtainable (transport unsupported / lane gated)."
+                  "description": "Folded work state: the WorkReport state, or unverified when no valid report was obtained (transport unsupported / lane gated, or an instructed footer missing or broken)."
                 },
                 "source": {
                   "type": "string",
@@ -163,6 +163,19 @@
                   },
                   "maxItems": 16,
                   "description": "Carried through from a needs_input/incomplete WorkReport for honest disclosure."
+                },
+                "unverified_reason": {
+                  "type": "string",
+                  "enum": [
+                    "footer_missing",
+                    "footer_not_json",
+                    "footer_not_object",
+                    "report_missing",
+                    "report_malformed",
+                    "report_contradictory",
+                    "legacy_output_invalid"
+                  ],
+                  "description": "Present only with state unverified on a validated (instructed footer) source: the disclosed cause of the missing report."
                 }
               },
               "required": [

package/generated/EnvelopeCustody.schema.json

@@ -0,0 +1,195 @@
+{
+  "$ref": "#/definitions/EnvelopeCustody",
+  "definitions": {
+    "EnvelopeCustody": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "number",
+          "const": 1
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "live",
+            "retained"
+          ]
+        },
+        "holder_run_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Run that holds the envelope."
+        },
+        "holder_run_dir": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Absolute run directory of the holder."
+        },
+        "envelope": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Envelope id."
+            },
+            "task_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Task the envelope belongs to."
+            },
+            "attempt_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Attempt the envelope belongs to."
+            },
+            "repo_root": {
+              "type": "string",
+              "description": "Absolute path of the source repository root."
+            },
+            "base_ref": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "description": "Git base ref; null for directory execution."
+            },
+            "base_sha": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Resolved base commit SHA; null when not recorded."
+            },
+            "worktree_path": {
+              "type": "string",
+              "description": "Absolute actual execution directory, whether Git-backed or plain."
+            },
+            "branch_name": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "description": "Clone-local branch; null for directory execution."
+            },
+            "workspace_kind": {
+              "type": "string",
+              "enum": [
+                "git",
+                "directory"
+              ]
+            },
+            "scope_paths": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "home_dir": {
+              "type": "string",
+              "description": "Scoped HOME directory for the harness process (kept outside the checkout)."
+            },
+            "harness_config_dirs": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              },
+              "default": {},
+              "description": "Scoped per-harness config directories keyed by harness id (kept outside the checkout)."
+            },
+            "policy_profile": {
+              "type": "string",
+              "default": "workspace_write",
+              "description": "Access profile the envelope enforces."
+            },
+            "dirty_policy": {
+              "type": "string",
+              "enum": [
+                "refuse",
+                "snapshot"
+              ],
+              "description": "How a dirty working tree is handled when creating an envelope: snapshot captures the dirty state as the base SHA without touching the live tree; refuse fails loudly.",
+              "default": "refuse"
+            },
+            "created_at": {
+              "type": "string",
+              "minLength": 1,
+              "description": "When the envelope was created."
+            }
+          },
+          "required": [
+            "id",
+            "task_id",
+            "attempt_id",
+            "repo_root",
+            "base_ref",
+            "worktree_path",
+            "branch_name",
+            "home_dir",
+            "created_at"
+          ],
+          "additionalProperties": false,
+          "description": "The envelope exactly as created (adoption reuses it)."
+        },
+        "cause": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "vendor_limit",
+                "pool_exhausted",
+                "pinned_limit",
+                "transport",
+                "context_exhausted",
+                "wall_clock",
+                "cancelled",
+                "host_restart",
+                "input_required",
+                "other"
+              ],
+              "description": "Typed reason the previous process stopped: a vendor limit (next account eligible), the whole pool spent, a pinned account's limit, a transport death (crash, timeout, watchdog), context exhaustion, the wall-clock deadline, a cancel, a daemon/host restart, a model that asked for input, or another typed cause."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Why the holder stopped; null while live."
+        },
+        "retained_at": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "When custody became retained; null while live."
+        },
+        "bytes": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Disk use measured when retained (the kept envelope is not written to); null while live or unmeasured."
+        }
+      },
+      "required": [
+        "version",
+        "state",
+        "holder_run_id",
+        "holder_run_dir",
+        "envelope",
+        "cause",
+        "retained_at",
+        "bytes"
+      ],
+      "additionalProperties": false,
+      "description": "Durable custody record of an isolated envelope (live or retained for continuation)."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/GlobalConfig.schema.json

@@ -106,7 +106,7 @@
                         "minLength": 1,
                         "maxLength": 32,
                         "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
-                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
+                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, places a word the vendor order lacks by the shared preference order (none < minimal < low < medium < high < xhigh < max < ultra) onto an advertised level, and refuses words neither order places."
                       }
                     },
                     "required": [

package/generated/HarnessEvent.schema.json

@@ -5,66 +5,117 @@
       "type": "object",
       "properties": {
         "request_refusal": {
-          "type": "object",
-          "properties": {
-            "scope": {
-              "type": "string",
-              "const": "turn_text",
-              "description": "All text input items in one native turn; separate instructions are excluded."
-            },
-            "unit": {
-              "type": "string",
-              "const": "unicode_scalars"
-            },
-            "limit": {
-              "anyOf": [
-                {
-                  "type": "integer",
-                  "exclusiveMinimum": 0,
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "scope": {
+                  "type": "string",
+                  "const": "turn_text",
+                  "description": "All text input items in one native turn; separate instructions are excluded."
                 },
-                {
-                  "type": "null"
+                "unit": {
+                  "type": "string",
+                  "const": "unicode_scalars"
+                },
+                "limit": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "source": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "kind": {
+                  "type": "string",
+                  "const": "input_too_large"
+                },
+                "actual": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "native_code": {
+                  "type": "string",
+                  "minLength": 1
                 }
-              ]
-            },
-            "source": {
-              "type": "string",
-              "minLength": 1
-            },
-            "kind": {
-              "type": "string",
-              "const": "input_too_large"
+              },
+              "required": [
+                "scope",
+                "unit",
+                "limit",
+                "source",
+                "kind",
+                "actual",
+                "native_code"
+              ],
+              "additionalProperties": false
             },
-            "actual": {
-              "anyOf": [
-                {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "vendor_cli_too_old"
                 },
-                {
-                  "type": "null"
+                "native_code": {
+                  "type": "string",
+                  "const": "claude_code_version_too_old"
+                },
+                "source": {
+                  "type": "string",
+                  "const": "claude_stdout"
+                },
+                "binary_path": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "installed_version": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
                 }
-              ]
-            },
-            "native_code": {
-              "type": "string",
-              "minLength": 1
+              },
+              "required": [
+                "kind",
+                "native_code",
+                "source",
+                "binary_path",
+                "installed_version"
+              ],
+              "additionalProperties": false
             }
-          },
-          "required": [
-            "scope",
-            "unit",
-            "limit",
-            "source",
-            "kind",
-            "actual",
-            "native_code"
           ],
-          "additionalProperties": false,
-          "description": "Vendor-typed physical input refusal; the same input cannot be repaired by changing this harness's account or model."
+          "description": "Vendor-attested request refusal that another account cannot repair; input and executable causes carry their own evidence."
         },
         "effort_resolution": {
           "type": "object",
@@ -550,7 +601,6 @@
             "raw_patch_outside_scope",
             "raw_patch_stale_preimage",
             "raw_patch_binary_unsupported",
-            "raw_patch_sensitive_content",
             "raw_patch_truncated",
             "raw_patch_apply_failed"
           ],
@@ -696,7 +746,9 @@
                 "claude_api_retry",
                 "claude_oauth_usage",
                 "agy_command_usage",
-                "cursor_rate_limit"
+                "cursor_rate_limit",
+                "claude_rate_limit_event",
+                "codex_app_server_event"
               ],
               "description": "Machine-readable source of quota evidence, classified by schema-owned traits."
             },
@@ -739,6 +791,12 @@
                       }
                     ]
                   },
+                  "applies_to_model_prefixes": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/HarnessEvent/properties/credential_profile_id"
+                    }
+                  },
                   "applies_to_unspecified_model": {
                     "type": "boolean"
                   },
@@ -797,7 +855,7 @@
                   "resets_at"
                 ],
                 "additionalProperties": false,
-                "description": "One independent vendor quota window; omitted/null applies_to_models means every model, and null usage stays unknown."
+                "description": "One independent vendor quota window; without model ids or declared prefixes it applies to every model, and null usage stays unknown."
               }
             }
           },

package/generated/HarnessManifest.schema.json

@@ -525,7 +525,7 @@
                 "minLength": 1,
                 "maxLength": 32,
                 "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
-                "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
+                "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, places a word the vendor order lacks by the shared preference order (none < minimal < low < medium < high < xhigh < max < ultra) onto an advertised level, and refuses words neither order places."
               },
               "default": [],
               "description": "Ordered (weakest to strongest) reasoning-effort levels this harness accepts across all its models; empty means effort is not a tunable surface."

package/generated/HarnessStatusDto.schema.json

@@ -543,7 +543,7 @@
                         "minLength": 1,
                         "maxLength": 32,
                         "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
-                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
+                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, places a word the vendor order lacks by the shared preference order (none < minimal < low < medium < high < xhigh < max < ultra) onto an advertised level, and refuses words neither order places."
                       },
                       "default": [],
                       "description": "Ordered (weakest to strongest) reasoning-effort levels this harness accepts across all its models; empty means effort is not a tunable surface."