@wowok/agent-mcp 3.4.3 → 3.4.4

package/dist/schemas/messenger_operation.schema.json

@@ -1,2068 +1 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/messenger_operation.json",
-  "title": "Messenger Operations",
-  "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": {
-            "account": {
-              "description": "Account to query conversations for - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-              "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",
-                      "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                }
-              ]
-            },
-            "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",
-              "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"
-            },
-            "sync": {
-              "description": "Sync mode (default true): true = block on one server pull per account before returning (freshest data, one-shot semantics); false = return local data immediately and trigger a background server pull whose results appear on later queries. Only set false when slightly stale data is acceptable",
-              "type": "boolean"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "required": [
-        "operation"
-      ],
-      "additionalProperties": false
-    },
-    {
-      "type": "object",
-      "properties": {
-        "operation": {
-          "type": "string",
-          "const": "send_message"
-        },
-        "from": {
-          "description": "Sender account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "description": "Recipient ACCOUNT address or account/mark name - can be a string (name/address) or full object. Messenger registers ACCOUNTS. A Contact object id IS accepted and auto-resolved on-chain to the messenger address stored inside it; any OTHER on-chain object address is rejected locally with the object type named ⚠️ ANTI-SPAM (by design): your FIRST message to a stranger IS delivered, but follow-ups are rejected until the recipient replies once — a single reply re-opens the thread. Adding the recipient to Contact/friends does NOT exempt this (server-side permission, independent of contacts). Merchant-push SOP: have the buyer send the first message, then reply in that thread."
-        },
-        "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. REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks. Guard verification is MAINNET-ONLY (no testnet)",
-              "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",
-                  "description": "Replied-to message ID (unique within the conversation)"
-                }
-              },
-              "required": [
-                "messageId"
-              ],
-              "additionalProperties": false
-            },
-            "smart": {
-              "description": "Smart send (default true): when the recipient's guard policy rejects a plain send, silently resend using a local Passport issued via one of their guards; when no usable Passport exists, returns a structured guard_authorization_required result (authRequired=true) instead of an error. Set false for strict legacy behavior. Guard verification runs on MAINNET only",
-              "type": "boolean"
-            },
-            "authorize": {
-              "description": "One-click guard authorization: when the recipient's guard policy rejects the send, create a fresh Passport via ALL of their guards in one gas-consuming transaction and resend automatically. Use after showing the user the guard_authorization_required card and getting consent. If a guard demands submission answers, the result returns authRequired with submissions for follow-up. The Passport tx is always on MAINNET (guard verification is mainnet-only)",
-              "type": "boolean"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "required": [
-        "operation",
-        "to",
-        "content"
-      ],
-      "additionalProperties": false
-    },
-    {
-      "type": "object",
-      "properties": {
-        "operation": {
-          "type": "string",
-          "const": "send_file"
-        },
-        "from": {
-          "description": "Sender account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "description": "Recipient ACCOUNT address or account/mark name - can be a string (name/address) or full object. Messenger registers ACCOUNTS. A Contact object id IS accepted and auto-resolved on-chain to the messenger address stored inside it; any OTHER on-chain object address is rejected locally with the object type named ⚠️ ANTI-SPAM (by design): your FIRST message to a stranger IS delivered, but follow-ups are rejected until the recipient replies once — a single reply re-opens the thread. Adding the recipient to Contact/friends does NOT exempt this (server-side permission, independent of contacts). Merchant-push SOP: have the buyer send the first message, then reply in that thread."
-        },
-        "filePath": {
-          "type": "string",
-          "description": "Local file path to send. Transported as an E2EE attachment envelope (zip container); the recipient restores the original file name/type via the encrypted manifest"
-        },
-        "options": {
-          "description": "Optional file sending settings",
-          "type": "object",
-          "properties": {
-            "fileName": {
-              "description": "Custom file name",
-              "type": "string"
-            },
-            "contentType": {
-              "description": "Legacy server-visible classification hint (auto-inferred from extension: .wts/.wip, otherwise zip). Evidence types wts/wip always win over extension",
-              "type": "string",
-              "enum": [
-                "wts",
-                "wip",
-                "zip"
-              ]
-            },
-            "kind": {
-              "description": "Attachment business type for the recipient's UI. Media kinds (image/video/audio/file) are auto-inferred from extension; set 'voice' explicitly for voice messages (webm cannot be distinguished from video automatically)",
-              "type": "string",
-              "enum": [
-                "image",
-                "video",
-                "audio",
-                "voice",
-                "file",
-                "wts",
-                "wip"
-              ]
-            },
-            "mimeType": {
-              "description": "Explicit MIME type override (otherwise inferred from extension)",
-              "type": "string"
-            },
-            "caption": {
-              "description": "Caption text attached to the file. Stored inside the E2EE envelope manifest — the server cannot see it; the recipient sees it with the attachment",
-              "type": "string"
-            },
-            "durationMs": {
-              "description": "Audio/video duration in milliseconds",
-              "type": "number"
-            },
-            "width": {
-              "description": "Media width in pixels",
-              "type": "number"
-            },
-            "height": {
-              "description": "Media height in pixels",
-              "type": "number"
-            },
-            "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
-        },
-        "goal_id": {
-          "description": "Optional goal id (from goal_operation). When set, this act is recorded as communication evidence on the goal's TaskProcess (K3 27 G5) — use it only when the act belongs to an active goal's execution (order negotiation, required-info confirmation, WTS evidence, on-chain proof).",
-          "type": "string"
-        }
-      },
-      "required": [
-        "operation",
-        "to",
-        "filePath"
-      ],
-      "additionalProperties": false
-    },
-    {
-      "type": "object",
-      "properties": {
-        "operation": {
-          "type": "string",
-          "const": "send_required_info"
-        },
-        "from": {
-          "description": "Sender account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "description": "Recipient ACCOUNT address or account/mark name — the merchant account AS RECORDED IN the Contact (its stored address field). A Contact object id is ALSO accepted and auto-resolved on-chain to that stored address; any OTHER on-chain object address is rejected locally with the object type named. Can be a string (name/address) or full object ⚠️ ANTI-SPAM (by design): your FIRST message to a stranger IS delivered, but follow-ups are rejected until the recipient replies once — a single reply re-opens the thread. Adding the recipient to Contact/friends does NOT exempt this (server-side permission, independent of contacts). Merchant-push SOP: have the buyer send the first message, then reply in that thread."
-        },
-        "fields": {
-          "description": "LocalInfo field names to send (e.g. ['phone','shipping_address']). If omitted, ALL LocalInfo fields are included",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "content": {
-          "description": "Explicit plaintext content to send. If provided, fields are ignored and LocalInfo is NOT auto-assembled — the envelope then discloses the dropped names under result.fields_ignored (content wins; only ONE of content/fields is ever delivered)",
-          "type": "string"
-        },
-        "options": {
-          "description": "Optional message settings (guardAddress/passportAddress/network/replyTo/force/enable_messenger)",
-          "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. REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks. Guard verification is MAINNET-ONLY (no testnet)",
-              "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",
-                  "description": "Replied-to message ID (unique within the conversation)"
-                }
-              },
-              "required": [
-                "messageId"
-              ],
-              "additionalProperties": false
-            },
-            "smart": {
-              "description": "Smart send (default true): when the recipient's guard policy rejects a plain send, silently resend using a local Passport issued via one of their guards; when no usable Passport exists, returns a structured guard_authorization_required result (authRequired=true) instead of an error. Set false for strict legacy behavior. Guard verification runs on MAINNET only",
-              "type": "boolean"
-            },
-            "authorize": {
-              "description": "One-click guard authorization: when the recipient's guard policy rejects the send, create a fresh Passport via ALL of their guards in one gas-consuming transaction and resend automatically. Use after showing the user the guard_authorization_required card and getting consent. If a guard demands submission answers, the result returns authRequired with submissions for follow-up. The Passport tx is always on MAINNET (guard verification is mainnet-only)",
-              "type": "boolean"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "required": [
-        "operation",
-        "to"
-      ],
-      "additionalProperties": false,
-      "description": "Send the buyer's required-info confirmation to the merchant (E2EE, assembles from the SENDER's LOCAL private info — nothing is fetched from the network). PREREQUISITE: the fields named in `fields` must already be pre-stored on THIS device in your LocalInfo (private local storage: phone numbers, delivery/shipping addresses, contact entries) — pre-store them first (local info save in the account flow), then list the exact names here. Inventory check: run query_toolkit query_type='local_info_list' FIRST to see which fields exist locally and their exact names — a field name that is not in that list is not sendable and fails the assembly. Omit `fields` to send ALL stored fields; pass `content` to send explicit plaintext instead (mutually exclusive with fields)."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "operation": {
-          "type": "string",
-          "const": "watch_messages"
-        },
-        "filter": {
-          "description": "Message filter options",
-          "type": "object",
-          "properties": {
-            "account": {
-              "description": "Account to filter messages for - can be a string (name/address/mark name) or full object",
-              "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",
-                      "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                }
-              ]
-            },
-            "direction": {
-              "description": "Filter by message direction",
-              "type": "string",
-              "enum": [
-                "sent",
-                "received"
-              ]
-            },
-            "status": {
-              "description": "Filter by message status",
-              "type": "string",
-              "enum": [
-                "pending",
-                "confirmed",
-                "read",
-                "failed",
-                "rejected",
-                "decrypted",
-                "decrypt_failed"
-              ]
-            },
-            "peerAddress": {
-              "description": "Filter by peer address - can be a string (name/address) or full object",
-              "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",
-                      "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                }
-              ]
-            },
-            "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"
-            },
-            "sync": {
-              "description": "Sync mode (default true): true = block on one server pull before returning (freshest data, one-shot semantics); false = return local data immediately and trigger a background server pull whose results appear on later queries. Only set false when slightly stale data is acceptable",
-              "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"
-            },
-            "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"
-            },
-            "beforeCreatedAt": {
-              "description": "Keyset pagination cursor: only return messages created strictly BEFORE this timestamp (ms). MUST be provided together with beforeMessageId; when both are absent the newest page is returned. Use for 'open conversation showing latest N, scroll up to load older pages'",
-              "type": "number"
-            },
-            "beforeMessageId": {
-              "description": "Keyset pagination cursor: message ID anchor paired with beforeCreatedAt (tie-breaker for messages with identical createdAt). MUST be provided together with beforeCreatedAt",
-              "type": "string"
-            },
-            "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",
-              "enum": [
-                "friends",
-                "guard",
-                "stranger",
-                "any"
-              ]
-            },
-            "customListFilter": {
-              "description": "Custom list filter for advanced address-based filtering, works in combination with listFilterMode",
-              "type": "object",
-              "properties": {
-                "includeAddresses": {
-                  "description": "Include addresses - only return messages from these addresses (highest priority)",
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                },
-                "excludeAddresses": {
-                  "description": "Exclude addresses - exclude messages from these addresses",
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                },
-                "relation": {
-                  "description": "Address list relation: 'union' = combine lists as union, 'intersection' = combine lists as intersection",
-                  "type": "string",
-                  "enum": [
-                    "union",
-                    "intersection"
-                  ]
-                }
-              },
-              "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"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "required": [
-        "operation"
-      ],
-      "additionalProperties": false,
-      "description": "LOCAL-ONLY message read: returns messages from the local cache/registry and NEVER contacts the messenger server, and never advances the pull cursor (contract R2-09). Messages fetched by others appear only after pull_messages has synced them — an empty result usually means a cache miss: pull first, then watch again"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "operation": {
-          "type": "string",
-          "const": "save_attachment"
-        },
-        "account": {
-          "description": "Account owning the message - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "messageId": {
-          "type": "string",
-          "description": "Attachment message ID (a message with attachment/zipMetadata, e.g. found via watch_messages)"
-        },
-        "outputDir": {
-          "description": "Target directory. If not specified, saves to the workspace/attachments directory",
-          "type": "string"
-        },
-        "saveAs": {
-          "description": "Override file name (basename only; directories are stripped). Defaults to the original attachment file name. Collisions get a ' (1)' suffix",
-          "type": "string"
-        }
-      },
-      "required": [
-        "operation",
-        "messageId"
-      ],
-      "additionalProperties": false
-    },
-    {
-      "type": "object",
-      "properties": {
-        "operation": {
-          "type": "string",
-          "const": "generate_wts"
-        },
-        "params": {
-          "type": "object",
-          "properties": {
-            "myAccount": {
-              "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",
-                      "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                }
-              ],
-              "description": "My account - can be a string (name/address/mark name) or full object"
-            },
-            "peerAccount": {
-              "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",
-                      "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                }
-              ],
-              "description": "Peer account name or address - can be a string (name/address) or full object"
-            },
-            "range": {
-              "description": "Range filter parameters",
-              "oneOf": [
-                {
-                  "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
-                }
-              ]
-            },
-            "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": [
-            "myAccount",
-            "peerAccount"
-          ],
-          "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 to sign with - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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": {
-            "title": {
-              "description": "HTML document title",
-              "type": "string"
-            },
-            "theme": {
-              "description": "HTML theme",
-              "type": "string",
-              "enum": [
-                "light",
-                "dark"
-              ]
-            },
-            "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 that PROOF reads from — must be the SENDER account that sent the message (the sent message lives only in the sender's local storage; querying from the recipient's or any other account returns 'Message not found'). Can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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)"
-        },
-        "goal_id": {
-          "description": "Optional goal id (from goal_operation). When set, this act is recorded as communication evidence on the goal's TaskProcess (K3 27 G5) — use it only when the act belongs to an active goal's execution (order negotiation, required-info confirmation, WTS evidence, on-chain proof).",
-          "type": "string"
-        }
-      },
-      "required": [
-        "operation",
-        "messageId",
-        "network"
-      ],
-      "additionalProperties": false
-    },
-    {
-      "type": "object",
-      "properties": {
-        "operation": {
-          "type": "string",
-          "const": "blacklist"
-        },
-        "account": {
-          "description": "Account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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']"
-                    },
-                    {
-                      "type": "object",
-                      "properties": {
-                        "entities": {
-                          "minItems": 1,
-                          "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                          }
-                        },
-                        "check_all_founded": {
-                          "default": true,
-                          "description": "Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)",
-                          "type": "boolean"
-                        }
-                      },
-                      "required": [
-                        "entities",
-                        "check_all_founded"
-                      ],
-                      "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": [
-                    {
-                      "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": {
-                          "minItems": 1,
-                          "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                          }
-                        },
-                        "check_all_founded": {
-                          "default": true,
-                          "description": "Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)",
-                          "type": "boolean"
-                        }
-                      },
-                      "required": [
-                        "entities",
-                        "check_all_founded"
-                      ],
-                      "additionalProperties": false,
-                      "description": "Used to batch find account or object IDs by name"
-                    }
-                  ],
-                  "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": [
-                    {
-                      "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": {
-                          "minItems": 1,
-                          "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                          }
-                        },
-                        "check_all_founded": {
-                          "default": true,
-                          "description": "Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)",
-                          "type": "boolean"
-                        }
-                      },
-                      "required": [
-                        "entities",
-                        "check_all_founded"
-                      ],
-                      "additionalProperties": false,
-                      "description": "Used to batch find account or object IDs by name"
-                    }
-                  ],
-                  "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": {
-          "description": "Account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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']"
-                    },
-                    {
-                      "type": "object",
-                      "properties": {
-                        "entities": {
-                          "minItems": 1,
-                          "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                          }
-                        },
-                        "check_all_founded": {
-                          "default": true,
-                          "description": "Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)",
-                          "type": "boolean"
-                        }
-                      },
-                      "required": [
-                        "entities",
-                        "check_all_founded"
-                      ],
-                      "additionalProperties": false,
-                      "description": "Used to batch find account or object IDs by name"
-                    }
-                  ],
-                  "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": [
-                    {
-                      "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": {
-                          "minItems": 1,
-                          "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                          }
-                        },
-                        "check_all_founded": {
-                          "default": true,
-                          "description": "Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)",
-                          "type": "boolean"
-                        }
-                      },
-                      "required": [
-                        "entities",
-                        "check_all_founded"
-                      ],
-                      "additionalProperties": false,
-                      "description": "Used to batch find account or object IDs by name"
-                    }
-                  ],
-                  "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": [
-                    {
-                      "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": {
-                          "minItems": 1,
-                          "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-                          }
-                        },
-                        "check_all_founded": {
-                          "default": true,
-                          "description": "Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)",
-                          "type": "boolean"
-                        }
-                      },
-                      "required": [
-                        "entities",
-                        "check_all_founded"
-                      ],
-                      "additionalProperties": false,
-                      "description": "Used to batch find account or object IDs by name"
-                    }
-                  ],
-                  "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": {
-          "description": "Account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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. ⚠️ MAINNET-ONLY: Messenger guards must be Guard objects on MAINNET — a testnet Guard is rejected at add time ('Guard not found on mainnet'). Create the Guard on mainnet before adding it here."
-                      },
-                      "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. ⚠️ MAINNET-ONLY: only mainnet Guard objects are supported — testnet Guards are rejected."
-                }
-              },
-              "required": [
-                "op",
-                "guards"
-              ],
-              "additionalProperties": false
-            },
-            {
-              "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
-            },
-            {
-              "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": {
-          "description": "Account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "settings": {
-          "oneOf": [
-            {
-              "type": "object",
-              "properties": {
-                "op": {
-                  "type": "string",
-                  "const": "get"
-                }
-              },
-              "required": [
-                "op"
-              ],
-              "additionalProperties": false
-            },
-            {
-              "type": "object",
-              "properties": {
-                "op": {
-                  "type": "string",
-                  "const": "set"
-                },
-                "allowStrangerMessages": {
-                  "description": "Allow messages from strangers. NOTE: only effective while the guard list is EMPTY — with any guard configured the stranger channel is disabled server-side and non-friends must hold a passport issued via one of the configured guards",
-                  "type": "boolean"
-                },
-                "maxInboxSize": {
-                  "description": "Maximum inbox size",
-                  "type": "number",
-                  "minimum": 1
-                }
-              },
-              "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": {
-          "description": "Account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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 - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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"
-            },
-            {
-              "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "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": "mark_conversation_read"
-        },
-        "account": {
-          "description": "Account - can be a string (name/address/mark name) or full object. If not specified, uses default account",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "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"
-            },
-            {
-              "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "description": "Peer address or account name - can be a string (name/address) or full object"
-        },
-        "through_seq": {
-          "description": "Conversation sequence (leafIndex) to mark read THROUGH, inclusive. Ignored if lower than the current watermark (monotonic). Omit to use the highest RECEIVED seq retained locally. Values beyond the highest received seq are capped and reported (capped=true)",
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 9007199254740991
-        }
-      },
-      "required": [
-        "operation",
-        "peerAddress"
-      ],
-      "additionalProperties": false
-    },
-    {
-      "type": "object",
-      "properties": {
-        "operation": {
-          "type": "string",
-          "const": "pull_messages"
-        },
-        "account": {
-          "description": "Account - can be a string (name/address/mark name) or full object. If not specified, uses default account (ignored when allAccounts/accounts is set)",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "limit": {
-          "description": "Maximum number of messages to pull from server per account; in incremental mode (after set) this is the PAGE SIZE of returned messages",
-          "type": "number"
-        },
-        "allAccounts": {
-          "description": "Pull every messenger-enabled account in ONE bounded-concurrency fan-out (default concurrency 5). Only the process holding each account's polling lock pulls; per-account failures are isolated in the result entries. Returns one result entry per account",
-          "type": "boolean"
-        },
-        "accounts": {
-          "description": "Restrict the fan-out to these accounts (implies allAccounts flow). Each entry can be a string (name/address/mark name) or full object. Cold accounts are initialized on demand",
-          "type": "array",
-          "items": {
-            "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",
-                    "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-              }
-            ],
-            "description": "Account or address lookup. Can be a simple string (recommended for AI) or full object with explicit local_mark_first control. String form auto-converts to { name_or_address: <string>, local_mark_first: true }."
-          }
-        },
-        "concurrency": {
-          "description": "Max concurrent account pulls in fan-out mode (default 5)",
-          "type": "number",
-          "minimum": 1,
-          "maximum": 20
-        },
-        "peerAddress": {
-          "description": "Conversation peer. REQUIRED in incremental mode (when `after` is set) — the cursor is conversation-scoped because the sequence (leafIndex) is per conversation",
-          "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",
-                  "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ]
-        },
-        "after": {
-          "description": "Incremental cursor: return only messages of this conversation whose sequence (leafIndex) is strictly GREATER than this value, ascending, and return highest_seq/has_more plus gap detection. Omitting `after` keeps the legacy bare-array behavior. Do NOT advance this cursor on watch_messages — watch is a local query, not a consume",
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 9007199254740991
-        }
-      },
-      "required": [
-        "operation"
-      ],
-      "additionalProperties": false
-    }
-  ]
-}
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://wowok.net/schemas/messenger_operation.json","title":"Messenger Operations","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":{"account":{"description":"Account to query conversations for - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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","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"},"sync":{"description":"Sync mode (default true): true = block on one server pull per account before returning (freshest data, one-shot semantics); false = return local data immediately and trigger a background server pull whose results appear on later queries. Only set false when slightly stale data is acceptable","type":"boolean"}},"additionalProperties":false}},"required":["operation"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"send_message"},"from":{"description":"Sender account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Recipient ACCOUNT address or account/mark name - can be a string (name/address) or full object. Messenger registers ACCOUNTS. A Contact object id IS accepted and auto-resolved on-chain to the messenger address stored inside it; any OTHER on-chain object address is rejected locally with the object type named ⚠️ ANTI-SPAM (by design): your FIRST message to a stranger IS delivered, but follow-ups are rejected until the recipient replies once — a single reply re-opens the thread. Adding the recipient to Contact/friends does NOT exempt this (server-side permission, independent of contacts). Merchant-push SOP: have the buyer send the first message, then reply in that thread."},"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. REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks. Guard verification is MAINNET-ONLY (no testnet)","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","description":"Replied-to message ID (unique within the conversation)"}},"required":["messageId"],"additionalProperties":false},"smart":{"description":"Smart send (default true): when the recipient's guard policy rejects a plain send, silently resend using a local Passport issued via one of their guards; when no usable Passport exists, returns a structured guard_authorization_required result (authRequired=true) instead of an error. Set false for strict legacy behavior. Guard verification runs on MAINNET only","type":"boolean"},"authorize":{"description":"One-click guard authorization: when the recipient's guard policy rejects the send, create a fresh Passport via ALL of their guards in one gas-consuming transaction and resend automatically. Use after showing the user the guard_authorization_required card and getting consent. If a guard demands submission answers, the result returns authRequired with submissions for follow-up. The Passport tx is always on MAINNET (guard verification is mainnet-only)","type":"boolean"}},"additionalProperties":false}},"required":["operation","to","content"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"send_file"},"from":{"description":"Sender account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Recipient ACCOUNT address or account/mark name - can be a string (name/address) or full object. Messenger registers ACCOUNTS. A Contact object id IS accepted and auto-resolved on-chain to the messenger address stored inside it; any OTHER on-chain object address is rejected locally with the object type named ⚠️ ANTI-SPAM (by design): your FIRST message to a stranger IS delivered, but follow-ups are rejected until the recipient replies once — a single reply re-opens the thread. Adding the recipient to Contact/friends does NOT exempt this (server-side permission, independent of contacts). Merchant-push SOP: have the buyer send the first message, then reply in that thread."},"filePath":{"type":"string","description":"Local file path to send. Transported as an E2EE attachment envelope (zip container); the recipient restores the original file name/type via the encrypted manifest"},"options":{"description":"Optional file sending settings","type":"object","properties":{"fileName":{"description":"Custom file name","type":"string"},"contentType":{"description":"Legacy server-visible classification hint (auto-inferred from extension: .wts/.wip, otherwise zip). Evidence types wts/wip always win over extension","type":"string","enum":["wts","wip","zip"]},"kind":{"description":"Attachment business type for the recipient's UI. Media kinds (image/video/audio/file) are auto-inferred from extension; set 'voice' explicitly for voice messages (webm cannot be distinguished from video automatically)","type":"string","enum":["image","video","audio","voice","file","wts","wip"]},"mimeType":{"description":"Explicit MIME type override (otherwise inferred from extension)","type":"string"},"caption":{"description":"Caption text attached to the file. Stored inside the E2EE envelope manifest — the server cannot see it; the recipient sees it with the attachment","type":"string"},"durationMs":{"description":"Audio/video duration in milliseconds","type":"number"},"width":{"description":"Media width in pixels","type":"number"},"height":{"description":"Media height in pixels","type":"number"},"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},"goal_id":{"description":"Optional goal id (from goal_operation). When set, this act is recorded as communication evidence on the goal's TaskProcess (K3 27 G5) — use it only when the act belongs to an active goal's execution (order negotiation, required-info confirmation, WTS evidence, on-chain proof).","type":"string"}},"required":["operation","to","filePath"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"send_required_info"},"from":{"description":"Sender account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Recipient ACCOUNT address or account/mark name — the merchant account AS RECORDED IN the Contact (its stored address field). A Contact object id is ALSO accepted and auto-resolved on-chain to that stored address; any OTHER on-chain object address is rejected locally with the object type named. Can be a string (name/address) or full object ⚠️ ANTI-SPAM (by design): your FIRST message to a stranger IS delivered, but follow-ups are rejected until the recipient replies once — a single reply re-opens the thread. Adding the recipient to Contact/friends does NOT exempt this (server-side permission, independent of contacts). Merchant-push SOP: have the buyer send the first message, then reply in that thread."},"fields":{"description":"LocalInfo field names to send (e.g. ['phone','shipping_address']). If omitted, ALL LocalInfo fields are included","type":"array","items":{"type":"string"}},"content":{"description":"Explicit plaintext content to send. If provided, fields are ignored and LocalInfo is NOT auto-assembled — the envelope then discloses the dropped names under result.fields_ignored (content wins; only ONE of content/fields is ever delivered)","type":"string"},"options":{"description":"Optional message settings (guardAddress/passportAddress/network/replyTo/force/enable_messenger)","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. REQUIRED when guardAddress and passportAddress are provided — Guard messages and regular messages are independent data systems on different networks. Guard verification is MAINNET-ONLY (no testnet)","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","description":"Replied-to message ID (unique within the conversation)"}},"required":["messageId"],"additionalProperties":false},"smart":{"description":"Smart send (default true): when the recipient's guard policy rejects a plain send, silently resend using a local Passport issued via one of their guards; when no usable Passport exists, returns a structured guard_authorization_required result (authRequired=true) instead of an error. Set false for strict legacy behavior. Guard verification runs on MAINNET only","type":"boolean"},"authorize":{"description":"One-click guard authorization: when the recipient's guard policy rejects the send, create a fresh Passport via ALL of their guards in one gas-consuming transaction and resend automatically. Use after showing the user the guard_authorization_required card and getting consent. If a guard demands submission answers, the result returns authRequired with submissions for follow-up. The Passport tx is always on MAINNET (guard verification is mainnet-only)","type":"boolean"}},"additionalProperties":false}},"required":["operation","to"],"additionalProperties":false,"description":"Send the buyer's required-info confirmation to the merchant (E2EE, assembles from the SENDER's LOCAL private info — nothing is fetched from the network). PREREQUISITE: the fields named in `fields` must already be pre-stored on THIS device in your LocalInfo (private local storage: phone numbers, delivery/shipping addresses, contact entries) — pre-store them first (local info save in the account flow), then list the exact names here. Inventory check: run query_toolkit query_type='local_info_list' FIRST to see which fields exist locally and their exact names — a field name that is not in that list is not sendable and fails the assembly. Omit `fields` to send ALL stored fields; pass `content` to send explicit plaintext instead (mutually exclusive with fields)."},{"type":"object","properties":{"operation":{"type":"string","const":"watch_messages"},"filter":{"description":"Message filter options","type":"object","properties":{"account":{"description":"Account to filter messages for - can be a string (name/address/mark name) or full object","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"direction":{"description":"Filter by message direction","type":"string","enum":["sent","received"]},"status":{"description":"Filter by message status","type":"string","enum":["pending","confirmed","read","failed","rejected","decrypted","decrypt_failed"]},"peerAddress":{"description":"Filter by peer address - can be a string (name/address) or full object","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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"},"sync":{"description":"Sync mode (default true): true = block on one server pull before returning (freshest data, one-shot semantics); false = return local data immediately and trigger a background server pull whose results appear on later queries. Only set false when slightly stale data is acceptable","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"},"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"},"beforeCreatedAt":{"description":"Keyset pagination cursor: only return messages created strictly BEFORE this timestamp (ms). MUST be provided together with beforeMessageId; when both are absent the newest page is returned. Use for 'open conversation showing latest N, scroll up to load older pages'","type":"number"},"beforeMessageId":{"description":"Keyset pagination cursor: message ID anchor paired with beforeCreatedAt (tie-breaker for messages with identical createdAt). MUST be provided together with beforeCreatedAt","type":"string"},"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","enum":["friends","guard","stranger","any"]},"customListFilter":{"description":"Custom list filter for advanced address-based filtering, works in combination with listFilterMode","type":"object","properties":{"includeAddresses":{"description":"Include addresses - only return messages from these addresses (highest priority)","type":"array","items":{"type":"string"}},"excludeAddresses":{"description":"Exclude addresses - exclude messages from these addresses","type":"array","items":{"type":"string"}},"relation":{"description":"Address list relation: 'union' = combine lists as union, 'intersection' = combine lists as intersection","type":"string","enum":["union","intersection"]}},"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"}},"additionalProperties":false}},"required":["operation"],"additionalProperties":false,"description":"LOCAL-ONLY message read: returns messages from the local cache/registry and NEVER contacts the messenger server, and never advances the pull cursor (contract R2-09). Messages fetched by others appear only after pull_messages has synced them — an empty result usually means a cache miss: pull first, then watch again"},{"type":"object","properties":{"operation":{"type":"string","const":"save_attachment"},"account":{"description":"Account owning the message - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"messageId":{"type":"string","description":"Attachment message ID (a message with attachment/zipMetadata, e.g. found via watch_messages)"},"outputDir":{"description":"Target directory. If not specified, saves to the workspace/attachments directory","type":"string"},"saveAs":{"description":"Override file name (basename only; directories are stripped). Defaults to the original attachment file name. Collisions get a ' (1)' suffix","type":"string"}},"required":["operation","messageId"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"generate_wts"},"params":{"type":"object","properties":{"myAccount":{"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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"My account - can be a string (name/address/mark name) or full object"},"peerAccount":{"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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Peer account name or address - can be a string (name/address) or full object"},"range":{"description":"Range filter parameters","oneOf":[{"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}]},"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":["myAccount","peerAccount"],"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"},"network":{"description":"Network partition you assert this evidence belongs to (mainnet/testnet/localnet). The official-key verdict is scored in the keybook's own anchor partition and stays evidence for THAT partition only — declaring it here just pins the comparison and the receipt's wording. Omit to compare against the process-pinned network.","type":"string","enum":["localnet","testnet","mainnet"]}},"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 to sign with - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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":{"title":{"description":"HTML document title","type":"string"},"theme":{"description":"HTML theme","type":"string","enum":["light","dark"]},"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 that PROOF reads from — must be the SENDER account that sent the message (the sent message lives only in the sender's local storage; querying from the recipient's or any other account returns 'Message not found'). Can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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)"},"goal_id":{"description":"Optional goal id (from goal_operation). When set, this act is recorded as communication evidence on the goal's TaskProcess (K3 27 G5) — use it only when the act belongs to an active goal's execution (order negotiation, required-info confirmation, WTS evidence, on-chain proof).","type":"string"}},"required":["operation","messageId","network"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"blacklist"},"account":{"description":"Account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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']"},{"type":"object","properties":{"entities":{"minItems":1,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}},"check_all_founded":{"default":true,"description":"Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)","type":"boolean"}},"required":["entities","check_all_founded"],"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":[{"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":{"minItems":1,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}},"check_all_founded":{"default":true,"description":"Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)","type":"boolean"}},"required":["entities","check_all_founded"],"additionalProperties":false,"description":"Used to batch find account or object IDs by name"}],"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":[{"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":{"minItems":1,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}},"check_all_founded":{"default":true,"description":"Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)","type":"boolean"}},"required":["entities","check_all_founded"],"additionalProperties":false,"description":"Used to batch find account or object IDs by name"}],"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":{"description":"Account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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']"},{"type":"object","properties":{"entities":{"minItems":1,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}},"check_all_founded":{"default":true,"description":"Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)","type":"boolean"}},"required":["entities","check_all_founded"],"additionalProperties":false,"description":"Used to batch find account or object IDs by name"}],"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":[{"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":{"minItems":1,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}},"check_all_founded":{"default":true,"description":"Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)","type":"boolean"}},"required":["entities","check_all_founded"],"additionalProperties":false,"description":"Used to batch find account or object IDs by name"}],"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":[{"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":{"minItems":1,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}},"check_all_founded":{"default":true,"description":"Whether to check all entities are found. Defaults to true: abort and throw if ANY entity cannot be resolved. Set false only when partial resolution is explicitly intended (only found IDs are returned)","type":"boolean"}},"required":["entities","check_all_founded"],"additionalProperties":false,"description":"Used to batch find account or object IDs by name"}],"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":{"description":"Account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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. ⚠️ MAINNET-ONLY: Messenger guards must be Guard objects on MAINNET — a testnet Guard is rejected at add time ('Guard not found on mainnet'). Create the Guard on mainnet before adding it here."},"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. ⚠️ MAINNET-ONLY: only mainnet Guard objects are supported — testnet Guards are rejected."}},"required":["op","guards"],"additionalProperties":false},{"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},{"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":{"description":"Account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"settings":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"get"}},"required":["op"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"set"},"allowStrangerMessages":{"description":"Allow messages from strangers. NOTE: only effective while the guard list is EMPTY — with any guard configured the stranger channel is disabled server-side and non-friends must hold a passport issued via one of the configured guards","type":"boolean"},"maxInboxSize":{"description":"Maximum inbox size","type":"number","minimum":1}},"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":{"description":"Account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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 - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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"},{"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"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":"mark_conversation_read"},"account":{"description":"Account - can be a string (name/address/mark name) or full object. If not specified, uses default account","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"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"},{"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Peer address or account name - can be a string (name/address) or full object"},"through_seq":{"description":"Conversation sequence (leafIndex) to mark read THROUGH, inclusive. Ignored if lower than the current watermark (monotonic). Omit to use the highest RECEIVED seq retained locally. Values beyond the highest received seq are capped and reported (capped=true)","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["operation","peerAddress"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"pull_messages"},"account":{"description":"Account - can be a string (name/address/mark name) or full object. If not specified, uses default account (ignored when allAccounts/accounts is set)","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"limit":{"description":"Maximum number of messages to pull from server per account; in incremental mode (after set) this is the PAGE SIZE of returned messages","type":"number"},"allAccounts":{"description":"Pull every messenger-enabled account in ONE bounded-concurrency fan-out (default concurrency 5). Only the process holding each account's polling lock pulls; per-account failures are isolated in the result entries. Returns one result entry per account","type":"boolean"},"accounts":{"description":"Restrict the fan-out to these accounts (implies allAccounts flow). Each entry can be a string (name/address/mark name) or full object. Cold accounts are initialized on demand","type":"array","items":{"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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Account or address lookup. Can be a simple string (recommended for AI) or full object with explicit local_mark_first control. String form auto-converts to { name_or_address: <string>, local_mark_first: true }."}},"concurrency":{"description":"Max concurrent account pulls in fan-out mode (default 5)","type":"number","minimum":1,"maximum":20},"peerAddress":{"description":"Conversation peer. REQUIRED in incremental mode (when `after` is set) — the cursor is conversation-scoped because the sequence (leafIndex) is per conversation","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","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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}]},"after":{"description":"Incremental cursor: return only messages of this conversation whose sequence (leafIndex) is strictly GREATER than this value, ascending, and return highest_seq/has_more plus gap detection. Omitting `after` keeps the legacy bare-array behavior. Do NOT advance this cursor on watch_messages — watch is a local query, not a consume","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["operation"],"additionalProperties":false}]}