@wowok/agent-mcp 2.6.3 → 2.6.6

package/dist/examples/machine-multisig-threshold.json

@@ -0,0 +1,86 @@
+{
+  "title": "Machine Template: 2-of-3 Multi-Sig Approval Workflow (threshold > 1)",
+  "description": "Four-node workflow where the 'approved' node requires cumulative weight 2 from three distinct approver forwards (permissionIndex 1001/1002/1003, weight 1 each) — the on-chain multi-signature approval pattern.",
+  "tags": ["machine", "template", "multisig", "threshold", "approval", "governance"],
+  "industry": "general",
+  "operation_type": "machine",
+  "source": "constructed under T-09 authorization; grounded in MachineNodePairSchema threshold + MachineForwardSchema weight — schema-validated, not chain-verified",
+  "verified": false,
+  "network": "testnet",
+  "call": {
+    "tool": "onchain_operations",
+    "operation_type": "machine",
+    "data": {
+      "object": {
+        "name": "multisig_approval_machine"
+      },
+      "node": {
+        "op": "add",
+        "bReplace": true,
+        "nodes": [
+          {
+            "name": "submitted",
+            "pairs": [
+              {
+                "prev_node": "",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Submit", "weight": 1, "namedOperator": "" }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "under_review",
+            "pairs": [
+              {
+                "prev_node": "submitted",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Start Review", "weight": 1, "permissionIndex": 1000 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "approved",
+            "pairs": [
+              {
+                "prev_node": "under_review",
+                "threshold": 2,
+                "forwards": [
+                  { "name": "Approve Alice", "weight": 1, "permissionIndex": 1001 },
+                  { "name": "Approve Bob", "weight": 1, "permissionIndex": 1002 },
+                  { "name": "Approve Carol", "weight": 1, "permissionIndex": 1003 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "completed",
+            "pairs": [
+              {
+                "prev_node": "approved",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Finalize", "weight": 1, "permissionIndex": 1000 }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    },
+    "env": {
+      "network": "testnet"
+    }
+  },
+  "notes": [
+    "MULTI-SIG MECHANICS: pair threshold=2 means Progress advances from 'under_review' to 'approved' only when the CUMULATIVE weight of completed DISTINCT forwards on that pair reaches 2. Each of the three approver forwards contributes weight 1, so any 2 of the 3 approvers must act — a 2-of-3 signature scheme.",
+    "Each approver calls progress operate with their OWN forward name (e.g. 'Approve Alice'). The same forward cannot be double-counted; distinct forwards by the same operator would still count separately, so map each forward to a distinct permissionIndex (1001/1002/1003 = three approver roles in the Permission table).",
+    "threshold semantics (MachineNodePairSchema): 'If total Forward weight is greater than or equal to threshold, node advancement is triggered.' Weighted variants are possible — e.g. give a senior approver weight 2 so they can approve alone (threshold 2 met by one forward).",
+    "Entry-node rule: 'submitted' has prev_node='' with at least one forward (schema-enforced FIX-002). namedOperator='' = order owner; permissionIndex references Permission table entries.",
+    "Compare with machine-template-7node-rental.json where every pair uses threshold 1 (single-signature sequential flow).",
+    "This Machine is a TEMPLATE object: bind it to a Service and each order gets a Progress instance whose multi-sig approvals are tracked per order."
+  ]
+}

package/dist/examples/machine-template-7node-rental.json

@@ -1,11 +1,12 @@
 {
-  "title": "Machine Template: 7-Node Rental Workflow (Simplified)",
-  "description": "Simplified rental workflow without damage/arbitration paths",
-  "tags": ["machine", "template", "rental", "simplified"],
+  "title": "Machine Template: 7-Node Rental Workflow (Simplified, R-M1-11 Compliant)",
+  "description": "Simplified rental workflow without damage/arbitration paths. Refund flows through an Allocator triggered by the return_approved routing node — never through a Machine terminal node.",
+  "tags": ["machine", "template", "rental", "simplified", "r-m1-11"],
   "industry": "rental",
   "operation_type": "machine",
   "source": "template",
   "verified": true,
+  "network": "testnet",
   "call": {
     "tool": "onchain_operations",
     "operation_type": "machine",
@@ -13,102 +14,106 @@
       "object": {
         "name": "rental_machine_simple"
       },
-      "nodes": [
-        {
-          "name": "reserved",
-          "pairs": [
-            {
-              "prev_node": "",
-              "threshold": 0,
-              "forwards": [
-                {
-                  "name": "Pay",
-                  "weight": 1,
-                  "namedOperator": "",
-                  "permissionIndex": null
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "paid",
-          "pairs": [
-            {
-              "prev_node": "reserved",
-              "threshold": 1,
-              "forwards": [
-                {
-                  "name": "Deliver",
-                  "weight": 1,
-                  "namedOperator": null,
-                  "permissionIndex": 1000
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "in_use",
-          "pairs": [
-            {
-              "prev_node": "paid",
-              "threshold": 1,
-              "forwards": [
-                {
-                  "name": "Return",
-                  "weight": 1,
-                  "namedOperator": "",
-                  "permissionIndex": null
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "returned",
-          "pairs": [
-            {
-              "prev_node": "in_use",
-              "threshold": 1,
-              "forwards": [
-                {
-                  "name": "Inspect",
-                  "weight": 1,
-                  "namedOperator": null,
-                  "permissionIndex": 1001
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "inspected",
-          "pairs": [
-            {
-              "prev_node": "returned",
-              "threshold": 1,
-              "forwards": [
-                {
-                  "name": "Refund",
-                  "weight": 1,
-                  "namedOperator": null,
-                  "permissionIndex": 1002
-                }
-              ]
-            }
-          ]
-        },
-        { "name": "refunded", "pairs": [] },
-        { "name": "completed", "pairs": [] }
-      ]
+      "node": {
+        "op": "add",
+        "bReplace": true,
+        "nodes": [
+          {
+            "name": "reserved",
+            "pairs": [
+              {
+                "prev_node": "",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Pay", "weight": 1, "namedOperator": "" }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "paid",
+            "pairs": [
+              {
+                "prev_node": "reserved",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Confirm Payment", "weight": 1, "permissionIndex": 1000 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "in_use",
+            "pairs": [
+              {
+                "prev_node": "paid",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Deliver Item", "weight": 1, "permissionIndex": 1000 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "returned",
+            "pairs": [
+              {
+                "prev_node": "in_use",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Return Item", "weight": 1, "namedOperator": "" }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "inspected",
+            "pairs": [
+              {
+                "prev_node": "returned",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Inspect", "weight": 1, "permissionIndex": 1001 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "return_approved",
+            "pairs": [
+              {
+                "prev_node": "inspected",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Approve Return", "weight": 1, "permissionIndex": 1002 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "completed",
+            "pairs": [
+              {
+                "prev_node": "return_approved",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Complete", "weight": 1, "permissionIndex": 1000 }
+                ]
+              }
+            ]
+          }
+        ]
+      }
     },
     "env": {
       "network": "testnet"
     }
   },
   "notes": [
-    "Simplified version — no damage or arbitration paths",
-    "Use for short-term rentals without damage risk"
+    "R-M1-11: 'return_approved' is a ROUTING node — the actual refund MUST be executed by an Allocator (bound via Service.order_allocators) whose Guard checks progress.current == 'return_approved'. A node named 'refunded' implies the Machine itself moves funds, which Machines cannot do; funds would lock in the Order escrow.",
+    "Forwards describe INCOMING transitions: the forward in a node's pair (prev_node='X') is the action that advances Progress FROM X INTO this node.",
+    "The entry node (prev_node='') MUST have at least one forward — schema-enforced (FIX-002).",
+    "namedOperator='' means OrderHolder (customer). permissionIndex references Permission table entries (1000=operator, 1001=inspector, 1002=finance).",
+    "Simplified version — no damage or arbitration paths. Use for short-term rentals without damage risk."
   ]
 }

package/dist/examples/payment-scenario-bound.json

@@ -0,0 +1,45 @@
+{
+  "title": "Create Scenario-Bound Payment (for_object + for_guard)",
+  "description": "Create a Payment of 0.05 WOW to alice whose payment_info binds it to a Demand object and a KYC Guard, making the fund flow auditable against a business scenario.",
+  "tags": ["payment", "scenario", "for_object", "for_guard", "audit"],
+  "industry": "general",
+  "operation_type": "payment",
+  "source": "constructed under T-09 authorization; grounded in CallPayment_CreateSchema + PaymentInfoSchema — schema-validated, not chain-verified",
+  "verified": false,
+  "network": "testnet",
+  "call": {
+    "tool": "onchain_operations",
+    "operation_type": "payment",
+    "data": {
+      "object": {
+        "name": "kyc_bounty_payment_v1",
+        "type_parameter": "0x2::wow::WOW"
+      },
+      "revenue": [
+        {
+          "recipient": { "name_or_address": "alice" },
+          "amount": { "balance": 50000000 }
+        }
+      ],
+      "info": {
+        "for_object": "toy_repair_demand_v1",
+        "for_guard": "kyc_level_guard",
+        "remark": "Bounty payout for completed KYC verification demand",
+        "index": 0
+      }
+    },
+    "env": {
+      "network": "testnet",
+      "no_cache": true,
+      "confirmed": true
+    }
+  },
+  "notes": [
+    "SCENARIO BINDING: info.for_object ties the Payment to a business object (here the Demand it settles); info.for_guard ties it to the Guard whose verification justified the payout (here the KYC Guard). Both are optional but together make the payment self-describing on-chain — auditors can trace WHY the money moved.",
+    "Payment is IMMUTABLE once created: it can only be created, never modified. revenue[] is the full recipient/amount split in one shot (single recipient here; multiple entries split the total).",
+    "amount uses CoinParam {balance: <smallest unit>} — 50000000 = 0.05 WOW (9 decimals). recipient is AccountOrMark_Address OBJECT form {name_or_address}.",
+    "info.remark and info.index are REQUIRED (PaymentInfoSchema); index numbers the payment record for later reference by fees_transfer-style operations.",
+    "The OTHER payment mode (not shown): {object: '<coinwrapper_id>', receive: true, type_parameter: '0x2::wow::WOW'} unwraps a CoinWrapper received from an Allocation split into spendable coins — see CallPayment_ReceiveSchema and the allocation-activate example for the full flow.",
+    "type_parameter goes INSIDE 'object' (TypeNamedObjectSchema) and must match the coin being paid."
+  ]
+}

package/dist/examples/rental-ziroom-machine-create.json

@@ -1,10 +1,10 @@
 {
-  "title": "Create 10-node Machine for Rental Lifecycle (Ziroom)",
-  "description": "10-node workflow: reserved → paid_deposit → in_use → returned → inspected → deposit_refunded/damage_confirmed/arbiter_rule",
-  "tags": ["machine", "rental", "workflow", "nodes", "permission_index"],
+  "title": "Create 9-Node Machine for Rental Lifecycle (Ziroom, R-M1-11 Compliant)",
+  "description": "9-node workflow: reserved → paid_deposit → in_use → returned → inspected, then three competing routing branches: return_approved (refund Allocator fires) / damage_confirmed (deduction Allocator fires) / arbiter_rule (off-Machine arbitration). completed follows return_approved.",
+  "tags": ["machine", "rental", "workflow", "nodes", "permission_index", "r-m1-11"],
   "industry": "rental",
   "operation_type": "machine",
-  "source": "ziroom testnet deployment 2026-07-29",
+  "source": "ziroom testnet deployment 2026-07-29 (repaired to current schema + R-M1-11)",
   "verified": true,
   "network": "testnet",
   "call": {
@@ -14,114 +14,123 @@
       "object": {
         "name": "ziroom_machine_v1",
         "tags": ["rental", "machine"],
-        "replaceExistName": true
+        "replaceExistName": true,
+        "permission": "ziroom_permission_v1"
       },
-      "permission": "ziroom_permission_v1",
-      "nodes": [
-        {
-          "name": "reserved",
-          "pairs": [
-            {
-              "prev_node": "",
-              "threshold": 0,
-              "forwards": [
-                {
-                  "name": "Pay Deposit",
-                  "weight": 1,
-                  "namedOperator": "",
-                  "permissionIndex": null
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "paid_deposit",
-          "pairs": [
-            {
-              "prev_node": "reserved",
-              "threshold": 1,
-              "forwards": [
-                {
-                  "name": "Handover",
-                  "weight": 1,
-                  "namedOperator": null,
-                  "permissionIndex": 1000
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "in_use",
-          "pairs": [
-            {
-              "prev_node": "paid_deposit",
-              "threshold": 1,
-              "forwards": [
-                {
-                  "name": "Return Keys",
-                  "weight": 1,
-                  "namedOperator": "",
-                  "permissionIndex": null
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "returned",
-          "pairs": [
-            {
-              "prev_node": "in_use",
-              "threshold": 1,
-              "forwards": [
-                {
-                  "name": "Inspect",
-                  "weight": 1,
-                  "namedOperator": null,
-                  "permissionIndex": 1001
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "inspected",
-          "pairs": [
-            {
-              "prev_node": "returned",
-              "threshold": 1,
-              "forwards": [
-                { "name": "Refund Deposit", "weight": 1, "namedOperator": null, "permissionIndex": 1002 },
-                { "name": "Confirm Damage", "weight": 1, "namedOperator": null, "permissionIndex": 1001 },
-                { "name": "Escalate Arbitration", "weight": 1, "namedOperator": null, "permissionIndex": 1500 }
-              ]
-            }
-          ]
-        },
-        { "name": "deposit_refunded", "pairs": [] },
-        { "name": "completed", "pairs": [] },
-        {
-          "name": "damage_confirmed",
-          "pairs": [
-            {
-              "prev_node": "inspected",
-              "threshold": 1,
-              "forwards": [
-                {
-                  "name": "Deduct Deposit",
-                  "weight": 1,
-                  "namedOperator": null,
-                  "permissionIndex": 1002
-                }
-              ]
-            }
-          ]
-        },
-        { "name": "deposit_deducted", "pairs": [] },
-        { "name": "arbiter_rule", "pairs": [] }
-      ]
+      "node": {
+        "op": "add",
+        "bReplace": true,
+        "nodes": [
+          {
+            "name": "reserved",
+            "pairs": [
+              {
+                "prev_node": "",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Reserve", "weight": 1, "namedOperator": "" }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "paid_deposit",
+            "pairs": [
+              {
+                "prev_node": "reserved",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Pay Deposit", "weight": 1, "namedOperator": "" }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "in_use",
+            "pairs": [
+              {
+                "prev_node": "paid_deposit",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Handover", "weight": 1, "permissionIndex": 1000 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "returned",
+            "pairs": [
+              {
+                "prev_node": "in_use",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Return Keys", "weight": 1, "namedOperator": "" }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "inspected",
+            "pairs": [
+              {
+                "prev_node": "returned",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Inspect", "weight": 1, "permissionIndex": 1001 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "return_approved",
+            "pairs": [
+              {
+                "prev_node": "inspected",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Approve Refund", "weight": 1, "permissionIndex": 1002 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "damage_confirmed",
+            "pairs": [
+              {
+                "prev_node": "inspected",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Confirm Damage", "weight": 1, "permissionIndex": 1001 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "arbiter_rule",
+            "pairs": [
+              {
+                "prev_node": "inspected",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Escalate Arbitration", "weight": 1, "permissionIndex": 1500 }
+                ]
+              }
+            ]
+          },
+          {
+            "name": "completed",
+            "pairs": [
+              {
+                "prev_node": "return_approved",
+                "threshold": 1,
+                "forwards": [
+                  { "name": "Complete", "weight": 1, "permissionIndex": 1000 }
+                ]
+              }
+            ]
+          }
+        ]
+      }
     },
     "env": {
       "network": "testnet",
@@ -130,8 +139,11 @@
     }
   },
   "notes": [
-    "namedOperator='' means OrderHolder (customer), NOT 'anyone'",
-    "permissionIndex maps to Permission table entries (1000=operator, 1001=inspector, 1002=finance, 1500=arbiter)",
-    "Machine nodes are immutable after publish — create new Machine to change workflow"
+    "R-M1-11: return_approved / damage_confirmed / arbiter_rule are ROUTING nodes. Fund movement (deposit refund / deduction) MUST be executed by Allocators (Service.order_allocators) whose Guards check progress.current == <routing node>. Never name nodes 'deposit_refunded'/'deposit_deducted'/'refunded' — Machines have no fund movement primitive; misnamed nodes leave funds locked in the Order escrow.",
+    "The three branches from 'inspected' are competing pairs (each threshold=1): the first forward executed wins and the other branches are abandoned for this session.",
+    "Forwards describe INCOMING transitions: a forward in a node's pair (prev_node='X') advances Progress FROM X INTO this node.",
+    "permission lives INSIDE 'object' (NamedObjectWithPermissionSchema) — it references existing Permission 'ziroom_permission_v1' by LocalMark name.",
+    "namedOperator='' means OrderHolder (customer), NOT 'anyone'. permissionIndex maps to Permission table entries (1000=operator, 1001=inspector, 1002=finance, 1500=arbiter).",
+    "Machine nodes are immutable after publish — create a new Machine to change the workflow."
   ]
 }

package/dist/examples/rental-ziroom-permission-create.json

@@ -4,8 +4,9 @@
   "tags": ["permission", "rental", "role", "index"],
   "industry": "rental",
   "operation_type": "permission",
-  "source": "ziroom testnet deployment 2026-07-29",
+  "source": "ziroom testnet deployment 2026-07-29 (repaired to current schema)",
   "verified": true,
+  "network": "testnet",
   "call": {
     "tool": "onchain_operations",
     "operation_type": "permission",
@@ -18,7 +19,12 @@
       "table": {
         "op": "add perm by index",
         "index": 1000,
-        "entity": ["0x51bd..."]
+        "entity": {
+          "entities": [
+            { "name_or_address": "ziroom_operator" }
+          ],
+          "check_all_founded": false
+        }
       }
     },
     "env": {
@@ -30,6 +36,7 @@
   "notes": [
     "Custom indexes range 1000-65535 (0-999 are protocol-reserved)",
     "Single Permission recommended for centralized control across all objects",
-    "Use 'add perm by index' to grant one permission to many entities"
+    "Use 'add perm by index' to grant one permission to many entities",
+    "entity is ManyAccountOrMark_AddressSchema OBJECT form {entities: [{name_or_address}], check_all_founded?} — NOT a bare array (schema drift repair 2026-07-30: the 2026-07-29 deployment used the legacy array form; current schema requires the object wrapper). Recipient shown as the operator's local mark name; the original deployment used raw 0x addresses (desensitized)."
   ]
 }