@wowok/agent-mcp 3.0.0 → 3.0.2

package/dist/schemas/onchain_table_data.output.json

@@ -9392,6 +9392,24 @@
           "additionalProperties": false,
           "description": "Business Relationship Graph (K3/19): derive ONE account's full relationship web from on-chain power carriers (Permission memberships, Machine forwards, Orders, Demand presenters, Allocation sharing, Arbitration bindings, Contact ims). Each edge carries the three dimensions — 权属 power (what each side CAN do, and where that power lives on-chain), 利益 interest (gains/exposures, with registry-declared goal tensions like principal-agent divergence), and 价值交互 value flows (escrow → allocation → payment chains). Read-only; roles are DERIVED from chain data, never asserted."
         },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "scenario_topology"
+            },
+            "chain_id": {
+              "description": "Optional scenario-chain id (chain.standard_ecommerce | chain.procurement_tender | chain.data_subscription | chain.collaborative_operations). When given, only that chain is returned; otherwise ALL scenario chains + bridges are returned.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "query_type"
+          ],
+          "additionalProperties": false,
+          "description": "Scenario Topology knowledge (K3 03 §3.5 / Part 2): the STATIC registry of how WoWok objects INTEGRATE each other. Bridges weld object pairs into a capability that belongs to no single object (e.g. Demand.present(service) grants MATCHMAKING); chains compose bridges into whole applications (e.g. standard e-commerce, procurement tender). Pure knowledge, read-only — no on-chain reads. Use to explain HOW a business scenario is assembled from on-chain objects and why the integration (not the objects themselves) yields the capability."
+        },
         {
           "type": "object",
           "properties": {
@@ -9461,6 +9479,47 @@
           ],
           "additionalProperties": false,
           "description": "Like / Favor list for ONE account (client Quick Access 'Like / Favor' tab) — every address (object OR plain user) the account has EVER liked / disliked / favored, deduplicated, with the CURRENT active vote kinds per target. Deterministic source: the voter's own Resource mark table (registrar.move handle_vote → resource::tag_set), cross-read with the target's EntityLinker votes for the 'marked at' clock. Fully-toggled-off targets are dropped. Each row: address + tags (like/dislike/favor) + time + object_type (null = plain user) + local name / description / tags. Aggregation result is TTL-cached (120s, keyed by network + account). Read-only."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "migration_preflight"
+            },
+            "no_cache": {
+              "description": "Set to true to bypass the SDK chain-read cache.",
+              "type": "boolean"
+            },
+            "account": {
+              "type": "string",
+              "description": "Account address (or name) to check. Required when query_type='migration_preflight'."
+            },
+            "source_network": {
+              "description": "Source network to detect an existing build (default 'testnet').",
+              "type": "string",
+              "enum": [
+                "testnet",
+                "mainnet",
+                "localnet"
+              ]
+            },
+            "target_network": {
+              "description": "Target network for the migration (default 'mainnet').",
+              "type": "string",
+              "enum": [
+                "testnet",
+                "mainnet",
+                "localnet"
+              ]
+            }
+          },
+          "required": [
+            "query_type",
+            "account"
+          ],
+          "additionalProperties": false,
+          "description": "Cross-network build detection + mainnet customization preflight (first-touch migration): detect whether the account has already built Services/Machines/etc. on the source network (default testnet), report the same on the target network (default mainnet), and return a business-facing checklist of the key settings to confirm/change when migrating — payment token, location, arbitration, WIP, gas. Read-only."
         }
       ]
     },

package/dist/schemas/query_toolkit.output.json

@@ -17537,6 +17537,54 @@
                 "summary": {
                   "type": "string",
                   "description": "One-paragraph relationship web summary."
+                },
+                "demander_interest": {
+                  "description": "Demander-interest analysis per anchor-owned demand (fund_flow/responsibility/leverage/stakes).",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "demand": {
+                        "type": "string"
+                      },
+                      "fund_flow": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "responsibility": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "leverage": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "stakes": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "summary": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "demand",
+                      "fund_flow",
+                      "responsibility",
+                      "leverage",
+                      "stakes",
+                      "summary"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "required": [
@@ -17557,6 +17605,203 @@
           ],
           "additionalProperties": false
         },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "scenario_topology"
+            },
+            "result": {
+              "type": "object",
+              "properties": {
+                "version": {
+                  "type": "string",
+                  "description": "scenario-topology registry version."
+                },
+                "chains": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Stable chain id (e.g. chain.standard_ecommerce)."
+                      },
+                      "name": {
+                        "type": "string"
+                      },
+                      "steps": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "bridge": {
+                              "type": "string"
+                            },
+                            "note": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "bridge"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "Ordered bridges forming the complete application."
+                      },
+                      "application_capability": {
+                        "type": "string",
+                        "description": "The end-to-end application capability."
+                      },
+                      "objects_touched": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "steps",
+                      "application_capability",
+                      "objects_touched"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Scenario chains (whole applications); optionally filtered by chain_id."
+                },
+                "bridges": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Stable bridge id (e.g. bridge.supply_match)."
+                      },
+                      "name": {
+                        "type": "string"
+                      },
+                      "participants": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "object": {
+                              "type": "string"
+                            },
+                            "role": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "object",
+                            "role"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "Objects welded by this bridge."
+                      },
+                      "bridge_fields": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "object": {
+                              "type": "string"
+                            },
+                            "field": {
+                              "type": "string"
+                            },
+                            "meaning": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "object",
+                            "field",
+                            "meaning"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "The integrating Move fields (source of truth)."
+                      },
+                      "move_anchor": {
+                        "type": "string",
+                        "description": "Move creation/consumption function anchor."
+                      },
+                      "scenario": {
+                        "type": "object",
+                        "properties": {
+                          "from": {
+                            "type": "string"
+                          },
+                          "to": {
+                            "type": "string"
+                          },
+                          "merged": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "from",
+                          "to",
+                          "merged"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "capability_gained": {
+                        "type": "string",
+                        "description": "The NEW capability from the integration itself (belongs to no single object)."
+                      },
+                      "value_flow": {
+                        "type": "string"
+                      },
+                      "prerequisites": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "examples": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "participants",
+                      "bridge_fields",
+                      "move_anchor",
+                      "scenario",
+                      "capability_gained",
+                      "prerequisites",
+                      "examples"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Scenario bridges (field integrations) resolvable from chain steps."
+                }
+              },
+              "required": [
+                "version",
+                "chains",
+                "bridges"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "query_type",
+            "result"
+          ],
+          "additionalProperties": false
+        },
         {
           "type": "object",
           "properties": {
@@ -17590,6 +17835,189 @@
             "result"
           ],
           "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "migration_preflight"
+            },
+            "result": {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "migration_preflight"
+                },
+                "account": {
+                  "type": "string"
+                },
+                "source_network": {
+                  "type": "string"
+                },
+                "target_network": {
+                  "type": "string"
+                },
+                "source": {
+                  "type": "object",
+                  "properties": {
+                    "network": {
+                      "type": "string"
+                    },
+                    "has_build": {
+                      "type": "boolean",
+                      "description": "True when the account has built at least one object on this network."
+                    },
+                    "permissions": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "services": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "machines": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "treasuries": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "rewards": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "contacts": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "arbitrations": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "network",
+                    "has_build",
+                    "permissions",
+                    "services",
+                    "machines",
+                    "treasuries",
+                    "rewards",
+                    "contacts",
+                    "arbitrations"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Build status on the source network (e.g. testnet)."
+                },
+                "target": {
+                  "type": "object",
+                  "properties": {
+                    "network": {
+                      "type": "string"
+                    },
+                    "has_build": {
+                      "type": "boolean",
+                      "description": "True when the account has built at least one object on this network."
+                    },
+                    "permissions": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "services": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "machines": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "treasuries": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "rewards": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "contacts": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "arbitrations": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "network",
+                    "has_build",
+                    "permissions",
+                    "services",
+                    "machines",
+                    "treasuries",
+                    "rewards",
+                    "contacts",
+                    "arbitrations"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Build status on the target network (e.g. mainnet)."
+                },
+                "migration_checklist": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Key settings to confirm/change when migrating testnet → mainnet (payment token, location, arbitration, WIP, gas)."
+                }
+              },
+              "required": [
+                "action",
+                "account",
+                "source_network",
+                "target_network",
+                "source",
+                "target",
+                "migration_checklist"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "query_type",
+            "result"
+          ],
+          "additionalProperties": false
         }
       ]
     },

package/dist/schemas/query_toolkit.schema.json

@@ -1238,6 +1238,24 @@
       "additionalProperties": false,
       "description": "Business Relationship Graph (K3/19): derive ONE account's full relationship web from on-chain power carriers (Permission memberships, Machine forwards, Orders, Demand presenters, Allocation sharing, Arbitration bindings, Contact ims). Each edge carries the three dimensions — 权属 power (what each side CAN do, and where that power lives on-chain), 利益 interest (gains/exposures, with registry-declared goal tensions like principal-agent divergence), and 价值交互 value flows (escrow → allocation → payment chains). Read-only; roles are DERIVED from chain data, never asserted."
     },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "scenario_topology"
+        },
+        "chain_id": {
+          "description": "Optional scenario-chain id (chain.standard_ecommerce | chain.procurement_tender | chain.data_subscription | chain.collaborative_operations). When given, only that chain is returned; otherwise ALL scenario chains + bridges are returned.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "query_type"
+      ],
+      "additionalProperties": false,
+      "description": "Scenario Topology knowledge (K3 03 §3.5 / Part 2): the STATIC registry of how WoWok objects INTEGRATE each other. Bridges weld object pairs into a capability that belongs to no single object (e.g. Demand.present(service) grants MATCHMAKING); chains compose bridges into whole applications (e.g. standard e-commerce, procurement tender). Pure knowledge, read-only — no on-chain reads. Use to explain HOW a business scenario is assembled from on-chain objects and why the integration (not the objects themselves) yields the capability."
+    },
     {
       "type": "object",
       "properties": {
@@ -1307,6 +1325,47 @@
       ],
       "additionalProperties": false,
       "description": "Like / Favor list for ONE account (client Quick Access 'Like / Favor' tab) — every address (object OR plain user) the account has EVER liked / disliked / favored, deduplicated, with the CURRENT active vote kinds per target. Deterministic source: the voter's own Resource mark table (registrar.move handle_vote → resource::tag_set), cross-read with the target's EntityLinker votes for the 'marked at' clock. Fully-toggled-off targets are dropped. Each row: address + tags (like/dislike/favor) + time + object_type (null = plain user) + local name / description / tags. Aggregation result is TTL-cached (120s, keyed by network + account). Read-only."
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "migration_preflight"
+        },
+        "no_cache": {
+          "description": "Set to true to bypass the SDK chain-read cache.",
+          "type": "boolean"
+        },
+        "account": {
+          "type": "string",
+          "description": "Account address (or name) to check. Required when query_type='migration_preflight'."
+        },
+        "source_network": {
+          "description": "Source network to detect an existing build (default 'testnet').",
+          "type": "string",
+          "enum": [
+            "testnet",
+            "mainnet",
+            "localnet"
+          ]
+        },
+        "target_network": {
+          "description": "Target network for the migration (default 'mainnet').",
+          "type": "string",
+          "enum": [
+            "testnet",
+            "mainnet",
+            "localnet"
+          ]
+        }
+      },
+      "required": [
+        "query_type",
+        "account"
+      ],
+      "additionalProperties": false,
+      "description": "Cross-network build detection + mainnet customization preflight (first-touch migration): detect whether the account has already built Services/Machines/etc. on the source network (default testnet), report the same on the target network (default mainnet), and return a business-facing checklist of the key settings to confirm/change when migrating — payment token, location, arbitration, WIP, gas. Read-only."
     }
   ]
 }

package/dist/schemas/schema_query.output.json

@@ -40,69 +40,6 @@
           },
           "description": "List of schema summaries (list/search/list_operations)."
         },
-        {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "file": {
-                "type": "string",
-                "description": "Example file name (e.g. 'rental-ziroom-service-create.json')."
-              },
-              "title": {
-                "type": "string",
-                "description": "Human-readable title from the example metadata."
-              },
-              "description": {
-                "type": "string",
-                "description": "Longer description from the example metadata."
-              },
-              "tags": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "Tags from the example metadata."
-              },
-              "industry": {
-                "type": "string",
-                "description": "Industry category (e.g. 'rental', 'retail', 'general')."
-              },
-              "operation_type": {
-                "type": "string",
-                "description": "Operation type (e.g. 'service', 'machine', 'guard', 'permission')."
-              },
-              "verified": {
-                "type": "boolean",
-                "description": "Whether the example is marked as verified."
-              },
-              "score": {
-                "type": "number",
-                "description": "Relevance score — number of fields that matched the query (0-5)."
-              },
-              "matched_fields": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "List of fields that matched the query."
-              }
-            },
-            "required": [
-              "file",
-              "title",
-              "description",
-              "tags",
-              "industry",
-              "operation_type",
-              "verified",
-              "score",
-              "matched_fields"
-            ],
-            "additionalProperties": false
-          },
-          "description": "List of matching examples (search_examples)."
-        },
         {
           "type": "object",
           "propertyNames": {
@@ -116,7 +53,7 @@
           "description": "No data — lookup failed or returned nothing, or data was written to output_file."
         }
       ],
-      "description": "Response data — array of schema summaries for list-like actions, array of example results for search_examples, JSON Schema object for get/get_output/get_field, Guard template data for get_guard_templates, null on failure or when output_file is used."
+      "description": "Response data — array of schema summaries for list-like actions, JSON Schema object for get/get_output/get_field, Guard template data for get_guard_templates, null on failure or when output_file is used."
     },
     "message": {
       "type": "string",