wowok_agent 1.6.6 → 2.1.8

package/dist/schema/messenger/index.js

@@ -0,0 +1,407 @@
+import { z } from "zod";
+import { NameOrAddressSchema, EntrypointSchema, ManyAccountOrMark_AddressSchema, AccountOrMark_AddressSchema } from "../common/index.js";
+// ============================================================
+// Messenger Schema Definitions (strictly based on messenger-api.ts and types.ts)
+// ============================================================
+// Enums from types.ts
+export const MessageStatusSchema = z.enum(["pending", "confirmed", "read", "failed", "rejected"]);
+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"]);
+// ZipMetadata
+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");
+// Message
+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)"),
+    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"),
+}).describe("Message object");
+// ConversationInfo
+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"),
+    lastMessagePreview: z.string().optional().describe("Last message preview"),
+}).describe("Conversation info");
+// MessageFilter
+export const MessageFilterSchema = z.object({
+    direction: MessageDirectionSchema.optional().describe("Filter by message direction"),
+    status: MessageStatusSchema.optional().describe("Filter by message status"),
+    peerAddress: AccountOrMark_AddressSchema.optional().describe("Filter by peer address"),
+    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"),
+    customListFilter: z.object({
+        includeAddresses: z.array(z.string()).optional().describe("Include addresses"),
+        excludeAddresses: z.array(z.string()).optional().describe("Exclude addresses"),
+        relation: z.enum(["union", "intersection"]).optional().describe("Address list relation"),
+    }).optional().describe("Custom list filter"),
+    account: NameOrAddressSchema.optional().describe("Account to filter messages for"),
+}).describe("Message filter options");
+// SendMessageOptions
+export const SendMessageOptionsSchema = z.object({
+    guardAddress: NameOrAddressSchema.optional().describe("Guard address"),
+    passportAddress: NameOrAddressSchema.optional().describe("Passport address"),
+    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");
+// SendFileOptions
+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"),
+    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");
+// SendMessageResult
+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)"),
+}).describe("Send message result");
+// WTS Range Types
+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");
+// WtsGenerationParams
+export const WtsGenerationParamsSchema = z.object({
+    myAccount: NameOrAddressSchema.describe("My account name or address"),
+    peerAccount: NameOrAddressSchema.describe("Peer account or address"),
+    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");
+// WtsFileResult
+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");
+// WtsVerificationResult
+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().optional().describe("Whether hash validation passed"),
+    hasSignature: z.boolean().optional().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");
+// WtsToHtmlOptions
+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");
+// List Operation Response
+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().describe("Invalid addresses"),
+    existResults: z.array(AddressExistenceSchema).optional().describe("Existence check results"),
+    message: z.string().optional().describe("Operation message"),
+    currentList: z.array(z.string()).optional().describe("Current list content"),
+    currentGuardList: z.array(GuardListItemSchema).optional().describe("Current guard list content"),
+}).describe("List operation response");
+// Blacklist Operations
+export const BlacklistOperationSchema = z.discriminatedUnion("op", [
+    z.object({
+        op: z.literal("add"),
+        users: ManyAccountOrMark_AddressSchema.describe("Users to add to blacklist"),
+    }),
+    z.object({
+        op: z.literal("remove"),
+        users: ManyAccountOrMark_AddressSchema.describe("Users to remove from blacklist"),
+    }),
+    z.object({
+        op: z.literal("clear"),
+    }),
+    z.object({
+        op: z.literal("get"),
+    }),
+    z.object({
+        op: z.literal("exist"),
+        users: ManyAccountOrMark_AddressSchema.describe("Users to check existence"),
+    }),
+]).describe("Blacklist management operation");
+// Friendslist Operations
+export const FriendslistOperationSchema = z.discriminatedUnion("op", [
+    z.object({
+        op: z.literal("add"),
+        users: ManyAccountOrMark_AddressSchema.describe("Users to add to friends list"),
+    }),
+    z.object({
+        op: z.literal("remove"),
+        users: ManyAccountOrMark_AddressSchema.describe("Users to remove from friends list"),
+    }),
+    z.object({
+        op: z.literal("clear"),
+    }),
+    z.object({
+        op: z.literal("get"),
+    }),
+    z.object({
+        op: z.literal("exist"),
+        users: ManyAccountOrMark_AddressSchema.describe("Users to check existence"),
+    }),
+]).describe("Friends list management operation");
+// Guardlist Operations
+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");
+// ============================================================
+// Input Schema (Discriminated Union by "operation")
+// ============================================================
+export const MessengerOperationInputSchema = z.discriminatedUnion("operation", [
+    z.object({
+        operation: z.literal("watch_conversations"),
+        account: NameOrAddressSchema.optional().describe("Account name or address. If not specified, uses default account"),
+    }),
+    z.object({
+        operation: z.literal("send_message"),
+        from: NameOrAddressSchema.optional().describe("Sender account name or address. If not specified, uses default account"),
+        to: AccountOrMark_AddressSchema.describe("Recipient address or account name"),
+        content: z.string().max(10000).describe("Message content text"),
+        options: SendMessageOptionsSchema.optional().describe("Optional message settings"),
+    }),
+    z.object({
+        operation: z.literal("send_file"),
+        from: NameOrAddressSchema.optional().describe("Sender account name or address. If not specified, uses default account"),
+        to: AccountOrMark_AddressSchema.describe("Recipient address or account name"),
+        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"),
+    }),
+    z.object({
+        operation: z.literal("watch_messages"),
+        filter: MessageFilterSchema.optional().describe("Message filter options"),
+    }),
+    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"),
+    }),
+    z.object({
+        operation: z.literal("generate_wts"),
+        params: WtsGenerationParamsSchema.describe("WTS generation parameters"),
+    }),
+    z.object({
+        operation: z.literal("verify_wts"),
+        wtsFilePath: z.string().describe("WTS file path to verify"),
+    }),
+    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"),
+    }),
+    z.object({
+        operation: z.literal("wts2html"),
+        wtsPath: z.string().describe("WTS file path or directory to convert"),
+        options: WtsToHtmlOptionsSchema.optional().describe("Conversion options"),
+    }),
+    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.optional().describe("Network to use for on-chain proof"),
+    }),
+    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"),
+    }),
+    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"),
+    }),
+    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"),
+    }),
+]).describe("Messenger operation input schema");
+// ============================================================
+// Output Schema (Discriminated Union by "operation")
+// ============================================================
+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"),
+        }),
+    ]).describe("Messenger operation output schema")
+});