@wowok/agent-mcp 2.3.11 → 2.3.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,12 +1,13 @@
1
1
  import { z } from 'zod';
2
2
  import { CallEnvSchema, NamedObjectSchema } from './base.js';
3
3
  import { DescriptionSchema, NameOrAddressSchema } from '../common/index.js';
4
+ import { MAX_PROOF_SIZE, MAX_SERVER_PUBKEY_SIZE, MAX_SERVER_SIGNATURE_SIZE } from '@wowok/wowok';
4
5
  export const CallProof_DataSchema = z.object({
5
6
  namedNew: NamedObjectSchema.optional(),
6
7
  description: DescriptionSchema.optional(),
7
- proof: z.string().max(10240).describe("Proof content. e.g. merkle tree root"),
8
- server_pubkey: z.string().max(1024).describe("Server public key"),
9
- server_signature: z.string().max(40480).describe("Server signature"),
8
+ proof: z.string().max(MAX_PROOF_SIZE).describe("Proof content. e.g. merkle tree root"),
9
+ server_pubkey: z.string().max(MAX_SERVER_PUBKEY_SIZE).describe("Server public key"),
10
+ server_signature: z.string().max(MAX_SERVER_SIGNATURE_SIZE).describe("Server signature"),
10
11
  proof_type: z.union([z.number().int().min(0), z.string()]).describe("Proof type. 1: WTS proof; 1-100 reserved."),
11
12
  item_count: z.union([z.number().int().min(0), z.string(), z.null()]).optional().describe("Item count. e.g. number of items in the merkle tree"),
12
13
  about_address: z.union([NameOrAddressSchema, z.null()]).optional().describe("About address. e.g. address of the entity being proved"),
@@ -16,9 +17,9 @@ export const CallProof_InputSchema = z.object({
16
17
  env: CallEnvSchema.optional(),
17
18
  }).strict().describe("On-chain, create a new Proof object");
18
19
  export const CallGenProof_InputSchema = z.object({
19
- proof: z.string().max(10240).describe("Proof content. e.g. merkle tree root"),
20
- server_pubkey: z.string().max(1024).describe("Server public key"),
21
- server_signature: z.string().max(40480).describe("Server signature"),
20
+ proof: z.string().max(MAX_PROOF_SIZE).describe("Proof content. e.g. merkle tree root"),
21
+ server_pubkey: z.string().max(MAX_SERVER_PUBKEY_SIZE).describe("Server public key"),
22
+ server_signature: z.string().max(MAX_SERVER_SIGNATURE_SIZE).describe("Server signature"),
22
23
  proof_type: z.union([z.number().int().min(0), z.string()]).describe("Proof type. 1: WTS proof; 1-100 reserved."),
23
24
  description: DescriptionSchema.optional(),
24
25
  item_count: z.union([z.number().int().min(0), z.string(), z.null()]).optional().describe("Item count. e.g. number of items in the merkle tree"),
@@ -584,12 +584,15 @@ export declare const SendMessageOptionsSchema: z.ZodObject<{
584
584
  passportAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
585
585
  force: z.ZodOptional<z.ZodBoolean>;
586
586
  new_messenger_name: z.ZodOptional<z.ZodString>;
587
+ network: z.ZodOptional<z.ZodEnum<[import("@wowok/wowok").ENTRYPOINT.Localnet, import("@wowok/wowok").ENTRYPOINT.Testnet, import("@wowok/wowok").ENTRYPOINT.Mainnet]>>;
587
588
  }, "strip", z.ZodTypeAny, {
589
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
588
590
  guardAddress?: string | undefined;
589
591
  passportAddress?: string | undefined;
590
592
  force?: boolean | undefined;
591
593
  new_messenger_name?: string | undefined;
592
594
  }, {
595
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
593
596
  guardAddress?: string | undefined;
594
597
  passportAddress?: string | undefined;
595
598
  force?: boolean | undefined;
@@ -602,7 +605,9 @@ export declare const SendFileOptionsSchema: z.ZodObject<{
602
605
  passportAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
603
606
  force: z.ZodOptional<z.ZodBoolean>;
604
607
  new_messenger_name: z.ZodOptional<z.ZodString>;
608
+ network: z.ZodOptional<z.ZodEnum<[import("@wowok/wowok").ENTRYPOINT.Localnet, import("@wowok/wowok").ENTRYPOINT.Testnet, import("@wowok/wowok").ENTRYPOINT.Mainnet]>>;
605
609
  }, "strip", z.ZodTypeAny, {
610
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
606
611
  fileName?: string | undefined;
607
612
  contentType?: "wip" | "zip" | "wts" | undefined;
608
613
  guardAddress?: string | undefined;
@@ -610,6 +615,7 @@ export declare const SendFileOptionsSchema: z.ZodObject<{
610
615
  force?: boolean | undefined;
611
616
  new_messenger_name?: string | undefined;
612
617
  }, {
618
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
613
619
  fileName?: string | undefined;
614
620
  contentType?: "wip" | "zip" | "wts" | undefined;
615
621
  guardAddress?: string | undefined;
@@ -1478,12 +1484,15 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
1478
1484
  passportAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1479
1485
  force: z.ZodOptional<z.ZodBoolean>;
1480
1486
  new_messenger_name: z.ZodOptional<z.ZodString>;
1487
+ network: z.ZodOptional<z.ZodEnum<[import("@wowok/wowok").ENTRYPOINT.Localnet, import("@wowok/wowok").ENTRYPOINT.Testnet, import("@wowok/wowok").ENTRYPOINT.Mainnet]>>;
1481
1488
  }, "strip", z.ZodTypeAny, {
1489
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
1482
1490
  guardAddress?: string | undefined;
1483
1491
  passportAddress?: string | undefined;
1484
1492
  force?: boolean | undefined;
1485
1493
  new_messenger_name?: string | undefined;
1486
1494
  }, {
1495
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
1487
1496
  guardAddress?: string | undefined;
1488
1497
  passportAddress?: string | undefined;
1489
1498
  force?: boolean | undefined;
@@ -1497,6 +1506,7 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
1497
1506
  local_mark_first?: boolean | undefined;
1498
1507
  };
1499
1508
  options?: {
1509
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
1500
1510
  guardAddress?: string | undefined;
1501
1511
  passportAddress?: string | undefined;
1502
1512
  force?: boolean | undefined;
@@ -1511,6 +1521,7 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
1511
1521
  local_mark_first?: boolean | undefined;
1512
1522
  };
1513
1523
  options?: {
1524
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
1514
1525
  guardAddress?: string | undefined;
1515
1526
  passportAddress?: string | undefined;
1516
1527
  force?: boolean | undefined;
@@ -1538,7 +1549,9 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
1538
1549
  passportAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1539
1550
  force: z.ZodOptional<z.ZodBoolean>;
1540
1551
  new_messenger_name: z.ZodOptional<z.ZodString>;
1552
+ network: z.ZodOptional<z.ZodEnum<[import("@wowok/wowok").ENTRYPOINT.Localnet, import("@wowok/wowok").ENTRYPOINT.Testnet, import("@wowok/wowok").ENTRYPOINT.Mainnet]>>;
1541
1553
  }, "strip", z.ZodTypeAny, {
1554
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
1542
1555
  fileName?: string | undefined;
1543
1556
  contentType?: "wip" | "zip" | "wts" | undefined;
1544
1557
  guardAddress?: string | undefined;
@@ -1546,6 +1559,7 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
1546
1559
  force?: boolean | undefined;
1547
1560
  new_messenger_name?: string | undefined;
1548
1561
  }, {
1562
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
1549
1563
  fileName?: string | undefined;
1550
1564
  contentType?: "wip" | "zip" | "wts" | undefined;
1551
1565
  guardAddress?: string | undefined;
@@ -1561,6 +1575,7 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
1561
1575
  local_mark_first?: boolean | undefined;
1562
1576
  };
1563
1577
  options?: {
1578
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
1564
1579
  fileName?: string | undefined;
1565
1580
  contentType?: "wip" | "zip" | "wts" | undefined;
1566
1581
  guardAddress?: string | undefined;
@@ -1577,6 +1592,7 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
1577
1592
  local_mark_first?: boolean | undefined;
1578
1593
  };
1579
1594
  options?: {
1595
+ network?: import("@wowok/wowok").ENTRYPOINT | undefined;
1580
1596
  fileName?: string | undefined;
1581
1597
  contentType?: "wip" | "zip" | "wts" | undefined;
1582
1598
  guardAddress?: string | undefined;
@@ -2256,16 +2272,16 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
2256
2272
  operation: z.ZodLiteral<"proof_message">;
2257
2273
  account: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
2258
2274
  messageId: z.ZodString;
2259
- network: z.ZodOptional<z.ZodEnum<[import("@wowok/wowok").ENTRYPOINT.Localnet, import("@wowok/wowok").ENTRYPOINT.Testnet, import("@wowok/wowok").ENTRYPOINT.Mainnet]>>;
2275
+ network: z.ZodEnum<[import("@wowok/wowok").ENTRYPOINT.Localnet, import("@wowok/wowok").ENTRYPOINT.Testnet, import("@wowok/wowok").ENTRYPOINT.Mainnet]>;
2260
2276
  }, "strip", z.ZodTypeAny, {
2277
+ network: import("@wowok/wowok").ENTRYPOINT;
2261
2278
  operation: "proof_message";
2262
2279
  messageId: string;
2263
- network?: import("@wowok/wowok").ENTRYPOINT | undefined;
2264
2280
  account?: string | undefined;
2265
2281
  }, {
2282
+ network: import("@wowok/wowok").ENTRYPOINT;
2266
2283
  operation: "proof_message";
2267
2284
  messageId: string;
2268
- network?: import("@wowok/wowok").ENTRYPOINT | undefined;
2269
2285
  account?: string | undefined;
2270
2286
  }>, z.ZodObject<{
2271
2287
  operation: z.ZodLiteral<"blacklist">;
@@ -1,5 +1,6 @@
1
1
  import { z } from "zod";
2
2
  import { NameOrAddressSchema, EntrypointSchema, AccountOrMark_AddressAISchema, ManyAccountOrMark_AddressAISchema } from "../common/index.js";
3
+ import { NORMAL_MESSAGE_BYTES_LIMIT } from "@wowok/wowok";
3
4
  export const MessageStatusSchema = z.enum(["pending", "confirmed", "read", "failed", "rejected", "decrypted", "decrypt_failed"]);
4
5
  export const MessageDirectionSchema = z.enum(["sent", "received"]);
5
6
  export const MessageTypeSchema = z.union([z.literal(1), z.literal(3)]);
@@ -106,19 +107,21 @@ export const MessageFilterSchema = z.object({
106
107
  skipAutoMarkViewed: z.boolean().optional().describe("If true, messages returned by this query will NOT be automatically marked as viewed. Default is false, meaning messages are auto-marked as viewed when retrieved through watch_messages"),
107
108
  }).describe("Message filter options - all conditions are optional and combined with AND logic. Use viewed field to filter by read/unread status, and viewedAtStart/viewedAtEnd to filter by when messages were viewed");
108
109
  export const SendMessageOptionsSchema = z.object({
109
- guardAddress: NameOrAddressSchema.optional().describe("Guard address"),
110
- passportAddress: NameOrAddressSchema.optional().describe("Passport address"),
110
+ guardAddress: NameOrAddressSchema.optional().describe("Guard address. REQUIRED when sending Guard-verified messages"),
111
+ passportAddress: NameOrAddressSchema.optional().describe("Passport address. REQUIRED when sending Guard-verified messages"),
111
112
  force: z.boolean().optional().describe("Force send even if there are pending Guard messages"),
112
113
  new_messenger_name: z.string().optional().describe("New messenger name for recipient"),
113
- }).describe("Send message options");
114
+ network: EntrypointSchema.optional().describe("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"),
115
+ }).describe("Send message options. When guardAddress + passportAddress are provided, the message enters Guard verification flow and network MUST be specified");
114
116
  export const SendFileOptionsSchema = z.object({
115
117
  fileName: z.string().optional().describe("Custom file name"),
116
118
  contentType: z.enum(["wts", "wip", "zip"]).optional().describe("Content type hint"),
117
- guardAddress: NameOrAddressSchema.optional().describe("Guard address"),
118
- passportAddress: NameOrAddressSchema.optional().describe("Passport address"),
119
+ guardAddress: NameOrAddressSchema.optional().describe("Guard address. REQUIRED when sending Guard-verified files"),
120
+ passportAddress: NameOrAddressSchema.optional().describe("Passport address. REQUIRED when sending Guard-verified files"),
119
121
  force: z.boolean().optional().describe("Force send even if there are pending Guard messages"),
120
122
  new_messenger_name: z.string().optional().describe("New messenger name for recipient"),
121
- }).describe("Send file options");
123
+ network: EntrypointSchema.optional().describe("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"),
124
+ }).describe("Send file options. When guardAddress + passportAddress are provided, the file enters Guard verification flow and network MUST be specified");
122
125
  export const SendMessageResultSchema = z.object({
123
126
  messageId: z.string().describe("Message ID"),
124
127
  status: MessageStatusSchema.describe("Message status"),
@@ -294,7 +297,7 @@ export const MessengerOperationInputSchema = z.discriminatedUnion("operation", [
294
297
  operation: z.literal("send_message"),
295
298
  from: NameOrAddressSchema.optional().describe("Sender account name or address. If not specified, uses default account"),
296
299
  to: AccountOrMark_AddressAISchema.describe("Recipient address or account name - can be a string (name/address) or full object"),
297
- content: z.string().max(10000).describe("Message content text"),
300
+ content: z.string().max(NORMAL_MESSAGE_BYTES_LIMIT).describe("Message content text (max 10240 bytes)"),
298
301
  options: SendMessageOptionsSchema.optional().describe("Optional message settings"),
299
302
  }),
300
303
  z.object({
@@ -337,7 +340,7 @@ export const MessengerOperationInputSchema = z.discriminatedUnion("operation", [
337
340
  operation: z.literal("proof_message"),
338
341
  account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
339
342
  messageId: z.string().describe("Message ID to proof on-chain"),
340
- network: EntrypointSchema.optional().describe("Network to use for on-chain proof"),
343
+ network: EntrypointSchema.describe("Network to use for on-chain proof (required)"),
341
344
  }),
342
345
  z.object({
343
346
  operation: z.literal("blacklist"),
@@ -2,7 +2,7 @@
2
2
  "$schema": "http://json-schema.org/draft-07/schema#",
3
3
  "title": "WoWok MCP Schema Index",
4
4
  "description": "Index of all available JSON schemas for WoWok MCP tools",
5
- "generatedAt": "2026-07-11T23:01:05.088Z",
5
+ "generatedAt": "2026-07-13T08:10:04.689Z",
6
6
  "tools": [
7
7
  {
8
8
  "name": "onchain_operations",
@@ -105,19 +105,19 @@
105
105
  },
106
106
  "content": {
107
107
  "type": "string",
108
- "maxLength": 10000,
109
- "description": "Message content text"
108
+ "maxLength": 10240,
109
+ "description": "Message content text (max 10240 bytes)"
110
110
  },
111
111
  "options": {
112
112
  "type": "object",
113
113
  "properties": {
114
114
  "guardAddress": {
115
115
  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
116
- "description": "Guard address"
116
+ "description": "Guard address. REQUIRED when sending Guard-verified messages"
117
117
  },
118
118
  "passportAddress": {
119
119
  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
120
- "description": "Passport address"
120
+ "description": "Passport address. REQUIRED when sending Guard-verified messages"
121
121
  },
122
122
  "force": {
123
123
  "type": "boolean",
@@ -126,6 +126,15 @@
126
126
  "new_messenger_name": {
127
127
  "type": "string",
128
128
  "description": "New messenger name for recipient"
129
+ },
130
+ "network": {
131
+ "type": "string",
132
+ "enum": [
133
+ "localnet",
134
+ "testnet",
135
+ "mainnet"
136
+ ],
137
+ "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"
129
138
  }
130
139
  },
131
140
  "additionalProperties": false,
@@ -183,11 +192,11 @@
183
192
  },
184
193
  "guardAddress": {
185
194
  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
186
- "description": "Guard address"
195
+ "description": "Guard address. REQUIRED when sending Guard-verified files"
187
196
  },
188
197
  "passportAddress": {
189
198
  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
190
- "description": "Passport address"
199
+ "description": "Passport address. REQUIRED when sending Guard-verified files"
191
200
  },
192
201
  "force": {
193
202
  "type": "boolean",
@@ -196,6 +205,10 @@
196
205
  "new_messenger_name": {
197
206
  "type": "string",
198
207
  "description": "New messenger name for recipient"
208
+ },
209
+ "network": {
210
+ "$ref": "#/definitions/messenger_operation/anyOf/1/properties/options/properties/network",
211
+ "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"
199
212
  }
200
213
  },
201
214
  "additionalProperties": false,
@@ -895,12 +908,13 @@
895
908
  "testnet",
896
909
  "mainnet"
897
910
  ],
898
- "description": "Network to use for on-chain proof"
911
+ "description": "Network to use for on-chain proof (required)"
899
912
  }
900
913
  },
901
914
  "required": [
902
915
  "operation",
903
- "messageId"
916
+ "messageId",
917
+ "network"
904
918
  ],
905
919
  "additionalProperties": false
906
920
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wowok/agent-mcp",
3
- "version": "2.3.11",
3
+ "version": "2.3.13",
4
4
  "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -36,7 +36,7 @@
36
36
  "license": "Apache-2.0",
37
37
  "dependencies": {
38
38
  "@modelcontextprotocol/sdk": "^1.29.0",
39
- "@wowok/wowok": "2.3.11",
39
+ "@wowok/wowok": "2.3.13",
40
40
  "lodash": "^4.18.1",
41
41
  "zod": "^3.25.76"
42
42
  },