@claudexor/schema 3.1.0 → 3.1.2

package/generated/RunTelemetry.schema.json

@@ -260,7 +260,8 @@
                       "type": "string",
                       "enum": [
                         "browser",
-                        "path_deny"
+                        "path_deny",
+                        "delegation"
                       ]
                     },
                     "harness_id": {
@@ -284,6 +285,7 @@
                         "manifest_unsupported",
                         "web_policy_off",
                         "access_profile_incompatible",
+                        "runtime_unavailable",
                         "postdiff_only"
                       ]
                     },
@@ -383,7 +385,7 @@
                     "recovered": {
                       "type": "boolean",
                       "default": false,
-                      "description": "True when a later successful result of the same tool exists in the same attempt."
+                      "description": "True when a later successful result matches this failed invocation."
                     },
                     "tool_use_id": {
                       "type": [
@@ -780,6 +782,61 @@
           "default": [],
           "description": "All selected-lane capability receipts for this run."
         },
+        "delegation": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "requested": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "effective": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "used": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "reason": {
+                  "type": "string",
+                  "enum": [
+                    "pending",
+                    "not_requested",
+                    "injected_unused",
+                    "used",
+                    "runtime_unavailable",
+                    "manifest_unsupported",
+                    "access_profile_incompatible",
+                    "partially_degraded",
+                    "startup_failed"
+                  ],
+                  "default": "not_requested"
+                },
+                "remediation": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                }
+              },
+              "additionalProperties": false,
+              "description": "Engine-owned Delegate requested/effective/used receipt; surfaces project it without parsing model output."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Run-level Delegate receipt aggregated from engine injection and typed tool evidence; null on legacy artifacts that did not record it.",
+          "default": null
+        },
         "tool_warnings_total": {
           "type": "integer",
           "minimum": 0,
@@ -948,6 +1005,8 @@
                     "quality_tier",
                     "expiring_quota_slack",
                     "all_incremental_cash_unknown",
+                    "delegate_effective_first",
+                    "explicit_primary",
                     "declared_order"
                   ],
                   "description": "Typed decisive reason the pool ranked the way it did (QA-034)."

package/generated/TaskContract.schema.json

@@ -70,6 +70,48 @@
           "additionalProperties": false,
           "description": "Canonical run mode for this task."
         },
+        "delegation_requested": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether the caller requested the Delegate agent strategy."
+        },
+        "run_lineage": {
+          "type": "object",
+          "properties": {
+            "parent_run_id": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Non-empty identifier string."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string.",
+              "default": null
+            },
+            "delegated_from_run_id": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TaskContract/properties/run_lineage/properties/parent_run_id/anyOf/0"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string.",
+              "default": null
+            }
+          },
+          "additionalProperties": false,
+          "default": {
+            "parent_run_id": null,
+            "delegated_from_run_id": null
+          },
+          "description": "Server-owned run lineage; delegated_from_run_id is present only for a Claudexor belt child."
+        },
         "user_intent": {
           "type": "object",
           "properties": {
@@ -118,9 +160,7 @@
         "credential_profile_id": {
           "anyOf": [
             {
-              "type": "string",
-              "minLength": 1,
-              "description": "Non-empty identifier string."
+              "$ref": "#/definitions/TaskContract/properties/run_lineage/properties/parent_run_id/anyOf/0"
             },
             {
               "type": "null"
@@ -151,7 +191,7 @@
                 "type": "string"
               },
               "default": [],
-              "description": "Approval globs — path globs (e.g. `migrations/**`, `**/*.env`) whose changes escalate a run to a human-approval gate before it can be applied. Spec/config-owned and never suppressed by per-run protected-path approvals."
+              "description": "Approval globs — path globs (e.g. `migrations/**`, `**/*.env`) whose matching create, modify, delete, or rename changes escalate a run to a human-approval gate before it can be applied. Project-config-owned and never suppressed by per-run protected-path approvals."
             },
             "deny_paths": {
               "type": "array",
@@ -512,14 +552,10 @@
           "type": "object",
           "additionalProperties": {
             "type": "string",
-            "enum": [
-              "low",
-              "medium",
-              "high",
-              "xhigh",
-              "max"
-            ],
-            "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+            "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."
           },
           "default": {},
           "description": "Resolved harness-scoped reasoning-effort map for this run (harness id to effort), frozen so an Exact Retry replays the same effort instead of re-resolving current settings."

package/generated/WorkspaceEnvelope.schema.json

@@ -25,7 +25,7 @@
         },
         "base_ref": {
           "type": "string",
-          "description": "Git ref the worktree was created from."
+          "description": "Git ref the checkout was created from."
         },
         "base_sha": {
           "type": [
@@ -37,15 +37,15 @@
         },
         "worktree_path": {
           "type": "string",
-          "description": "Absolute path of the isolated git worktree."
+          "description": "Absolute path of the isolated Git checkout."
         },
         "branch_name": {
           "type": "string",
-          "description": "Branch created for the worktree."
+          "description": "Clone-local branch created for the checkout."
         },
         "home_dir": {
           "type": "string",
-          "description": "Scoped HOME directory for the harness process (kept outside the worktree)."
+          "description": "Scoped HOME directory for the harness process (kept outside the checkout)."
         },
         "harness_config_dirs": {
           "type": "object",
@@ -53,7 +53,7 @@
             "type": "string"
           },
           "default": {},
-          "description": "Scoped per-harness config directories keyed by harness id (kept outside the worktree)."
+          "description": "Scoped per-harness config directories keyed by harness id (kept outside the checkout)."
         },
         "policy_profile": {
           "type": "string",
@@ -87,7 +87,7 @@
         "created_at"
       ],
       "additionalProperties": false,
-      "description": "An isolated execution envelope: a git worktree for files plus scoped env/HOME/harness-config isolation."
+      "description": "An isolated execution envelope: a private Git checkout plus scoped env/HOME/harness-config isolation."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "license": "MIT",
   "description": "Single source of truth for all Claudexor data shapes (Zod + generated JSON Schema).",
   "type": "module",
@@ -20,7 +20,7 @@
   "dependencies": {
     "zod": "^3.24.1",
     "zod-to-json-schema": "^3.24.1",
-    "@claudexor/util": "3.1.0"
+    "@claudexor/util": "3.1.2"
   },
   "repository": {
     "type": "git",