@claudexor/schema 1.0.1 → 2.0.0

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",
@@ -201,15 +269,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,19 +304,6 @@
                 "default": null,
                 "description": "Default max convergence rounds; null = engine default."
               },
-              "max_usd": {
-                "anyOf": [
-                  {
-                    "type": "number",
-                    "minimum": 0
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "default": null,
-                "description": "Per-harness USD cap; null = no cap."
-              },
               "tools_allow": {
                 "type": "array",
                 "items": {
@@ -306,7 +353,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,6 +14,7 @@
             "tool_result",
             "interaction_requested",
             "file_change",
+            "patch_produced",
             "usage",
             "error",
             "completed"
@@ -178,6 +179,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 +296,133 @@
           "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."
+        },
         "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"
+              ],
+              "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": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Non-empty identifier string."
+                  },
+                  "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",
@@ -341,6 +528,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": {},

package/generated/HarnessManifest.schema.json

@@ -57,12 +57,13 @@
                     "type": "string",
                     "enum": [
                       "native_session",
+                      "oauth_token_env",
                       "api_key_env",
                       "api_key_flag",
                       "provider_auth_file",
                       "none"
                     ],
-                    "description": "Where a harness's credentials can come from: a native login session, an API key via env var or CLI flag, a provider auth file, or none."
+                    "description": "Concrete credential source used or probed by a harness."
                   },
                   "default": [],
                   "description": "Auth sources this harness supports."
@@ -175,21 +176,62 @@
               "default": {},
               "description": "Declared isolation containment facts for a harness."
             },
-            "image_input": {
-              "type": "string",
-              "enum": [
-                "file_path",
-                "base64_stream",
-                "base64_inline",
-                "none"
-              ],
-              "description": "How a harness accepts image input: file_path (CLI file argument), base64_stream (base64 image block on the stream), base64_inline (data-URL in the request), or none (no vision input on this route).",
-              "default": "none"
+            "attachment_inputs": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "image",
+                      "file"
+                    ],
+                    "description": "Kind of attached resource: image input or generic file bytes."
+                  },
+                  "mime_types": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "minItems": 1
+                  },
+                  "max_bytes": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0
+                  },
+                  "max_count": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0
+                  },
+                  "transport": {
+                    "type": "string",
+                    "enum": [
+                      "file_path",
+                      "base64_stream",
+                      "base64_inline",
+                      "text_inline"
+                    ],
+                    "description": "Native adapter transport used for one supported attachment class."
+                  }
+                },
+                "required": [
+                  "kind",
+                  "mime_types",
+                  "max_bytes",
+                  "max_count",
+                  "transport"
+                ],
+                "additionalProperties": false,
+                "description": "Finite MIME, size, count and transport limits declared by one adapter."
+              },
+              "default": []
             }
           },
           "additionalProperties": false,
           "default": {},
-          "description": "Structured per-harness facts the engine consumes: auth routing, isolation containment, readonly mechanism, and vision input."
+          "description": "Structured per-harness facts the engine consumes: auth routing, isolation containment, readonly mechanism, and finite attachment inputs."
         },
         "capabilities": {
           "type": "object",
@@ -204,6 +246,15 @@
               "default": false,
               "description": "The harness can implement code changes (implement intent)."
             },
+            "implementation_transport": {
+              "type": "string",
+              "enum": [
+                "workspace",
+                "git_patch_envelope"
+              ],
+              "description": "Typed producer/consumer transport used when implement=true.",
+              "default": "workspace"
+            },
             "create_from_scratch": {
               "type": "boolean",
               "default": false,