@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/schema/messenger/index.js

@@ -1,475 +1 @@
-import { z } from "zod";
-import { NameOrAddressSchema, EntrypointSchema, AccountOrMark_AddressAISchema, ManyAccountOrMark_AddressAISchema } from "../common/index.js";
-import { SemanticSummarySchema } from "../call/base.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)]);
-export const MessageContentTypeSchema = z.enum(["text", "zip", "wts", "wip"]);
-export const MessageTimeFieldSchema = z.enum(["createdAt", "receivedAt", "serverTimestamp"]);
-export const RangeTypeSchema = z.enum(["time", "messageId", "seqIndex"]);
-export const ZipMetadataSchema = z.object({
-    fileName: z.string().describe("ZIP filename"),
-    fileSize: z.number().describe("File size in bytes"),
-    fileHash: z.string().describe("File SHA256 hash"),
-    contentType: MessageContentTypeSchema.describe("Content type"),
-    localCachePath: z.string().optional().describe("Local cache path"),
-    downloadedAt: z.number().optional().describe("Download timestamp"),
-}).describe("ZIP file metadata");
-export const ReplyToSchema = z.object({
-    messageId: z.string().describe("Replied-to message ID (unique within the conversation)"),
-}).describe("Reply (quote) relationship — references a previous message in the same conversation. The referenced message's sender/preview are resolved locally by messageId");
-export const MessageSchema = z.object({
-    messageId: z.string().describe("Message ID"),
-    fromAddress: z.string().describe("Sender address"),
-    toAddress: z.string().describe("Recipient address"),
-    plaintextHash: z.string().describe("Plaintext hash"),
-    plaintext: z.string().optional().describe("Decrypted plaintext (optional)"),
-    replyTo: ReplyToSchema.optional().describe("Quoted (replied-to) message reference, if this message replies to a previous one"),
-    guardAddress: z.string().optional().describe("Guard address"),
-    passportAddress: z.string().optional().describe("Passport address"),
-    lastReceivedLeafIndex: z.number().optional().describe("Last received leaf index"),
-    direction: MessageDirectionSchema.describe("Message direction"),
-    status: MessageStatusSchema.describe("Message status"),
-    msgType: MessageTypeSchema.describe("Message type"),
-    leafIndex: z.number().optional().describe("Leaf index"),
-    prevRoot: z.string().optional().describe("Previous Merkle Root"),
-    newRoot: z.string().optional().describe("Current Merkle Root"),
-    serverSignature: z.string().optional().describe("Server signature"),
-    serverTimestamp: z.number().optional().describe("Server confirmation timestamp"),
-    serverPublicKey: z.string().optional().describe("Server public key"),
-    arkConfirmed: z.object({
-        recipient: z.string().describe("Recipient address"),
-        recipientPublicKey: z.string().describe("Recipient public key"),
-        signature: z.string().describe("Recipient signature"),
-        timestamp: z.number().describe("ARK confirmation time"),
-    }).optional().describe("ARK confirmation"),
-    createdAt: z.number().describe("Message creation time (client)"),
-    receivedAt: z.number().optional().describe("Local reception time"),
-    zipMetadata: ZipMetadataSchema.optional().describe("ZIP file metadata"),
-    proof: z.string().optional().describe("On-chain proof object address"),
-    decryptError: z.string().optional().describe("Decryption failure reason"),
-    decryptAttempts: z.number().optional().describe("Number of decryption attempts"),
-    lastDecryptAttemptAt: z.number().optional().describe("Last decryption attempt timestamp"),
-    viewedAt: z.number().optional().describe("Timestamp when the current user viewed this message (local storage). If present, indicates the message has been viewed by the user. Only applicable to received messages (direction === 'received')"),
-}).describe("Message object");
-export const ConversationInfoSchema = z.object({
-    peerAddress: z.string().describe("Peer address"),
-    lastMessageAt: z.number().describe("Last message time"),
-    messageCount: z.number().describe("Total message count"),
-    unreadCount: z.number().describe("Unread message count - count of received messages that have not been viewed (viewedAt is undefined)"),
-    lastMessagePreview: z.string().optional().describe("Last message preview text"),
-    previewMessages: z.array(MessageSchema).optional().describe("Preview messages for this conversation (default 2 messages, sorted by time descending)"),
-}).describe("Conversation info with unread count and preview messages");
-export const ConversationsFilterSchema = z.object({
-    account: z.string().optional().describe("Account name or address to query conversations for. If not specified, uses default account"),
-    unreadOnly: z.boolean().optional().describe("If true, only return conversations with unread messages (unreadCount > 0). Useful for quickly finding conversations needing attention"),
-    startTime: z.number().optional().describe("Start timestamp (ms) for filtering conversations by lastMessageAt. Only returns conversations where lastMessageAt >= this value"),
-    endTime: z.number().optional().describe("End timestamp (ms) for filtering conversations by lastMessageAt. Only returns conversations where lastMessageAt <= this value"),
-    previewMessageCount: z.number().optional().describe("Number of preview messages to include for each conversation (default: 2). Set to 0 to disable preview messages. If > 0, preview messages are automatically included"),
-    sortBy: z.enum(["lastMessageAt", "unreadCount", "messageCount"]).optional().describe("Sort conversations by: 'lastMessageAt' = most recent activity first, 'unreadCount' = most unread messages first, 'messageCount' = most total messages first"),
-    sortOrder: z.enum(["asc", "desc"]).optional().describe("Sort order: 'asc' = ascending (oldest/smallest first), 'desc' = descending (newest/largest first). Default is 'desc' for time-based sorting"),
-    skipAutoMarkViewed: z.boolean().optional().describe("If true, preview messages will NOT be automatically marked as viewed when retrieved. Default is false, meaning preview messages are auto-marked as viewed"),
-}).describe("Conversations filter options - use unreadOnly to quickly find active conversations, and previewMessageCount to control how many recent messages are included");
-export const MessageFilterSchema = z.object({
-    account: z.string().optional().describe("Account to filter messages for"),
-    direction: MessageDirectionSchema.optional().describe("Filter by message direction"),
-    status: MessageStatusSchema.optional().describe("Filter by message status"),
-    peerAddress: AccountOrMark_AddressAISchema.optional().describe("Filter by peer address - can be a string (name/address) or full object"),
-    msgType: MessageTypeSchema.optional().describe("Filter by message type"),
-    contentType: MessageContentTypeSchema.optional().describe("Filter by content type"),
-    decryptedOnly: z.boolean().optional().describe("Only return decrypted messages"),
-    confirmedOnly: z.boolean().optional().describe("Only return confirmed messages"),
-    keyword: z.string().optional().describe("Search keyword in plaintext"),
-    sortOrder: z.enum(["asc", "desc"]).optional().describe("Sort order: asc or desc"),
-    limit: z.number().optional().describe("Return limit"),
-    offset: z.number().optional().describe("Pagination offset"),
-    timeField: MessageTimeFieldSchema.optional().describe("Time field for time filtering"),
-    startTime: z.number().optional().describe("Start timestamp (ms)"),
-    endTime: z.number().optional().describe("End timestamp (ms)"),
-    createdAtStart: z.number().optional().describe("Created at start time"),
-    createdAtEnd: z.number().optional().describe("Created at end time"),
-    receivedAtStart: z.number().optional().describe("Received at start time"),
-    receivedAtEnd: z.number().optional().describe("Received at end time"),
-    serverTimestampStart: z.number().optional().describe("Server timestamp start time"),
-    serverTimestampEnd: z.number().optional().describe("Server timestamp end time"),
-    arkConfirmedOnly: z.boolean().optional().describe("Only return ARK confirmed messages"),
-    arkTimestampStart: z.number().optional().describe("ARK timestamp start"),
-    arkTimestampEnd: z.number().optional().describe("ARK timestamp end"),
-    proofedOnly: z.boolean().optional().describe("Only return messages with proof"),
-    hasLastReceivedIndexOnly: z.boolean().optional().describe("Only return messages with lastReceivedLeafIndex"),
-    lastReceivedIndexMin: z.number().optional().describe("Min lastReceivedLeafIndex"),
-    lastReceivedIndexMax: z.number().optional().describe("Max lastReceivedLeafIndex"),
-    listFilterMode: z.enum(["friends", "guard", "stranger", "any"]).optional().describe("List filter mode: 'friends' = only messages from friends list, 'guard' = only messages from Guard list, 'stranger' = only messages from strangers (not in friends/guard lists), 'any' = no filtering (default)"),
-    customListFilter: z.object({
-        includeAddresses: z.array(z.string()).optional().describe("Include addresses - only return messages from these addresses (highest priority)"),
-        excludeAddresses: z.array(z.string()).optional().describe("Exclude addresses - exclude messages from these addresses"),
-        relation: z.enum(["union", "intersection"]).optional().describe("Address list relation: 'union' = combine lists as union, 'intersection' = combine lists as intersection"),
-    }).optional().describe("Custom list filter for advanced address-based filtering, works in combination with listFilterMode"),
-    viewed: z.boolean().optional().describe("Filter by viewed status: true = only viewed messages, false = only unviewed messages. A message is considered 'viewed' if viewedAt field exists. Only applicable to received messages"),
-    viewedAtStart: z.number().optional().describe("Filter by viewed timestamp start (inclusive). Only returns messages where viewedAt >= this value. Useful for finding recently viewed messages"),
-    viewedAtEnd: z.number().optional().describe("Filter by viewed timestamp end (inclusive). Only returns messages where viewedAt <= this value. Useful for finding messages viewed before a certain time"),
-    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. 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"),
-    enable_messenger: z.boolean().optional().describe("Auto-enable messenger for the sender account if not already enabled"),
-    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"),
-    replyTo: ReplyToSchema.optional().describe("Quote/reply to a previous message in the SAME conversation. The messageId MUST exist in local storage for the current conversation, otherwise sending fails"),
-}).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. 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"),
-    enable_messenger: z.boolean().optional().describe("Auto-enable messenger for the sender account if not already enabled"),
-    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"),
-    merkleData: z.object({
-        leafIndex: z.number().describe("Leaf index"),
-        prevRoot: z.string().describe("Previous Merkle Root"),
-        newRoot: z.string().describe("Current Merkle Root"),
-        serverSignature: z.string().describe("Server signature"),
-        serverTimestamp: z.number().describe("Server confirmation timestamp"),
-        serverPublicKey: z.string().describe("Server public key"),
-    }).optional().describe("Merkle Tree proof data"),
-    guardList: z.array(z.string()).optional().describe("Guard list (only returned on error)"),
-    lastReceivedLeafIndex: z.number().optional().describe("Last received leaf index (for message confirmation)"),
-}).describe("Send message result");
-const BaseRangeSchema = z.object({
-    type: RangeTypeSchema.describe("Range type"),
-    start: z.union([z.number(), z.string()]).describe("Start value"),
-    end: z.union([z.number(), z.string()]).describe("End value"),
-});
-export const TimeRangeSchema = BaseRangeSchema.extend({
-    type: z.literal("time"),
-    start: z.number(),
-    end: z.number(),
-});
-export const MessageIdRangeSchema = BaseRangeSchema.extend({
-    type: z.literal("messageId"),
-    start: z.string(),
-    end: z.string(),
-});
-export const SeqIndexRangeSchema = BaseRangeSchema.extend({
-    type: z.literal("seqIndex"),
-    start: z.number(),
-    end: z.number(),
-});
-export const WtsRangeSchema = z.discriminatedUnion("type", [
-    TimeRangeSchema,
-    MessageIdRangeSchema,
-    SeqIndexRangeSchema,
-]).describe("WTS range filter parameters");
-export const WtsGenerationParamsSchema = z.object({
-    myAccount: NameOrAddressSchema.describe("My account name or address (string)"),
-    peerAccount: AccountOrMark_AddressAISchema.describe("Peer account name or address - can be a string (name/address) or full object"),
-    range: WtsRangeSchema.optional().describe("Range filter parameters"),
-    excludePlaintext: z.boolean().optional().describe("Whether to exclude plaintext"),
-    outputDir: z.string().describe("Output directory path"),
-}).describe("WTS generation parameters");
-export const WtsFileResultSchema = z.object({
-    files: z.array(z.string()).describe("Generated WTS file paths"),
-    totalMessageCount: z.number().describe("Total message count"),
-    timeRange: z.object({
-        start: z.number().describe("Start time"),
-        end: z.number().describe("End time"),
-    }).describe("Time range"),
-}).describe("WTS file result");
-export const WtsSignatureVerificationSchema = z.object({
-    publicKey: z.string().describe("Signer public key"),
-    address: z.string().optional().describe("Signer address"),
-    valid: z.boolean().describe("Whether signature is valid"),
-}).describe("WTS signature verification details");
-export const WtsVerificationResultSchema = z.object({
-    valid: z.boolean().describe("Whether verification succeeded"),
-    error: z.string().optional().describe("Error message if verification failed"),
-    hashValid: z.boolean().describe("Whether hash validation passed"),
-    hasSignature: z.boolean().describe("Whether WTS has signatures"),
-    signatureValid: z.boolean().optional().describe("Whether signature validation passed"),
-    signatures: z.array(WtsSignatureVerificationSchema).optional().describe("Signature verification details"),
-}).describe("WTS verification result");
-export const WtsToHtmlOptionsSchema = z.object({
-    title: z.string().optional().describe("HTML document title"),
-    theme: z.enum(["light", "dark"]).optional().describe("HTML theme"),
-    outputPath: z.string().optional().describe("Output file path"),
-}).describe("WTS to HTML conversion options");
-export const AddressExistenceSchema = z.object({
-    address: z.string().describe("Address"),
-    exists: z.boolean().describe("Whether address exists in list"),
-}).describe("Address existence check result");
-export const GuardListItemSchema = z.object({
-    guardAddress: z.string().describe("Guard address"),
-    passportValiditySeconds: z.number().describe("Passport validity in seconds"),
-}).describe("Guard list item");
-export const ListOperationResponseSchema = z.object({
-    success: z.boolean().describe("Whether operation succeeded"),
-    operation: z.string().describe("Operation performed"),
-    modifiedCount: z.number().describe("Number of items modified"),
-    currentCount: z.number().describe("Current list size"),
-    maxCount: z.number().describe("Maximum list size"),
-    invalidAddresses: z.array(z.string()).optional().nullable().describe("Invalid addresses"),
-    existResults: z.array(AddressExistenceSchema).optional().nullable().describe("Existence check results"),
-    message: z.string().optional().nullable().describe("Operation message"),
-    currentList: z.array(z.string()).optional().nullable().describe("Current list content"),
-    currentGuardList: z.array(GuardListItemSchema).optional().nullable().describe("Current guard list content"),
-}).describe("List operation response");
-export const BlacklistOperationSchema = z.discriminatedUnion("op", [
-    z.object({
-        op: z.literal("add"),
-        users: ManyAccountOrMark_AddressAISchema.describe("Users to add to blacklist - can be array of strings (names/addresses) or full object"),
-    }),
-    z.object({
-        op: z.literal("remove"),
-        users: ManyAccountOrMark_AddressAISchema.describe("Users to remove from blacklist - can be array of strings (names/addresses) or full object"),
-    }),
-    z.object({
-        op: z.literal("clear"),
-    }),
-    z.object({
-        op: z.literal("get"),
-    }),
-    z.object({
-        op: z.literal("exist"),
-        users: ManyAccountOrMark_AddressAISchema.describe("Users to check existence - can be array of strings (names/addresses) or full object"),
-    }),
-]).describe("Blacklist management operation");
-export const FriendslistOperationSchema = z.discriminatedUnion("op", [
-    z.object({
-        op: z.literal("add"),
-        users: ManyAccountOrMark_AddressAISchema.describe("Users to add to friends list - can be array of strings (names/addresses) or full object"),
-    }),
-    z.object({
-        op: z.literal("remove"),
-        users: ManyAccountOrMark_AddressAISchema.describe("Users to remove from friends list - can be array of strings (names/addresses) or full object"),
-    }),
-    z.object({
-        op: z.literal("clear"),
-    }),
-    z.object({
-        op: z.literal("get"),
-    }),
-    z.object({
-        op: z.literal("exist"),
-        users: ManyAccountOrMark_AddressAISchema.describe("Users to check existence - can be array of strings (names/addresses) or full object"),
-    }),
-]).describe("Friends list management operation");
-export const GuardParamSchema = z.object({
-    guard: NameOrAddressSchema.describe("Guard address or name"),
-    passportValiditySeconds: z.number().min(10).max(315360000).describe("Passport validity in seconds (10s to 10 years)"),
-}).describe("Guard parameter");
-export const GuardlistOperationSchema = z.discriminatedUnion("op", [
-    z.object({
-        op: z.literal("add"),
-        guards: z.array(GuardParamSchema).min(1).max(10).describe("Guards to add to guard list"),
-    }),
-    z.object({
-        op: z.literal("remove"),
-        guards: z.array(NameOrAddressSchema).min(1).max(10).describe("Guard addresses to remove from guard list"),
-    }),
-    z.object({
-        op: z.literal("get"),
-    }),
-]).describe("Guard list management operation");
-export const SettingsOperationSchema = z.discriminatedUnion("op", [
-    z.object({
-        op: z.literal("get"),
-    }),
-    z.object({
-        op: z.literal("set"),
-        allowStrangerMessages: z.boolean().optional().describe("Allow messages from strangers"),
-        maxInboxSize: z.number().min(1).optional().describe("Maximum inbox size"),
-    }),
-]).describe("Settings management operation");
-export const GetSettingsResponseSchema = z.object({
-    allowStrangerMessages: z.boolean().optional().describe("Whether messages from strangers are allowed"),
-    maxInboxSize: z.number().optional().describe("Current maximum inbox size"),
-    minUserInboxSize: z.number().describe("Server minimum allowed inbox size limit"),
-    maxUserInboxSize: z.number().describe("Server maximum allowed inbox size limit"),
-    defaultAllowStrangerMessages: z.boolean().describe("Server default setting for allowing stranger messages"),
-}).describe("Get settings response");
-export const MessengerOperationInputSchema = z.discriminatedUnion("operation", [
-    z.object({
-        operation: z.literal("watch_conversations"),
-        filter: ConversationsFilterSchema.optional().describe("Conversations filter options - use unreadOnly to find conversations with unread messages, previewMessageCount to control message previews (default 2), and sortBy/sortOrder to customize sorting"),
-    }).strict(),
-    z.object({
-        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(NORMAL_MESSAGE_BYTES_LIMIT).describe("Message content text (max 10240 bytes)"),
-        options: SendMessageOptionsSchema.optional().describe("Optional message settings"),
-    }).strict(),
-    z.object({
-        operation: z.literal("send_file"),
-        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"),
-        filePath: z.string().describe("Local file path to send. File will be compressed as ZIP before sending"),
-        options: SendFileOptionsSchema.optional().describe("Optional file sending settings"),
-    }).strict(),
-    z.object({
-        operation: z.literal("watch_messages"),
-        filter: MessageFilterSchema.optional().describe("Message filter options"),
-    }).strict(),
-    z.object({
-        operation: z.literal("extract_zip_messages"),
-        account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
-        messages: z.array(z.union([z.string(), MessageSchema])).describe("Array of message objects or message IDs to extract"),
-        outputDir: z.string().describe("Output directory path for extracted files"),
-    }).strict(),
-    z.object({
-        operation: z.literal("generate_wts"),
-        params: WtsGenerationParamsSchema.describe("WTS generation parameters"),
-    }).strict(),
-    z.object({
-        operation: z.literal("verify_wts"),
-        wtsFilePath: z.string().describe("WTS file path to verify"),
-    }).strict(),
-    z.object({
-        operation: z.literal("sign_wts"),
-        wtsFilePath: z.string().describe("WTS file path to sign"),
-        account: NameOrAddressSchema.optional().describe("Account name or address to sign with. If not specified, uses default account"),
-        outputPath: z.string().optional().describe("Output file path. If not specified, saves to signed_*.wts"),
-    }).strict(),
-    z.object({
-        operation: z.literal("wts2html"),
-        wtsPath: z.string().describe("WTS file path or directory to convert"),
-        options: WtsToHtmlOptionsSchema.optional().describe("Conversion options"),
-    }).strict(),
-    z.object({
-        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.describe("Network to use for on-chain proof (required)"),
-    }).strict(),
-    z.object({
-        operation: z.literal("blacklist"),
-        account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
-        blacklist: BlacklistOperationSchema.describe("Blacklist management operation"),
-    }).strict(),
-    z.object({
-        operation: z.literal("friendslist"),
-        account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
-        friendslist: FriendslistOperationSchema.describe("Friends list management operation"),
-    }).strict(),
-    z.object({
-        operation: z.literal("guardlist"),
-        account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
-        guardlist: GuardlistOperationSchema.describe("Guard list management operation"),
-    }).strict(),
-    z.object({
-        operation: z.literal("settings"),
-        account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
-        settings: SettingsOperationSchema.describe("Settings management operation"),
-    }).strict(),
-    z.object({
-        operation: z.literal("mark_messages_as_viewed"),
-        account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
-        messageIds: z.array(z.string()).min(1).max(1000).describe("Array of message IDs to mark as viewed (1-1000 messages). Only messages belonging to this account will be marked"),
-    }).strict(),
-    z.object({
-        operation: z.literal("mark_conversation_as_viewed"),
-        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"),
-    }).strict(),
-    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"),
-    }).strict(),
-]).describe("Messenger operation input schema. PREREQUISITE: an account must ENABLE messenger before sending/receiving. " +
-    "There is NO 'enable' operation in this tool — enable via account_operation {messenger: {enabled: true, name_or_account: '<account>'}}, " +
-    "or implicitly via send_message/send_file with options.enable_messenger: true. " +
-    "Use proof_message to anchor a message's WTS proof on-chain (creates a Proof object consumable by Guards via proof.signer/proof.time queries).");
-export const MessengerOperationOutputSchema = z.object({
-    result: z.discriminatedUnion("operation", [
-        z.object({
-            operation: z.literal("watch_conversations"),
-            result: z.array(ConversationInfoSchema).describe("List of conversations"),
-        }),
-        z.object({
-            operation: z.literal("send_message"),
-            result: SendMessageResultSchema.describe("Send message result"),
-        }),
-        z.object({
-            operation: z.literal("send_file"),
-            result: SendMessageResultSchema.describe("Send file result"),
-        }),
-        z.object({
-            operation: z.literal("watch_messages"),
-            result: z.array(MessageSchema).describe("List of messages"),
-        }),
-        z.object({
-            operation: z.literal("extract_zip_messages"),
-            result: z.array(z.string()).describe("Extracted file paths"),
-        }),
-        z.object({
-            operation: z.literal("generate_wts"),
-            result: WtsFileResultSchema.describe("Generate WTS result"),
-        }),
-        z.object({
-            operation: z.literal("verify_wts"),
-            result: WtsVerificationResultSchema.describe("WTS verification result"),
-        }),
-        z.object({
-            operation: z.literal("sign_wts"),
-            result: z.string().describe("Signed WTS file path"),
-        }),
-        z.object({
-            operation: z.literal("wts2html"),
-            result: z.union([z.string(), z.array(z.string())]).describe("HTML string or file path(s)"),
-        }),
-        z.object({
-            operation: z.literal("proof_message"),
-            result: z.object({
-                proofAddress: z.string().describe("Proof object address on blockchain"),
-            }).describe("Proof message result"),
-        }),
-        z.object({
-            operation: z.literal("blacklist"),
-            op: z.enum(["add", "remove", "clear", "get", "exist"]).describe("Operation type"),
-            result: z.union([ListOperationResponseSchema, z.array(z.string())]).describe("Blacklist operation result"),
-        }),
-        z.object({
-            operation: z.literal("friendslist"),
-            op: z.enum(["add", "remove", "clear", "get", "exist"]).describe("Operation type"),
-            result: z.union([ListOperationResponseSchema, z.array(z.string())]).describe("Friends list operation result"),
-        }),
-        z.object({
-            operation: z.literal("guardlist"),
-            op: z.enum(["add", "remove", "get"]).describe("Operation type"),
-            result: ListOperationResponseSchema.describe("Guard list operation result"),
-        }),
-        z.object({
-            operation: z.literal("settings"),
-            op: z.enum(["get", "set"]).describe("Operation type"),
-            result: z.union([GetSettingsResponseSchema, z.boolean()]).describe("Settings operation result - GetSettingsResponse for 'get' operation, boolean for 'set' operation"),
-        }),
-        z.object({
-            operation: z.literal("mark_messages_as_viewed"),
-            result: z.number().describe("Number of messages successfully marked as viewed. Only messages that were previously unviewed are counted"),
-        }),
-        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"),
-        }),
-        z.object({
-            operation: z.literal("error"),
-            error: z.string().describe("Error message"),
-            error_code: z.string().optional().describe("Error code"),
-            retryable: z.boolean().optional().describe("Whether the operation is retryable"),
-            recovery_hint: z.string().optional().describe("Recovery hint"),
-        }).describe("Error response"),
-    ]).describe("Messenger operation result discriminated union"),
-    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for messenger operation"),
-}).describe("Messenger operation output schema");
+import{z}from'zod';import{NameOrAddressSchema,EntrypointSchema,AccountOrMark_AddressAISchema,ManyAccountOrMark_AddressAISchema}from'../common/index.js';import{SemanticSummarySchema}from'../call/base.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'](0x1),z['literal'](0x3)]);export const MessageContentTypeSchema=z['enum'](['text','zip','wts','wip']);export const MessageTimeFieldSchema=z['enum'](['createdAt','receivedAt','serverTimestamp']);export const RangeTypeSchema=z['enum'](['time','messageId','seqIndex']);export const ZipMetadataSchema=z['object']({'fileName':z['string']()['describe']('ZIP\x20filename'),'fileSize':z['number']()['describe']('File\x20size\x20in\x20bytes'),'fileHash':z['string']()['describe']('File\x20SHA256\x20hash'),'contentType':MessageContentTypeSchema['describe']('Content\x20type'),'localCachePath':z['string']()['optional']()['describe']('Local\x20cache\x20path'),'downloadedAt':z['number']()['optional']()['describe']('Download\x20timestamp')})['describe']('ZIP\x20file\x20metadata');export const ReplyToSchema=z['object']({'messageId':z['string']()['describe']('Replied-to\x20message\x20ID\x20(unique\x20within\x20the\x20conversation)')})['describe']('Reply\x20(quote)\x20relationship\x20—\x20references\x20a\x20previous\x20message\x20in\x20the\x20same\x20conversation.\x20The\x20referenced\x20message\x27s\x20sender/preview\x20are\x20resolved\x20locally\x20by\x20messageId');export const MessageSchema=z['object']({'messageId':z['string']()['describe']('Message\x20ID'),'fromAddress':z['string']()['describe']('Sender\x20address'),'toAddress':z['string']()['describe']('Recipient\x20address'),'plaintextHash':z['string']()['describe']('Plaintext\x20hash'),'plaintext':z['string']()['optional']()['describe']('Decrypted\x20plaintext\x20(optional)'),'replyTo':ReplyToSchema['optional']()['describe']('Quoted\x20(replied-to)\x20message\x20reference,\x20if\x20this\x20message\x20replies\x20to\x20a\x20previous\x20one'),'guardAddress':z['string']()['optional']()['describe']('Guard\x20address'),'passportAddress':z['string']()['optional']()['describe']('Passport\x20address'),'lastReceivedLeafIndex':z['number']()['optional']()['describe']('Last\x20received\x20leaf\x20index'),'direction':MessageDirectionSchema['describe']('Message\x20direction'),'status':MessageStatusSchema['describe']('Message\x20status'),'msgType':MessageTypeSchema['describe']('Message\x20type'),'leafIndex':z['number']()['optional']()['describe']('Leaf\x20index'),'prevRoot':z['string']()['optional']()['describe']('Previous\x20Merkle\x20Root'),'newRoot':z['string']()['optional']()['describe']('Current\x20Merkle\x20Root'),'serverSignature':z['string']()['optional']()['describe']('Server\x20signature'),'serverTimestamp':z['number']()['optional']()['describe']('Server\x20confirmation\x20timestamp'),'serverPublicKey':z['string']()['optional']()['describe']('Server\x20public\x20key'),'arkConfirmed':z['object']({'recipient':z['string']()['describe']('Recipient\x20address'),'recipientPublicKey':z['string']()['describe']('Recipient\x20public\x20key'),'signature':z['string']()['describe']('Recipient\x20signature'),'timestamp':z['number']()['describe']('ARK\x20confirmation\x20time')})['optional']()['describe']('ARK\x20confirmation'),'createdAt':z['number']()['describe']('Message\x20creation\x20time\x20(client)'),'receivedAt':z['number']()['optional']()['describe']('Local\x20reception\x20time'),'zipMetadata':ZipMetadataSchema['optional']()['describe']('ZIP\x20file\x20metadata'),'proof':z['string']()['optional']()['describe']('On-chain\x20proof\x20object\x20address'),'decryptError':z['string']()['optional']()['describe']('Decryption\x20failure\x20reason'),'decryptAttempts':z['number']()['optional']()['describe']('Number\x20of\x20decryption\x20attempts'),'lastDecryptAttemptAt':z['number']()['optional']()['describe']('Last\x20decryption\x20attempt\x20timestamp'),'viewedAt':z['number']()['optional']()['describe']('Timestamp\x20when\x20the\x20current\x20user\x20viewed\x20this\x20message\x20(local\x20storage).\x20If\x20present,\x20indicates\x20the\x20message\x20has\x20been\x20viewed\x20by\x20the\x20user.\x20Only\x20applicable\x20to\x20received\x20messages\x20(direction\x20===\x20\x27received\x27)')})['describe']('Message\x20object');export const ConversationInfoSchema=z['object']({'peerAddress':z['string']()['describe']('Peer\x20address'),'lastMessageAt':z['number']()['describe']('Last\x20message\x20time'),'messageCount':z['number']()['describe']('Total\x20message\x20count'),'unreadCount':z['number']()['describe']('Unread\x20message\x20count\x20-\x20count\x20of\x20received\x20messages\x20that\x20have\x20not\x20been\x20viewed\x20(viewedAt\x20is\x20undefined)'),'lastMessagePreview':z['string']()['optional']()['describe']('Last\x20message\x20preview\x20text'),'previewMessages':z['array'](MessageSchema)['optional']()['describe']('Preview\x20messages\x20for\x20this\x20conversation\x20(default\x202\x20messages,\x20sorted\x20by\x20time\x20descending)')})['describe']('Conversation\x20info\x20with\x20unread\x20count\x20and\x20preview\x20messages');export const ConversationsFilterSchema=z['object']({'account':z['string']()['optional']()['describe']('Account\x20name\x20or\x20address\x20to\x20query\x20conversations\x20for.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'unreadOnly':z['boolean']()['optional']()['describe']('If\x20true,\x20only\x20return\x20conversations\x20with\x20unread\x20messages\x20(unreadCount\x20>\x200).\x20Useful\x20for\x20quickly\x20finding\x20conversations\x20needing\x20attention'),'startTime':z['number']()['optional']()['describe']('Start\x20timestamp\x20(ms)\x20for\x20filtering\x20conversations\x20by\x20lastMessageAt.\x20Only\x20returns\x20conversations\x20where\x20lastMessageAt\x20>=\x20this\x20value'),'endTime':z['number']()['optional']()['describe']('End\x20timestamp\x20(ms)\x20for\x20filtering\x20conversations\x20by\x20lastMessageAt.\x20Only\x20returns\x20conversations\x20where\x20lastMessageAt\x20<=\x20this\x20value'),'previewMessageCount':z['number']()['optional']()['describe']('Number\x20of\x20preview\x20messages\x20to\x20include\x20for\x20each\x20conversation\x20(default:\x202).\x20Set\x20to\x200\x20to\x20disable\x20preview\x20messages.\x20If\x20>\x200,\x20preview\x20messages\x20are\x20automatically\x20included'),'sortBy':z['enum'](['lastMessageAt','unreadCount','messageCount'])['optional']()['describe']('Sort\x20conversations\x20by:\x20\x27lastMessageAt\x27\x20=\x20most\x20recent\x20activity\x20first,\x20\x27unreadCount\x27\x20=\x20most\x20unread\x20messages\x20first,\x20\x27messageCount\x27\x20=\x20most\x20total\x20messages\x20first'),'sortOrder':z['enum'](['asc','desc'])['optional']()['describe']('Sort\x20order:\x20\x27asc\x27\x20=\x20ascending\x20(oldest/smallest\x20first),\x20\x27desc\x27\x20=\x20descending\x20(newest/largest\x20first).\x20Default\x20is\x20\x27desc\x27\x20for\x20time-based\x20sorting'),'skipAutoMarkViewed':z['boolean']()['optional']()['describe']('If\x20true,\x20preview\x20messages\x20will\x20NOT\x20be\x20automatically\x20marked\x20as\x20viewed\x20when\x20retrieved.\x20Default\x20is\x20false,\x20meaning\x20preview\x20messages\x20are\x20auto-marked\x20as\x20viewed')})['describe']('Conversations\x20filter\x20options\x20-\x20use\x20unreadOnly\x20to\x20quickly\x20find\x20active\x20conversations,\x20and\x20previewMessageCount\x20to\x20control\x20how\x20many\x20recent\x20messages\x20are\x20included');export const MessageFilterSchema=z['object']({'account':z['string']()['optional']()['describe']('Account\x20to\x20filter\x20messages\x20for'),'direction':MessageDirectionSchema['optional']()['describe']('Filter\x20by\x20message\x20direction'),'status':MessageStatusSchema['optional']()['describe']('Filter\x20by\x20message\x20status'),'peerAddress':AccountOrMark_AddressAISchema['optional']()['describe']('Filter\x20by\x20peer\x20address\x20-\x20can\x20be\x20a\x20string\x20(name/address)\x20or\x20full\x20object'),'msgType':MessageTypeSchema['optional']()['describe']('Filter\x20by\x20message\x20type'),'contentType':MessageContentTypeSchema['optional']()['describe']('Filter\x20by\x20content\x20type'),'decryptedOnly':z['boolean']()['optional']()['describe']('Only\x20return\x20decrypted\x20messages'),'confirmedOnly':z['boolean']()['optional']()['describe']('Only\x20return\x20confirmed\x20messages'),'keyword':z['string']()['optional']()['describe']('Search\x20keyword\x20in\x20plaintext'),'sortOrder':z['enum'](['asc','desc'])['optional']()['describe']('Sort\x20order:\x20asc\x20or\x20desc'),'limit':z['number']()['optional']()['describe']('Return\x20limit'),'offset':z['number']()['optional']()['describe']('Pagination\x20offset'),'timeField':MessageTimeFieldSchema['optional']()['describe']('Time\x20field\x20for\x20time\x20filtering'),'startTime':z['number']()['optional']()['describe']('Start\x20timestamp\x20(ms)'),'endTime':z['number']()['optional']()['describe']('End\x20timestamp\x20(ms)'),'createdAtStart':z['number']()['optional']()['describe']('Created\x20at\x20start\x20time'),'createdAtEnd':z['number']()['optional']()['describe']('Created\x20at\x20end\x20time'),'receivedAtStart':z['number']()['optional']()['describe']('Received\x20at\x20start\x20time'),'receivedAtEnd':z['number']()['optional']()['describe']('Received\x20at\x20end\x20time'),'serverTimestampStart':z['number']()['optional']()['describe']('Server\x20timestamp\x20start\x20time'),'serverTimestampEnd':z['number']()['optional']()['describe']('Server\x20timestamp\x20end\x20time'),'arkConfirmedOnly':z['boolean']()['optional']()['describe']('Only\x20return\x20ARK\x20confirmed\x20messages'),'arkTimestampStart':z['number']()['optional']()['describe']('ARK\x20timestamp\x20start'),'arkTimestampEnd':z['number']()['optional']()['describe']('ARK\x20timestamp\x20end'),'proofedOnly':z['boolean']()['optional']()['describe']('Only\x20return\x20messages\x20with\x20proof'),'hasLastReceivedIndexOnly':z['boolean']()['optional']()['describe']('Only\x20return\x20messages\x20with\x20lastReceivedLeafIndex'),'lastReceivedIndexMin':z['number']()['optional']()['describe']('Min\x20lastReceivedLeafIndex'),'lastReceivedIndexMax':z['number']()['optional']()['describe']('Max\x20lastReceivedLeafIndex'),'listFilterMode':z['enum'](['friends','guard','stranger','any'])['optional']()['describe']('List\x20filter\x20mode:\x20\x27friends\x27\x20=\x20only\x20messages\x20from\x20friends\x20list,\x20\x27guard\x27\x20=\x20only\x20messages\x20from\x20Guard\x20list,\x20\x27stranger\x27\x20=\x20only\x20messages\x20from\x20strangers\x20(not\x20in\x20friends/guard\x20lists),\x20\x27any\x27\x20=\x20no\x20filtering\x20(default)'),'customListFilter':z['object']({'includeAddresses':z['array'](z['string']())['optional']()['describe']('Include\x20addresses\x20-\x20only\x20return\x20messages\x20from\x20these\x20addresses\x20(highest\x20priority)'),'excludeAddresses':z['array'](z['string']())['optional']()['describe']('Exclude\x20addresses\x20-\x20exclude\x20messages\x20from\x20these\x20addresses'),'relation':z['enum'](['union','intersection'])['optional']()['describe']('Address\x20list\x20relation:\x20\x27union\x27\x20=\x20combine\x20lists\x20as\x20union,\x20\x27intersection\x27\x20=\x20combine\x20lists\x20as\x20intersection')})['optional']()['describe']('Custom\x20list\x20filter\x20for\x20advanced\x20address-based\x20filtering,\x20works\x20in\x20combination\x20with\x20listFilterMode'),'viewed':z['boolean']()['optional']()['describe']('Filter\x20by\x20viewed\x20status:\x20true\x20=\x20only\x20viewed\x20messages,\x20false\x20=\x20only\x20unviewed\x20messages.\x20A\x20message\x20is\x20considered\x20\x27viewed\x27\x20if\x20viewedAt\x20field\x20exists.\x20Only\x20applicable\x20to\x20received\x20messages'),'viewedAtStart':z['number']()['optional']()['describe']('Filter\x20by\x20viewed\x20timestamp\x20start\x20(inclusive).\x20Only\x20returns\x20messages\x20where\x20viewedAt\x20>=\x20this\x20value.\x20Useful\x20for\x20finding\x20recently\x20viewed\x20messages'),'viewedAtEnd':z['number']()['optional']()['describe']('Filter\x20by\x20viewed\x20timestamp\x20end\x20(inclusive).\x20Only\x20returns\x20messages\x20where\x20viewedAt\x20<=\x20this\x20value.\x20Useful\x20for\x20finding\x20messages\x20viewed\x20before\x20a\x20certain\x20time'),'skipAutoMarkViewed':z['boolean']()['optional']()['describe']('If\x20true,\x20messages\x20returned\x20by\x20this\x20query\x20will\x20NOT\x20be\x20automatically\x20marked\x20as\x20viewed.\x20Default\x20is\x20false,\x20meaning\x20messages\x20are\x20auto-marked\x20as\x20viewed\x20when\x20retrieved\x20through\x20watch_messages')})['describe']('Message\x20filter\x20options\x20-\x20all\x20conditions\x20are\x20optional\x20and\x20combined\x20with\x20AND\x20logic.\x20Use\x20viewed\x20field\x20to\x20filter\x20by\x20read/unread\x20status,\x20and\x20viewedAtStart/viewedAtEnd\x20to\x20filter\x20by\x20when\x20messages\x20were\x20viewed');export const SendMessageOptionsSchema=z['object']({'guardAddress':NameOrAddressSchema['optional']()['describe']('Guard\x20address.\x20REQUIRED\x20when\x20sending\x20Guard-verified\x20messages'),'passportAddress':NameOrAddressSchema['optional']()['describe']('Passport\x20address.\x20REQUIRED\x20when\x20sending\x20Guard-verified\x20messages'),'force':z['boolean']()['optional']()['describe']('Force\x20send\x20even\x20if\x20there\x20are\x20pending\x20Guard\x20messages'),'enable_messenger':z['boolean']()['optional']()['describe']('Auto-enable\x20messenger\x20for\x20the\x20sender\x20account\x20if\x20not\x20already\x20enabled'),'network':EntrypointSchema['optional']()['describe']('Target\x20network\x20for\x20Guard\x20verification\x20(e.g.,\x20testnet,\x20mainnet).\x20REQUIRED\x20when\x20guardAddress\x20and\x20passportAddress\x20are\x20provided\x20—\x20Guard\x20messages\x20and\x20regular\x20messages\x20are\x20independent\x20data\x20systems\x20on\x20different\x20networks'),'replyTo':ReplyToSchema['optional']()['describe']('Quote/reply\x20to\x20a\x20previous\x20message\x20in\x20the\x20SAME\x20conversation.\x20The\x20messageId\x20MUST\x20exist\x20in\x20local\x20storage\x20for\x20the\x20current\x20conversation,\x20otherwise\x20sending\x20fails')})['describe']('Send\x20message\x20options.\x20When\x20guardAddress\x20+\x20passportAddress\x20are\x20provided,\x20the\x20message\x20enters\x20Guard\x20verification\x20flow\x20and\x20network\x20MUST\x20be\x20specified');export const SendFileOptionsSchema=z['object']({'fileName':z['string']()['optional']()['describe']('Custom\x20file\x20name'),'contentType':z['enum'](['wts','wip','zip'])['optional']()['describe']('Content\x20type\x20hint'),'guardAddress':NameOrAddressSchema['optional']()['describe']('Guard\x20address.\x20REQUIRED\x20when\x20sending\x20Guard-verified\x20files'),'passportAddress':NameOrAddressSchema['optional']()['describe']('Passport\x20address.\x20REQUIRED\x20when\x20sending\x20Guard-verified\x20files'),'force':z['boolean']()['optional']()['describe']('Force\x20send\x20even\x20if\x20there\x20are\x20pending\x20Guard\x20messages'),'enable_messenger':z['boolean']()['optional']()['describe']('Auto-enable\x20messenger\x20for\x20the\x20sender\x20account\x20if\x20not\x20already\x20enabled'),'network':EntrypointSchema['optional']()['describe']('Target\x20network\x20for\x20Guard\x20verification\x20(e.g.,\x20testnet,\x20mainnet).\x20REQUIRED\x20when\x20guardAddress\x20and\x20passportAddress\x20are\x20provided\x20—\x20Guard\x20messages\x20and\x20regular\x20messages\x20are\x20independent\x20data\x20systems\x20on\x20different\x20networks')})['describe']('Send\x20file\x20options.\x20When\x20guardAddress\x20+\x20passportAddress\x20are\x20provided,\x20the\x20file\x20enters\x20Guard\x20verification\x20flow\x20and\x20network\x20MUST\x20be\x20specified');export const SendMessageResultSchema=z['object']({'messageId':z['string']()['describe']('Message\x20ID'),'status':MessageStatusSchema['describe']('Message\x20status'),'merkleData':z['object']({'leafIndex':z['number']()['describe']('Leaf\x20index'),'prevRoot':z['string']()['describe']('Previous\x20Merkle\x20Root'),'newRoot':z['string']()['describe']('Current\x20Merkle\x20Root'),'serverSignature':z['string']()['describe']('Server\x20signature'),'serverTimestamp':z['number']()['describe']('Server\x20confirmation\x20timestamp'),'serverPublicKey':z['string']()['describe']('Server\x20public\x20key')})['optional']()['describe']('Merkle\x20Tree\x20proof\x20data'),'guardList':z['array'](z['string']())['optional']()['describe']('Guard\x20list\x20(only\x20returned\x20on\x20error)'),'lastReceivedLeafIndex':z['number']()['optional']()['describe']('Last\x20received\x20leaf\x20index\x20(for\x20message\x20confirmation)')})['describe']('Send\x20message\x20result');const BaseRangeSchema=z['object']({'type':RangeTypeSchema['describe']('Range\x20type'),'start':z['union']([z['number'](),z['string']()])['describe']('Start\x20value'),'end':z['union']([z['number'](),z['string']()])['describe']('End\x20value')});export const TimeRangeSchema=BaseRangeSchema['extend']({'type':z['literal']('time'),'start':z['number'](),'end':z['number']()});export const MessageIdRangeSchema=BaseRangeSchema['extend']({'type':z['literal']('messageId'),'start':z['string'](),'end':z['string']()});export const SeqIndexRangeSchema=BaseRangeSchema['extend']({'type':z['literal']('seqIndex'),'start':z['number'](),'end':z['number']()});export const WtsRangeSchema=z['discriminatedUnion']('type',[TimeRangeSchema,MessageIdRangeSchema,SeqIndexRangeSchema])['describe']('WTS\x20range\x20filter\x20parameters');export const WtsGenerationParamsSchema=z['object']({'myAccount':NameOrAddressSchema['describe']('My\x20account\x20name\x20or\x20address\x20(string)'),'peerAccount':AccountOrMark_AddressAISchema['describe']('Peer\x20account\x20name\x20or\x20address\x20-\x20can\x20be\x20a\x20string\x20(name/address)\x20or\x20full\x20object'),'range':WtsRangeSchema['optional']()['describe']('Range\x20filter\x20parameters'),'excludePlaintext':z['boolean']()['optional']()['describe']('Whether\x20to\x20exclude\x20plaintext'),'outputDir':z['string']()['optional']()['describe']('Output\x20directory\x20path.\x20If\x20not\x20specified,\x20defaults\x20to\x20the\x20workspace/wts\x20directory')})['describe']('WTS\x20generation\x20parameters');export const WtsFileResultSchema=z['object']({'files':z['array'](z['string']())['describe']('Generated\x20WTS\x20file\x20paths'),'totalMessageCount':z['number']()['describe']('Total\x20message\x20count'),'timeRange':z['object']({'start':z['number']()['describe']('Start\x20time'),'end':z['number']()['describe']('End\x20time')})['describe']('Time\x20range')})['describe']('WTS\x20file\x20result');export const WtsSignatureVerificationSchema=z['object']({'publicKey':z['string']()['describe']('Signer\x20public\x20key'),'address':z['string']()['optional']()['describe']('Signer\x20address'),'valid':z['boolean']()['describe']('Whether\x20signature\x20is\x20valid')})['describe']('WTS\x20signature\x20verification\x20details');export const WtsVerificationResultSchema=z['object']({'valid':z['boolean']()['describe']('Whether\x20verification\x20succeeded'),'error':z['string']()['optional']()['describe']('Error\x20message\x20if\x20verification\x20failed'),'hashValid':z['boolean']()['describe']('Whether\x20hash\x20validation\x20passed'),'hasSignature':z['boolean']()['describe']('Whether\x20WTS\x20has\x20signatures'),'signatureValid':z['boolean']()['optional']()['describe']('Whether\x20signature\x20validation\x20passed'),'signatures':z['array'](WtsSignatureVerificationSchema)['optional']()['describe']('Signature\x20verification\x20details')})['describe']('WTS\x20verification\x20result');export const WtsToHtmlOptionsSchema=z['object']({'title':z['string']()['optional']()['describe']('HTML\x20document\x20title'),'theme':z['enum'](['light','dark'])['optional']()['describe']('HTML\x20theme'),'outputPath':z['string']()['optional']()['describe']('Output\x20file\x20path')})['describe']('WTS\x20to\x20HTML\x20conversion\x20options');export const AddressExistenceSchema=z['object']({'address':z['string']()['describe']('Address'),'exists':z['boolean']()['describe']('Whether\x20address\x20exists\x20in\x20list')})['describe']('Address\x20existence\x20check\x20result');export const GuardListItemSchema=z['object']({'guardAddress':z['string']()['describe']('Guard\x20address'),'passportValiditySeconds':z['number']()['describe']('Passport\x20validity\x20in\x20seconds')})['describe']('Guard\x20list\x20item');export const ListOperationResponseSchema=z['object']({'success':z['boolean']()['describe']('Whether\x20operation\x20succeeded'),'operation':z['string']()['describe']('Operation\x20performed'),'modifiedCount':z['number']()['describe']('Number\x20of\x20items\x20modified'),'currentCount':z['number']()['describe']('Current\x20list\x20size'),'maxCount':z['number']()['describe']('Maximum\x20list\x20size'),'invalidAddresses':z['array'](z['string']())['optional']()['nullable']()['describe']('Invalid\x20addresses'),'existResults':z['array'](AddressExistenceSchema)['optional']()['nullable']()['describe']('Existence\x20check\x20results'),'message':z['string']()['optional']()['nullable']()['describe']('Operation\x20message'),'currentList':z['array'](z['string']())['optional']()['nullable']()['describe']('Current\x20list\x20content'),'currentGuardList':z['array'](GuardListItemSchema)['optional']()['nullable']()['describe']('Current\x20guard\x20list\x20content')})['describe']('List\x20operation\x20response');export const BlacklistOperationSchema=z['discriminatedUnion']('op',[z['object']({'op':z['literal']('add'),'users':ManyAccountOrMark_AddressAISchema['describe']('Users\x20to\x20add\x20to\x20blacklist\x20-\x20can\x20be\x20array\x20of\x20strings\x20(names/addresses)\x20or\x20full\x20object')}),z['object']({'op':z['literal']('remove'),'users':ManyAccountOrMark_AddressAISchema['describe']('Users\x20to\x20remove\x20from\x20blacklist\x20-\x20can\x20be\x20array\x20of\x20strings\x20(names/addresses)\x20or\x20full\x20object')}),z['object']({'op':z['literal']('clear')}),z['object']({'op':z['literal']('get')}),z['object']({'op':z['literal']('exist'),'users':ManyAccountOrMark_AddressAISchema['describe']('Users\x20to\x20check\x20existence\x20-\x20can\x20be\x20array\x20of\x20strings\x20(names/addresses)\x20or\x20full\x20object')})])['describe']('Blacklist\x20management\x20operation');export const FriendslistOperationSchema=z['discriminatedUnion']('op',[z['object']({'op':z['literal']('add'),'users':ManyAccountOrMark_AddressAISchema['describe']('Users\x20to\x20add\x20to\x20friends\x20list\x20-\x20can\x20be\x20array\x20of\x20strings\x20(names/addresses)\x20or\x20full\x20object')}),z['object']({'op':z['literal']('remove'),'users':ManyAccountOrMark_AddressAISchema['describe']('Users\x20to\x20remove\x20from\x20friends\x20list\x20-\x20can\x20be\x20array\x20of\x20strings\x20(names/addresses)\x20or\x20full\x20object')}),z['object']({'op':z['literal']('clear')}),z['object']({'op':z['literal']('get')}),z['object']({'op':z['literal']('exist'),'users':ManyAccountOrMark_AddressAISchema['describe']('Users\x20to\x20check\x20existence\x20-\x20can\x20be\x20array\x20of\x20strings\x20(names/addresses)\x20or\x20full\x20object')})])['describe']('Friends\x20list\x20management\x20operation');export const GuardParamSchema=z['object']({'guard':NameOrAddressSchema['describe']('Guard\x20address\x20or\x20name'),'passportValiditySeconds':z['number']()['min'](0xa)['max'](0x12cc0300)['describe']('Passport\x20validity\x20in\x20seconds\x20(10s\x20to\x2010\x20years)')})['describe']('Guard\x20parameter');export const GuardlistOperationSchema=z['discriminatedUnion']('op',[z['object']({'op':z['literal']('add'),'guards':z['array'](GuardParamSchema)['min'](0x1)['max'](0xa)['describe']('Guards\x20to\x20add\x20to\x20guard\x20list')}),z['object']({'op':z['literal']('remove'),'guards':z['array'](NameOrAddressSchema)['min'](0x1)['max'](0xa)['describe']('Guard\x20addresses\x20to\x20remove\x20from\x20guard\x20list')}),z['object']({'op':z['literal']('get')})])['describe']('Guard\x20list\x20management\x20operation');export const SettingsOperationSchema=z['discriminatedUnion']('op',[z['object']({'op':z['literal']('get')}),z['object']({'op':z['literal']('set'),'allowStrangerMessages':z['boolean']()['optional']()['describe']('Allow\x20messages\x20from\x20strangers'),'maxInboxSize':z['number']()['min'](0x1)['optional']()['describe']('Maximum\x20inbox\x20size')})])['describe']('Settings\x20management\x20operation');export const GetSettingsResponseSchema=z['object']({'allowStrangerMessages':z['boolean']()['optional']()['describe']('Whether\x20messages\x20from\x20strangers\x20are\x20allowed'),'maxInboxSize':z['number']()['optional']()['describe']('Current\x20maximum\x20inbox\x20size'),'minUserInboxSize':z['number']()['describe']('Server\x20minimum\x20allowed\x20inbox\x20size\x20limit'),'maxUserInboxSize':z['number']()['describe']('Server\x20maximum\x20allowed\x20inbox\x20size\x20limit'),'defaultAllowStrangerMessages':z['boolean']()['describe']('Server\x20default\x20setting\x20for\x20allowing\x20stranger\x20messages')})['describe']('Get\x20settings\x20response');export const MessengerOperationInputSchema=z['discriminatedUnion']('operation',[z['object']({'operation':z['literal']('watch_conversations'),'filter':ConversationsFilterSchema['optional']()['describe']('Conversations\x20filter\x20options\x20-\x20use\x20unreadOnly\x20to\x20find\x20conversations\x20with\x20unread\x20messages,\x20previewMessageCount\x20to\x20control\x20message\x20previews\x20(default\x202),\x20and\x20sortBy/sortOrder\x20to\x20customize\x20sorting')})['strict'](),z['object']({'operation':z['literal']('send_message'),'from':NameOrAddressSchema['optional']()['describe']('Sender\x20account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'to':AccountOrMark_AddressAISchema['describe']('Recipient\x20address\x20or\x20account\x20name\x20-\x20can\x20be\x20a\x20string\x20(name/address)\x20or\x20full\x20object'),'content':z['string']()['max'](NORMAL_MESSAGE_BYTES_LIMIT)['describe']('Message\x20content\x20text\x20(max\x2010240\x20bytes)'),'options':SendMessageOptionsSchema['optional']()['describe']('Optional\x20message\x20settings')})['strict'](),z['object']({'operation':z['literal']('send_file'),'from':NameOrAddressSchema['optional']()['describe']('Sender\x20account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'to':AccountOrMark_AddressAISchema['describe']('Recipient\x20address\x20or\x20account\x20name\x20-\x20can\x20be\x20a\x20string\x20(name/address)\x20or\x20full\x20object'),'filePath':z['string']()['describe']('Local\x20file\x20path\x20to\x20send.\x20File\x20will\x20be\x20compressed\x20as\x20ZIP\x20before\x20sending'),'options':SendFileOptionsSchema['optional']()['describe']('Optional\x20file\x20sending\x20settings')})['strict'](),z['object']({'operation':z['literal']('watch_messages'),'filter':MessageFilterSchema['optional']()['describe']('Message\x20filter\x20options')})['strict'](),z['object']({'operation':z['literal']('extract_zip_messages'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'messages':z['array'](z['union']([z['string'](),MessageSchema]))['describe']('Array\x20of\x20message\x20objects\x20or\x20message\x20IDs\x20to\x20extract'),'outputDir':z['string']()['optional']()['describe']('Output\x20directory\x20path\x20for\x20extracted\x20files.\x20If\x20not\x20specified,\x20defaults\x20to\x20the\x20workspace/extracted\x20directory')})['strict'](),z['object']({'operation':z['literal']('generate_wts'),'params':WtsGenerationParamsSchema['describe']('WTS\x20generation\x20parameters')})['strict'](),z['object']({'operation':z['literal']('verify_wts'),'wtsFilePath':z['string']()['describe']('WTS\x20file\x20path\x20to\x20verify')})['strict'](),z['object']({'operation':z['literal']('sign_wts'),'wtsFilePath':z['string']()['describe']('WTS\x20file\x20path\x20to\x20sign'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address\x20to\x20sign\x20with.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'outputPath':z['string']()['optional']()['describe']('Output\x20file\x20path.\x20If\x20not\x20specified,\x20saves\x20to\x20signed_*.wts')})['strict'](),z['object']({'operation':z['literal']('wts2html'),'wtsPath':z['string']()['describe']('WTS\x20file\x20path\x20or\x20directory\x20to\x20convert'),'options':WtsToHtmlOptionsSchema['optional']()['describe']('Conversion\x20options')})['strict'](),z['object']({'operation':z['literal']('proof_message'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'messageId':z['string']()['describe']('Message\x20ID\x20to\x20proof\x20on-chain'),'network':EntrypointSchema['describe']('Network\x20to\x20use\x20for\x20on-chain\x20proof\x20(required)')})['strict'](),z['object']({'operation':z['literal']('blacklist'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'blacklist':BlacklistOperationSchema['describe']('Blacklist\x20management\x20operation')})['strict'](),z['object']({'operation':z['literal']('friendslist'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'friendslist':FriendslistOperationSchema['describe']('Friends\x20list\x20management\x20operation')})['strict'](),z['object']({'operation':z['literal']('guardlist'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'guardlist':GuardlistOperationSchema['describe']('Guard\x20list\x20management\x20operation')})['strict'](),z['object']({'operation':z['literal']('settings'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'settings':SettingsOperationSchema['describe']('Settings\x20management\x20operation')})['strict'](),z['object']({'operation':z['literal']('mark_messages_as_viewed'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'messageIds':z['array'](z['string']())['min'](0x1)['max'](0x3e8)['describe']('Array\x20of\x20message\x20IDs\x20to\x20mark\x20as\x20viewed\x20(1-1000\x20messages).\x20Only\x20messages\x20belonging\x20to\x20this\x20account\x20will\x20be\x20marked')})['strict'](),z['object']({'operation':z['literal']('mark_conversation_as_viewed'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'peerAddress':AccountOrMark_AddressAISchema['describe']('Peer\x20address\x20or\x20account\x20name\x20-\x20can\x20be\x20a\x20string\x20(name/address)\x20or\x20full\x20object.\x20All\x20unviewed\x20received\x20messages\x20from\x20this\x20peer\x20will\x20be\x20marked\x20as\x20viewed')})['strict'](),z['object']({'operation':z['literal']('pull_messages'),'account':NameOrAddressSchema['optional']()['describe']('Account\x20name\x20or\x20address.\x20If\x20not\x20specified,\x20uses\x20default\x20account'),'limit':z['number']()['optional']()['describe']('Maximum\x20number\x20of\x20messages\x20to\x20pull\x20from\x20server')})['strict']()])['describe']('Messenger\x20operation\x20input\x20schema.\x20PREREQUISITE:\x20an\x20account\x20must\x20ENABLE\x20messenger\x20before\x20sending/receiving.\x20'+'There\x20is\x20NO\x20\x27enable\x27\x20operation\x20in\x20this\x20tool\x20—\x20enable\x20via\x20account_operation\x20{messenger:\x20{enabled:\x20true,\x20name_or_account:\x20\x27<account>\x27}},\x20'+'or\x20implicitly\x20via\x20send_message/send_file\x20with\x20options.enable_messenger:\x20true.\x20'+'Use\x20proof_message\x20to\x20anchor\x20a\x20message\x27s\x20WTS\x20proof\x20on-chain\x20(creates\x20a\x20Proof\x20object\x20consumable\x20by\x20Guards\x20via\x20proof.signer/proof.time\x20queries).');export const MessengerOperationOutputSchema=z['object']({'result':z['discriminatedUnion']('operation',[z['object']({'operation':z['literal']('watch_conversations'),'result':z['array'](ConversationInfoSchema)['describe']('List\x20of\x20conversations')}),z['object']({'operation':z['literal']('send_message'),'result':SendMessageResultSchema['describe']('Send\x20message\x20result')}),z['object']({'operation':z['literal']('send_file'),'result':SendMessageResultSchema['describe']('Send\x20file\x20result')}),z['object']({'operation':z['literal']('watch_messages'),'result':z['array'](MessageSchema)['describe']('List\x20of\x20messages')}),z['object']({'operation':z['literal']('extract_zip_messages'),'result':z['array'](z['string']())['describe']('Extracted\x20file\x20paths')}),z['object']({'operation':z['literal']('generate_wts'),'result':WtsFileResultSchema['describe']('Generate\x20WTS\x20result')}),z['object']({'operation':z['literal']('verify_wts'),'result':WtsVerificationResultSchema['describe']('WTS\x20verification\x20result')}),z['object']({'operation':z['literal']('sign_wts'),'result':z['string']()['describe']('Signed\x20WTS\x20file\x20path')}),z['object']({'operation':z['literal']('wts2html'),'result':z['union']([z['string'](),z['array'](z['string']())])['describe']('Output\x20file\x20path(s)\x20(always\x20writes\x20files;\x20never\x20returns\x20raw\x20HTML)')}),z['object']({'operation':z['literal']('proof_message'),'result':z['object']({'proofAddress':z['string']()['describe']('Proof\x20object\x20address\x20on\x20blockchain')})['describe']('Proof\x20message\x20result')}),z['object']({'operation':z['literal']('blacklist'),'op':z['enum'](['add','remove','clear','get','exist'])['describe']('Operation\x20type'),'result':z['union']([ListOperationResponseSchema,z['array'](z['string']())])['describe']('Blacklist\x20operation\x20result')}),z['object']({'operation':z['literal']('friendslist'),'op':z['enum'](['add','remove','clear','get','exist'])['describe']('Operation\x20type'),'result':z['union']([ListOperationResponseSchema,z['array'](z['string']())])['describe']('Friends\x20list\x20operation\x20result')}),z['object']({'operation':z['literal']('guardlist'),'op':z['enum'](['add','remove','get'])['describe']('Operation\x20type'),'result':ListOperationResponseSchema['describe']('Guard\x20list\x20operation\x20result')}),z['object']({'operation':z['literal']('settings'),'op':z['enum'](['get','set'])['describe']('Operation\x20type'),'result':z['union']([GetSettingsResponseSchema,z['boolean']()])['describe']('Settings\x20operation\x20result\x20-\x20GetSettingsResponse\x20for\x20\x27get\x27\x20operation,\x20boolean\x20for\x20\x27set\x27\x20operation')}),z['object']({'operation':z['literal']('mark_messages_as_viewed'),'result':z['number']()['describe']('Number\x20of\x20messages\x20successfully\x20marked\x20as\x20viewed.\x20Only\x20messages\x20that\x20were\x20previously\x20unviewed\x20are\x20counted')}),z['object']({'operation':z['literal']('mark_conversation_as_viewed'),'result':z['number']()['describe']('Number\x20of\x20messages\x20successfully\x20marked\x20as\x20viewed\x20in\x20the\x20conversation.\x20Only\x20received\x20messages\x20that\x20were\x20previously\x20unviewed\x20are\x20counted')}),z['object']({'operation':z['literal']('pull_messages'),'result':z['array'](MessageSchema)['describe']('List\x20of\x20messages\x20pulled\x20from\x20server')}),z['object']({'operation':z['literal']('error'),'error':z['string']()['describe']('Error\x20message'),'error_code':z['string']()['optional']()['describe']('Error\x20code'),'retryable':z['boolean']()['optional']()['describe']('Whether\x20the\x20operation\x20is\x20retryable'),'recovery_hint':z['string']()['optional']()['describe']('Recovery\x20hint')})['describe']('Error\x20response')])['describe']('Messenger\x20operation\x20result\x20discriminated\x20union'),'semantic':SemanticSummarySchema['optional']()['describe']('Business\x20semantic\x20summary\x20for\x20messenger\x20operation')})['describe']('Messenger\x20operation\x20output\x20schema');