@wowok/agent-mcp 2.3.14 → 2.3.16

package/dist/schema/local/index.js

@@ -1,6 +1,18 @@
 import { EntrypointSchema, ObjectOwnerSchema, NameOrAddressSchema, NameSchema, WowAddressSchema, TokenTypeSchema, FaucetNetworkSchema } from "../common/index.js";
 import { z } from "zod";
 const SemanticSummarySchema = z.any();
+const LocalOperationErrorFields = {
+    error_code: z
+        .enum([
+        "invalid_parameter", "guard_rejected", "state_conflict",
+        "insufficient_balance", "object_not_found", "permission_denied",
+        "immutable_violation", "network_error", "unknown",
+    ])
+        .optional()
+        .describe("Error classification for programmatic recovery"),
+    retryable: z.boolean().optional().describe("Whether the operation can be retried as-is"),
+    recovery_hint: z.string().optional().describe("Recovery suggestion for AI or user"),
+};
 export const LocalMarkConstraints = {
     nameMaxLength: 64,
     tagMaxLength: 64,
@@ -59,7 +71,7 @@ export const WowEventSchema = z.discriminatedUnion("bcsEncoding", [
     z.object({
         id: EventIdSchema.describe("Event ID"),
         packageId: z.string().describe("Package ID where event originated"),
-        parsedJson: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()])).describe("Parsed JSON value of the event"),
+        parsedJson: z.record(z.string(), z.unknown()).describe("Parsed JSON value of the event"),
         sender: z.string().describe("Sender's address"),
         timestampMs: z.union([z.string(), z.null()]).optional().describe("UTC timestamp in milliseconds since epoch"),
         transactionModule: z.string().describe("Module where event originated"),
@@ -70,7 +82,7 @@ export const WowEventSchema = z.discriminatedUnion("bcsEncoding", [
     z.object({
         id: EventIdSchema.describe("Event ID"),
         packageId: z.string().describe("Package ID where event originated"),
-        parsedJson: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()])).describe("Parsed JSON value of the event"),
+        parsedJson: z.record(z.string(), z.unknown()).describe("Parsed JSON value of the event"),
         sender: z.string().describe("Sender's ID"),
         timestampMs: z.union([z.string(), z.null()]).optional().describe("UTC timestamp in milliseconds since epoch"),
         transactionModule: z.string().describe("Module where event originated"),
@@ -231,7 +243,7 @@ export const MarkParamSchema = z
             .describe("If true, replace existing mark with same name; if false (default), throw error when name exists"),
     })
         .optional()
-        .describe("Mark naming configuration"),
+        .describe("Mark naming configuration. MUST be an object {value: string, replaceExistName?: boolean}, NOT a plain string. Example: {name: {value: 'my-account', replaceExistName: true}}"),
     address: WowAddressSchema,
     tags: z
         .array(z
@@ -241,7 +253,7 @@ 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.");
+    .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.");
 export const MarkDataSchema = z
     .object({
     name: z
@@ -672,7 +684,13 @@ export const LocalMarkOperationSchema = z
         .optional()
         .describe("Remove all marks"),
 })
-    .describe("Local mark operations. Exactly one operation type (add/remove/clear) must be specified.");
+    .refine((data) => data.add !== undefined || data.remove !== undefined || data.clear !== undefined, {
+    message: "Exactly one operation field (add/remove/clear) must be specified. " +
+        "CORRECT format: {add: {op:'add', data:[...]}} or {remove: {op:'remove', names:[...]}} or {clear: {op:'clear'}}. " +
+        "INCORRECT flat format {op:'add', data:[...]} will silently do nothing.",
+})
+    .describe("Local mark operations. Exactly one operation type (add/remove/clear) must be specified as a NESTED field. " +
+    "Example: {add: {op:'add', data:[...]}} — NOT flat {op:'add', data:[...]}.");
 export const LocalMarkOperationResultSchema = z.object({
     clear: z.boolean().optional().describe("Whether all marks were successfully removed"),
     add: z.array(MarkDataSchema).optional().describe("List of added mark data"),
@@ -717,7 +735,13 @@ export const LocalInfoOperationSchema = z
         .optional()
         .describe("Remove all info entries"),
 })
-    .describe("Local info operations. Exactly one operation type (add/remove/reset/clear) must be specified.");
+    .refine((data) => data.add !== undefined || data.remove !== undefined || data.reset !== undefined || data.clear !== undefined, {
+    message: "Exactly one operation field (add/remove/reset/clear) must be specified. " +
+        "CORRECT format: {add: {op:'add', data:[...]}} or {remove: {op:'remove', data:[...]}} etc. " +
+        "INCORRECT flat format {op:'add', data:[...]} will silently do nothing.",
+})
+    .describe("Local info operations. Exactly one operation type (add/remove/reset/clear) must be specified as a NESTED field. " +
+    "Example: {add: {op:'add', data:[...]}} — NOT flat {op:'add', data:[...]}.");
 export const LocalInfoOperationResultSchema = z.object({
     success: z.boolean().describe("Whether successful"),
 }).describe("Results of local info operations");
@@ -828,6 +852,7 @@ export const AccountOperationOutputSchema = z.discriminatedUnion("status", [
     z.object({
         status: z.literal("error"),
         error: z.string().describe("Error message"),
+        ...LocalOperationErrorFields,
     }),
 ]).describe("Account operation output schema with discriminator");
 export const AccountOperationOutputWrappedSchema = z.object({
@@ -842,6 +867,7 @@ export const LocalMarkOperationOutputSchema = z.discriminatedUnion("status", [
     z.object({
         status: z.literal("error"),
         error: z.string().describe("Error message"),
+        ...LocalOperationErrorFields,
     }),
 ]).describe("Local mark operation output schema with discriminator");
 export const LocalMarkOperationOutputWrappedSchema = z.object({
@@ -856,6 +882,7 @@ export const LocalInfoOperationOutputSchema = z.discriminatedUnion("status", [
     z.object({
         status: z.literal("error"),
         error: z.string().describe("Error message"),
+        ...LocalOperationErrorFields,
     }),
 ]).describe("Local info operation output schema with discriminator");
 export const LocalInfoOperationOutputWrappedSchema = z.object({