@wowok/agent-mcp 2.6.0 → 2.6.3

package/dist/schema/local/index.js

@@ -7,7 +7,9 @@ const LocalOperationErrorFields = {
         .enum([
         "invalid_parameter", "guard_rejected", "state_conflict",
         "insufficient_balance", "object_not_found", "permission_denied",
-        "immutable_violation", "network_error", "unknown",
+        "immutable_violation", "network_error", "rate_limit",
+        "gas_exceeded", "bcs_error", "signature_error",
+        "config_error", "wip_verification_failed", "unknown",
     ])
         .optional()
         .describe("Error classification for programmatic recovery"),
@@ -254,7 +256,14 @@ export const MarkParamSchema = z
         .optional()
         .describe(`Tags for categorization (max ${LocalMarkConstraints.tagMaxCount} tags, each max ${LocalMarkConstraints.tagMaxLength} bcs characters)`),
 })
-    .describe("LOCAL ONLY: Parameters for creating or updating a LOCAL mark. This data is stored privately on your device and will NEVER be published to the blockchain. For public on-chain marks, use the 'personal' tool instead. IMPORTANT: 'name' field is an OBJECT {value, replaceExistName?}, not a string.");
+    .describe("LOCAL ONLY: Parameters for creating or updating a LOCAL mark. This data is stored privately on your device and will NEVER be published to the blockchain. " +
+    "For public on-chain marks, use the 'personal' tool instead. " +
+    "IMPORTANT: 'name' field is an OBJECT {value, replaceExistName?}, not a string. " +
+    "FIX-011 cross-network consistency: LocalMark names are scoped per network. " +
+    "When creating marks for the same logical object on different networks (e.g. testnet and mainnet), " +
+    "use the SAME name value to keep name-based references portable. " +
+    "Before creating a mark on mainnet, check if a mark with the same name already exists on testnet " +
+    "(via query_local with network='testnet') and replicate the same name on mainnet for consistency.");
 export const MarkDataSchema = z
     .object({
     name: z
@@ -277,7 +286,7 @@ export const MarkDataSchema = z
         .optional()
         .describe("Unix timestamp (ms) when this mark was last modified"),
 })
-    .describe("LOCAL PRIVATE: Local mark data structure for storing address names and tags privately on your device. This data is NEVER published to the blockchain.");
+    .describe("LOCAL PRIVATE: Local mark data structure for storing address names and tags privately on your device. This data is NEVER published to the blockchain. CROSS-NETWORK ISOLATION (DOC-02): LocalMark names are scoped per network — the same name 'my-service' can map to different addresses on testnet vs mainnet. When switching networks (e.g., testnet→mainnet deployment), re-create marks with the same names pointing to the new mainnet addresses. This enables name-based object references that work identically across networks without code changes.");
 export const InfoDataInnerSchema = z
     .object({
     default: z
@@ -447,11 +456,20 @@ export const AccountOperationSchema = z
         .optional()
         .describe("Generate new account"),
     faucet: z
-        .object({
+        .preprocess((val) => {
+        if (val && typeof val === 'object' && !Array.isArray(val)) {
+            const obj = val;
+            if (obj.name !== undefined && obj.name_or_address === undefined) {
+                obj.name_or_address = obj.name;
+                delete obj.name;
+            }
+        }
+        return val;
+    }, z.object({
         name_or_address: NameOrAddressSchema.optional()
             .describe("Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."),
         network: FaucetNetworkSchema,
-    })
+    }).strict())
         .optional()
         .describe("Distribute test coins from faucet to the specified account"),
     suspend: z
@@ -550,7 +568,11 @@ export const AccountOperationSchema = z
 })
     .strict()
     .refine((data) => Object.keys(data).length > 0, "At least one operation (gen/faucet/suspend/resume/rename/swap_name/transfer/get/signData/messenger) must be specified")
-    .describe("Account operations. Parameters MUST be wrapped in the operation type property (e.g. {transfer: {...}}, NOT {amount: ...}). Unwrapped parameters are rejected.");
+    .describe("Account operations (mutations only: gen/faucet/suspend/resume/rename/swap_name/transfer/get/signData/messenger). " +
+    "Parameters MUST be wrapped in the operation type property (e.g. {transfer: {...}}, NOT {amount: ...}). Unwrapped parameters are rejected. " +
+    "TO LIST ALL ACCOUNTS: use the query_toolkit tool with query_type='account_list' (returns name, address, suspended status, messenger status for all local accounts). " +
+    "This separation follows CQRS: account_operation = mutations, query_toolkit = queries. " +
+    "Common workflow after MCP restart: (1) query_toolkit query_type='account_list' to see all accounts, (2) account_operation with the appropriate mutation.");
 export const AccountOperationResultSchema = z
     .object({
     gen: z