@wowok/agent-mcp 2.5.5 → 2.6.1

package/dist/schema/call/service.d.ts

@@ -73,7 +73,7 @@ export declare const BuySchema: z.ZodObject<{
 }>;
 export declare const DiscountSchema: z.ZodObject<{
     name: z.ZodString;
-    discount_type: z.ZodUnion<[z.ZodLiteral<import("@wowok/wowok").DiscountType.RATES>, z.ZodLiteral<import("@wowok/wowok").DiscountType.FIXED>]>;
+    discount_type: z.ZodUnion<[z.ZodEnum<["RATES", "FIXED"]>, z.ZodEffects<z.ZodNumber, "FIXED" | "RATES", number>]>;
     discount_value: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
     benchmark: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     time_ms_start: z.ZodOptional<z.ZodNumber>;
@@ -115,7 +115,7 @@ export declare const DiscountSchema: z.ZodObject<{
         check_all_founded?: boolean | undefined;
     };
     count: number;
-    discount_type: import("@wowok/wowok").DiscountType;
+    discount_type: "FIXED" | "RATES";
     transferable: boolean;
     discount_value: string | number;
     time_ms_end: number;
@@ -131,7 +131,7 @@ export declare const DiscountSchema: z.ZodObject<{
         check_all_founded?: boolean | undefined;
     };
     count: number;
-    discount_type: import("@wowok/wowok").DiscountType;
+    discount_type: number | "FIXED" | "RATES";
     transferable: boolean;
     discount_value: string | number;
     time_ms_end: number;
@@ -878,7 +878,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
     }, {
         op: "clear";
     }>]>>;
-    repositories: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+    repositories: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">]>;
         objects: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
     }, "strict", z.ZodTypeAny, {
@@ -902,8 +902,16 @@ export declare const CallService_DataSchema: z.ZodObject<{
         op: "clear";
     }, {
         op: "clear";
-    }>]>>;
-    rewards: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+    }>]>, {
+        op: "set" | "add";
+        objects: string[];
+    } | {
+        op: "remove";
+        objects: string[];
+    } | {
+        op: "clear";
+    }, unknown>>;
+    rewards: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">]>;
         objects: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
     }, "strict", z.ZodTypeAny, {
@@ -927,8 +935,16 @@ export declare const CallService_DataSchema: z.ZodObject<{
         op: "clear";
     }, {
         op: "clear";
-    }>]>>;
-    arbitrations: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+    }>]>, {
+        op: "set" | "add";
+        objects: string[];
+    } | {
+        op: "remove";
+        objects: string[];
+    } | {
+        op: "clear";
+    }, unknown>>;
+    arbitrations: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">]>;
         objects: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
     }, "strict", z.ZodTypeAny, {
@@ -952,11 +968,19 @@ export declare const CallService_DataSchema: z.ZodObject<{
         op: "clear";
     }, {
         op: "clear";
-    }>]>>;
+    }>]>, {
+        op: "set" | "add";
+        objects: string[];
+    } | {
+        op: "remove";
+        objects: string[];
+    } | {
+        op: "clear";
+    }, unknown>>;
     machine: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodNull]>>;
     discount: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
-        discount_type: z.ZodUnion<[z.ZodLiteral<import("@wowok/wowok").DiscountType.RATES>, z.ZodLiteral<import("@wowok/wowok").DiscountType.FIXED>]>;
+        discount_type: z.ZodUnion<[z.ZodEnum<["RATES", "FIXED"]>, z.ZodEffects<z.ZodNumber, "FIXED" | "RATES", number>]>;
         discount_value: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
         benchmark: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
         time_ms_start: z.ZodOptional<z.ZodNumber>;
@@ -998,7 +1022,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
             check_all_founded?: boolean | undefined;
         };
         count: number;
-        discount_type: import("@wowok/wowok").DiscountType;
+        discount_type: "FIXED" | "RATES";
         transferable: boolean;
         discount_value: string | number;
         time_ms_end: number;
@@ -1014,7 +1038,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
             check_all_founded?: boolean | undefined;
         };
         count: number;
-        discount_type: import("@wowok/wowok").DiscountType;
+        discount_type: number | "FIXED" | "RATES";
         transferable: boolean;
         discount_value: string | number;
         time_ms_end: number;
@@ -1064,7 +1088,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
                     Signer: "signer";
                 }>]>;
                 sharing: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-                mode: z.ZodEnum<["Amount", "Rate", "Surplus"]>;
+                mode: z.ZodUnion<[z.ZodEnum<["Amount", "Rate", "Surplus"]>, z.ZodEffects<z.ZodNumber, "Amount" | "Rate" | "Surplus", number>]>;
             }, "strip", z.ZodTypeAny, {
                 mode: "Amount" | "Rate" | "Surplus";
                 sharing: string | number;
@@ -1079,7 +1103,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
                     Signer: "signer";
                 };
             }, {
-                mode: "Amount" | "Rate" | "Surplus";
+                mode: number | "Amount" | "Rate" | "Surplus";
                 sharing: string | number;
                 who: {
                     GuardIdentifier: number;
@@ -1115,7 +1139,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
         }, {
             guard: string;
             sharing: {
-                mode: "Amount" | "Rate" | "Surplus";
+                mode: number | "Amount" | "Rate" | "Surplus";
                 sharing: string | number;
                 who: {
                     GuardIdentifier: number;
@@ -1158,7 +1182,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
         allocators: {
             guard: string;
             sharing: {
-                mode: "Amount" | "Rate" | "Surplus";
+                mode: number | "Amount" | "Rate" | "Surplus";
                 sharing: string | number;
                 who: {
                     GuardIdentifier: number;
@@ -1350,7 +1374,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
             check_all_founded?: boolean | undefined;
         };
         count: number;
-        discount_type: import("@wowok/wowok").DiscountType;
+        discount_type: "FIXED" | "RATES";
         transferable: boolean;
         discount_value: string | number;
         time_ms_end: number;
@@ -1488,7 +1512,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
         allocators: {
             guard: string;
             sharing: {
-                mode: "Amount" | "Rate" | "Surplus";
+                mode: number | "Amount" | "Rate" | "Surplus";
                 sharing: string | number;
                 who: {
                     GuardIdentifier: number;
@@ -1542,31 +1566,15 @@ export declare const CallService_DataSchema: z.ZodObject<{
             check_all_founded?: boolean | undefined;
         };
         count: number;
-        discount_type: import("@wowok/wowok").DiscountType;
+        discount_type: number | "FIXED" | "RATES";
         transferable: boolean;
         discount_value: string | number;
         time_ms_end: number;
         benchmark?: string | number | undefined;
         time_ms_start?: number | undefined;
     } | undefined;
-    rewards?: {
-        op: "set" | "add";
-        objects: string[];
-    } | {
-        op: "remove";
-        objects: string[];
-    } | {
-        op: "clear";
-    } | undefined;
-    arbitrations?: {
-        op: "set" | "add";
-        objects: string[];
-    } | {
-        op: "remove";
-        objects: string[];
-    } | {
-        op: "clear";
-    } | undefined;
+    rewards?: unknown;
+    arbitrations?: unknown;
     pause?: boolean | undefined;
     um?: string | null | undefined;
     owner_receive?: {
@@ -1582,15 +1590,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
         id: string;
         content_raw?: any;
     }[] | undefined;
-    repositories?: {
-        op: "set" | "add";
-        objects: string[];
-    } | {
-        op: "remove";
-        objects: string[];
-    } | {
-        op: "clear";
-    } | undefined;
+    repositories?: unknown;
     customer_required?: string[] | undefined;
     location?: string | undefined;
     compensation_fund_add?: {
@@ -2057,7 +2057,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         }, {
             op: "clear";
         }>]>>;
-        repositories: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        repositories: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">]>;
             objects: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
         }, "strict", z.ZodTypeAny, {
@@ -2081,8 +2081,16 @@ export declare const CallService_InputSchema: z.ZodObject<{
             op: "clear";
         }, {
             op: "clear";
-        }>]>>;
-        rewards: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        }>]>, {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        }, unknown>>;
+        rewards: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">]>;
             objects: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
         }, "strict", z.ZodTypeAny, {
@@ -2106,8 +2114,16 @@ export declare const CallService_InputSchema: z.ZodObject<{
             op: "clear";
         }, {
             op: "clear";
-        }>]>>;
-        arbitrations: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        }>]>, {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        }, unknown>>;
+        arbitrations: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">]>;
             objects: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
         }, "strict", z.ZodTypeAny, {
@@ -2131,11 +2147,19 @@ export declare const CallService_InputSchema: z.ZodObject<{
             op: "clear";
         }, {
             op: "clear";
-        }>]>>;
+        }>]>, {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        }, unknown>>;
         machine: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodNull]>>;
         discount: z.ZodOptional<z.ZodObject<{
             name: z.ZodString;
-            discount_type: z.ZodUnion<[z.ZodLiteral<import("@wowok/wowok").DiscountType.RATES>, z.ZodLiteral<import("@wowok/wowok").DiscountType.FIXED>]>;
+            discount_type: z.ZodUnion<[z.ZodEnum<["RATES", "FIXED"]>, z.ZodEffects<z.ZodNumber, "FIXED" | "RATES", number>]>;
             discount_value: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
             benchmark: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
             time_ms_start: z.ZodOptional<z.ZodNumber>;
@@ -2177,7 +2201,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
                 check_all_founded?: boolean | undefined;
             };
             count: number;
-            discount_type: import("@wowok/wowok").DiscountType;
+            discount_type: "FIXED" | "RATES";
             transferable: boolean;
             discount_value: string | number;
             time_ms_end: number;
@@ -2193,7 +2217,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
                 check_all_founded?: boolean | undefined;
             };
             count: number;
-            discount_type: import("@wowok/wowok").DiscountType;
+            discount_type: number | "FIXED" | "RATES";
             transferable: boolean;
             discount_value: string | number;
             time_ms_end: number;
@@ -2243,7 +2267,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
                         Signer: "signer";
                     }>]>;
                     sharing: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-                    mode: z.ZodEnum<["Amount", "Rate", "Surplus"]>;
+                    mode: z.ZodUnion<[z.ZodEnum<["Amount", "Rate", "Surplus"]>, z.ZodEffects<z.ZodNumber, "Amount" | "Rate" | "Surplus", number>]>;
                 }, "strip", z.ZodTypeAny, {
                     mode: "Amount" | "Rate" | "Surplus";
                     sharing: string | number;
@@ -2258,7 +2282,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
                         Signer: "signer";
                     };
                 }, {
-                    mode: "Amount" | "Rate" | "Surplus";
+                    mode: number | "Amount" | "Rate" | "Surplus";
                     sharing: string | number;
                     who: {
                         GuardIdentifier: number;
@@ -2294,7 +2318,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
             }, {
                 guard: string;
                 sharing: {
-                    mode: "Amount" | "Rate" | "Surplus";
+                    mode: number | "Amount" | "Rate" | "Surplus";
                     sharing: string | number;
                     who: {
                         GuardIdentifier: number;
@@ -2337,7 +2361,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
             allocators: {
                 guard: string;
                 sharing: {
-                    mode: "Amount" | "Rate" | "Surplus";
+                    mode: number | "Amount" | "Rate" | "Surplus";
                     sharing: string | number;
                     who: {
                         GuardIdentifier: number;
@@ -2529,7 +2553,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
                 check_all_founded?: boolean | undefined;
             };
             count: number;
-            discount_type: import("@wowok/wowok").DiscountType;
+            discount_type: "FIXED" | "RATES";
             transferable: boolean;
             discount_value: string | number;
             time_ms_end: number;
@@ -2667,7 +2691,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
             allocators: {
                 guard: string;
                 sharing: {
-                    mode: "Amount" | "Rate" | "Surplus";
+                    mode: number | "Amount" | "Rate" | "Surplus";
                     sharing: string | number;
                     who: {
                         GuardIdentifier: number;
@@ -2721,31 +2745,15 @@ export declare const CallService_InputSchema: z.ZodObject<{
                 check_all_founded?: boolean | undefined;
             };
             count: number;
-            discount_type: import("@wowok/wowok").DiscountType;
+            discount_type: number | "FIXED" | "RATES";
             transferable: boolean;
             discount_value: string | number;
             time_ms_end: number;
             benchmark?: string | number | undefined;
             time_ms_start?: number | undefined;
         } | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
-        arbitrations?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
+        rewards?: unknown;
+        arbitrations?: unknown;
         pause?: boolean | undefined;
         um?: string | null | undefined;
         owner_receive?: {
@@ -2761,15 +2769,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
             id: string;
             content_raw?: any;
         }[] | undefined;
-        repositories?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
+        repositories?: unknown;
         customer_required?: string[] | undefined;
         location?: string | undefined;
         compensation_fund_add?: {
@@ -3132,7 +3132,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
                 check_all_founded?: boolean | undefined;
             };
             count: number;
-            discount_type: import("@wowok/wowok").DiscountType;
+            discount_type: "FIXED" | "RATES";
             transferable: boolean;
             discount_value: string | number;
             time_ms_end: number;
@@ -3312,7 +3312,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
             allocators: {
                 guard: string;
                 sharing: {
-                    mode: "Amount" | "Rate" | "Surplus";
+                    mode: number | "Amount" | "Rate" | "Surplus";
                     sharing: string | number;
                     who: {
                         GuardIdentifier: number;
@@ -3366,31 +3366,15 @@ export declare const CallService_InputSchema: z.ZodObject<{
                 check_all_founded?: boolean | undefined;
             };
             count: number;
-            discount_type: import("@wowok/wowok").DiscountType;
+            discount_type: number | "FIXED" | "RATES";
             transferable: boolean;
             discount_value: string | number;
             time_ms_end: number;
             benchmark?: string | number | undefined;
             time_ms_start?: number | undefined;
         } | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
-        arbitrations?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
+        rewards?: unknown;
+        arbitrations?: unknown;
         pause?: boolean | undefined;
         um?: string | null | undefined;
         owner_receive?: {
@@ -3406,15 +3390,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
             id: string;
             content_raw?: any;
         }[] | undefined;
-        repositories?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
+        repositories?: unknown;
         customer_required?: string[] | undefined;
         location?: string | undefined;
         compensation_fund_add?: {

package/dist/schema/call/service.js

@@ -73,7 +73,28 @@ export const CallService_DataSchema = z.object({
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects and other objects received by this object and send them to the owner of its Permission object."),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object ID or name."),
     pause: z.boolean().optional().describe("Whether to pause accepting new orders."),
-    publish: z.boolean().optional().describe("Whether to publish the Service. After publishing, customers can place orders; at the same time, service commitments such as machine, order_allocators, arbitrations, etc. will be immutable."),
+    publish: z.boolean().optional().describe("Whether to publish the Service. After publishing, customers can place orders. " +
+        "BUG-04 fix (v2.2 — verified against Move source service.move + SDK service.ts):\n" +
+        "  SDK-LOCKED after publish (checkNotPublished — cannot modify, must clone new Service):\n" +
+        "    • machine          (permanently locked — workflow template)\n" +
+        "    • order_allocators (permanently locked — fund distribution rules)\n" +
+        "    • arbitrations     (permanently locked at SDK level — dispute resolution objects)\n" +
+        "  TIME-LOCKED after publish (modifiable only after pause + setting_lock_duration elapsed):\n" +
+        "    • rewards remove/clear  (assert_not_published — time-based lock)\n" +
+        "  REMAIN MUTABLE after publish (no SDK check, no Move check):\n" +
+        "    • buy_guard            (CAN be modified after publish — purchase eligibility guard)\n" +
+        "    • setting_locked_time_add (CAN be extended — only increases, never decreases)\n" +
+        "    • sales, discount, description, location, pause, repositories,\n" +
+        "    • compensation_fund_add, customer_required, um (Contact), rewards add\n" +
+        "These 3 SDK-LOCKED fields (machine/order_allocators/arbitrations) MUST be set BEFORE publish=true.\n" +
+        "\n" +
+        "SCHEMA-03 / P0-01 fix — DEPLOYMENT WORKFLOW (two-phase, avoids circular dependency):\n" +
+        "  Phase 1 — CREATE (no publish): object={name:'my-service', type_parameter, permission} + machine + order_allocators + arbitrations.\n" +
+        "    NOTE: buy_guard can use a LocalMark NAME (not address) to break the Guard→Service circular dependency.\n" +
+        "    The name is resolved to an address at transaction build time.\n" +
+        "  Phase 2 — PUBLISH: object='my-service' (string ref) + publish=true.\n" +
+        "    All SDK-LOCKED fields must be set in Phase 1; Phase 2 only flips the publish flag.\n" +
+        "  Post-publish updates: buy_guard, sales, description, repositories (add), rewards (add), etc."),
 }).strict().describe("On-chain Service operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, type_parameter, permission, ...} to create a Service. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 export const CallService_InputSchema = z.object({
     data: CallService_DataSchema,

package/dist/schema/common/index.d.ts

@@ -43,7 +43,10 @@ export declare const ManyAccountOrMark_AddressSchema: z.ZodObject<{
     }[];
     check_all_founded?: boolean | undefined;
 }>;
-export declare const AccountOrMark_AddressAISchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+export declare const AccountOrMark_AddressAISchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, {
+    name_or_address: string;
+    local_mark_first: boolean;
+}, string>, z.ZodObject<{
     name_or_address: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     local_mark_first: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
@@ -53,7 +56,13 @@ export declare const AccountOrMark_AddressAISchema: z.ZodUnion<[z.ZodString, z.Z
     name_or_address?: string | undefined;
     local_mark_first?: boolean | undefined;
 }>]>;
-export declare const ManyAccountOrMark_AddressAISchema: z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodObject<{
+export declare const ManyAccountOrMark_AddressAISchema: z.ZodUnion<[z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">, {
+    entities: {
+        name_or_address: string;
+        local_mark_first: boolean;
+    }[];
+    check_all_founded: boolean;
+}, string[]>, z.ZodObject<{
     entities: z.ZodArray<z.ZodObject<{
         name_or_address: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         local_mark_first: z.ZodOptional<z.ZodBoolean>;

package/dist/schema/common/index.js

@@ -83,19 +83,26 @@ export const ManyAccountOrMark_AddressSchema = z.object({
     check_all_founded: z.boolean().optional().describe("Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs"),
 }).strict().describe("Used to batch find account or object IDs by name");
 export const AccountOrMark_AddressAISchema = z.union([
-    z.string().describe("Account name, address (0x...), or mark name. " +
+    NameOrAddressSchema.transform(s => ({ name_or_address: s, local_mark_first: true })).describe("Account name, address (0x...), or mark name. " +
         "When using string format, local marks are searched first. " +
         "EXAMPLE: 'alice' - searches local marks first, then global; " +
-        "EXAMPLE: '0x1234...' - uses address directly"),
+        "EXAMPLE: '0x2...' (64 hex chars) - uses address directly; " +
+        "EXAMPLE: '' - uses the default local account"),
     AccountOrMark_AddressSchema
 ]).describe("Account or address lookup. Can be a simple string (recommended for AI) " +
-    "or full object with explicit local_mark_first control");
+    "or full object with explicit local_mark_first control. " +
+    "String form auto-converts to { name_or_address: <string>, local_mark_first: true }.");
 export const ManyAccountOrMark_AddressAISchema = z.union([
-    z.array(z.string()).describe("Array of account names, addresses, or mark names. " +
-        "Local marks are searched first for each entry"),
+    z.array(NameOrAddressSchema).transform(arr => ({
+        entities: arr.map(s => ({ name_or_address: s, local_mark_first: true })),
+        check_all_founded: true,
+    })).describe("Array of account names, addresses, or mark names. " +
+        "Local marks are searched first for each entry. " +
+        "EXAMPLE: ['alice', '0x2...', 'bob']"),
     ManyAccountOrMark_AddressSchema
 ]).describe("Batch account or address lookup. Can be an array of strings (recommended for AI) " +
-    "or full object with explicit control");
+    "or full object with explicit control. " +
+    "Array form auto-converts to { entities: [...], check_all_founded: true }.");
 export const ObjectOwnerSchema = z.union([
     z.object({
         AddressOwner: z.string().describe("Address owner"),
@@ -215,7 +222,16 @@ export const ObjectTypeSchema = z.enum([
     WowObjectType.TableItem_AddressMark,
     WowObjectType.TableItem_EntityRegistrar,
 ]).describe("Wowok object type");
-export const BalanceTypeSchema = z.union([z.number(), z.string()]).describe("Balance type");
+export const BalanceTypeSchema = z.union([z.number(), z.string()]).describe("A coin/balance amount in the smallest on-chain unit (u64). " +
+    "Accepts a JS number OR a numeric string. " +
+    "PRECISION RULE: for values exceeding 2^53 (e.g. token amounts with 18 decimals), " +
+    "ALWAYS pass a numeric STRING (e.g. \"1000000000000000000\") to preserve precision — " +
+    "JS numbers lose precision above 2^53. " +
+    "UNIT: this is the smallest unit, NOT the display unit. " +
+    "For SUI: 1 SUI = 10^9 MIST, so 10 SUI = 10000000000. " +
+    "For custom tokens: use the token's native smallest unit (decimals from coin metadata). " +
+    "Examples: 10000000000 (10 SUI), \"1000000000000000000\" (1 token with 18 decimals), 500 (500 units of a token with 0 decimals). " +
+    "Used for: Service.sale.price, Service.compensation_fund_add balance, Treasury.deposit, Arbitration.fee, Reward.amount, stock quantities.");
 export const QueryIdSchema = z.number().int().min(0).describe("Query ID");
 export const CacheExpireTypeSchema = z.union([z.number(), z.literal("INFINITE")]).describe("Cache expiration time type");
 export const ValueContainerSchema = z.lazy(() => z.object({
@@ -238,18 +254,31 @@ export const GuardIdentifierSchema = z.number().int().min(0).max(255).describe("
 export const GuardTableItemBaseSchema = z.object({
     identifier: GuardIdentifierSchema,
     b_submission: z.boolean().describe("Whether user submission is required for this data"),
-    value_type: ValueTypeUserSchema.describe("Type of the value"),
-    value: SupportedValueUserSchema.optional().describe("The actual value data"),
-    name: z.string().default("").describe("Name or description of this data"),
-}).strict().describe("Guard table item");
+    value_type: ValueTypeUserSchema.describe("Type of the value stored in `value`. One of: Bool(0), Address(1), String(2), U8(3), U16(4), U32(5), U64(6), U128(7), U256(8), VecBool(9), VecAddress(10), VecString(11), VecU8(12), VecU16(13), VecU32(14), VecU64(15), VecU128(16), VecU256(17), VecVecU8(18). " +
+        "When value_type=Address (1), the `value` field accepts a hex address string, a LocalMark name, or an AccountOrMark_Address object — see `value` field description for details."),
+    value: SupportedValueUserSchema.optional().describe("The actual value data. Format depends on `value_type`:\n" +
+        "• Bool: true/false (boolean)\n" +
+        "• Address (CRITICAL — string 'Address' is NOT a placeholder): a hex address (e.g. '0x1234...'), a LocalMark name (e.g. 'my-service' — resolved to address at evaluation time), an AccountOrMark_Address object (e.g. {name_or_address:'my-service'}), or system shorthand ('0xaaa' = EntityLinker, '0xaab' = EntityRegistrar). The literal string 'Address' itself is INVALID — it would be treated as a non-existent LocalMark name and fail. Example: value='0x2::wow::WOW<address>' or value='my-permission'.\n" +
+        "• String: any string\n" +
+        "• U8/U16/U32/U64/U128/U256: number or numeric string (e.g. 42 or '42')\n" +
+        "• Vec* types: arrays of the corresponding element type\n" +
+        "REQUIRED when b_submission=false. OPTIONAL when b_submission=true (value is supplied at evaluation time by user submission)."),
+    name: z.string().default("").describe("Data name identifier. MAX 64 BCS characters (Chinese chars count as 3-4 BCS bytes each). " +
+        "Use short identifiers like 'order_id', 'delivery_node'. " +
+        "Put longer descriptions in the Guard's 'description' field, NOT here."),
+}).strict().describe("Guard table item (INPUT/CREATION form). DO NOT include `object_type` field — it is query-output only and will be rejected here.");
 export const GuardTableItemSchema = GuardTableItemBaseSchema.extend({
-    object_type: ObjectTypeSchema.optional().describe("Object type when value_type is Address and represents a specific object"),
-}).strict().describe("Guard table item");
+    object_type: ObjectTypeSchema.optional().describe("OUTPUT-ONLY (query side): Object type when value_type is Address and represents a specific object. Auto-derived by the system — DO NOT set this field at Guard creation."),
+}).strict().describe("Guard table item (QUERY/OUTPUT form — includes auto-derived object_type field)");
 export const EntrypointSchema = z.enum([
     ENTRYPOINT.Localnet,
     ENTRYPOINT.Testnet,
     ENTRYPOINT.Mainnet,
-]).describe("Network entrypoint: Specifies which network the operation occurs on");
+]).describe("Network entrypoint: Specifies which network the operation occurs on. " +
+    "FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). " +
+    "When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names " +
+    "to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the " +
+    "project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy.");
 export const FaucetNetworkSchema = z.enum([
     ENTRYPOINT.Localnet,
     ENTRYPOINT.Testnet,