@claudexor/schema 1.0.1 → 2.0.0

package/generated/HarnessStatusDto.schema.json

@@ -75,12 +75,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."
@@ -193,21 +194,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",
@@ -222,6 +264,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,
@@ -431,6 +482,46 @@
           "default": [],
           "description": "Human-readable reasons for degraded/unavailable status."
         },
+        "authSources": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "source": {
+                "$ref": "#/definitions/HarnessStatusDto/properties/manifest/anyOf/0/properties/capability_profile/properties/auth/properties/supported_sources/items"
+              },
+              "availability": {
+                "type": "string",
+                "enum": [
+                  "available",
+                  "unavailable",
+                  "unknown"
+                ]
+              },
+              "verification": {
+                "type": "string",
+                "enum": [
+                  "passed",
+                  "failed",
+                  "not_run"
+                ]
+              },
+              "detail": {
+                "type": "string",
+                "description": "Redacted human-readable source evidence."
+              }
+            },
+            "required": [
+              "source",
+              "availability",
+              "verification"
+            ],
+            "additionalProperties": false,
+            "description": "Doctor-backed readiness for one exact credential source."
+          },
+          "default": [],
+          "description": "Doctor-backed readiness by authentication source; an empty array means readiness was not reported."
+        },
         "configuredModel": {
           "type": [
             "string",

package/generated/OrchestrateContract.schema.json

@@ -39,18 +39,44 @@
         "budget": {
           "type": "object",
           "properties": {
-            "max_usd": {
+            "paid_budget": {
               "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": "USD cap for the whole orchestration; null = no cap."
+              "description": "Incremental-cash budget: explicitly unlimited or a finite non-negative USD cap.",
+              "default": {
+                "kind": "unlimited"
+              }
             },
             "max_tool_calls": {
               "anyOf": [

package/generated/OrchestratePlan.schema.json

@@ -11,6 +11,11 @@
               {
                 "type": "object",
                 "properties": {
+                  "required": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "Whether parent success requires this step to succeed."
+                  },
                   "tool": {
                     "type": "string",
                     "const": "start_run"
@@ -52,6 +57,9 @@
               {
                 "type": "object",
                 "properties": {
+                  "required": {
+                    "$ref": "#/definitions/OrchestratePlan/properties/tool_calls/items/anyOf/0/properties/required"
+                  },
                   "tool": {
                     "type": "string",
                     "const": "race"
@@ -83,6 +91,9 @@
               {
                 "type": "object",
                 "properties": {
+                  "required": {
+                    "$ref": "#/definitions/OrchestratePlan/properties/tool_calls/items/anyOf/0/properties/required"
+                  },
                   "tool": {
                     "type": "string",
                     "const": "review"
@@ -108,6 +119,9 @@
               {
                 "type": "object",
                 "properties": {
+                  "required": {
+                    "$ref": "#/definitions/OrchestratePlan/properties/tool_calls/items/anyOf/0/properties/required"
+                  },
                   "tool": {
                     "type": "string",
                     "const": "status"
@@ -133,6 +147,9 @@
               {
                 "type": "object",
                 "properties": {
+                  "required": {
+                    "$ref": "#/definitions/OrchestratePlan/properties/tool_calls/items/anyOf/0/properties/required"
+                  },
                   "tool": {
                     "type": "string",
                     "const": "answer_question"
@@ -193,6 +210,9 @@
               {
                 "type": "object",
                 "properties": {
+                  "required": {
+                    "$ref": "#/definitions/OrchestratePlan/properties/tool_calls/items/anyOf/0/properties/required"
+                  },
                   "tool": {
                     "type": "string",
                     "const": "apply"

package/generated/OrchestratePlanProgress.schema.json

@@ -46,6 +46,67 @@
                 ],
                 "description": "Executor status of one plan step: pending, running, done, skipped, blocked (risky step awaiting a human), or failed."
               },
+              "required": {
+                "type": "boolean",
+                "default": true
+              },
+              "terminal_status": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "enum": [
+                      "success",
+                      "no_op",
+                      "ungated",
+                      "review_not_run",
+                      "blocked",
+                      "failed",
+                      "interrupted_unknown",
+                      "cost_unverifiable",
+                      "exhausted_overshoot",
+                      "exhausted",
+                      "not_converged",
+                      "stuck_no_progress",
+                      "cancelled"
+                    ],
+                    "description": "Terminal status of a run, including truthful blocked, interrupted-unknown, cost-unverifiable, overshoot, exhaustion, non-convergence, failure, and cancellation outcomes."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Actual child/delivery terminal used by the parent outcome reducer.",
+                "default": null
+              },
+              "terminal_source": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "enum": [
+                      "executor",
+                      "subrun",
+                      "review",
+                      "delivery",
+                      "policy",
+                      "budget"
+                    ]
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Authority that produced terminal_status."
+              },
+              "evidence_refs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "default": [],
+                "description": "Immutable run artifact or delivery receipt references."
+              },
               "run_id": {
                 "type": [
                   "string",

package/generated/PaidBudget.schema.json

@@ -0,0 +1,42 @@
+{
+  "$ref": "#/definitions/PaidBudget",
+  "definitions": {
+    "PaidBudget": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "unlimited"
+            }
+          },
+          "required": [
+            "kind"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "finite"
+            },
+            "maxUsd": {
+              "type": "number",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "kind",
+            "maxUsd"
+          ],
+          "additionalProperties": false
+        }
+      ],
+      "description": "Incremental-cash budget: explicitly unlimited or a finite non-negative USD cap."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/Project.schema.json

@@ -0,0 +1,45 @@
+{
+  "$ref": "#/definitions/Project",
+  "definitions": {
+    "Project": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 2,
+          "description": "Schema version of the artifact; bumped on breaking ABI changes."
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Stable Claudexor project id."
+        },
+        "root": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Canonical absolute project root."
+        },
+        "created_at": {
+          "type": "string",
+          "minLength": 1,
+          "description": "When the project was first registered."
+        },
+        "updated_at": {
+          "type": "string",
+          "minLength": 1,
+          "description": "When the project link was last updated."
+        }
+      },
+      "required": [
+        "schema_version",
+        "id",
+        "root",
+        "created_at",
+        "updated_at"
+      ],
+      "additionalProperties": false,
+      "description": "A durable v2 project registration; v1 state is never imported implicitly."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ProjectConfig.schema.json

@@ -48,10 +48,46 @@
             "commands": {
               "type": "array",
               "items": {
-                "type": "string"
+                "type": "object",
+                "properties": {
+                  "program": {
+                    "type": "string",
+                    "minLength": 1,
+                    "pattern": "\\S",
+                    "description": "Executable invoked directly without an implicit shell."
+                  },
+                  "args": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "default": [],
+                    "description": "Exact argv passed to the executable."
+                  },
+                  "cwd": {
+                    "type": "string",
+                    "description": "Optional project-relative working directory for the command."
+                  },
+                  "envAllowlist": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1,
+                      "pattern": "\\S",
+                      "description": "User-supplied string that must contain visible content, not just whitespace."
+                    },
+                    "default": [],
+                    "description": "Non-secret parent environment names explicitly forwarded to the command."
+                  }
+                },
+                "required": [
+                  "program"
+                ],
+                "additionalProperties": false,
+                "description": "Canonical deterministic command invocation; no implicit shell parsing."
               },
               "default": [],
-              "description": "Test commands run as deterministic gates."
+              "description": "Typed-argv test commands run as deterministic gates."
             }
           },
           "additionalProperties": false,
@@ -63,28 +99,19 @@
         "budget": {
           "type": "object",
           "properties": {
-            "portfolio": {
+            "routing_goal": {
               "type": "string",
               "enum": [
-                "daily-rich",
-                "balanced",
-                "cheapest",
-                "strongest",
-                "burn",
-                "subscription-first",
-                "api-overflow",
-                "conserve-claude",
-                "conserve-codex"
+                "auto",
+                "quality",
+                "economy"
               ],
-              "description": "Budget portfolio weighting the harness router's quality/cost/latency and subscription-vs-API preferences (e.g. cheapest minimizes spend, burn maximizes quality, conserve-* deprioritizes one vendor).",
-              "default": "subscription-first"
+              "description": "Routing objective: pace expiring quota, choose the highest declared quality tier, or minimize incremental paid spend."
             }
           },
           "additionalProperties": false,
-          "default": {
-            "portfolio": "subscription-first"
-          },
-          "description": "Project budget preferences."
+          "default": {},
+          "description": "Safe project routing preference; paid fallback remains user-global."
         }
       },
       "additionalProperties": false,