wowok_agent 2.1.26 → 2.1.28

package/dist/index.js

@@ -8,10 +8,156 @@ import packageJson from "../package.json" with { type: "json" };
 // Import schema
 import { CallService_DataSchema, CallMachine_DataSchema, MachineNode2File_InputSchema, MachineNode2File_OutputWrappedSchema, CallProgress_DataSchema, CallPermission_DataSchema, CallGuard_DataSchema, Guard2File_InputSchema, Guard2File_OutputWrappedSchema, CallArbitration_DataSchema, CallRepository_DataSchema, CallContact_DataSchema, CallTreasury_DataSchema, CallReward_DataSchema, CallAllocation_DataSchema, CallPersonal_DataSchema, CallPayment_DataSchema, CallDemand_DataSchema, CallOrder_DataSchema, CallEnvSchema, SubmissionCallSchema, strictParse, CallOutputSchema, handleCallResult, createServerConfig, createCapabilitiesConfig, createToolMeta, transformSubmission, getEnvConfig, WipGenerationOptionsSchema, WipToHtmlOptionsSchema, TokenDataFilterSchema, LocalInfoFilterSchema, LocalMarkFilterSchema, AccountFilterSchema, TokenTypeSchema, OnchainEventsInputSchema, OnchainEventsResultSchema, ProtocolInfoQuerySchema, ProtocolInfoResultSchema, WatchQueryOperationsResultSchema, NameOrAddressSchema, AccountOrMark_AddressSchema, ObjectTypeSchema, AccountOperationOutputWrappedSchema, LocalMarkOperationOutputWrappedSchema, LocalInfoOperationOutputWrappedSchema, WipOperationOutputSchema, MessengerOperationOutputSchema, AccountOperationSchema, LocalMarkOperationSchema, LocalInfoOperationSchema, parseMachineNodesFromText, formatNodeErrors as formatMachineNodeErrors, MessengerOperationInputSchema, } from "./schema/index.js";
 // Import wowok SDK
-import { CallService, CallMachine, CallProgress, CallPermission, CallGuard, CallArbitration, CallRepository, CallContact, CallTreasury, CallReward, CallAllocation, CallPersonal, CallPayment, CallDemand, CallOrder, gen_passport, guard2file, parseGuardFile, formatGuardParseErrors, machineNode2file, generateNodeComments, generate_wip, verify_wip, sign_wip, wip2html, account_operation, local_mark_operation, local_info_operation, watch_conversations, send_message, send_file, watch_messages, extract_zip_messages, generate_wts, verify_wts, sign_wts, wts2html, proof_message, query_local_mark_list, query_account_list, query_local_info_list, query_local_token_list, query_account, query_personal, query_objects, query_table, queryProtocolInfo, query_received, queryTableItem_RepositoryData, queryTableItem_PermissionPerm, queryTableItem_RewardRecord, queryTableItem_DemandPresenter, queryTableItem_TreasuryHistory, queryTableItem_MachineNode, queryTableItem_ProgressHistory, queryTableItem_AddressMark, queryTableItem_EntityRegistrar, queryTableItem_EntityLinker, query_events, blacklist, friendslist, guardlist, settings, } from "wowok";
+import { CallService, CallMachine, CallProgress, CallPermission, CallGuard, CallArbitration, CallRepository, CallContact, CallTreasury, CallReward, CallAllocation, CallPersonal, CallPayment, CallDemand, CallOrder, gen_passport, guard2file, parseGuardFile, formatGuardParseErrors, machineNode2file, generateNodeComments, generate_wip, verify_wip, sign_wip, wip2html, account_operation, local_mark_operation, local_info_operation, watch_conversations, send_message, send_file, watch_messages, extract_zip_messages, generate_wts, verify_wts, sign_wts, wts2html, proof_message, query_local_mark_list, query_account_list, query_local_info_list, query_local_token_list, query_account, query_personal, query_objects, query_table, queryProtocolInfo, query_received, queryTableItem_RepositoryData, queryTableItem_PermissionPerm, queryTableItem_RewardRecord, queryTableItem_DemandPresenter, queryTableItem_TreasuryHistory, queryTableItem_MachineNode, queryTableItem_ProgressHistory, queryTableItem_AddressMark, queryTableItem_EntityRegistrar, queryTableItem_EntityLinker, query_events, blacklist, friendslist, guardlist, settings, AmountType, } from "wowok";
+const SERVER_DESCRIPTION = `WoWok MCP Server - Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.
+
+## Token System Overview
+
+### Default Platform Token: WOW
+- Token Type: 0x2::wow::WOW
+- Precision: 1_000_000_000 (9 decimal places)
+- This is the default token for all operations unless specified otherwise
+
+### Multi-Token Support
+The platform supports ANY token (e.g., USDT, USDC, custom tokens). To use non-WOW tokens:
+1. Use query_toolkit with query_type='token_list' to query available tokens and their precision info
+2. Use the token's full type string (e.g., '0x2::usdt::USDT') in token_type parameter
+3. Each token has its own precision - always verify before operations
+
+### Token Precision Handling
+Different tokens have different precisions. ALWAYS query to verify:
+- WOW (default): 1_000_000_000 (9 decimals)
+- Other tokens: Use query_toolkit with query_type='token_list' to get actual precision
+- Never assume a token's decimal places - always query first
+
+## CRITICAL: Token Amount Handling
+
+### Amount Input Rules
+1. WITH currency unit (e.g., '2WOW', '10.5WOW', '100USDT'):
+   - Auto-converted using token's precision: 2WOW -> 2_000_000_000
+   - Use for: All on-chain token operations
+   - MUST match the token_type parameter
+
+2. WITHOUT currency unit (e.g., '2', '100'):
+   - Used as-is: 2 -> 2
+   - Use for: Regular numeric parameters (counts, indices, etc.)
+
+### Multi-Token Operation Examples
+- Create USDT-priced Service: token_type='0x2::usdt::USDT', amount='100USDT'
+- Allocate USDC rewards: token_type='0x2::usdc::USDC', amount='500USDC'
+- WOW remains default: omit token_type or use '0x2::wow::WOW'
+
+### Security Warning
+Token amounts are HIGHLY SENSITIVE. Always:
+- Confirm user's intent before executing transfers
+- Verify token type and amount format (with/without unit)
+- Query token precision if unsure
+- Double-check large amount transactions
+- Never assume decimal places - use explicit token unit
+
+## Tool Selection Guide
+
+| User Intent | Correct Tool | Wrong Tool (Avoid) |
+|------------|--------------|-------------------|
+| Create service listing | onchain_operations (service) | query_toolkit |
+| Send coins to address | onchain_operations (payment) | account_operation |
+| Check my balance | query_toolkit (account_balance) | onchain_operations |
+| Manage local wallet | account_operation | onchain_operations |
+| Export Guard for edit | guard2file | query_toolkit |
+| Send/Watch encrypted message | messenger_operation | onchain_operations |
+| Create workflow template | onchain_operations (machine) | wip_file |
+| Store my phone number | local_info_operation | onchain_operations |
+| Buy service (create order) | onchain_operations (order) | onchain_operations (service) |
+| Manage my orders | onchain_operations (order) | query_toolkit |
+| Apply for arbitration | onchain_operations (order) | onchain_operations (arbitration) |
+| Create reward pool for marketing | onchain_operations (reward) | onchain_operations (treasury) |
+| Claim rewards from pool | onchain_operations (reward) | query_toolkit |
+| Create fund allocation plan | onchain_operations (allocation) | onchain_operations (treasury) |
+| Execute fund distribution | onchain_operations (allocation) | onchain_operations (payment) |
+| Post service demand with reward | onchain_operations (demand) | onchain_operations (service) |
+| Submit solution for demand | onchain_operations (demand) | onchain_operations (order) |
+| Create team treasury | onchain_operations (treasury) | onchain_operations (allocation) |
+| Deposit/Withdraw from treasury | onchain_operations (treasury) | onchain_operations (payment) |
+| Create access control rules | onchain_operations (permission) | onchain_operations (guard) |
+| Create validation rules (Guard) | onchain_operations (guard) | onchain_operations (permission) |
+| Export Guard for editing | guard2file | query_toolkit |
+| Export Machine nodes for editing | machineNode2file | query_toolkit |
+| Query token list and precision | query_toolkit (token_list) | wowok_buildin_info |
+| Watch on-chain events | onchain_events | query_toolkit |
+| Generate WIP promise file | wip_file (generate) | messenger_operation |
+| Sign WIP file | wip_file (sign) | account_operation (signData) |
+| Verify WIP file integrity | wip_file (verify) | query_toolkit |
+| Send encrypted file via messenger | messenger_operation (send_file) | wip_file |
+| Generate witness timestamp (WTS) | messenger_operation (generate_wts) | wip_file |
+| Query protocol constants | wowok_buildin_info | query_toolkit |
+| Get documentation URL | documents_and_learn | wowok_buildin_info |
+
+## Local vs On-chain Operations
+
+### LOCAL ONLY (Never touch blockchain):
+- account_operation
+- local_mark_operation
+- local_info_operation
+
+### ON-CHAIN (Blockchain transactions):
+- onchain_operations
+- messenger_operation (some operations)
+- wip_file (sign operation)
+
+### QUERY (Read-only):
+- query_toolkit
+- onchain_events
+- wowok_buildin_info
+- documents_and_learn
+- guard2file
+- machineNode2file
+`;
 // Create server instance
 const server = new McpServer(createServerConfig(packageJson), createCapabilitiesConfig());
 // ================================================
+// Helper Functions
+// ================================================
+/**
+ * Convert string amount type to AmountType enum
+ * Handles case-insensitive matching
+ */
+function convertAmountType(type) {
+    if (typeof type === "number")
+        return type;
+    const upperType = type.toUpperCase();
+    if (upperType === "GUARDU64IDENTIFIER" || upperType === "GUARD_U64_IDENTIFIER") {
+        return AmountType.GuardU64Identifier;
+    }
+    if (upperType === "FIXED") {
+        return AmountType.Fixed;
+    }
+    return AmountType.Fixed; // default
+}
+/**
+ * Transform reward data to convert string amount types to enum values
+ */
+function transformRewardData(data) {
+    if (!data)
+        return data;
+    const transformed = { ...data };
+    // Transform guard_add array
+    if (transformed.guard_add && Array.isArray(transformed.guard_add)) {
+        transformed.guard_add = transformed.guard_add.map((guard) => {
+            if (guard.amount && typeof guard.amount.type === "string") {
+                return {
+                    ...guard,
+                    amount: {
+                        ...guard.amount,
+                        type: convertAmountType(guard.amount.type)
+                    }
+                };
+            }
+            return guard;
+        });
+    }
+    return transformed;
+}
+// ================================================
 // Schema Definitions
 // ================================================
 // On-chain Operations Schema (Merged from Merchant and Personal Operations)
@@ -314,7 +460,9 @@ async function handleOnchainOperations(args) {
                 return handleCallResult(result);
             }
             case "reward": {
-                const callReward = new CallReward(validated.data);
+                // Transform reward data to convert string amount types to enum values
+                const transformedData = transformRewardData(validated.data);
+                const callReward = new CallReward(transformedData);
                 const result = validated.submission
                     ? await callReward.call_with_submission(env, transformSubmission(validated.submission))
                     : await callReward.call(env);
@@ -388,7 +536,57 @@ async function handleOnchainOperations(args) {
             }
             // Personal Operations
             case "personal": {
-                const callPersonal = new CallPersonal(validated.data);
+                // Transform AI-friendly string format to SDK object format
+                const transformPersonalData = (data) => {
+                    const result = { ...data };
+                    // Transform mark operations
+                    if (data.mark) {
+                        const transformAddress = (addr) => {
+                            if (typeof addr === 'string') {
+                                return { name_or_address: addr, local_mark_first: true };
+                            }
+                            return addr;
+                        };
+                        if (data.mark.op === 'add' && data.mark.data) {
+                            result.mark = {
+                                ...data.mark,
+                                data: data.mark.data.map((item) => ({
+                                    ...item,
+                                    address: transformAddress(item.address)
+                                }))
+                            };
+                        }
+                        else if (data.mark.op === 'remove' && data.mark.data) {
+                            result.mark = {
+                                ...data.mark,
+                                data: data.mark.data.map((item) => ({
+                                    ...item,
+                                    address: transformAddress(item.address)
+                                }))
+                            };
+                        }
+                        else if (data.mark.op === 'clear' && data.mark.address) {
+                            const addr = data.mark.address;
+                            if (Array.isArray(addr) && addr.every((a) => typeof a === 'string')) {
+                                result.mark = {
+                                    ...data.mark,
+                                    address: {
+                                        entities: addr.map((a) => ({ name_or_address: a, local_mark_first: true }))
+                                    }
+                                };
+                            }
+                        }
+                        else if (data.mark.op === 'transfer' && data.mark.to) {
+                            result.mark = {
+                                ...data.mark,
+                                to: transformAddress(data.mark.to)
+                            };
+                        }
+                    }
+                    return result;
+                };
+                const transformedData = transformPersonalData(validated.data);
+                const callPersonal = new CallPersonal(transformedData);
                 const result = await callPersonal.call(env);
                 return handleCallResult(result);
             }