@wowok/agent-mcp 3.0.3 → 3.0.5

package/dist/schemas/onchain_operations_personal.schema.json

@@ -962,8 +962,17 @@
           "type": "boolean"
         },
         "dry_run": {
-          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [

package/dist/schemas/onchain_operations_progress.schema.json

@@ -385,8 +385,17 @@
           "type": "boolean"
         },
         "dry_run": {
-          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [

package/dist/schemas/onchain_operations_proof.schema.json

@@ -171,8 +171,17 @@
           "type": "boolean"
         },
         "dry_run": {
-          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [

package/dist/schemas/onchain_operations_repository.schema.json

@@ -144,7 +144,7 @@
                           "additionalProperties": false,
                           "description": "Guard object that needs verification when writing policy"
                         },
-                        "description": "Guard object list that can be verified when writing data"
+                        "description": "Guard object list that can be verified when writing data. REQUIRED (non-empty) when id_from is 0/None (chain abort 22); optional when id_from is Clock/Signer."
                       },
                       "quote_guard": {
                         "description": "Guard object ID that needs verification when referencing this policy data on-chain (e.g., verifying if user has paid subscription). If null, no verification is needed for on-chain references. The Guard must have empty 'relies' field and 'rep' field true.",
@@ -637,7 +637,7 @@
                         "description": "Data item list."
                       },
                       "write_guard": {
-                        "description": "Guard ID or name. Used to specify the policy write permissions and rules corresponding to this Guard.",
+                        "description": "Guard ID or name. REQUIRED for data_add items when the matching policy uses id_from=None(0): it must reference one of that policy's write_guard guards, otherwise the chain aborts with 22 (E_POLICY_WRITE_GUARD_REQUIRED). Optional for Clock/Signer policies.",
                         "type": "string"
                       }
                     },
@@ -723,7 +723,7 @@
                         "description": "Data item ID list."
                       },
                       "write_guard": {
-                        "description": "Guard ID or name. Used to verify permission to delete data.",
+                        "description": "Guard ID or name. REQUIRED for data_remove items when the matching policy uses id_from=None(0); optional for Clock/Signer policies.",
                         "type": "string"
                       }
                     },
@@ -1012,8 +1012,17 @@
           "type": "boolean"
         },
         "dry_run": {
-          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [

package/dist/schemas/onchain_operations_reward.schema.json

@@ -589,8 +589,17 @@
           "type": "boolean"
         },
         "dry_run": {
-          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [

package/dist/schemas/onchain_operations_service.schema.json

@@ -1464,8 +1464,17 @@
           "type": "boolean"
         },
         "dry_run": {
-          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [

package/dist/schemas/onchain_operations_treasury.schema.json

@@ -945,8 +945,17 @@
           "type": "boolean"
         },
         "dry_run": {
-          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [

package/dist/schemas/onchain_table_data.output.json

@@ -5997,6 +5997,36 @@
                       "additionalProperties": false,
                       "description": "Role evidence derived from the address's on-chain facts (K3 22 §13 P1-7)."
                     },
+                    "follow_ups": {
+                      "description": "Guided follow-ups (INTERACTION FLOOR: always at least 2). Data-driven probes first (permission organizations / order footprint when memberships exist), generic relation probes (public personal profile / reverse map / recent activity) fill up to the floor. Present at least two, numbered, so the user can answer with one short reply.",
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "label": {
+                            "type": "string",
+                            "description": "Short label of the guided follow-up probe."
+                          },
+                          "detail": {
+                            "description": "One line on what the probe answers.",
+                            "type": "string"
+                          },
+                          "call": {
+                            "type": "object",
+                            "propertyNames": {
+                              "type": "string"
+                            },
+                            "additionalProperties": {},
+                            "description": "READY-TO-RUN query_toolkit arguments for this probe — present it to the user so a single short reply runs it."
+                          }
+                        },
+                        "required": [
+                          "label",
+                          "call"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
                     "service_analysis": {
                       "description": "Service-type analysis merged into the address profile (present for Service addresses).",
                       "anyOf": [
@@ -9520,6 +9550,160 @@
           ],
           "additionalProperties": false,
           "description": "Cross-network build detection + mainnet customization preflight (first-touch migration): detect whether the account has already built Services/Machines/etc. on the source network (default testnet), report the same on the target network (default mainnet), and return a business-facing checklist of the key settings to confirm/change when migrating — payment token, location, arbitration, WIP, gas. Read-only."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_topology"
+            },
+            "focus": {
+              "description": "Seed of the topology — an on-chain address (EOA 0x00… or any object 0x10..0x24/0xf1) or a LocalMark name (resolved automatically). Required when query_type='onchain_topology'. The read-side topology kernel expands OUTWARD from this seed over the machine-readable EdgeSchema: holder fields, global reverse indexes (orders/permissions/bindings/votes), Machine node tables (the workflow graph) and derived money-flow edges.",
+              "type": "string"
+            },
+            "context_network": {
+              "type": "string",
+              "enum": [
+                "testnet",
+                "mainnet",
+                "localnet"
+              ],
+              "description": "Network for the query. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode."
+            },
+            "intent": {
+              "description": "SEMANTIC exploration strategy (G3) — what this topology call is trying to establish. Deterministically shapes the edge whitelist, per-family depth caps and budget: full_map=complete structural map; order_health=order lifecycle+completion+disputes; fund_flow=payments+allocation waterfall+guard-gated splits; workflow=Machine node graphs+transitions+progress; counterparty=who is on the other side (buyer/seller/agents/operators); reputation=votes+arbitration record+contacts; permission=permission groups+bindings+entity tables; supply_chain=multi-leg allocation/sub-order settlement; arbitration=dispute cases+voters; demand_match=demand presenters+guards+rewards. When omitted, defaults come from the persona system (role default intents < account persona preference), then industry templates; every applied layer is reported in result.strategy.trace.",
+              "type": "string",
+              "enum": [
+                "full_map",
+                "order_health",
+                "fund_flow",
+                "workflow",
+                "counterparty",
+                "reputation",
+                "permission",
+                "supply_chain",
+                "arbitration",
+                "demand_match"
+              ]
+            },
+            "role": {
+              "description": "Identity lens for the default strategy: the persona role whose default intents and RoleProfile.topology preference drive the exploration when 'intent' is omitted (e.g. prospect → counterparty+reputation+fund_flow due diligence).",
+              "type": "string",
+              "enum": [
+                "merchant",
+                "customer",
+                "demander",
+                "prospect",
+                "supplier",
+                "collaborator",
+                "arbitrator"
+              ]
+            },
+            "industry": {
+              "description": "Industry template lens (freelance/rental/education/travel/subscription/retail or a registered pack industry): shapes per-family depth caps — e.g. rental deepens money edges (deposit round-trip), travel deepens workflow (multi-leg trips).",
+              "type": "string"
+            },
+            "context_account": {
+              "description": "Optional EOA address whose persona record supplies the identity-specific exploration preference (RoleProfile.topology). Omit to use the system persona. Also serves as the OBSERVER of the G2 role-interest view when interest_role is set.",
+              "type": "string"
+            },
+            "interest_role": {
+              "description": "G2 role interest view — project THIS CommercialRole's complete interest view (利益评估 stakes + 可行操作路径 node-game actions + 博弈对手分析 + 风险提醒) for context_account (or the seed when it is an EOA) over the same expanded graph. The view is returned as result.role_interest and as one IR:<role> finding carrying the same structured payload. Scoring comes exclusively from the evaluation game modules; when omitted, defaults to the persona 'role' lens if provided.",
+              "type": "string",
+              "enum": [
+                "merchant",
+                "customer",
+                "demander",
+                "prospect",
+                "supplier",
+                "collaborator",
+                "arbitrator",
+                "neutral",
+                "system"
+              ]
+            },
+            "no_cache": {
+              "description": "Set true to bypass the SDK chain-read cache. In-call batching/dedup still applies.",
+              "type": "boolean"
+            },
+            "analyze": {
+              "description": "Run the registered graph Analyzer suite (R/A/O/G — risk / structural-arbitrage / opportunity / game) over the NEUTRAL viewport and return objective findings. Default true; set false for raw topology only. Findings are facts + structural suggestions, never scores — scoring stays in the game-theory modules.",
+              "type": "boolean"
+            },
+            "analyzer_kinds": {
+              "description": "Filter analyzer kinds when analyze=true (default: all four): risk=R rules, arbitrage=A structural-arbitrage, opportunity=O, game=G objective situations.",
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "risk",
+                  "arbitrage",
+                  "opportunity",
+                  "game"
+                ]
+              }
+            },
+            "only_analyzers": {
+              "description": "Run ONLY these analyzer ids (whitelist, e.g. ['R1','G2']). The full registered id list is returned in `analyzers` of every response.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "include_raw": {
+              "description": "Attach each node's full raw on-chain object as nodes[].raw. Default false — nodes then carry only kind/object_type/coin_type/state/depth, keeping the payload compact.",
+              "type": "boolean"
+            },
+            "table_edges": {
+              "description": "Dynamic-table edges to expand (channel B). Default ['machine.node'] — expands every reached Machine's workflow node table and DERIVES the wf.transition graph. Add 'permission.entity' for permission-group members (EOA/Guard + perm indices) and 'demand.presenter' for demand proposals.",
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "machine.node",
+                  "permission.entity",
+                  "demand.presenter"
+                ]
+              }
+            },
+            "budget": {
+              "description": "Optional expansion-budget overrides. Every fetch stays batched (<=50 ids/request) regardless of these caps; exhaustion is reported honestly in budget_exhausted.",
+              "type": "object",
+              "properties": {
+                "max_depth": {
+                  "description": "BFS wave depth (default 4).",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 8
+                },
+                "max_nodes": {
+                  "description": "Hard node cap (default 500).",
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 3000
+                },
+                "max_rpcs": {
+                  "description": "Hard logical RPC-batch cap; each batch carries at most 50 ids (default 120).",
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 400
+                },
+                "max_fanout": {
+                  "description": "Per-node fanout cap per edge schema (default 60).",
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5200
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "query_type"
+          ],
+          "additionalProperties": false,
+          "description": "Read-only on-chain TOPOLOGY network around ONE seed address: batched multi-hop BFS over the machine-readable EdgeSchema (never per-id RPC; objects / EOA keyed fields / tables / events use four separate batched channels). Returns nodes + typed edges (family F=field / R=reverse-index / W=workflow / M=money-flow / S=social) with per-edge retention semantics (complete / bounded_exact / membership / bounded_window / derived), the STRUCTURAL workflow subgraph of each reached Machine (incl. its structural terminal set), structural completion of every Order reached, R/A/O/G analyzer findings, and truncation / data-gap / budget honesty markers. Read-only."
         }
       ]
     },