agent-hitch 0.2.9 → 0.2.10

package/docs/schemas/controller-runtime-observation.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/controller-runtime-observation.schema.json",
+  "title": "Hitch controller runtime observation V2",
+  "description": "Reports the loaded package's compiled payload and its own source checkout, without paths or credentials. An installed package never borrows its parent repository's commit. This is not GPU or sandbox validation.",
+  "type": "object", "additionalProperties": false,
+  "required": ["schema_version", "package_version", "node_version", "runtime_id", "source"],
+  "properties": {
+    "schema_version": { "const": "2" }, "package_version": { "type": "string", "minLength": 1 },
+    "node_version": { "type": "string", "pattern": "^v[0-9]+\\.[0-9]+\\.[0-9]+" },
+    "runtime_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "source": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["kind", "commit", "dirty"], "properties": {
+        "kind": { "const": "git-checkout" }, "commit": { "type": "string", "pattern": "^[a-f0-9]{40}$" }, "dirty": { "type": "boolean" }
+      } },
+      { "type": "object", "additionalProperties": false, "required": ["kind", "commit", "dirty"], "properties": {
+        "kind": { "const": "unavailable" }, "commit": { "type": "null" }, "dirty": { "type": "null" }
+      } }
+    ] }
+  }
+}

package/docs/schemas/eval-execution-plan.schema.json

@@ -26,6 +26,7 @@
     },
     "provider": { "type": "string", "minLength": 1 },
     "model_capture": { "$ref": "#/$defs/modelCapture" },
+    "training_binding": { "$ref": "training-external-binding.schema.json" },
     "max_parallelism": { "type": "integer", "minimum": 1 },
     "default_trial_resources": { "$ref": "#/$defs/resources" },
     "task_resources": {

package/docs/schemas/eval-request.schema.json

@@ -20,6 +20,8 @@
     "timeout_ms": { "type": "number", "minimum": 0 },
     "setup_timeout_ms": { "type": "number", "minimum": 0 },
     "agent_args": { "type": "array", "items": { "type": "string" } },
-    "pass_env": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+    "pass_env": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+    "local_inference": { "$ref": "local-inference-selection.schema.json" },
+    "training_binding": { "$ref": "training-external-binding.schema.json" }
   }
 }

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

@@ -30,8 +30,102 @@
     "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" }
+    "terminal_at": { "type": "string", "format": "date-time" },
+    "release_confirmation": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "schema_version",
+            "offer_id",
+            "worker_generation",
+            "execution_epoch",
+            "receipt_digest",
+            "released_at"
+          ],
+          "properties": {
+            "schema_version": {
+              "const": "2"
+            },
+            "offer_id": {
+              "type": "string",
+              "pattern": "^offer_[a-f0-9]{32}$"
+            },
+            "worker_generation": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "execution_epoch": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "receipt_digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "released_at": {
+              "type": "string",
+              "format": "date-time"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "schema_version",
+            "offer_id",
+            "worker_generation",
+            "execution_epoch",
+            "receipt_digest",
+            "released_at",
+            "cleanup_generation",
+            "cleanup_id",
+            "admission_digest"
+          ],
+          "properties": {
+            "schema_version": {
+              "const": "3"
+            },
+            "offer_id": {
+              "type": "string",
+              "pattern": "^offer_[a-f0-9]{32}$"
+            },
+            "worker_generation": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "execution_epoch": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "receipt_digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "released_at": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "cleanup_generation": {
+              "type": "integer",
+              "minimum": 2
+            },
+            "cleanup_id": {
+              "type": "string",
+              "pattern": "^cleanup_[a-f0-9]{32}$"
+            },
+            "admission_digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            }
+          }
+        }
+      ]
+    }
   },
+  "allOf": [{ "if": { "required": ["release_confirmation"] }, "then": { "properties": { "state": { "const": "released" }, "provider": { "not": { "const": "local-docker" } } } } }],
   "$defs": {
     "resources": {
       "type": "object",

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

@@ -4,61 +4,195 @@
   "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"],
+  "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 } },
+    "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"],
+        "required": [
+          "id",
+          "version"
+        ],
         "properties": {
-          "id": { "type": "string", "minLength": 1 },
-          "version": { "type": "string", "minLength": 1 }
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1
+          }
         }
       }
     },
     "features": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["docker", "buildkit", "model_proxy", "isolated_same_task_attempts"],
+      "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" }
-      }
+        "docker": {
+          "type": "boolean"
+        },
+        "buildkit": {
+          "type": "boolean"
+        },
+        "model_proxy": {
+          "type": "boolean"
+        },
+        "isolated_same_task_attempts": {
+          "type": "boolean"
+        },
+        "training_external_binding": {
+          "const": "2"
+        },
+        "managed_model_node": {
+          "const": "2"
+        },
+        "physical_work": {
+          "const": "2"
+        },
+        "execution_observation": {
+          "const": "2"
+        },
+        "verifier_source": {
+          "const": "2"
+        },
+        "verifier_only": {
+          "const": "2"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "required": [
+              "verifier_only"
+            ]
+          },
+          "then": {
+            "required": [
+              "physical_work"
+            ],
+            "properties": {
+              "docker": {
+                "const": true
+              },
+              "physical_work": {
+                "const": "2"
+              }
+            }
+          }
+        }
+      ]
     },
     "capacity": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["total", "allocatable", "allocated"],
+      "required": [
+        "total",
+        "allocatable",
+        "allocated"
+      ],
       "properties": {
-        "total": { "$ref": "#/$defs/resources" },
-        "allocatable": { "$ref": "#/$defs/resources" },
-        "allocated": { "$ref": "#/$defs/resources" }
+        "total": {
+          "$ref": "#/$defs/resources"
+        },
+        "allocatable": {
+          "$ref": "#/$defs/resources"
+        },
+        "allocated": {
+          "$ref": "#/$defs/resources"
+        }
       }
     },
-    "heartbeat_at": { "type": "string", "format": "date-time" }
+    "heartbeat_at": {
+      "type": "string",
+      "format": "date-time"
+    }
   },
   "$defs": {
     "resources": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["cpu_millis", "memory_bytes", "container_slots", "build_slots"],
+      "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 }
+        "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
+        }
       }
     }
   }