@wowok/agent-mcp 2.3.12 → 2.3.14

package/dist/schema/messenger/index.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { NameOrAddressSchema, EntrypointSchema, AccountOrMark_AddressAISchema, ManyAccountOrMark_AddressAISchema } from "../common/index.js";
+import { NORMAL_MESSAGE_BYTES_LIMIT } from "@wowok/wowok";
 export const MessageStatusSchema = z.enum(["pending", "confirmed", "read", "failed", "rejected", "decrypted", "decrypt_failed"]);
 export const MessageDirectionSchema = z.enum(["sent", "received"]);
 export const MessageTypeSchema = z.union([z.literal(1), z.literal(3)]);
@@ -106,19 +107,21 @@ export const MessageFilterSchema = z.object({
     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"),
 }).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");
 export const SendMessageOptionsSchema = z.object({
-    guardAddress: NameOrAddressSchema.optional().describe("Guard address"),
-    passportAddress: NameOrAddressSchema.optional().describe("Passport address"),
+    guardAddress: NameOrAddressSchema.optional().describe("Guard address. REQUIRED when sending Guard-verified messages"),
+    passportAddress: NameOrAddressSchema.optional().describe("Passport address. REQUIRED when sending Guard-verified messages"),
     force: z.boolean().optional().describe("Force send even if there are pending Guard messages"),
     new_messenger_name: z.string().optional().describe("New messenger name for recipient"),
-}).describe("Send message options");
+    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"),
+}).describe("Send message options. When guardAddress + passportAddress are provided, the message enters Guard verification flow and network MUST be specified");
 export const SendFileOptionsSchema = z.object({
     fileName: z.string().optional().describe("Custom file name"),
     contentType: z.enum(["wts", "wip", "zip"]).optional().describe("Content type hint"),
-    guardAddress: NameOrAddressSchema.optional().describe("Guard address"),
-    passportAddress: NameOrAddressSchema.optional().describe("Passport address"),
+    guardAddress: NameOrAddressSchema.optional().describe("Guard address. REQUIRED when sending Guard-verified files"),
+    passportAddress: NameOrAddressSchema.optional().describe("Passport address. REQUIRED when sending Guard-verified files"),
     force: z.boolean().optional().describe("Force send even if there are pending Guard messages"),
     new_messenger_name: z.string().optional().describe("New messenger name for recipient"),
-}).describe("Send file options");
+    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"),
+}).describe("Send file options. When guardAddress + passportAddress are provided, the file enters Guard verification flow and network MUST be specified");
 export const SendMessageResultSchema = z.object({
     messageId: z.string().describe("Message ID"),
     status: MessageStatusSchema.describe("Message status"),
@@ -294,7 +297,7 @@ export const MessengerOperationInputSchema = z.discriminatedUnion("operation", [
         operation: z.literal("send_message"),
         from: NameOrAddressSchema.optional().describe("Sender account name or address. If not specified, uses default account"),
         to: AccountOrMark_AddressAISchema.describe("Recipient address or account name - can be a string (name/address) or full object"),
-        content: z.string().max(10000).describe("Message content text"),
+        content: z.string().max(NORMAL_MESSAGE_BYTES_LIMIT).describe("Message content text (max 10240 bytes)"),
         options: SendMessageOptionsSchema.optional().describe("Optional message settings"),
     }),
     z.object({
@@ -337,7 +340,7 @@ export const MessengerOperationInputSchema = z.discriminatedUnion("operation", [
         operation: z.literal("proof_message"),
         account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
         messageId: z.string().describe("Message ID to proof on-chain"),
-        network: EntrypointSchema.optional().describe("Network to use for on-chain proof"),
+        network: EntrypointSchema.describe("Network to use for on-chain proof (required)"),
     }),
     z.object({
         operation: z.literal("blacklist"),
@@ -369,6 +372,11 @@ export const MessengerOperationInputSchema = z.discriminatedUnion("operation", [
         account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
         peerAddress: AccountOrMark_AddressAISchema.describe("Peer address or account name - can be a string (name/address) or full object. All unviewed received messages from this peer will be marked as viewed"),
     }),
+    z.object({
+        operation: z.literal("pull_messages"),
+        account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
+        limit: z.number().optional().describe("Maximum number of messages to pull from server"),
+    }),
 ]).describe("Messenger operation input schema");
 export const MessengerOperationOutputSchema = z.object({
     result: z.discriminatedUnion("operation", [
@@ -442,5 +450,9 @@ export const MessengerOperationOutputSchema = z.object({
             operation: z.literal("mark_conversation_as_viewed"),
             result: z.number().describe("Number of messages successfully marked as viewed in the conversation. Only received messages that were previously unviewed are counted"),
         }),
+        z.object({
+            operation: z.literal("pull_messages"),
+            result: z.array(MessageSchema).describe("List of messages pulled from server"),
+        }),
     ]).describe("Messenger operation result discriminated union"),
 }).describe("Messenger operation output schema");