@wowok/agent-mcp 2.3.13 → 2.3.16

package/dist/schema/local/index.js

@@ -1,5 +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,
@@ -58,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"),
@@ -69,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"),
@@ -230,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
@@ -240,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
@@ -529,7 +542,9 @@ export const AccountOperationSchema = z
         .optional()
         .describe("Enable or disable messenger for an account"),
 })
-    .describe("Account operations");
+    .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.");
 export const AccountOperationResultSchema = z
     .object({
     gen: z
@@ -669,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"),
@@ -714,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");
@@ -774,6 +801,10 @@ export const AccountFilterSchema = z
     })
         .optional()
         .describe("Filter by update time range"),
+    includePubkey: z
+        .boolean()
+        .optional()
+        .describe("Include pubkey in results (default: false). Pubkey is large (~900 bytes), omit unless needed"),
 })
     .describe("Filter criteria for querying accounts. Multiple filters are combined with AND logic.");
 export const QueryAccountListSchema = z.object({
@@ -821,10 +852,12 @@ 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({
     result: AccountOperationOutputSchema,
+    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for account operation"),
 }).describe("Account operation output wrapped schema");
 export const LocalMarkOperationOutputSchema = z.discriminatedUnion("status", [
     z.object({
@@ -834,10 +867,12 @@ 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({
     result: LocalMarkOperationOutputSchema,
+    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for local mark operation"),
 }).describe("Local mark operation output wrapped schema");
 export const LocalInfoOperationOutputSchema = z.discriminatedUnion("status", [
     z.object({
@@ -847,9 +882,11 @@ 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({
     result: LocalInfoOperationOutputSchema,
+    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for local info operation"),
 }).describe("Local info operation output wrapped schema");
 export * from "./wip.js";