@wowok/agent-mcp 3.0.5 → 3.1.0

package/dist/schemas/messenger_operation.output.json

@@ -284,9 +284,36 @@
                           "additionalProperties": false
                         },
                         "proof": {
-                          "description": "On-chain proof object address",
+                          "description": "Latest on-chain proof object address (projection of the last entry in proofs; derived at the read boundary for single-value consumers)",
                           "type": "string"
                         },
+                        "proofs": {
+                          "description": "All on-chain proofs anchored for this message, ascending by publish time (one-to-many; a message may be proofed multiple times)",
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "address": {
+                                "type": "string",
+                                "description": "On-chain Proof object address"
+                              },
+                              "network": {
+                                "description": "Network the proof was published on (testnet/mainnet/localnet); absent in legacy local records",
+                                "type": "string"
+                              },
+                              "createdAt": {
+                                "type": "number",
+                                "description": "Local record time (ms)"
+                              }
+                            },
+                            "required": [
+                              "address",
+                              "createdAt"
+                            ],
+                            "additionalProperties": false,
+                            "description": "One on-chain proof anchored for this message"
+                          }
+                        },
                         "decryptError": {
                           "description": "Decryption failure reason",
                           "type": "string"
@@ -349,20 +376,28 @@
               "properties": {
                 "messageId": {
                   "type": "string",
-                  "description": "Message ID"
+                  "description": "Message ID (empty on guard_authorization_required)"
                 },
                 "status": {
-                  "type": "string",
-                  "enum": [
-                    "pending",
-                    "confirmed",
-                    "read",
-                    "failed",
-                    "rejected",
-                    "decrypted",
-                    "decrypt_failed"
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "pending",
+                        "confirmed",
+                        "read",
+                        "failed",
+                        "rejected",
+                        "decrypted",
+                        "decrypt_failed"
+                      ]
+                    },
+                    {
+                      "type": "string",
+                      "const": "guard_authorization_required"
+                    }
                   ],
-                  "description": "Message status"
+                  "description": "Message status; 'guard_authorization_required' means smart send needs one-click authorization before delivery"
                 },
                 "merkleData": {
                   "description": "Merkle Tree proof data",
@@ -413,6 +448,38 @@
                 "lastReceivedLeafIndex": {
                   "description": "Last received leaf index (for message confirmation)",
                   "type": "number"
+                },
+                "authRequired": {
+                  "description": "True on the guard_authorization_required result shape — show the user ONE confirmation card, then resend via send_message with options.authorize=true",
+                  "type": "boolean"
+                },
+                "network": {
+                  "description": "Network the Passport must be created on (present on guard_authorization_required)",
+                  "type": "string",
+                  "enum": [
+                    "localnet",
+                    "testnet",
+                    "mainnet"
+                  ]
+                },
+                "reason": {
+                  "description": "Why silent passport reuse failed (present on guard_authorization_required)",
+                  "type": "string",
+                  "enum": [
+                    "no_local_passport",
+                    "local_passport_stale"
+                  ]
+                },
+                "hint": {
+                  "description": "Guidance text incl. the auto-friend hint — once the recipient replies, the sender is auto-friended and future messages need no verification",
+                  "type": "string"
+                },
+                "serverError": {
+                  "description": "Original server rejection message",
+                  "type": "string"
+                },
+                "submissions": {
+                  "description": "Guard submission requirements, when a guard demands answers before issuing a Passport (route through onchain_operations gen_passport with info)"
                 }
               },
               "required": [
@@ -441,20 +508,28 @@
               "properties": {
                 "messageId": {
                   "type": "string",
-                  "description": "Message ID"
+                  "description": "Message ID (empty on guard_authorization_required)"
                 },
                 "status": {
-                  "type": "string",
-                  "enum": [
-                    "pending",
-                    "confirmed",
-                    "read",
-                    "failed",
-                    "rejected",
-                    "decrypted",
-                    "decrypt_failed"
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "pending",
+                        "confirmed",
+                        "read",
+                        "failed",
+                        "rejected",
+                        "decrypted",
+                        "decrypt_failed"
+                      ]
+                    },
+                    {
+                      "type": "string",
+                      "const": "guard_authorization_required"
+                    }
                   ],
-                  "description": "Message status"
+                  "description": "Message status; 'guard_authorization_required' means smart send needs one-click authorization before delivery"
                 },
                 "merkleData": {
                   "description": "Merkle Tree proof data",
@@ -505,6 +580,38 @@
                 "lastReceivedLeafIndex": {
                   "description": "Last received leaf index (for message confirmation)",
                   "type": "number"
+                },
+                "authRequired": {
+                  "description": "True on the guard_authorization_required result shape — show the user ONE confirmation card, then resend via send_message with options.authorize=true",
+                  "type": "boolean"
+                },
+                "network": {
+                  "description": "Network the Passport must be created on (present on guard_authorization_required)",
+                  "type": "string",
+                  "enum": [
+                    "localnet",
+                    "testnet",
+                    "mainnet"
+                  ]
+                },
+                "reason": {
+                  "description": "Why silent passport reuse failed (present on guard_authorization_required)",
+                  "type": "string",
+                  "enum": [
+                    "no_local_passport",
+                    "local_passport_stale"
+                  ]
+                },
+                "hint": {
+                  "description": "Guidance text incl. the auto-friend hint — once the recipient replies, the sender is auto-friended and future messages need no verification",
+                  "type": "string"
+                },
+                "serverError": {
+                  "description": "Original server rejection message",
+                  "type": "string"
+                },
+                "submissions": {
+                  "description": "Guard submission requirements, when a guard demands answers before issuing a Passport (route through onchain_operations gen_passport with info)"
                 }
               },
               "required": [
@@ -533,20 +640,28 @@
               "properties": {
                 "messageId": {
                   "type": "string",
-                  "description": "Message ID"
+                  "description": "Message ID (empty on guard_authorization_required)"
                 },
                 "status": {
-                  "type": "string",
-                  "enum": [
-                    "pending",
-                    "confirmed",
-                    "read",
-                    "failed",
-                    "rejected",
-                    "decrypted",
-                    "decrypt_failed"
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "pending",
+                        "confirmed",
+                        "read",
+                        "failed",
+                        "rejected",
+                        "decrypted",
+                        "decrypt_failed"
+                      ]
+                    },
+                    {
+                      "type": "string",
+                      "const": "guard_authorization_required"
+                    }
                   ],
-                  "description": "Message status"
+                  "description": "Message status; 'guard_authorization_required' means smart send needs one-click authorization before delivery"
                 },
                 "merkleData": {
                   "description": "Merkle Tree proof data",
@@ -598,6 +713,38 @@
                   "description": "Last received leaf index (for message confirmation)",
                   "type": "number"
                 },
+                "authRequired": {
+                  "description": "True on the guard_authorization_required result shape — show the user ONE confirmation card, then resend via send_message with options.authorize=true",
+                  "type": "boolean"
+                },
+                "network": {
+                  "description": "Network the Passport must be created on (present on guard_authorization_required)",
+                  "type": "string",
+                  "enum": [
+                    "localnet",
+                    "testnet",
+                    "mainnet"
+                  ]
+                },
+                "reason": {
+                  "description": "Why silent passport reuse failed (present on guard_authorization_required)",
+                  "type": "string",
+                  "enum": [
+                    "no_local_passport",
+                    "local_passport_stale"
+                  ]
+                },
+                "hint": {
+                  "description": "Guidance text incl. the auto-friend hint — once the recipient replies, the sender is auto-friended and future messages need no verification",
+                  "type": "string"
+                },
+                "serverError": {
+                  "description": "Original server rejection message",
+                  "type": "string"
+                },
+                "submissions": {
+                  "description": "Guard submission requirements, when a guard demands answers before issuing a Passport (route through onchain_operations gen_passport with info)"
+                },
                 "sent_fields": {
                   "type": "array",
                   "items": {
@@ -872,9 +1019,36 @@
                     "additionalProperties": false
                   },
                   "proof": {
-                    "description": "On-chain proof object address",
+                    "description": "Latest on-chain proof object address (projection of the last entry in proofs; derived at the read boundary for single-value consumers)",
                     "type": "string"
                   },
+                  "proofs": {
+                    "description": "All on-chain proofs anchored for this message, ascending by publish time (one-to-many; a message may be proofed multiple times)",
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "address": {
+                          "type": "string",
+                          "description": "On-chain Proof object address"
+                        },
+                        "network": {
+                          "description": "Network the proof was published on (testnet/mainnet/localnet); absent in legacy local records",
+                          "type": "string"
+                        },
+                        "createdAt": {
+                          "type": "number",
+                          "description": "Local record time (ms)"
+                        }
+                      },
+                      "required": [
+                        "address",
+                        "createdAt"
+                      ],
+                      "additionalProperties": false,
+                      "description": "One on-chain proof anchored for this message"
+                    }
+                  },
                   "decryptError": {
                     "description": "Decryption failure reason",
                     "type": "string"
@@ -1661,7 +1835,7 @@
                   "type": "object",
                   "properties": {
                     "allowStrangerMessages": {
-                      "description": "Whether messages from strangers are allowed",
+                      "description": "Whether messages from strangers are allowed (ineffective while the guard list is non-empty)",
                       "type": "boolean"
                     },
                     "maxInboxSize": {
@@ -1992,9 +2166,36 @@
                         "additionalProperties": false
                       },
                       "proof": {
-                        "description": "On-chain proof object address",
+                        "description": "Latest on-chain proof object address (projection of the last entry in proofs; derived at the read boundary for single-value consumers)",
                         "type": "string"
                       },
+                      "proofs": {
+                        "description": "All on-chain proofs anchored for this message, ascending by publish time (one-to-many; a message may be proofed multiple times)",
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "address": {
+                              "type": "string",
+                              "description": "On-chain Proof object address"
+                            },
+                            "network": {
+                              "description": "Network the proof was published on (testnet/mainnet/localnet); absent in legacy local records",
+                              "type": "string"
+                            },
+                            "createdAt": {
+                              "type": "number",
+                              "description": "Local record time (ms)"
+                            }
+                          },
+                          "required": [
+                            "address",
+                            "createdAt"
+                          ],
+                          "additionalProperties": false,
+                          "description": "One on-chain proof anchored for this message"
+                        }
+                      },
                       "decryptError": {
                         "description": "Decryption failure reason",
                         "type": "string"
@@ -2284,9 +2485,36 @@
                               "additionalProperties": false
                             },
                             "proof": {
-                              "description": "On-chain proof object address",
+                              "description": "Latest on-chain proof object address (projection of the last entry in proofs; derived at the read boundary for single-value consumers)",
                               "type": "string"
                             },
+                            "proofs": {
+                              "description": "All on-chain proofs anchored for this message, ascending by publish time (one-to-many; a message may be proofed multiple times)",
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "address": {
+                                    "type": "string",
+                                    "description": "On-chain Proof object address"
+                                  },
+                                  "network": {
+                                    "description": "Network the proof was published on (testnet/mainnet/localnet); absent in legacy local records",
+                                    "type": "string"
+                                  },
+                                  "createdAt": {
+                                    "type": "number",
+                                    "description": "Local record time (ms)"
+                                  }
+                                },
+                                "required": [
+                                  "address",
+                                  "createdAt"
+                                ],
+                                "additionalProperties": false,
+                                "description": "One on-chain proof anchored for this message"
+                              }
+                            },
                             "decryptError": {
                               "description": "Decryption failure reason",
                               "type": "string"

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
@@ -356,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",
@@ -377,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
@@ -559,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"
@@ -1471,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": {

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",