@wowok/agent-mcp 2.7.8 → 3.0.0

package/dist/schemas/monitor_subscription.schema.json

@@ -0,0 +1,327 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/monitor_subscription.json",
+  "title": "Monitor Subscription - Scope, Filters & Todo-Stream Config",
+  "description": "Input parameters for monitor subscription configuration (scope, filters, todo-stream switches)",
+  "type": "object",
+  "properties": {
+    "action": {
+      "type": "string",
+      "enum": [
+        "get",
+        "save",
+        "reset",
+        "scope_preview",
+        "test_filter"
+      ],
+      "description": "'get' — effective config + resolved scope summary + loop status; 'save' — merge a partial config (loop params clamped to safe bounds) and trigger an immediate scope re-resolve; 'reset' — restore defaults and re-resolve; 'scope_preview' — current scope closure grouped by layer (inspect BEFORE tuning switches); 'test_filter' — dry-run a filter over recently captured events (pre-save preview)"
+    },
+    "config": {
+      "description": "Partial config for action='save'",
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "description": "Master switch — false stops the todo stream; event capture continues",
+          "type": "boolean"
+        },
+        "scope": {
+          "type": "object",
+          "properties": {
+            "accounts": {
+              "description": "Anchor accounts: 'local-all' (every local account) or an explicit address list",
+              "anyOf": [
+                {
+                  "type": "string",
+                  "const": "local-all"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            "rules": {
+              "description": "Scope-closure rule switches (merged field-wise on save)",
+              "type": "object",
+              "properties": {
+                "managed_objects": {
+                  "description": "Events from objects managed by my permissions",
+                  "type": "boolean"
+                },
+                "merchant_orders": {
+                  "description": "Events from orders of MY services (merchant side)",
+                  "type": "boolean"
+                },
+                "my_orders": {
+                  "description": "Events from orders where I am builder/agent (buyer side)",
+                  "type": "boolean"
+                },
+                "order_children": {
+                  "description": "Events from each in-scope order's dispute/progress/allocation children",
+                  "type": "boolean"
+                },
+                "favor_objects": {
+                  "description": "Auto-focus objects I recently gave on-chain favor feedback to",
+                  "type": "boolean"
+                }
+              },
+              "additionalProperties": false
+            },
+            "focus_objects": {
+              "description": "Explicit focus objects (REPLACED wholesale on save)",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "object": {
+                    "type": "string",
+                    "description": "Object address to focus on"
+                  },
+                  "added_at": {
+                    "type": "number",
+                    "description": "When the focus was added (ms epoch)"
+                  },
+                  "reason": {
+                    "type": "string",
+                    "enum": [
+                      "favor",
+                      "manual",
+                      "radar",
+                      "goal"
+                    ],
+                    "description": "Why this object is focused: favor (auto from my on-chain favor feedback) | manual | radar | goal"
+                  },
+                  "note": {
+                    "description": "Optional human-readable note",
+                    "type": "string"
+                  },
+                  "closure": {
+                    "type": "boolean",
+                    "description": "true → also derive the closure (focused service → its orders; focused order → its arb/progress/allocation children)"
+                  },
+                  "goal_id": {
+                    "description": "Goal id when reason='goal' (K3 24) — the GoalEngine expires exactly this goal's focus entries on completion/abandonment",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "object",
+                  "added_at",
+                  "reason",
+                  "closure"
+                ],
+                "additionalProperties": false,
+                "description": "An explicitly focused object (focus closure member)"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "events": {
+          "description": "Per-event-type delivery switches for the todo stream (merged on save). Capture set is unaffected EXCEPT NewPaymentEvent, which is captured only when switched ON here",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "boolean"
+          }
+        },
+        "filters": {
+          "description": "Conditional delivery filters (REPLACED wholesale on save)",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Stable filter id (unique within the config)"
+              },
+              "enabled": {
+                "type": "boolean",
+                "description": "false keeps the filter in config without applying it"
+              },
+              "event": {
+                "description": "Short event type to restrict to (e.g. 'NewPaymentEvent'); omitted = all captured types",
+                "type": "string"
+              },
+              "field": {
+                "type": "string",
+                "description": "Event field path: dot notation ('info.for_object') with '[]' array-walk ('record[].recipient' — any element matches)"
+              },
+              "op": {
+                "type": "string",
+                "enum": [
+                  "eq",
+                  "neq",
+                  "contains",
+                  "gte",
+                  "lte",
+                  "in"
+                ],
+                "description": "Comparison op; gte/lte compare integer-safe (BigInt) when both sides are base-10 integers"
+              },
+              "value": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                ],
+                "description": "Comparison value (string list for op='in')"
+              }
+            },
+            "required": [
+              "id",
+              "enabled",
+              "field",
+              "op",
+              "value"
+            ],
+            "additionalProperties": false,
+            "description": "Conditional delivery filter over event fields (dry-run it with action='test_filter' before saving)"
+          }
+        },
+        "loop": {
+          "description": "Loop tuning (merged on save, clamped to safe bounds)",
+          "type": "object",
+          "properties": {
+            "poll_interval_ms": {
+              "description": "Capture tick interval (default 15000, min 5000)",
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "scope_refresh_ms": {
+              "description": "Scope re-resolve interval (default 300000, min 60000)",
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "backfill_days": {
+              "description": "Re-annotation window after a scope change (default 7 days, min 0)",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "rule": {
+      "description": "action='scope_preview' — restrict to one scope layer; omit for all layers",
+      "type": "string",
+      "enum": [
+        "accounts",
+        "permissions",
+        "managed_objects",
+        "services",
+        "orders",
+        "order_children",
+        "focus"
+      ]
+    },
+    "filter": {
+      "description": "Filter to dry-run for action='test_filter'",
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Stable filter id (unique within the config)"
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "false keeps the filter in config without applying it"
+        },
+        "event": {
+          "description": "Short event type to restrict to (e.g. 'NewPaymentEvent'); omitted = all captured types",
+          "type": "string"
+        },
+        "field": {
+          "type": "string",
+          "description": "Event field path: dot notation ('info.for_object') with '[]' array-walk ('record[].recipient' — any element matches)"
+        },
+        "op": {
+          "type": "string",
+          "enum": [
+            "eq",
+            "neq",
+            "contains",
+            "gte",
+            "lte",
+            "in"
+          ],
+          "description": "Comparison op; gte/lte compare integer-safe (BigInt) when both sides are base-10 integers"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Comparison value (string list for op='in')"
+        }
+      },
+      "required": [
+        "id",
+        "enabled",
+        "field",
+        "op",
+        "value"
+      ],
+      "additionalProperties": false
+    },
+    "sample": {
+      "description": "action='test_filter' — how many recent captured events to scan (default 200, max 1000)",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 1000
+    },
+    "limit": {
+      "description": "action='scope_preview' — page size per group (default 50, max 500)",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 500
+    },
+    "offset": {
+      "description": "action='scope_preview' — pagination offset within each group (default 0)",
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "network": {
+      "description": "Network: 'mainnet' or 'testnet'. Uses default network if not specified",
+      "type": "string",
+      "enum": [
+        "localnet",
+        "testnet",
+        "mainnet"
+      ]
+    }
+  },
+  "required": [
+    "action"
+  ],
+  "additionalProperties": false
+}

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": [
@@ -1283,7 +1283,7 @@
                       },
                       "location": {
                         "type": "string",
-                        "description": "Service location"
+                        "description": "The service area and scope as stated by the merchant."
                       },
                       "description": {
                         "type": "string",
@@ -1428,7 +1428,7 @@
                       },
                       "location": {
                         "type": "string",
-                        "description": "Demand location"
+                        "description": "The area or scope where the services required by the demand are located."
                       },
                       "description": {
                         "type": "string",
@@ -2217,10 +2217,10 @@
               "items": {
                 "type": "string"
               },
-              "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','project_service','experience_layer']"
+              "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','experience_layer']"
             },
             "inactive": {
-              "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness','graph_persist']",
+              "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness']",
               "type": "array",
               "items": {
                 "type": "string"

package/dist/schemas/onchain_operations.output.json

@@ -3420,10 +3420,10 @@
               "items": {
                 "type": "string"
               },
-              "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','project_service','experience_layer']"
+              "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','experience_layer']"
             },
             "inactive": {
-              "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness','graph_persist']",
+              "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness']",
               "type": "array",
               "items": {
                 "type": "string"