@wowok/agent-mcp 3.0.0 → 3.0.2

package/dist/schemas/keeper_operation.schema.json

@@ -0,0 +1,359 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/keeper_operation.json",
+  "title": "Keeper - Actionable Reminders & Authorized Auto-Execution",
+  "description": "Who-benefits-who-pushes: actionable reminders (unclaimed payments, actionable workflow forwards), dismiss/execute, auto-exec rule authorizations, config, manual scan, status",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "tasks"
+        },
+        "status": {
+          "description": "Filter by task status (default: all).",
+          "type": "string",
+          "enum": [
+            "pending",
+            "executed",
+            "dismissed",
+            "superseded"
+          ]
+        },
+        "detector": {
+          "description": "Filter by detector kind.",
+          "type": "string",
+          "enum": [
+            "payment_unclaimed",
+            "progress_actionable"
+          ]
+        },
+        "beneficiary": {
+          "description": "Filter by beneficiary account.",
+          "type": "string",
+          "pattern": "^0x[0-9a-fA-F]{4,64}$"
+        },
+        "limit": {
+          "description": "Page size (default 50).",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 200
+        },
+        "offset": {
+          "description": "Page offset (default 0).",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "dismiss"
+        },
+        "task_ids": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Task ids to dismiss. A dismissed task re-opens ONLY when the underlying state materially changes (new funds, new forward) — never for the identical state."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action",
+        "task_ids"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "execute"
+        },
+        "task_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Task id to execute NOW as its beneficiary. Only tasks carrying a keeper-executable operation can run (v1: payment_unclaimed — claim-to-self). Reminder-only tasks point at workflow_operation in their detail text. This explicit call IS the user decision (no rule required)."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action",
+        "task_id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "rules"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "rule_set"
+        },
+        "rule_id": {
+          "description": "Existing rule id to update; omit to create a new rule.",
+          "type": "string"
+        },
+        "detector": {
+          "type": "string",
+          "enum": [
+            "payment_unclaimed",
+            "progress_actionable"
+          ],
+          "description": "Detector the rule applies to."
+        },
+        "enabled": {
+          "description": "Default true.",
+          "type": "boolean"
+        },
+        "accounts": {
+          "description": "Beneficiaries covered (default: all beneficiaries the detector surfaces).",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^0x[0-9a-fA-F]{4,64}$",
+            "description": "Account address (0x…). Case-insensitive; stored lowercase."
+          }
+        },
+        "auto_execute": {
+          "description": "Standing authorization: the keeper executes matching tasks automatically. v1: only 'payment_unclaimed' may auto-execute (claim-to-self — funds move only INTO the beneficiary's own wallet). Progress advancing stays reminder-only because it can release funds to a counterparty.",
+          "type": "boolean"
+        },
+        "note": {
+          "description": "User rationale, recorded verbatim in the audit trail.",
+          "type": "string"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action",
+        "detector"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "rule_remove"
+        },
+        "rule_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action",
+        "rule_id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "config"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "config_set"
+        },
+        "enabled": {
+          "description": "Master switch — false pauses scanning (existing tasks stay visible).",
+          "type": "boolean"
+        },
+        "detectors": {
+          "description": "Per-detector reminder switches.",
+          "type": "object",
+          "properties": {
+            "payment_unclaimed": {
+              "type": "boolean"
+            },
+            "progress_actionable": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false
+        },
+        "scan_interval_ms": {
+          "description": "Min ms between keeper scans (default 120000, min 30000). The scan runs inside the monitor tick.",
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "max_scan_objects": {
+          "description": "Hard bound on chain-reading candidates per scan (default 20).",
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "max_auto_execute_per_scan": {
+          "description": "Gas guard: max auto-executions per scan (default 5).",
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "auto_retry_cooldown_ms": {
+          "description": "Cooldown after a failed auto-exec (default 1800000 = 30min).",
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "scan"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "status"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}

package/dist/schemas/messenger_operation.schema.json

@@ -240,6 +240,10 @@
             }
           },
           "additionalProperties": false
+        },
+        "goal_id": {
+          "description": "Optional goal id (from goal_operation). When set, this act is recorded as communication evidence on the goal's TaskProcess (K3 27 G5) — use it only when the act belongs to an active goal's execution (order negotiation, required-info confirmation, WTS evidence, on-chain proof).",
+          "type": "string"
         }
       },
       "required": [
@@ -1080,6 +1084,10 @@
             "mainnet"
           ],
           "description": "Network to use for on-chain proof (required)"
+        },
+        "goal_id": {
+          "description": "Optional goal id (from goal_operation). When set, this act is recorded as communication evidence on the goal's TaskProcess (K3 27 G5) — use it only when the act belongs to an active goal's execution (order negotiation, required-info confirmation, WTS evidence, on-chain proof).",
+          "type": "string"
         }
       },
       "required": [

package/dist/schemas/onchain_events.output.json

@@ -77,6 +77,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -113,7 +117,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -207,6 +211,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -243,7 +251,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -394,6 +402,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -430,7 +442,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -579,6 +591,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -615,7 +631,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -757,6 +773,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -793,7 +813,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -908,6 +928,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -944,7 +968,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -1070,6 +1094,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -1106,7 +1134,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -1221,6 +1249,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -1257,7 +1289,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -1366,6 +1398,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -1402,7 +1438,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -1519,6 +1555,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -1555,7 +1595,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",
@@ -1672,6 +1712,10 @@
                             "type": "string",
                             "const": "ServiceEvent"
                           },
+                          {
+                            "type": "string",
+                            "const": "ArbitrationEvent"
+                          },
                           {
                             "type": "string",
                             "const": "DemandChangedEvent"
@@ -1708,7 +1752,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
+                        "description": "Event type. Supports Wowok built-in types (ArbEvent, NewOrderEvent, ProgressEvent, DemandPresentEvent, DemandFeedbackEvent, NewEntityEvent, ServiceEvent, ArbitrationEvent, DemandChangedEvent, VoteEvent, FeedbackEvent, AllocationEvent, TreasuryEvent, RewardClaimEvent, RewardFundEvent, NewPaymentEvent) or any string for generic MoveEventType (e.g., '0x2::coin::CoinEvent'). See the Event Semantics Registry (knowledge/event-semantics.ts) for every event's trigger logic, parameter meanings, and business semantics — especially NewPaymentEvent (the universal fund-flow receipt: from_object is the internal-only funding-source object — Treasury/Allocation/Service — set by the framework, never by user code)."
                       },
                       "type_raw": {
                         "type": "string",

package/dist/schemas/onchain_events.schema.json

@@ -35,6 +35,10 @@
           "type": "string",
           "const": "ServiceEvent"
         },
+        {
+          "type": "string",
+          "const": "ArbitrationEvent"
+        },
         {
           "type": "string",
           "const": "DemandChangedEvent"