@wowok/agent-mcp 2.7.10 → 3.0.1

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

@@ -500,7 +500,7 @@
                             "type": "string"
                           }
                         ],
-                        "description": "A coin/balance amount. Accepts three formats: (1) DISPLAY FORMAT with token symbol: \"2.5WOW\", \"10USDC\", \"0.05WOW\" — auto-converted to smallest units via the Fund Processing Layer (token precision resolved from official registry → cache → on-chain). The symbol MUST match the token's type_parameter. (2) SMALLEST UNIT (numeric string): \"10000000000\" — used as-is, no conversion. (3) SMALLEST UNIT (number): 10000000000 — used as-is (loses precision above 2^53). PRECISION RULE: for values exceeding 2^53, ALWAYS use format (1) or (2) — JS numbers lose precision. Default token: WOW (9 decimals, 1 WOW = 10^9 MIST). For custom tokens: use display format with the token's symbol, or pass smallest units directly. MONEY CONFIRMATION: all monetary fields trigger user confirmation via the Fund Processing Layer. If multiple tokens share a symbol (ambiguity), specify the full type string in type_parameter. Examples: \"2.5WOW\" (display → 2500000000), 10000000000 (number, smallest unit), \"50000000000\" (string, smallest unit). Used for: Service.sale.price, Service.compensation_fund_add balance, Treasury.deposit, Arbitration.fee, Reward.amount, stock quantities."
+                        "description": "A coin/balance amount. Accepts three formats: (1) DISPLAY FORMAT with token symbol: \"2.5WOW\", \"10USDC\", \"0.05WOW\" — auto-converted to smallest units via the Fund Processing Layer (token precision resolved from official registry → cache → on-chain). The symbol MUST match the token's type_parameter. (2) SMALLEST UNIT (numeric string): \"10000000000\" — used as-is, no conversion. (3) SMALLEST UNIT (number): 10000000000 — used as-is only within the safe integer range (±2^53); numbers outside it are REJECTED, use a numeric string instead. PRECISION RULE: for values exceeding 2^53 (9007199254740991), ALWAYS use format (1) or (2) — JS numbers lose integer precision silently and such inputs are blocked. Raw amounts must be plain non-negative integers; a decimal value without a token symbol (e.g. \"2.5\") is rejected — append the symbol (\"2.5WOW\") so the Fund Processing Layer converts it. Default token: WOW (9 decimals, 1 WOW = 10^9 MIST). For custom tokens: use display format with the token's symbol, or pass smallest units directly. MONEY CONFIRMATION: all monetary fields trigger user confirmation via the Fund Processing Layer, where the token's FULL type, decimals and raw amount are always visible. MULTIPLE ISSUERS: several on-chain tokens may legally share the same symbol (e.g. multiple \"USDT\" coins). When a bare symbol matches more than one token, the operation is BLOCKED and every candidate is listed with full details (type, name, decimals, verified tag) — present the list to the USER and let them choose (they may answer by number), then re-issue with the chosen token's FULL type string in type_parameter; never guess an issuer from the bare symbol. MISSING TOKEN INFO: when a token's precision cannot be resolved, the operation is REFUSED (raw u64 included — amount magnitude could not be verified). Recovery: provide the token's FULL type in package::module::Name form in type_parameter (a bare symbol like \"USDT\" cannot be resolved), and verify the WOW network is correct. Examples: \"2.5WOW\" (display → 2500000000), 10000000000 (number, smallest unit), \"50000000000\" (string, smallest unit). Used for: Service.sale.price, Service.compensation_fund_add balance, Treasury.deposit, Arbitration.fee, Reward.amount, stock quantities."
                       }
                     },
                     "required": [