@wowok/agent-mcp 3.0.0 → 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_table_data.output.json

@@ -9392,6 +9392,24 @@
           "additionalProperties": false,
           "description": "Business Relationship Graph (K3/19): derive ONE account's full relationship web from on-chain power carriers (Permission memberships, Machine forwards, Orders, Demand presenters, Allocation sharing, Arbitration bindings, Contact ims). Each edge carries the three dimensions — 权属 power (what each side CAN do, and where that power lives on-chain), 利益 interest (gains/exposures, with registry-declared goal tensions like principal-agent divergence), and 价值交互 value flows (escrow → allocation → payment chains). Read-only; roles are DERIVED from chain data, never asserted."
         },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "scenario_topology"
+            },
+            "chain_id": {
+              "description": "Optional scenario-chain id (chain.standard_ecommerce | chain.procurement_tender | chain.data_subscription | chain.collaborative_operations). When given, only that chain is returned; otherwise ALL scenario chains + bridges are returned.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "query_type"
+          ],
+          "additionalProperties": false,
+          "description": "Scenario Topology knowledge (K3 03 §3.5 / Part 2): the STATIC registry of how WoWok objects INTEGRATE each other. Bridges weld object pairs into a capability that belongs to no single object (e.g. Demand.present(service) grants MATCHMAKING); chains compose bridges into whole applications (e.g. standard e-commerce, procurement tender). Pure knowledge, read-only — no on-chain reads. Use to explain HOW a business scenario is assembled from on-chain objects and why the integration (not the objects themselves) yields the capability."
+        },
         {
           "type": "object",
           "properties": {

package/dist/schemas/query_toolkit.output.json

@@ -17537,6 +17537,54 @@
                 "summary": {
                   "type": "string",
                   "description": "One-paragraph relationship web summary."
+                },
+                "demander_interest": {
+                  "description": "Demander-interest analysis per anchor-owned demand (fund_flow/responsibility/leverage/stakes).",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "demand": {
+                        "type": "string"
+                      },
+                      "fund_flow": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "responsibility": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "leverage": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "stakes": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "summary": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "demand",
+                      "fund_flow",
+                      "responsibility",
+                      "leverage",
+                      "stakes",
+                      "summary"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "required": [
@@ -17557,6 +17605,203 @@
           ],
           "additionalProperties": false
         },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "scenario_topology"
+            },
+            "result": {
+              "type": "object",
+              "properties": {
+                "version": {
+                  "type": "string",
+                  "description": "scenario-topology registry version."
+                },
+                "chains": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Stable chain id (e.g. chain.standard_ecommerce)."
+                      },
+                      "name": {
+                        "type": "string"
+                      },
+                      "steps": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "bridge": {
+                              "type": "string"
+                            },
+                            "note": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "bridge"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "Ordered bridges forming the complete application."
+                      },
+                      "application_capability": {
+                        "type": "string",
+                        "description": "The end-to-end application capability."
+                      },
+                      "objects_touched": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "steps",
+                      "application_capability",
+                      "objects_touched"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Scenario chains (whole applications); optionally filtered by chain_id."
+                },
+                "bridges": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Stable bridge id (e.g. bridge.supply_match)."
+                      },
+                      "name": {
+                        "type": "string"
+                      },
+                      "participants": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "object": {
+                              "type": "string"
+                            },
+                            "role": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "object",
+                            "role"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "Objects welded by this bridge."
+                      },
+                      "bridge_fields": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "object": {
+                              "type": "string"
+                            },
+                            "field": {
+                              "type": "string"
+                            },
+                            "meaning": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "object",
+                            "field",
+                            "meaning"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "The integrating Move fields (source of truth)."
+                      },
+                      "move_anchor": {
+                        "type": "string",
+                        "description": "Move creation/consumption function anchor."
+                      },
+                      "scenario": {
+                        "type": "object",
+                        "properties": {
+                          "from": {
+                            "type": "string"
+                          },
+                          "to": {
+                            "type": "string"
+                          },
+                          "merged": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "from",
+                          "to",
+                          "merged"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "capability_gained": {
+                        "type": "string",
+                        "description": "The NEW capability from the integration itself (belongs to no single object)."
+                      },
+                      "value_flow": {
+                        "type": "string"
+                      },
+                      "prerequisites": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "examples": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "participants",
+                      "bridge_fields",
+                      "move_anchor",
+                      "scenario",
+                      "capability_gained",
+                      "prerequisites",
+                      "examples"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Scenario bridges (field integrations) resolvable from chain steps."
+                }
+              },
+              "required": [
+                "version",
+                "chains",
+                "bridges"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "query_type",
+            "result"
+          ],
+          "additionalProperties": false
+        },
         {
           "type": "object",
           "properties": {