@ixo/topic-protocol 0.8.0 → 1.0.0-rc.1

package/recipes/agent-delivery.json

@@ -0,0 +1,607 @@
+{
+  "version": 1,
+  "code": "agent-delivery",
+  "id": "https://topic-protocol.ixo.world/recipes/agent-delivery",
+  "recipeVersion": "1.0.0-rc.1",
+  "label": "Agent delivery",
+  "description": "Commission agent work, review its delivery, and explicitly confirm any external Action.",
+  "baseRecipe": "flow",
+  "creates": "draft",
+  "shape": {
+    "version": 1,
+    "code": "recipe/agent-delivery",
+    "axes": [
+      {
+        "code": "contract",
+        "phase": "forming",
+        "required": true,
+        "initialState": "draft",
+        "states": [
+          {
+            "code": "draft"
+          },
+          {
+            "code": "accepted",
+            "terminal": true
+          }
+        ]
+      },
+      {
+        "code": "work",
+        "phase": "working",
+        "required": true,
+        "initialState": "pending",
+        "states": [
+          {
+            "code": "pending"
+          },
+          {
+            "code": "in-progress"
+          },
+          {
+            "code": "submitted",
+            "terminal": true
+          }
+        ]
+      },
+      {
+        "code": "verification",
+        "phase": "verifying",
+        "required": true,
+        "initialState": "pending",
+        "states": [
+          {
+            "code": "pending"
+          },
+          {
+            "code": "verified",
+            "terminal": true
+          }
+        ]
+      },
+      {
+        "code": "decision",
+        "phase": "deciding",
+        "required": true,
+        "initialState": "pending",
+        "states": [
+          {
+            "code": "pending"
+          },
+          {
+            "code": "approved",
+            "terminal": true
+          }
+        ]
+      },
+      {
+        "code": "effect",
+        "phase": "effecting",
+        "required": true,
+        "initialState": "pending",
+        "states": [
+          {
+            "code": "pending"
+          },
+          {
+            "code": "requested"
+          },
+          {
+            "code": "confirmed",
+            "terminal": true
+          }
+        ]
+      },
+      {
+        "code": "topic",
+        "phase": "complete",
+        "required": true,
+        "initialState": "open",
+        "states": [
+          {
+            "code": "open"
+          },
+          {
+            "code": "complete",
+            "terminal": true
+          }
+        ]
+      }
+    ],
+    "transitions": [
+      {
+        "code": "edit-terms",
+        "phase": "forming",
+        "predecessor": {
+          "axis": "contract",
+          "state": "draft"
+        },
+        "target": {
+          "axis": "contract",
+          "state": "draft"
+        },
+        "command": "topic.edit-terms",
+        "requiredAbility": "topic/write",
+        "assignedTo": {
+          "kind": "role",
+          "value": "contract-acceptor"
+        },
+        "gates": [],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "update-contract"
+        },
+        "presentation": {
+          "reasonCode": "terms-need-input"
+        }
+      },
+      {
+        "code": "accept-terms",
+        "phase": "forming",
+        "predecessor": {
+          "axis": "contract",
+          "state": "draft"
+        },
+        "target": {
+          "axis": "contract",
+          "state": "accepted"
+        },
+        "command": "topic.accept-terms",
+        "requiredAbility": "topic/accept-contract",
+        "assignedTo": {
+          "kind": "role",
+          "value": "contract-acceptor"
+        },
+        "gates": [],
+        "confirmation": "viewer",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "accept-contract"
+        },
+        "presentation": {
+          "reasonCode": "terms-await-acceptance"
+        }
+      },
+      {
+        "code": "start-work",
+        "phase": "working",
+        "predecessor": {
+          "axis": "work",
+          "state": "pending"
+        },
+        "target": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "command": "topic.start-work",
+        "requiredAbility": "topic/write",
+        "assignedTo": {
+          "kind": "role",
+          "value": "worker"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "contract",
+            "states": [
+              "accepted"
+            ]
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "change-progress"
+        },
+        "presentation": {
+          "reasonCode": "start-work"
+        }
+      },
+      {
+        "code": "answer-question",
+        "phase": "working",
+        "predecessor": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "target": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "command": "topic.answer-question",
+        "requiredAbility": "topic/write",
+        "assignedTo": {
+          "kind": "role",
+          "value": "worker"
+        },
+        "gates": [
+          {
+            "kind": "field",
+            "path": "/questions/open",
+            "predicate": "present"
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "answer-question"
+        },
+        "presentation": {
+          "reasonCode": "question-awaits-answer"
+        }
+      },
+      {
+        "code": "change-due-date",
+        "phase": "working",
+        "predecessor": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "target": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "command": "topic.change-due-date",
+        "requiredAbility": "topic/write",
+        "assignedTo": {
+          "kind": "role",
+          "value": "worker"
+        },
+        "gates": [
+          {
+            "kind": "field",
+            "path": "/outcome/target/value",
+            "predicate": "present"
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "change-due-date"
+        },
+        "presentation": {
+          "reasonCode": "due-date-review"
+        }
+      },
+      {
+        "code": "unblock-topic",
+        "phase": "working",
+        "predecessor": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "target": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "command": "topic.unblock",
+        "requiredAbility": "topic/unblock",
+        "assignedTo": {
+          "kind": "role",
+          "value": "block-resolver"
+        },
+        "gates": [
+          {
+            "kind": "condition",
+            "states": [
+              "blocked"
+            ]
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "unblock-topic"
+        },
+        "presentation": {
+          "reasonCode": "topic-blocked"
+        }
+      },
+      {
+        "code": "submit-work",
+        "phase": "working",
+        "predecessor": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "target": {
+          "axis": "work",
+          "state": "submitted"
+        },
+        "command": "topic.record-outcome",
+        "requiredAbility": "topic/record-outcome",
+        "assignedTo": {
+          "kind": "role",
+          "value": "worker"
+        },
+        "gates": [],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "record",
+          "type": "ixo.topic.work-submission",
+          "finality": "accepted"
+        },
+        "presentation": {
+          "reasonCode": "submit-work"
+        }
+      },
+      {
+        "code": "complete-topic",
+        "phase": "complete",
+        "predecessor": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "target": {
+          "axis": "topic",
+          "state": "complete"
+        },
+        "command": "topic.complete",
+        "requiredAbility": "topic/confirm-completion",
+        "assignedTo": {
+          "kind": "role",
+          "value": "completion-authority"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "work",
+            "states": [
+              "submitted"
+            ]
+          }
+        ],
+        "confirmation": "authority",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "complete-topic"
+        },
+        "completesTopic": true,
+        "presentation": {
+          "reasonCode": "complete-topic"
+        }
+      },
+      {
+        "code": "record-verification",
+        "phase": "verifying",
+        "predecessor": {
+          "axis": "verification",
+          "state": "pending"
+        },
+        "target": {
+          "axis": "verification",
+          "state": "verified"
+        },
+        "command": "topic.record-verification",
+        "requiredAbility": "claim/evaluate",
+        "assignedTo": {
+          "kind": "role",
+          "value": "evaluator"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "work",
+            "states": [
+              "submitted"
+            ]
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "record",
+          "type": "ixo.evaluation",
+          "finality": "accepted"
+        },
+        "handoff": {
+          "kind": "flow",
+          "binding": "evaluation"
+        },
+        "presentation": {
+          "reasonCode": "verification-required"
+        }
+      },
+      {
+        "code": "record-decision",
+        "phase": "deciding",
+        "predecessor": {
+          "axis": "decision",
+          "state": "pending"
+        },
+        "target": {
+          "axis": "decision",
+          "state": "approved"
+        },
+        "command": "topic.record-decision",
+        "requiredAbility": "claim/decide",
+        "assignedTo": {
+          "kind": "role",
+          "value": "decision-authority"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "verification",
+            "states": [
+              "verified"
+            ]
+          }
+        ],
+        "confirmation": "authority",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "record",
+          "type": "ixo.decision",
+          "finality": "accepted"
+        },
+        "presentation": {
+          "reasonCode": "decision-required"
+        }
+      },
+      {
+        "code": "request-action",
+        "phase": "effecting",
+        "predecessor": {
+          "axis": "effect",
+          "state": "pending"
+        },
+        "target": {
+          "axis": "effect",
+          "state": "requested"
+        },
+        "command": "topic.request-action",
+        "requiredAbility": "topic/request-action",
+        "assignedTo": {
+          "kind": "role",
+          "value": "action-requester"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "decision",
+            "states": [
+              "approved"
+            ]
+          },
+          {
+            "kind": "binding",
+            "type": "flow"
+          }
+        ],
+        "confirmation": "viewer",
+        "consequence": "external-effect",
+        "evidence": {
+          "kind": "operation",
+          "type": "request-action"
+        },
+        "handoff": {
+          "kind": "flow",
+          "binding": "action"
+        },
+        "presentation": {
+          "reasonCode": "action-request-required"
+        }
+      },
+      {
+        "code": "confirm-action",
+        "phase": "effecting",
+        "predecessor": {
+          "axis": "effect",
+          "state": "requested"
+        },
+        "target": {
+          "axis": "effect",
+          "state": "confirmed"
+        },
+        "command": "topic.confirm-action",
+        "requiredAbility": "topic/record-action",
+        "assignedTo": {
+          "kind": "role",
+          "value": "action-confirmer"
+        },
+        "gates": [],
+        "confirmation": "authority",
+        "consequence": "external-effect",
+        "evidence": {
+          "kind": "receipt",
+          "type": "ixo.action-receipt",
+          "finality": "final"
+        },
+        "handoff": {
+          "kind": "flow",
+          "binding": "action"
+        },
+        "presentation": {
+          "reasonCode": "action-confirmation-required"
+        }
+      }
+    ],
+    "progressRules": [
+      {
+        "code": "disputed",
+        "condition": "disputed",
+        "priority": 700,
+        "source": {
+          "kind": "record",
+          "value": "ixo.topic.dispute"
+        }
+      },
+      {
+        "code": "failed",
+        "condition": "failed",
+        "priority": 650,
+        "source": {
+          "kind": "receipt",
+          "value": "failed"
+        }
+      },
+      {
+        "code": "blocked",
+        "condition": "blocked",
+        "priority": 600,
+        "source": {
+          "kind": "topic",
+          "value": "blocked"
+        },
+        "requiresTarget": true
+      },
+      {
+        "code": "waiting",
+        "condition": "waiting",
+        "priority": 500,
+        "source": {
+          "kind": "topic",
+          "value": "waiting"
+        },
+        "requiresTarget": true
+      },
+      {
+        "code": "needs-input",
+        "condition": "needs-input",
+        "priority": 400,
+        "source": {
+          "kind": "record",
+          "value": "ixo.topic.question"
+        }
+      },
+      {
+        "code": "needs-acceptance",
+        "condition": "needs-acceptance",
+        "priority": 350,
+        "source": {
+          "kind": "axis",
+          "value": "contract"
+        },
+        "states": [
+          "draft"
+        ]
+      }
+    ],
+    "inferredRecordPolicy": {
+      "autoAccept": [
+        "ixo.topic.fact",
+        "ixo.topic.summary",
+        "ixo.topic.classification"
+      ],
+      "neverAutoAccept": [
+        "ixo.topic.contract",
+        "ixo.topic.outcome",
+        "ixo.topic.authority",
+        "ixo.topic.action",
+        "ixo.claim",
+        "ixo.evaluation",
+        "ixo.settlement"
+      ]
+    }
+  }
+}

package/recipes/registry.json

@@ -0,0 +1,41 @@
+{
+  "version": 1,
+  "recipes": [
+    {
+      "code": "research-brief",
+      "label": "Research brief",
+      "description": "Frame a question, do the research, verify the sources, and close the brief explicitly.",
+      "baseRecipe": "research",
+      "creates": "draft",
+      "ref": {
+        "id": "https://topic-protocol.ixo.world/recipes/research-brief",
+        "version": "1.0.0-rc.1",
+        "digest": "sha256:deae09bfdc76592fdc749d1c2d893b972acaca1dcbbeb4677e7cf4b7da8d1878"
+      }
+    },
+    {
+      "code": "agent-delivery",
+      "label": "Agent delivery",
+      "description": "Commission agent work, review its delivery, and explicitly confirm any external Action.",
+      "baseRecipe": "flow",
+      "creates": "draft",
+      "ref": {
+        "id": "https://topic-protocol.ixo.world/recipes/agent-delivery",
+        "version": "1.0.0-rc.1",
+        "digest": "sha256:5d92d85cd9a6aeef0d4d0c89588412328ad98ca111f1f58d78dee6c98b2a14a0"
+      }
+    },
+    {
+      "code": "verified-work-payment",
+      "label": "Verified work payment",
+      "description": "Bind one entity and claim collection, verify work, decide, execute through Flow, and observe settlement finality.",
+      "baseRecipe": "claims",
+      "creates": "draft",
+      "ref": {
+        "id": "https://topic-protocol.ixo.world/recipes/verified-work-payment",
+        "version": "1.0.0-rc.1",
+        "digest": "sha256:ce7401ed4f2d94c536108fd1ff35b79d68be9a3df42edb73800f480a415ce77c"
+      }
+    }
+  ]
+}