@wowok/agent-mcp 3.0.4 → 3.0.5

package/dist/schemas/query_toolkit.output.json

@@ -5688,7 +5688,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.",
@@ -15755,6 +15755,10 @@
                                 "description": "Unix timestamp in milliseconds",
                                 "type": "string"
                               },
+                              "checkpoint": {
+                                "description": "Checkpoint sequence containing this transaction — the global total order. Use it to order/compare across pages instead of timestamp_ms (which is the fullnode's ms clock).",
+                                "type": "string"
+                              },
                               "sender": {
                                 "description": "Transaction sender address",
                                 "type": "string"
@@ -15869,6 +15873,10 @@
                                 "description": "Unix timestamp in milliseconds",
                                 "type": "string"
                               },
+                              "checkpoint": {
+                                "description": "Checkpoint sequence containing this transaction — the global total order. Use it to order/compare across pages instead of timestamp_ms (which is the fullnode's ms clock).",
+                                "type": "string"
+                              },
                               "sender": {
                                 "description": "Transaction sender address",
                                 "type": "string"
@@ -16592,6 +16600,34 @@
                             "weight": {
                               "description": "Forward weight (accumulates toward the pair's threshold).",
                               "type": "number"
+                            },
+                            "recommended_call": {
+                              "description": "Concrete tool route for THIS account to execute the forward (absent when execution_path=not_available).",
+                              "type": "object",
+                              "properties": {
+                                "tool": {
+                                  "type": "string",
+                                  "enum": [
+                                    "onchain_operations",
+                                    "workflow_operation"
+                                  ],
+                                  "description": "Tool that executes the forward: onchain_operations order.data.progress (OrderHolder short-circuit) or workflow_operation data.operate (permission index / named operator)."
+                                },
+                                "path": {
+                                  "type": "string",
+                                  "description": "Input path inside the tool data payload."
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "description": "Chain-authoritative routing reason, including the wrong-route abort code (direct progress::next on a namedOperator='' forward aborts permission#5 'Permission denied') and the Guard passport requirement when the forward binds one."
+                                }
+                              },
+                              "required": [
+                                "tool",
+                                "path",
+                                "reason"
+                              ],
+                              "additionalProperties": false
                             }
                           },
                           "required": [
@@ -16970,6 +17006,34 @@
                             "weight": {
                               "description": "Forward weight (accumulates toward the pair's threshold).",
                               "type": "number"
+                            },
+                            "recommended_call": {
+                              "description": "Concrete tool route for THIS account to execute the forward (absent when execution_path=not_available).",
+                              "type": "object",
+                              "properties": {
+                                "tool": {
+                                  "type": "string",
+                                  "enum": [
+                                    "onchain_operations",
+                                    "workflow_operation"
+                                  ],
+                                  "description": "Tool that executes the forward: onchain_operations order.data.progress (OrderHolder short-circuit) or workflow_operation data.operate (permission index / named operator)."
+                                },
+                                "path": {
+                                  "type": "string",
+                                  "description": "Input path inside the tool data payload."
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "description": "Chain-authoritative routing reason, including the wrong-route abort code (direct progress::next on a namedOperator='' forward aborts permission#5 'Permission denied') and the Guard passport requirement when the forward binds one."
+                                }
+                              },
+                              "required": [
+                                "tool",
+                                "path",
+                                "reason"
+                              ],
+                              "additionalProperties": false
                             }
                           },
                           "required": [
@@ -17672,6 +17736,17 @@
                         "type": "string",
                         "description": "Stable bridge id (e.g. bridge.supply_match)."
                       },
+                      "code": {
+                        "type": "string",
+                        "description": "Short cross-link code used by EdgeSchema.bridgeIds (b01..b12)."
+                      },
+                      "edge_refs": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Machine-readable grounding: EdgeSchema ids whose presence indicates this bridge."
+                      },
                       "name": {
                         "type": "string"
                       },
@@ -17765,6 +17840,8 @@
                     },
                     "required": [
                       "id",
+                      "code",
+                      "edge_refs",
                       "name",
                       "participants",
                       "bridge_fields",
@@ -18009,7 +18086,1508 @@
             "result"
           ],
           "additionalProperties": false
-        }
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_topology"
+            },
+            "result": {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "onchain_topology"
+                },
+                "seed": {
+                  "type": "string",
+                  "description": "Resolved seed address (lowercased canonical form)."
+                },
+                "network": {
+                  "type": "string",
+                  "description": "Network the topology was read from."
+                },
+                "strategy": {
+                  "type": "object",
+                  "properties": {
+                    "intents": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Semantic intents that drove the expansion."
+                    },
+                    "families": {
+                      "description": "Family whitelist applied (undefined = all families).",
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "schemas": {
+                      "description": "Schema-id whitelist applied (undefined = family-driven).",
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "table_edges": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Dynamic-table edges expanded."
+                    },
+                    "family_depths": {
+                      "description": "Per-family BFS depth caps.",
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {
+                        "type": "number"
+                      }
+                    },
+                    "budget": {
+                      "type": "object",
+                      "properties": {
+                        "max_depth": {
+                          "type": "number"
+                        },
+                        "max_nodes": {
+                          "type": "number"
+                        },
+                        "max_fanout": {
+                          "type": "number"
+                        },
+                        "max_rpcs": {
+                          "type": "number"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "description": "Effective budget overrides after the strategy merge."
+                    },
+                    "trace": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Ordered provenance — every strategy layer applied and why."
+                    }
+                  },
+                  "required": [
+                    "intents",
+                    "table_edges",
+                    "budget",
+                    "trace"
+                  ],
+                  "additionalProperties": false,
+                  "description": "The resolved semantic exploration strategy (G3): intents, whitelist, budget and WHY (layer trace)."
+                },
+                "analyzers": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "All registered graph-analyzer ids (discovery list for only_analyzers)."
+                },
+                "stats": {
+                  "type": "object",
+                  "properties": {
+                    "nodes_total": {
+                      "type": "number"
+                    },
+                    "nodes_by_kind": {
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {
+                        "type": "number"
+                      }
+                    },
+                    "nodes_by_object_type": {
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {
+                        "type": "number"
+                      }
+                    },
+                    "edges_total": {
+                      "type": "number"
+                    },
+                    "edges_by_family": {
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {
+                        "type": "number"
+                      }
+                    },
+                    "edges_by_schema": {
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {
+                        "type": "number"
+                      }
+                    },
+                    "rpc": {
+                      "type": "object",
+                      "properties": {
+                        "batches": {
+                          "type": "number",
+                          "description": "Logical RPC batches (one <=50-id chunk = 1 batch)."
+                        },
+                        "by_channel": {
+                          "type": "object",
+                          "properties": {
+                            "objects": {
+                              "type": "number"
+                            },
+                            "keyed_fields": {
+                              "type": "number"
+                            },
+                            "tables": {
+                              "type": "number"
+                            },
+                            "events": {
+                              "type": "number"
+                            }
+                          },
+                          "required": [
+                            "objects",
+                            "keyed_fields",
+                            "tables",
+                            "events"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "dedup_hits": {
+                          "type": "number",
+                          "description": "Fetches avoided via in-call dedup/session cache."
+                        }
+                      },
+                      "required": [
+                        "batches",
+                        "by_channel",
+                        "dedup_hits"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "nodes_total",
+                    "nodes_by_kind",
+                    "nodes_by_object_type",
+                    "edges_total",
+                    "edges_by_family",
+                    "edges_by_schema",
+                    "rpc"
+                  ],
+                  "additionalProperties": false
+                },
+                "nodes": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Lowercased canonical node id (EOA/object address, or ${machine}::node::${name} for wfnode)."
+                      },
+                      "kind": {
+                        "type": "string",
+                        "enum": [
+                          "eoa",
+                          "object",
+                          "wfnode"
+                        ],
+                        "description": "eoa=user account (first byte 0x00); object=chain object; wfnode=synthetic Machine workflow node."
+                      },
+                      "object_type": {
+                        "description": "SDK object type label for object nodes (Service/Machine/Order/Progress/Allocation/...).",
+                        "type": "string"
+                      },
+                      "coin_type": {
+                        "description": "Generic coin type T parsed from type_raw (amounts of different T are never mixed).",
+                        "type": "string"
+                      },
+                      "state": {
+                        "type": "string",
+                        "enum": [
+                          "seed",
+                          "fetched",
+                          "error",
+                          "stub"
+                        ],
+                        "description": "Fetch state: seed/fetched carry data; stub=discovered but not yet loaded; error=read failed (see data_gaps)."
+                      },
+                      "depth": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 9007199254740991,
+                        "description": "Shallowest BFS depth at which the node was reached (seed=0)."
+                      },
+                      "error": {
+                        "description": "Fetch error marker when state='error'.",
+                        "type": "string"
+                      },
+                      "raw": {
+                        "description": "Full raw on-chain object — present ONLY when include_raw=true."
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "kind",
+                      "state",
+                      "depth"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "All reached nodes (raw objects only with include_raw=true)."
+                },
+                "edges": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Deterministic edge id: ${schema}|${from}→${to}[|${key}]."
+                      },
+                      "schema": {
+                        "type": "string",
+                        "description": "Machine-readable EdgeSchema id (e.g. service.order, wf.transition, payment.recipient)."
+                      },
+                      "family": {
+                        "type": "string",
+                        "enum": [
+                          "F",
+                          "R",
+                          "M",
+                          "W",
+                          "S"
+                        ],
+                        "description": "F=forward field snapshot; R=global reverse index; W=workflow-derived; M=money-flow receipt; S=social/reputation."
+                      },
+                      "from": {
+                        "type": "string"
+                      },
+                      "to": {
+                        "type": "string"
+                      },
+                      "retention": {
+                        "type": "string",
+                        "enum": [
+                          "complete",
+                          "bounded_exact",
+                          "bounded_window",
+                          "membership",
+                          "derived"
+                        ],
+                        "description": "Data-bound semantics: complete=full snapshot; bounded_exact=lossless bounded index; bounded_window=FIFO/ring <=5200 (counts are LOWER BOUNDS, see truncations); membership=current members only; derived=structurally produced."
+                      },
+                      "evidence": {
+                        "type": "string",
+                        "description": "Contract evidence anchor (move file + line range)."
+                      },
+                      "key": {
+                        "description": "Disambiguator for multi-edges of one schema between the same nodes (e.g. forward name).",
+                        "type": "string"
+                      },
+                      "truncated": {
+                        "description": "Set when the producing index is a FIFO/ring window that may have dropped rows.",
+                        "type": "boolean"
+                      },
+                      "payload": {
+                        "description": "Family-specific data — M: amount/coinType/mode/guard; W: node/prevNode/forward/threshold/weight/guard/namedOperator/permissionIndex; R: roleBits; S: voteBits.",
+                        "type": "object",
+                        "propertyNames": {
+                          "type": "string"
+                        },
+                        "additionalProperties": {}
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "schema",
+                      "family",
+                      "from",
+                      "to",
+                      "retention",
+                      "evidence"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "All deduped topology edges with retention + evidence."
+                },
+                "workflows": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "machine": {
+                        "type": "string",
+                        "description": "Machine object address."
+                      },
+                      "transitions": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "node": {
+                              "type": "string",
+                              "description": "Destination workflow node."
+                            },
+                            "prev_node": {
+                              "type": "string",
+                              "description": "Source node ('' = workflow entry sentinel)."
+                            },
+                            "forward": {
+                              "description": "Advance-operation name (absent = no explicit forward on the pair).",
+                              "type": "string"
+                            },
+                            "threshold": {
+                              "description": "Pair threshold (accumulated forward weights required to advance).",
+                              "type": "number"
+                            },
+                            "guard": {
+                              "description": "Guard gating this forward (null = none).",
+                              "anyOf": [
+                                {
+                                  "type": "string"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            },
+                            "weight": {
+                              "description": "Forward weight toward the pair threshold.",
+                              "anyOf": [
+                                {
+                                  "type": "number"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            },
+                            "named_operator": {
+                              "description": "Named-operator binding on this forward (null = none; '' = OrderHolder/customer).",
+                              "anyOf": [
+                                {
+                                  "type": "string"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            },
+                            "permission_index": {
+                              "description": "Permission-index binding on this forward (null = none).",
+                              "anyOf": [
+                                {
+                                  "type": "number"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            },
+                            "recommended_call": {
+                              "anyOf": [
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "tool": {
+                                      "type": "string",
+                                      "enum": [
+                                        "onchain_operations",
+                                        "workflow_operation"
+                                      ],
+                                      "description": "Tool that executes the forward: onchain_operations order.data.progress (OrderHolder short-circuit) or workflow_operation data.operate (permission index / named operator)."
+                                    },
+                                    "path": {
+                                      "type": "string",
+                                      "description": "Input path inside the tool data payload."
+                                    },
+                                    "reason": {
+                                      "type": "string",
+                                      "description": "Chain-authoritative routing reason, including the wrong-route abort code (direct progress::next on a namedOperator='' forward aborts permission#5 'Permission denied') and the Guard passport requirement when the forward binds one."
+                                    }
+                                  },
+                                  "required": [
+                                    "tool",
+                                    "path",
+                                    "reason"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Structural execution route from the forward binding (caller-neutral): named_operator='' → onchain_operations order.data.progress; permission_index/non-empty named_operator → workflow_operation data.operate. null = unbound forward (no operator binding; see R/G findings)."
+                            }
+                          },
+                          "required": [
+                            "node",
+                            "prev_node",
+                            "recommended_call"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "Flattened forward-expanded transitions (one row per forward)."
+                      },
+                      "terminal_names": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "STRUCTURAL terminal set: node names never appearing as any pair.prev_node — the D2 completion authority."
+                      }
+                    },
+                    "required": [
+                      "machine",
+                      "transitions",
+                      "terminal_names"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "One structural workflow subgraph per Machine whose node table was expanded (table_edges)."
+                },
+                "orders_completion": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "order": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "completed",
+                          "in_progress",
+                          "unknown"
+                        ],
+                        "description": "Structural completion: no machine=completed; machine bound without progress/current=in_progress; current node in the machine's structural terminal set=completed; unverifiable from this graph=unknown."
+                      },
+                      "terminal": {
+                        "description": "The structural terminal the order currently sits on (when status=completed).",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "order",
+                      "status"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Structural completion of every Order node reached in this graph."
+                },
+                "findings": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Stable analyzer rule id (R1-R6 / A1-A3 / O1-O3 / G1-G3 / AC1-AC4; node bindings like SR1:<service>#<n>)."
+                      },
+                      "kind": {
+                        "type": "string",
+                        "enum": [
+                          "risk",
+                          "arbitrage",
+                          "opportunity",
+                          "game"
+                        ]
+                      },
+                      "severity": {
+                        "type": "string",
+                        "enum": [
+                          "info",
+                          "low",
+                          "medium",
+                          "high"
+                        ]
+                      },
+                      "titleZh": {
+                        "type": "string",
+                        "description": "Chinese one-line finding title."
+                      },
+                      "path": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Evidence path — ordered edge schema ids / node ids the finding rests on."
+                      },
+                      "confidence": {
+                        "type": "string",
+                        "enum": [
+                          "exact",
+                          "bounded",
+                          "windowed",
+                          "derived"
+                        ],
+                        "description": "Synthesized from the WEAKEST retention on the evidence path (windowed => lower-bound wording)."
+                      },
+                      "window": {
+                        "description": "Present when evidence crosses a bounded FIFO/ring window (observed/limit).",
+                        "type": "object",
+                        "properties": {
+                          "observed": {
+                            "type": "number"
+                          },
+                          "limit": {
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "observed",
+                          "limit"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "roles": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Commercial roles this finding is relevant to."
+                      },
+                      "detailZh": {
+                        "type": "string",
+                        "description": "Chinese objective detail (facts only)."
+                      },
+                      "suggestionZh": {
+                        "type": "string",
+                        "description": "Chinese structural suggestion (never a score)."
+                      },
+                      "interest": {
+                        "description": "G2 role-interest view payload — present only on IR:<role> findings (利益评估/操作路径/对手分析/风险提醒).",
+                        "type": "object",
+                        "properties": {
+                          "role": {
+                            "type": "string",
+                            "description": "The CommercialRole whose interest view this is."
+                          },
+                          "observer": {
+                            "type": "string",
+                            "description": "The EOA the view is projected for."
+                          },
+                          "drive": {
+                            "description": "Persona driving signals that re-anchored scoring.",
+                            "type": "object",
+                            "properties": {
+                              "risk_appetite": {
+                                "type": "string",
+                                "enum": [
+                                  "conservative",
+                                  "balanced",
+                                  "aggressive"
+                                ]
+                              },
+                              "requirements": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            },
+                            "additionalProperties": false
+                          },
+                          "stakes": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "object": {
+                                  "type": "string"
+                                },
+                                "object_type": {
+                                  "type": "string"
+                                },
+                                "positions": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "amount": {
+                                  "type": "string"
+                                },
+                                "coin_type": {
+                                  "type": "string"
+                                },
+                                "state": {
+                                  "type": "string"
+                                },
+                                "evidence": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                }
+                              },
+                              "required": [
+                                "object",
+                                "object_type",
+                                "positions",
+                                "evidence"
+                              ],
+                              "additionalProperties": false
+                            },
+                            "description": "利益评估 — what the observer has at stake."
+                          },
+                          "actions": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "order": {
+                                  "type": "string"
+                                },
+                                "machine": {
+                                  "type": "string"
+                                },
+                                "current_node": {
+                                  "type": "string"
+                                },
+                                "advice": {
+                                  "type": "object",
+                                  "properties": {
+                                    "current_node": {
+                                      "type": "string"
+                                    },
+                                    "perspective": {
+                                      "type": "string"
+                                    },
+                                    "actions": {
+                                      "type": "array",
+                                      "items": {
+                                        "type": "object",
+                                        "properties": {
+                                          "forward": {
+                                            "type": "string"
+                                          },
+                                          "to_node": {
+                                            "type": "string"
+                                          },
+                                          "execution_path": {
+                                            "type": "string"
+                                          },
+                                          "guard": {
+                                            "type": "string"
+                                          },
+                                          "favorability": {
+                                            "type": "number"
+                                          },
+                                          "gain_score": {
+                                            "type": "number"
+                                          },
+                                          "risk_score": {
+                                            "type": "number"
+                                          },
+                                          "is_optimal": {
+                                            "type": "boolean"
+                                          },
+                                          "payoff_note": {
+                                            "type": "string"
+                                          },
+                                          "risk": {
+                                            "type": "string",
+                                            "enum": [
+                                              "low",
+                                              "medium",
+                                              "high"
+                                            ]
+                                          }
+                                        },
+                                        "required": [
+                                          "forward",
+                                          "to_node",
+                                          "execution_path",
+                                          "favorability",
+                                          "gain_score",
+                                          "risk_score",
+                                          "is_optimal",
+                                          "payoff_note",
+                                          "risk"
+                                        ],
+                                        "additionalProperties": false
+                                      }
+                                    },
+                                    "cooperation": {
+                                      "type": "object",
+                                      "properties": {
+                                        "threshold": {
+                                          "type": "number"
+                                        },
+                                        "my_weight": {
+                                          "type": "number"
+                                        },
+                                        "needed_from_others": {
+                                          "type": "number"
+                                        },
+                                        "collaborators": {
+                                          "type": "array",
+                                          "items": {
+                                            "type": "string"
+                                          }
+                                        },
+                                        "allocation_note": {
+                                          "type": "string"
+                                        }
+                                      },
+                                      "required": [
+                                        "threshold",
+                                        "my_weight",
+                                        "needed_from_others",
+                                        "collaborators"
+                                      ],
+                                      "additionalProperties": false
+                                    },
+                                    "value_at_stake": {
+                                      "type": "string"
+                                    },
+                                    "risk_exposure": {
+                                      "type": "string"
+                                    },
+                                    "summary": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "current_node",
+                                    "perspective",
+                                    "actions",
+                                    "summary"
+                                  ],
+                                  "additionalProperties": false,
+                                  "description": "node-game ranking — the single action authority."
+                                },
+                                "recommended_calls": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "forward": {
+                                        "type": "string"
+                                      },
+                                      "call": {}
+                                    },
+                                    "required": [
+                                      "forward",
+                                      "call"
+                                    ],
+                                    "additionalProperties": false
+                                  }
+                                },
+                                "blocked_forwards": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "forward": {
+                                        "type": "string"
+                                      },
+                                      "reason": {
+                                        "type": "string"
+                                      }
+                                    },
+                                    "required": [
+                                      "forward",
+                                      "reason"
+                                    ],
+                                    "additionalProperties": false
+                                  }
+                                }
+                              },
+                              "required": [
+                                "order",
+                                "machine",
+                                "current_node",
+                                "advice",
+                                "recommended_calls",
+                                "blocked_forwards"
+                              ],
+                              "additionalProperties": false
+                            },
+                            "description": "可行操作路径 — per in-flight order."
+                          },
+                          "arb_actions": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string"
+                                },
+                                "perspective": {
+                                  "type": "string"
+                                },
+                                "actions": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "action": {
+                                        "type": "string"
+                                      },
+                                      "favorability": {
+                                        "type": "number"
+                                      },
+                                      "gain_score": {
+                                        "type": "number"
+                                      },
+                                      "risk_score": {
+                                        "type": "number"
+                                      },
+                                      "is_optimal": {
+                                        "type": "boolean"
+                                      },
+                                      "payoff_note": {
+                                        "type": "string"
+                                      },
+                                      "risk": {
+                                        "type": "string",
+                                        "enum": [
+                                          "low",
+                                          "medium",
+                                          "high"
+                                        ]
+                                      }
+                                    },
+                                    "required": [
+                                      "action",
+                                      "favorability",
+                                      "gain_score",
+                                      "risk_score",
+                                      "is_optimal",
+                                      "payoff_note",
+                                      "risk"
+                                    ],
+                                    "additionalProperties": false
+                                  }
+                                },
+                                "summary": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "perspective",
+                                "actions",
+                                "summary"
+                              ],
+                              "additionalProperties": false
+                            },
+                            "description": "arbitration-game moves when the observer is a case party."
+                          },
+                          "counterparties": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "object": {
+                                  "type": "string"
+                                },
+                                "counter_role": {
+                                  "type": "string"
+                                },
+                                "who": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "their_prefer": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "their_avoid": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "alignment": {
+                                  "type": "string",
+                                  "enum": [
+                                    "conflict",
+                                    "aligned",
+                                    "neutral"
+                                  ]
+                                },
+                                "noteZh": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "object",
+                                "counter_role",
+                                "who",
+                                "their_prefer",
+                                "their_avoid",
+                                "alignment",
+                                "noteZh"
+                              ],
+                              "additionalProperties": false
+                            },
+                            "description": "博弈对手分析 — structural tension from the single ROLE_INTERESTS table."
+                          },
+                          "risk_finding_ids": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            },
+                            "description": "风险提醒 — ids of role-relevant risk findings in the same result."
+                          },
+                          "summaryZh": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "role",
+                          "observer",
+                          "stakes",
+                          "actions",
+                          "arb_actions",
+                          "counterparties",
+                          "risk_finding_ids",
+                          "summaryZh"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "kind",
+                      "severity",
+                      "titleZh",
+                      "path",
+                      "confidence",
+                      "roles",
+                      "detailZh",
+                      "suggestionZh"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "R/A/O/G analyzer findings (empty when analyze=false)."
+                },
+                "role_interest": {
+                  "description": "G2 role interest view (same payload as the IR:<role> finding): stakes / node-game actions / arbitration moves / counterparty tensions / risk reminders for interest_role's observer.",
+                  "type": "object",
+                  "properties": {
+                    "role": {
+                      "type": "string",
+                      "description": "The CommercialRole whose interest view this is."
+                    },
+                    "observer": {
+                      "type": "string",
+                      "description": "The EOA the view is projected for."
+                    },
+                    "drive": {
+                      "description": "Persona driving signals that re-anchored scoring.",
+                      "type": "object",
+                      "properties": {
+                        "risk_appetite": {
+                          "type": "string",
+                          "enum": [
+                            "conservative",
+                            "balanced",
+                            "aggressive"
+                          ]
+                        },
+                        "requirements": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        }
+                      },
+                      "additionalProperties": false
+                    },
+                    "stakes": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "object": {
+                            "type": "string"
+                          },
+                          "object_type": {
+                            "type": "string"
+                          },
+                          "positions": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "amount": {
+                            "type": "string"
+                          },
+                          "coin_type": {
+                            "type": "string"
+                          },
+                          "state": {
+                            "type": "string"
+                          },
+                          "evidence": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        },
+                        "required": [
+                          "object",
+                          "object_type",
+                          "positions",
+                          "evidence"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "利益评估 — what the observer has at stake."
+                    },
+                    "actions": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "order": {
+                            "type": "string"
+                          },
+                          "machine": {
+                            "type": "string"
+                          },
+                          "current_node": {
+                            "type": "string"
+                          },
+                          "advice": {
+                            "type": "object",
+                            "properties": {
+                              "current_node": {
+                                "type": "string"
+                              },
+                              "perspective": {
+                                "type": "string"
+                              },
+                              "actions": {
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "properties": {
+                                    "forward": {
+                                      "type": "string"
+                                    },
+                                    "to_node": {
+                                      "type": "string"
+                                    },
+                                    "execution_path": {
+                                      "type": "string"
+                                    },
+                                    "guard": {
+                                      "type": "string"
+                                    },
+                                    "favorability": {
+                                      "type": "number"
+                                    },
+                                    "gain_score": {
+                                      "type": "number"
+                                    },
+                                    "risk_score": {
+                                      "type": "number"
+                                    },
+                                    "is_optimal": {
+                                      "type": "boolean"
+                                    },
+                                    "payoff_note": {
+                                      "type": "string"
+                                    },
+                                    "risk": {
+                                      "type": "string",
+                                      "enum": [
+                                        "low",
+                                        "medium",
+                                        "high"
+                                      ]
+                                    }
+                                  },
+                                  "required": [
+                                    "forward",
+                                    "to_node",
+                                    "execution_path",
+                                    "favorability",
+                                    "gain_score",
+                                    "risk_score",
+                                    "is_optimal",
+                                    "payoff_note",
+                                    "risk"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              },
+                              "cooperation": {
+                                "type": "object",
+                                "properties": {
+                                  "threshold": {
+                                    "type": "number"
+                                  },
+                                  "my_weight": {
+                                    "type": "number"
+                                  },
+                                  "needed_from_others": {
+                                    "type": "number"
+                                  },
+                                  "collaborators": {
+                                    "type": "array",
+                                    "items": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "allocation_note": {
+                                    "type": "string"
+                                  }
+                                },
+                                "required": [
+                                  "threshold",
+                                  "my_weight",
+                                  "needed_from_others",
+                                  "collaborators"
+                                ],
+                                "additionalProperties": false
+                              },
+                              "value_at_stake": {
+                                "type": "string"
+                              },
+                              "risk_exposure": {
+                                "type": "string"
+                              },
+                              "summary": {
+                                "type": "string"
+                              }
+                            },
+                            "required": [
+                              "current_node",
+                              "perspective",
+                              "actions",
+                              "summary"
+                            ],
+                            "additionalProperties": false,
+                            "description": "node-game ranking — the single action authority."
+                          },
+                          "recommended_calls": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "forward": {
+                                  "type": "string"
+                                },
+                                "call": {}
+                              },
+                              "required": [
+                                "forward",
+                                "call"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "blocked_forwards": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "forward": {
+                                  "type": "string"
+                                },
+                                "reason": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "forward",
+                                "reason"
+                              ],
+                              "additionalProperties": false
+                            }
+                          }
+                        },
+                        "required": [
+                          "order",
+                          "machine",
+                          "current_node",
+                          "advice",
+                          "recommended_calls",
+                          "blocked_forwards"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "可行操作路径 — per in-flight order."
+                    },
+                    "arb_actions": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "status": {
+                            "type": "string"
+                          },
+                          "perspective": {
+                            "type": "string"
+                          },
+                          "actions": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "action": {
+                                  "type": "string"
+                                },
+                                "favorability": {
+                                  "type": "number"
+                                },
+                                "gain_score": {
+                                  "type": "number"
+                                },
+                                "risk_score": {
+                                  "type": "number"
+                                },
+                                "is_optimal": {
+                                  "type": "boolean"
+                                },
+                                "payoff_note": {
+                                  "type": "string"
+                                },
+                                "risk": {
+                                  "type": "string",
+                                  "enum": [
+                                    "low",
+                                    "medium",
+                                    "high"
+                                  ]
+                                }
+                              },
+                              "required": [
+                                "action",
+                                "favorability",
+                                "gain_score",
+                                "risk_score",
+                                "is_optimal",
+                                "payoff_note",
+                                "risk"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "summary": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "status",
+                          "perspective",
+                          "actions",
+                          "summary"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "arbitration-game moves when the observer is a case party."
+                    },
+                    "counterparties": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "object": {
+                            "type": "string"
+                          },
+                          "counter_role": {
+                            "type": "string"
+                          },
+                          "who": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "their_prefer": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "their_avoid": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "alignment": {
+                            "type": "string",
+                            "enum": [
+                              "conflict",
+                              "aligned",
+                              "neutral"
+                            ]
+                          },
+                          "noteZh": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "object",
+                          "counter_role",
+                          "who",
+                          "their_prefer",
+                          "their_avoid",
+                          "alignment",
+                          "noteZh"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "博弈对手分析 — structural tension from the single ROLE_INTERESTS table."
+                    },
+                    "risk_finding_ids": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "风险提醒 — ids of role-relevant risk findings in the same result."
+                    },
+                    "summaryZh": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "role",
+                    "observer",
+                    "stakes",
+                    "actions",
+                    "arb_actions",
+                    "counterparties",
+                    "risk_finding_ids",
+                    "summaryZh"
+                  ],
+                  "additionalProperties": false
+                },
+                "truncations": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "node_id": {
+                        "type": "string"
+                      },
+                      "schema": {
+                        "type": "string"
+                      },
+                      "observed": {
+                        "type": "number"
+                      },
+                      "limit": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "node_id",
+                      "schema",
+                      "observed",
+                      "limit"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Per-node FIFO/ring truncations — conclusions crossing these edges are confidence-degraded."
+                },
+                "budget_exhausted": {
+                  "type": "object",
+                  "properties": {
+                    "nodes": {
+                      "type": "boolean"
+                    },
+                    "depth": {
+                      "type": "boolean"
+                    },
+                    "rpcs": {
+                      "type": "boolean"
+                    },
+                    "event_pages": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "Which expansion budgets were exhausted (the topology is partial when any flag is set)."
+                },
+                "data_gaps": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Fail-soft degradation notes — unreadable objects/tables and partial-data markers."
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "One-paragraph machine-readable topology summary."
+                }
+              },
+              "required": [
+                "action",
+                "seed",
+                "network",
+                "strategy",
+                "analyzers",
+                "stats",
+                "nodes",
+                "edges",
+                "workflows",
+                "orders_completion",
+                "findings",
+                "truncations",
+                "budget_exhausted",
+                "data_gaps",
+                "summary"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "query_type",
+            "result"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "network": {
+      "description": "Network the data was READ from for single-network on-chain query types (e.g. account_balance, onchain_objects, onchain_transaction, panoramas). Omitted for purely-local queries (local_*), static cross-chain data (scenario_topology), and two-network results (migration_preflight). When network_source='default' the input omitted the network and the SDK's current default network was used.",
+      "type": "string",
+      "enum": [
+        "localnet",
+        "testnet",
+        "mainnet"
+      ]
+    },
+    "network_source": {
+      "description": "How the response network was chosen: 'explicit' = the call supplied the network parameter; 'default' = resolved through the SDK default network. Present only when 'network' is present.",
+      "type": "string",
+      "enum": [
+        "explicit",
+        "default"
       ]
     },
     "semantic": {