@wowok/agent-mcp 2.6.8 → 2.6.9

package/dist/schema/query/index.js

@@ -1369,6 +1369,29 @@ export const BridgeTokenInfoSchema = z.object({
     evmChains: z.array(z.number()).optional().describe('Bridge protocol chain IDs where this token is available (e.g. 10 = ETH mainnet)'),
     description: z.string().optional().describe('Token description'),
 }).describe('Mainnet Bridge token info');
+export const FundingGuidanceSchema = z.object({
+    overview: z.string().describe('Overview of how to obtain WOW gas and payment tokens'),
+    testnet: z.object({
+        token: z.string().describe('Testnet token (WOW)'),
+        method: z.literal('faucet').describe('Testnet funding method (faucet)'),
+        faucet_url: z.string().describe('Testnet faucet URL'),
+        note: z.string().describe('Testnet funding note: all merchant/order testing can use WOW'),
+    }),
+    mainnet: z.object({
+        method: z.literal('eth_bridge').describe('Mainnet funding method (ETH mainnet cross-chain bridge)'),
+        supported_tokens: z.array(z.string()).describe('Tokens supported by the mainnet bridge (ETH/USDT/USDC/WBTC)'),
+        steps: z.array(z.string()).describe('Step-by-step mainnet funding flow: query active EVM account → transfer from external wallet → confirm balance → cross-chain to WOW'),
+    }),
+    airdrop: z.object({
+        url: z.string().describe('WOW mainnet airdrop URL'),
+        status: z.string().describe('Airdrop status (under construction)'),
+    }),
+    payment_token: z.object({
+        testnet_default: z.string().describe('Default testnet payment token (WOW)'),
+        mainnet_option: z.string().describe('Mainnet payment token option (USDT and other stablecoins)'),
+        migration_note: z.string().describe('Guidance: ask whether to switch payment token when migrating testnet → mainnet'),
+    }),
+}).describe('Funding guidance — how to obtain WOW gas and payment tokens (testnet faucet / mainnet bridge / airdrop). This is the first-step guidance for new users.');
 export const ProtocolInfoQuerySchema = z.discriminatedUnion('info', [
     z.object({
         info: z.literal('constants')
@@ -1393,7 +1416,10 @@ export const ProtocolInfoQuerySchema = z.discriminatedUnion('info', [
     }).strict().describe('Value types query - returns all supported value types with their numeric and string representations'),
     z.object({
         info: z.literal('mainnet bridge tokens')
-    }).strict().describe('Mainnet Bridge tokens query - returns all tokens deployed on the mainnet bridge with their symbol, WOW-side type tag, EVM address, decimals, and description')
+    }).strict().describe('Mainnet Bridge tokens query - returns all tokens deployed on the mainnet bridge with their symbol, WOW-side type tag, EVM address, decimals, and description'),
+    z.object({
+        info: z.literal('funding guidance')
+    }).strict().describe('Funding guidance query - how to obtain WOW gas and payment tokens. Returns testnet faucet info, mainnet ETH cross-chain bridge flow, and the WOW mainnet airdrop link. Use this when a user asks how to obtain tokens/gas/funds, or as a proactive first-use reminder.')
 ]).describe('WoWok Build-in infomation query');
 export const BuiltinPermissionSchema = z.object({
     result: z.array(PermissionInfoTypeSchema).describe('Built-in permissions result')
@@ -1426,6 +1452,10 @@ export const ProtocolInfoResultWrappedSchema = z.discriminatedUnion('info', [
     z.object({
         info: z.literal('mainnet bridge tokens'),
         result: z.array(BridgeTokenInfoSchema).describe('Mainnet Bridge tokens result - each item contains tokenId, symbol, wowTypeTag, evmAddress, evmDecimals, wowDecimals, evmChains, and description')
+    }),
+    z.object({
+        info: z.literal('funding guidance'),
+        result: FundingGuidanceSchema.describe('Funding guidance result - testnet faucet / mainnet bridge / airdrop / payment-token guidance')
     })
 ]).describe('Protocol info result');
 export const ProtocolInfoResultSchema = z.object({
@@ -1467,6 +1497,14 @@ export const TxBalanceChangeSchema = z.object({
     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 TxEventSchema = z.object({
+    type: z.string().describe("Fully-qualified event type (e.g. 0x2::progress::ProgressEvent)"),
+    package_id: z.string().optional().describe("Package that declared the event module"),
+    module: z.string().optional().describe("Module name that emitted the event"),
+    sender: z.string().optional().describe("Sender of the emitting transaction"),
+    parsed_json: z.unknown().optional().describe("Parsed JSON payload of the event (Move struct fields)"),
+    bcs: z.string().optional().describe("Raw BCS bytes of the event (base64)"),
+}).strict().describe("Event emitted by a transaction");
 export const TransactionDetailSchema = z.object({
     digest: z.string().describe("Transaction digest (0x...)"),
     status: z.enum(["success", "failed"]).describe("Transaction execution status"),
@@ -1479,6 +1517,9 @@ export const TransactionDetailSchema = z.object({
     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"),
+    events: z.array(TxEventSchema).describe("Events emitted by the transaction. Always populated by query_transaction (showEvents=true). " +
+        "Each event carries its Move struct payload (parsed_json) so callers can inspect " +
+        "ProgressEvent, NewOrderEvent, ArbEvent, etc. without an extra query."),
     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"),

package/dist/schema/sync-layer4.js

@@ -22,6 +22,7 @@ export const TOOLS_17 = [
     'trust_score',
 ];
 const JSON_SCHEMA_DRAFT7 = 'http://json-schema.org/draft-07/schema#';
+const RECURSIVE_EXTERNAL_FILES = new Set(['guard-node-schema.json']);
 function createExternalFileCache() {
     return new Map();
 }
@@ -70,18 +71,37 @@ function resolveRefTarget(ref, root, layer3Dir, cache) {
     }
     return target;
 }
-function resolveRefs(node, root, layer3Dir, cache, seen = new Set()) {
+function resolveRefs(node, root, layer3Dir, cache, seen = new Set(), memo = new Map()) {
     if (node === null || typeof node !== 'object') {
         return node;
     }
     if (Array.isArray(node)) {
-        return node.map((item) => resolveRefs(item, root, layer3Dir, cache, seen));
+        return node.map((item) => resolveRefs(item, root, layer3Dir, cache, seen, memo));
     }
     if (typeof node.$ref === 'string') {
         const ref = node.$ref;
+        if (!ref.startsWith('#') && RECURSIVE_EXTERNAL_FILES.has(ref.split('#', 2)[0])) {
+            return {
+                type: 'object',
+                additionalProperties: true,
+                description: 'Recursive GuardNode computational tree (55 self-referential node types). ' +
+                    'NOT inlined here to avoid exponential schema bloat. ' +
+                    "Use schema_query (e.g. action='get' name='onchain_operations_guard') or read guard-node-schema.json " +
+                    'for the complete node definitions. Key node families: identifier / query / context / ' +
+                    'logic_* / calc_* / convert_* / vec_* / query_progress_* / query_reward_*.',
+            };
+        }
         if (seen.has(ref)) {
             return { $ref: ref, description: node.description };
         }
+        if (memo.has(ref)) {
+            const cached = memo.get(ref);
+            const copy = JSON.parse(JSON.stringify(cached));
+            if (node.description && !copy.description) {
+                copy.description = node.description;
+            }
+            return copy;
+        }
         const target = resolveRefTarget(ref, root, layer3Dir, cache);
         if (target === undefined || target === null) {
             throw new Error(`Cannot resolve $ref target: ${ref}`);
@@ -91,15 +111,16 @@ function resolveRefs(node, root, layer3Dir, cache, seen = new Set()) {
         const externalRoot = ref.startsWith('#')
             ? root
             : loadExternalFile(ref.split('#', 2)[0], layer3Dir, cache);
-        const resolved = resolveRefs(target, externalRoot, layer3Dir, cache, nextSeen);
+        const resolved = resolveRefs(target, externalRoot, layer3Dir, cache, nextSeen, memo);
         if (node.description && !resolved.description) {
             resolved.description = node.description;
         }
+        memo.set(ref, resolved);
         return resolved;
     }
     const result = {};
     for (const [key, value] of Object.entries(node)) {
-        result[key] = resolveRefs(value, root, layer3Dir, cache, seen);
+        result[key] = resolveRefs(value, root, layer3Dir, cache, seen, memo);
     }
     return result;
 }

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-08-10T12:46:37.677Z",
+  "generatedAt": "2026-08-15T01:29:23.265Z",
   "tools": [
     {
       "name": "onchain_operations",

package/dist/schemas/onchain_operations.schema.json

@@ -1988,7 +1988,7 @@
             },
             "order_required_info": {
               "type": "string",
-              "description": "Contact object ID or WTS Proof object"
+              "description": "Contact object ID or WTS Proof object, recorded on the Order as proof that the order holder delivered the required private information (service.customer_required) to the merchant. FLOW: when a Service declares customer_required (e.g. phone/email/shipping_address), the order holder MUST send that private information to the Service's Contact (um) via end-to-end encrypted Messenger, then pass the Contact object ID or the generated WTS Proof here so the delivery is verifiable on-chain."
             },
             "transfer": {
               "$ref": "#/definitions/data_service/properties/order_new/properties/agents/properties/entities/items",
@@ -2339,7 +2339,7 @@
             "type": "string",
             "minLength": 1
           },
-          "description": "Customer required information. Such as phone, email, etc."
+          "description": "Customer required information labels. Such as phone, email, shipping_address, etc. ⚠️ HARD LINKAGE (SDK-enforced): if customer_required is set (non-empty), the Service MUST also bind a Contact via `um` — otherwise the customer's private information cannot be delivered through end-to-end encrypted Messenger (which routes to the Contact bound as um). Set `um` together with customer_required."
         },
         "order_allocators": {
           "anyOf": [
@@ -2681,7 +2681,7 @@
               "type": "null"
             }
           ],
-          "description": "Contact object ID or name."
+          "description": "Contact object ID or name — the Service's customer-service channel. This is the object that Messenger routes encrypted messages to for pre-order negotiation, private-info delivery (see customer_required), and post-sale support. ⚠️ REQUIRED whenever customer_required is set: without um, the customer's private information has no channel to reach the merchant."
         },
         "pause": {
           "type": "boolean",
@@ -6929,7 +6929,7 @@
             },
             "alloc_by_guard": {
               "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/allocators/items/properties/sharing/items/properties/who/anyOf/1/properties/Entity/properties/name_or_address",
-              "description": "Verify the specified Guard and execute the corresponding fund allocation. POST-ALLOCATION CLAIM (required step): each recipient receives a CoinWrapper object (NOT spendable coins). Recipient address resolution (allocation.move): Entity recipients receive it at the Entity's address; Signer recipients receive it at the transaction sender's address; GuardIdentifier n recipients receive it at the ADDRESS SUBMITTED for identifier n in this call's submission (resolved via passport::submission_get) — conventionally the Order OBJECT address (escrow pattern), in which case the order owner claims it via operation_type='order' {object:'<order_id>', receive:'recently'}. Claim paths by holder: EOA wallet → operation_type='payment' RECEIVE mode {object:'<coinwrapper_id>', receive:true, type_parameter:'0x2::wow::WOW'}; Order object → order receive; Treasury object → treasury receive. Find pending CoinWrappers via query_toolkit query_type='onchain_received'. Verify the distribution via the immutable Payment object created by this call (allocation.payment array)."
+              "description": "Verify the specified Guard and execute the corresponding fund allocation. POST-ALLOCATION CLAIM (required step): each recipient receives a CoinWrapper object (NOT spendable coins). Recipient address resolution (allocation.move): Entity recipients receive it at the Entity's address; Signer recipients receive it at the transaction sender's address; GuardIdentifier n recipients receive it at the ADDRESS SUBMITTED for identifier n in this call's submission (resolved via passport::submission_get) — conventionally the Order OBJECT address (escrow pattern), in which case the order owner claims it via operation_type='order' {object:'<order_id>', receive:'recently'}. Claim paths by holder: EOA wallet → operation_type='payment' RECEIVE mode {object:'<coinwrapper_id>', receive:true} (type_parameter optional, auto-derived from the CoinWrapper type); Order object → order receive; Treasury object → treasury receive. Find pending CoinWrappers via query_toolkit query_type='onchain_received'. Verify the distribution via the immutable Payment object created by this call (allocation.payment array)."
             }
           },
           "required": [
@@ -8938,19 +8938,18 @@
             },
             "type_parameter": {
               "type": "string",
-              "description": "Coin type of the CoinWrapper, e.g. '0x2::wow::WOW'. Must match the type used when the Allocation created the Payment."
+              "description": "Coin type of the CoinWrapper, e.g. '0x2::wow::WOW'. OPTIONAL: when omitted it is auto-derived from the CoinWrapper's own on-chain type (the inner T of `CoinWrapper<T>`), so {object, receive:true} alone unwraps to spendable coins. Only provide it explicitly when auto-derivation fails."
             }
           },
           "required": [
             "object",
-            "receive",
-            "type_parameter"
+            "receive"
           ],
           "additionalProperties": false,
           "description": "Receive mode: unwrap a CoinWrapper to the caller's wallet. Use after Allocation's alloc_by_guard creates a Payment with your address as a revenue recipient. The CoinWrapper holds your share — call this to convert it to actual coins in your wallet."
         }
       ],
-      "description": "On-chain Payment operations. TWO modes:\n(1) CREATE: Set 'object' with {name, type_parameter, ...}, 'revenue', and 'info' to create a new Payment.\n(2) RECEIVE: Set {object: '<coinwrapper_id_or_name>', receive: true, type_parameter: '0x2::wow::WOW'} to unwrap a CoinWrapper to your wallet.\nThe 'object' field is CRITICAL and REQUIRED in both modes. STRING for receive (CoinWrapper ID/name), OBJECT for create."
+      "description": "On-chain Payment operations. TWO modes:\n(1) CREATE: Set 'object' with {name, type_parameter, ...}, 'revenue', and 'info' to create a new Payment.\n(2) RECEIVE: Set {object: '<coinwrapper_id_or_name>', receive: true} to unwrap a CoinWrapper to your wallet (type_parameter optional — auto-derived from the CoinWrapper's type).\nThe 'object' field is CRITICAL and REQUIRED in both modes. STRING for receive (CoinWrapper ID/name), OBJECT for create."
     },
     "data_demand": {
       "type": "object",

package/dist/schemas/onchain_operations_allocation.schema.json

@@ -361,7 +361,7 @@
             },
             "alloc_by_guard": {
               "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/allocators/items/properties/sharing/items/properties/who/anyOf/1/properties/Entity/properties/name_or_address",
-              "description": "Verify the specified Guard and execute the corresponding fund allocation. POST-ALLOCATION CLAIM (required step): each recipient receives a CoinWrapper object (NOT spendable coins). Recipient address resolution (allocation.move): Entity recipients receive it at the Entity's address; Signer recipients receive it at the transaction sender's address; GuardIdentifier n recipients receive it at the ADDRESS SUBMITTED for identifier n in this call's submission (resolved via passport::submission_get) — conventionally the Order OBJECT address (escrow pattern), in which case the order owner claims it via operation_type='order' {object:'<order_id>', receive:'recently'}. Claim paths by holder: EOA wallet → operation_type='payment' RECEIVE mode {object:'<coinwrapper_id>', receive:true, type_parameter:'0x2::wow::WOW'}; Order object → order receive; Treasury object → treasury receive. Find pending CoinWrappers via query_toolkit query_type='onchain_received'. Verify the distribution via the immutable Payment object created by this call (allocation.payment array)."
+              "description": "Verify the specified Guard and execute the corresponding fund allocation. POST-ALLOCATION CLAIM (required step): each recipient receives a CoinWrapper object (NOT spendable coins). Recipient address resolution (allocation.move): Entity recipients receive it at the Entity's address; Signer recipients receive it at the transaction sender's address; GuardIdentifier n recipients receive it at the ADDRESS SUBMITTED for identifier n in this call's submission (resolved via passport::submission_get) — conventionally the Order OBJECT address (escrow pattern), in which case the order owner claims it via operation_type='order' {object:'<order_id>', receive:'recently'}. Claim paths by holder: EOA wallet → operation_type='payment' RECEIVE mode {object:'<coinwrapper_id>', receive:true} (type_parameter optional, auto-derived from the CoinWrapper type); Order object → order receive; Treasury object → treasury receive. Find pending CoinWrappers via query_toolkit query_type='onchain_received'. Verify the distribution via the immutable Payment object created by this call (allocation.payment array)."
             }
           },
           "required": [

package/dist/schemas/onchain_operations_payment.schema.json

@@ -182,19 +182,18 @@
             },
             "type_parameter": {
               "type": "string",
-              "description": "Coin type of the CoinWrapper, e.g. '0x2::wow::WOW'. Must match the type used when the Allocation created the Payment."
+              "description": "Coin type of the CoinWrapper, e.g. '0x2::wow::WOW'. OPTIONAL: when omitted it is auto-derived from the CoinWrapper's own on-chain type (the inner T of `CoinWrapper<T>`), so {object, receive:true} alone unwraps to spendable coins. Only provide it explicitly when auto-derivation fails."
             }
           },
           "required": [
             "object",
-            "receive",
-            "type_parameter"
+            "receive"
           ],
           "additionalProperties": false,
           "description": "Receive mode: unwrap a CoinWrapper to the caller's wallet. Use after Allocation's alloc_by_guard creates a Payment with your address as a revenue recipient. The CoinWrapper holds your share — call this to convert it to actual coins in your wallet."
         }
       ],
-      "description": "On-chain Payment operations. TWO modes:\n(1) CREATE: Set 'object' with {name, type_parameter, ...}, 'revenue', and 'info' to create a new Payment.\n(2) RECEIVE: Set {object: '<coinwrapper_id_or_name>', receive: true, type_parameter: '0x2::wow::WOW'} to unwrap a CoinWrapper to your wallet.\nThe 'object' field is CRITICAL and REQUIRED in both modes. STRING for receive (CoinWrapper ID/name), OBJECT for create."
+      "description": "On-chain Payment operations. TWO modes:\n(1) CREATE: Set 'object' with {name, type_parameter, ...}, 'revenue', and 'info' to create a new Payment.\n(2) RECEIVE: Set {object: '<coinwrapper_id_or_name>', receive: true} to unwrap a CoinWrapper to your wallet (type_parameter optional — auto-derived from the CoinWrapper's type).\nThe 'object' field is CRITICAL and REQUIRED in both modes. STRING for receive (CoinWrapper ID/name), OBJECT for create."
     },
     "env": {
       "type": "object",

package/dist/schemas/onchain_operations_service.schema.json

@@ -225,7 +225,7 @@
             },
             "order_required_info": {
               "type": "string",
-              "description": "Contact object ID or WTS Proof object"
+              "description": "Contact object ID or WTS Proof object, recorded on the Order as proof that the order holder delivered the required private information (service.customer_required) to the merchant. FLOW: when a Service declares customer_required (e.g. phone/email/shipping_address), the order holder MUST send that private information to the Service's Contact (um) via end-to-end encrypted Messenger, then pass the Contact object ID or the generated WTS Proof here so the delivery is verifiable on-chain."
             },
             "transfer": {
               "$ref": "#/definitions/data/properties/order_new/properties/agents/properties/entities/items",
@@ -576,7 +576,7 @@
             "type": "string",
             "minLength": 1
           },
-          "description": "Customer required information. Such as phone, email, etc."
+          "description": "Customer required information labels. Such as phone, email, shipping_address, etc. ⚠️ HARD LINKAGE (SDK-enforced): if customer_required is set (non-empty), the Service MUST also bind a Contact via `um` — otherwise the customer's private information cannot be delivered through end-to-end encrypted Messenger (which routes to the Contact bound as um). Set `um` together with customer_required."
         },
         "order_allocators": {
           "anyOf": [
@@ -918,7 +918,7 @@
               "type": "null"
             }
           ],
-          "description": "Contact object ID or name."
+          "description": "Contact object ID or name — the Service's customer-service channel. This is the object that Messenger routes encrypted messages to for pre-order negotiation, private-info delivery (see customer_required), and post-sale support. ⚠️ REQUIRED whenever customer_required is set: without um, the customer's private information has no channel to reach the merchant."
         },
         "pause": {
           "type": "boolean",

package/dist/schemas/project_operation.output.json

@@ -1878,6 +1878,49 @@
                   "additionalProperties": {},
                   "description": "Operation history extracted from object states — NOT from tx queries. Progress objects: session.forwards (who did what, when, accomplished). Order objects: disputes, claimed_by, progress_object. This is the CORRECT history source: convergent, no infinite recursion."
                 },
+                "dependencies": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "object": {
+                        "type": "string",
+                        "description": "Discovered dependency object ID (0x...)."
+                      },
+                      "depth": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "description": "BFS depth at which this dependency was discovered (1 = direct reference from a center object)."
+                      },
+                      "via_field": {
+                        "type": "string",
+                        "description": "Field name on the parent object that references this dependency (e.g. 'permission', 'machine', 'guard'). Matches extractAddressFields output."
+                      },
+                      "via_type": {
+                        "type": "string",
+                        "description": "Semantic edge type: 'bind' | 'validate' | 'consume' | 'trigger' | 'create'."
+                      },
+                      "parent": {
+                        "type": "string",
+                        "description": "Object ID of the parent that referenced this dependency."
+                      }
+                    },
+                    "required": [
+                      "object",
+                      "depth",
+                      "via_field",
+                      "via_type",
+                      "parent"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Dependency edges discovered via BFS expansion (only when context_depth > 0). Each entry describes one outbound reference (parent → child) with the field name and semantic edge type. Use with dependency_objects to get the full states. Cycles are deduplicated — each object ID appears at most once at its shallowest depth."
+                },
+                "dependency_objects": {
+                  "type": "array",
+                  "items": {},
+                  "description": "Full on-chain states of the discovered dependency objects (only when context_depth > 0). Order matches `dependencies` when possible; safe to consume as an unordered set. Center objects are NOT repeated here — they live in `objects`."
+                },
                 "semantic_summary": {
                   "description": "Business semantic annotations generated by buildDataSemantic — maps raw object fields to business-meaningful concepts for LLM consumption."
                 },
@@ -3740,6 +3783,41 @@
                   "type": "string",
                   "description": "Explains that testnet/mainnet are different projects with different addresses for same names."
                 },
+                "payment_token_decision": {
+                  "type": "object",
+                  "properties": {
+                    "round": {
+                      "type": "string",
+                      "description": "Decision round identifier (e.g. 'M1')."
+                    },
+                    "question": {
+                      "type": "string",
+                      "description": "Question asking whether to keep WOW or switch to a stablecoin when migrating testnet → mainnet."
+                    },
+                    "options": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Available choices (e.g. Keep WOW / Switch to USDT / Switch to USDC / Other stablecoin)."
+                    },
+                    "default": {
+                      "type": "string",
+                      "description": "Recommended default choice (Keep WOW)."
+                    },
+                    "note": {
+                      "type": "string",
+                      "description": "Guidance: mainnet stablecoins are available via the ETH mainnet cross-chain bridge; if switching, update Service/Treasury/Allocation type_parameter before publishing."
+                    }
+                  },
+                  "required": [
+                    "round",
+                    "question",
+                    "options"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Payment-token migration decision. testnet recommends WOW; mainnet supports USDT and other stablecoins via the ETH mainnet bridge. Must be resolved BEFORE step 2 (on-chain deployment) because the Service/Treasury/Allocation type_parameter determines the payment token."
+                },
                 "migration_plan": {
                   "type": "array",
                   "items": {
@@ -3838,6 +3916,7 @@
                 "source_project",
                 "target_project",
                 "key_principle",
+                "payment_token_decision",
                 "migration_plan",
                 "summary"
               ],

package/dist/schemas/project_operation.schema.json

@@ -86,6 +86,19 @@
           ],
           "description": "Network for assemble_context queries. Defaults to 'testnet' if omitted."
         },
+        "context_depth": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 5,
+          "description": "BFS recursion depth for dependency expansion in assemble_context (default 0 = no expansion). When >0, the assembly recursively queries objects referenced by the center objects (permission, guard, machine, service, repositories, etc.) up to the given depth, using the same address-field extraction rules as build_graph (Pathway 1). Each level issues one batched query_objects call (≤50 IDs per batch). Cycles are detected and skipped via a visited set. Discovered dependencies are returned in `dependencies` (edge metadata) and `dependency_objects` (full object states). Recommended: 1–2 for most use cases; 3+ may pull large subgraphs (use context_include to constrain)."
+        },
+        "context_include": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Optional filter for dependency expansion edge types. When omitted, ALL outbound references are followed. When provided, only edges whose `field` matches one of the listed names are followed. Recognized field names (from extractAddressFields): 'permission', 'machine', 'service', 'progress', 'buy_guard', 'um', 'repositories', 'arbitrations', 'rewards', 'consensus_repositories', 'context_repositories', 'dispute', 'allocation', 'external_deposit_guard', 'external_withdraw_guard', 'allocator_guard', 'for_object', 'for_guard', 'payment', 'voting_guard', 'usage_guard', 'guard', 'write_guard', 'quote_guard', 'recipient_entity', 'order_allocators'. Example: ['permission','guard'] expands only permission/guard dependencies."
+        },
         "filter_status": {
           "type": "string",
           "enum": [

package/dist/schemas/query_toolkit.output.json

@@ -14396,6 +14396,43 @@
               "type": "number",
               "description": "Number of events emitted by this transaction"
             },
+            "events": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "description": "Fully-qualified event type (e.g. 0x2::progress::ProgressEvent)"
+                  },
+                  "package_id": {
+                    "type": "string",
+                    "description": "Package that declared the event module"
+                  },
+                  "module": {
+                    "type": "string",
+                    "description": "Module name that emitted the event"
+                  },
+                  "sender": {
+                    "type": "string",
+                    "description": "Sender of the emitting transaction"
+                  },
+                  "parsed_json": {
+                    "description": "Parsed JSON payload of the event (Move struct fields)"
+                  },
+                  "bcs": {
+                    "type": "string",
+                    "description": "Raw BCS bytes of the event (base64)"
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": false,
+                "description": "Event emitted by a transaction"
+              },
+              "description": "Events emitted by the transaction. Always populated by query_transaction (showEvents=true). Each event carries its Move struct payload (parsed_json) so callers can inspect ProgressEvent, NewOrderEvent, ArbEvent, etc. without an extra query."
+            },
             "epoch": {
               "type": "string",
               "description": "Epoch number when the transaction was executed"
@@ -14422,7 +14459,8 @@
             "status",
             "object_changes",
             "balance_changes",
-            "event_count"
+            "event_count",
+            "events"
           ],
           "additionalProperties": false,
           "description": "Full transaction detail — verifiable proof of an on-chain operation"

package/dist/schemas/wowok_buildin_info.output.json

@@ -703,6 +703,138 @@
                 "result"
               ],
               "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "info": {
+                  "type": "string",
+                  "const": "funding guidance"
+                },
+                "result": {
+                  "type": "object",
+                  "properties": {
+                    "overview": {
+                      "type": "string",
+                      "description": "Overview of how to obtain WOW gas and payment tokens"
+                    },
+                    "testnet": {
+                      "type": "object",
+                      "properties": {
+                        "token": {
+                          "type": "string",
+                          "description": "Testnet token (WOW)"
+                        },
+                        "method": {
+                          "type": "string",
+                          "const": "faucet",
+                          "description": "Testnet funding method (faucet)"
+                        },
+                        "faucet_url": {
+                          "type": "string",
+                          "description": "Testnet faucet URL"
+                        },
+                        "note": {
+                          "type": "string",
+                          "description": "Testnet funding note: all merchant/order testing can use WOW"
+                        }
+                      },
+                      "required": [
+                        "token",
+                        "method",
+                        "faucet_url",
+                        "note"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "mainnet": {
+                      "type": "object",
+                      "properties": {
+                        "method": {
+                          "type": "string",
+                          "const": "eth_bridge",
+                          "description": "Mainnet funding method (ETH mainnet cross-chain bridge)"
+                        },
+                        "supported_tokens": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          },
+                          "description": "Tokens supported by the mainnet bridge (ETH/USDT/USDC/WBTC)"
+                        },
+                        "steps": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          },
+                          "description": "Step-by-step mainnet funding flow: query active EVM account → transfer from external wallet → confirm balance → cross-chain to WOW"
+                        }
+                      },
+                      "required": [
+                        "method",
+                        "supported_tokens",
+                        "steps"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "airdrop": {
+                      "type": "object",
+                      "properties": {
+                        "url": {
+                          "type": "string",
+                          "description": "WOW mainnet airdrop URL"
+                        },
+                        "status": {
+                          "type": "string",
+                          "description": "Airdrop status (under construction)"
+                        }
+                      },
+                      "required": [
+                        "url",
+                        "status"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "payment_token": {
+                      "type": "object",
+                      "properties": {
+                        "testnet_default": {
+                          "type": "string",
+                          "description": "Default testnet payment token (WOW)"
+                        },
+                        "mainnet_option": {
+                          "type": "string",
+                          "description": "Mainnet payment token option (USDT and other stablecoins)"
+                        },
+                        "migration_note": {
+                          "type": "string",
+                          "description": "Guidance: ask whether to switch payment token when migrating testnet → mainnet"
+                        }
+                      },
+                      "required": [
+                        "testnet_default",
+                        "mainnet_option",
+                        "migration_note"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "overview",
+                    "testnet",
+                    "mainnet",
+                    "airdrop",
+                    "payment_token"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Funding guidance result - testnet faucet / mainnet bridge / airdrop / payment-token guidance"
+                }
+              },
+              "required": [
+                "info",
+                "result"
+              ],
+              "additionalProperties": false
             }
           ],
           "description": "Protocol info result"

package/dist/schemas/wowok_buildin_info.schema.json

@@ -537,6 +537,20 @@
           ],
           "additionalProperties": false,
           "description": "Mainnet Bridge tokens query - returns all tokens deployed on the mainnet bridge with their symbol, WOW-side type tag, EVM address, decimals, and description"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "info": {
+              "type": "string",
+              "const": "funding guidance"
+            }
+          },
+          "required": [
+            "info"
+          ],
+          "additionalProperties": false,
+          "description": "Funding guidance query - how to obtain WOW gas and payment tokens. Returns testnet faucet info, mainnet ETH cross-chain bridge flow, and the WOW mainnet airdrop link. Use this when a user asks how to obtain tokens/gas/funds, or as a proactive first-use reminder."
         }
       ],
       "description": "WoWok Build-in infomation query"