@wowok/agent-mcp 2.7.1 → 2.7.2

package/dist/knowledge/tools-reference.js

@@ -1,178 +1 @@
-export const TOOLS_REFERENCE = [
-    {
-        name: "onchain_operations",
-        summary: "On-chain object creation, modification, and publish for all 16 Wowok object types.",
-        actions: ["service", "machine", "guard", "permission", "reward", "arb", "progress", "treasury", "demand", "repository", "contact", "order", "allocation", "personal", "payment", "proof", "gen_passport", "gen_proof"],
-        common_params: {
-            operation_type: "Object type to create/modify (string enum).",
-            data: "Operation payload — shape varies by operation_type.",
-            object: "Object name or address (for modify-by-id).",
-            namedNew: "New object spec (name, description, tags) for create.",
-            env: "Execution environment (account, network, gas_budget).",
-        },
-        prerequisites: ["account_operation (for account setup)"],
-        follow_ups: ["query_toolkit (verify result)", "local_mark_operation (tag object)"],
-        notes: [
-            "publish=true is irreversible — use confirm_gate.",
-            "Service/Machine require publish after create before they are visible on-chain.",
-            "Use schema_query with action='list_operations' to see all operation schemas.",
-        ],
-    },
-    {
-        name: "account_operation",
-        summary: "Local wallet management — generate, suspend, resume, faucet, sign data.",
-        actions: ["gen", "resume", "suspend", "faucet", "operate", "sign", "list", "info"],
-        common_params: {
-            name: "Account name (local identifier).",
-            network: "mainnet | testnet (determines RPC).",
-        },
-        prerequisites: [],
-        follow_ups: ["onchain_operations (use account for signing)"],
-        notes: [
-            "100% LOCAL — keys never leave the device.",
-            "faucet only works on testnet.",
-        ],
-    },
-    {
-        name: "local_mark_operation",
-        summary: "Local address book — map human-readable names to blockchain addresses with tags.",
-        actions: ["add", "remove", "update", "list", "query"],
-        common_params: { name: "Local name.", address: "Blockchain address.", tags: "Tag array." },
-        notes: ["100% LOCAL — never on-chain.", "Used by project_service for project: tag auto-injection."],
-    },
-    {
-        name: "local_info_operation",
-        summary: "Local private data management — delivery addresses, phone numbers, contacts.",
-        actions: ["add", "remove", "update", "list"],
-        notes: ["100% LOCAL — sensitive data, never on-chain."],
-    },
-    {
-        name: "wip_file",
-        summary: "Witness Immutable Promise file operations — generate, verify, sign, convert.",
-        actions: ["generate", "verify", "sign", "wip2html"],
-        notes: ["WIP hash must be non-empty — compute actual hash before calling."],
-    },
-    {
-        name: "messenger_operation",
-        summary: "Encrypted messenger — watch/send messages, WTS, friendslist, blacklist, guardlist.",
-        actions: ["watch_conversations", "send_message", "send_file", "watch_messages", "extract_zip", "gen_wts", "verify_wts", "sign_wts", "wts2html", "proof_message", "manage_blacklist", "manage_friendslist", "manage_guardlist", "settings", "mark_viewed", "pull_messages"],
-        notes: ["Requires messenger-enabled account.", "30s timeout — network operations."],
-    },
-    {
-        name: "guard2file",
-        summary: "Export a Guard object's definition to local JSON/Markdown for editing.",
-        notes: ["Read-only — use query_toolkit for on-chain queries."],
-    },
-    {
-        name: "machineNode2file",
-        summary: "Export a Machine object's node definition to local JSON/Markdown for editing.",
-        notes: ["Read-only — use query_toolkit for on-chain queries."],
-    },
-    {
-        name: "query_toolkit",
-        summary: "9-query-type toolkit covering local device data and on-chain blockchain data.",
-        actions: ["local_mark_list", "account_list", "local_info_list", "token_list", "account_balance", "local_names", "onchain_personal_profile", "onchain_objects", "onchain_received"],
-        notes: ["Read-only — safe to call without confirmation."],
-    },
-    {
-        name: "onchain_table_data",
-        summary: "Dynamic table data queries — paginated table queries and specific table item lookups.",
-        actions: ["onchain_table", "onchain_table_item_repository_data", "onchain_table_item_permission_perm", "onchain_table_item_entity_registrar", "onchain_table_item_entity_linker", "onchain_table_item_reward_record", "onchain_table_item_demand_presenter", "onchain_table_item_treasury_history", "onchain_table_item_machine_node", "onchain_table_item_progress_history", "onchain_table_item_address_mark", "onchain_table_item_generic"],
-        notes: ["Read-only — safe for exploration."],
-    },
-    {
-        name: "onchain_events",
-        summary: "Watch on-chain events by type — arbitration, order, progress, demand, entity.",
-        notes: ["Read-only — use cursor for pagination."],
-    },
-    {
-        name: "wowok_buildin_info",
-        summary: "Protocol info — constants, built-in permissions, common mistakes, guard instructions, network, value types, bridge tokens.",
-        actions: ["constants", "built-in permissions", "common mistakes", "guard instructions", "current network", "value types", "mainnet bridge tokens"],
-        notes: ["Read-only — authoritative protocol reference.", "Use 'common mistakes' before submitting an operation to learn known field-name/unit/workflow pitfalls."],
-    },
-    {
-        name: "schema_query",
-        summary: "Look up JSON Schemas for MCP tools and on-chain operations — the authoritative reference. Also serves sunk knowledge: tool reference, Guard design patterns, safety rules.",
-        actions: ["list", "get", "get_output", "get_field", "search", "list_operations", "get_guard_templates", "search_examples", "get_tool_reference", "get_guard_design_patterns", "get_safety_rules"],
-        notes: ["Always check schema before calling an unfamiliar tool.", "get_field takes a dot-path (field_path) for single-field lookup; search_examples finds verified example files by keyword.", "get_tool_reference/get_guard_design_patterns/get_safety_rules expose the knowledge sunk from the wowok-tools/guard/safety skills — no skills installation required."],
-    },
-    {
-        name: "bridge_operation",
-        summary: "Cross-chain bridge between WOW and EVM (Ethereum mainnet). Mainnet only.",
-        actions: ["cross_chain_wow_to_evm", "cross_chain_evm_to_wow", "withdraw", "query_active_evm_account", "query_supported_evm_chains", "query_supported_tokens", "query_transfer_list", "query_transfer_status", "manage_evm_rpc"],
-        notes: ["Only WOW mainnet provides cross-chain functionality."],
-    },
-    {
-        name: "project_operation",
-        summary: "Project entity management (SQLite) + 3-pathway graph construction + dual rule-based/LLM-assisted evaluation engine + industry mode recommendation/registry + C1-C4 intent/risk/substep pipeline.",
-        actions: ["list_projects", "create_project", "create_project_from_onchain", "update_project", "get_project_detail", "add_object", "remove_object", "create_version", "build_graph", "get_graph", "evaluate_project", "save_evaluation", "compare_projects", "refresh_objects", "get_object_diff", "assemble_context", "recommend_industry", "list_modes", "derive_user_mode", "evolve_user_mode", "register_user_mode", "unregister_user_mode", "register_custom_metric", "register_custom_constraint", "list_metrics_constraints", "analyze_intent", "aggregate_risks", "trace_substeps"],
-        notes: [
-            "GLM6: Projects are first-class entities with SQLite persistence, rigid project-object relationships.",
-            "Evaluation: risk/trust/completeness are rule-based (computed locally). value/worth_buying require LLM assistance (returns a prompt).",
-            "Graph: 3 pathways — internal references (configurable depth), Registrar inbound (O(1)), potential relationships.",
-            "E.7: call recommend_industry BEFORE create_project when the user describes a business without naming an industry — returns top-3 industries + reference examples.",
-            "E.2: user modes — derive_user_mode customizes a builtin mode; register_user_mode registers fully custom; R-M1-11 enforced on machine_shape.",
-            "C1-C4 pipeline (GLM5-31 §V3/V4): analyze_intent (intent → objects + puzzle snapshots) → aggregate_risks (puzzles OR intent → calibrated risks + RISK_BLOCKED status; optional planned_objects/planned_operations safety checks) → trace_substeps (substep records → DAG coherence + D-10 verdict). All three are pure transformations — no I/O, no confirmation needed.",
-        ],
-    },
-    {
-        name: "config_operation",
-        summary: "Runtime service toggles — enable/disable Phase 2 services without restart.",
-        actions: ["list", "toggle", "enable", "disable", "reset", "info"],
-        notes: ["GLM5: harness is default ON with tiered enforcement (off/lightweight/full)."],
-    },
-    {
-        name: "trust_score",
-        summary: "Service trust & risk assessment — 5 trust dimensions + 4 risk dimensions.",
-        notes: ["Use when user asks 'is this service trustworthy?' or 'should I buy?'."],
-    },
-    {
-        name: "query_task_status",
-        summary: "Query async task status (build_graph / evaluate_project with async_mode).",
-        notes: ["Read-only; tasks are ephemeral (retained 5 min after completion)."],
-    },
-    {
-        name: "evaluation_operation",
-        summary: "Pluggable business evaluations — risk / match / compose / game with user injection.",
-        actions: ["service_risk", "demand_match", "service_match", "capability_gap", "compose_service", "node_game", "arb_game"],
-        notes: ["Read-only; the role decides and acts via onchain_operations."],
-    },
-    {
-        name: "persona_operation",
-        summary: "User identity setting (persona) — preferences, strategy, rules, spec; long-term + current layers.",
-        actions: ["get", "list", "set", "analyze", "apply", "remove"],
-        notes: ["Read/write local state; account persona overrides system; current overrides long-term."],
-    },
-    {
-        name: "intent_radar",
-        summary: "User business intent × chain event matching — persist intents, score events against them.",
-        actions: ["save", "list", "remove", "match"],
-        notes: ["Read-only w.r.t. chain; industry/keywords resolved once at save; events supplied or auto-pulled."],
-    },
-];
-export function getToolReference(name) {
-    return TOOLS_REFERENCE.find((t) => t.name === name);
-}
-export function searchToolReference(query) {
-    const q = query.toLowerCase();
-    return TOOLS_REFERENCE.filter((t) => {
-        if (t.name.toLowerCase().includes(q))
-            return true;
-        if (t.summary.toLowerCase().includes(q))
-            return true;
-        if (t.actions?.some((a) => a.toLowerCase().includes(q)))
-            return true;
-        return false;
-    });
-}
-export function getToolSequence(name) {
-    const entry = getToolReference(name);
-    if (!entry)
-        return undefined;
-    return {
-        prerequisites: entry.prerequisites ?? [],
-        tool: entry.name,
-        follow_ups: entry.follow_ups ?? [],
-    };
-}
+export const TOOLS_REFERENCE=[{'name':'onchain_operations','summary':'On-chain\x20object\x20creation,\x20modification,\x20and\x20publish\x20for\x20all\x2016\x20Wowok\x20object\x20types.','actions':['service','machine','guard','permission','reward','arb','progress','treasury','demand','repository','contact','order','allocation','personal','payment','proof','gen_passport','gen_proof'],'common_params':{'operation_type':'Object\x20type\x20to\x20create/modify\x20(string\x20enum).','data':'Operation\x20payload\x20—\x20shape\x20varies\x20by\x20operation_type.','object':'Object\x20name\x20or\x20address\x20(for\x20modify-by-id).','namedNew':'New\x20object\x20spec\x20(name,\x20description,\x20tags)\x20for\x20create.','env':'Execution\x20environment\x20(account,\x20network,\x20gas_budget).'},'prerequisites':['account_operation\x20(for\x20account\x20setup)'],'follow_ups':['query_toolkit\x20(verify\x20result)','local_mark_operation\x20(tag\x20object)'],'notes':['publish=true\x20is\x20irreversible\x20—\x20use\x20confirm_gate.','Service/Machine\x20require\x20publish\x20after\x20create\x20before\x20they\x20are\x20visible\x20on-chain.','Use\x20schema_query\x20with\x20action=\x27list_operations\x27\x20to\x20see\x20all\x20operation\x20schemas.']},{'name':'account_operation','summary':'Local\x20wallet\x20management\x20—\x20generate,\x20suspend,\x20resume,\x20faucet,\x20sign\x20data.','actions':['gen','resume','suspend','faucet','operate','sign','list','info'],'common_params':{'name':'Account\x20name\x20(local\x20identifier).','network':'mainnet\x20|\x20testnet\x20(determines\x20RPC).'},'prerequisites':[],'follow_ups':['onchain_operations\x20(use\x20account\x20for\x20signing)'],'notes':['100%\x20LOCAL\x20—\x20keys\x20never\x20leave\x20the\x20device.','faucet\x20only\x20works\x20on\x20testnet.']},{'name':'local_mark_operation','summary':'Local\x20address\x20book\x20—\x20map\x20human-readable\x20names\x20to\x20blockchain\x20addresses\x20with\x20tags.','actions':['add','remove','update','list','query'],'common_params':{'name':'Local\x20name.','address':'Blockchain\x20address.','tags':'Tag\x20array.'},'notes':['100%\x20LOCAL\x20—\x20never\x20on-chain.','Used\x20by\x20project_service\x20for\x20project:\x20tag\x20auto-injection.']},{'name':'local_info_operation','summary':'Local\x20private\x20data\x20management\x20—\x20delivery\x20addresses,\x20phone\x20numbers,\x20contacts.','actions':['add','remove','update','list'],'notes':['100%\x20LOCAL\x20—\x20sensitive\x20data,\x20never\x20on-chain.']},{'name':'wip_file','summary':'Witness\x20Immutable\x20Promise\x20file\x20operations\x20—\x20generate,\x20verify,\x20sign,\x20convert.','actions':['generate','verify','sign','wip2html'],'notes':['WIP\x20hash\x20must\x20be\x20non-empty\x20—\x20compute\x20actual\x20hash\x20before\x20calling.']},{'name':'messenger_operation','summary':'Encrypted\x20messenger\x20—\x20watch/send\x20messages,\x20WTS,\x20friendslist,\x20blacklist,\x20guardlist.','actions':['watch_conversations','send_message','send_file','watch_messages','extract_zip','gen_wts','verify_wts','sign_wts','wts2html','proof_message','manage_blacklist','manage_friendslist','manage_guardlist','settings','mark_viewed','pull_messages'],'notes':['Requires\x20messenger-enabled\x20account.','30s\x20timeout\x20—\x20network\x20operations.']},{'name':'guard2file','summary':'Export\x20a\x20Guard\x20object\x27s\x20definition\x20to\x20local\x20JSON/Markdown\x20for\x20editing.','notes':['Read-only\x20—\x20use\x20query_toolkit\x20for\x20on-chain\x20queries.']},{'name':'machineNode2file','summary':'Export\x20a\x20Machine\x20object\x27s\x20node\x20definition\x20to\x20local\x20JSON/Markdown\x20for\x20editing.','notes':['Read-only\x20—\x20use\x20query_toolkit\x20for\x20on-chain\x20queries.']},{'name':'query_toolkit','summary':'9-query-type\x20toolkit\x20covering\x20local\x20device\x20data\x20and\x20on-chain\x20blockchain\x20data.','actions':['local_mark_list','account_list','local_info_list','token_list','account_balance','local_names','onchain_personal_profile','onchain_objects','onchain_received'],'notes':['Read-only\x20—\x20safe\x20to\x20call\x20without\x20confirmation.']},{'name':'onchain_table_data','summary':'Dynamic\x20table\x20data\x20queries\x20—\x20paginated\x20table\x20queries\x20and\x20specific\x20table\x20item\x20lookups.','actions':['onchain_table','onchain_table_item_repository_data','onchain_table_item_permission_perm','onchain_table_item_entity_registrar','onchain_table_item_entity_linker','onchain_table_item_reward_record','onchain_table_item_demand_presenter','onchain_table_item_treasury_history','onchain_table_item_machine_node','onchain_table_item_progress_history','onchain_table_item_address_mark','onchain_table_item_generic'],'notes':['Read-only\x20—\x20safe\x20for\x20exploration.']},{'name':'onchain_events','summary':'Watch\x20on-chain\x20events\x20by\x20type\x20—\x20arbitration,\x20order,\x20progress,\x20demand,\x20entity.','notes':['Read-only\x20—\x20use\x20cursor\x20for\x20pagination.']},{'name':'wowok_buildin_info','summary':'Protocol\x20info\x20—\x20constants,\x20built-in\x20permissions,\x20common\x20mistakes,\x20guard\x20instructions,\x20network,\x20value\x20types,\x20bridge\x20tokens.','actions':['constants','built-in\x20permissions','common\x20mistakes','guard\x20instructions','current\x20network','value\x20types','mainnet\x20bridge\x20tokens'],'notes':['Read-only\x20—\x20authoritative\x20protocol\x20reference.','Use\x20\x27common\x20mistakes\x27\x20before\x20submitting\x20an\x20operation\x20to\x20learn\x20known\x20field-name/unit/workflow\x20pitfalls.']},{'name':'schema_query','summary':'Look\x20up\x20JSON\x20Schemas\x20for\x20MCP\x20tools\x20and\x20on-chain\x20operations\x20—\x20the\x20authoritative\x20reference.\x20Also\x20serves\x20sunk\x20knowledge:\x20tool\x20reference,\x20Guard\x20design\x20patterns,\x20safety\x20rules.','actions':['list','get','get_output','get_field','search','list_operations','get_guard_templates','search_examples','get_tool_reference','get_guard_design_patterns','get_safety_rules'],'notes':['Always\x20check\x20schema\x20before\x20calling\x20an\x20unfamiliar\x20tool.','get_field\x20takes\x20a\x20dot-path\x20(field_path)\x20for\x20single-field\x20lookup;\x20search_examples\x20finds\x20verified\x20example\x20files\x20by\x20keyword.','get_tool_reference/get_guard_design_patterns/get_safety_rules\x20expose\x20the\x20knowledge\x20sunk\x20from\x20the\x20wowok-tools/guard/safety\x20skills\x20—\x20no\x20skills\x20installation\x20required.']},{'name':'bridge_operation','summary':'Cross-chain\x20bridge\x20between\x20WOW\x20and\x20EVM\x20(Ethereum\x20mainnet).\x20Mainnet\x20only.','actions':['cross_chain_wow_to_evm','cross_chain_evm_to_wow','withdraw','query_active_evm_account','query_supported_evm_chains','query_supported_tokens','query_transfer_list','query_transfer_status','manage_evm_rpc'],'notes':['Only\x20WOW\x20mainnet\x20provides\x20cross-chain\x20functionality.']},{'name':'project_operation','summary':'Project\x20entity\x20management\x20(SQLite)\x20+\x203-pathway\x20graph\x20construction\x20+\x20dual\x20rule-based/LLM-assisted\x20evaluation\x20engine\x20+\x20industry\x20mode\x20recommendation/registry\x20+\x20C1-C4\x20intent/risk/substep\x20pipeline.','actions':['list_projects','create_project','create_project_from_onchain','update_project','get_project_detail','add_object','remove_object','create_version','build_graph','get_graph','evaluate_project','save_evaluation','compare_projects','refresh_objects','get_object_diff','assemble_context','recommend_industry','list_modes','derive_user_mode','evolve_user_mode','register_user_mode','unregister_user_mode','register_custom_metric','register_custom_constraint','list_metrics_constraints','analyze_intent','aggregate_risks','trace_substeps'],'notes':['GLM6:\x20Projects\x20are\x20first-class\x20entities\x20with\x20SQLite\x20persistence,\x20rigid\x20project-object\x20relationships.','Evaluation:\x20risk/trust/completeness\x20are\x20rule-based\x20(computed\x20locally).\x20value/worth_buying\x20require\x20LLM\x20assistance\x20(returns\x20a\x20prompt).','Graph:\x203\x20pathways\x20—\x20internal\x20references\x20(configurable\x20depth),\x20Registrar\x20inbound\x20(O(1)),\x20potential\x20relationships.','E.7:\x20call\x20recommend_industry\x20BEFORE\x20create_project\x20when\x20the\x20user\x20describes\x20a\x20business\x20without\x20naming\x20an\x20industry\x20—\x20returns\x20top-3\x20industries\x20+\x20reference\x20examples.','E.2:\x20user\x20modes\x20—\x20derive_user_mode\x20customizes\x20a\x20builtin\x20mode;\x20register_user_mode\x20registers\x20fully\x20custom;\x20R-M1-11\x20enforced\x20on\x20machine_shape.','C1-C4\x20pipeline\x20(GLM5-31\x20§V3/V4):\x20analyze_intent\x20(intent\x20→\x20objects\x20+\x20puzzle\x20snapshots)\x20→\x20aggregate_risks\x20(puzzles\x20OR\x20intent\x20→\x20calibrated\x20risks\x20+\x20RISK_BLOCKED\x20status;\x20optional\x20planned_objects/planned_operations\x20safety\x20checks)\x20→\x20trace_substeps\x20(substep\x20records\x20→\x20DAG\x20coherence\x20+\x20D-10\x20verdict).\x20All\x20three\x20are\x20pure\x20transformations\x20—\x20no\x20I/O,\x20no\x20confirmation\x20needed.']},{'name':'config_operation','summary':'Runtime\x20service\x20toggles\x20—\x20enable/disable\x20Phase\x202\x20services\x20without\x20restart.','actions':['list','toggle','enable','disable','reset','info'],'notes':['GLM5:\x20harness\x20is\x20default\x20ON\x20with\x20tiered\x20enforcement\x20(off/lightweight/full).']},{'name':'trust_score','summary':'Service\x20trust\x20&\x20risk\x20assessment\x20—\x205\x20trust\x20dimensions\x20+\x204\x20risk\x20dimensions.','notes':['Use\x20when\x20user\x20asks\x20\x27is\x20this\x20service\x20trustworthy?\x27\x20or\x20\x27should\x20I\x20buy?\x27.']},{'name':'query_task_status','summary':'Query\x20async\x20task\x20status\x20(build_graph\x20/\x20evaluate_project\x20with\x20async_mode).','notes':['Read-only;\x20tasks\x20are\x20ephemeral\x20(retained\x205\x20min\x20after\x20completion).']},{'name':'evaluation_operation','summary':'Pluggable\x20business\x20evaluations\x20—\x20risk\x20/\x20match\x20/\x20compose\x20/\x20game\x20with\x20user\x20injection.','actions':['service_risk','demand_match','service_match','capability_gap','compose_service','node_game','arb_game'],'notes':['Read-only;\x20the\x20role\x20decides\x20and\x20acts\x20via\x20onchain_operations.']},{'name':'persona_operation','summary':'User\x20identity\x20setting\x20(persona)\x20—\x20preferences,\x20strategy,\x20rules,\x20spec;\x20long-term\x20+\x20current\x20layers.','actions':['get','list','set','analyze','apply','remove'],'notes':['Read/write\x20local\x20state;\x20account\x20persona\x20overrides\x20system;\x20current\x20overrides\x20long-term.']},{'name':'intent_radar','summary':'User\x20business\x20intent\x20×\x20chain\x20event\x20matching\x20—\x20persist\x20intents,\x20score\x20events\x20against\x20them.','actions':['save','list','remove','match'],'notes':['Read-only\x20w.r.t.\x20chain;\x20industry/keywords\x20resolved\x20once\x20at\x20save;\x20events\x20supplied\x20or\x20auto-pulled.']}];export function getToolReference(a){return TOOLS_REFERENCE['find'](b=>b['name']===a);}export function searchToolReference(a){const b=a['toLowerCase']();return TOOLS_REFERENCE['filter'](c=>{if(c['name']['toLowerCase']()['includes'](b))return!![];if(c['summary']['toLowerCase']()['includes'](b))return!![];if(c['actions']?.['some'](d=>d['toLowerCase']()['includes'](b)))return!![];return![];});}export function getToolSequence(a){const b=getToolReference(a);if(!b)return undefined;return{'prerequisites':b['prerequisites']??[],'tool':b['name'],'follow_ups':b['follow_ups']??[]};}