@wowok/agent-mcp 3.0.4 → 3.0.5

package/dist/schemas/messenger_operation.schema.json

@@ -198,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",
@@ -209,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",
@@ -217,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"
@@ -607,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
     },
@@ -1762,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_operations.schema.json

@@ -4890,7 +4890,7 @@
                               "additionalProperties": false,
                               "description": "Guard object that needs verification when writing policy"
                             },
-                            "description": "Guard object list that can be verified when writing data"
+                            "description": "Guard object list that can be verified when writing data. REQUIRED (non-empty) when id_from is 0/None (chain abort 22); optional when id_from is Clock/Signer."
                           },
                           "quote_guard": {
                             "description": "Guard object ID that needs verification when referencing this policy data on-chain (e.g., verifying if user has paid subscription). If null, no verification is needed for on-chain references. The Guard must have empty 'relies' field and 'rep' field true.",
@@ -5383,7 +5383,7 @@
                             "description": "Data item list."
                           },
                           "write_guard": {
-                            "description": "Guard ID or name. Used to specify the policy write permissions and rules corresponding to this Guard.",
+                            "description": "Guard ID or name. REQUIRED for data_add items when the matching policy uses id_from=None(0): it must reference one of that policy's write_guard guards, otherwise the chain aborts with 22 (E_POLICY_WRITE_GUARD_REQUIRED). Optional for Clock/Signer policies.",
                             "type": "string"
                           }
                         },
@@ -5469,7 +5469,7 @@
                             "description": "Data item ID list."
                           },
                           "write_guard": {
-                            "description": "Guard ID or name. Used to verify permission to delete data.",
+                            "description": "Guard ID or name. REQUIRED for data_remove items when the matching policy uses id_from=None(0); optional for Clock/Signer policies.",
                             "type": "string"
                           }
                         },

package/dist/schemas/onchain_operations_repository.schema.json

@@ -144,7 +144,7 @@
                           "additionalProperties": false,
                           "description": "Guard object that needs verification when writing policy"
                         },
-                        "description": "Guard object list that can be verified when writing data"
+                        "description": "Guard object list that can be verified when writing data. REQUIRED (non-empty) when id_from is 0/None (chain abort 22); optional when id_from is Clock/Signer."
                       },
                       "quote_guard": {
                         "description": "Guard object ID that needs verification when referencing this policy data on-chain (e.g., verifying if user has paid subscription). If null, no verification is needed for on-chain references. The Guard must have empty 'relies' field and 'rep' field true.",
@@ -637,7 +637,7 @@
                         "description": "Data item list."
                       },
                       "write_guard": {
-                        "description": "Guard ID or name. Used to specify the policy write permissions and rules corresponding to this Guard.",
+                        "description": "Guard ID or name. REQUIRED for data_add items when the matching policy uses id_from=None(0): it must reference one of that policy's write_guard guards, otherwise the chain aborts with 22 (E_POLICY_WRITE_GUARD_REQUIRED). Optional for Clock/Signer policies.",
                         "type": "string"
                       }
                     },
@@ -723,7 +723,7 @@
                         "description": "Data item ID list."
                       },
                       "write_guard": {
-                        "description": "Guard ID or name. Used to verify permission to delete data.",
+                        "description": "Guard ID or name. REQUIRED for data_remove items when the matching policy uses id_from=None(0); optional for Clock/Signer policies.",
                         "type": "string"
                       }
                     },

package/dist/schemas/onchain_table_data.output.json

@@ -5997,6 +5997,36 @@
                       "additionalProperties": false,
                       "description": "Role evidence derived from the address's on-chain facts (K3 22 §13 P1-7)."
                     },
+                    "follow_ups": {
+                      "description": "Guided follow-ups (INTERACTION FLOOR: always at least 2). Data-driven probes first (permission organizations / order footprint when memberships exist), generic relation probes (public personal profile / reverse map / recent activity) fill up to the floor. Present at least two, numbered, so the user can answer with one short reply.",
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "label": {
+                            "type": "string",
+                            "description": "Short label of the guided follow-up probe."
+                          },
+                          "detail": {
+                            "description": "One line on what the probe answers.",
+                            "type": "string"
+                          },
+                          "call": {
+                            "type": "object",
+                            "propertyNames": {
+                              "type": "string"
+                            },
+                            "additionalProperties": {},
+                            "description": "READY-TO-RUN query_toolkit arguments for this probe — present it to the user so a single short reply runs it."
+                          }
+                        },
+                        "required": [
+                          "label",
+                          "call"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
                     "service_analysis": {
                       "description": "Service-type analysis merged into the address profile (present for Service addresses).",
                       "anyOf": [
@@ -9520,6 +9550,160 @@
           ],
           "additionalProperties": false,
           "description": "Cross-network build detection + mainnet customization preflight (first-touch migration): detect whether the account has already built Services/Machines/etc. on the source network (default testnet), report the same on the target network (default mainnet), and return a business-facing checklist of the key settings to confirm/change when migrating — payment token, location, arbitration, WIP, gas. Read-only."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_topology"
+            },
+            "focus": {
+              "description": "Seed of the topology — an on-chain address (EOA 0x00… or any object 0x10..0x24/0xf1) or a LocalMark name (resolved automatically). Required when query_type='onchain_topology'. The read-side topology kernel expands OUTWARD from this seed over the machine-readable EdgeSchema: holder fields, global reverse indexes (orders/permissions/bindings/votes), Machine node tables (the workflow graph) and derived money-flow edges.",
+              "type": "string"
+            },
+            "context_network": {
+              "type": "string",
+              "enum": [
+                "testnet",
+                "mainnet",
+                "localnet"
+              ],
+              "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+            },
+            "intent": {
+              "description": "SEMANTIC exploration strategy (G3) — what this topology call is trying to establish. Deterministically shapes the edge whitelist, per-family depth caps and budget: full_map=complete structural map; order_health=order lifecycle+completion+disputes; fund_flow=payments+allocation waterfall+guard-gated splits; workflow=Machine node graphs+transitions+progress; counterparty=who is on the other side (buyer/seller/agents/operators); reputation=votes+arbitration record+contacts; permission=permission groups+bindings+entity tables; supply_chain=multi-leg allocation/sub-order settlement; arbitration=dispute cases+voters; demand_match=demand presenters+guards+rewards. When omitted, defaults come from the persona system (role default intents < account persona preference), then industry templates; every applied layer is reported in result.strategy.trace.",
+              "type": "string",
+              "enum": [
+                "full_map",
+                "order_health",
+                "fund_flow",
+                "workflow",
+                "counterparty",
+                "reputation",
+                "permission",
+                "supply_chain",
+                "arbitration",
+                "demand_match"
+              ]
+            },
+            "role": {
+              "description": "Identity lens for the default strategy: the persona role whose default intents and RoleProfile.topology preference drive the exploration when 'intent' is omitted (e.g. prospect → counterparty+reputation+fund_flow due diligence).",
+              "type": "string",
+              "enum": [
+                "merchant",
+                "customer",
+                "demander",
+                "prospect",
+                "supplier",
+                "collaborator",
+                "arbitrator"
+              ]
+            },
+            "industry": {
+              "description": "Industry template lens (freelance/rental/education/travel/subscription/retail or a registered pack industry): shapes per-family depth caps — e.g. rental deepens money edges (deposit round-trip), travel deepens workflow (multi-leg trips).",
+              "type": "string"
+            },
+            "context_account": {
+              "description": "Optional EOA address whose persona record supplies the identity-specific exploration preference (RoleProfile.topology). Omit to use the system persona. Also serves as the OBSERVER of the G2 role-interest view when interest_role is set.",
+              "type": "string"
+            },
+            "interest_role": {
+              "description": "G2 role interest view — project THIS CommercialRole's complete interest view (利益评估 stakes + 可行操作路径 node-game actions + 博弈对手分析 + 风险提醒) for context_account (or the seed when it is an EOA) over the same expanded graph. The view is returned as result.role_interest and as one IR:<role> finding carrying the same structured payload. Scoring comes exclusively from the evaluation game modules; when omitted, defaults to the persona 'role' lens if provided.",
+              "type": "string",
+              "enum": [
+                "merchant",
+                "customer",
+                "demander",
+                "prospect",
+                "supplier",
+                "collaborator",
+                "arbitrator",
+                "neutral",
+                "system"
+              ]
+            },
+            "no_cache": {
+              "description": "Set true to bypass the SDK chain-read cache. In-call batching/dedup still applies.",
+              "type": "boolean"
+            },
+            "analyze": {
+              "description": "Run the registered graph Analyzer suite (R/A/O/G — risk / structural-arbitrage / opportunity / game) over the NEUTRAL viewport and return objective findings. Default true; set false for raw topology only. Findings are facts + structural suggestions, never scores — scoring stays in the game-theory modules.",
+              "type": "boolean"
+            },
+            "analyzer_kinds": {
+              "description": "Filter analyzer kinds when analyze=true (default: all four): risk=R rules, arbitrage=A structural-arbitrage, opportunity=O, game=G objective situations.",
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "risk",
+                  "arbitrage",
+                  "opportunity",
+                  "game"
+                ]
+              }
+            },
+            "only_analyzers": {
+              "description": "Run ONLY these analyzer ids (whitelist, e.g. ['R1','G2']). The full registered id list is returned in `analyzers` of every response.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "include_raw": {
+              "description": "Attach each node's full raw on-chain object as nodes[].raw. Default false — nodes then carry only kind/object_type/coin_type/state/depth, keeping the payload compact.",
+              "type": "boolean"
+            },
+            "table_edges": {
+              "description": "Dynamic-table edges to expand (channel B). Default ['machine.node'] — expands every reached Machine's workflow node table and DERIVES the wf.transition graph. Add 'permission.entity' for permission-group members (EOA/Guard + perm indices) and 'demand.presenter' for demand proposals.",
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "machine.node",
+                  "permission.entity",
+                  "demand.presenter"
+                ]
+              }
+            },
+            "budget": {
+              "description": "Optional expansion-budget overrides. Every fetch stays batched (<=50 ids/request) regardless of these caps; exhaustion is reported honestly in budget_exhausted.",
+              "type": "object",
+              "properties": {
+                "max_depth": {
+                  "description": "BFS wave depth (default 4).",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 8
+                },
+                "max_nodes": {
+                  "description": "Hard node cap (default 500).",
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 3000
+                },
+                "max_rpcs": {
+                  "description": "Hard logical RPC-batch cap; each batch carries at most 50 ids (default 120).",
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 400
+                },
+                "max_fanout": {
+                  "description": "Per-node fanout cap per edge schema (default 60).",
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5200
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "query_type"
+          ],
+          "additionalProperties": false,
+          "description": "Read-only on-chain TOPOLOGY network around ONE seed address: batched multi-hop BFS over the machine-readable EdgeSchema (never per-id RPC; objects / EOA keyed fields / tables / events use four separate batched channels). Returns nodes + typed edges (family F=field / R=reverse-index / W=workflow / M=money-flow / S=social) with per-edge retention semantics (complete / bounded_exact / membership / bounded_window / derived), the STRUCTURAL workflow subgraph of each reached Machine (incl. its structural terminal set), structural completion of every Order reached, R/A/O/G analyzer findings, and truncation / data-gap / budget honesty markers. Read-only."
         }
       ]
     },