@wowok/agent-mcp 2.7.7 → 2.7.10

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
+}