@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/schemas/messenger_operation.schema.json

@@ -2,1446 +2,1664 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/messenger_operation.json",
   "title": "Messenger Operations",
-  "description": "WoWok encrypted messenger operations",
-  "$ref": "#/definitions/messenger_operation",
-  "definitions": {
-    "messenger_operation": {
-      "anyOf": [
-        {
+  "description": "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).",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "watch_conversations"
+        },
+        "filter": {
+          "description": "Conversations filter options - use unreadOnly to find conversations with unread messages, previewMessageCount to control message previews (default 2), and sortBy/sortOrder to customize sorting",
           "type": "object",
           "properties": {
-            "operation": {
+            "account": {
+              "description": "Account name or address to query conversations for. If not specified, uses default account",
+              "type": "string"
+            },
+            "unreadOnly": {
+              "description": "If true, only return conversations with unread messages (unreadCount > 0). Useful for quickly finding conversations needing attention",
+              "type": "boolean"
+            },
+            "startTime": {
+              "description": "Start timestamp (ms) for filtering conversations by lastMessageAt. Only returns conversations where lastMessageAt >= this value",
+              "type": "number"
+            },
+            "endTime": {
+              "description": "End timestamp (ms) for filtering conversations by lastMessageAt. Only returns conversations where lastMessageAt <= this value",
+              "type": "number"
+            },
+            "previewMessageCount": {
+              "description": "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",
+              "type": "number"
+            },
+            "sortBy": {
+              "description": "Sort conversations by: 'lastMessageAt' = most recent activity first, 'unreadCount' = most unread messages first, 'messageCount' = most total messages first",
+              "type": "string",
+              "enum": [
+                "lastMessageAt",
+                "unreadCount",
+                "messageCount"
+              ]
+            },
+            "sortOrder": {
+              "description": "Sort order: 'asc' = ascending (oldest/smallest first), 'desc' = descending (newest/largest first). Default is 'desc' for time-based sorting",
               "type": "string",
-              "const": "watch_conversations"
+              "enum": [
+                "asc",
+                "desc"
+              ]
+            },
+            "skipAutoMarkViewed": {
+              "description": "If true, preview messages will NOT be automatically marked as viewed when retrieved. Default is false, meaning preview messages are auto-marked as viewed",
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "operation"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "send_message"
+        },
+        "from": {
+          "description": "Sender account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "to": {
+          "anyOf": [
+            {
+              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
             },
-            "filter": {
+            {
               "type": "object",
               "properties": {
-                "account": {
+                "name_or_address": {
                   "type": "string",
-                  "description": "Account name or address to query conversations for. If not specified, uses default account"
-                },
-                "unreadOnly": {
-                  "type": "boolean",
-                  "description": "If true, only return conversations with unread messages (unreadCount > 0). Useful for quickly finding conversations needing attention"
-                },
-                "startTime": {
-                  "type": "number",
-                  "description": "Start timestamp (ms) for filtering conversations by lastMessageAt. Only returns conversations where lastMessageAt >= this value"
-                },
-                "endTime": {
-                  "type": "number",
-                  "description": "End timestamp (ms) for filtering conversations by lastMessageAt. Only returns conversations where lastMessageAt <= this value"
+                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
                 },
-                "previewMessageCount": {
-                  "type": "number",
-                  "description": "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": {
+                "local_mark_first": {
+                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                  "type": "boolean"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+            }
+          ],
+          "description": "Recipient address or account name - can be a string (name/address) or full object"
+        },
+        "content": {
+          "type": "string",
+          "maxLength": 10240,
+          "description": "Message content text (max 10240 bytes)"
+        },
+        "options": {
+          "description": "Optional message settings",
+          "type": "object",
+          "properties": {
+            "guardAddress": {
+              "description": "Guard address. REQUIRED when sending Guard-verified messages",
+              "type": "string"
+            },
+            "passportAddress": {
+              "description": "Passport address. REQUIRED when sending Guard-verified messages",
+              "type": "string"
+            },
+            "force": {
+              "description": "Force send even if there are pending Guard messages",
+              "type": "boolean"
+            },
+            "enable_messenger": {
+              "description": "Auto-enable messenger for the sender account if not already enabled",
+              "type": "boolean"
+            },
+            "network": {
+              "description": "Target network for Guard verification (e.g., testnet, mainnet). REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks",
+              "type": "string",
+              "enum": [
+                "localnet",
+                "testnet",
+                "mainnet"
+              ]
+            },
+            "replyTo": {
+              "description": "Quote/reply to a previous message in the SAME conversation. The messageId MUST exist in local storage for the current conversation, otherwise sending fails",
+              "type": "object",
+              "properties": {
+                "messageId": {
                   "type": "string",
-                  "enum": [
-                    "lastMessageAt",
-                    "unreadCount",
-                    "messageCount"
-                  ],
-                  "description": "Sort conversations by: 'lastMessageAt' = most recent activity first, 'unreadCount' = most unread messages first, 'messageCount' = most total messages first"
-                },
-                "sortOrder": {
+                  "description": "Replied-to message ID (unique within the conversation)"
+                }
+              },
+              "required": [
+                "messageId"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "operation",
+        "to",
+        "content"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "send_file"
+        },
+        "from": {
+          "description": "Sender account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "to": {
+          "anyOf": [
+            {
+              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "name_or_address": {
                   "type": "string",
-                  "enum": [
-                    "asc",
-                    "desc"
-                  ],
-                  "description": "Sort order: 'asc' = ascending (oldest/smallest first), 'desc' = descending (newest/largest first). Default is 'desc' for time-based sorting"
+                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
                 },
-                "skipAutoMarkViewed": {
-                  "type": "boolean",
-                  "description": "If true, preview messages will NOT be automatically marked as viewed when retrieved. Default is false, meaning preview messages are auto-marked as viewed"
+                "local_mark_first": {
+                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                  "type": "boolean"
                 }
               },
               "additionalProperties": false,
-              "description": "Conversations filter options - use unreadOnly to find conversations with unread messages, previewMessageCount to control message previews (default 2), and sortBy/sortOrder to customize sorting"
+              "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
             }
-          },
-          "required": [
-            "operation"
           ],
+          "description": "Recipient address or account name - can be a string (name/address) or full object"
+        },
+        "filePath": {
+          "type": "string",
+          "description": "Local file path to send. File will be compressed as ZIP before sending"
+        },
+        "options": {
+          "description": "Optional file sending settings",
+          "type": "object",
+          "properties": {
+            "fileName": {
+              "description": "Custom file name",
+              "type": "string"
+            },
+            "contentType": {
+              "description": "Content type hint",
+              "type": "string",
+              "enum": [
+                "wts",
+                "wip",
+                "zip"
+              ]
+            },
+            "guardAddress": {
+              "description": "Guard address. REQUIRED when sending Guard-verified files",
+              "type": "string"
+            },
+            "passportAddress": {
+              "description": "Passport address. REQUIRED when sending Guard-verified files",
+              "type": "string"
+            },
+            "force": {
+              "description": "Force send even if there are pending Guard messages",
+              "type": "boolean"
+            },
+            "enable_messenger": {
+              "description": "Auto-enable messenger for the sender account if not already enabled",
+              "type": "boolean"
+            },
+            "network": {
+              "description": "Target network for Guard verification (e.g., testnet, mainnet). REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks",
+              "type": "string",
+              "enum": [
+                "localnet",
+                "testnet",
+                "mainnet"
+              ]
+            }
+          },
           "additionalProperties": false
+        }
+      },
+      "required": [
+        "operation",
+        "to",
+        "filePath"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "watch_messages"
         },
-        {
+        "filter": {
+          "description": "Message filter options",
           "type": "object",
           "properties": {
-            "operation": {
+            "account": {
+              "description": "Account to filter messages for",
+              "type": "string"
+            },
+            "direction": {
+              "description": "Filter by message direction",
               "type": "string",
-              "const": "send_message"
+              "enum": [
+                "sent",
+                "received"
+              ]
             },
-            "from": {
+            "status": {
+              "description": "Filter by message status",
               "type": "string",
-              "description": "Sender account name or address. If not specified, uses default account"
+              "enum": [
+                "pending",
+                "confirmed",
+                "read",
+                "failed",
+                "rejected",
+                "decrypted",
+                "decrypt_failed"
+              ]
             },
-            "to": {
+            "peerAddress": {
+              "description": "Filter by peer address - can be a string (name/address) or full object",
               "anyOf": [
                 {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
                   "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
                 },
                 {
                   "type": "object",
                   "properties": {
                     "name_or_address": {
-                      "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+                      "type": "string",
                       "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
                     },
                     "local_mark_first": {
-                      "type": "boolean",
-                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks"
+                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                      "type": "boolean"
                     }
                   },
                   "additionalProperties": false,
                   "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
                 }
-              ],
-              "description": "Recipient address or account name - can be a string (name/address) or full object"
+              ]
+            },
+            "msgType": {
+              "description": "Filter by message type",
+              "anyOf": [
+                {
+                  "type": "number",
+                  "const": 1
+                },
+                {
+                  "type": "number",
+                  "const": 3
+                }
+              ]
+            },
+            "contentType": {
+              "description": "Filter by content type",
+              "type": "string",
+              "enum": [
+                "text",
+                "zip",
+                "wts",
+                "wip"
+              ]
+            },
+            "decryptedOnly": {
+              "description": "Only return decrypted messages",
+              "type": "boolean"
+            },
+            "confirmedOnly": {
+              "description": "Only return confirmed messages",
+              "type": "boolean"
+            },
+            "keyword": {
+              "description": "Search keyword in plaintext",
+              "type": "string"
+            },
+            "sortOrder": {
+              "description": "Sort order: asc or desc",
+              "type": "string",
+              "enum": [
+                "asc",
+                "desc"
+              ]
+            },
+            "limit": {
+              "description": "Return limit",
+              "type": "number"
+            },
+            "offset": {
+              "description": "Pagination offset",
+              "type": "number"
+            },
+            "timeField": {
+              "description": "Time field for time filtering",
+              "type": "string",
+              "enum": [
+                "createdAt",
+                "receivedAt",
+                "serverTimestamp"
+              ]
+            },
+            "startTime": {
+              "description": "Start timestamp (ms)",
+              "type": "number"
+            },
+            "endTime": {
+              "description": "End timestamp (ms)",
+              "type": "number"
+            },
+            "createdAtStart": {
+              "description": "Created at start time",
+              "type": "number"
+            },
+            "createdAtEnd": {
+              "description": "Created at end time",
+              "type": "number"
+            },
+            "receivedAtStart": {
+              "description": "Received at start time",
+              "type": "number"
+            },
+            "receivedAtEnd": {
+              "description": "Received at end time",
+              "type": "number"
+            },
+            "serverTimestampStart": {
+              "description": "Server timestamp start time",
+              "type": "number"
             },
-            "content": {
+            "serverTimestampEnd": {
+              "description": "Server timestamp end time",
+              "type": "number"
+            },
+            "arkConfirmedOnly": {
+              "description": "Only return ARK confirmed messages",
+              "type": "boolean"
+            },
+            "arkTimestampStart": {
+              "description": "ARK timestamp start",
+              "type": "number"
+            },
+            "arkTimestampEnd": {
+              "description": "ARK timestamp end",
+              "type": "number"
+            },
+            "proofedOnly": {
+              "description": "Only return messages with proof",
+              "type": "boolean"
+            },
+            "hasLastReceivedIndexOnly": {
+              "description": "Only return messages with lastReceivedLeafIndex",
+              "type": "boolean"
+            },
+            "lastReceivedIndexMin": {
+              "description": "Min lastReceivedLeafIndex",
+              "type": "number"
+            },
+            "lastReceivedIndexMax": {
+              "description": "Max lastReceivedLeafIndex",
+              "type": "number"
+            },
+            "listFilterMode": {
+              "description": "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)",
               "type": "string",
-              "maxLength": 10240,
-              "description": "Message content text (max 10240 bytes)"
+              "enum": [
+                "friends",
+                "guard",
+                "stranger",
+                "any"
+              ]
             },
-            "options": {
+            "customListFilter": {
+              "description": "Custom list filter for advanced address-based filtering, works in combination with listFilterMode",
               "type": "object",
               "properties": {
-                "guardAddress": {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "Guard address. REQUIRED when sending Guard-verified messages"
-                },
-                "passportAddress": {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "Passport address. REQUIRED when sending Guard-verified messages"
-                },
-                "force": {
-                  "type": "boolean",
-                  "description": "Force send even if there are pending Guard messages"
+                "includeAddresses": {
+                  "description": "Include addresses - only return messages from these addresses (highest priority)",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
                 },
-                "enable_messenger": {
-                  "type": "boolean",
-                  "description": "Auto-enable messenger for the sender account if not already enabled"
+                "excludeAddresses": {
+                  "description": "Exclude addresses - exclude messages from these addresses",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
                 },
-                "network": {
+                "relation": {
+                  "description": "Address list relation: 'union' = combine lists as union, 'intersection' = combine lists as intersection",
                   "type": "string",
                   "enum": [
-                    "localnet",
-                    "testnet",
-                    "mainnet"
-                  ],
-                  "description": "Target network for Guard verification (e.g., testnet, mainnet). REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks"
-                },
-                "replyTo": {
-                  "type": "object",
-                  "properties": {
-                    "messageId": {
-                      "type": "string",
-                      "description": "Replied-to message ID (unique within the conversation)"
-                    }
-                  },
-                  "required": [
-                    "messageId"
-                  ],
-                  "additionalProperties": false,
-                  "description": "Quote/reply to a previous message in the SAME conversation. The messageId MUST exist in local storage for the current conversation, otherwise sending fails"
+                    "union",
+                    "intersection"
+                  ]
                 }
               },
-              "additionalProperties": false,
-              "description": "Optional message settings"
+              "additionalProperties": false
+            },
+            "viewed": {
+              "description": "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",
+              "type": "boolean"
+            },
+            "viewedAtStart": {
+              "description": "Filter by viewed timestamp start (inclusive). Only returns messages where viewedAt >= this value. Useful for finding recently viewed messages",
+              "type": "number"
+            },
+            "viewedAtEnd": {
+              "description": "Filter by viewed timestamp end (inclusive). Only returns messages where viewedAt <= this value. Useful for finding messages viewed before a certain time",
+              "type": "number"
+            },
+            "skipAutoMarkViewed": {
+              "description": "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",
+              "type": "boolean"
             }
           },
-          "required": [
-            "operation",
-            "to",
-            "content"
-          ],
           "additionalProperties": false
+        }
+      },
+      "required": [
+        "operation"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "extract_zip_messages"
+        },
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "messages": {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "messageId": {
+                    "type": "string",
+                    "description": "Message ID"
+                  },
+                  "fromAddress": {
+                    "type": "string",
+                    "description": "Sender address"
+                  },
+                  "toAddress": {
+                    "type": "string",
+                    "description": "Recipient address"
+                  },
+                  "plaintextHash": {
+                    "type": "string",
+                    "description": "Plaintext hash"
+                  },
+                  "plaintext": {
+                    "description": "Decrypted plaintext (optional)",
+                    "type": "string"
+                  },
+                  "replyTo": {
+                    "description": "Quoted (replied-to) message reference, if this message replies to a previous one",
+                    "type": "object",
+                    "properties": {
+                      "messageId": {
+                        "type": "string",
+                        "description": "Replied-to message ID (unique within the conversation)"
+                      }
+                    },
+                    "required": [
+                      "messageId"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "guardAddress": {
+                    "description": "Guard address",
+                    "type": "string"
+                  },
+                  "passportAddress": {
+                    "description": "Passport address",
+                    "type": "string"
+                  },
+                  "lastReceivedLeafIndex": {
+                    "description": "Last received leaf index",
+                    "type": "number"
+                  },
+                  "direction": {
+                    "type": "string",
+                    "enum": [
+                      "sent",
+                      "received"
+                    ],
+                    "description": "Message direction"
+                  },
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "pending",
+                      "confirmed",
+                      "read",
+                      "failed",
+                      "rejected",
+                      "decrypted",
+                      "decrypt_failed"
+                    ],
+                    "description": "Message status"
+                  },
+                  "msgType": {
+                    "anyOf": [
+                      {
+                        "type": "number",
+                        "const": 1
+                      },
+                      {
+                        "type": "number",
+                        "const": 3
+                      }
+                    ],
+                    "description": "Message type"
+                  },
+                  "leafIndex": {
+                    "description": "Leaf index",
+                    "type": "number"
+                  },
+                  "prevRoot": {
+                    "description": "Previous Merkle Root",
+                    "type": "string"
+                  },
+                  "newRoot": {
+                    "description": "Current Merkle Root",
+                    "type": "string"
+                  },
+                  "serverSignature": {
+                    "description": "Server signature",
+                    "type": "string"
+                  },
+                  "serverTimestamp": {
+                    "description": "Server confirmation timestamp",
+                    "type": "number"
+                  },
+                  "serverPublicKey": {
+                    "description": "Server public key",
+                    "type": "string"
+                  },
+                  "arkConfirmed": {
+                    "description": "ARK confirmation",
+                    "type": "object",
+                    "properties": {
+                      "recipient": {
+                        "type": "string",
+                        "description": "Recipient address"
+                      },
+                      "recipientPublicKey": {
+                        "type": "string",
+                        "description": "Recipient public key"
+                      },
+                      "signature": {
+                        "type": "string",
+                        "description": "Recipient signature"
+                      },
+                      "timestamp": {
+                        "type": "number",
+                        "description": "ARK confirmation time"
+                      }
+                    },
+                    "required": [
+                      "recipient",
+                      "recipientPublicKey",
+                      "signature",
+                      "timestamp"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "createdAt": {
+                    "type": "number",
+                    "description": "Message creation time (client)"
+                  },
+                  "receivedAt": {
+                    "description": "Local reception time",
+                    "type": "number"
+                  },
+                  "zipMetadata": {
+                    "description": "ZIP file metadata",
+                    "type": "object",
+                    "properties": {
+                      "fileName": {
+                        "type": "string",
+                        "description": "ZIP filename"
+                      },
+                      "fileSize": {
+                        "type": "number",
+                        "description": "File size in bytes"
+                      },
+                      "fileHash": {
+                        "type": "string",
+                        "description": "File SHA256 hash"
+                      },
+                      "contentType": {
+                        "type": "string",
+                        "enum": [
+                          "text",
+                          "zip",
+                          "wts",
+                          "wip"
+                        ],
+                        "description": "Content type"
+                      },
+                      "localCachePath": {
+                        "description": "Local cache path",
+                        "type": "string"
+                      },
+                      "downloadedAt": {
+                        "description": "Download timestamp",
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "fileName",
+                      "fileSize",
+                      "fileHash",
+                      "contentType"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "proof": {
+                    "description": "On-chain proof object address",
+                    "type": "string"
+                  },
+                  "decryptError": {
+                    "description": "Decryption failure reason",
+                    "type": "string"
+                  },
+                  "decryptAttempts": {
+                    "description": "Number of decryption attempts",
+                    "type": "number"
+                  },
+                  "lastDecryptAttemptAt": {
+                    "description": "Last decryption attempt timestamp",
+                    "type": "number"
+                  },
+                  "viewedAt": {
+                    "description": "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')",
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "messageId",
+                  "fromAddress",
+                  "toAddress",
+                  "plaintextHash",
+                  "direction",
+                  "status",
+                  "msgType",
+                  "createdAt"
+                ],
+                "additionalProperties": false,
+                "description": "Message object"
+              }
+            ]
+          },
+          "description": "Array of message objects or message IDs to extract"
+        },
+        "outputDir": {
+          "description": "Output directory path for extracted files. If not specified, defaults to the workspace/extracted directory",
+          "type": "string"
+        }
+      },
+      "required": [
+        "operation",
+        "messages"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "generate_wts"
         },
-        {
+        "params": {
           "type": "object",
           "properties": {
-            "operation": {
+            "myAccount": {
               "type": "string",
-              "const": "send_file"
+              "description": "My account name or address (string)"
             },
-            "from": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Sender account name or address. If not specified, uses default account"
-            },
-            "to": {
+            "peerAccount": {
               "anyOf": [
                 {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/0"
+                  "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
                 },
-                {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/1"
-                }
-              ],
-              "description": "Recipient address or account name - can be a string (name/address) or full object"
-            },
-            "filePath": {
-              "type": "string",
-              "description": "Local file path to send. File will be compressed as ZIP before sending"
-            },
-            "options": {
-              "type": "object",
-              "properties": {
-                "fileName": {
-                  "type": "string",
-                  "description": "Custom file name"
-                },
-                "contentType": {
-                  "type": "string",
-                  "enum": [
-                    "wts",
-                    "wip",
-                    "zip"
-                  ],
-                  "description": "Content type hint"
-                },
-                "guardAddress": {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "Guard address. REQUIRED when sending Guard-verified files"
-                },
-                "passportAddress": {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "Passport address. REQUIRED when sending Guard-verified files"
-                },
-                "force": {
-                  "type": "boolean",
-                  "description": "Force send even if there are pending Guard messages"
-                },
-                "enable_messenger": {
-                  "type": "boolean",
-                  "description": "Auto-enable messenger for the sender account if not already enabled"
-                },
-                "network": {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/options/properties/network",
-                  "description": "Target network for Guard verification (e.g., testnet, mainnet). REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks"
-                }
-              },
-              "additionalProperties": false,
-              "description": "Optional file sending settings"
-            }
-          },
-          "required": [
-            "operation",
-            "to",
-            "filePath"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "watch_messages"
-            },
-            "filter": {
-              "type": "object",
-              "properties": {
-                "account": {
-                  "type": "string",
-                  "description": "Account to filter messages for"
-                },
-                "direction": {
-                  "type": "string",
-                  "enum": [
-                    "sent",
-                    "received"
-                  ],
-                  "description": "Filter by message direction"
-                },
-                "status": {
-                  "type": "string",
-                  "enum": [
-                    "pending",
-                    "confirmed",
-                    "read",
-                    "failed",
-                    "rejected",
-                    "decrypted",
-                    "decrypt_failed"
-                  ],
-                  "description": "Filter by message status"
-                },
-                "peerAddress": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/0"
-                    },
-                    {
-                      "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/1"
-                    }
-                  ],
-                  "description": "Filter by peer address - can be a string (name/address) or full object"
-                },
-                "msgType": {
-                  "type": "number",
-                  "enum": [
-                    1,
-                    3
-                  ],
-                  "description": "Filter by message type"
-                },
-                "contentType": {
-                  "type": "string",
-                  "enum": [
-                    "text",
-                    "zip",
-                    "wts",
-                    "wip"
-                  ],
-                  "description": "Filter by content type"
-                },
-                "decryptedOnly": {
-                  "type": "boolean",
-                  "description": "Only return decrypted messages"
-                },
-                "confirmedOnly": {
-                  "type": "boolean",
-                  "description": "Only return confirmed messages"
-                },
-                "keyword": {
-                  "type": "string",
-                  "description": "Search keyword in plaintext"
-                },
-                "sortOrder": {
-                  "type": "string",
-                  "enum": [
-                    "asc",
-                    "desc"
-                  ],
-                  "description": "Sort order: asc or desc"
-                },
-                "limit": {
-                  "type": "number",
-                  "description": "Return limit"
-                },
-                "offset": {
-                  "type": "number",
-                  "description": "Pagination offset"
-                },
-                "timeField": {
-                  "type": "string",
-                  "enum": [
-                    "createdAt",
-                    "receivedAt",
-                    "serverTimestamp"
-                  ],
-                  "description": "Time field for time filtering"
-                },
-                "startTime": {
-                  "type": "number",
-                  "description": "Start timestamp (ms)"
-                },
-                "endTime": {
-                  "type": "number",
-                  "description": "End timestamp (ms)"
-                },
-                "createdAtStart": {
-                  "type": "number",
-                  "description": "Created at start time"
-                },
-                "createdAtEnd": {
-                  "type": "number",
-                  "description": "Created at end time"
-                },
-                "receivedAtStart": {
-                  "type": "number",
-                  "description": "Received at start time"
-                },
-                "receivedAtEnd": {
-                  "type": "number",
-                  "description": "Received at end time"
-                },
-                "serverTimestampStart": {
-                  "type": "number",
-                  "description": "Server timestamp start time"
-                },
-                "serverTimestampEnd": {
-                  "type": "number",
-                  "description": "Server timestamp end time"
-                },
-                "arkConfirmedOnly": {
-                  "type": "boolean",
-                  "description": "Only return ARK confirmed messages"
-                },
-                "arkTimestampStart": {
-                  "type": "number",
-                  "description": "ARK timestamp start"
-                },
-                "arkTimestampEnd": {
-                  "type": "number",
-                  "description": "ARK timestamp end"
-                },
-                "proofedOnly": {
-                  "type": "boolean",
-                  "description": "Only return messages with proof"
-                },
-                "hasLastReceivedIndexOnly": {
-                  "type": "boolean",
-                  "description": "Only return messages with lastReceivedLeafIndex"
-                },
-                "lastReceivedIndexMin": {
-                  "type": "number",
-                  "description": "Min lastReceivedLeafIndex"
-                },
-                "lastReceivedIndexMax": {
-                  "type": "number",
-                  "description": "Max lastReceivedLeafIndex"
-                },
-                "listFilterMode": {
-                  "type": "string",
-                  "enum": [
-                    "friends",
-                    "guard",
-                    "stranger",
-                    "any"
-                  ],
-                  "description": "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": {
-                  "type": "object",
-                  "properties": {
-                    "includeAddresses": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      },
-                      "description": "Include addresses - only return messages from these addresses (highest priority)"
-                    },
-                    "excludeAddresses": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      },
-                      "description": "Exclude addresses - exclude messages from these addresses"
-                    },
-                    "relation": {
-                      "type": "string",
-                      "enum": [
-                        "union",
-                        "intersection"
-                      ],
-                      "description": "Address list relation: 'union' = combine lists as union, 'intersection' = combine lists as intersection"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Custom list filter for advanced address-based filtering, works in combination with listFilterMode"
-                },
-                "viewed": {
-                  "type": "boolean",
-                  "description": "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": {
-                  "type": "number",
-                  "description": "Filter by viewed timestamp start (inclusive). Only returns messages where viewedAt >= this value. Useful for finding recently viewed messages"
-                },
-                "viewedAtEnd": {
-                  "type": "number",
-                  "description": "Filter by viewed timestamp end (inclusive). Only returns messages where viewedAt <= this value. Useful for finding messages viewed before a certain time"
-                },
-                "skipAutoMarkViewed": {
-                  "type": "boolean",
-                  "description": "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"
-                }
-              },
-              "additionalProperties": false,
-              "description": "Message filter options"
-            }
-          },
-          "required": [
-            "operation"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "extract_zip_messages"
-            },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
-            },
-            "messages": {
-              "type": "array",
-              "items": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "messageId": {
-                        "type": "string",
-                        "description": "Message ID"
-                      },
-                      "fromAddress": {
-                        "type": "string",
-                        "description": "Sender address"
-                      },
-                      "toAddress": {
-                        "type": "string",
-                        "description": "Recipient address"
-                      },
-                      "plaintextHash": {
-                        "type": "string",
-                        "description": "Plaintext hash"
-                      },
-                      "plaintext": {
-                        "type": "string",
-                        "description": "Decrypted plaintext (optional)"
-                      },
-                      "replyTo": {
-                        "$ref": "#/definitions/messenger_operation/anyOf/1/properties/options/properties/replyTo",
-                        "description": "Quoted (replied-to) message reference, if this message replies to a previous one"
-                      },
-                      "guardAddress": {
-                        "type": "string",
-                        "description": "Guard address"
-                      },
-                      "passportAddress": {
-                        "type": "string",
-                        "description": "Passport address"
-                      },
-                      "lastReceivedLeafIndex": {
-                        "type": "number",
-                        "description": "Last received leaf index"
-                      },
-                      "direction": {
-                        "type": "string",
-                        "enum": [
-                          "sent",
-                          "received"
-                        ],
-                        "description": "Message direction"
-                      },
-                      "status": {
-                        "type": "string",
-                        "enum": [
-                          "pending",
-                          "confirmed",
-                          "read",
-                          "failed",
-                          "rejected",
-                          "decrypted",
-                          "decrypt_failed"
-                        ],
-                        "description": "Message status"
-                      },
-                      "msgType": {
-                        "type": "number",
-                        "enum": [
-                          1,
-                          3
-                        ],
-                        "description": "Message type"
-                      },
-                      "leafIndex": {
-                        "type": "number",
-                        "description": "Leaf index"
-                      },
-                      "prevRoot": {
-                        "type": "string",
-                        "description": "Previous Merkle Root"
-                      },
-                      "newRoot": {
-                        "type": "string",
-                        "description": "Current Merkle Root"
-                      },
-                      "serverSignature": {
-                        "type": "string",
-                        "description": "Server signature"
-                      },
-                      "serverTimestamp": {
-                        "type": "number",
-                        "description": "Server confirmation timestamp"
-                      },
-                      "serverPublicKey": {
-                        "type": "string",
-                        "description": "Server public key"
-                      },
-                      "arkConfirmed": {
-                        "type": "object",
-                        "properties": {
-                          "recipient": {
-                            "type": "string",
-                            "description": "Recipient address"
-                          },
-                          "recipientPublicKey": {
-                            "type": "string",
-                            "description": "Recipient public key"
-                          },
-                          "signature": {
-                            "type": "string",
-                            "description": "Recipient signature"
-                          },
-                          "timestamp": {
-                            "type": "number",
-                            "description": "ARK confirmation time"
-                          }
-                        },
-                        "required": [
-                          "recipient",
-                          "recipientPublicKey",
-                          "signature",
-                          "timestamp"
-                        ],
-                        "additionalProperties": false,
-                        "description": "ARK confirmation"
-                      },
-                      "createdAt": {
-                        "type": "number",
-                        "description": "Message creation time (client)"
-                      },
-                      "receivedAt": {
-                        "type": "number",
-                        "description": "Local reception time"
-                      },
-                      "zipMetadata": {
-                        "type": "object",
-                        "properties": {
-                          "fileName": {
-                            "type": "string",
-                            "description": "ZIP filename"
-                          },
-                          "fileSize": {
-                            "type": "number",
-                            "description": "File size in bytes"
-                          },
-                          "fileHash": {
-                            "type": "string",
-                            "description": "File SHA256 hash"
-                          },
-                          "contentType": {
-                            "type": "string",
-                            "enum": [
-                              "text",
-                              "zip",
-                              "wts",
-                              "wip"
-                            ],
-                            "description": "Content type"
-                          },
-                          "localCachePath": {
-                            "type": "string",
-                            "description": "Local cache path"
-                          },
-                          "downloadedAt": {
-                            "type": "number",
-                            "description": "Download timestamp"
-                          }
-                        },
-                        "required": [
-                          "fileName",
-                          "fileSize",
-                          "fileHash",
-                          "contentType"
-                        ],
-                        "additionalProperties": false,
-                        "description": "ZIP file metadata"
-                      },
-                      "proof": {
-                        "type": "string",
-                        "description": "On-chain proof object address"
-                      },
-                      "decryptError": {
-                        "type": "string",
-                        "description": "Decryption failure reason"
-                      },
-                      "decryptAttempts": {
-                        "type": "number",
-                        "description": "Number of decryption attempts"
-                      },
-                      "lastDecryptAttemptAt": {
-                        "type": "number",
-                        "description": "Last decryption attempt timestamp"
-                      },
-                      "viewedAt": {
-                        "type": "number",
-                        "description": "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')"
-                      }
-                    },
-                    "required": [
-                      "messageId",
-                      "fromAddress",
-                      "toAddress",
-                      "plaintextHash",
-                      "direction",
-                      "status",
-                      "msgType",
-                      "createdAt"
-                    ],
-                    "additionalProperties": false,
-                    "description": "Message object"
-                  }
-                ]
-              },
-              "description": "Array of message objects or message IDs to extract"
-            },
-            "outputDir": {
-              "type": "string",
-              "description": "Output directory path for extracted files"
-            }
-          },
-          "required": [
-            "operation",
-            "messages",
-            "outputDir"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "generate_wts"
-            },
-            "params": {
-              "type": "object",
-              "properties": {
-                "myAccount": {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                  "description": "My account name or address (string)"
-                },
-                "peerAccount": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/0"
-                    },
-                    {
-                      "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/1"
-                    }
-                  ],
-                  "description": "Peer account name or address - can be a string (name/address) or full object"
-                },
-                "range": {
-                  "anyOf": [
-                    {
-                      "type": "object",
-                      "properties": {
-                        "type": {
-                          "type": "string",
-                          "const": "time"
-                        },
-                        "start": {
-                          "type": "number"
-                        },
-                        "end": {
-                          "type": "number"
-                        }
-                      },
-                      "required": [
-                        "type",
-                        "start",
-                        "end"
-                      ],
-                      "additionalProperties": false
-                    },
-                    {
-                      "type": "object",
-                      "properties": {
-                        "type": {
-                          "type": "string",
-                          "const": "messageId"
-                        },
-                        "start": {
-                          "type": "string"
-                        },
-                        "end": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "type",
-                        "start",
-                        "end"
-                      ],
-                      "additionalProperties": false
-                    },
-                    {
-                      "type": "object",
-                      "properties": {
-                        "type": {
-                          "type": "string",
-                          "const": "seqIndex"
-                        },
-                        "start": {
-                          "type": "number"
-                        },
-                        "end": {
-                          "type": "number"
-                        }
-                      },
-                      "required": [
-                        "type",
-                        "start",
-                        "end"
-                      ],
-                      "additionalProperties": false
-                    }
-                  ],
-                  "description": "Range filter parameters"
-                },
-                "excludePlaintext": {
-                  "type": "boolean",
-                  "description": "Whether to exclude plaintext"
-                },
-                "outputDir": {
-                  "type": "string",
-                  "description": "Output directory path"
-                }
-              },
-              "required": [
-                "myAccount",
-                "peerAccount",
-                "outputDir"
-              ],
-              "additionalProperties": false,
-              "description": "WTS generation parameters"
-            }
-          },
-          "required": [
-            "operation",
-            "params"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "verify_wts"
-            },
-            "wtsFilePath": {
-              "type": "string",
-              "description": "WTS file path to verify"
-            }
-          },
-          "required": [
-            "operation",
-            "wtsFilePath"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "sign_wts"
-            },
-            "wtsFilePath": {
-              "type": "string",
-              "description": "WTS file path to sign"
-            },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address to sign with. If not specified, uses default account"
-            },
-            "outputPath": {
-              "type": "string",
-              "description": "Output file path. If not specified, saves to signed_*.wts"
-            }
-          },
-          "required": [
-            "operation",
-            "wtsFilePath"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "wts2html"
-            },
-            "wtsPath": {
-              "type": "string",
-              "description": "WTS file path or directory to convert"
-            },
-            "options": {
-              "type": "object",
-              "properties": {
-                "title": {
-                  "type": "string",
-                  "description": "HTML document title"
-                },
-                "theme": {
-                  "type": "string",
-                  "enum": [
-                    "light",
-                    "dark"
-                  ],
-                  "description": "HTML theme"
-                },
-                "outputPath": {
-                  "type": "string",
-                  "description": "Output file path"
-                }
-              },
-              "additionalProperties": false,
-              "description": "Conversion options"
-            }
-          },
-          "required": [
-            "operation",
-            "wtsPath"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "proof_message"
-            },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
-            },
-            "messageId": {
-              "type": "string",
-              "description": "Message ID to proof on-chain"
-            },
-            "network": {
-              "type": "string",
-              "enum": [
-                "localnet",
-                "testnet",
-                "mainnet"
-              ],
-              "description": "Network to use for on-chain proof (required)"
-            }
-          },
-          "required": [
-            "operation",
-            "messageId",
-            "network"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "blacklist"
-            },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
-            },
-            "blacklist": {
-              "anyOf": [
                 {
                   "type": "object",
                   "properties": {
-                    "op": {
+                    "name_or_address": {
                       "type": "string",
-                      "const": "add"
+                      "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
                     },
-                    "users": {
-                      "anyOf": [
-                        {
-                          "type": "array",
-                          "items": {
-                            "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from"
-                          },
-                          "description": "Array of account names, addresses, or mark names. Local marks are searched first for each entry. EXAMPLE: ['alice', '0x2...', 'bob']"
-                        },
-                        {
-                          "type": "object",
-                          "properties": {
-                            "entities": {
-                              "type": "array",
-                              "items": {
-                                "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/1"
-                              }
-                            },
-                            "check_all_founded": {
-                              "type": "boolean",
-                              "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs"
-                            }
-                          },
-                          "required": [
-                            "entities"
-                          ],
-                          "additionalProperties": false,
-                          "description": "Used to batch find account or object IDs by name"
-                        }
-                      ],
-                      "description": "Users to add to blacklist - can be array of strings (names/addresses) or full object"
+                    "local_mark_first": {
+                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                      "type": "boolean"
                     }
                   },
-                  "required": [
-                    "op",
-                    "users"
-                  ],
-                  "additionalProperties": false
-                },
+                  "additionalProperties": false,
+                  "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                }
+              ],
+              "description": "Peer account name or address - can be a string (name/address) or full object"
+            },
+            "range": {
+              "description": "Range filter parameters",
+              "oneOf": [
                 {
                   "type": "object",
                   "properties": {
-                    "op": {
+                    "type": {
                       "type": "string",
-                      "const": "remove"
+                      "const": "time"
                     },
-                    "users": {
-                      "anyOf": [
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/0"
-                        },
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/1"
-                        }
-                      ],
-                      "description": "Users to remove from blacklist - can be array of strings (names/addresses) or full object"
-                    }
-                  },
-                  "required": [
-                    "op",
-                    "users"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "clear"
+                    "start": {
+                      "type": "number"
+                    },
+                    "end": {
+                      "type": "number"
                     }
                   },
                   "required": [
-                    "op"
+                    "type",
+                    "start",
+                    "end"
                   ],
                   "additionalProperties": false
                 },
                 {
                   "type": "object",
                   "properties": {
-                    "op": {
+                    "type": {
                       "type": "string",
-                      "const": "get"
+                      "const": "messageId"
+                    },
+                    "start": {
+                      "type": "string"
+                    },
+                    "end": {
+                      "type": "string"
                     }
                   },
                   "required": [
-                    "op"
+                    "type",
+                    "start",
+                    "end"
                   ],
                   "additionalProperties": false
                 },
                 {
                   "type": "object",
                   "properties": {
-                    "op": {
+                    "type": {
                       "type": "string",
-                      "const": "exist"
+                      "const": "seqIndex"
                     },
-                    "users": {
-                      "anyOf": [
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/0"
-                        },
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/1"
-                        }
-                      ],
-                      "description": "Users to check existence - can be array of strings (names/addresses) or full object"
+                    "start": {
+                      "type": "number"
+                    },
+                    "end": {
+                      "type": "number"
                     }
                   },
                   "required": [
-                    "op",
-                    "users"
+                    "type",
+                    "start",
+                    "end"
                   ],
                   "additionalProperties": false
                 }
-              ],
-              "description": "Blacklist management operation"
+              ]
+            },
+            "excludePlaintext": {
+              "description": "Whether to exclude plaintext",
+              "type": "boolean"
+            },
+            "outputDir": {
+              "description": "Output directory path. If not specified, defaults to the workspace/wts directory",
+              "type": "string"
             }
           },
           "required": [
-            "operation",
-            "blacklist"
+            "myAccount",
+            "peerAccount"
           ],
-          "additionalProperties": false
+          "additionalProperties": false,
+          "description": "WTS generation parameters"
+        }
+      },
+      "required": [
+        "operation",
+        "params"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "verify_wts"
+        },
+        "wtsFilePath": {
+          "type": "string",
+          "description": "WTS file path to verify"
+        }
+      },
+      "required": [
+        "operation",
+        "wtsFilePath"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "sign_wts"
+        },
+        "wtsFilePath": {
+          "type": "string",
+          "description": "WTS file path to sign"
         },
-        {
+        "account": {
+          "description": "Account name or address to sign with. If not specified, uses default account",
+          "type": "string"
+        },
+        "outputPath": {
+          "description": "Output file path. If not specified, saves to signed_*.wts",
+          "type": "string"
+        }
+      },
+      "required": [
+        "operation",
+        "wtsFilePath"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "wts2html"
+        },
+        "wtsPath": {
+          "type": "string",
+          "description": "WTS file path or directory to convert"
+        },
+        "options": {
+          "description": "Conversion options",
           "type": "object",
           "properties": {
-            "operation": {
-              "type": "string",
-              "const": "friendslist"
+            "title": {
+              "description": "HTML document title",
+              "type": "string"
             },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
+            "theme": {
+              "description": "HTML theme",
+              "type": "string",
+              "enum": [
+                "light",
+                "dark"
+              ]
             },
-            "friendslist": {
-              "anyOf": [
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "add"
+            "outputPath": {
+              "description": "Output file path",
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "operation",
+        "wtsPath"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "proof_message"
+        },
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "messageId": {
+          "type": "string",
+          "description": "Message ID to proof on-chain"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network to use for on-chain proof (required)"
+        }
+      },
+      "required": [
+        "operation",
+        "messageId",
+        "network"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "blacklist"
+        },
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "blacklist": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "add"
+                },
+                "users": {
+                  "anyOf": [
+                    {
+                      "description": "Array of account names, addresses, or mark names. Local marks are searched first for each entry. EXAMPLE: ['alice', '0x2...', 'bob']"
                     },
-                    "users": {
-                      "anyOf": [
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/0"
+                    {
+                      "type": "object",
+                      "properties": {
+                        "entities": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "name_or_address": {
+                                "type": "string",
+                                "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                              },
+                              "local_mark_first": {
+                                "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                                "type": "boolean"
+                              }
+                            },
+                            "additionalProperties": false,
+                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                          }
                         },
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/1"
+                        "check_all_founded": {
+                          "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                          "type": "boolean"
                         }
+                      },
+                      "required": [
+                        "entities"
                       ],
-                      "description": "Users to add to friends list - can be array of strings (names/addresses) or full object"
+                      "additionalProperties": false,
+                      "description": "Used to batch find account or object IDs by name"
                     }
-                  },
-                  "required": [
-                    "op",
-                    "users"
                   ],
-                  "additionalProperties": false
+                  "description": "Users to add to blacklist - can be array of strings (names/addresses) or full object"
+                }
+              },
+              "required": [
+                "op",
+                "users"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "remove"
                 },
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "remove"
+                "users": {
+                  "anyOf": [
+                    {
+                      "description": "Array of account names, addresses, or mark names. Local marks are searched first for each entry. EXAMPLE: ['alice', '0x2...', 'bob']"
                     },
-                    "users": {
-                      "anyOf": [
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/0"
+                    {
+                      "type": "object",
+                      "properties": {
+                        "entities": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "name_or_address": {
+                                "type": "string",
+                                "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                              },
+                              "local_mark_first": {
+                                "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                                "type": "boolean"
+                              }
+                            },
+                            "additionalProperties": false,
+                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                          }
                         },
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/1"
+                        "check_all_founded": {
+                          "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                          "type": "boolean"
                         }
+                      },
+                      "required": [
+                        "entities"
                       ],
-                      "description": "Users to remove from friends list - can be array of strings (names/addresses) or full object"
-                    }
-                  },
-                  "required": [
-                    "op",
-                    "users"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "clear"
-                    }
-                  },
-                  "required": [
-                    "op"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "get"
+                      "additionalProperties": false,
+                      "description": "Used to batch find account or object IDs by name"
                     }
-                  },
-                  "required": [
-                    "op"
                   ],
-                  "additionalProperties": false
+                  "description": "Users to remove from blacklist - can be array of strings (names/addresses) or full object"
+                }
+              },
+              "required": [
+                "op",
+                "users"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "clear"
+                }
+              },
+              "required": [
+                "op"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "get"
+                }
+              },
+              "required": [
+                "op"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "exist"
                 },
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "exist"
+                "users": {
+                  "anyOf": [
+                    {
+                      "description": "Array of account names, addresses, or mark names. Local marks are searched first for each entry. EXAMPLE: ['alice', '0x2...', 'bob']"
                     },
-                    "users": {
-                      "anyOf": [
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/0"
+                    {
+                      "type": "object",
+                      "properties": {
+                        "entities": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "name_or_address": {
+                                "type": "string",
+                                "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                              },
+                              "local_mark_first": {
+                                "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                                "type": "boolean"
+                              }
+                            },
+                            "additionalProperties": false,
+                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                          }
                         },
-                        {
-                          "$ref": "#/definitions/messenger_operation/anyOf/10/properties/blacklist/anyOf/0/properties/users/anyOf/1"
+                        "check_all_founded": {
+                          "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                          "type": "boolean"
                         }
+                      },
+                      "required": [
+                        "entities"
                       ],
-                      "description": "Users to check existence - can be array of strings (names/addresses) or full object"
+                      "additionalProperties": false,
+                      "description": "Used to batch find account or object IDs by name"
                     }
-                  },
-                  "required": [
-                    "op",
-                    "users"
                   ],
-                  "additionalProperties": false
+                  "description": "Users to check existence - can be array of strings (names/addresses) or full object"
                 }
+              },
+              "required": [
+                "op",
+                "users"
               ],
-              "description": "Friends list management operation"
+              "additionalProperties": false
             }
-          },
-          "required": [
-            "operation",
-            "friendslist"
           ],
-          "additionalProperties": false
+          "description": "Blacklist management operation"
+        }
+      },
+      "required": [
+        "operation",
+        "blacklist"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "friendslist"
         },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "guardlist"
-            },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
-            },
-            "guardlist": {
-              "anyOf": [
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "add"
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "friendslist": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "add"
+                },
+                "users": {
+                  "anyOf": [
+                    {
+                      "description": "Array of account names, addresses, or mark names. Local marks are searched first for each entry. EXAMPLE: ['alice', '0x2...', 'bob']"
                     },
-                    "guards": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "properties": {
-                          "guard": {
-                            "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-                            "description": "Guard address or name"
-                          },
-                          "passportValiditySeconds": {
-                            "type": "number",
-                            "minimum": 10,
-                            "maximum": 315360000,
-                            "description": "Passport validity in seconds (10s to 10 years)"
+                    {
+                      "type": "object",
+                      "properties": {
+                        "entities": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "name_or_address": {
+                                "type": "string",
+                                "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                              },
+                              "local_mark_first": {
+                                "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                                "type": "boolean"
+                              }
+                            },
+                            "additionalProperties": false,
+                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
                           }
                         },
-                        "required": [
-                          "guard",
-                          "passportValiditySeconds"
-                        ],
-                        "additionalProperties": false,
-                        "description": "Guard parameter"
+                        "check_all_founded": {
+                          "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                          "type": "boolean"
+                        }
                       },
-                      "minItems": 1,
-                      "maxItems": 10,
-                      "description": "Guards to add to guard list"
+                      "required": [
+                        "entities"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Used to batch find account or object IDs by name"
                     }
-                  },
-                  "required": [
-                    "op",
-                    "guards"
                   ],
-                  "additionalProperties": false
+                  "description": "Users to add to friends list - can be array of strings (names/addresses) or full object"
+                }
+              },
+              "required": [
+                "op",
+                "users"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "remove"
                 },
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "remove"
+                "users": {
+                  "anyOf": [
+                    {
+                      "description": "Array of account names, addresses, or mark names. Local marks are searched first for each entry. EXAMPLE: ['alice', '0x2...', 'bob']"
                     },
-                    "guards": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from"
+                    {
+                      "type": "object",
+                      "properties": {
+                        "entities": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "name_or_address": {
+                                "type": "string",
+                                "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                              },
+                              "local_mark_first": {
+                                "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                                "type": "boolean"
+                              }
+                            },
+                            "additionalProperties": false,
+                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                          }
+                        },
+                        "check_all_founded": {
+                          "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                          "type": "boolean"
+                        }
                       },
-                      "minItems": 1,
-                      "maxItems": 10,
-                      "description": "Guard addresses to remove from guard list"
-                    }
-                  },
-                  "required": [
-                    "op",
-                    "guards"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "get"
+                      "required": [
+                        "entities"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Used to batch find account or object IDs by name"
                     }
-                  },
-                  "required": [
-                    "op"
                   ],
-                  "additionalProperties": false
+                  "description": "Users to remove from friends list - can be array of strings (names/addresses) or full object"
                 }
+              },
+              "required": [
+                "op",
+                "users"
               ],
-              "description": "Guard list management operation"
-            }
-          },
-          "required": [
-            "operation",
-            "guardlist"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "settings"
+              "additionalProperties": false
             },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "clear"
+                }
+              },
+              "required": [
+                "op"
+              ],
+              "additionalProperties": false
             },
-            "settings": {
-              "anyOf": [
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "get"
-                    }
-                  },
-                  "required": [
-                    "op"
-                  ],
-                  "additionalProperties": false
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "get"
+                }
+              },
+              "required": [
+                "op"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "exist"
                 },
-                {
-                  "type": "object",
-                  "properties": {
-                    "op": {
-                      "type": "string",
-                      "const": "set"
-                    },
-                    "allowStrangerMessages": {
-                      "type": "boolean",
-                      "description": "Allow messages from strangers"
+                "users": {
+                  "anyOf": [
+                    {
+                      "description": "Array of account names, addresses, or mark names. Local marks are searched first for each entry. EXAMPLE: ['alice', '0x2...', 'bob']"
                     },
-                    "maxInboxSize": {
-                      "type": "number",
-                      "minimum": 1,
-                      "description": "Maximum inbox size"
+                    {
+                      "type": "object",
+                      "properties": {
+                        "entities": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "name_or_address": {
+                                "type": "string",
+                                "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                              },
+                              "local_mark_first": {
+                                "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                                "type": "boolean"
+                              }
+                            },
+                            "additionalProperties": false,
+                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                          }
+                        },
+                        "check_all_founded": {
+                          "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                          "type": "boolean"
+                        }
+                      },
+                      "required": [
+                        "entities"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Used to batch find account or object IDs by name"
                     }
-                  },
-                  "required": [
-                    "op"
                   ],
-                  "additionalProperties": false
+                  "description": "Users to check existence - can be array of strings (names/addresses) or full object"
                 }
+              },
+              "required": [
+                "op",
+                "users"
               ],
-              "description": "Settings management operation"
+              "additionalProperties": false
             }
-          },
-          "required": [
-            "operation",
-            "settings"
           ],
-          "additionalProperties": false
+          "description": "Friends list management operation"
+        }
+      },
+      "required": [
+        "operation",
+        "friendslist"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "guardlist"
         },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "mark_messages_as_viewed"
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "guardlist": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "add"
+                },
+                "guards": {
+                  "minItems": 1,
+                  "maxItems": 10,
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "guard": {
+                        "type": "string",
+                        "description": "Guard address or name"
+                      },
+                      "passportValiditySeconds": {
+                        "type": "number",
+                        "minimum": 10,
+                        "maximum": 315360000,
+                        "description": "Passport validity in seconds (10s to 10 years)"
+                      }
+                    },
+                    "required": [
+                      "guard",
+                      "passportValiditySeconds"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Guard parameter"
+                  },
+                  "description": "Guards to add to guard list"
+                }
+              },
+              "required": [
+                "op",
+                "guards"
+              ],
+              "additionalProperties": false
             },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "remove"
+                },
+                "guards": {
+                  "minItems": 1,
+                  "maxItems": 10,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                  },
+                  "description": "Guard addresses to remove from guard list"
+                }
+              },
+              "required": [
+                "op",
+                "guards"
+              ],
+              "additionalProperties": false
             },
-            "messageIds": {
-              "type": "array",
-              "items": {
-                "type": "string"
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "get"
+                }
               },
-              "minItems": 1,
-              "maxItems": 1000,
-              "description": "Array of message IDs to mark as viewed (1-1000 messages). Only messages belonging to this account will be marked"
+              "required": [
+                "op"
+              ],
+              "additionalProperties": false
             }
-          },
-          "required": [
-            "operation",
-            "messageIds"
           ],
-          "additionalProperties": false
+          "description": "Guard list management operation"
+        }
+      },
+      "required": [
+        "operation",
+        "guardlist"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "settings"
         },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "mark_conversation_as_viewed"
-            },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "settings": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "get"
+                }
+              },
+              "required": [
+                "op"
+              ],
+              "additionalProperties": false
             },
-            "peerAddress": {
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/0"
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "set"
                 },
-                {
-                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/1"
+                "allowStrangerMessages": {
+                  "description": "Allow messages from strangers",
+                  "type": "boolean"
+                },
+                "maxInboxSize": {
+                  "description": "Maximum inbox size",
+                  "type": "number",
+                  "minimum": 1
                 }
+              },
+              "required": [
+                "op"
               ],
-              "description": "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"
+              "additionalProperties": false
             }
-          },
-          "required": [
-            "operation",
-            "peerAddress"
           ],
-          "additionalProperties": false
+          "description": "Settings management operation"
+        }
+      },
+      "required": [
+        "operation",
+        "settings"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "mark_messages_as_viewed"
         },
-        {
-          "type": "object",
-          "properties": {
-            "operation": {
-              "type": "string",
-              "const": "pull_messages"
-            },
-            "account": {
-              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
-              "description": "Account name or address. If not specified, uses default account"
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "messageIds": {
+          "minItems": 1,
+          "maxItems": 1000,
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of message IDs to mark as viewed (1-1000 messages). Only messages belonging to this account will be marked"
+        }
+      },
+      "required": [
+        "operation",
+        "messageIds"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "mark_conversation_as_viewed"
+        },
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "peerAddress": {
+          "anyOf": [
+            {
+              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
             },
-            "limit": {
-              "type": "number",
-              "description": "Maximum number of messages to pull from server"
+            {
+              "type": "object",
+              "properties": {
+                "name_or_address": {
+                  "type": "string",
+                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                },
+                "local_mark_first": {
+                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                  "type": "boolean"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
             }
-          },
-          "required": [
-            "operation"
           ],
-          "additionalProperties": false
+          "description": "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"
+        }
+      },
+      "required": [
+        "operation",
+        "peerAddress"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "const": "pull_messages"
+        },
+        "account": {
+          "description": "Account name or address. If not specified, uses default account",
+          "type": "string"
+        },
+        "limit": {
+          "description": "Maximum number of messages to pull from server",
+          "type": "number"
         }
+      },
+      "required": [
+        "operation"
       ],
-      "description": "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)."
+      "additionalProperties": false
     }
-  }
+  ]
 }