@wowok/agent-mcp 3.0.4 → 3.0.6

package/dist/schemas/query_toolkit.schema.json

@@ -248,7 +248,7 @@
           "const": "account_balance"
         },
         "name_or_address": {
-          "description": "Account name or address to query. Examples: \"my_account\", \"0xabc123...\", or \"\" for the default account. NOTE: This field is NOT named 'filter' — use 'name_or_address' directly. Defaults to '' (default account) if omitted.",
+          "description": "Account name or address to query. Examples: \"my_account\", \"0xabc123...\", or \"\" for the default account. Aliases 'account' and 'address' are accepted and auto-renamed to 'name_or_address'. Defaults to '' (default account) if omitted.",
           "type": "string"
         },
         "balance": {
@@ -289,20 +289,20 @@
           "type": "string"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
         "query_type"
       ],
       "additionalProperties": false,
-      "description": "Query an account's coin balance OR paginated coin objects. LIVE QUERY: the balance is always fetched fresh from the fullnode — there is NO cache, so 'no_cache' is not needed and not accepted on this query type. PARAMETERS: Use 'name_or_address' to specify the account (NOT 'filter'). Use balance=true for total amount, or coin={cursor,limit} to list individual coin objects. Use token_type to query non-default tokens (format: 0x<package>::<module>::<struct>). If the input resolves to an ON-CHAIN OBJECT (e.g. a Treasury name), the result auto-routes: it returns the object with its 'balance' field plus a routing hint. Returns: { address, balance? | coin? | object?, hint? }"
+      "description": "Query an account's coin balance OR paginated coin objects. LIVE QUERY: the balance is always fetched fresh from the fullnode — there is NO cache, so 'no_cache' is not needed and not accepted on this query type. PARAMETERS: Use 'name_or_address' to specify the account. Use balance=true for total amount, or coin={cursor,limit} to list individual coin objects. Use token_type to query non-default tokens (format: 0x<package>::<module>::<struct>). If the input resolves to an ON-CHAIN OBJECT (e.g. a Treasury name), the result auto-routes: it returns the object with its 'balance' field plus a routing hint. Returns: { address, balance? | coin? | object?, hint? }"
     },
     {
       "type": "object",
@@ -334,7 +334,7 @@
           "const": "onchain_personal_profile"
         },
         "account": {
-          "description": "Account name or ID to query. Use empty string '' for the default account.",
+          "description": "Account name or ID to query. Use empty string '' for the default account. Aliases 'name_or_address' and 'address' are accepted and auto-renamed to 'account'.",
           "type": "string"
         },
         "no_cache": {
@@ -342,13 +342,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -377,13 +377,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -465,13 +465,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -497,13 +497,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -513,6 +513,34 @@
       "additionalProperties": false,
       "description": "Verify what a specific transaction did on-chain — the 'OperationProof' primitive. After executing any operation, call this with the returned digest to confirm: status (success/failed), object changes (created/mutated/deleted), balance changes, gas used, and events. Essential for the 5-step loop's Verify step. Returns: TransactionDetail | undefined"
     },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "onchain_block"
+        },
+        "block": {
+          "type": "string",
+          "description": "Checkpoint sequence number (e.g. \"12345\") or checkpoint digest. A checkpoint (block) is the chain's unit of finalization — use it to answer 'what happened at block N', look up block time/transaction count, or place a transaction in the global order (checkpoint sequences appear in onchain_transaction/onchain_object_history results)."
+        },
+        "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ]
+        }
+      },
+      "required": [
+        "query_type",
+        "block"
+      ],
+      "additionalProperties": false,
+      "description": "Query ONE checkpoint (block) by sequence number or digest — returns the RAW fullnode checkpoint summary VERBATIM (no semantic shaping): sequence, digest, timestampMs, transaction count, epoch bindings, networkTransactions, endOfEpoch data when present. Checkpoints are immutable, so the value is authoritative forever. Distinct from onchain_transaction (per-tx proof) — use this for block-level facts. Returns: raw checkpoint summary object | undefined"
+    },
     {
       "type": "object",
       "properties": {
@@ -522,7 +550,7 @@
         },
         "object": {
           "type": "string",
-          "description": "Object ID (0x...) or LocalMark name. Query the provenance chain — every transaction that created, mutated, or deleted this object. Use to trace how an object reached its current state."
+          "description": "Object ID (0x...) or LocalMark name. Query the provenance chain — every transaction that created, mutated, unwrapped, or deleted this object (plus transactions that consumed it as an input). The CREATING/arrival transaction IS included (ChangedObject ∪ InputObject indexes are merged), so freshly received coins and never-used objects no longer return an empty history. Use to trace how an object reached its current state."
         },
         "cursor": {
           "description": "Pagination cursor from previous page's next_cursor",
@@ -564,13 +592,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -600,13 +628,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -614,7 +642,7 @@
         "objects"
       ],
       "additionalProperties": false,
-      "description": "Batch query the LAST on-chain update time of objects — the timestamp of the most recent transaction that touched each object (SDK query_object_last_updated, cached TTL 2 min). Use for 'updated' stamps on list items. Returns: { items: [{ object, timestamp_ms, digest, sender }] }"
+      "description": "Batch query the LAST on-chain WRITE time of objects — the timestamp of the most recent transaction that touched each object (SDK query_object_last_updated, cached TTL 2 min). WARNING: this is a LAST-MODIFIED stamp, NOT the creation or arrival time, and it is silently replaced by every later write (a coin merge, a field update, any re-use). For creation/arrival provenance use onchain_object_history (its first/ascending entry includes the creating tx) or onchain_address_activity with direction='received'. Returns: { items: [{ object, timestamp_ms, digest, sender }] }"
     },
     {
       "type": "object",
@@ -644,7 +672,15 @@
               "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
             }
           ],
-          "description": "Address (0x...) or account name. Query all on-chain activity by this actor — every transaction they sent. Use to build a user's on-chain activity profile or verify an actor's history."
+          "description": "Address (0x...) or account name. Query on-chain activity of this actor. Use to build a user's on-chain activity profile, verify an actor's history, or trace when funds/objects ARRIVED at an address."
+        },
+        "direction": {
+          "description": "'sent' (default): transactions SENT BY this address. 'received': transactions that delivered objects/coins TO this address (inbound transfers — the route for 'when did this arrive' without knowing the sender).",
+          "type": "string",
+          "enum": [
+            "sent",
+            "received"
+          ]
         },
         "cursor": {
           "description": "Pagination cursor from previous page's next_cursor",
@@ -686,13 +722,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -700,7 +736,7 @@
         "name_or_address"
       ],
       "additionalProperties": false,
-      "description": "FORENSICS TOOL — query all transactions sent by an address. WARNING: like onchain_object_history, this can lead to non-convergent queries. For AI context building, use assemble_context (extracts embedded history) or query_events (real-time transitions) instead. This tool is for auditing/user-activity profiling only. Returns: TransactionHistoryAnswer | undefined"
+      "description": "FORENSICS TOOL — query transactions sent BY an address (direction='sent', default) or inbound deliveries TO an address (direction='received'). WARNING: like onchain_object_history, this can lead to non-convergent queries. For AI context building, use assemble_context (extracts embedded history) or query_events (real-time transitions) instead. This tool is for auditing/user-activity profiling and inbound-arrival lookup only. Returns: TransactionHistoryAnswer | undefined"
     },
     {
       "type": "object",
@@ -736,13 +772,13 @@
           ]
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -780,20 +816,20 @@
               "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
             }
           ],
-          "description": "Address to profile. Supports string (name/address) or object form. LocalMark names are resolved automatically."
+          "description": "Address to profile. Supports string (name/address) or object form. LocalMark names are resolved automatically. Aliases 'name_or_address' and 'account' are accepted and auto-renamed to 'address'."
         },
         "no_cache": {
           "description": "Set to true to bypass cache and fetch fresh on-chain data",
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -844,13 +880,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -895,13 +931,13 @@
           "type": "boolean"
         },
         "network": {
+          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
             "testnet",
             "mainnet"
-          ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
+          ]
         }
       },
       "required": [
@@ -929,7 +965,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         }
       },
       "required": [
@@ -956,7 +992,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         }
       },
       "required": [
@@ -983,7 +1019,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         }
       },
       "required": [
@@ -1010,7 +1046,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         }
       },
       "required": [
@@ -1044,7 +1080,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         },
         "context_depth": {
           "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 extractAddressFields. 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).",
@@ -1087,7 +1123,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         },
         "reverse_order_amount": {
           "description": "Escrowed order amount (smallest-unit string) for reverse_map — included in the report summary as the concrete escrow mention.",
@@ -1184,7 +1220,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         }
       },
       "required": [
@@ -1229,7 +1265,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         }
       },
       "required": [
@@ -1274,7 +1310,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         },
         "account": {
           "description": "Scope the aggregation to ONE account address (the client's current account). Omit to aggregate across ALL local accounts.",
@@ -1309,7 +1345,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+          "description": "Network for the query. Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
         },
         "account": {
           "description": "Scope to ONE account address (the client's current account). Omit to merge across ALL local accounts.",
@@ -1366,6 +1402,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 the user's CURRENT network (client UI selection / authority config) when 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."
     }
   ]
 }

package/dist/schemas/schema_query.schema.json

@@ -65,7 +65,7 @@
       "type": "string"
     },
     "guard": {
-      "description": "Guard JSON for 'analyze_guard_semantics' action (object or JSON-encoded string). Shape: {description?, table: [{identifier, b_submission?, value_type?, value?, name?, object_type?}], root: {...}, rely?: {guards, logic_or?}, binding_hint?: {host_object?, binding_field?, action?, sharing_recipients?}}. This is the export format of guard2file / the 'data' payload of onchain_operations guard creation.",
+      "description": "Guard for 'analyze_guard_semantics' action. THREE accepted forms: (1) Guard JSON object, (2) JSON-encoded string (the guard2file export format: {description?, table: [...], root: {...}, rely?, binding_hint?}), (3) an on-chain Guard ADDRESS (0x...) or LocalMark name — loaded from chain automatically. Forms (1)/(2) analyze a local definition; form (3) analyzes the LIVE on-chain Guard.",
       "anyOf": [
         {
           "type": "string"
@@ -78,6 +78,30 @@
           "additionalProperties": {}
         }
       ]
+    },
+    "binding": {
+      "description": "Optional business-slot binding for 'analyze_guard_semantics' (G1). When set, the analysis includes the slot's business semantics (what the Guard means, what your submission means, pass/fail consequences, stakes). E.g. 'buy' for a Service.buy_guard, 'forward' for a Machine Forward.guard, 'allocate' when the submission identifies a payment recipient.",
+      "type": "string",
+      "enum": [
+        "buy",
+        "forward",
+        "allocate",
+        "claim_reward",
+        "vote",
+        "dispute",
+        "write_repository",
+        "submit_progress",
+        "gen_passport",
+        "custom"
+      ]
+    },
+    "network": {
+      "description": "Network for 'analyze_guard_semantics' when the guard is given as an on-chain address/name (G1). Defaults to the configured network.",
+      "type": "string",
+      "enum": [
+        "mainnet",
+        "testnet"
+      ]
     }
   },
   "required": [