@wowok/agent-mcp 2.3.12 → 2.3.14

package/dist/schema/query/index.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { TokenTypeInfoSchema, QueryLocalMarkListResultSchema, QueryAccountListResultSchema, QueryLocalInfoListResultSchema, QueryLocalTokenListResultSchema, QueryAccountResultSchema } from "../local/index.js";
 import { AccountOrMark_AddressSchema, BalanceTypeSchema, CacheExpireTypeSchema, EntrypointSchema, GuardIdentifierSchema, GuardTableItemSchema, NameOrAddressSchema, ObjectBaseSchema, ObjectTypeSchema, QueryIdSchema, SupportedValueSchema, ValueTypeSchema, QueryReceivedResultSchema, LongNameSchema, DescriptionSchema } from "../common/index.js";
+const SemanticSummarySchema = z.any();
 import { isValidPermissionIndex } from '../utils/permission-index-utils.js';
 import { isValidGuardQueryId, isValidGuardQueryIdOrName } from '../utils/guard-query-utils.js';
 import { ENTITY_LINKER_ADDRESS, ENTITY_REGISTRAR_ADDRESS, isWitnessType, } from "@wowok/wowok";
@@ -1034,6 +1035,7 @@ export const OnchainEventsInputSchema = z.object({
 }).describe("Input parameters for querying on-chain WOWOK events");
 export const OnchainEventsResultSchema = z.object({
     result: z.union([EventAnswerSchema, z.null()]).describe("Event query result containing list of events and pagination info, or null if no data found"),
+    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for the event query"),
 }).describe("Result of on-chain events query");
 export const TableItem_RepositoryDataOrUndefinedSchema = z.union([TableItem_RepositoryDataSchema, z.null()]).describe("Repository data item or null");
 export const TableItem_PermissionPermOrUndefinedSchema = z.union([TableItem_PermissionPermSchema, z.null()]).describe("Permission permission item or null");
@@ -1337,5 +1339,6 @@ export const AllQueryResultsSchema = z.union([
     OnchainQueryResultSchema_Part2,
 ]);
 export const WatchQueryOperationsResultSchema = z.object({
-    result: AllQueryResultsSchema
+    result: AllQueryResultsSchema,
+    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for the query operation"),
 }).describe("Watch query operations result schema");

package/dist/schemas/account_operation.output.json

@@ -1385,6 +1385,9 @@
             }
           ],
           "description": "Account operation output schema with discriminator"
+        },
+        "semantic": {
+          "description": "Business semantic summary for account operation"
         }
       },
       "required": [

package/dist/schemas/account_operation.schema.json

@@ -250,7 +250,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Account operations"
+      "description": "Account operations. Parameters MUST be wrapped in the operation type property (e.g. {transfer: {...}}, NOT {amount: ...}). Unwrapped parameters are rejected."
     }
   }
 }

package/dist/schemas/index.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "WoWok MCP Schema Index",
   "description": "Index of all available JSON schemas for WoWok MCP tools",
-  "generatedAt": "2026-07-12T08:57:43.173Z",
+  "generatedAt": "2026-07-14T07:50:49.195Z",
   "tools": [
     {
       "name": "onchain_operations",

package/dist/schemas/local_info_operation.output.json

@@ -58,6 +58,9 @@
             }
           ],
           "description": "Local info operation output schema with discriminator"
+        },
+        "semantic": {
+          "description": "Business semantic summary for local info operation"
         }
       },
       "required": [

package/dist/schemas/local_mark_operation.output.json

@@ -102,6 +102,9 @@
             }
           ],
           "description": "Local mark operation output schema with discriminator"
+        },
+        "semantic": {
+          "description": "Business semantic summary for local mark operation"
         }
       },
       "required": [

package/dist/schemas/messenger_operation.output.json

@@ -1053,6 +1053,27 @@
                 "result"
               ],
               "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "operation": {
+                  "type": "string",
+                  "const": "pull_messages"
+                },
+                "result": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/messenger_operation/properties/result/anyOf/0/properties/result/items/properties/previewMessages/items"
+                  },
+                  "description": "List of messages pulled from server"
+                }
+              },
+              "required": [
+                "operation",
+                "result"
+              ],
+              "additionalProperties": false
             }
           ],
           "description": "Messenger operation result discriminated union"

package/dist/schemas/messenger_operation.schema.json

@@ -105,19 +105,19 @@
             },
             "content": {
               "type": "string",
-              "maxLength": 10000,
-              "description": "Message content text"
+              "maxLength": 10240,
+              "description": "Message content text (max 10240 bytes)"
             },
             "options": {
               "type": "object",
               "properties": {
                 "guardAddress": {
                   "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "Guard address"
+                  "description": "Guard address. REQUIRED when sending Guard-verified messages"
                 },
                 "passportAddress": {
                   "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "Passport address"
+                  "description": "Passport address. REQUIRED when sending Guard-verified messages"
                 },
                 "force": {
                   "type": "boolean",
@@ -126,6 +126,15 @@
                 "new_messenger_name": {
                   "type": "string",
                   "description": "New messenger name for recipient"
+                },
+                "network": {
+                  "type": "string",
+                  "enum": [
+                    "localnet",
+                    "testnet",
+                    "mainnet"
+                  ],
+                  "description": "Target network for Guard verification (e.g., testnet, mainnet). REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks"
                 }
               },
               "additionalProperties": false,
@@ -183,11 +192,11 @@
                 },
                 "guardAddress": {
                   "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "Guard address"
+                  "description": "Guard address. REQUIRED when sending Guard-verified files"
                 },
                 "passportAddress": {
                   "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "Passport address"
+                  "description": "Passport address. REQUIRED when sending Guard-verified files"
                 },
                 "force": {
                   "type": "boolean",
@@ -196,6 +205,10 @@
                 "new_messenger_name": {
                   "type": "string",
                   "description": "New messenger name for recipient"
+                },
+                "network": {
+                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/options/properties/network",
+                  "description": "Target network for Guard verification (e.g., testnet, mainnet). REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks"
                 }
               },
               "additionalProperties": false,
@@ -895,12 +908,13 @@
                 "testnet",
                 "mainnet"
               ],
-              "description": "Network to use for on-chain proof"
+              "description": "Network to use for on-chain proof (required)"
             }
           },
           "required": [
             "operation",
-            "messageId"
+            "messageId",
+            "network"
           ],
           "additionalProperties": false
         },
@@ -1386,6 +1400,27 @@
             "peerAddress"
           ],
           "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "string",
+              "const": "pull_messages"
+            },
+            "account": {
+              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+              "description": "Account name or address. If not specified, uses default account"
+            },
+            "limit": {
+              "type": "number",
+              "description": "Maximum number of messages to pull from server"
+            }
+          },
+          "required": [
+            "operation"
+          ],
+          "additionalProperties": false
         }
       ],
       "description": "Messenger operation input schema"

package/dist/schemas/onchain_events.output.json

@@ -501,6 +501,9 @@
             }
           ],
           "description": "Event query result containing list of events and pagination info, or null if no data found"
+        },
+        "semantic": {
+          "description": "Business semantic summary for the event query"
         }
       },
       "required": [