@wowok/agent-mcp 3.0.4 → 3.0.6

package/dist/schemas/messenger_operation.schema.json

@@ -129,7 +129,7 @@
               "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",
+              "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",
@@ -150,6 +150,14 @@
                 "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
@@ -198,7 +206,7 @@
         },
         "filePath": {
           "type": "string",
-          "description": "Local file path to send. File will be compressed as ZIP before sending"
+          "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",
@@ -209,7 +217,7 @@
               "type": "string"
             },
             "contentType": {
-              "description": "Content type hint",
+              "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",
@@ -217,6 +225,39 @@
                 "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"
@@ -323,7 +364,7 @@
               "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",
+              "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",
@@ -344,6 +385,14 @@
                 "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
@@ -526,6 +575,14 @@
               "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"
@@ -607,252 +664,28 @@
       "properties": {
         "operation": {
           "type": "string",
-          "const": "extract_zip_messages"
+          "const": "save_attachment"
         },
         "account": {
-          "description": "Account name or address. If not specified, uses default account",
+          "description": "Account name or address owning the message. If not specified, uses default account",
           "type": "string"
         },
-        "messages": {
-          "type": "array",
-          "items": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "messageId": {
-                    "type": "string",
-                    "description": "Message ID"
-                  },
-                  "fromAddress": {
-                    "type": "string",
-                    "description": "Sender address"
-                  },
-                  "toAddress": {
-                    "type": "string",
-                    "description": "Recipient address"
-                  },
-                  "plaintextHash": {
-                    "type": "string",
-                    "description": "Plaintext hash"
-                  },
-                  "plaintext": {
-                    "description": "Decrypted plaintext (optional)",
-                    "type": "string"
-                  },
-                  "replyTo": {
-                    "description": "Quoted (replied-to) message reference, if this message replies to a previous one",
-                    "type": "object",
-                    "properties": {
-                      "messageId": {
-                        "type": "string",
-                        "description": "Replied-to message ID (unique within the conversation)"
-                      }
-                    },
-                    "required": [
-                      "messageId"
-                    ],
-                    "additionalProperties": false
-                  },
-                  "guardAddress": {
-                    "description": "Guard address",
-                    "type": "string"
-                  },
-                  "passportAddress": {
-                    "description": "Passport address",
-                    "type": "string"
-                  },
-                  "lastReceivedLeafIndex": {
-                    "description": "Last received leaf index",
-                    "type": "number"
-                  },
-                  "direction": {
-                    "type": "string",
-                    "enum": [
-                      "sent",
-                      "received"
-                    ],
-                    "description": "Message direction"
-                  },
-                  "status": {
-                    "type": "string",
-                    "enum": [
-                      "pending",
-                      "confirmed",
-                      "read",
-                      "failed",
-                      "rejected",
-                      "decrypted",
-                      "decrypt_failed"
-                    ],
-                    "description": "Message status"
-                  },
-                  "msgType": {
-                    "anyOf": [
-                      {
-                        "type": "number",
-                        "const": 1
-                      },
-                      {
-                        "type": "number",
-                        "const": 3
-                      }
-                    ],
-                    "description": "Message type"
-                  },
-                  "leafIndex": {
-                    "description": "Leaf index",
-                    "type": "number"
-                  },
-                  "prevRoot": {
-                    "description": "Previous Merkle Root",
-                    "type": "string"
-                  },
-                  "newRoot": {
-                    "description": "Current Merkle Root",
-                    "type": "string"
-                  },
-                  "serverSignature": {
-                    "description": "Server signature",
-                    "type": "string"
-                  },
-                  "serverTimestamp": {
-                    "description": "Server confirmation timestamp",
-                    "type": "number"
-                  },
-                  "serverPublicKey": {
-                    "description": "Server public key",
-                    "type": "string"
-                  },
-                  "arkConfirmed": {
-                    "description": "ARK confirmation",
-                    "type": "object",
-                    "properties": {
-                      "recipient": {
-                        "type": "string",
-                        "description": "Recipient address"
-                      },
-                      "recipientPublicKey": {
-                        "type": "string",
-                        "description": "Recipient public key"
-                      },
-                      "signature": {
-                        "type": "string",
-                        "description": "Recipient signature"
-                      },
-                      "timestamp": {
-                        "type": "number",
-                        "description": "ARK confirmation time"
-                      }
-                    },
-                    "required": [
-                      "recipient",
-                      "recipientPublicKey",
-                      "signature",
-                      "timestamp"
-                    ],
-                    "additionalProperties": false
-                  },
-                  "createdAt": {
-                    "type": "number",
-                    "description": "Message creation time (client)"
-                  },
-                  "receivedAt": {
-                    "description": "Local reception time",
-                    "type": "number"
-                  },
-                  "zipMetadata": {
-                    "description": "ZIP file metadata",
-                    "type": "object",
-                    "properties": {
-                      "fileName": {
-                        "type": "string",
-                        "description": "ZIP filename"
-                      },
-                      "fileSize": {
-                        "type": "number",
-                        "description": "File size in bytes"
-                      },
-                      "fileHash": {
-                        "type": "string",
-                        "description": "File SHA256 hash"
-                      },
-                      "contentType": {
-                        "type": "string",
-                        "enum": [
-                          "text",
-                          "zip",
-                          "wts",
-                          "wip"
-                        ],
-                        "description": "Content type"
-                      },
-                      "localCachePath": {
-                        "description": "Local cache path",
-                        "type": "string"
-                      },
-                      "downloadedAt": {
-                        "description": "Download timestamp",
-                        "type": "number"
-                      }
-                    },
-                    "required": [
-                      "fileName",
-                      "fileSize",
-                      "fileHash",
-                      "contentType"
-                    ],
-                    "additionalProperties": false
-                  },
-                  "proof": {
-                    "description": "On-chain proof object address",
-                    "type": "string"
-                  },
-                  "decryptError": {
-                    "description": "Decryption failure reason",
-                    "type": "string"
-                  },
-                  "decryptAttempts": {
-                    "description": "Number of decryption attempts",
-                    "type": "number"
-                  },
-                  "lastDecryptAttemptAt": {
-                    "description": "Last decryption attempt timestamp",
-                    "type": "number"
-                  },
-                  "viewedAt": {
-                    "description": "Timestamp when the current user viewed this message (local storage). If present, indicates the message has been viewed by the user. Only applicable to received messages (direction === 'received')",
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "messageId",
-                  "fromAddress",
-                  "toAddress",
-                  "plaintextHash",
-                  "direction",
-                  "status",
-                  "msgType",
-                  "createdAt"
-                ],
-                "additionalProperties": false,
-                "description": "Message object"
-              }
-            ]
-          },
-          "description": "Array of message objects or message IDs to extract"
+        "messageId": {
+          "type": "string",
+          "description": "Attachment message ID (a message with attachment/zipMetadata, e.g. found via watch_messages)"
         },
         "outputDir": {
-          "description": "Output directory path for extracted files. If not specified, defaults to the workspace/extracted directory",
+          "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",
-        "messages"
+        "messageId"
       ],
       "additionalProperties": false
     },
@@ -1662,7 +1495,7 @@
                   "const": "set"
                 },
                 "allowStrangerMessages": {
-                  "description": "Allow messages from strangers",
+                  "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": {
@@ -1762,12 +1595,30 @@
           "const": "pull_messages"
         },
         "account": {
-          "description": "Account name or address. If not specified, uses default account",
+          "description": "Account name or address. If not specified, uses default account (ignored when allAccounts/accounts is set)",
           "type": "string"
         },
         "limit": {
-          "description": "Maximum number of messages to pull from server",
+          "description": "Maximum number of messages to pull from server per account",
           "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). Cold accounts are initialized on demand",
+          "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)."
+          }
+        },
+        "concurrency": {
+          "description": "Max concurrent account pulls in fan-out mode (default 5)",
+          "type": "number",
+          "minimum": 1,
+          "maximum": 20
         }
       },
       "required": [

package/dist/schemas/onchain_events.schema.json

@@ -75,7 +75,7 @@
           "type": "string"
         }
       ],
-      "description": "Event type to query. Supported types: ArbEvent (arbitration events), NewOrderEvent (new order events), ProgressEvent (progress events), DemandPresentEvent (demand presentation events), DemandFeedbackEvent (demand feedback events), NewEntityEvent (new entity registration events)"
+      "description": "Event type to query. Supported types (all 16 built-in framework events): ArbEvent (arbitration events), NewOrderEvent (new order events), ProgressEvent (progress events), DemandPresentEvent (demand presentation events), DemandFeedbackEvent (demand feedback events), NewEntityEvent (new entity registration events), ServiceEvent (service lifecycle events), ArbitrationEvent (arbitration creation events), DemandChangedEvent (demand update events), VoteEvent (voting events), FeedbackEvent (feedback events), AllocationEvent (allocation distribution events), TreasuryEvent (treasury deposit/withdraw events), RewardClaimEvent (reward claim events), RewardFundEvent (reward funding events), NewPaymentEvent (universal fund-flow receipt events). Any other string is accepted as a generic MoveEventType (e.g. '0x2::coin::CoinEvent')"
     },
     "cursor": {
       "description": "Optional pagination cursor for fetching next page of results. Use null for first query, then use nextCursor from response for subsequent queries",