@claudexor/schema 1.0.1 → 2.1.1

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,
@@ -289,10 +340,41 @@
             "known_models": {
               "type": "array",
               "items": {
-                "type": "string"
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Model id/alias."
+                      },
+                      "routes": {
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "enum": [
+                            "local_session",
+                            "api_key"
+                          ]
+                        },
+                        "minItems": 1,
+                        "description": "Credential routes this model is available on."
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "routes"
+                    ],
+                    "additionalProperties": false
+                  }
+                ]
               },
               "default": [],
-              "description": "Manifest-declared model ids/aliases this harness accepts, used as the model truth source when the adapter has no live inventory; explicit models outside the truth source are refused."
+              "description": "Manifest-declared model ids/aliases this harness accepts (bare string = every credential route; object form scopes a model to specific routes), used as the model truth source when the adapter has no live inventory; explicit models outside the truth source are refused."
             },
             "known_models_verified_against": {
               "type": [

package/generated/HarnessModel.schema.json

@@ -28,6 +28,25 @@
           ],
           "default": null,
           "description": "Context window in tokens; null when the enumeration source does not report it."
+        },
+        "routes": {
+          "anyOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "local_session",
+                  "api_key"
+                ]
+              }
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Credential routes the model is scoped to; null = every route."
         }
       },
       "required": [

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,
@@ -307,10 +358,41 @@
                     "known_models": {
                       "type": "array",
                       "items": {
-                        "type": "string"
+                        "anyOf": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "type": "object",
+                            "properties": {
+                              "id": {
+                                "type": "string",
+                                "minLength": 1,
+                                "description": "Model id/alias."
+                              },
+                              "routes": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string",
+                                  "enum": [
+                                    "local_session",
+                                    "api_key"
+                                  ]
+                                },
+                                "minItems": 1,
+                                "description": "Credential routes this model is available on."
+                              }
+                            },
+                            "required": [
+                              "id",
+                              "routes"
+                            ],
+                            "additionalProperties": false
+                          }
+                        ]
                       },
                       "default": [],
-                      "description": "Manifest-declared model ids/aliases this harness accepts, used as the model truth source when the adapter has no live inventory; explicit models outside the truth source are refused."
+                      "description": "Manifest-declared model ids/aliases this harness accepts (bare string = every credential route; object form scopes a model to specific routes), used as the model truth source when the adapter has no live inventory; explicit models outside the truth source are refused."
                     },
                     "known_models_verified_against": {
                       "type": [
@@ -377,6 +459,14 @@
           "default": [],
           "description": "Intents the gateway will route to this harness."
         },
+        "routableIntents": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Intents the harness is actually routable for right now (doctor-gated); the server-side availability truth surfaces must read instead of re-deriving."
+        },
         "disabledIntents": {
           "type": "array",
           "items": {
@@ -431,6 +521,100 @@
           "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."
+        },
+        "readiness": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Stable machine id of the check (adapter probe id or auth source)."
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "binary",
+                  "auth",
+                  "smoke",
+                  "model",
+                  "probe"
+                ],
+                "description": "What KIND of readiness this is: binary presence, credential source, isolated smoke, configured-model validity, or a generic capability probe."
+              },
+              "title": {
+                "type": "string",
+                "description": "Human display name of the check."
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "pass",
+                  "fail",
+                  "skip"
+                ],
+                "description": "Outcome; skip = not run / not applicable."
+              },
+              "detail": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Redacted human-readable evidence for the outcome."
+              }
+            },
+            "required": [
+              "id",
+              "kind",
+              "title",
+              "status"
+            ],
+            "additionalProperties": false,
+            "description": "One display-ready readiness check row (daemon-normalized)."
+          },
+          "default": [],
+          "description": "Display-ready readiness checks, daemon-normalized from the raw evidence."
+        },
         "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#"
+}