agent-hitch 0.2.9 → 0.2.10

package/docs/schemas/inference-service-record.schema.json

@@ -0,0 +1,227 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/inference-service-record.schema.json",
+  "title": "Hitch inference service record v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "service_id",
+    "inference_id",
+    "isolation_key",
+    "state",
+    "epoch",
+    "owner_id",
+    "lease_owner_ids",
+    "backend",
+    "started_at",
+    "updated_at"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "1"
+    },
+    "service_id": {
+      "type": "string",
+      "pattern": "^inference_[a-f0-9]{32}$"
+    },
+    "inference_id": {
+      "$ref": "#/$defs/sha256"
+    },
+    "isolation_key": {
+      "$ref": "#/$defs/sha256"
+    },
+    "state": {
+      "enum": [
+        "starting",
+        "ready",
+        "draining",
+        "stopped",
+        "failed"
+      ]
+    },
+    "epoch": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "owner_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "lease_owner_ids": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "backend": {
+      "enum": [
+        "cpu",
+        "cuda",
+        "metal"
+      ]
+    },
+    "container_id": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{12,64}$"
+    },
+    "pid": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "base_url": {
+      "type": "string",
+      "pattern": "^http://127\\.0\\.0\\.1:[0-9]+/?$"
+    },
+    "started_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "code",
+        "message"
+      ],
+      "properties": {
+        "code": {
+          "type": "string",
+          "minLength": 1
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "service_handle": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "schema_version",
+            "kind",
+            "container_id"
+          ],
+          "properties": {
+            "schema_version": {
+              "const": "2"
+            },
+            "kind": {
+              "const": "docker"
+            },
+            "container_id": {
+              "type": "string",
+              "pattern": "^[a-f0-9]{12,64}$"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "schema_version",
+            "kind",
+            "node_id",
+            "generation",
+            "service_id",
+            "process"
+          ],
+          "properties": {
+            "schema_version": {
+              "const": "2"
+            },
+            "kind": {
+              "const": "process"
+            },
+            "node_id": {
+              "type": "string",
+              "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$"
+            },
+            "generation": {
+              "type": "string",
+              "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$"
+            },
+            "service_id": {
+              "type": "string",
+              "pattern": "^inference_[a-f0-9]{32}$"
+            },
+            "process": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "pid",
+                "created_at"
+              ],
+              "properties": {
+                "pid": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 9007199254740991
+                },
+                "created_at": {
+                  "type": "number",
+                  "exclusiveMinimum": 0
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "model_node": {
+      "$ref": "#/$defs/modelNodeBinding"
+    }
+  },
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "modelNodeBinding": {
+      "$ref": "model-node-binding.schema.json"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "required": [
+          "service_handle"
+        ],
+        "properties": {
+          "service_handle": {
+            "properties": {
+              "kind": {
+                "const": "process"
+              }
+            }
+          }
+        }
+      },
+      "then": {
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "container_id"
+              ]
+            },
+            {
+              "required": [
+                "pid"
+              ]
+            }
+          ]
+        }
+      }
+    }
+  ]
+}

package/docs/schemas/local-inference-selection.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/local-inference-selection.schema.json",
+  "title": "Hitch local inference selection",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "model": {
+      "type": "string",
+      "pattern": "^local/(?:[a-z0-9][a-z0-9._-]{0,63}|sha256:[a-f0-9]{64})$"
+    },
+    "device": {
+      "enum": [
+        "auto",
+        "cpu",
+        "cuda",
+        "metal"
+      ],
+      "default": "auto"
+    },
+    "profile": {
+      "enum": [
+        "baseline",
+        "throughput"
+      ],
+      "default": "baseline"
+    },
+    "offline": {
+      "type": "boolean",
+      "default": false
+    },
+    "inference_id": {
+      "$ref": "#/$defs/sha256"
+    },
+    "model_node": {
+      "$ref": "#/$defs/modelNodeBinding"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "required": [
+          "inference_id"
+        ],
+        "not": {
+          "required": [
+            "model_node"
+          ]
+        }
+      },
+      "then": {
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "device"
+              ]
+            },
+            {
+              "required": [
+                "profile"
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "required": [
+          "model_node"
+        ]
+      },
+      "then": {
+        "required": [
+          "inference_id"
+        ],
+        "properties": {
+          "device": {
+            "const": "auto"
+          },
+          "profile": {
+            "const": "baseline"
+          }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "modelNodeBinding": {
+      "$ref": "model-node-binding.schema.json"
+    }
+  }
+}

package/docs/schemas/local-model-manifest.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/local-model-manifest.schema.json",
+  "title": "Hitch local model manifest v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "model_id", "format", "files", "architecture", "model_type", "dtype", "quantization", "context_tokens", "tokenizer_digest", "template_digest", "source", "created_at"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "model_id": { "$ref": "#/$defs/sha256" },
+    "format": { "const": "hf-safetensors" },
+    "files": {
+      "type": "array", "minItems": 3,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["path", "size", "sha256"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$" },
+          "size": { "type": "integer", "minimum": 0 },
+          "sha256": { "$ref": "#/$defs/sha256" }
+        }
+      }
+    },
+    "architecture": { "type": "string", "minLength": 1 },
+    "model_type": { "type": "string", "minLength": 1 },
+    "dtype": { "type": "string", "minLength": 1 },
+    "quantization": { "type": ["string", "null"] },
+    "context_tokens": { "type": ["integer", "null"], "minimum": 1 },
+    "tokenizer_digest": { "$ref": "#/$defs/sha256" },
+    "template_digest": { "oneOf": [{ "$ref": "#/$defs/sha256" }, { "type": "null" }] },
+    "source": {
+      "type": "object", "additionalProperties": false,
+      "required": ["kind", "label", "license"],
+      "properties": {
+        "kind": { "const": "local-directory" },
+        "label": { "type": "string", "minLength": 1 },
+        "license": { "type": ["string", "null"] }
+      }
+    },
+    "created_at": { "type": "string", "format": "date-time" }
+  },
+  "$defs": { "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }
+}

package/docs/schemas/model-node-binding.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/model-node-binding.schema.json",
+  "title": "Frozen Hitch model-node binding v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "node_id",
+    "generation",
+    "runtime_digest",
+    "launcher"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "2"
+    },
+    "node_id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$"
+    },
+    "generation": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$"
+    },
+    "runtime_digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "launcher": {
+      "const": "process"
+    }
+  }
+}

package/docs/schemas/model-node-generation-release.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/model-node-generation-release.schema.json",
+  "title": "Confirmed release of a previous model-node generation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "service_digest", "model_node", "receipt_digest", "receipt"],
+  "properties": {
+    "schema_version": { "const": "2" },
+    "service_digest": { "$ref": "#/$defs/sha" },
+    "model_node": { "$ref": "model-node-binding.schema.json" },
+    "receipt_digest": { "$ref": "#/$defs/sha" },
+    "receipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "kind", "serviceId", "ownerId", "inferenceId", "previousNode", "node", "sourceIdentityDigest", "handle", "admissionOnly", "state", "resourcesReleased", "gpuSeconds", "devices", "previousBootDigest", "currentBootDigest"],
+      "properties": {
+        "schemaVersion": { "const": 2 },
+        "kind": { "const": "inference-generation-release" },
+        "serviceId": { "type": "string", "pattern": "^inference_[a-f0-9]{32}$" },
+        "ownerId": { "type": "string", "minLength": 1 },
+        "inferenceId": { "$ref": "#/$defs/sha" },
+        "previousNode": { "$ref": "#/$defs/node" },
+        "node": { "$ref": "#/$defs/node" },
+        "sourceIdentityDigest": { "$ref": "#/$defs/sha" },
+        "handle": { "oneOf": [{ "type": "null" }, { "$ref": "inference-service-record.schema.json#/properties/service_handle/oneOf/1" }] },
+        "admissionOnly": { "type": "boolean" },
+        "state": { "const": "stopped" },
+        "resourcesReleased": { "const": true },
+        "gpuSeconds": { "type": "number", "minimum": 0 },
+        "devices": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^GPU-[a-fA-F0-9-]+$" } },
+        "previousBootDigest": { "$ref": "#/$defs/sha" },
+        "currentBootDigest": { "$ref": "#/$defs/sha" }
+      }
+    }
+  },
+  "$defs": {
+    "sha": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "node": { "type": "object", "additionalProperties": false, "required": ["nodeId", "generation"],
+      "properties": {
+        "nodeId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$" },
+        "generation": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$" }
+      }
+    }
+  }
+}

package/docs/schemas/ordered-eval-control.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/ordered-eval-control.schema.json",
+  "title": "Ordered eval command v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "key", "subject_digest", "sequence", "action"],
+  "properties": {
+    "schema_version": { "const": "2" },
+    "key": { "type": "string", "pattern": "^[!-~]{1,256}$" },
+    "subject_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "sequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+    "action": { "enum": ["start", "pause"] },
+    "submission": { "$ref": "eval-submission-input.schema.json" },
+    "rerun": {
+      "type": "object", "additionalProperties": false, "required": ["eval_id", "input"],
+      "properties": {
+        "eval_id": { "type": "string", "pattern": "^eval_[a-f0-9]{32}$" },
+        "input": {
+          "type": "object", "additionalProperties": false, "required": ["rerun_id", "rerun_type", "selector"],
+          "properties": {
+            "rerun_id": { "type": "string", "pattern": "^rerun_[a-f0-9]{32}$" },
+            "rerun_type": { "$ref": "eval-rerun-submission.schema.json#/$defs/rerunType" },
+            "selector": { "$ref": "eval-rerun-submission.schema.json#/$defs/selector" },
+            "verifier_runtime_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+          },
+          "allOf": [{ "if": { "required": ["verifier_runtime_id"] }, "then": { "properties": { "rerun_type": { "const": "verifier-only" } } } }]
+        }
+      }
+    }
+  },
+  "allOf": [
+    { "not": { "required": ["submission", "rerun"] } },
+    {
+      "if": { "properties": { "action": { "const": "pause" } } },
+      "then": { "not": { "anyOf": [{ "required": ["submission"] }, { "required": ["rerun"] }] } }
+    }
+  ]
+}

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

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/remote-execution-lease-grant.schema.json",
+  "title": "Hitch current remote execution lease V2",
+  "description": "An authenticated no-store snapshot of the current controller execution lease for an accepted offer; reading never renews it. Worker, offer, generation, epoch and immutable resource identity must match.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "offer_id",
+    "generation",
+    "lease"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "2"
+    },
+    "offer_id": {
+      "type": "string",
+      "pattern": "^offer_[a-f0-9]{32}$"
+    },
+    "generation": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "lease": {
+      "allOf": [
+        {
+          "$ref": "execution-lease.schema.json"
+        },
+        {
+          "properties": {
+            "state": {
+              "enum": [
+                "offered",
+                "accepted",
+                "running"
+              ]
+            }
+          }
+        }
+      ]
+    }
+  }
+}