@wowok/agent-mcp 3.1.7 → 3.2.1

package/dist/schemas/local_cache_operation.schema.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/local_cache_operation.json",
+  "title": "SDK Read Cache Operations",
+  "description": "LOCAL ONLY, NEVER ON-CHAIN: inspect and clear this device's WoWok SDK read cache. Use {status: {op:'status'}} to diagnose a stale cache, {refresh_chain_scope: {op:'refresh_chain_scope'}} after the chain node was reset or restarted (this alone fixes 'object 0x… version 0x… is unavailable'), {clear_prefix: {...}} to drop one cache family such as on-chain objects, or {clear: {op:'clear'}} to drop everything. Does NOT touch accounts, marks, info or history — those hold user data and have their own tools.",
+  "type": "object",
+  "properties": {
+    "status": {
+      "description": "Report cache diagnostics: active chain identity, in-memory entry count, persisted row count. Read-only — changes nothing.",
+      "type": "object",
+      "properties": {
+        "op": {
+          "type": "string",
+          "const": "status",
+          "description": "Operation type: report cache diagnostics"
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    "clear_prefix": {
+      "description": "Clear every cached row under ONE prefix, in memory and on disk. Choose 'objectv2' to force a full re-read of on-chain objects.",
+      "type": "object",
+      "properties": {
+        "op": {
+          "type": "string",
+          "const": "clear_prefix",
+          "description": "Operation type: clear one cache prefix"
+        },
+        "prefix": {
+          "type": "string",
+          "enum": [
+            "objectv2",
+            "sharedobject",
+            "servicelist",
+            "demandlist",
+            "arbitlist",
+            "table",
+            "event",
+            "tx",
+            "entity",
+            "config",
+            "token",
+            "personal",
+            "mark",
+            "info",
+            "history"
+          ],
+          "description": "Cache prefix to clear (e.g. 'objectv2' for on-chain objects)"
+        }
+      },
+      "required": [
+        "op",
+        "prefix"
+      ],
+      "additionalProperties": false
+    },
+    "clear": {
+      "description": "Clear the ENTIRE read cache (every prefix, every network, memory and disk). Accounts, marks, info and history are NOT affected.",
+      "type": "object",
+      "properties": {
+        "op": {
+          "type": "string",
+          "const": "clear",
+          "description": "Operation type: clear the entire read cache"
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    "refresh_chain_scope": {
+      "description": "Re-fetch the chain identity (w_getChainIdentifier) and install it as the cache scope. If the chain was reset, every previously written row becomes UNREACHABLE automatically and is re-fetched on next read — the automatic half of the reset-recovery fix.",
+      "type": "object",
+      "properties": {
+        "op": {
+          "type": "string",
+          "const": "refresh_chain_scope",
+          "description": "Operation type: re-detect the chain identity and re-scope the cache"
+        },
+        "network": {
+          "description": "Network to re-detect; defaults to the configured network",
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ]
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/dist/schemas/local_history_operation.output.json

@@ -1139,7 +1139,7 @@
                     "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
                   },
                   "gains": {
-                    "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement triggered — funds released to provider']",
+                    "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement unlocked — funds releasable to provider via an explicit allocation step']",
                     "type": "array",
                     "items": {
                       "type": "string"
@@ -1386,7 +1386,7 @@
                         "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
                       },
                       "gains": {
-                        "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement triggered — funds released to provider']",
+                        "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement unlocked — funds releasable to provider via an explicit allocation step']",
                         "type": "array",
                         "items": {
                           "type": "string"

package/dist/schemas/local_info_operation.output.json

@@ -1025,7 +1025,7 @@
                     "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
                   },
                   "gains": {
-                    "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement triggered — funds released to provider']",
+                    "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement unlocked — funds releasable to provider via an explicit allocation step']",
                     "type": "array",
                     "items": {
                       "type": "string"
@@ -1272,7 +1272,7 @@
                         "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
                       },
                       "gains": {
-                        "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement triggered — funds released to provider']",
+                        "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement unlocked — funds releasable to provider via an explicit allocation step']",
                         "type": "array",
                         "items": {
                           "type": "string"

package/dist/schemas/local_mark_operation.output.json

@@ -22,44 +22,59 @@
                   "type": "boolean"
                 },
                 "add": {
-                  "description": "List of added mark data",
-                  "type": "array",
-                  "items": {
-                    "type": "object",
-                    "properties": {
-                      "name": {
-                        "description": "Mark name (max 64 bcs characters)",
-                        "type": "string",
-                        "maxLength": 64
-                      },
-                      "address": {
-                        "type": "string",
-                        "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
-                      },
-                      "tags": {
-                        "description": "Tags for categorization (max 50 tags, each max 64 bcs characters)",
-                        "maxItems": 50,
-                        "type": "array",
-                        "items": {
-                          "type": "string",
-                          "maxLength": 64
-                        }
-                      },
-                      "createdAt": {
-                        "description": "Unix timestamp (ms) when this mark was created",
-                        "type": "number"
+                  "description": "Result of adding marks (written entries + how many carry no name)",
+                  "type": "object",
+                  "properties": {
+                    "marked": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "description": "Mark name (max 64 bcs characters)",
+                            "type": "string",
+                            "maxLength": 64
+                          },
+                          "address": {
+                            "type": "string",
+                            "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
+                          },
+                          "tags": {
+                            "description": "Tags for categorization (max 50 tags, each max 64 bcs characters)",
+                            "maxItems": 50,
+                            "type": "array",
+                            "items": {
+                              "type": "string",
+                              "maxLength": 64
+                            }
+                          },
+                          "createdAt": {
+                            "description": "Unix timestamp (ms) when this mark was created",
+                            "type": "number"
+                          },
+                          "updatedAt": {
+                            "description": "Unix timestamp (ms) when this mark was last modified",
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "address"
+                        ],
+                        "additionalProperties": false,
+                        "description": "LOCAL PRIVATE: Local mark data structure for storing address names and tags privately on your device. This data is NEVER published to the blockchain. CROSS-NETWORK ISOLATION (DOC-02): LocalMark names are scoped per network — the same name 'my-service' can map to different addresses on testnet vs mainnet. When switching networks (e.g., testnet→mainnet deployment), re-create marks with the same names pointing to the new mainnet addresses. This enables name-based object references that work identically across networks without code changes."
                       },
-                      "updatedAt": {
-                        "description": "Unix timestamp (ms) when this mark was last modified",
-                        "type": "number"
-                      }
+                      "description": "Entries created or merged. Any entry WITH a `name` is reachable via get(name)."
                     },
-                    "required": [
-                      "address"
-                    ],
-                    "additionalProperties": false,
-                    "description": "LOCAL PRIVATE: Local mark data structure for storing address names and tags privately on your device. This data is NEVER published to the blockchain. CROSS-NETWORK ISOLATION (DOC-02): LocalMark names are scoped per network — the same name 'my-service' can map to different addresses on testnet vs mainnet. When switching networks (e.g., testnet→mainnet deployment), re-create marks with the same names pointing to the new mainnet addresses. This enables name-based object references that work identically across networks without code changes."
-                  }
+                    "unnamed": {
+                      "type": "number",
+                      "description": "How many of the written entries have NO name and are therefore unreachable via get(name). Non-zero is legitimate only when the caller asked for address-only rows; a malformed `name` is rejected outright rather than landing here (wiki/test/10 N-1)."
+                    }
+                  },
+                  "required": [
+                    "marked",
+                    "unnamed"
+                  ],
+                  "additionalProperties": false
                 },
                 "remove": {
                   "description": "List of removed mark data",
@@ -1102,7 +1117,7 @@
                     "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
                   },
                   "gains": {
-                    "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement triggered — funds released to provider']",
+                    "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement unlocked — funds releasable to provider via an explicit allocation step']",
                     "type": "array",
                     "items": {
                       "type": "string"
@@ -1349,7 +1364,7 @@
                         "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
                       },
                       "gains": {
-                        "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement triggered — funds released to provider']",
+                        "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement unlocked — funds releasable to provider via an explicit allocation step']",
                         "type": "array",
                         "items": {
                           "type": "string"

package/dist/schemas/local_mark_operation.schema.json

@@ -26,6 +26,7 @@
                 "properties": {
                   "value": {
                     "type": "string",
+                    "minLength": 1,
                     "maxLength": 64,
                     "description": "Mark name value (max 64 bcs characters)"
                   },

package/dist/schemas/messenger_operation.output.json

@@ -3539,7 +3539,7 @@
                     "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
                   },
                   "gains": {
-                    "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement triggered — funds released to provider']",
+                    "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement unlocked — funds releasable to provider via an explicit allocation step']",
                     "type": "array",
                     "items": {
                       "type": "string"
@@ -3786,7 +3786,7 @@
                         "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
                       },
                       "gains": {
-                        "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement triggered — funds released to provider']",
+                        "description": "Gains for the caller if this option is chosen (K3 Game G1 gain separation). Example: ['Settlement unlocked — funds releasable to provider via an explicit allocation step']",
                         "type": "array",
                         "items": {
                           "type": "string"