agent-hitch 0.2.9 → 0.2.11

package/docs/schemas/remote-harbor-work-spec.schema.json

@@ -0,0 +1,325 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/remote-harbor-work-spec.schema.json",
+  "title": "Hitch remote Harbor work spec V1/V2",
+  "description": "The worker additionally validates equality with its offer and the complete request/plan/model graph before execution.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "request",
+    "plan",
+    "work",
+    "resolution",
+    "harness_artifact",
+    "controller_runtime",
+    "task"
+  ],
+  "properties": {
+    "schema_version": {
+      "enum": [
+        "1",
+        "2"
+      ]
+    },
+    "request": {
+      "allOf": [
+        {
+          "$ref": "eval-request.schema.json"
+        },
+        {
+          "properties": {
+            "dataset": {
+              "const": "task-input"
+            }
+          }
+        }
+      ]
+    },
+    "plan": {
+      "$ref": "eval-execution-plan.schema.json"
+    },
+    "work": {
+      "$ref": "eval-execution-plan.schema.json#/properties/work_items/items"
+    },
+    "resolution": {
+      "$ref": "resolved-revision.schema.json"
+    },
+    "harness_artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "directory",
+        "artifact_id",
+        "artifact_integrity",
+        "entrypoint_integrity",
+        "harness_id",
+        "revision_identity",
+        "adapter_version",
+        "recipe_version",
+        "platform",
+        "node_version",
+        "source_type"
+      ],
+      "properties": {
+        "directory": {
+          "const": "harness-artifact"
+        },
+        "artifact_id": {
+          "$ref": "#/$defs/sha256"
+        },
+        "artifact_integrity": {
+          "$ref": "#/$defs/sha256"
+        },
+        "entrypoint_integrity": {
+          "$ref": "#/$defs/sha256"
+        },
+        "harness_id": {
+          "$ref": "#/$defs/text"
+        },
+        "revision_identity": {
+          "$ref": "#/$defs/sha256"
+        },
+        "adapter_version": {
+          "$ref": "#/$defs/text"
+        },
+        "recipe_version": {
+          "$ref": "#/$defs/text"
+        },
+        "platform": {
+          "$ref": "#/$defs/text"
+        },
+        "node_version": {
+          "$ref": "#/$defs/text"
+        },
+        "source_type": {
+          "$ref": "#/$defs/text"
+        }
+      }
+    },
+    "controller_runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "runtime_id",
+        "directory"
+      ],
+      "properties": {
+        "runtime_id": {
+          "$ref": "#/$defs/sha256"
+        },
+        "directory": {
+          "const": "controller-runtime"
+        }
+      }
+    },
+    "task": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "task_id",
+        "directory"
+      ],
+      "properties": {
+        "task_id": {
+          "$ref": "#/$defs/text"
+        },
+        "directory": {
+          "const": "task-input"
+        }
+      }
+    },
+    "credential_names": {
+      "type": "array",
+      "uniqueItems": true,
+      "maxItems": 256,
+      "items": {
+        "type": "string",
+        "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+      }
+    },
+    "model_binding": {
+      "$ref": "remote-model-binding.schema.json"
+    },
+    "physical_execution": {
+      "$ref": "remote-physical-execution.schema.json"
+    },
+    "verifier_source": {
+      "const": "2"
+    },
+    "verifier_only": {
+      "$ref": "remote-verifier-work.schema.json"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "schema_version": {
+            "const": "2"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "credential_names"
+        ],
+        "anyOf": [
+          {
+            "required": [
+              "model_binding"
+            ]
+          },
+          {
+            "required": [
+              "physical_execution"
+            ]
+          },
+          {
+            "required": [
+              "verifier_source"
+            ]
+          }
+        ]
+      },
+      "else": {
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "model_binding"
+              ]
+            },
+            {
+              "required": [
+                "physical_execution"
+              ]
+            },
+            {
+              "required": [
+                "verifier_source"
+              ]
+            },
+            {
+              "required": [
+                "verifier_only"
+              ]
+            }
+          ]
+        },
+        "properties": {
+          "request": {
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "training_binding"
+                  ]
+                },
+                {
+                  "required": [
+                    "local_inference"
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": [
+          "model_binding"
+        ]
+      },
+      "then": {
+        "properties": {
+          "credential_names": {
+            "maxItems": 0
+          },
+          "request": {
+            "properties": {
+              "pass_env": {
+                "maxItems": 0
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": [
+          "verifier_only"
+        ]
+      },
+      "then": {
+        "required": [
+          "physical_execution",
+          "credential_names"
+        ],
+        "properties": {
+          "schema_version": {
+            "const": "2"
+          },
+          "physical_execution": {
+            "properties": {
+              "kind": {
+                "const": "verifier-only"
+              }
+            }
+          },
+          "credential_names": {
+            "maxItems": 0
+          },
+          "request": {
+            "not": {
+              "required": [
+                "training_binding"
+              ]
+            }
+          }
+        },
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "model_binding"
+              ]
+            },
+            {
+              "required": [
+                "verifier_source"
+              ]
+            }
+          ]
+        }
+      },
+      "else": {
+        "properties": {
+          "physical_execution": {
+            "properties": {
+              "kind": {
+                "not": {
+                  "const": "verifier-only"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4096
+    }
+  }
+}

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

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/remote-model-binding.schema.json",
+  "title": "Hitch remote worker public model binding V2",
+  "oneOf": [
+    {
+      "type": "object", "additionalProperties": false, "required": ["schema_version", "kind", "training"],
+      "properties": { "schema_version": { "const": "2" }, "kind": { "const": "training-external" }, "training": { "$ref": "training-external-binding.schema.json" } }
+    },
+    {
+      "type": "object", "additionalProperties": false, "required": ["schema_version", "kind", "inference_id", "model_id", "model_node", "api", "max_output_tokens"],
+      "properties": {
+        "schema_version": { "const": "2" }, "kind": { "const": "managed-inference" },
+        "inference_id": { "$ref": "#/$defs/sha256" }, "model_id": { "$ref": "#/$defs/sha256" },
+        "model_node": { "$ref": "model-node-binding.schema.json" }, "api": { "enum": ["responses", "chat-completions"] },
+        "max_output_tokens": { "type": "integer", "minimum": 1 }
+      }
+    }
+  ],
+  "$defs": { "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }
+}

package/docs/schemas/remote-physical-execution.schema.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/remote-physical-execution.schema.json",
+  "title": "Hitch remote physical execution V2",
+  "description": "Derives a physical work ID from an unchanged frozen logical plan. The worker additionally verifies all work fields against the original source and rejects training slot reruns.",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "kind",
+        "source_work_id",
+        "rerun_id"
+      ],
+      "properties": {
+        "schema_version": {
+          "const": "2"
+        },
+        "kind": {
+          "const": "candidate-restart"
+        },
+        "source_work_id": {
+          "$ref": "#/$defs/workId"
+        },
+        "rerun_id": {
+          "type": "string",
+          "pattern": "^rerun_[a-f0-9]{32}$"
+        }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "kind",
+        "source_work_id",
+        "retry_index",
+        "trigger_trial_ids"
+      ],
+      "properties": {
+        "schema_version": {
+          "const": "2"
+        },
+        "kind": {
+          "const": "physical-infrastructure-retry"
+        },
+        "source_work_id": {
+          "$ref": "#/$defs/workId"
+        },
+        "retry_index": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "trigger_trial_ids": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 10000,
+          "uniqueItems": true,
+          "description": "Sorted in UTF-8 byte order.",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4096,
+            "pattern": "^[^\\u0000\\r\\n]+$"
+          }
+        }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "kind",
+        "source_work_id",
+        "rerun_id",
+        "assessment_id"
+      ],
+      "properties": {
+        "schema_version": {
+          "const": "2"
+        },
+        "kind": {
+          "const": "verifier-only"
+        },
+        "source_work_id": {
+          "$ref": "#/$defs/workId"
+        },
+        "rerun_id": {
+          "type": "string",
+          "pattern": "^rerun_[a-f0-9]{32}$"
+        },
+        "assessment_id": {
+          "type": "string",
+          "pattern": "^assessment_[a-f0-9]{32}$"
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "workId": {
+      "type": "string",
+      "pattern": "^work_[a-f0-9]{32}$"
+    }
+  }
+}

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

@@ -1,12 +1,13 @@
 {
   "$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",
+  "title": "Hitch remote result envelope V1/V2",
   "type": "object",
   "additionalProperties": false,
   "required": ["schema_version", "eval_id", "work_id", "lease_id", "lease_epoch", "trial", "files"],
   "properties": {
-    "schema_version": { "const": "1" },
+    "schema_version": { "enum": ["1", "2"] },
+    "verifier_source": { "$ref": "remote-verifier-source.schema.json" },
     "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}$" },
@@ -28,5 +29,10 @@
         }
       }
     }
-  }
+  },
+  "allOf": [{
+    "if": { "properties": { "schema_version": { "const": "2" } } },
+    "then": { "required": ["verifier_source"] },
+    "else": { "not": { "required": ["verifier_source"] } }
+  }]
 }

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

@@ -2,24 +2,38 @@
   "$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",
+  "description": "The runtime also validates canonical paths, order, unique entries, total limits, safe symlink targets and file digests.",
   "type": "object",
   "additionalProperties": false,
   "required": ["schema_version", "files"],
   "properties": {
     "schema_version": { "const": "1" },
+    "directories": { "type": "array", "maxItems": 100000, "items": {
+      "type": "object", "additionalProperties": false, "required": ["path", "mode"],
+      "properties": { "path": { "type": "string", "minLength": 1 }, "mode": { "type": "integer", "minimum": 256, "maximum": 511 } }
+    } },
+    "symlinks": { "type": "array", "maxItems": 100000, "items": {
+      "type": "object", "additionalProperties": false, "required": ["path", "target"],
+      "properties": { "path": { "type": "string", "minLength": 1 }, "target": { "type": "string", "minLength": 1 } }
+    } },
     "files": {
-      "type": "array", "minItems": 1, "maxItems": 100000,
+      "type": "array", "maxItems": 100000,
       "items": {
         "type": "object", "additionalProperties": false,
         "required": ["path", "mode", "size", "sha256", "content_base64"],
         "properties": {
           "path": { "type": "string", "minLength": 1 },
-          "mode": { "enum": [420, 493] },
+          "mode": { "type": "integer", "minimum": 256, "maximum": 511 },
           "size": { "type": "integer", "minimum": 0, "maximum": 268435456 },
           "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
           "content_base64": { "type": "string", "contentEncoding": "base64" }
         }
       }
     }
-  }
+  },
+  "anyOf": [
+    { "properties": { "files": { "minItems": 1 } } },
+    { "required": ["directories"], "properties": { "directories": { "minItems": 1 } } },
+    { "required": ["symlinks"], "properties": { "symlinks": { "minItems": 1 } } }
+  ]
 }