@taifoon/jev 0.1.0

package/workflows/0.1.0/schemas/hire.json

@@ -0,0 +1,337 @@
+{
+  "$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",
+      "x-source": "this contract",
+      "description": "which canonical entity this record is; fixed per schema"
+    },
+    "job": {
+      "$ref": "common.json#/$defs/job_ref",
+      "x-stage": "S1",
+      "x-source": "JobCreated.jobId / JobManager id / hook bytes32 / handshake id (src/ids.ts)"
+    },
+    "lane": {
+      "$ref": "common.json#/$defs/lane",
+      "x-stage": "S2",
+      "x-source": "observatory source (erc8183 | memo-acp | hook, + deployment for extra) or handshake"
+    },
+    "tenant": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S2",
+      "x-source": "observatory tenant for hook jobs (layer | moonbeam)"
+    },
+    "buyer": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1",
+      "x-source": "JobCreated.client / hook JobFunded.buyer / handshake hirer / §2 offer client"
+    },
+    "seller": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1",
+      "x-source": "JobCreated.provider (ProviderSet on extra) / hook seller / handshake candidate.address"
+    },
+    "seller_agent_key": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/agent_key"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S9",
+      "x-source": "the provider → ERC-8004 join: extra provider_agent_id, handshake candidate.agentId; null when nothing joins them (the missing seam)"
+    },
+    "seller_ids": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "scheme": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "scheme",
+          "id"
+        ],
+        "additionalProperties": false
+      },
+      "x-stage": "S1",
+      "x-source": "every other id the source names for the seller: bitagent ProviderSet agentId (not an ERC-8004 id), handshake candidate agentId"
+    },
+    "evaluator": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1",
+      "x-source": "JobCreated.evaluator (null for hook jobs: the buyer or the hook’s evaluators decide)"
+    },
+    "hook": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1",
+      "x-source": "JobCreated.hook (ERC-8183 hook contract; null when zero) / the assurance hook itself on the hook lane"
+    },
+    "evaluator_kind": {
+      "anyOf": [
+        {
+          "enum": [
+            "buyer",
+            "none",
+            "named",
+            "platform",
+            "hook"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S2",
+      "x-source": "observatory evaluator_kind; hook = the assurance hook’s buyer/evaluator set"
+    },
+    "task": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S2",
+      "x-source": "getJob(id).description (tasks.json) / memo-ACP first REQUEST memo / handshake task / §2 offer task"
+    },
+    "required_skills": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "x-stage": "L",
+      "x-source": "handshake / offer required_skills"
+    },
+    "budget": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/amount"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1",
+      "x-source": "JobFunded.amount (else BudgetSet / getJob word 6) in the job token; handshake budget_usdc"
+    },
+    "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",
+      "x-source": "hook JobFunded(price, premium, deposit, pool) + JobCovered.coverCap + jobs(jobId).deadline; ERC-8183 JobFunded.amount as price"
+    },
+    "created_at": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/unix_s"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1",
+      "x-source": "JobCreated block ts / handshake createdAt"
+    },
+    "deadline": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/unix_s"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1",
+      "x-source": "JobCreated.expiredAt / hook deadline"
+    },
+    "handshake_id": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^hs_[0-9a-f]{24}$",
+      "x-stage": "L",
+      "x-source": "the broker’s handshake this job was offered under"
+    },
+    "offer_nonce": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S7",
+      "x-source": "§2 offer nonce the seller must echo (n8n.webhook class DET)"
+    },
+    "state": {
+      "$ref": "common.json#/$defs/lifecycle_state",
+      "x-stage": "L",
+      "x-source": "machine state (src/machine.ts) derived from the events / hook state / memo phase / handshake state"
+    },
+    "ending": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/ending"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S2",
+      "x-source": "observatory ending, null for a handshake"
+    },
+    "anchors": {
+      "type": "array",
+      "items": {
+        "$ref": "common.json#/$defs/anchor"
+      },
+      "x-stage": "S1",
+      "x-source": "JobCreated / JobFunded transactions; the handshake row"
+    },
+    "source": {
+      "$ref": "common.json#/$defs/source",
+      "x-stage": "L",
+      "x-source": "the mapper"
+    }
+  },
+  "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.1.0/schemas/job.json

@@ -0,0 +1,96 @@
+{
+  "$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",
+      "x-source": "this contract",
+      "description": "which canonical entity this record is; fixed per schema"
+    },
+    "job_key": {
+      "$ref": "common.json#/$defs/job_key",
+      "x-stage": "L",
+      "x-source": "hire.job.key"
+    },
+    "hire": {
+      "$ref": "hire.json",
+      "x-stage": "S1",
+      "x-source": "HIRE"
+    },
+    "delivery": {
+      "anyOf": [
+        {
+          "$ref": "delivery.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S1",
+      "x-source": "DELIVERY"
+    },
+    "facts": {
+      "anyOf": [
+        {
+          "$ref": "facts.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S4",
+      "x-source": "FACTS"
+    },
+    "verdict": {
+      "anyOf": [
+        {
+          "$ref": "verdict.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S5",
+      "x-source": "VERDICT"
+    },
+    "settlement": {
+      "anyOf": [
+        {
+          "$ref": "settlement.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6",
+      "x-source": "SETTLEMENT"
+    },
+    "record": {
+      "anyOf": [
+        {
+          "$ref": "record.json"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S2",
+      "x-source": "the seller RECORD at read time"
+    }
+  },
+  "required": [
+    "schema",
+    "job_key",
+    "hire",
+    "delivery",
+    "facts",
+    "verdict",
+    "settlement",
+    "record"
+  ],
+  "additionalProperties": false
+}

package/workflows/0.1.0/schemas/settlement.json

@@ -0,0 +1,225 @@
+{
+  "$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",
+      "x-source": "this contract",
+      "description": "which canonical entity this record is; fixed per schema"
+    },
+    "job": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/job_ref"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6",
+      "x-source": "settle:<jobId>; null when a runner row names no job id"
+    },
+    "chain_id": {
+      "$ref": "common.json#/$defs/chain_id",
+      "x-stage": "S6",
+      "x-source": "settlement chain"
+    },
+    "tenant": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S6",
+      "x-source": "moonbeam | null (layer)"
+    },
+    "kind": {
+      "anyOf": [
+        {
+          "enum": [
+            "jev",
+            "agent",
+            "resource"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6",
+      "x-source": "settle.ts kind (runner rows)"
+    },
+    "buyer": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6",
+      "x-source": "hook buyer"
+    },
+    "seller": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6",
+      "x-source": "hook seller"
+    },
+    "price": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/uint_string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6",
+      "x-source": "price in the token’s smallest unit"
+    },
+    "token": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/address"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6",
+      "x-source": "job token"
+    },
+    "verdict": {
+      "anyOf": [
+        {
+          "enum": [
+            "complete",
+            "reject",
+            "expire",
+            "cheat"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "S6",
+      "x-source": "settle-records verdictOfState"
+    },
+    "state": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/lifecycle_state"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "L",
+      "x-source": "the terminal machine state the verdict word names"
+    },
+    "decision_id": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "x-stage": "S5",
+      "x-source": "the decision that drove it, when recorded"
+    },
+    "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",
+      "x-source": "every transaction, unioned by hash"
+    },
+    "writer": {
+      "enum": [
+        "runner",
+        "relayer",
+        "evaluator-leg",
+        "site",
+        "n8n"
+      ],
+      "x-stage": "L",
+      "x-source": "which write path recorded it (n8n = a workflow that signed its own legs, e.g. the devnet signer)"
+    },
+    "at": {
+      "anyOf": [
+        {
+          "$ref": "common.json#/$defs/unix_s"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "x-stage": "L",
+      "x-source": "first write"
+    },
+    "anchors": {
+      "type": "array",
+      "items": {
+        "$ref": "common.json#/$defs/anchor"
+      },
+      "x-stage": "S6",
+      "x-source": "the settlement transactions"
+    },
+    "source": {
+      "$ref": "common.json#/$defs/source",
+      "x-stage": "L",
+      "x-source": "the mapper"
+    }
+  },
+  "required": [
+    "schema",
+    "job",
+    "chain_id",
+    "tenant",
+    "kind",
+    "buyer",
+    "seller",
+    "price",
+    "token",
+    "verdict",
+    "state",
+    "decision_id",
+    "txs",
+    "writer",
+    "at",
+    "anchors",
+    "source"
+  ],
+  "additionalProperties": false
+}