@wowok/agent-mcp 2.4.3 → 2.5.0

package/dist/knowledge/tools-reference.js

@@ -0,0 +1,151 @@
+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, guard instructions, network, value types, bridge tokens.",
+        actions: ["constants", "permissions", "guard", "network", "value_types", "bridge_tokens"],
+        notes: ["Read-only — authoritative protocol reference."],
+    },
+    {
+        name: "schema_query",
+        summary: "Look up JSON Schemas for MCP tools and on-chain operations — the authoritative reference.",
+        actions: ["list", "get", "get_output", "search", "list_operations"],
+        notes: ["Always check schema before calling an unfamiliar tool."],
+    },
+    {
+        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 namespace + object dependency graph (DAG) + GLM5 C1-C4 composite actions.",
+        actions: ["list_projects", "list_objects", "shareable", "dependencies", "referenced_by", "pre_publish_check", "cross_project_refs", "graph_stats", "save_graph", "load_graph", "analyze_intent", "aggregate_risks", "generate_deployment_doc", "trace_substeps"],
+        notes: [
+            "GLM5: C1-C4 actions drive the 5-stage project-based deployment flow.",
+            "Non-blocking: only CRITICAL risks block; HIGH/MEDIUM/LOW are advisory.",
+        ],
+    },
+    {
+        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?'."],
+    },
+];
+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 ?? [],
+    };
+}

package/dist/knowledge/treasury-confirm.d.ts

@@ -0,0 +1,133 @@
+import { type TreasuryRiskAssessment } from "./treasury-risk.js";
+export type TreasuryConfirmGateStatus = "approved" | "blocked_checklist" | "blocked_risk" | "blocked_user" | "blocked_environment";
+export interface TreasuryConfirmGateResult {
+    status: TreasuryConfirmGateStatus;
+    checklist_result: TreasuryChecklistResult;
+    risk_result?: TreasuryRiskAssessment;
+    user_confirmation?: TreasuryUserConfirmation;
+    environment_result?: TreasuryEnvironmentResult;
+    confirmation_text?: string;
+    block_reason?: string;
+    decision_record: TreasuryDecisionRecord;
+}
+export interface TreasuryChecklistResult {
+    all_passed: boolean;
+    items: TreasuryChecklistItem[];
+}
+export interface TreasuryChecklistItem {
+    id: string;
+    description: string;
+    passed: boolean;
+    message: string;
+}
+export interface TreasuryUserConfirmation {
+    questions_asked: TreasuryConfirmationQuestion[];
+    responses: TreasuryConfirmationResponse[];
+    all_confirmed: boolean;
+}
+export interface TreasuryConfirmationQuestion {
+    id: string;
+    question: string;
+    requires_explicit_yes: boolean;
+    related_risk_ids?: string[];
+}
+export interface TreasuryConfirmationResponse {
+    question_id: string;
+    response: "yes" | "no" | "skip";
+}
+export interface TreasuryEnvironmentResult {
+    passed: boolean;
+    checks: {
+        name: string;
+        passed: boolean;
+        message: string;
+    }[];
+}
+export interface TreasuryDecisionRecord {
+    timestamp: string;
+    gate_version: string;
+    final_status: TreasuryConfirmGateStatus;
+    layers_passed: string[];
+    layers_failed: string[];
+}
+export interface TreasuryJsonForConfirm {
+    object?: string | object | null;
+    description?: string;
+    deposit?: {
+        coin?: {
+            balance?: string;
+            coin_object?: string;
+        };
+        by_external_deposit_guard?: string;
+        payment_info?: {
+            remark?: string;
+            index: number;
+        };
+    };
+    withdraw?: {
+        amount?: {
+            fixed?: string;
+            by_external_withdraw_guard?: string;
+        };
+        recipient?: string;
+        payment_info?: {
+            remark?: string;
+            index: number;
+        };
+    };
+    external_deposit_guard?: {
+        op: "add" | "set";
+        guards: {
+            guard: string;
+            identifier?: number | null;
+            store_from_id?: number | null;
+        }[];
+    } | {
+        op: "remove";
+        guards: string[];
+    } | {
+        op: "clear";
+    };
+    external_withdraw_guard?: {
+        op: "add" | "set";
+        guards: {
+            guard: string;
+            identifier?: number | null;
+            store_from_id?: number | null;
+        }[];
+    } | {
+        op: "remove";
+        guards: string[];
+    } | {
+        op: "clear";
+    };
+    receive?: string[] | "recently";
+    owner_receive?: string[] | "recently";
+    um?: string | null;
+}
+export interface TreasuryConfirmGateInput {
+    treasury_json: TreasuryJsonForConfirm;
+    intent?: string;
+    type_parameter?: string;
+    permission_address?: string;
+    current_balance?: string;
+    current_external_deposit_guard_count?: number;
+    current_external_withdraw_guard_count?: number;
+    shared_with_service?: boolean;
+    shared_with_allocator?: boolean;
+    shared_with_arbitration?: boolean;
+    current_permission_indexes_granted?: number[];
+    skip_user_confirmation?: boolean;
+    skip_environment_check?: boolean;
+}
+export declare const TREASURY_PUBLISH_CHECKLIST: TreasuryChecklistItem[];
+export declare const TREASURY_CONFIRMATION_QUESTIONS: TreasuryConfirmationQuestion[];
+export declare const TREASURY_CONFIRM_VERSION = "1.0.0";
+export declare function runTreasuryConfirmGate(input: TreasuryConfirmGateInput): TreasuryConfirmGateResult;
+export interface ProgressiveTreasuryCheckResult {
+    stage: "checklist" | "risk" | "confirmation" | "environment" | "complete";
+    status: "pass" | "fail" | "pending";
+    message: string;
+    next_action?: string;
+}
+export declare function progressiveTreasuryCheck(input: TreasuryConfirmGateInput): ProgressiveTreasuryCheckResult;