@claudexor/schema 1.0.1 → 2.0.0

package/dist/workspace.d.ts

@@ -28,8 +28,8 @@ export declare const WorkspaceEnvelope: z.ZodObject<{
     base_ref: string;
     task_id: string;
     attempt_id: string;
-    repo_root: string;
     dirty_policy: "refuse" | "snapshot";
+    repo_root: string;
     branch_name: string;
     home_dir: string;
     harness_config_dirs: Record<string, string>;

package/dist/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBwF,CAAC;AACvH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC3B,CAAC;AACJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/workspace.js

@@ -14,15 +14,24 @@ export const WorkspaceEnvelope = z
     attempt_id: Id.describe("Attempt the envelope belongs to."),
     repo_root: z.string().describe("Absolute path of the source repository root."),
     base_ref: z.string().describe("Git ref the worktree was created from."),
-    base_sha: z.string().nullable().default(null).describe("Resolved base commit SHA; null when not recorded."),
+    base_sha: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Resolved base commit SHA; null when not recorded."),
     worktree_path: z.string().describe("Absolute path of the isolated git worktree."),
     branch_name: z.string().describe("Branch created for the worktree."),
-    home_dir: z.string().describe("Scoped HOME directory for the harness process (kept outside the worktree)."),
+    home_dir: z
+        .string()
+        .describe("Scoped HOME directory for the harness process (kept outside the worktree)."),
     harness_config_dirs: z
         .record(z.string(), z.string())
         .default({})
         .describe("Scoped per-harness config directories keyed by harness id (kept outside the worktree)."),
-    policy_profile: z.string().default("workspace_write").describe("Access profile the envelope enforces."),
+    policy_profile: z
+        .string()
+        .default("workspace_write")
+        .describe("Access profile the envelope enforces."),
     dirty_policy: DirtyPolicy.default("refuse"),
     created_at: IsoTimestamp.describe("When the envelope was created."),
 })

package/dist/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC/B,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACrD,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC9E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC3G,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;IAC3G,mBAAmB,EAAE,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,wFAAwF,CAAC;IACrG,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACvG,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC3C,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACpE,CAAC;KACD,QAAQ,CAAC,yGAAyG,CAAC,CAAC"}
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC/B,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACrD,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC9E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACvE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,mDAAmD,CAAC;IAChE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACpE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,4EAA4E,CAAC;IACzF,mBAAmB,EAAE,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACP,wFAAwF,CACzF;IACH,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,OAAO,CAAC,iBAAiB,CAAC;SAC1B,QAAQ,CAAC,uCAAuC,CAAC;IACpD,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC3C,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACpE,CAAC;KACD,QAAQ,CACP,yGAAyG,CAC1G,CAAC"}

package/generated/AgentCapabilityCatalog.schema.json

@@ -135,15 +135,57 @@
                 ],
                 "description": "How external web/search is controlled for this harness."
               },
-              "imageInput": {
-                "type": "string",
-                "enum": [
-                  "file_path",
-                  "base64_stream",
-                  "base64_inline",
-                  "none"
-                ],
-                "description": "Attachment/vision delivery mechanism the adapter supports."
+              "attachmentInputs": {
+                "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."
+                },
+                "description": "Finite media/MIME/size/count/transport declarations for this adapter."
               },
               "effortLevels": {
                 "type": "array",
@@ -199,7 +241,7 @@
               "configuredModelValid",
               "models",
               "webPolicy",
-              "imageInput",
+              "attachmentInputs",
               "effortLevels",
               "accessProfilesSupported",
               "readonlyMechanism"
@@ -264,7 +306,7 @@
                   "live"
                 ]
               },
-              "description": "Run isolation: envelope = isolated worktree under .claudexor/workspaces (default), live = the project tree itself."
+              "description": "Run isolation: envelope = isolated worktree in the external per-project runtime namespace (default), live = the project tree itself."
             },
             "workspaceModes": {
               "type": "array",

package/generated/BudgetLease.schema.json

@@ -49,13 +49,61 @@
           "default": null,
           "description": "Requested model for the reserved call; null = harness default."
         },
-        "max_usd": {
-          "type": [
-            "number",
-            "null"
+        "cost": {
+          "type": "object",
+          "properties": {
+            "knowledge": {
+              "type": "string",
+              "enum": [
+                "exact",
+                "estimated",
+                "unknown"
+              ],
+              "description": "Quality of incremental-cash cost evidence for an operation."
+            },
+            "billing": {
+              "type": "string",
+              "enum": [
+                "proven_zero",
+                "subscription_entitlement",
+                "metered",
+                "unknown"
+              ],
+              "description": "What is actually known about incremental billing; a native credential route alone never proves entitlement or zero cost."
+            },
+            "source": {
+              "type": "string",
+              "minLength": 1
+            },
+            "provenance": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1
+            },
+            "estimatedUsd": {
+              "anyOf": [
+                {
+                  "type": "number",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            }
+          },
+          "required": [
+            "knowledge",
+            "billing",
+            "source",
+            "provenance"
           ],
-          "default": null,
-          "description": "USD cap reserved for the call; null = no cap."
+          "additionalProperties": false,
+          "description": "Incremental-cash cost knowledge with its source and evidence provenance."
         },
         "reason": {
           "type": "array",
@@ -85,6 +133,7 @@
         "task_id",
         "intent",
         "harness_id",
+        "cost",
         "created_at"
       ],
       "additionalProperties": false,

package/generated/BudgetObservation.schema.json

@@ -29,19 +29,40 @@
           "enum": [
             "spend",
             "rate_limited",
-            "used_percent",
-            "cooldown",
-            "manual"
+            "quota_constraint",
+            "cooldown"
           ],
-          "description": "What was observed: spend, a rate-limit hit, a used-percent reading, a cooldown, or a manual entry."
+          "description": "What was observed: spend, a rate-limit hit, one independent quota constraint, or a cooldown."
         },
         "usd": {
           "type": "number",
           "description": "Observed spend in USD, for spend observations."
         },
-        "used_percent": {
-          "type": "number",
-          "description": "Consumed share of the rate window (0-100), for used_percent observations."
+        "constraint_id": {
+          "type": "string"
+        },
+        "used_ratio": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "window_seconds": {
+          "anyOf": [
+            {
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
         },
         "resets_at": {
           "type": [

package/generated/ConformanceReport.schema.json

@@ -93,6 +93,55 @@
           },
           "default": [],
           "description": "Human-readable reasons for degraded/unavailable status or disabled intents."
+        },
+        "auth_sources": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "source": {
+                "type": "string",
+                "enum": [
+                  "native_session",
+                  "oauth_token_env",
+                  "api_key_env",
+                  "api_key_flag",
+                  "provider_auth_file",
+                  "none"
+                ],
+                "description": "Concrete credential source used or probed by a harness."
+              },
+              "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 the adapter did not report source readiness."
         }
       },
       "required": [

package/generated/ControlApplyCheckResponse.schema.json

@@ -0,0 +1,34 @@
+{
+  "$ref": "#/definitions/ControlApplyCheckResponse",
+  "definitions": {
+    "ControlApplyCheckResponse": {
+      "type": "object",
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "code": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "stderr": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "ok",
+        "code",
+        "stderr"
+      ],
+      "additionalProperties": false,
+      "description": "Mechanical git apply --check result."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlArtifactListResponse.schema.json

@@ -0,0 +1,57 @@
+{
+  "$ref": "#/definitions/ControlArtifactListResponse",
+  "definitions": {
+    "ControlArtifactListResponse": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "artifacts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "Artifact path relative to the run directory."
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "file",
+                  "directory"
+                ],
+                "description": "Whether the artifact is a file or a directory."
+              },
+              "bytes": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Size in bytes; absent for directories."
+              },
+              "mime": {
+                "type": "string",
+                "description": "MIME type derived from the extension; absent for directories."
+              }
+            },
+            "required": [
+              "path",
+              "kind"
+            ],
+            "additionalProperties": false,
+            "description": "One artifact in the run's artifact tree."
+          },
+          "default": []
+        }
+      },
+      "required": [
+        "runId"
+      ],
+      "additionalProperties": false,
+      "description": "Run-keyed technical artifact or produced-output listing."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlAuthReadinessRefreshRequest.schema.json

@@ -0,0 +1,38 @@
+{
+  "$ref": "#/definitions/ControlAuthReadinessRefreshRequest",
+  "definitions": {
+    "ControlAuthReadinessRefreshRequest": {
+      "type": "object",
+      "properties": {
+        "authRequest": {
+          "type": "string",
+          "enum": [
+            "subscription",
+            "api_key",
+            "auto"
+          ],
+          "description": "Requested credential behavior: exact subscription, exact managed API key, or policy-governed auto selection."
+        },
+        "source": {
+          "type": "string",
+          "enum": [
+            "native_session",
+            "oauth_token_env",
+            "api_key_env",
+            "api_key_flag",
+            "provider_auth_file",
+            "none"
+          ],
+          "description": "Concrete credential source used or probed by a harness."
+        }
+      },
+      "required": [
+        "authRequest",
+        "source"
+      ],
+      "additionalProperties": false,
+      "description": "Request to refresh one exact harness authentication source without probing unrelated routes."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlAuthReadinessRefreshResponse.schema.json

@@ -0,0 +1,85 @@
+{
+  "$ref": "#/definitions/ControlAuthReadinessRefreshResponse",
+  "definitions": {
+    "ControlAuthReadinessRefreshResponse": {
+      "type": "object",
+      "properties": {
+        "harnessId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "authRequest": {
+          "type": "string",
+          "enum": [
+            "subscription",
+            "api_key",
+            "auto"
+          ],
+          "description": "Requested credential behavior: exact subscription, exact managed API key, or policy-governed auto selection."
+        },
+        "requestedSource": {
+          "type": "string",
+          "enum": [
+            "native_session",
+            "oauth_token_env",
+            "api_key_env",
+            "api_key_flag",
+            "provider_auth_file",
+            "none"
+          ],
+          "description": "Concrete credential source used or probed by a harness."
+        },
+        "observedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "readiness": {
+          "type": "object",
+          "properties": {
+            "source": {
+              "$ref": "#/definitions/ControlAuthReadinessRefreshResponse/properties/requestedSource"
+            },
+            "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."
+        }
+      },
+      "required": [
+        "harnessId",
+        "authRequest",
+        "requestedSource",
+        "observedAt",
+        "readiness"
+      ],
+      "additionalProperties": false,
+      "description": "Point-in-time readiness evidence for one exact harness credential source."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlDeliveryResponse.schema.json

@@ -0,0 +1,136 @@
+{
+  "$ref": "#/definitions/ControlDeliveryResponse",
+  "definitions": {
+    "ControlDeliveryResponse": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "artifact_only",
+            "apply",
+            "branch",
+            "commit",
+            "pr"
+          ]
+        },
+        "applied": {
+          "type": "boolean"
+        },
+        "branch": {
+          "type": "string"
+        },
+        "commit": {
+          "type": "string"
+        },
+        "prUrl": {
+          "type": "string"
+        },
+        "detail": {
+          "type": "string"
+        },
+        "treeMutated": {
+          "type": "boolean"
+        },
+        "refused": {
+          "type": "boolean"
+        },
+        "finalVerify": {
+          "type": "object",
+          "properties": {
+            "attempted": {
+              "type": "boolean",
+              "description": "Whether the final verify was attempted."
+            },
+            "base_sha": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Base SHA the verify tree was created from (the winner envelope's base)."
+            },
+            "applied_cleanly": {
+              "type": [
+                "boolean",
+                "null"
+              ],
+              "default": null,
+              "description": "Whether the patch applied cleanly onto the fresh tree; null when not attempted."
+            },
+            "gates_passed": {
+              "type": [
+                "boolean",
+                "null"
+              ],
+              "default": null,
+              "description": "Whether the re-run deterministic gates passed; null when not attempted."
+            },
+            "gates": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Gate id."
+                  },
+                  "status": {
+                    "type": "string",
+                    "description": "Gate status."
+                  }
+                },
+                "required": [
+                  "id",
+                  "status"
+                ],
+                "additionalProperties": false
+              },
+              "default": [],
+              "description": "Per-gate re-run results."
+            },
+            "duration_ms": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "How long the verify took, in milliseconds."
+            },
+            "reason": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Typed reason when attempted=false (e.g. no_patch, no_base_sha) or a failure detail."
+            }
+          },
+          "required": [
+            "attempted"
+          ],
+          "additionalProperties": false,
+          "description": "Fresh verifier evidence for this delivery attempt."
+        },
+        "targetPreimageSha": {
+          "type": "string",
+          "description": "Target snapshot verified immediately before delivery."
+        }
+      },
+      "required": [
+        "mode",
+        "applied",
+        "finalVerify",
+        "targetPreimageSha"
+      ],
+      "additionalProperties": false,
+      "description": "Result of a manual run delivery attempt."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}