@wowok/agent-mcp 2.5.5 → 2.6.1

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
@@ -429,24 +438,38 @@ export const AccountOperationSchema = z
         .object({
         name: NameSchema
             .optional()
-            .describe(`Account name (max ${AccountConstraints.nameMaxLength} characters). Use empty string '' or omit for the default account.`),
+            .describe(`Account name (max ${AccountConstraints.nameMaxLength} characters). Use empty string '' or omit for the default account. ` +
+            `Recommended convention: <role>-<number> (e.g. shop-001, user-001, arb-001) for easy filtering and batch operations.`),
         replaceExistName: z
             .boolean()
             .optional()
-            .describe("If true, existing account with the same name will lose the name; if false (default), throw error when name exists"),
-        m: z
-            .union([NameSchema, z.null()])
+            .describe("DISCOURAGED. If true, an existing account with the same name will be SUSPENDED (not just renamed) to free the name for the new account. " +
+            "The old account moves to the Suspended tab and cannot sign transactions until resumed with a new name. " +
+            "FORBIDDEN on the default account (name='' or omitted) — the default account is unique and cannot be replaced; use suspend() explicitly instead. " +
+            "Prefer versioned names (e.g. 'shop_v2') over replaceExistName for production. Default: false (throws AccountNameExist on collision)."),
+        messenger: z
+            .boolean()
             .optional()
-            .describe("Messenger name to enable messenger for this account (max 64 characters). If null, disable messenger. Omit to leave messenger unchanged."),
+            .describe("Enable messenger for this account. true=enable, false=disable, omit=unchanged. " +
+            "Account name is used for messenger identity lookup (no separate messenger name)."),
     })
         .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
@@ -536,9 +559,9 @@ export const AccountOperationSchema = z
         .object({
         name_or_account: NameOrAddressSchema.optional()
             .describe("Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."),
-        m: z
-            .union([NameSchema, z.null()])
-            .describe("Messenger name to enable messenger for this account (max 64 characters). If null, disable messenger."),
+        enabled: z
+            .boolean()
+            .describe("true to enable messenger, false to disable"),
     })
         .optional()
         .describe("Enable or disable messenger for an account"),
@@ -552,10 +575,10 @@ export const AccountOperationResultSchema = z
         .object({
         address: z.string().describe("Newly generated account ID"),
         name: NameSchema.optional().describe("Account name"),
-        m: z
-            .union([NameSchema, z.null()])
+        messenger: z
+            .boolean()
             .optional()
-            .describe("Messenger name if enabled"),
+            .describe("Messenger enabled flag"),
     })
         .optional()
         .describe("Result of generating new account"),
@@ -648,9 +671,9 @@ export const AccountOperationResultSchema = z
         .object({
         name_or_account: NameOrAddressSchema.optional()
             .describe("Account name or address"),
-        m: z
-            .union([NameSchema, z.null()])
-            .describe("Messenger name if enabled, null if disabled"),
+        enabled: z
+            .boolean()
+            .describe("Messenger enabled flag"),
     })
         .optional()
         .describe("Result of enabling or disabling messenger for an account"),
@@ -782,9 +805,6 @@ export const AccountFilterSchema = z
         .boolean()
         .optional()
         .describe("Filter accounts with messenger enabled"),
-    m: NameSchema
-        .optional()
-        .describe("Filter by messenger name (supports fuzzy match)"),
     createdAt: z
         .object({
         gte: z
@@ -828,7 +848,8 @@ export const AccountDataSchema = z.object({
     suspended: z.boolean().optional().describe("Whether account is suspended"),
     createdAt: z.number().optional().describe("Timestamp when account was created"),
     updatedAt: z.number().optional().describe("Timestamp when account was last updated"),
-    m: z.string().nullable().optional().describe("Messenger name, indicates this account has messenger enabled"),
+    messenger: z.boolean().optional().describe("Whether messenger is enabled for this account"),
+    suspendedName: z.string().optional().describe("Name before suspension (set by suspend, cleared by resume)"),
 }).describe("Account data");
 export const QueryAccountListResultSchema = z.object({
     result: z.array(AccountDataSchema).describe("Account list"),