@taifoon/jev 0.2.13 → 0.2.15

package/workflows/0.2.15/schemas/hire.json

@@ -0,0 +1,314 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://www.taifoon.io/schemas/coordination/v1/hire.json",
+  "title": "HIRE — what was asked, of whom, on which ledger, for how much",
+  "description": "The job itself: parties, task, money, deadline, and the lifecycle state it is in. One shape for an ERC-8183 job, a memo-ACP job, an extra deployment’s job, an assurance-hook job and a handshake that has no job yet.",
+  "type": "object",
+  "properties": {
+    "schema": {
+      "const": "taifoon.hire.v1",
+      "x-stage": "L",
+      "description": "which canonical entity this record is; fixed per schema"
+    },
+    "job": {
+      "$ref": "common.json#/$defs/job_ref",
+      "x-stage": "S1"
+    },
+    "lane": {
+      "$ref": "common.json#/$defs/lane",
+      "x-stage": "S2"
+    },
+    "tenant": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S2"
+    },
+    "buyer": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1"
+    },
+    "seller": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1"
+    },
+    "seller_agent_key": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/agent_key"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S9"
+    },
+    "seller_ids": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "scheme": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "scheme",
+          "id"
+        ],
+        "additionalProperties": false
+      },
+      "x-stage": "S1"
+    },
+    "evaluator": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1"
+    },
+    "hook": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1"
+    },
+    "evaluator_kind": {
+      "anyOf": [
+        {
+          "enum": [
+            "buyer",
+            "none",
+            "named",
+            "platform",
+            "hook"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S2"
+    },
+    "task": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S2"
+    },
+    "required_skills": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "x-stage": "L"
+    },
+    "budget": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/amount"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1"
+    },
+    "funding": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "properties": {
+        "price": {
+          "$ref": "common.json#/$defs/amount"
+        },
+        "premium": {
+          "anyOf": [
+            {
+              "$ref": "common.json#/$defs/amount"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "deposit": {
+          "anyOf": [
+            {
+              "$ref": "common.json#/$defs/amount"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "pool": {
+          "anyOf": [
+            {
+              "$ref": "common.json#/$defs/address"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "cover_cap": {
+          "anyOf": [
+            {
+              "$ref": "common.json#/$defs/uint_string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "deadline": {
+          "anyOf": [
+            {
+              "$ref": "common.json#/$defs/unix_s"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "challenge_window": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "stored by the hook, read by no contract logic"
+        }
+      },
+      "required": [
+        "price",
+        "premium",
+        "deposit",
+        "pool",
+        "cover_cap",
+        "deadline",
+        "challenge_window"
+      ],
+      "additionalProperties": false,
+      "x-stage": "S1"
+    },
+    "created_at": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/unix_s"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1"
+    },
+    "deadline": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/unix_s"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1"
+    },
+    "handshake_id": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^hs_[0-9a-f]{24}$",
+      "x-stage": "L"
+    },
+    "offer_nonce": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S7"
+    },
+    "state": {
+      "$ref": "common.json#/$defs/lifecycle_state",
+      "x-stage": "L"
+    },
+    "ending": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/ending"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S2"
+    },
+    "anchors": {
+      "type": "array",
+      "items": {
+        "$ref": "common.json#/$defs/anchor"
+      },
+      "x-stage": "S1"
+    },
+    "source": {
+      "$ref": "common.json#/$defs/source",
+      "x-stage": "L"
+    }
+  },
+  "required": [
+    "schema",
+    "job",
+    "lane",
+    "tenant",
+    "buyer",
+    "seller",
+    "seller_agent_key",
+    "seller_ids",
+    "evaluator",
+    "hook",
+    "evaluator_kind",
+    "task",
+    "required_skills",
+    "budget",
+    "funding",
+    "created_at",
+    "deadline",
+    "handshake_id",
+    "offer_nonce",
+    "state",
+    "ending",
+    "anchors",
+    "source"
+  ],
+  "additionalProperties": false
+}

package/workflows/0.2.15/schemas/job.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://www.taifoon.io/schemas/coordination/v1/job.json",
+  "title": "JOB — one job with everything known about it",
+  "description": "The unit a harvester emits and the judge reads: HIRE always; DELIVERY and FACTS whenever the source shows them; VERDICT, SETTLEMENT and the seller RECORD when known. HARVESTABLE.md is the minimum.",
+  "type": "object",
+  "properties": {
+    "schema": {
+      "const": "taifoon.job.v1",
+      "x-stage": "L",
+      "description": "which canonical entity this record is; fixed per schema"
+    },
+    "job_key": {
+      "$ref": "common.json#/$defs/job_key",
+      "x-stage": "L"
+    },
+    "hire": {
+      "$ref": "hire.json",
+      "x-stage": "S1"
+    },
+    "delivery": {
+      "anyOf": [
+        {
+          "$ref": "delivery.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1"
+    },
+    "facts": {
+      "anyOf": [
+        {
+          "$ref": "facts.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S4"
+    },
+    "verdict": {
+      "anyOf": [
+        {
+          "$ref": "verdict.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S5"
+    },
+    "settlement": {
+      "anyOf": [
+        {
+          "$ref": "settlement.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6"
+    },
+    "record": {
+      "anyOf": [
+        {
+          "$ref": "record.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S2"
+    }
+  },
+  "required": [
+    "schema",
+    "job_key",
+    "hire",
+    "delivery",
+    "facts",
+    "verdict",
+    "settlement",
+    "record"
+  ],
+  "additionalProperties": false
+}

package/workflows/0.2.15/schemas/settlement.json

@@ -0,0 +1,243 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://www.taifoon.io/schemas/coordination/v1/settlement.json",
+  "title": "SETTLEMENT — how the money moved",
+  "description": "One row per job, whichever path settled it (settle-records.ts): every transaction with its role and link, the on-chain ending in the hook’s words.",
+  "type": "object",
+  "properties": {
+    "schema": {
+      "const": "taifoon.settlement.v1",
+      "x-stage": "L",
+      "description": "which canonical entity this record is; fixed per schema"
+    },
+    "job": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/job_ref"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6"
+    },
+    "chain_id": {
+      "$ref": "common.json#/$defs/chain_id",
+      "x-stage": "S6"
+    },
+    "tenant": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S6"
+    },
+    "kind": {
+      "anyOf": [
+        {
+          "enum": [
+            "jev",
+            "agent",
+            "resource"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6"
+    },
+    "buyer": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6"
+    },
+    "seller": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6"
+    },
+    "price": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/uint_string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6"
+    },
+    "token": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6"
+    },
+    "verdict": {
+      "anyOf": [
+        {
+          "enum": [
+            "complete",
+            "reject",
+            "expire",
+            "cheat"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6"
+    },
+    "state": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/lifecycle_state"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "L"
+    },
+    "decision_id": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S5"
+    },
+    "jev_decision_id": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^decision-[0-9]+-[0-9a-f]+$",
+      "x-stage": "S5"
+    },
+    "operator_decision_id": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^opdec-[0-9a-f]{16}$",
+      "x-stage": "L"
+    },
+    "decided_by": {
+      "anyOf": [
+        {
+          "enum": [
+            "jev",
+            "loop-agent",
+            "operator"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "L"
+    },
+    "txs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "role": {
+            "type": "string"
+          },
+          "tx": {
+            "$ref": "common.json#/$defs/bytes32"
+          },
+          "link": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "role",
+          "tx",
+          "link"
+        ],
+        "additionalProperties": false
+      },
+      "x-stage": "S6"
+    },
+    "writer": {
+      "enum": [
+        "runner",
+        "relayer",
+        "evaluator-leg",
+        "keeper",
+        "site",
+        "n8n"
+      ],
+      "x-stage": "L"
+    },
+    "at": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/unix_s"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "L"
+    },
+    "anchors": {
+      "type": "array",
+      "items": {
+        "$ref": "common.json#/$defs/anchor"
+      },
+      "x-stage": "S6"
+    },
+    "source": {
+      "$ref": "common.json#/$defs/source",
+      "x-stage": "L"
+    }
+  },
+  "required": [
+    "schema",
+    "job",
+    "chain_id",
+    "tenant",
+    "kind",
+    "buyer",
+    "seller",
+    "price",
+    "token",
+    "verdict",
+    "state",
+    "decision_id",
+    "jev_decision_id",
+    "operator_decision_id",
+    "decided_by",
+    "txs",
+    "writer",
+    "at",
+    "anchors",
+    "source"
+  ],
+  "additionalProperties": false
+}