@wowok/agent-mcp 3.4.3 → 3.4.4

package/dist/schemas/query_toolkit.schema.json

@@ -1,1867 +1 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/query_toolkit.json",
-  "title": "Data Query Toolkit",
-  "description": "Query local and on-chain data",
-  "oneOf": [
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "local_mark_list"
-        },
-        "filter": {
-          "description": "Local mark filter",
-          "type": "object",
-          "properties": {
-            "name": {
-              "description": "Filter by mark name (supports fuzzy match)",
-              "type": "string"
-            },
-            "tags": {
-              "description": "Filter by tags - returns marks that contain ANY of the specified tags",
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            },
-            "address": {
-              "description": "Filter by address (exact match, format: 0x + 64 hex characters)",
-              "type": "string"
-            },
-            "createdAt": {
-              "description": "Filter by creation time range",
-              "type": "object",
-              "properties": {
-                "gte": {
-                  "description": "Filter marks created on or after this timestamp (ms)",
-                  "type": "number"
-                },
-                "lte": {
-                  "description": "Filter marks created on or before this timestamp (ms)",
-                  "type": "number"
-                }
-              },
-              "additionalProperties": false
-            },
-            "updatedAt": {
-              "description": "Filter by update time range",
-              "type": "object",
-              "properties": {
-                "gte": {
-                  "description": "Filter marks updated on or after this timestamp (ms)",
-                  "type": "number"
-                },
-                "lte": {
-                  "description": "Filter marks updated on or before this timestamp (ms)",
-                  "type": "number"
-                }
-              },
-              "additionalProperties": false
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Query your LOCAL address book — maps human-readable names to blockchain addresses with optional tags. Use to resolve names→addresses or find addresses by tag. Returns: MarkData[] (name, address, tags, timestamps)"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "account_list"
-        },
-        "filter": {
-          "description": "Account filter",
-          "type": "object",
-          "properties": {
-            "name": {
-              "description": "Filter by account name (supports fuzzy match)",
-              "type": "string"
-            },
-            "address": {
-              "description": "Filter by account address (supports partial match, format: 0x + hex characters)",
-              "type": "string"
-            },
-            "suspended": {
-              "description": "Filter by suspension status. Omit to return all accounts regardless of status",
-              "type": "boolean"
-            },
-            "hasMessenger": {
-              "description": "Filter accounts with messenger enabled",
-              "type": "boolean"
-            },
-            "createdAt": {
-              "description": "Filter by creation time range",
-              "type": "object",
-              "properties": {
-                "gte": {
-                  "description": "Filter accounts created on or after this timestamp (ms)",
-                  "type": "number"
-                },
-                "lte": {
-                  "description": "Filter accounts created on or before this timestamp (ms)",
-                  "type": "number"
-                }
-              },
-              "additionalProperties": false
-            },
-            "updatedAt": {
-              "description": "Filter by update time range",
-              "type": "object",
-              "properties": {
-                "gte": {
-                  "description": "Filter accounts updated on or after this timestamp (ms)",
-                  "type": "number"
-                },
-                "lte": {
-                  "description": "Filter accounts updated on or before this timestamp (ms)",
-                  "type": "number"
-                }
-              },
-              "additionalProperties": false
-            },
-            "includePubkey": {
-              "description": "Include pubkey in results (default: false). Pubkey is large (~900 bytes), omit unless needed",
-              "type": "boolean"
-            }
-          },
-          "additionalProperties": false
-        },
-        "no_cache": {
-          "description": "Accepted for call-shape uniformity and IGNORED — account_list is a device-local read with no cache to bypass",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Query your LOCAL accounts — view all accounts stored on this device (addresses, messenger status, suspension state). Use filter.includePubkey=true to also include public keys (~900 bytes each, omitted by default). Returns: AccountData[] (name, address, pubkey?, suspended, messenger, timestamps)"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "local_info_list"
-        },
-        "filter": {
-          "description": "Local info filter",
-          "type": "object",
-          "properties": {
-            "name": {
-              "description": "Filter by info name (supports fuzzy match)",
-              "type": "string"
-            },
-            "default": {
-              "description": "Filter by default value (supports fuzzy match)",
-              "type": "string"
-            },
-            "contents": {
-              "description": "Filter by contents - returns info that contains ANY of the specified content items",
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            },
-            "createdAt": {
-              "description": "Filter by creation time range",
-              "type": "object",
-              "properties": {
-                "gte": {
-                  "description": "Filter info created on or after this timestamp (ms)",
-                  "type": "number"
-                },
-                "lte": {
-                  "description": "Filter info created on or before this timestamp (ms)",
-                  "type": "number"
-                }
-              },
-              "additionalProperties": false
-            },
-            "updatedAt": {
-              "description": "Filter by update time range",
-              "type": "object",
-              "properties": {
-                "gte": {
-                  "description": "Filter info updated on or after this timestamp (ms)",
-                  "type": "number"
-                },
-                "lte": {
-                  "description": "Filter info updated on or before this timestamp (ms)",
-                  "type": "number"
-                }
-              },
-              "additionalProperties": false
-            }
-          },
-          "additionalProperties": false
-        },
-        "account": {
-          "description": "Account partition to query (name or address). Local info is isolated per account; omit for the default account's partition.",
-          "type": "string"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Query your LOCAL private info — sensitive data like delivery addresses, phone numbers, contacts stored ONLY on this device. Use to retrieve saved contact/delivery details. Returns: InfoData[] (name, default value, contents, timestamps)"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "token_list"
-        },
-        "filter": {
-          "type": "object",
-          "properties": {
-            "alias_or_name": {
-              "description": "Alias or name filter",
-              "type": "string"
-            },
-            "symbol": {
-              "description": "Token symbol",
-              "type": "string"
-            },
-            "type": {
-              "description": "Token type",
-              "type": "string"
-            }
-          },
-          "additionalProperties": false,
-          "description": "Token data filter"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Query cached token metadata — symbol, decimals, icon URL, description for tokens previously fetched from chain. Use to look up token info without an on-chain query. Returns: TokenTypeInfo[] (type, alias, name, symbol, decimals, iconUrl)"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "account_balance"
-        },
-        "name_or_address": {
-          "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": {
-          "description": "Set to true to query total balance amount for the token type",
-          "type": "boolean"
-        },
-        "coin": {
-          "description": "Set to query paginated coin objects instead of balance. Use cursor/limit for pagination.",
-          "type": "object",
-          "properties": {
-            "cursor": {
-              "description": "Pagination cursor for listing coin objects",
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "limit": {
-              "description": "Max coin objects per page",
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "additionalProperties": false
-        },
-        "token_type": {
-          "description": "Token type in Move format: 0x<package>::<module>::<struct>. Examples: \"0x2::wow::WOW\" (default). For custom tokens, use the full type string from the token's coin metadata. The Fund Processing Layer resolves precision from the official registry → cache → on-chain.",
-          "type": "string"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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"
-          ]
-        },
-        "no_cache": {
-          "description": "Accepted for call-shape uniformity and IGNORED — this query is always a live read; freshness provenance rides `_balance_read_freshness`",
-          "type": "boolean"
-        }
-      },
-      "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 accepted but has no effect. The response carries `_balance_read_freshness` (fetched_at + note): figures CAN differ between reads taken moments apart (live F-RQ-12: the same wallet read 9.93 / 21.88 / 56.28 WOW on three consecutive calls) — reconcile via the coin page and prove arrival via the transaction digest, never off a single read. 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",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "local_names"
-        },
-        "addresses": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Array of addresses to look up local names for"
-        }
-      },
-      "required": [
-        "query_type",
-        "addresses"
-      ],
-      "additionalProperties": false,
-      "description": "Query local names (account name and local mark name) for a list of addresses. Returns array of: { account?: string, local_mark?: string, address: string }"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "onchain_personal_profile"
-        },
-        "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": {
-          "description": "Set to true to bypass cache and fetch fresh on-chain data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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"
-      ],
-      "additionalProperties": false,
-      "description": "Query any user's PUBLIC on-chain profile — social links, reputation (likes/dislikes), personal info records, voting history, referrer. Use to look up a user's public identity and reputation. Returns: ObjectPersonal | undefined"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "onchain_objects"
-        },
-        "objects": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-          },
-          "description": "List of object IDs (names or addresses) to query in batch"
-        },
-        "winner_node": {
-          "description": "Optional adjudication node name for the winner derivation (MN5-6R ③A): when passed, every queried Progress object derives `winner_derivation` — the first account whose forward completed entry into THIS node, computed purely from the append-only Progress history (the chain stores no winner field). When omitted, the Progress's current node is used as the adjudication node. No match → `winner_derivation: null` with a note (the order has not advanced into that node).",
-          "type": "string"
-        },
-        "no_cache": {
-          "description": "Set to FALSE to allow the session cache; OMIT (or pass true) for a forced-fresh read. ⚠️ DEFAULT IS FRESH ON PURPOSE: a cached snapshot here reports a PRE-TRANSACTION value for exactly the fields an agent uses to decide whether money moved — on testnet this reported a stale `compensation_fund`, a stale `order.claimed_by`, and a stale `allocation.balance`. Only pass no_cache:false when you deliberately want a cheap repeat read of data you already know is current. The response carries `_read_freshness` (source live|session_cache, fetched_at) so a snapshot can never be mistaken for state.",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "objects"
-      ],
-      "additionalProperties": false,
-      "description": "Batch query on-chain WOWOK objects by ID or name — supports Service, Machine, Order, Treasury, Reward, Arb, Personal, Contact, and more. Use to inspect one or more objects in a single call. FORCED-FRESH by default (see no_cache) and the response includes `_read_freshness` provenance. Every queried Progress object additionally carries `_winner_derivation` (MN5-6R ③A): the first account whose forward completed entry into the adjudication node (`winner_node`, default = the Progress's current node), derived purely from the Progress history — null + note when the order has not advanced there. Returns: { objects: ObjectBase[], _read_freshness: { source, no_cache, fetched_at, note } }"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "onchain_received"
-        },
-        "name_or_address": {
-          "anyOf": [
-            {
-              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
-            },
-            {
-              "type": "object",
-              "properties": {
-                "name_or_address": {
-                  "type": "string",
-                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-                },
-                "local_mark_first": {
-                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
-                  "type": "boolean"
-                }
-              },
-              "additionalProperties": false,
-              "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "description": "Name or address of the object that received payments/items - can be a string (name/address) or full object"
-        },
-        "type": {
-          "description": "Type filter for querying received objects. - If undefined or null: query all types (equivalent to the old all_type=true). - If 'CoinWrapper': query CoinWrapper type for the object's token (equivalent to the old all_type=false). - If string: query specific StructType (e.g., '0x2::payment::CoinWrapper<0x2::wow::WOW>').",
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "string",
-              "const": "CoinWrapper"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "cursor": {
-          "description": "Pagination cursor from previous page",
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "limit": {
-          "description": "Max records per page",
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "no_cache": {
-          "description": "Set to true to bypass cache and fetch fresh on-chain data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "name_or_address"
-      ],
-      "additionalProperties": false,
-      "description": "Query objects (Payments, Tokens, NFTs) received by a specific object. Use to track incoming payments or items sent to an on-chain object. Supports pagination and type filter. Returns: ReceivedBalance | ReceivedNormal[]"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "onchain_transaction"
-        },
-        "digest": {
-          "type": "string",
-          "description": "Transaction digest (0x...) to verify. Use after any on-chain operation to confirm what actually happened on-chain — object changes, balance changes, gas used, success/failure status. This is the 'OperationProof' primitive for the Verify step."
-        },
-        "no_cache": {
-          "description": "Set to true to bypass cache and fetch fresh on-chain data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "digest"
-      ],
-      "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: 'localnet' | 'mainnet' | '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": {
-        "query_type": {
-          "type": "string",
-          "const": "onchain_object_history"
-        },
-        "object": {
-          "type": "string",
-          "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",
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "limit": {
-          "description": "Max results per page (default 20, max 50)",
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "order": {
-          "description": "Sort order: ascending=oldest first, descending=newest first (default)",
-          "anyOf": [
-            {
-              "type": "string",
-              "const": "ascending"
-            },
-            {
-              "type": "string",
-              "const": "descending"
-            }
-          ]
-        },
-        "no_cache": {
-          "description": "Set to true to bypass cache and fetch fresh on-chain data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "object"
-      ],
-      "additionalProperties": false,
-      "description": "FORENSICS TOOL — query all transactions that touched an object. WARNING: this can lead to non-convergent queries (each tx touches more objects with their own history). For AI context building, use assemble_context instead — it extracts embedded history from object states (ProgressSession.forwards, etc.) without infinite recursion. This tool is for auditing/forensics only. Returns: TransactionHistoryAnswer | undefined"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "onchain_last_updated"
-        },
-        "objects": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-          },
-          "description": "List of object IDs (names or addresses) to query in batch"
-        },
-        "no_cache": {
-          "description": "Set to true to bypass cache and fetch fresh on-chain data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "objects"
-      ],
-      "additionalProperties": false,
-      "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",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "onchain_address_activity"
-        },
-        "name_or_address": {
-          "anyOf": [
-            {
-              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
-            },
-            {
-              "type": "object",
-              "properties": {
-                "name_or_address": {
-                  "type": "string",
-                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-                },
-                "local_mark_first": {
-                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
-                  "type": "boolean"
-                }
-              },
-              "additionalProperties": false,
-              "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "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",
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "limit": {
-          "description": "Max results per page (default 20, max 50)",
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "order": {
-          "description": "Sort order: ascending=oldest first, descending=newest first (default)",
-          "anyOf": [
-            {
-              "type": "string",
-              "const": "ascending"
-            },
-            {
-              "type": "string",
-              "const": "descending"
-            }
-          ]
-        },
-        "no_cache": {
-          "description": "Set to true to bypass cache and fetch fresh on-chain data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "name_or_address"
-      ],
-      "additionalProperties": false,
-      "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",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "token_value_convert"
-        },
-        "token_type": {
-          "type": "string",
-          "description": "Full token type in Move format: 0x<package>::<module>::<struct>. Examples: \"0x2::wow::WOW\" (9 decimals). The token's decimals drive the conversion — resolved from official registry → local cache → on-chain coin metadata."
-        },
-        "raw": {
-          "description": "Raw smallest-unit value (u64, e.g. \"2200000000\") to convert TO a human unit value. Provide EXACTLY ONE of raw / unit.",
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "number"
-            }
-          ]
-        },
-        "unit": {
-          "description": "Human unit value (e.g. \"2.2\") to convert TO raw smallest units (u64). Provide EXACTLY ONE of raw / unit. Conversion is REFUSED when the token's decimals cannot be resolved (guessing would forge wrong on-chain values).",
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "number"
-            }
-          ]
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "token_type"
-      ],
-      "additionalProperties": false,
-      "description": "Convert between raw on-chain smallest units (u64) and human unit values, in EITHER direction. Provide EXACTLY ONE of raw / unit (handler-validated). raw → unit: \"2200000000\" → \"2.2\" (pass-through when precision unknown). unit → raw: \"2.2\" → \"2200000000\" (REFUSED when precision unknown — never guesses decimals). Use this before displaying chain values to users, and before entering amounts for on-chain operations. Returns: { token_type, symbol?, decimals?, precision_known, direction, input, output, error?, text }"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "address_profile"
-        },
-        "address": {
-          "anyOf": [
-            {
-              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
-            },
-            {
-              "type": "object",
-              "properties": {
-                "name_or_address": {
-                  "type": "string",
-                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-                },
-                "local_mark_first": {
-                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
-                  "type": "boolean"
-                }
-              },
-              "additionalProperties": false,
-              "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "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: 'localnet' | 'mainnet' | '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",
-        "address"
-      ],
-      "additionalProperties": false,
-      "description": "Unified address profile (K3 22 §P0-1): classifies the address (user / business-object type / system singleton), then batches identity + reputation (like/dislike/favor) + order membership + contact membership + permission membership + core/tx reverse bindings + the object itself into a single result. The one-stop entry for 'who/what is this address'. For Service addresses the result also merges a service_analysis block (description / payment token / shelf split / location / trust-risk / on-chain last update). Returns: AddressProfile"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "address_profiles"
-        },
-        "addresses": {
-          "minItems": 1,
-          "maxItems": 50,
-          "type": "array",
-          "items": {
-            "anyOf": [
-              {
-                "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "name_or_address": {
-                    "type": "string",
-                    "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-                  },
-                  "local_mark_first": {
-                    "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
-                    "type": "boolean"
-                  }
-                },
-                "additionalProperties": false,
-                "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-              }
-            ],
-            "description": "Account or address lookup. Can be a simple string (recommended for AI) or full object with explicit local_mark_first control. String form auto-converts to { name_or_address: <string>, local_mark_first: true }."
-          },
-          "description": "Addresses to profile in ONE batch (the list form of address_profile — prefer this over N single-address calls in list views). Each entry supports string (name/address) or object form; LocalMark names are resolved automatically. Result order matches the request order; a per-address failure yields a null slot (never rejects the whole batch)."
-        },
-        "no_cache": {
-          "description": "Set to true to bypass cache and fetch fresh on-chain data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "addresses"
-      ],
-      "additionalProperties": false,
-      "description": "BATCH unified address profiles: one call for up to 50 addresses instead of N single-address round-trips. Each non-null entry carries the SAME shape as address_profile (classification + identity + reputation votes + order/contact/permission memberships + core/tx reverse bindings + the object + activity + role evidence), including the merged service_analysis block for Service addresses. Use for list views that need profiles for many rows at once. Returns: (AddressProfile | null)[]"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "service_supply_chain"
-        },
-        "address": {
-          "anyOf": [
-            {
-              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
-            },
-            {
-              "type": "object",
-              "properties": {
-                "name_or_address": {
-                  "type": "string",
-                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-                },
-                "local_mark_first": {
-                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
-                  "type": "boolean"
-                }
-              },
-              "additionalProperties": false,
-              "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "description": "Service address whose transparent sub-order purchasing graph to resolve. Supports string (name/address) or object form. LocalMark names are resolved automatically."
-        },
-        "no_cache": {
-          "description": "Set to true to bypass cache and fetch fresh on-chain data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | '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",
-        "address"
-      ],
-      "additionalProperties": false,
-      "description": "Resolve a Service's transparent sub-order purchasing graph (K3 23 §3.6): reads the bound Machine's frozen forwards, finds purchasing-commitment Guards, and returns each forward's purchased sub-services (fixed address fields) + required sub-order proof fields (b_submission fields). Standalone capability for buyer due-diligence / compose_service / anti_cheat / merchant self-check; reused by Watch. Returns: SupplyChainGraph"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "recover_created_objects"
-        },
-        "label": {
-          "anyOf": [
-            {
-              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
-            },
-            {
-              "type": "object",
-              "properties": {
-                "name_or_address": {
-                  "type": "string",
-                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-                },
-                "local_mark_first": {
-                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
-                  "type": "boolean"
-                }
-              },
-              "additionalProperties": false,
-              "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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
-            }
-          ],
-          "description": "Account name or address (0x...) whose recovery state to assemble — the SENDER of the timed-out call (a submission_unknown / timeout envelope names it in the verification header or submission_verification.sender). Supports string or object form; LocalMark names are resolved automatically."
-        },
-        "op": {
-          "description": "Filter the in-flight markers by operation name: 'order_new' (order creation), 'alloc_by_guard' (distribution), or an operation_type like 'payment', 'reward', 'guard'. Omit to list every open marker.",
-          "type": "string"
-        },
-        "limit": {
-          "description": "Max returned-digest and activity entries (default 20).",
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 50
-        },
-        "no_cache": {
-          "description": "Set to true to bypass the on-chain activity cache and fetch fresh data",
-          "type": "boolean"
-        },
-        "network": {
-          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used.",
-          "type": "string",
-          "enum": [
-            "localnet",
-            "testnet",
-            "mainnet"
-          ]
-        }
-      },
-      "required": [
-        "query_type",
-        "label"
-      ],
-      "additionalProperties": false,
-      "description": "RECOVERY TOOL — assemble in ONE call everything needed to recover objects after a TIMED-OUT or lost-response write (W5-09, the official form of the ad-hoc recovery script). Joins three sources: (1) in-flight markers this process still holds OPEN — operations whose commit state was never observed (each carries op, target service/allocation, buyer, item count, started_at, any transport-reported digests); (2) digests this process recently RETURNED as executed receipts; (3) the account's on-chain sent-activity in the failure window. Decision rule: a marker whose digest resolves to an executed transaction → ADOPT its created objects and stop; activity shows the operation landed → adopt; markers exist but nothing on-chain → the state stayed open, a corrected resubmit is allowed; nothing anywhere → nothing landed from THIS process (other sessions/devices may still hold state — the chain remains the only truth). Returns: { label, resolved_address?, inflight_markers[], returned_digests[], landed_tombstones[], onchain_activity?, recovery_guidance }"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "service_panorama"
-        },
-        "object_address": {
-          "description": "On-chain Service object address (or LocalMark name). Required when query_type='service_panorama'. PREFERRED field name — the panorama family (service/machine/object) is unified on `object_address` (a Service IS an on-chain object); `service_address` remains accepted as a deprecated alias.",
-          "type": "string"
-        },
-        "service_address": {
-          "description": "DEPRECATED alias of object_address (accepted for call compatibility). Prefer object_address. Example: {\"query_type\": \"service_panorama\", \"object_address\": \"0xabc...\"}.",
-          "type": "string"
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "ONE-CALL full business-intelligence context of an on-chain Service (K3 22 / Business Service tab): base data + machine workflow graph + buy_guard/permission/allocator guards + related objects + supply chain + deterministic BusinessReport + recent orders. Every section degrades gracefully — failures are reported in `data_gaps`. Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "service_quote"
-        },
-        "object_address": {
-          "description": "On-chain Service object address (or LocalMark name). Required when query_type='service_quote'. PREFERRED field name — unified with the panorama family on `object_address`; `service_address` remains accepted as a deprecated alias.",
-          "type": "string"
-        },
-        "service_address": {
-          "description": "DEPRECATED alias of object_address (accepted for call compatibility). Prefer object_address. Example: {\"query_type\": \"service_quote\", \"object_address\": \"0xabc...\"}.",
-          "type": "string"
-        },
-        "items": {
-          "description": "Basket to quote. Omit to quote EVERY sale with quantity 1 (the floor basket — order quantity is chosen at buy time, so per-unit prices are the authoritative input). Each item names its sale via `name` (exact literal) or `sale_id` (0-based index) — exactly one.",
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "name": {
-                "description": "Sale name exactly as configured on the Service. Required unless sale_id is given.",
-                "type": "string"
-              },
-              "sale_id": {
-                "description": "0-based index of the sale in the Service's configured sales list (same enumeration the buy tool accepts). Required unless name is given.",
-                "type": "integer",
-                "minimum": 0,
-                "maximum": 9007199254740991
-              },
-              "quantity": {
-                "default": 1,
-                "description": "Units of this item in the basket (default 1).",
-                "type": "integer",
-                "exclusiveMinimum": 0,
-                "maximum": 10000
-              }
-            },
-            "required": [
-              "quantity"
-            ],
-            "additionalProperties": false
-          }
-        },
-        "discount": {
-          "description": "C-10: Discount (coupon) object address or LocalMark name to price the basket WITH. Without it the quote is always the UNDISCOUNTED total, so a discounted buyer cannot compute the exact total_pay that order_new requires (it must equal the order total precisely — any drift aborts with E_COIN_NOT_ENOUGH). RATES subtracts total*off/10000; MINUS/FIXED subtracts min(total, off), mirroring the on-chain rule with integer floor division. Read-only: quoting does NOT consume the coupon.",
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
-        },
-        "no_cache": {
-          "description": "A-5 freshness control, same convention as the panorama family (DEFAULT TRUE = read fresh, bypass the object cache). A quote that feeds an exact total_pay must never come from a stale cache — pass false only for high-frequency polling.",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "READ-ONLY pre-purchase quote of a Service (finding 3.6 — order_new total_pay pre-check): per-item unit price × quantity, the basket total that order_new.buy.total_pay.balance must exactly equal (the on-chain buy aborts on any drift), and the order_allocators fee-split preview (sharing rows of the FIRST allocator — the normal payout path; guards select per-case allocators such as refund/damage, so the live split depends on which guard passes). Also previews the reward terms of every Reward hung on the Service (pool balance, per-claim amount, claim window) so a buyer never budgets on an expired or unfunded reward. Mirrors the on-chain price×quantity semantics WITHOUT calling quote on-chain and NEVER submits a transaction. Amounts are payment-token smallest units plus a human display when the token precision resolves."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "machine_panorama"
-        },
-        "object_address": {
-          "description": "On-chain object address (0x followed by 32-64 hex chars). Also accepts a LocalMark NAME (resolved automatically). H-06 fix: invalid formats are rejected at the handler level with a descriptive error.",
-          "type": "string"
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "ONE-CALL panorama of an on-chain Machine (Business Machine tab; Machine counterpart of service_panorama): head (name/tags/description/published/paused) + the Machine's own fields (permission/um/node_count/consensus repositories) + workflow graph (nodes/edges/forwards) + Progress list from the GLOBAL tx table (0xaaf, Machine address as KEY). Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "object_panorama"
-        },
-        "object_address": {
-          "description": "On-chain object address (0x followed by 32-64 hex chars) for object_panorama. Also accepts a LocalMark NAME (resolved automatically). H-06 fix: invalid formats are rejected at the handler level with a descriptive error. F27 (gf32-mn-261103): `object` is accepted as an alias too — the write faces all take `object`, so a driver reusing one helper for reads and writes no longer trips on the key name.",
-          "type": "string"
-        },
-        "object": {
-          "description": "ALIAS of object_address (accepted for write-face key compatibility — every write tool takes `object`). Prefer object_address on query calls. Example: {\"query_type\": \"object_panorama\", \"object\": \"0xabc...\"}.",
-          "type": "string"
-        },
-        "filter": {
-          "description": "DEPRECATED alias of object_address (accepted for call compatibility; must be a plain address or LocalMark NAME string, not an object). Prefer object_address. Example: {\"query_type\": \"object_panorama\", \"object_address\": \"0xabc...\"}.",
-          "type": "string"
-        },
-        "wts_file_path": {
-          "description": "Proof objects only: local path to the .wts evidence packet to cross-check against this anchor. Returns wts_anchor_check — whether the packet's message roots match the frozen root, whether the server key matches, and whether the Proof predates the packet (a frozen Proof is what makes WTS content non-re-fabricable after the fact).",
-          "type": "string"
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
-        },
-        "no_cache": {
-          "description": "A-5 freshness control (amz9-ln-261023). DEFAULT TRUE: the panorama primary read bypasses the object cache and reads the chain state fresh — a post-write panorama (confirm, forward, claim, refund) must never show pre-write cache (the F-L02/F-L10 stale-after-confirm failure made agents re-confirm and misread terminal states). Pass false to opt back into the cached read for high-frequency polling where a few seconds of staleness is acceptable.",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "ONE-CALL detail-page panorama for Progress / Demand / Order / Allocation / Arb / Repository / Proof objects (client panorama family): discriminated `object_type` + head (name/tags/description) + the object's own typed fields + type-specific extras (Demand presenters from the GLOBAL tx table, Progress session/forwards, Order fund state, Allocation pool balance + per-rail resolved recipients + Payment children, Arb votes & propositions, Repository policies, Proof anchored root + WTS cross-check). Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "review_pack"
-        },
-        "object_address": {
-          "description": "On-chain object address (0x followed by 32-64 hex chars) for review_pack. Also accepts a LocalMark NAME (resolved automatically). H-06 fix: invalid formats are rejected at the handler level with a descriptive error.",
-          "type": "string"
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "ONE-CALL typed ReviewPack for the client's generic ReviewPackRenderer (K3 24 §5.2 / G3) — section list + typed field values; the UI-convention defaults live in the renderer, the section composition lives in the MCP assembler. Runs the matching panorama (one chain-query pass) and reshapes it. Supported types: Order, Service, Arb, Demand, Repository, Progress, Machine. Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "assemble_context"
-        },
-        "context_objects": {
-          "description": "Object IDs (0x...) or LocalMark names to assemble context for. Required when query_type='assemble_context'. The current on-chain state of each object will be queried and enriched with semantic annotations.",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "include_events": {
-          "description": "When true, assemble_context also queries recent state-transition events (NewOrderEvent, ProgressEvent, ArbEvent, etc.). Events are the real-time transition log — convergent and bounded. Defaults to false. Note: object-embedded history (ProgressSession.forwards, Order.disputes) is ALWAYS extracted automatically — no flag needed.",
-          "type": "boolean"
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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).",
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 5
-        },
-        "context_include": {
-          "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.",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Semantic context assembly (GLM5 §6, Layer 3): query on-chain object states + extract embedded history + optional events + optional BFS dependency expansion, and assemble a structured context for LLM consumption. Required: context_objects (array of object IDs/names). Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "reverse_map"
-        },
-        "context_objects": {
-          "description": "Object IDs (0x...) or LocalMark names to feed into the report. Required when query_type='reverse_map' (include the Service; add Machine/Allocation for refund-path detection).",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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.",
-          "type": "string"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Deterministic L4→L1 business report (K3 03 reverse lane; no LLM): queries the objects, classifies into business semantics, emits merchant profile + user risk assessment + game-theory analysis. Same objects ALWAYS yield the same report. Required: context_objects (include the Service; add Machine/Allocation for refund-path detection). Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "participation_radar"
-        },
-        "radar_account": {
-          "description": "Account to analyze — address (0x...) or LocalMark name (resolved to an address). Required when query_type='participation_radar'. The perspective (customer/operator/observer) is DERIVED from on-chain data (Order.builder + PermissionPerm grants) — never asserted by this field.",
-          "type": "string"
-        },
-        "radar_targets": {
-          "description": "In-flight orders to analyze (1-20). Required when query_type='participation_radar'. Each target is analyzed independently; results are aggregated into one account dashboard.",
-          "minItems": 1,
-          "maxItems": 20,
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "progress": {
-                "type": "string",
-                "description": "Progress object address (0x...) or LocalMark name. The Progress carries the current node + bound Machine."
-              },
-              "order": {
-                "description": "Order object address or LocalMark name (optional but recommended — enables order-holder detection, service-level compensation/reward claims, and dispute context).",
-                "type": "string"
-              }
-            },
-            "required": [
-              "progress"
-            ],
-            "additionalProperties": false
-          }
-        },
-        "radar_include_alerts": {
-          "description": "Attach order-monitor alerts (progress stall / compensation fund / review & arbitration windows) to each per-order result. Default true.",
-          "type": "boolean"
-        },
-        "radar_review_summary": {
-          "description": "Merchant-side review coverage summary (REVIEW-COMPONENT-PLAN batch 4): completed orders vs orders with a structured review record. Review rows live in a caller-named Repository — gather both counts via onchain_table_data (repository rows under the 'review' key, order-keyed → one row per order, F09) and pass them in; the radar derives the merchant-side review-rate hint (high missing rate with a reward attached → reward lapsed or window too short). Omit when no review repository is bound.",
-          "type": "object",
-          "properties": {
-            "orders_completed": {
-              "type": "integer",
-              "minimum": 0,
-              "maximum": 9007199254740991
-            },
-            "reviews_written": {
-              "type": "integer",
-              "minimum": 0,
-              "maximum": 9007199254740991
-            },
-            "reward_bound": {
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "orders_completed",
-            "reviews_written"
-          ],
-          "additionalProperties": false
-        },
-        "radar_monitor_thresholds": {
-          "description": "Optional per-call overrides for order-monitor alert thresholds (only used when radar_include_alerts is on). All fields optional; omitted fields keep defaults. Units: hours/days as marked per field.",
-          "type": "object",
-          "properties": {
-            "progress_stall_hours": {
-              "description": "Progress stall alert threshold in HOURS. Default 0 = auto (expected_node_duration × 2).",
-              "type": "number",
-              "exclusiveMinimum": 0
-            },
-            "compensation_drop_ratio": {
-              "description": "Compensation fund drop alert ratio (0-1). Default 0.3 = alert on ≥30% drop.",
-              "type": "number",
-              "minimum": 0,
-              "maximum": 1
-            },
-            "compensation_coverage_min": {
-              "description": "Minimum compensation coverage ratio vs order amount (0-1). Default 1.0 = must fully cover.",
-              "type": "number",
-              "minimum": 0,
-              "maximum": 1
-            },
-            "messenger_timeout_hours": {
-              "description": "Messenger no-reply timeout in HOURS. Default 24.",
-              "type": "number",
-              "exclusiveMinimum": 0
-            },
-            "review_window_closing_days": {
-              "description": "Review window near-closing alert threshold in DAYS. Default 3.",
-              "type": "number",
-              "exclusiveMinimum": 0
-            },
-            "arb_window_closing_days": {
-              "description": "Arbitration window near-closing alert threshold in DAYS. Default 3.",
-              "type": "number",
-              "exclusiveMinimum": 0
-            }
-          },
-          "additionalProperties": false
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "In-flight order participation analysis for ONE account (GLM6/94): customer / operator / observer perspective derived from on-chain permission matching (never caller-asserted) — per-order operable forwards (branch choices), waiting_on roles, pending claims (reward/discount/compensation/rating), perspective-specific interest hints, aggregated account dashboard. Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "order_aggregate"
-        },
-        "group": {
-          "description": "Grouping dimension, read from each Order's own fields: 'service' (default — the crowd/group-buy pool per service), 'machine' (per workflow) or 'owner' (per ordering account).",
-          "type": "string",
-          "enum": [
-            "service",
-            "machine",
-            "owner"
-          ]
-        },
-        "group_id": {
-          "description": "Restrict the aggregation to ONE group value (exact address match — e.g. the Service address running a crowd-funding campaign). The funding-target verdict then reads a single row.",
-          "type": "string"
-        },
-        "metric": {
-          "description": "Numeric field to sum (default 'amount' — the Order's escrowed payment in smallest units).",
-          "type": "string",
-          "const": "amount"
-        },
-        "exclude_claimed": {
-          "description": "Exclude orders whose compensation has been claimed (claimed_by set). Default false — pass true so refund/compensation payouts are not double-counted toward a target.",
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Max group rows returned (default 50, max 1000). truncated flags rows beyond the limit; totals ALWAYS cover the full set regardless of the limit.",
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 1000
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "CROSS-ORDER aggregate over Order objects from the MCP index projection (S17-C / F-RQD2-06): count + exact amount sums per group, with the projection's reconciliation coverage attached. Read-side stand-in for the missing on-chain cross-order primitive — crowd/group-buy targets like '3 x 6 WOW >= 18 WOW before funding' are checked HERE until the protocol grows a native aggregate. A STALE projection refuses to answer loudly (INDEX_STALE_PROJECTION — no legacy fallback can aggregate) instead of serving a funding verdict on old data. Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "relationship_profile"
-        },
-        "radar_account": {
-          "description": "Anchor account to analyze — address (0x...) or LocalMark name. Required when query_type='relationship_profile'. ANY distributed account works (not only local accounts): the anchor is just an address; all relationships derive from on-chain power carriers.",
-          "type": "string"
-        },
-        "relation_kinds": {
-          "description": "Filter to specific relationship kinds (default: all). employment = merchant × staff (principal-agent); process_operation = machine node operators; agency = order owner × agents; transaction = customer × merchant; supply = demander × presenters; arbitration_delegation = service owner × arbitrators; dispute_resolution = arbitrator × disputants; value_distribution = payer × allocation recipients; contact_membership = communication channel members.",
-          "type": "array",
-          "items": {
-            "type": "string",
-            "enum": [
-              "employment",
-              "process_operation",
-              "agency",
-              "transaction",
-              "supply",
-              "arbitration_delegation",
-              "dispute_resolution",
-              "value_distribution",
-              "contact_membership"
-            ]
-          }
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Business Relationship Graph (K3/19): derive ONE account's full relationship web from on-chain power carriers (Permission memberships, Machine forwards, Orders, Demand presenters, Allocation sharing, Arbitration bindings, Contact ims). Each edge carries the three dimensions — power (what each side CAN do, and where that power lives on-chain), interest (gains/exposures, with registry-declared goal tensions like principal-agent divergence), and value flows (escrow → allocation → payment chains). Read-only; roles are DERIVED from chain data, never asserted."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "scenario_topology"
-        },
-        "chain_id": {
-          "description": "Optional scenario-chain id (chain.standard_ecommerce | chain.procurement_tender | chain.data_subscription | chain.collaborative_operations). When given, only that chain is returned; otherwise ALL scenario chains + bridges are returned.",
-          "type": "string"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Scenario Topology knowledge (K3 03 §3.5 / Part 2): the STATIC registry of how WoWok objects INTEGRATE each other. Bridges weld object pairs into a capability that belongs to no single object (e.g. Demand.present(service) grants MATCHMAKING); chains compose bridges into whole applications (e.g. standard e-commerce, procurement tender). Pure knowledge, read-only — no on-chain reads. Use to explain HOW a business scenario is assembled from on-chain objects and why the integration (not the objects themselves) yields the capability."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "workspace_lists"
-        },
-        "no_cache": {
-          "description": "Set to true to bypass both the aggregation cache and the SDK chain-read cache.",
-          "type": "boolean"
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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.",
-          "type": "string"
-        },
-        "light": {
-          "description": "Set to true for the fast first-paint phase: rows carry address / type / name / time only, skipping the per-object enrichment (dead-object probe, registrar votes, per-family extras). Used for progressive list loading; the client merges the full result afterwards.",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "ONE-CALL workspace object lists for ONE account (client Quick Access workspace buckets) — pass `account` to scope to the current account; omit to aggregate across ALL local accounts: treasuries / repositories / contacts / machines / rewards come from the unified permission reverse chain (account → EntityPermission @0xaad → permission-keyed ObjectLinkerCore @0xaae, the ONE source every permission-bearing object family writes to) plus account-keyed EntityContact memberships (@0xaa9) for contacts; others = account-keyed ObjectLinkerTx (@0xaaf) touches, deduplicated, minus all classified business types. Each item: object address + type + local name + time. Aggregation result is TTL-cached (120s, keyed by network + account). Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "marks_of_account"
-        },
-        "no_cache": {
-          "description": "Set to true to bypass both the aggregation cache and the SDK chain-read cache.",
-          "type": "boolean"
-        },
-        "context_network": {
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ],
-          "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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.",
-          "type": "string"
-        },
-        "light": {
-          "description": "Set to true for the fast first-paint phase: rows carry address / type only (vote_kinds is empty until the full result), skipping the per-target registrar-vote reads + object enrichment. Used for progressive list loading; the client merges the full result afterwards.",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "query_type"
-      ],
-      "additionalProperties": false,
-      "description": "Like / Favor list for ONE account (client Quick Access 'Like / Favor' tab) — every address (object OR plain user) the account has EVER liked / disliked / favored, deduplicated, with the CURRENT active vote kinds per target. Deterministic source: the voter's own Resource mark table, cross-read with the target's EntityLinker votes for the 'marked at' clock. Fully-toggled-off targets are dropped. Each row: address + tags (like/dislike/favor) + time + object_type (null = plain user) + local name / description / tags. Aggregation result is TTL-cached (120s, keyed by network + account). Read-only."
-    },
-    {
-      "type": "object",
-      "properties": {
-        "query_type": {
-          "type": "string",
-          "const": "migration_preflight"
-        },
-        "no_cache": {
-          "description": "Set to true to bypass the SDK chain-read cache.",
-          "type": "boolean"
-        },
-        "account": {
-          "type": "string",
-          "description": "Account address (or name) to check. Required when query_type='migration_preflight'."
-        },
-        "source_network": {
-          "description": "Source network to detect an existing build (default 'testnet').",
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ]
-        },
-        "target_network": {
-          "description": "Target network for the migration (default 'mainnet').",
-          "type": "string",
-          "enum": [
-            "testnet",
-            "mainnet",
-            "localnet"
-          ]
-        }
-      },
-      "required": [
-        "query_type",
-        "account"
-      ],
-      "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 — THIS field is `context_network` (the query tools accept no separate `network` key). 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 (interest-assessment stakes + node-game actions + counterparties + risk reminders) 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"
-          ]
-        },
-        "facets": {
-          "description": "Per-call facet overrides keyed by the ten facet ids (fund_safety/reputation/arbitration/fulfillment/offering_price/workflow/fund_flow/supply_chain/permission/my_stakes). Highest-precedence lens over the role, industry and persona defaults; unknown facet ids are ignored.",
-          "type": "object",
-          "propertyNames": {
-            "type": "string"
-          },
-          "additionalProperties": {
-            "type": "object",
-            "properties": {
-              "visible": {
-                "description": "Hide the facet from the returned items (default visible).",
-                "type": "boolean"
-              },
-              "order": {
-                "description": "Explicit reading-order rank.",
-                "type": "integer",
-                "exclusiveMinimum": 0,
-                "maximum": 9007199254740991
-              },
-              "weight": {
-                "description": "Facet emphasis — distributed to bound rules by document-default proportions (single scoring channel).",
-                "type": "number",
-                "minimum": 0
-              },
-              "threshold": {
-                "description": "Card-highlight hint only; never an engine gate.",
-                "type": "number",
-                "minimum": 0,
-                "maximum": 100
-              }
-            },
-            "additionalProperties": false
-          }
-        },
-        "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"
-            ]
-          }
-        },
-        "event_edges": {
-          "description": "Event-derived history edges to expand (channel D, append-only streams, windowless). Default: none (events are opt-in only). 'service.order_history' walks the shop's complete NewOrderEvent stream (beyond the FIFO 5200 shop-order window); 'eoa.order_history' the orders the account created as transacting buyer; 'arb.history' every dispute case an arbitration service handled. Page-budget truncation is reported (windowed confidence), never silent.",
-          "type": "array",
-          "items": {
-            "type": "string",
-            "enum": [
-              "service.order_history",
-              "eoa.order_history",
-              "arb.history"
-            ]
-          }
-        },
-        "schema_hops": {
-          "description": "Per-edge-schema traversal caps: how many times an edge of this schema may be crossed on any seed→object path, e.g. {'guard.relies':1}. Only narrows contract-level caps; 0 blocks the schema entirely. Unknown schema ids and out-of-range values are dropped (reported in strategy.trace).",
-          "type": "object",
-          "propertyNames": {
-            "type": "string"
-          },
-          "additionalProperties": {
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 8
-          }
-        },
-        "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."
-    }
-  ]
-}
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://wowok.net/schemas/query_toolkit.json","title":"Data Query Toolkit","description":"Query local and on-chain data","oneOf":[{"type":"object","properties":{"query_type":{"type":"string","const":"local_mark_list"},"filter":{"description":"Local mark filter","type":"object","properties":{"name":{"description":"Filter by mark name (supports fuzzy match)","type":"string"},"tags":{"description":"Filter by tags - returns marks that contain ANY of the specified tags","type":"array","items":{"type":"string"}},"address":{"description":"Filter by address (exact match, format: 0x + 64 hex characters)","type":"string"},"createdAt":{"description":"Filter by creation time range","type":"object","properties":{"gte":{"description":"Filter marks created on or after this timestamp (ms)","type":"number"},"lte":{"description":"Filter marks created on or before this timestamp (ms)","type":"number"}},"additionalProperties":false},"updatedAt":{"description":"Filter by update time range","type":"object","properties":{"gte":{"description":"Filter marks updated on or after this timestamp (ms)","type":"number"},"lte":{"description":"Filter marks updated on or before this timestamp (ms)","type":"number"}},"additionalProperties":false}},"additionalProperties":false}},"required":["query_type"],"additionalProperties":false,"description":"Query your LOCAL address book — maps human-readable names to blockchain addresses with optional tags. Use to resolve names→addresses or find addresses by tag. Returns: MarkData[] (name, address, tags, timestamps)"},{"type":"object","properties":{"query_type":{"type":"string","const":"account_list"},"filter":{"description":"Account filter","type":"object","properties":{"name":{"description":"Filter by account name (supports fuzzy match)","type":"string"},"address":{"description":"Filter by account address (supports partial match, format: 0x + hex characters)","type":"string"},"suspended":{"description":"Filter by suspension status. Omit to return all accounts regardless of status","type":"boolean"},"hasMessenger":{"description":"Filter accounts with messenger enabled","type":"boolean"},"createdAt":{"description":"Filter by creation time range","type":"object","properties":{"gte":{"description":"Filter accounts created on or after this timestamp (ms)","type":"number"},"lte":{"description":"Filter accounts created on or before this timestamp (ms)","type":"number"}},"additionalProperties":false},"updatedAt":{"description":"Filter by update time range","type":"object","properties":{"gte":{"description":"Filter accounts updated on or after this timestamp (ms)","type":"number"},"lte":{"description":"Filter accounts updated on or before this timestamp (ms)","type":"number"}},"additionalProperties":false},"includePubkey":{"description":"Include pubkey in results (default: false). Pubkey is large (~900 bytes), omit unless needed","type":"boolean"}},"additionalProperties":false},"no_cache":{"description":"Accepted for call-shape uniformity and IGNORED — account_list is a device-local read with no cache to bypass","type":"boolean"}},"required":["query_type"],"additionalProperties":false,"description":"Query your LOCAL accounts — view all accounts stored on this device (addresses, messenger status, suspension state). Use filter.includePubkey=true to also include public keys (~900 bytes each, omitted by default). Returns: AccountData[] (name, address, pubkey?, suspended, messenger, timestamps)"},{"type":"object","properties":{"query_type":{"type":"string","const":"local_info_list"},"filter":{"description":"Local info filter","type":"object","properties":{"name":{"description":"Filter by info name (supports fuzzy match)","type":"string"},"default":{"description":"Filter by default value (supports fuzzy match)","type":"string"},"contents":{"description":"Filter by contents - returns info that contains ANY of the specified content items","type":"array","items":{"type":"string"}},"createdAt":{"description":"Filter by creation time range","type":"object","properties":{"gte":{"description":"Filter info created on or after this timestamp (ms)","type":"number"},"lte":{"description":"Filter info created on or before this timestamp (ms)","type":"number"}},"additionalProperties":false},"updatedAt":{"description":"Filter by update time range","type":"object","properties":{"gte":{"description":"Filter info updated on or after this timestamp (ms)","type":"number"},"lte":{"description":"Filter info updated on or before this timestamp (ms)","type":"number"}},"additionalProperties":false}},"additionalProperties":false},"account":{"description":"Account partition to query (name or address). Local info is isolated per account; omit for the default account's partition.","type":"string"}},"required":["query_type"],"additionalProperties":false,"description":"Query your LOCAL private info — sensitive data like delivery addresses, phone numbers, contacts stored ONLY on this device. Use to retrieve saved contact/delivery details. Returns: InfoData[] (name, default value, contents, timestamps)"},{"type":"object","properties":{"query_type":{"type":"string","const":"token_list"},"filter":{"type":"object","properties":{"alias_or_name":{"description":"Alias or name filter","type":"string"},"symbol":{"description":"Token symbol","type":"string"},"type":{"description":"Token type","type":"string"}},"additionalProperties":false,"description":"Token data filter"}},"required":["query_type"],"additionalProperties":false,"description":"Query cached token metadata — symbol, decimals, icon URL, description for tokens previously fetched from chain. Use to look up token info without an on-chain query. Returns: TokenTypeInfo[] (type, alias, name, symbol, decimals, iconUrl)"},{"type":"object","properties":{"query_type":{"type":"string","const":"account_balance"},"name_or_address":{"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":{"description":"Set to true to query total balance amount for the token type","type":"boolean"},"coin":{"description":"Set to query paginated coin objects instead of balance. Use cursor/limit for pagination.","type":"object","properties":{"cursor":{"description":"Pagination cursor for listing coin objects","anyOf":[{"type":"string"},{"type":"null"}]},"limit":{"description":"Max coin objects per page","anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"token_type":{"description":"Token type in Move format: 0x<package>::<module>::<struct>. Examples: \"0x2::wow::WOW\" (default). For custom tokens, use the full type string from the token's coin metadata. The Fund Processing Layer resolves precision from the official registry → cache → on-chain.","type":"string"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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"]},"no_cache":{"description":"Accepted for call-shape uniformity and IGNORED — this query is always a live read; freshness provenance rides `_balance_read_freshness`","type":"boolean"}},"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 accepted but has no effect. The response carries `_balance_read_freshness` (fetched_at + note): figures CAN differ between reads taken moments apart (live F-RQ-12: the same wallet read 9.93 / 21.88 / 56.28 WOW on three consecutive calls) — reconcile via the coin page and prove arrival via the transaction digest, never off a single read. 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","properties":{"query_type":{"type":"string","const":"local_names"},"addresses":{"type":"array","items":{"type":"string"},"description":"Array of addresses to look up local names for"}},"required":["query_type","addresses"],"additionalProperties":false,"description":"Query local names (account name and local mark name) for a list of addresses. Returns array of: { account?: string, local_mark?: string, address: string }"},{"type":"object","properties":{"query_type":{"type":"string","const":"onchain_personal_profile"},"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":{"description":"Set to true to bypass cache and fetch fresh on-chain data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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"],"additionalProperties":false,"description":"Query any user's PUBLIC on-chain profile — social links, reputation (likes/dislikes), personal info records, voting history, referrer. Use to look up a user's public identity and reputation. Returns: ObjectPersonal | undefined"},{"type":"object","properties":{"query_type":{"type":"string","const":"onchain_objects"},"objects":{"type":"array","items":{"type":"string","description":"Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."},"description":"List of object IDs (names or addresses) to query in batch"},"winner_node":{"description":"Optional adjudication node name for the winner derivation (MN5-6R ③A): when passed, every queried Progress object derives `winner_derivation` — the first account whose forward completed entry into THIS node, computed purely from the append-only Progress history (the chain stores no winner field). When omitted, the Progress's current node is used as the adjudication node. No match → `winner_derivation: null` with a note (the order has not advanced into that node).","type":"string"},"no_cache":{"description":"Set to FALSE to allow the session cache; OMIT (or pass true) for a forced-fresh read. ⚠️ DEFAULT IS FRESH ON PURPOSE: a cached snapshot here reports a PRE-TRANSACTION value for exactly the fields an agent uses to decide whether money moved — on testnet this reported a stale `compensation_fund`, a stale `order.claimed_by`, and a stale `allocation.balance`. Only pass no_cache:false when you deliberately want a cheap repeat read of data you already know is current. The response carries `_read_freshness` (source live|session_cache, fetched_at) so a snapshot can never be mistaken for state.","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","objects"],"additionalProperties":false,"description":"Batch query on-chain WOWOK objects by ID or name — supports Service, Machine, Order, Treasury, Reward, Arb, Personal, Contact, and more. Use to inspect one or more objects in a single call. FORCED-FRESH by default (see no_cache) and the response includes `_read_freshness` provenance. Every queried Progress object additionally carries `_winner_derivation` (MN5-6R ③A): the first account whose forward completed entry into the adjudication node (`winner_node`, default = the Progress's current node), derived purely from the Progress history — null + note when the order has not advanced there. Returns: { objects: ObjectBase[], _read_freshness: { source, no_cache, fetched_at, note } }"},{"type":"object","properties":{"query_type":{"type":"string","const":"onchain_received"},"name_or_address":{"anyOf":[{"description":"Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"},{"type":"object","properties":{"name_or_address":{"type":"string","description":"Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."},"local_mark_first":{"description":"Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks","type":"boolean"}},"additionalProperties":false,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Name or address of the object that received payments/items - can be a string (name/address) or full object"},"type":{"description":"Type filter for querying received objects. - If undefined or null: query all types (equivalent to the old all_type=true). - If 'CoinWrapper': query CoinWrapper type for the object's token (equivalent to the old all_type=false). - If string: query specific StructType (e.g., '0x2::payment::CoinWrapper<0x2::wow::WOW>').","anyOf":[{"type":"string"},{"type":"string","const":"CoinWrapper"},{"type":"null"}]},"cursor":{"description":"Pagination cursor from previous page","anyOf":[{"type":"string"},{"type":"null"}]},"limit":{"description":"Max records per page","anyOf":[{"type":"number"},{"type":"null"}]},"no_cache":{"description":"Set to true to bypass cache and fetch fresh on-chain data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","name_or_address"],"additionalProperties":false,"description":"Query objects (Payments, Tokens, NFTs) received by a specific object. Use to track incoming payments or items sent to an on-chain object. Supports pagination and type filter. Returns: ReceivedBalance | ReceivedNormal[]"},{"type":"object","properties":{"query_type":{"type":"string","const":"onchain_transaction"},"digest":{"type":"string","description":"Transaction digest (0x...) to verify. Use after any on-chain operation to confirm what actually happened on-chain — object changes, balance changes, gas used, success/failure status. This is the 'OperationProof' primitive for the Verify step."},"no_cache":{"description":"Set to true to bypass cache and fetch fresh on-chain data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","digest"],"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: 'localnet' | 'mainnet' | '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":{"query_type":{"type":"string","const":"onchain_object_history"},"object":{"type":"string","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","anyOf":[{"type":"string"},{"type":"null"}]},"limit":{"description":"Max results per page (default 20, max 50)","anyOf":[{"type":"number"},{"type":"null"}]},"order":{"description":"Sort order: ascending=oldest first, descending=newest first (default)","anyOf":[{"type":"string","const":"ascending"},{"type":"string","const":"descending"}]},"no_cache":{"description":"Set to true to bypass cache and fetch fresh on-chain data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","object"],"additionalProperties":false,"description":"FORENSICS TOOL — query all transactions that touched an object. WARNING: this can lead to non-convergent queries (each tx touches more objects with their own history). For AI context building, use assemble_context instead — it extracts embedded history from object states (ProgressSession.forwards, etc.) without infinite recursion. This tool is for auditing/forensics only. Returns: TransactionHistoryAnswer | undefined"},{"type":"object","properties":{"query_type":{"type":"string","const":"onchain_last_updated"},"objects":{"type":"array","items":{"type":"string","description":"Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."},"description":"List of object IDs (names or addresses) to query in batch"},"no_cache":{"description":"Set to true to bypass cache and fetch fresh on-chain data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","objects"],"additionalProperties":false,"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","properties":{"query_type":{"type":"string","const":"onchain_address_activity"},"name_or_address":{"anyOf":[{"description":"Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"},{"type":"object","properties":{"name_or_address":{"type":"string","description":"Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."},"local_mark_first":{"description":"Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks","type":"boolean"}},"additionalProperties":false,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"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","anyOf":[{"type":"string"},{"type":"null"}]},"limit":{"description":"Max results per page (default 20, max 50)","anyOf":[{"type":"number"},{"type":"null"}]},"order":{"description":"Sort order: ascending=oldest first, descending=newest first (default)","anyOf":[{"type":"string","const":"ascending"},{"type":"string","const":"descending"}]},"no_cache":{"description":"Set to true to bypass cache and fetch fresh on-chain data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","name_or_address"],"additionalProperties":false,"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","properties":{"query_type":{"type":"string","const":"token_value_convert"},"token_type":{"type":"string","description":"Full token type in Move format: 0x<package>::<module>::<struct>. Examples: \"0x2::wow::WOW\" (9 decimals). The token's decimals drive the conversion — resolved from official registry → local cache → on-chain coin metadata."},"raw":{"description":"Raw smallest-unit value (u64, e.g. \"2200000000\") to convert TO a human unit value. Provide EXACTLY ONE of raw / unit.","anyOf":[{"type":"string"},{"type":"number"}]},"unit":{"description":"Human unit value (e.g. \"2.2\") to convert TO raw smallest units (u64). Provide EXACTLY ONE of raw / unit. Conversion is REFUSED when the token's decimals cannot be resolved (guessing would forge wrong on-chain values).","anyOf":[{"type":"string"},{"type":"number"}]},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","token_type"],"additionalProperties":false,"description":"Convert between raw on-chain smallest units (u64) and human unit values, in EITHER direction. Provide EXACTLY ONE of raw / unit (handler-validated). raw → unit: \"2200000000\" → \"2.2\" (pass-through when precision unknown). unit → raw: \"2.2\" → \"2200000000\" (REFUSED when precision unknown — never guesses decimals). Use this before displaying chain values to users, and before entering amounts for on-chain operations. Returns: { token_type, symbol?, decimals?, precision_known, direction, input, output, error?, text }"},{"type":"object","properties":{"query_type":{"type":"string","const":"address_profile"},"address":{"anyOf":[{"description":"Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"},{"type":"object","properties":{"name_or_address":{"type":"string","description":"Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."},"local_mark_first":{"description":"Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks","type":"boolean"}},"additionalProperties":false,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"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: 'localnet' | 'mainnet' | '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","address"],"additionalProperties":false,"description":"Unified address profile (K3 22 §P0-1): classifies the address (user / business-object type / system singleton), then batches identity + reputation (like/dislike/favor) + order membership + contact membership + permission membership + core/tx reverse bindings + the object itself into a single result. The one-stop entry for 'who/what is this address'. For Service addresses the result also merges a service_analysis block (description / payment token / shelf split / location / trust-risk / on-chain last update). Returns: AddressProfile"},{"type":"object","properties":{"query_type":{"type":"string","const":"address_profiles"},"addresses":{"minItems":1,"maxItems":50,"type":"array","items":{"anyOf":[{"description":"Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"},{"type":"object","properties":{"name_or_address":{"type":"string","description":"Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."},"local_mark_first":{"description":"Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks","type":"boolean"}},"additionalProperties":false,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Account or address lookup. Can be a simple string (recommended for AI) or full object with explicit local_mark_first control. String form auto-converts to { name_or_address: <string>, local_mark_first: true }."},"description":"Addresses to profile in ONE batch (the list form of address_profile — prefer this over N single-address calls in list views). Each entry supports string (name/address) or object form; LocalMark names are resolved automatically. Result order matches the request order; a per-address failure yields a null slot (never rejects the whole batch)."},"no_cache":{"description":"Set to true to bypass cache and fetch fresh on-chain data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","addresses"],"additionalProperties":false,"description":"BATCH unified address profiles: one call for up to 50 addresses instead of N single-address round-trips. Each non-null entry carries the SAME shape as address_profile (classification + identity + reputation votes + order/contact/permission memberships + core/tx reverse bindings + the object + activity + role evidence), including the merged service_analysis block for Service addresses. Use for list views that need profiles for many rows at once. Returns: (AddressProfile | null)[]"},{"type":"object","properties":{"query_type":{"type":"string","const":"service_supply_chain"},"address":{"anyOf":[{"description":"Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"},{"type":"object","properties":{"name_or_address":{"type":"string","description":"Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."},"local_mark_first":{"description":"Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks","type":"boolean"}},"additionalProperties":false,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Service address whose transparent sub-order purchasing graph to resolve. Supports string (name/address) or object form. LocalMark names are resolved automatically."},"no_cache":{"description":"Set to true to bypass cache and fetch fresh on-chain data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | '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","address"],"additionalProperties":false,"description":"Resolve a Service's transparent sub-order purchasing graph (K3 23 §3.6): reads the bound Machine's frozen forwards, finds purchasing-commitment Guards, and returns each forward's purchased sub-services (fixed address fields) + required sub-order proof fields (b_submission fields). Standalone capability for buyer due-diligence / compose_service / anti_cheat / merchant self-check; reused by Watch. Returns: SupplyChainGraph"},{"type":"object","properties":{"query_type":{"type":"string","const":"recover_created_objects"},"label":{"anyOf":[{"description":"Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"},{"type":"object","properties":{"name_or_address":{"type":"string","description":"Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."},"local_mark_first":{"description":"Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks","type":"boolean"}},"additionalProperties":false,"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. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."}],"description":"Account name or address (0x...) whose recovery state to assemble — the SENDER of the timed-out call (a submission_unknown / timeout envelope names it in the verification header or submission_verification.sender). Supports string or object form; LocalMark names are resolved automatically."},"op":{"description":"Filter the in-flight markers by operation name: 'order_new' (order creation), 'alloc_by_guard' (distribution), or an operation_type like 'payment', 'reward', 'guard'. Omit to list every open marker.","type":"string"},"limit":{"description":"Max returned-digest and activity entries (default 20).","type":"integer","minimum":1,"maximum":50},"no_cache":{"description":"Set to true to bypass the on-chain activity cache and fetch fresh data","type":"boolean"},"network":{"description":"Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used.","type":"string","enum":["localnet","testnet","mainnet"]}},"required":["query_type","label"],"additionalProperties":false,"description":"RECOVERY TOOL — assemble in ONE call everything needed to recover objects after a TIMED-OUT or lost-response write (W5-09, the official form of the ad-hoc recovery script). Joins three sources: (1) in-flight markers this process still holds OPEN — operations whose commit state was never observed (each carries op, target service/allocation, buyer, item count, started_at, any transport-reported digests); (2) digests this process recently RETURNED as executed receipts; (3) the account's on-chain sent-activity in the failure window. Decision rule: a marker whose digest resolves to an executed transaction → ADOPT its created objects and stop; activity shows the operation landed → adopt; markers exist but nothing on-chain → the state stayed open, a corrected resubmit is allowed; nothing anywhere → nothing landed from THIS process (other sessions/devices may still hold state — the chain remains the only truth). Returns: { label, resolved_address?, inflight_markers[], returned_digests[], landed_tombstones[], onchain_activity?, recovery_guidance }"},{"type":"object","properties":{"query_type":{"type":"string","const":"service_panorama"},"object_address":{"description":"On-chain Service object address (or LocalMark name). Required when query_type='service_panorama'. PREFERRED field name — the panorama family (service/machine/object) is unified on `object_address` (a Service IS an on-chain object); `service_address` remains accepted as a deprecated alias.","type":"string"},"service_address":{"description":"DEPRECATED alias of object_address (accepted for call compatibility). Prefer object_address. Example: {\"query_type\": \"service_panorama\", \"object_address\": \"0xabc...\"}.","type":"string"},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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":["query_type"],"additionalProperties":false,"description":"ONE-CALL full business-intelligence context of an on-chain Service (K3 22 / Business Service tab): base data + machine workflow graph + buy_guard/permission/allocator guards + related objects + supply chain + deterministic BusinessReport + recent orders. Every section degrades gracefully — failures are reported in `data_gaps`. Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"service_quote"},"object_address":{"description":"On-chain Service object address (or LocalMark name). Required when query_type='service_quote'. PREFERRED field name — unified with the panorama family on `object_address`; `service_address` remains accepted as a deprecated alias.","type":"string"},"service_address":{"description":"DEPRECATED alias of object_address (accepted for call compatibility). Prefer object_address. Example: {\"query_type\": \"service_quote\", \"object_address\": \"0xabc...\"}.","type":"string"},"items":{"description":"Basket to quote. Omit to quote EVERY sale with quantity 1 (the floor basket — order quantity is chosen at buy time, so per-unit prices are the authoritative input). Each item names its sale via `name` (exact literal) or `sale_id` (0-based index) — exactly one.","type":"array","items":{"type":"object","properties":{"name":{"description":"Sale name exactly as configured on the Service. Required unless sale_id is given.","type":"string"},"sale_id":{"description":"0-based index of the sale in the Service's configured sales list (same enumeration the buy tool accepts). Required unless name is given.","type":"integer","minimum":0,"maximum":9007199254740991},"quantity":{"default":1,"description":"Units of this item in the basket (default 1).","type":"integer","exclusiveMinimum":0,"maximum":10000}},"required":["quantity"],"additionalProperties":false}},"discount":{"description":"C-10: Discount (coupon) object address or LocalMark name to price the basket WITH. Without it the quote is always the UNDISCOUNTED total, so a discounted buyer cannot compute the exact total_pay that order_new requires (it must equal the order total precisely — any drift aborts with E_COIN_NOT_ENOUGH). RATES subtracts total*off/10000; MINUS/FIXED subtracts min(total, off), mirroring the on-chain rule with integer floor division. Read-only: quoting does NOT consume the coupon.","anyOf":[{"type":"string"},{"type":"null"}]},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."},"no_cache":{"description":"A-5 freshness control, same convention as the panorama family (DEFAULT TRUE = read fresh, bypass the object cache). A quote that feeds an exact total_pay must never come from a stale cache — pass false only for high-frequency polling.","type":"boolean"},"buyer":{"description":"Prospective buyer address (or LocalMark name) — the per-buyer-cap probe subject. Required only for the per_buyer_cap check; the rest of the quote is buyer-independent.","type":"string"},"per_buyer_cap":{"description":"Merchant-declared per-buyer purchase cap (max predicate-matching rows per buyer under the cap key; template fee_params per_buyer_cap; UNSET/absent = unlimited — no cap check runs). Advisory PRE-ORDER disclosure only: the on-chain purchase entry has NO cap hook yet (buy pre-hook pending a separate board decision) — the chain itself will not refuse an over-cap buy today.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"per_buyer_cap_repository":{"description":"Repository object address (or LocalMark name) whose per-key ledger the cap counts against (e.g. the group-buy Round Repository). Required for the per_buyer_cap check.","type":"string"},"per_buyer_cap_key":{"description":"Repository policy key the cap counts under (e.g. the campaign contribution key). Required for the per_buyer_cap check.","type":"string"}},"required":["query_type"],"additionalProperties":false,"description":"READ-ONLY pre-purchase quote of a Service (finding 3.6 — order_new total_pay pre-check): per-item unit price × quantity, the basket total that order_new.buy.total_pay.balance must exactly equal (the on-chain buy aborts on any drift), and the order_allocators fee-split preview (sharing rows of the FIRST allocator — the normal payout path; guards select per-case allocators such as refund/damage, so the live split depends on which guard passes). Also previews the reward terms of every Reward hung on the Service (pool balance, per-claim amount, claim window) so a buyer never budgets on an expired or unfunded reward. Mirrors the on-chain price×quantity semantics WITHOUT calling quote on-chain and NEVER submits a transaction. Amounts are payment-token smallest units plus a human display when the token precision resolves."},{"type":"object","properties":{"query_type":{"type":"string","const":"machine_panorama"},"object_address":{"description":"On-chain object address (0x followed by 32-64 hex chars). Also accepts a LocalMark NAME (resolved automatically). H-06 fix: invalid formats are rejected at the handler level with a descriptive error.","type":"string"},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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":["query_type"],"additionalProperties":false,"description":"ONE-CALL panorama of an on-chain Machine (Business Machine tab; Machine counterpart of service_panorama): head (name/tags/description/published/paused) + the Machine's own fields (permission/um/node_count/consensus repositories) + workflow graph (nodes/edges/forwards) + Progress list from the GLOBAL tx table (0xaaf, Machine address as KEY). Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"object_panorama"},"object_address":{"description":"On-chain object address (0x followed by 32-64 hex chars) for object_panorama. Also accepts a LocalMark NAME (resolved automatically). H-06 fix: invalid formats are rejected at the handler level with a descriptive error. F27 (gf32-mn-261103): `object` is accepted as an alias too — the write faces all take `object`, so a driver reusing one helper for reads and writes no longer trips on the key name.","type":"string"},"object":{"description":"ALIAS of object_address (accepted for write-face key compatibility — every write tool takes `object`). Prefer object_address on query calls. Example: {\"query_type\": \"object_panorama\", \"object\": \"0xabc...\"}.","type":"string"},"filter":{"description":"DEPRECATED alias of object_address (accepted for call compatibility; must be a plain address or LocalMark NAME string, not an object). Prefer object_address. Example: {\"query_type\": \"object_panorama\", \"object_address\": \"0xabc...\"}.","type":"string"},"wts_file_path":{"description":"Proof objects only: local path to the .wts evidence packet to cross-check against this anchor. Returns wts_anchor_check — whether the packet's message roots match the frozen root, whether the server key matches, and whether the Proof predates the packet (a frozen Proof is what makes WTS content non-re-fabricable after the fact).","type":"string"},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."},"no_cache":{"description":"A-5 freshness control (amz9-ln-261023). DEFAULT TRUE: the panorama primary read bypasses the object cache and reads the chain state fresh — a post-write panorama (confirm, forward, claim, refund) must never show pre-write cache (the F-L02/F-L10 stale-after-confirm failure made agents re-confirm and misread terminal states). Pass false to opt back into the cached read for high-frequency polling where a few seconds of staleness is acceptable.","type":"boolean"}},"required":["query_type"],"additionalProperties":false,"description":"ONE-CALL detail-page panorama for Progress / Demand / Order / Allocation / Arb / Repository / Proof objects (client panorama family): discriminated `object_type` + head (name/tags/description) + the object's own typed fields + type-specific extras (Demand presenters from the GLOBAL tx table, Progress session/forwards, Order fund state, Allocation pool balance + per-rail resolved recipients + Payment children, Arb votes & propositions, Repository policies, Proof anchored root + WTS cross-check). Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"review_pack"},"object_address":{"description":"On-chain object address (0x followed by 32-64 hex chars) for review_pack. Also accepts a LocalMark NAME (resolved automatically). H-06 fix: invalid formats are rejected at the handler level with a descriptive error.","type":"string"},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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":["query_type"],"additionalProperties":false,"description":"ONE-CALL typed ReviewPack for the client's generic ReviewPackRenderer (K3 24 §5.2 / G3) — section list + typed field values; the UI-convention defaults live in the renderer, the section composition lives in the MCP assembler. Runs the matching panorama (one chain-query pass) and reshapes it. Supported types: Order, Service, Arb, Demand, Repository, Progress, Machine. Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"assemble_context"},"context_objects":{"description":"Object IDs (0x...) or LocalMark names to assemble context for. Required when query_type='assemble_context'. The current on-chain state of each object will be queried and enriched with semantic annotations.","type":"array","items":{"type":"string"}},"include_events":{"description":"When true, assemble_context also queries recent state-transition events (NewOrderEvent, ProgressEvent, ArbEvent, etc.). Events are the real-time transition log — convergent and bounded. Defaults to false. Note: object-embedded history (ProgressSession.forwards, Order.disputes) is ALWAYS extracted automatically — no flag needed.","type":"boolean"},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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).","type":"integer","minimum":0,"maximum":5},"context_include":{"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.","type":"array","items":{"type":"string"}}},"required":["query_type"],"additionalProperties":false,"description":"Semantic context assembly (GLM5 §6, Layer 3): query on-chain object states + extract embedded history + optional events + optional BFS dependency expansion, and assemble a structured context for LLM consumption. Required: context_objects (array of object IDs/names). Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"reverse_map"},"context_objects":{"description":"Object IDs (0x...) or LocalMark names to feed into the report. Required when query_type='reverse_map' (include the Service; add Machine/Allocation for refund-path detection).","type":"array","items":{"type":"string"}},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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.","type":"string"}},"required":["query_type"],"additionalProperties":false,"description":"Deterministic L4→L1 business report (K3 03 reverse lane; no LLM): queries the objects, classifies into business semantics, emits merchant profile + user risk assessment + game-theory analysis. Same objects ALWAYS yield the same report. Required: context_objects (include the Service; add Machine/Allocation for refund-path detection). Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"participation_radar"},"radar_account":{"description":"Account to analyze — address (0x...) or LocalMark name (resolved to an address). Required when query_type='participation_radar'. The perspective (customer/operator/observer) is DERIVED from on-chain data (Order.builder + PermissionPerm grants) — never asserted by this field.","type":"string"},"radar_targets":{"description":"In-flight orders to analyze (1-20). Required when query_type='participation_radar'. Each target is analyzed independently; results are aggregated into one account dashboard.","minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"progress":{"type":"string","description":"Progress object address (0x...) or LocalMark name. The Progress carries the current node + bound Machine."},"order":{"description":"Order object address or LocalMark name (optional but recommended — enables order-holder detection, service-level compensation/reward claims, and dispute context).","type":"string"}},"required":["progress"],"additionalProperties":false}},"radar_include_alerts":{"description":"Attach order-monitor alerts (progress stall / compensation fund / review & arbitration windows) to each per-order result. Default true.","type":"boolean"},"radar_review_summary":{"description":"Merchant-side review coverage summary (REVIEW-COMPONENT-PLAN batch 4): completed orders vs orders with a structured review record. Review rows live in a caller-named Repository — gather both counts via onchain_table_data (repository rows under the 'review' key, order-keyed → one row per order, F09) and pass them in; the radar derives the merchant-side review-rate hint (high missing rate with a reward attached → reward lapsed or window too short). Omit when no review repository is bound.","type":"object","properties":{"orders_completed":{"type":"integer","minimum":0,"maximum":9007199254740991},"reviews_written":{"type":"integer","minimum":0,"maximum":9007199254740991},"reward_bound":{"type":"boolean"}},"required":["orders_completed","reviews_written"],"additionalProperties":false},"radar_monitor_thresholds":{"description":"Optional per-call overrides for order-monitor alert thresholds (only used when radar_include_alerts is on). All fields optional; omitted fields keep defaults. Units: hours/days as marked per field.","type":"object","properties":{"progress_stall_hours":{"description":"Progress stall alert threshold in HOURS. Default 0 = auto (expected_node_duration × 2).","type":"number","exclusiveMinimum":0},"compensation_drop_ratio":{"description":"Compensation fund drop alert ratio (0-1). Default 0.3 = alert on ≥30% drop.","type":"number","minimum":0,"maximum":1},"compensation_coverage_min":{"description":"Minimum compensation coverage ratio vs order amount (0-1). Default 1.0 = must fully cover.","type":"number","minimum":0,"maximum":1},"messenger_timeout_hours":{"description":"Messenger no-reply timeout in HOURS. Default 24.","type":"number","exclusiveMinimum":0},"review_window_closing_days":{"description":"Review window near-closing alert threshold in DAYS. Default 3.","type":"number","exclusiveMinimum":0},"arb_window_closing_days":{"description":"Arbitration window near-closing alert threshold in DAYS. Default 3.","type":"number","exclusiveMinimum":0}},"additionalProperties":false},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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":["query_type"],"additionalProperties":false,"description":"In-flight order participation analysis for ONE account (GLM6/94): customer / operator / observer perspective derived from on-chain permission matching (never caller-asserted) — per-order operable forwards (branch choices), waiting_on roles, pending claims (reward/discount/compensation/rating), perspective-specific interest hints, aggregated account dashboard. Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"order_aggregate"},"group":{"description":"Grouping dimension, read from each Order's own fields: 'service' (default — the crowd/group-buy pool per service), 'machine' (per workflow) or 'owner' (per ordering account).","type":"string","enum":["service","machine","owner"]},"group_id":{"description":"Restrict the aggregation to ONE group value (exact address match — e.g. the Service address running a crowd-funding campaign). The funding-target verdict then reads a single row.","type":"string"},"metric":{"description":"Numeric field to sum (default 'amount' — the Order's escrowed payment in smallest units).","type":"string","const":"amount"},"exclude_claimed":{"description":"Exclude orders whose compensation has been claimed (claimed_by set). Default false — pass true so refund/compensation payouts are not double-counted toward a target.","type":"boolean"},"limit":{"description":"Max group rows returned (default 50, max 1000). truncated flags rows beyond the limit; totals ALWAYS cover the full set regardless of the limit.","type":"integer","minimum":1,"maximum":1000},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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":["query_type"],"additionalProperties":false,"description":"CROSS-ORDER aggregate over Order objects from the MCP index projection (S17-C / F-RQD2-06): count + exact amount sums per group, with the projection's reconciliation coverage attached. Read-side stand-in for the missing on-chain cross-order primitive — crowd/group-buy targets like '3 x 6 WOW >= 18 WOW before funding' are checked HERE until the protocol grows a native aggregate. A STALE projection refuses to answer loudly (INDEX_STALE_PROJECTION — no legacy fallback can aggregate) instead of serving a funding verdict on old data. Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"relationship_profile"},"radar_account":{"description":"Anchor account to analyze — address (0x...) or LocalMark name. Required when query_type='relationship_profile'. ANY distributed account works (not only local accounts): the anchor is just an address; all relationships derive from on-chain power carriers.","type":"string"},"relation_kinds":{"description":"Filter to specific relationship kinds (default: all). employment = merchant × staff (principal-agent); process_operation = machine node operators; agency = order owner × agents; transaction = customer × merchant; supply = demander × presenters; arbitration_delegation = service owner × arbitrators; dispute_resolution = arbitrator × disputants; value_distribution = payer × allocation recipients; contact_membership = communication channel members.","type":"array","items":{"type":"string","enum":["employment","process_operation","agency","transaction","supply","arbitration_delegation","dispute_resolution","value_distribution","contact_membership"]}},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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":["query_type"],"additionalProperties":false,"description":"Business Relationship Graph (K3/19): derive ONE account's full relationship web from on-chain power carriers (Permission memberships, Machine forwards, Orders, Demand presenters, Allocation sharing, Arbitration bindings, Contact ims). Each edge carries the three dimensions — power (what each side CAN do, and where that power lives on-chain), interest (gains/exposures, with registry-declared goal tensions like principal-agent divergence), and value flows (escrow → allocation → payment chains). Read-only; roles are DERIVED from chain data, never asserted."},{"type":"object","properties":{"query_type":{"type":"string","const":"scenario_topology"},"chain_id":{"description":"Optional scenario-chain id (chain.standard_ecommerce | chain.procurement_tender | chain.data_subscription | chain.collaborative_operations). When given, only that chain is returned; otherwise ALL scenario chains + bridges are returned.","type":"string"}},"required":["query_type"],"additionalProperties":false,"description":"Scenario Topology knowledge (K3 03 §3.5 / Part 2): the STATIC registry of how WoWok objects INTEGRATE each other. Bridges weld object pairs into a capability that belongs to no single object (e.g. Demand.present(service) grants MATCHMAKING); chains compose bridges into whole applications (e.g. standard e-commerce, procurement tender). Pure knowledge, read-only — no on-chain reads. Use to explain HOW a business scenario is assembled from on-chain objects and why the integration (not the objects themselves) yields the capability."},{"type":"object","properties":{"query_type":{"type":"string","const":"workspace_lists"},"no_cache":{"description":"Set to true to bypass both the aggregation cache and the SDK chain-read cache.","type":"boolean"},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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.","type":"string"},"light":{"description":"Set to true for the fast first-paint phase: rows carry address / type / name / time only, skipping the per-object enrichment (dead-object probe, registrar votes, per-family extras). Used for progressive list loading; the client merges the full result afterwards.","type":"boolean"}},"required":["query_type"],"additionalProperties":false,"description":"ONE-CALL workspace object lists for ONE account (client Quick Access workspace buckets) — pass `account` to scope to the current account; omit to aggregate across ALL local accounts: treasuries / repositories / contacts / machines / rewards come from the unified permission reverse chain (account → EntityPermission @0xaad → permission-keyed ObjectLinkerCore @0xaae, the ONE source every permission-bearing object family writes to) plus account-keyed EntityContact memberships (@0xaa9) for contacts; others = account-keyed ObjectLinkerTx (@0xaaf) touches, deduplicated, minus all classified business types. Each item: object address + type + local name + time. Aggregation result is TTL-cached (120s, keyed by network + account). Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"marks_of_account"},"no_cache":{"description":"Set to true to bypass both the aggregation cache and the SDK chain-read cache.","type":"boolean"},"context_network":{"type":"string","enum":["testnet","mainnet","localnet"],"description":"Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). 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.","type":"string"},"light":{"description":"Set to true for the fast first-paint phase: rows carry address / type only (vote_kinds is empty until the full result), skipping the per-target registrar-vote reads + object enrichment. Used for progressive list loading; the client merges the full result afterwards.","type":"boolean"}},"required":["query_type"],"additionalProperties":false,"description":"Like / Favor list for ONE account (client Quick Access 'Like / Favor' tab) — every address (object OR plain user) the account has EVER liked / disliked / favored, deduplicated, with the CURRENT active vote kinds per target. Deterministic source: the voter's own Resource mark table, cross-read with the target's EntityLinker votes for the 'marked at' clock. Fully-toggled-off targets are dropped. Each row: address + tags (like/dislike/favor) + time + object_type (null = plain user) + local name / description / tags. Aggregation result is TTL-cached (120s, keyed by network + account). Read-only."},{"type":"object","properties":{"query_type":{"type":"string","const":"migration_preflight"},"no_cache":{"description":"Set to true to bypass the SDK chain-read cache.","type":"boolean"},"account":{"type":"string","description":"Account address (or name) to check. Required when query_type='migration_preflight'."},"source_network":{"description":"Source network to detect an existing build (default 'testnet').","type":"string","enum":["testnet","mainnet","localnet"]},"target_network":{"description":"Target network for the migration (default 'mainnet').","type":"string","enum":["testnet","mainnet","localnet"]}},"required":["query_type","account"],"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 — THIS field is `context_network` (the query tools accept no separate `network` key). 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 (interest-assessment stakes + node-game actions + counterparties + risk reminders) 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"]},"facets":{"description":"Per-call facet overrides keyed by the ten facet ids (fund_safety/reputation/arbitration/fulfillment/offering_price/workflow/fund_flow/supply_chain/permission/my_stakes). Highest-precedence lens over the role, industry and persona defaults; unknown facet ids are ignored.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"visible":{"description":"Hide the facet from the returned items (default visible).","type":"boolean"},"order":{"description":"Explicit reading-order rank.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"weight":{"description":"Facet emphasis — distributed to bound rules by document-default proportions (single scoring channel).","type":"number","minimum":0},"threshold":{"description":"Card-highlight hint only; never an engine gate.","type":"number","minimum":0,"maximum":100}},"additionalProperties":false}},"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"]}},"event_edges":{"description":"Event-derived history edges to expand (channel D, append-only streams, windowless). Default: none (events are opt-in only). 'service.order_history' walks the shop's complete NewOrderEvent stream (beyond the FIFO 5200 shop-order window); 'eoa.order_history' the orders the account created as transacting buyer; 'arb.history' every dispute case an arbitration service handled. Page-budget truncation is reported (windowed confidence), never silent.","type":"array","items":{"type":"string","enum":["service.order_history","eoa.order_history","arb.history"]}},"schema_hops":{"description":"Per-edge-schema traversal caps: how many times an edge of this schema may be crossed on any seed→object path, e.g. {'guard.relies':1}. Only narrows contract-level caps; 0 blocks the schema entirely. Unknown schema ids and out-of-range values are dropped (reported in strategy.trace).","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":8}},"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."}]}