@wowok/agent-mcp 3.0.3 → 3.0.5

package/dist/schemas/messenger_operation.schema.json

@@ -55,6 +55,10 @@
             "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
@@ -194,7 +198,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",
@@ -205,7 +209,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",
@@ -213,6 +217,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"
@@ -437,6 +474,10 @@
               "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"
@@ -599,252 +640,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
     },
@@ -1754,12 +1571,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.output.json

@@ -1319,7 +1319,7 @@
                       },
                       "description": {
                         "type": "string",
-                        "description": "Service description preview (<=260 UTF-8 chars)."
+                        "description": "Full Service description as carried on-chain (input creation still caps at 4000 UTF-8 chars)."
                       }
                     },
                     "required": [
@@ -1468,7 +1468,7 @@
                       },
                       "description": {
                         "type": "string",
-                        "description": "Demand description preview (<=260 UTF-8 chars)."
+                        "description": "Full Demand description as carried on-chain (input creation still caps at 4000 UTF-8 chars)."
                       },
                       "rewards": {
                         "type": "array",