@claudexor/schema 1.0.1 → 2.1.1

package/generated/GlobalConfig.schema.json

@@ -10,22 +10,6 @@
           "default": 1,
           "description": "Config format version."
         },
-        "default_portfolio": {
-          "type": "string",
-          "enum": [
-            "daily-rich",
-            "balanced",
-            "cheapest",
-            "strongest",
-            "burn",
-            "subscription-first",
-            "api-overflow",
-            "conserve-claude",
-            "conserve-codex"
-          ],
-          "description": "Budget portfolio used when a run does not specify one.",
-          "default": "subscription-first"
-        },
         "interaction_timeout_ms": {
           "type": "integer",
           "exclusiveMinimum": 0,
@@ -79,27 +63,85 @@
               "description": "Preferred auth route: subscription (native/OAuth session), api_key (a stored API key), or auto (engine picks subscription-first with policy fallback). A preference, not a secret.",
               "default": "auto"
             },
-            "quality_priors": {
+            "goal": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "quality",
+                "economy"
+              ],
+              "description": "Routing objective: pace expiring quota, choose the highest declared quality tier, or minimize incremental paid spend.",
+              "default": "auto"
+            },
+            "paid_fallback": {
+              "type": "string",
+              "enum": [
+                "never",
+                "when_unavailable",
+                "allowed_within_cap"
+              ],
+              "description": "When a route with incremental paid spend may be used.",
+              "default": "when_unavailable"
+            },
+            "quality_tiers": {
               "type": "object",
               "additionalProperties": {
-                "type": "number",
-                "minimum": 0,
-                "maximum": 1
+                "type": "array",
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "harness": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Non-empty identifier string."
+                      },
+                      "model": {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      "effort": {
+                        "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."
+                      }
+                    },
+                    "required": [
+                      "harness",
+                      "model",
+                      "effort"
+                    ],
+                    "additionalProperties": false,
+                    "description": "An exact harness, model, and effort route declared by the user."
+                  },
+                  "minItems": 1,
+                  "description": "A group of comparable exact routes at one user-declared quality level."
+                }
               },
               "propertyNames": {
                 "enum": [
-                  "openai",
-                  "anthropic",
-                  "google",
-                  "cursor",
-                  "opencode",
-                  "xai",
-                  "local",
-                  "unknown"
+                  "plan",
+                  "spec",
+                  "implement",
+                  "create_from_scratch",
+                  "repair",
+                  "review",
+                  "verify",
+                  "synthesize",
+                  "explain",
+                  "audit",
+                  "orchestrate"
                 ]
               },
               "default": {},
-              "description": "Operator-tunable per-provider-family quality priors (0..1) feeding the router; unset families ride the neutral 0.5."
+              "description": "Per-intent quality tiers ordered highest to lowest; no provider or benchmark priors are inferred."
             }
           },
           "additionalProperties": false,
@@ -109,18 +151,44 @@
         "budget": {
           "type": "object",
           "properties": {
-            "max_usd_per_run": {
+            "paid_budget_per_run": {
               "anyOf": [
                 {
-                  "type": "number",
-                  "minimum": 0
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "unlimited"
+                    }
+                  },
+                  "required": [
+                    "kind"
+                  ],
+                  "additionalProperties": false
                 },
                 {
-                  "type": "null"
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "finite"
+                    },
+                    "maxUsd": {
+                      "type": "number",
+                      "minimum": 0
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "maxUsd"
+                  ],
+                  "additionalProperties": false
                 }
               ],
-              "default": null,
-              "description": "Global USD cap per run; null = no cap."
+              "description": "Incremental-cash budget: explicitly unlimited or a finite non-negative USD cap.",
+              "default": {
+                "kind": "unlimited"
+              }
             },
             "estimate_usd_floor": {
               "type": "number",
@@ -180,6 +248,109 @@
           "default": {},
           "description": "Global runtime timeouts and retry policy."
         },
+        "retention": {
+          "type": "object",
+          "properties": {
+            "runs_max_age_days": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "default": 30,
+              "description": "Delete terminal, unreferenced run trees older than this many days."
+            },
+            "reviews_max_age_days": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "default": 14,
+              "description": "Delete standalone diff-review trees older than this many days."
+            },
+            "keep_last_runs_per_project": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 20,
+              "description": "The newest N runs per project always survive, regardless of age."
+            }
+          },
+          "additionalProperties": false,
+          "default": {},
+          "description": "Disk retention policy for engine-owned runtime artifacts."
+        },
+        "credential_profiles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "profile_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Stable user-chosen profile identifier (unique per harness)."
+              },
+              "harness_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Harness family this profile belongs to."
+              },
+              "display_name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Human label shown wherever the profile appears."
+              },
+              "credential_kind": {
+                "type": "string",
+                "enum": [
+                  "config_dir_login",
+                  "oauth_token",
+                  "api_key"
+                ],
+                "description": "Credential transport a profile isolates: a scoped vendor config-dir login, a stored OAuth token, or a stored API key."
+              },
+              "isolation_locator": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Canonical absolute config-dir path for config_dir_login profiles; null for secret-ref kinds."
+              },
+              "secret_ref": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Namespaced secret-store name (e.g. claude_oauth:work) for oauth_token/api_key profiles; null for config_dir_login."
+              },
+              "enabled": {
+                "type": "boolean",
+                "default": true,
+                "description": "Disabled profiles are never routable."
+              },
+              "created_at": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "ISO-8601 timestamp string."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "When the profile was registered; null for hand-written config entries.",
+                "default": null
+              }
+            },
+            "required": [
+              "profile_id",
+              "harness_id",
+              "display_name",
+              "credential_kind"
+            ],
+            "additionalProperties": false,
+            "description": "Durable non-secret registry entry for one credential identity of one harness; secret material lives in the vendor dir or the secret store, never here."
+          },
+          "default": [],
+          "description": "Durable non-secret credential-profile registry; secret material lives in the vendor dir or the secret store, never in config."
+        },
         "harnesses": {
           "type": "object",
           "additionalProperties": {
@@ -201,15 +372,7 @@
               "effort": {
                 "anyOf": [
                   {
-                    "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."
+                    "$ref": "#/definitions/GlobalConfig/properties/routing/properties/quality_tiers/additionalProperties/items/items/properties/effort"
                   },
                   {
                     "type": "null"
@@ -244,18 +407,38 @@
                 "default": null,
                 "description": "Default max convergence rounds; null = engine default."
               },
-              "max_usd": {
-                "anyOf": [
-                  {
-                    "type": "number",
-                    "minimum": 0
+              "profile_policy": {
+                "type": "object",
+                "properties": {
+                  "limit_action": {
+                    "type": "string",
+                    "enum": [
+                      "fail",
+                      "ask",
+                      "rotate"
+                    ],
+                    "default": "fail",
+                    "description": "On a typed vendor limit: fail the attempt, surface a typed ask, or rotate to the next eligible profile."
                   },
-                  {
-                    "type": "null"
+                  "rotation_eligible": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "default": [],
+                    "description": "Priority-ordered profile ids eligible for rotation; empty = every enabled profile of this harness in registry order."
+                  },
+                  "headroom_threshold": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1,
+                    "default": 0.9,
+                    "description": "Preflight headroom bound: a selected profile whose active window is at/over this ratio triggers the limit action BEFORE spawn."
                   }
-                ],
-                "default": null,
-                "description": "Per-harness USD cap; null = no cap."
+                },
+                "additionalProperties": false,
+                "default": {},
+                "description": "Typed profile-selection policy for this harness (INV-135)."
               },
               "tools_allow": {
                 "type": "array",
@@ -306,7 +489,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Global user config (~/.claudexor/config.yaml): portfolio, routing, budget, runtime, and per-harness settings."
+      "description": "Claudexor v2 global user config (~/.claudexor/v2/config.yaml): routing, budget, runtime, and per-harness settings."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/HarnessEvent.schema.json

@@ -14,11 +14,13 @@
             "tool_result",
             "interaction_requested",
             "file_change",
+            "patch_produced",
             "usage",
             "error",
+            "status",
             "completed"
           ],
-          "description": "Normalized event type covering session lifecycle, output, tool use, interaction, file changes, usage, and errors."
+          "description": "Normalized event type covering session lifecycle, output, tool use, interaction, file changes, usage, transient status, and errors."
         },
         "session_id": {
           "type": "string",
@@ -33,6 +35,10 @@
           "type": "string",
           "description": "Text content for thinking/message/error events."
         },
+        "final": {
+          "type": "boolean",
+          "description": "True on the harness's typed final-answer message (vendor terminal result); mid-run narration never sets it."
+        },
         "tool": {
           "type": "object",
           "properties": {
@@ -178,6 +184,88 @@
           "additionalProperties": false,
           "description": "Set on interaction_requested events."
         },
+        "patch_envelope": {
+          "type": "object",
+          "properties": {
+            "schema_version": {
+              "type": "number",
+              "const": 1
+            },
+            "context_packet_hash": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Content hash in algo:hex form, e.g. \"sha256:abcd...\"."
+            },
+            "base_tree_sha": {
+              "type": "string",
+              "minLength": 1
+            },
+            "patch": {
+              "type": "string",
+              "minLength": 1
+            },
+            "patch_hash": {
+              "$ref": "#/definitions/HarnessEvent/properties/patch_envelope/properties/context_packet_hash"
+            },
+            "touched_paths": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "expected_blob_oid": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Base-tree blob oid, or null only when the path is absent in the base tree."
+                  }
+                },
+                "required": [
+                  "path",
+                  "expected_blob_oid"
+                ],
+                "additionalProperties": false
+              },
+              "minItems": 1
+            }
+          },
+          "required": [
+            "schema_version",
+            "context_packet_hash",
+            "base_tree_sha",
+            "patch",
+            "patch_hash",
+            "touched_paths"
+          ],
+          "additionalProperties": false,
+          "description": "Typed hash-bound patch produced by a git-patch-envelope harness."
+        },
+        "refusal_code": {
+          "type": "string",
+          "enum": [
+            "raw_patch_requires_isolation",
+            "raw_patch_missing_evidence",
+            "raw_patch_digest_mismatch",
+            "raw_patch_base_mismatch",
+            "raw_patch_path_traversal",
+            "raw_patch_outside_scope",
+            "raw_patch_stale_preimage",
+            "raw_patch_binary_unsupported",
+            "raw_patch_sensitive_content",
+            "raw_patch_truncated",
+            "raw_patch_apply_failed"
+          ],
+          "description": "Typed refusal code for a rejected raw patch contract."
+        },
         "usage": {
           "type": "object",
           "properties": {
@@ -213,29 +301,137 @@
           "type": "string",
           "description": "Model the harness actually reported using."
         },
+        "credential_route": {
+          "type": "string",
+          "enum": [
+            "vendor_native",
+            "managed_api_key",
+            "local"
+          ],
+          "description": "Concrete credential route selected before spawn; first-class route evidence, never inferred from free-form payload text."
+        },
+        "credential_source": {
+          "type": "string",
+          "enum": [
+            "native_session",
+            "oauth_token_env",
+            "api_key_env",
+            "api_key_flag",
+            "provider_auth_file",
+            "none"
+          ],
+          "description": "Concrete credential source selected before spawn; exact native subscription requires native_session, never an OAuth token or API key."
+        },
+        "credential_profile_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Credential profile the attempt runs under; absent = engine-default credentials (INV-135 attribution)."
+        },
         "quota": {
           "type": "object",
           "properties": {
-            "used_percent": {
-              "type": "number",
-              "minimum": 0,
-              "maximum": 100,
-              "description": "Consumed share of the binding rate window, 0-100."
+            "source": {
+              "type": "string",
+              "enum": [
+                "codex_app_server",
+                "codex_rollout",
+                "claude_statusline",
+                "claude_api_retry",
+                "claude_oauth_usage"
+              ],
+              "description": "Vendor-owned machine-readable source of a quota snapshot."
             },
-            "resets_at": {
+            "plan_label": {
               "type": [
                 "string",
                 "null"
               ],
-              "default": null,
-              "description": "Native reset moment for the window, when the CLI reports one."
+              "default": null
+            },
+            "subject_id": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null
+            },
+            "constraints": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "$ref": "#/definitions/HarnessEvent/properties/credential_profile_id"
+                  },
+                  "label": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "used_ratio": {
+                    "anyOf": [
+                      {
+                        "type": "number",
+                        "minimum": 0,
+                        "maximum": 1
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "window_seconds": {
+                    "anyOf": [
+                      {
+                        "type": "number",
+                        "exclusiveMinimum": 0
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "resets_at": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "format": "date-time"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "cooldown_until": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "format": "date-time"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "default": null
+                  }
+                },
+                "required": [
+                  "id",
+                  "label",
+                  "used_ratio",
+                  "window_seconds",
+                  "resets_at"
+                ],
+                "additionalProperties": false,
+                "description": "One independent vendor quota window; null usage stays unknown."
+              }
             }
           },
           "required": [
-            "used_percent"
+            "source",
+            "constraints"
           ],
           "additionalProperties": false,
-          "description": "Typed quota/usage-window signal from the harness CLI's own native machine-readable surface, never scraped from prose."
+          "description": "All quota windows from a vendor-owned machine-readable source; never scraped from prose or collapsed into a fake aggregate."
         },
         "plan_progress": {
           "type": "object",
@@ -305,6 +501,54 @@
           "additionalProperties": false,
           "description": "Typed rate-limit/quota signal set by the adapter when the native CLI reports a 429/quota/overload."
         },
+        "status": {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "api_retry"
+              ],
+              "description": "Kind of transient status."
+            },
+            "attempt": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Retry attempt number."
+            },
+            "max_retries": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Vendor's configured retry ceiling."
+            },
+            "retry_delay_ms": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Delay before the retry, when reported."
+            },
+            "error_category": {
+              "type": "string",
+              "enum": [
+                "authentication_failed",
+                "oauth_org_not_allowed",
+                "billing_error",
+                "rate_limit",
+                "overloaded",
+                "invalid_request",
+                "model_not_found",
+                "server_error",
+                "max_output_tokens",
+                "unknown"
+              ],
+              "description": "Vendor's error category mapped onto the documented enum; unrecognized values collapse to 'unknown' (never free-form prose)."
+            }
+          },
+          "required": [
+            "kind"
+          ],
+          "additionalProperties": false,
+          "description": "Typed transient-status detail set by the adapter on status events."
+        },
         "transient": {
           "type": "object",
           "properties": {
@@ -341,6 +585,10 @@
           "type": "string",
           "description": "Error text for error events."
         },
+        "aborted": {
+          "type": "boolean",
+          "description": "Typed terminal cancellation marker, set on completed events when the run was aborted."
+        },
         "payload": {
           "type": "object",
           "additionalProperties": {},