agent-hitch 0.2.6 → 0.2.7

package/docs/schemas/eval-trial-publication.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/eval-trial-publication.schema.json",
+  "title": "Hitch Eval Trial Publication v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "eval_id", "mode", "trial", "created_at"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "eval_id": { "type": "string", "pattern": "^eval_[a-f0-9]{32}$" },
+    "mode": { "enum": ["settle", "replace-invalid"] },
+    "trial": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["trial_id", "run_id", "task_id", "attempt", "observation_status"],
+      "properties": {
+        "trial_id": { "type": "string", "minLength": 1 },
+        "run_id": { "type": "string", "pattern": "^run_[a-f0-9]{32}$" },
+        "task_id": { "type": "string", "minLength": 1 },
+        "attempt": { "type": "integer", "minimum": 1 },
+        "observation_status": { "enum": ["valid", "invalid"] },
+        "reward": { "type": "number" },
+        "verifier_result_ref": { "type": "string", "minLength": 1 },
+        "invalid_reason": { "type": "string", "minLength": 1 }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "observation_status": { "const": "valid" } } },
+          "then": { "required": ["reward"] }
+        },
+        {
+          "if": { "properties": { "observation_status": { "const": "invalid" } } },
+          "then": { "required": ["invalid_reason"] }
+        }
+      ]
+    },
+    "created_at": { "type": "string", "format": "date-time" }
+  }
+}

package/docs/schemas/execution-evidence.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/execution-evidence.schema.json",
+  "title": "Hitch execution evidence V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version", "provider", "worker_id", "collision_domain_id", "eval_id", "work_id",
+    "lease_id", "lease_epoch", "task_id", "reservation", "enforced", "observed"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "provider": { "type": "string", "minLength": 1, "maxLength": 4096 },
+    "worker_id": { "type": "string", "minLength": 1, "maxLength": 4096 },
+    "collision_domain_id": { "type": "string", "minLength": 1, "maxLength": 4096 },
+    "eval_id": { "type": "string", "pattern": "^eval_[a-f0-9]{32}$" },
+    "work_id": { "type": "string", "pattern": "^work_[a-f0-9]{32}$" },
+    "lease_id": { "type": "string", "pattern": "^lease_[a-f0-9]{32}$" },
+    "lease_epoch": { "type": "integer", "minimum": 1 },
+    "task_id": { "type": "string", "minLength": 1, "maxLength": 4096 },
+    "reservation": { "$ref": "#/$defs/resources" },
+    "enforced": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["main_limits", "sidecar_limits"],
+      "properties": {
+        "main_limits": { "$ref": "#/$defs/resources" },
+        "sidecar_limits": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["cpu_millis", "memory_bytes"],
+            "properties": {
+              "cpu_millis": { "type": "integer", "minimum": 1 },
+              "memory_bytes": { "type": "integer", "minimum": 1 },
+              "gpu_count": { "type": "integer", "minimum": 1 }
+            }
+          }
+        }
+      }
+    },
+    "observed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "started_at", "collected_at", "sample_count", "containers", "unavailable_fields", "issues"],
+      "properties": {
+        "status": { "enum": ["partial", "unavailable"] },
+        "started_at": { "type": "string", "format": "date-time" },
+        "collected_at": { "type": "string", "format": "date-time" },
+        "sample_count": { "type": "integer", "minimum": 0 },
+        "containers": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/container" } },
+        "unavailable_fields": {
+          "type": "array",
+          "items": { "enum": ["cpu_time_ns", "peak_memory_bytes", "exit_status", "image_identity"] },
+          "uniqueItems": true
+        },
+        "issues": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 512 } }
+      }
+    }
+  },
+  "$defs": {
+    "resources": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cpu_millis", "memory_bytes", "container_slots", "build_slots"],
+      "properties": {
+        "cpu_millis": { "type": "integer", "minimum": 0 },
+        "memory_bytes": { "type": "integer", "minimum": 0 },
+        "container_slots": { "type": "integer", "minimum": 0 },
+        "build_slots": { "type": "integer", "minimum": 0 },
+        "gpu_count": { "type": "integer", "minimum": 0 },
+        "ephemeral_disk_bytes": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "container": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["container_id", "first_observed_at", "last_observed_at"],
+      "properties": {
+        "container_id": { "type": "string", "pattern": "^[a-f0-9]{12,64}$" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "image_reference": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "image_config_digest": { "$ref": "#/$defs/sha256" },
+        "first_observed_at": { "type": "string", "format": "date-time" },
+        "last_observed_at": { "type": "string", "format": "date-time" },
+        "peak_memory_bytes": { "type": "integer", "minimum": 0 },
+        "cpu_time_ns": { "type": "integer", "minimum": 0 },
+        "oom_killed": { "type": "boolean" },
+        "exit_code": { "type": "integer", "minimum": 0, "maximum": 255 },
+        "exit_reason": { "type": "string", "minLength": 1, "maxLength": 512 }
+      }
+    },
+    "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/docs/schemas/execution-lease.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/execution-lease.schema.json",
+  "title": "Hitch execution lease V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version", "lease_id", "work_id", "eval_id", "worker_id", "provider", "collision_domain_id",
+    "reservation", "state", "epoch", "issued_at", "expires_at"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "lease_id": { "type": "string", "pattern": "^lease_[a-f0-9]{32}$" },
+    "work_id": { "type": "string", "pattern": "^work_[a-f0-9]{32}$" },
+    "eval_id": { "type": "string", "pattern": "^eval_[a-f0-9]{32}$" },
+    "worker_id": { "type": "string", "minLength": 1 },
+    "provider": { "type": "string", "minLength": 1 },
+    "collision_domain_id": { "type": "string", "minLength": 1 },
+    "parent_allocation_id": { "type": "string", "pattern": "^allocation_[a-f0-9]{32}$" },
+    "reservation": { "$ref": "#/$defs/resources" },
+    "state": { "enum": ["offered", "accepted", "running", "releasing", "released", "expired", "lost"] },
+    "epoch": { "type": "integer", "minimum": 1 },
+    "resource_epochs": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "integer", "minimum": 1 }
+    },
+    "issued_at": { "type": "string", "format": "date-time" },
+    "accepted_at": { "type": "string", "format": "date-time" },
+    "heartbeat_at": { "type": "string", "format": "date-time" },
+    "expires_at": { "type": "string", "format": "date-time" },
+    "terminal_at": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "resources": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cpu_millis", "memory_bytes", "container_slots", "build_slots"],
+      "properties": {
+        "cpu_millis": { "type": "integer", "minimum": 0 },
+        "memory_bytes": { "type": "integer", "minimum": 0 },
+        "container_slots": { "type": "integer", "minimum": 0 },
+        "build_slots": { "type": "integer", "minimum": 0 },
+        "gpu_count": { "type": "integer", "minimum": 0 },
+        "ephemeral_disk_bytes": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/docs/schemas/execution-provider-status.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/execution-provider-status.schema.json",
+  "title": "Hitch execution provider status V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "provider", "worker_id", "collision_domain_id", "health", "platforms", "backends", "features", "capacity", "heartbeat_at"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "provider": { "type": "string", "minLength": 1 },
+    "worker_id": { "type": "string", "minLength": 1 },
+    "collision_domain_id": { "type": "string", "minLength": 1 },
+    "health": { "enum": ["healthy", "degraded", "unavailable"] },
+    "platforms": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "backends": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "version"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "version": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "features": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["docker", "buildkit", "model_proxy", "isolated_same_task_attempts"],
+      "properties": {
+        "docker": { "type": "boolean" },
+        "buildkit": { "type": "boolean" },
+        "model_proxy": { "type": "boolean" },
+        "isolated_same_task_attempts": { "type": "boolean" }
+      }
+    },
+    "capacity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total", "allocatable", "allocated"],
+      "properties": {
+        "total": { "$ref": "#/$defs/resources" },
+        "allocatable": { "$ref": "#/$defs/resources" },
+        "allocated": { "$ref": "#/$defs/resources" }
+      }
+    },
+    "heartbeat_at": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "resources": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cpu_millis", "memory_bytes", "container_slots", "build_slots"],
+      "properties": {
+        "cpu_millis": { "type": "integer", "minimum": 0 },
+        "memory_bytes": { "type": "integer", "minimum": 0 },
+        "container_slots": { "type": "integer", "minimum": 0 },
+        "build_slots": { "type": "integer", "minimum": 0 },
+        "gpu_count": { "type": "integer", "minimum": 0 },
+        "ephemeral_disk_bytes": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/docs/schemas/execution-worker.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/execution-worker.schema.json",
+  "title": "Hitch execution worker V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "worker_id", "provider", "status", "collision_domain_id", "capabilities", "capacity"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "worker_id": { "type": "string", "minLength": 1 },
+    "provider": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["ready", "draining", "offline"] },
+    "collision_domain_id": { "type": "string", "minLength": 1 },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["backends", "platforms", "task_membership", "isolated_same_task_attempts", "remote"],
+      "properties": {
+        "backends": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+        "platforms": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+        "task_membership": { "type": "array", "items": { "enum": ["known", "opaque"] }, "uniqueItems": true },
+        "isolated_same_task_attempts": { "type": "boolean" },
+        "remote": { "type": "boolean" }
+      }
+    },
+    "capacity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total", "reserved_for_system", "allocatable", "allocated"],
+      "properties": {
+        "total": { "$ref": "#/$defs/resources" },
+        "reserved_for_system": { "$ref": "#/$defs/resources" },
+        "allocatable": { "$ref": "#/$defs/resources" },
+        "allocated": { "$ref": "#/$defs/resources" }
+      }
+    }
+  },
+  "$defs": {
+    "resources": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cpu_millis", "memory_bytes", "container_slots", "build_slots"],
+      "properties": {
+        "cpu_millis": { "type": "integer", "minimum": 0 },
+        "memory_bytes": { "type": "integer", "minimum": 0 },
+        "container_slots": { "type": "integer", "minimum": 0 },
+        "build_slots": { "type": "integer", "minimum": 0 },
+        "gpu_count": { "type": "integer", "minimum": 0 },
+        "ephemeral_disk_bytes": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/docs/schemas/harbor-process-exit.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/harbor-process-exit.schema.json",
+  "title": "Hitch supervised Harbor process exit V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "process_exit_code", "signal", "completed_at"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "process_exit_code": { "type": ["integer", "null"] },
+    "signal": { "type": ["string", "null"] },
+    "completed_at": { "type": "string", "format": "date-time" }
+  }
+}

package/docs/schemas/interaction-capture-ref.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/interaction-capture-ref.schema.json",
+  "title": "Hitch interaction capture reference V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version", "run_id", "mode", "required", "topology", "completeness", "interaction_count",
+    "interactions_ref", "redaction"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "run_id": { "type": "string", "pattern": "^run_[a-f0-9]{32}$" },
+    "mode": { "enum": ["proxy", "hybrid"] },
+    "required": { "type": "boolean" },
+    "topology": { "enum": ["host-side", "in-sandbox"] },
+    "completeness": { "enum": ["complete", "partial", "none"] },
+    "interaction_count": { "type": "integer", "minimum": 0 },
+    "interactions_ref": { "$ref": "#/$defs/relativePath" },
+    "redaction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policy", "status", "rules"],
+      "properties": {
+        "policy": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "status": { "enum": ["applied", "not-needed", "failed"] },
+        "rules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["rule_id", "count"],
+            "properties": {
+              "rule_id": { "type": "string", "minLength": 1 },
+              "count": { "type": "integer", "minimum": 1 }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "relativePath": { "type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\).+$" }
+  }
+}

package/docs/schemas/local-provider-execution.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/local-provider-execution.schema.json",
+  "title": "Hitch local Docker provider execution record V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "provider", "worker_id", "eval_id", "work_id", "lease_id", "lease_epoch", "backend_directory", "process", "state", "started_at"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "provider": { "const": "local-docker" },
+    "worker_id": { "type": "string", "minLength": 1 },
+    "eval_id": { "type": "string", "pattern": "^eval_[a-f0-9]{32}$" },
+    "work_id": { "type": "string", "pattern": "^work_[a-f0-9]{32}$" },
+    "lease_id": { "type": "string", "pattern": "^lease_[a-f0-9]{32}$" },
+    "lease_epoch": { "type": "integer", "minimum": 1 },
+    "backend_directory": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.?(?:/|$))(?!.*\\\\)[^/]+(?:/[^/]+)*$" },
+    "process": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pid", "start_identity", "observed_at"],
+      "properties": {
+        "pid": { "type": "integer", "minimum": 1 },
+        "start_identity": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "observed_at": { "type": "string", "format": "date-time" }
+      }
+    },
+    "state": { "enum": ["running", "terminal", "released"] },
+    "started_at": { "type": "string", "format": "date-time" },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "process_exit_code": { "type": ["integer", "null"] },
+    "signal": { "type": ["string", "null"] }
+  }
+}

package/docs/schemas/model-interaction.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/model-interaction.schema.json",
+  "title": "Hitch model interaction V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "interaction_id", "run_id", "sequence", "requested_model", "endpoint_identity", "started_at", "status"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "interaction_id": { "type": "string", "pattern": "^interaction_[a-f0-9]{32}$" },
+    "run_id": { "type": "string", "pattern": "^run_[a-f0-9]{32}$" },
+    "eval_id": { "type": "string", "minLength": 1 },
+    "trial_id": { "type": "string", "minLength": 1 },
+    "sequence": { "type": "integer", "minimum": 1 },
+    "requested_model": { "type": "string" },
+    "effective_model": { "type": "string", "minLength": 1 },
+    "endpoint_identity": { "$ref": "#/$defs/sha256" },
+    "started_at": { "type": "string", "format": "date-time" },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "latency_ms": { "type": "integer", "minimum": 0 },
+    "status": { "enum": ["succeeded", "failed", "cancelled"] },
+    "http_status": { "type": "integer", "minimum": 100, "maximum": 599 },
+    "retry_of": { "type": "string", "pattern": "^interaction_[a-f0-9]{32}$" },
+    "usage": { "type": "object", "additionalProperties": { "type": "number", "minimum": 0 } },
+    "request_ref": { "$ref": "#/$defs/relativePath" },
+    "response_ref": { "$ref": "#/$defs/relativePath" },
+    "error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 4096 }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "relativePath": { "type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\).+$" }
+  }
+}

package/docs/schemas/remote-result-envelope.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/remote-result-envelope.schema.json",
+  "title": "Hitch remote result envelope V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "eval_id", "work_id", "lease_id", "lease_epoch", "trial", "files"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "eval_id": { "type": "string", "pattern": "^eval_[a-f0-9]{32}$" },
+    "work_id": { "type": "string", "pattern": "^work_[a-f0-9]{32}$" },
+    "lease_id": { "type": "string", "pattern": "^lease_[a-f0-9]{32}$" },
+    "lease_epoch": { "type": "integer", "minimum": 1 },
+    "trial": { "type": "object" },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 100000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "size", "sha256", "content_base64"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "size": { "type": "integer", "minimum": 0, "maximum": 134217728 },
+          "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+          "content_base64": { "type": "string", "contentEncoding": "base64" }
+        }
+      }
+    }
+  }
+}

package/docs/schemas/remote-tree-envelope.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/remote-tree-envelope.schema.json",
+  "title": "Hitch remote tree envelope V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "files"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "files": {
+      "type": "array", "minItems": 1, "maxItems": 100000,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["path", "mode", "size", "sha256", "content_base64"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "mode": { "enum": [420, 493] },
+          "size": { "type": "integer", "minimum": 0, "maximum": 268435456 },
+          "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+          "content_base64": { "type": "string", "contentEncoding": "base64" }
+        }
+      }
+    }
+  }
+}

package/docs/schemas/remote-work-offer.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/remote-work-offer.schema.json",
+  "title": "Hitch remote work offer V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "offer_id", "nonce", "generation", "worker_id", "lease", "work", "state", "issued_at", "expires_at"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "offer_id": { "type": "string", "pattern": "^offer_[a-f0-9]{32}$" },
+    "nonce": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "generation": { "type": "integer", "minimum": 1 },
+    "worker_id": { "type": "string", "pattern": "^worker_[a-z0-9][a-z0-9_-]{0,62}$" },
+    "lease": { "$ref": "execution-lease.schema.json" },
+    "work": { "$ref": "eval-execution-plan.schema.json#/properties/work_items/items" },
+    "inputs": {
+      "type": "array", "minItems": 1, "maxItems": 4,
+      "items": { "$ref": "#/$defs/inputRef" }
+    },
+    "state": { "enum": ["offered", "accepted", "rejected", "cancel-requested", "completed", "release-requested", "released", "expired"] },
+    "issued_at": { "type": "string", "format": "date-time" },
+    "expires_at": { "type": "string", "format": "date-time" },
+    "accepted_at": { "type": "string", "format": "date-time" },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "released_at": { "type": "string", "format": "date-time" },
+    "rejection_code": { "type": "string", "minLength": 1 },
+    "accept_receipt_digest": { "$ref": "#/$defs/sha256" },
+    "terminal_receipt_digest": { "$ref": "#/$defs/sha256" },
+    "release_receipt_digest": { "$ref": "#/$defs/sha256" },
+    "terminal": {
+      "type": "object", "additionalProperties": false, "required": ["status", "artifacts", "sent_at"],
+      "properties": {
+        "status": { "enum": ["succeeded", "failed", "cancelled"] },
+        "artifacts": { "type": "array", "items": { "$ref": "#/$defs/artifactRef" } },
+        "sent_at": { "type": "string", "format": "date-time" }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "artifactRef": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "digest", "size"],
+      "properties": {
+        "kind": { "enum": ["result-bundle", "diagnostic"] }, "digest": { "$ref": "#/$defs/sha256" },
+        "size": { "type": "integer", "minimum": 0, "maximum": 536870912 }
+      }
+    },
+    "inputRef": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "format", "digest", "size"],
+      "properties": {
+        "kind": { "enum": ["work-spec", "harness-artifact", "controller-runtime", "task-input"] },
+        "format": { "enum": ["json", "hitch-tree-v1"] },
+        "digest": { "$ref": "#/$defs/sha256" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 268435456 }
+      }
+    }
+  }
+}

package/docs/schemas/remote-work-receipt.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/remote-work-receipt.schema.json",
+  "title": "Hitch remote work receipt V1",
+  "oneOf": [
+    {
+      "type": "object", "additionalProperties": false,
+      "required": ["schema_version", "offer_id", "nonce", "generation", "accepted", "sent_at"],
+      "properties": {
+        "schema_version": { "const": "1" }, "offer_id": { "$ref": "#/$defs/offerId" }, "nonce": { "$ref": "#/$defs/nonce" },
+        "generation": { "type": "integer", "minimum": 1 }, "accepted": { "type": "boolean" },
+        "rejection_code": { "type": "string", "minLength": 1 }, "sent_at": { "type": "string", "format": "date-time" }
+      }
+    },
+    {
+      "type": "object", "additionalProperties": false,
+      "required": ["schema_version", "offer_id", "nonce", "generation", "lease_id", "epoch", "status", "artifacts", "sent_at"],
+      "properties": {
+        "schema_version": { "const": "1" }, "offer_id": { "$ref": "#/$defs/offerId" }, "nonce": { "$ref": "#/$defs/nonce" },
+        "generation": { "type": "integer", "minimum": 1 }, "lease_id": { "$ref": "#/$defs/leaseId" }, "epoch": { "type": "integer", "minimum": 1 },
+        "status": { "enum": ["succeeded", "failed", "cancelled"] },
+        "artifacts": {
+          "type": "array", "items": {
+            "type": "object", "additionalProperties": false, "required": ["kind", "digest", "size"],
+            "properties": {
+              "kind": { "enum": ["result-bundle", "diagnostic"] }, "digest": { "$ref": "#/$defs/sha256" },
+              "size": { "type": "integer", "minimum": 0, "maximum": 536870912 }
+            }
+          }
+        },
+        "sent_at": { "type": "string", "format": "date-time" }
+      }
+    },
+    {
+      "type": "object", "additionalProperties": false,
+      "required": ["schema_version", "offer_id", "nonce", "generation", "lease_id", "epoch", "sent_at"],
+      "properties": {
+        "schema_version": { "const": "1" }, "offer_id": { "$ref": "#/$defs/offerId" }, "nonce": { "$ref": "#/$defs/nonce" },
+        "generation": { "type": "integer", "minimum": 1 }, "lease_id": { "$ref": "#/$defs/leaseId" },
+        "epoch": { "type": "integer", "minimum": 1 }, "sent_at": { "type": "string", "format": "date-time" }
+      }
+    }
+  ],
+  "$defs": {
+    "offerId": { "type": "string", "pattern": "^offer_[a-f0-9]{32}$" },
+    "leaseId": { "type": "string", "pattern": "^lease_[a-f0-9]{32}$" },
+    "nonce": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}