@wowok/agent-mcp 2.2.13 → 2.2.15

package/dist/schemas/messenger_operation.schema.json

@@ -0,0 +1,1393 @@
+{
+  "$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": [
+        {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "string",
+              "const": "watch_conversations"
+            },
+            "filter": {
+              "type": "object",
+              "properties": {
+                "account": {
+                  "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"
+                },
+                "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": {
+                  "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": {
+                  "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"
+                },
+                "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"
+                }
+              },
+              "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"
+            }
+          },
+          "required": [
+            "operation"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "string",
+              "const": "send_message"
+            },
+            "from": {
+              "type": "string",
+              "description": "Sender account name or address. If not specified, uses default account"
+            },
+            "to": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "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: '0x1234...' - uses address directly"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "name_or_address": {
+                      "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+                      "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"
+                    }
+                  },
+                  "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": 10000,
+              "description": "Message content text"
+            },
+            "options": {
+              "type": "object",
+              "properties": {
+                "guardAddress": {
+                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+                  "description": "Guard address"
+                },
+                "passportAddress": {
+                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+                  "description": "Passport address"
+                },
+                "force": {
+                  "type": "boolean",
+                  "description": "Force send even if there are pending Guard messages"
+                },
+                "new_messenger_name": {
+                  "type": "string",
+                  "description": "New messenger name for recipient"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Optional message settings"
+            }
+          },
+          "required": [
+            "operation",
+            "to",
+            "content"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "string",
+              "const": "send_file"
+            },
+            "from": {
+              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+              "description": "Sender account name or address. If not specified, uses default account"
+            },
+            "to": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/0"
+                },
+                {
+                  "$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"
+                },
+                "passportAddress": {
+                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+                  "description": "Passport address"
+                },
+                "force": {
+                  "type": "boolean",
+                  "description": "Force send even if there are pending Guard messages"
+                },
+                "new_messenger_name": {
+                  "type": "string",
+                  "description": "New messenger name for recipient"
+                }
+              },
+              "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)"
+                      },
+                      "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"
+              ],
+              "description": "Network to use for on-chain proof"
+            }
+          },
+          "required": [
+            "operation",
+            "messageId"
+          ],
+          "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": {
+                      "type": "string",
+                      "const": "add"
+                    },
+                    "users": {
+                      "anyOf": [
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          },
+                          "description": "Array of account names, addresses, or mark names. Local marks are searched first for each entry"
+                        },
+                        {
+                          "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"
+                    }
+                  },
+                  "required": [
+                    "op",
+                    "users"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "op": {
+                      "type": "string",
+                      "const": "remove"
+                    },
+                    "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"
+                    }
+                  },
+                  "required": [
+                    "op"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "op": {
+                      "type": "string",
+                      "const": "get"
+                    }
+                  },
+                  "required": [
+                    "op"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "op": {
+                      "type": "string",
+                      "const": "exist"
+                    },
+                    "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"
+                    }
+                  },
+                  "required": [
+                    "op",
+                    "users"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Blacklist management operation"
+            }
+          },
+          "required": [
+            "operation",
+            "blacklist"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "string",
+              "const": "friendslist"
+            },
+            "account": {
+              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+              "description": "Account name or address. If not specified, uses default account"
+            },
+            "friendslist": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "op": {
+                      "type": "string",
+                      "const": "add"
+                    },
+                    "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 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"
+                    },
+                    "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 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"
+                    }
+                  },
+                  "required": [
+                    "op"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "op": {
+                      "type": "string",
+                      "const": "exist"
+                    },
+                    "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"
+                    }
+                  },
+                  "required": [
+                    "op",
+                    "users"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Friends list management operation"
+            }
+          },
+          "required": [
+            "operation",
+            "friendslist"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "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"
+                    },
+                    "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)"
+                          }
+                        },
+                        "required": [
+                          "guard",
+                          "passportValiditySeconds"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Guard parameter"
+                      },
+                      "minItems": 1,
+                      "maxItems": 10,
+                      "description": "Guards to add to guard list"
+                    }
+                  },
+                  "required": [
+                    "op",
+                    "guards"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "op": {
+                      "type": "string",
+                      "const": "remove"
+                    },
+                    "guards": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from"
+                      },
+                      "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": [
+                    "op"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Guard list management operation"
+            }
+          },
+          "required": [
+            "operation",
+            "guardlist"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "string",
+              "const": "settings"
+            },
+            "account": {
+              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+              "description": "Account name or address. If not specified, uses default account"
+            },
+            "settings": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "op": {
+                      "type": "string",
+                      "const": "get"
+                    }
+                  },
+                  "required": [
+                    "op"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "op": {
+                      "type": "string",
+                      "const": "set"
+                    },
+                    "allowStrangerMessages": {
+                      "type": "boolean",
+                      "description": "Allow messages from strangers"
+                    },
+                    "maxInboxSize": {
+                      "type": "number",
+                      "minimum": 1,
+                      "description": "Maximum inbox size"
+                    }
+                  },
+                  "required": [
+                    "op"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Settings management operation"
+            }
+          },
+          "required": [
+            "operation",
+            "settings"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "string",
+              "const": "mark_messages_as_viewed"
+            },
+            "account": {
+              "$ref": "#/definitions/messenger_operation/anyOf/1/properties/from",
+              "description": "Account name or address. If not specified, uses default account"
+            },
+            "messageIds": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "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": [
+            "operation",
+            "messageIds"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "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"
+            },
+            "peerAddress": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/0"
+                },
+                {
+                  "$ref": "#/definitions/messenger_operation/anyOf/1/properties/to/anyOf/1"
+                }
+              ],
+              "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
+        }
+      ],
+      "description": "Messenger operation input schema"
+    }
+  }
+}