@wowok/agent-mcp 3.2.0 → 3.2.2

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_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",

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

@@ -1182,7 +1182,7 @@
               "properties": {
                 "valid": {
                   "type": "boolean",
-                  "description": "Whether verification succeeded"
+                  "description": "Whether verification succeeded. TRUE only when ALL hold (no opt-out exists): the packet is self-consistent (Merkle chain + digest), EVERY message carries a verifying per-message Falcon512 serverSignature, meta.signature seals the packet (binding the declared serverPublicKeys), AND every message's server key exists in the messenger server's official key history with a validity window covering the message's server timestamp (serverKeysOfficial). A freshly generated packet is valid:false until sign_wts seals it."
                 },
                 "error": {
                   "description": "Error message if verification failed",
@@ -1194,14 +1194,14 @@
                 },
                 "hasSignature": {
                   "type": "boolean",
-                  "description": "Whether WTS has signatures"
+                  "description": "Whether the packet carries a meta.signature seal"
                 },
                 "signatureValid": {
-                  "description": "Whether signature validation passed",
+                  "description": "Whether the packet seal (meta.signature) verified",
                   "type": "boolean"
                 },
                 "signatures": {
-                  "description": "Signature verification details",
+                  "description": "Packet seal verification details (per signer address)",
                   "type": "array",
                   "items": {
                     "type": "object",
@@ -1226,6 +1226,44 @@
                     "additionalProperties": false,
                     "description": "WTS signature verification details"
                   }
+                },
+                "attestedCount": {
+                  "description": "Messages whose serverSignature verified under a key the packet supplies",
+                  "type": "number"
+                },
+                "unattestedCount": {
+                  "description": "Messages with no verifying server signature (absent, or key unresolvable)",
+                  "type": "number"
+                },
+                "serverKeysOfficial": {
+                  "description": "True when every message's server key is in the server's OFFICIAL key history (rotation-aware) AND the key book itself matches its ON-CHAIN anchor (a well-known Repository record writable only by the pinned wowok signer). False — or absent because the key book or chain was unreachable — means the packet must NOT be treated as third-party evidence: a forger can mint a server key and self-sign a fully 'verifying' packet, and a fake server can serve a book full of forger keys.",
+                  "type": "boolean"
+                },
+                "serverKeyAnchor": {
+                  "description": "On-chain anchor verdict for the key book: the locally recomputed canonical hash must equal the hash in the keybook Repository record. verified:false (signer not pinned, anchor not deployed, hash mismatch, chain unreachable) forces valid:false and serverKeysOfficial:false.",
+                  "type": "object",
+                  "properties": {
+                    "verified": {
+                      "type": "boolean"
+                    },
+                    "network": {
+                      "type": "string"
+                    },
+                    "anchoredHash": {
+                      "type": "string"
+                    },
+                    "computedHash": {
+                      "type": "string"
+                    },
+                    "reason": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "verified",
+                    "network"
+                  ],
+                  "additionalProperties": false
                 }
               },
               "required": [