@wowok/agent-mcp 2.5.1 → 2.5.3

package/dist/schema/query/index.js

@@ -1282,6 +1282,52 @@ export const LocalQueryResultSchema = z.union([
         result: QueryAccountResultSchema,
     }),
 ]);
+export const TxObjectChangeSchema = z.object({
+    id: z.string().describe("Object ID affected by the transaction"),
+    type: z.enum(["created", "mutated", "deleted", "wrapped", "unwrapped"]).describe("Type of object change"),
+    object_type: z.string().optional().describe("Full Move type of the object"),
+    sender: z.string().optional().describe("Sender who caused this object change"),
+    version: z.string().optional().describe("Object version after the change"),
+    previous_version: z.string().optional().describe("Previous object version (for mutations)"),
+    digest: z.string().optional().describe("Transaction digest that caused this change"),
+}).strict().describe("Object change within a transaction");
+export const TxBalanceChangeSchema = z.object({
+    owner: z.string().describe("Owner address of the balance change"),
+    coin_type: z.string().describe("Coin type (e.g. 0x2::wow::WOW)"),
+    amount: z.string().describe("Amount changed (signed string, positive=incoming, negative=outgoing)"),
+}).strict().describe("Balance change within a transaction");
+export const TransactionDetailSchema = z.object({
+    digest: z.string().describe("Transaction digest (0x...)"),
+    status: z.enum(["success", "failed"]).describe("Transaction execution status"),
+    error: z.string().optional().describe("Error message if the transaction failed"),
+    timestamp_ms: z.string().optional().describe("Unix timestamp in milliseconds (string)"),
+    sender: z.string().optional().describe("Transaction sender address"),
+    gas_used: z.string().optional().describe("Total gas used (string, BigInt)"),
+    gas_budget: z.string().optional().describe("Gas budget set by the sender (string)"),
+    kind: z.string().optional().describe("Transaction kind (e.g. ProgrammableTransaction)"),
+    object_changes: z.array(TxObjectChangeSchema).describe("Object changes (created/mutated/deleted)"),
+    balance_changes: z.array(TxBalanceChangeSchema).describe("Balance changes for all involved owners"),
+    event_count: z.number().describe("Number of events emitted by this transaction"),
+    epoch: z.string().optional().describe("Epoch number when the transaction was executed"),
+    is_system_tx: z.boolean().optional().describe("Whether this was a system transaction"),
+    cache_expire: z.union([z.number(), z.literal("INFINITE")]).optional().describe("Cache expiration timestamp"),
+}).strict().describe("Full transaction detail — verifiable proof of an on-chain operation");
+export const TransactionHistoryItemSchema = z.object({
+    digest: z.string().describe("Transaction digest"),
+    status: z.enum(["success", "failed"]).describe("Transaction execution status"),
+    timestamp_ms: z.string().optional().describe("Unix timestamp in milliseconds"),
+    sender: z.string().optional().describe("Transaction sender address"),
+    kind: z.string().optional().describe("Transaction kind"),
+    gas_used: z.string().optional().describe("Gas used (string)"),
+    objects_touched: z.array(z.string()).describe("Object IDs touched by this transaction"),
+    has_object_changes: z.boolean().describe("Whether this tx created/mutated/deleted objects"),
+}).strict().describe("Transaction history summary item");
+export const TransactionHistoryAnswerSchema = z.object({
+    transactions: z.array(TransactionHistoryItemSchema).describe("Transaction history items"),
+    next_cursor: z.union([z.string(), z.null()]).describe("Cursor for the next page (null if no more pages)"),
+    has_next_page: z.boolean().describe("Whether more pages are available"),
+    cache_expire: z.union([z.number(), z.literal("INFINITE")]).optional().describe("Cache expiration timestamp"),
+}).strict().describe("Paginated transaction history answer");
 export const OnchainQueryResultSchema_Part1 = z.union([
     z.object({
         query_type: z.literal("onchain_personal_profile"),
@@ -1342,10 +1388,25 @@ export const OnchainQueryResultSchema_Part2 = z.union([
         result: QueryReceivedResultSchema.shape.result,
     }),
 ]);
+export const OnchainQueryResultSchema_Part3 = z.union([
+    z.object({
+        query_type: z.literal("onchain_transaction"),
+        result: z.union([TransactionDetailSchema, z.undefined()]),
+    }).strict(),
+    z.object({
+        query_type: z.literal("onchain_object_history"),
+        result: z.union([TransactionHistoryAnswerSchema, z.undefined()]),
+    }).strict(),
+    z.object({
+        query_type: z.literal("onchain_address_activity"),
+        result: z.union([TransactionHistoryAnswerSchema, z.undefined()]),
+    }).strict(),
+]);
 export const AllQueryResultsSchema = z.union([
     LocalQueryResultSchema,
     OnchainQueryResultSchema_Part1,
     OnchainQueryResultSchema_Part2,
+    OnchainQueryResultSchema_Part3,
 ]);
 export const WatchQueryOperationsResultSchema = z.object({
     result: AllQueryResultsSchema,

package/dist/schemas/bridge_operation.schema.json

@@ -109,6 +109,10 @@
                 "schema_strict_mode": {
                   "type": "boolean",
                   "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+                },
+                "dry_run": {
+                  "type": "boolean",
+                  "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
                 }
               },
               "additionalProperties": false,

package/dist/schemas/guard2file.schema.json

@@ -78,6 +78,10 @@
             "schema_strict_mode": {
               "type": "boolean",
               "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+            },
+            "dry_run": {
+              "type": "boolean",
+              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
             }
           },
           "additionalProperties": false,

package/dist/schemas/index.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "WoWok MCP Schema Index",
   "description": "Index of all available JSON schemas for WoWok MCP tools",
-  "generatedAt": "2026-07-21T13:52:06.712Z",
+  "generatedAt": "2026-07-22T23:43:25.893Z",
   "tools": [
     {
       "name": "onchain_operations",

package/dist/schemas/machineNode2file.schema.json

@@ -78,6 +78,10 @@
             "schema_strict_mode": {
               "type": "boolean",
               "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+            },
+            "dry_run": {
+              "type": "boolean",
+              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
             }
           },
           "additionalProperties": false,

package/dist/schemas/onchain_operations.schema.json

@@ -1027,6 +1027,10 @@
             "schema_strict_mode": {
               "type": "boolean",
               "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+            },
+            "dry_run": {
+              "type": "boolean",
+              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
             }
           },
           "additionalProperties": false,
@@ -1186,6 +1190,10 @@
             "schema_strict_mode": {
               "type": "boolean",
               "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+            },
+            "dry_run": {
+              "type": "boolean",
+              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
             }
           },
           "additionalProperties": false,
@@ -1258,6 +1266,10 @@
         "schema_strict_mode": {
           "type": "boolean",
           "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
         }
       },
       "additionalProperties": false,
@@ -9948,6 +9960,10 @@
             "schema_strict_mode": {
               "type": "boolean",
               "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+            },
+            "dry_run": {
+              "type": "boolean",
+              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
             }
           },
           "additionalProperties": false,
@@ -10175,6 +10191,10 @@
             "schema_strict_mode": {
               "type": "boolean",
               "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+            },
+            "dry_run": {
+              "type": "boolean",
+              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
             }
           },
           "additionalProperties": false,

package/dist/schemas/onchain_operations_allocation.schema.json

@@ -418,6 +418,10 @@
         "schema_strict_mode": {
           "type": "boolean",
           "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_arbitration.schema.json

@@ -673,6 +673,10 @@
         "schema_strict_mode": {
           "type": "boolean",
           "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_contact.schema.json

@@ -360,6 +360,10 @@
         "schema_strict_mode": {
           "type": "boolean",
           "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_demand.schema.json

@@ -491,6 +491,10 @@
         "schema_strict_mode": {
           "type": "boolean",
           "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_gen_passport.schema.json

@@ -588,6 +588,10 @@
         "schema_strict_mode": {
           "type": "boolean",
           "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
         }
       },
       "additionalProperties": false,
@@ -1183,6 +1187,10 @@
             "schema_strict_mode": {
               "type": "boolean",
               "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+            },
+            "dry_run": {
+              "type": "boolean",
+              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
             }
           },
           "additionalProperties": false,

package/dist/schemas/onchain_operations_gen_proof.schema.json

@@ -121,6 +121,10 @@
         "schema_strict_mode": {
           "type": "boolean",
           "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
         }
       },
       "additionalProperties": false,
@@ -253,6 +257,10 @@
             "schema_strict_mode": {
               "type": "boolean",
               "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+            },
+            "dry_run": {
+              "type": "boolean",
+              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
             }
           },
           "additionalProperties": false,