@wowok/agent-mcp 2.6.1 → 2.6.4

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

@@ -34,12 +34,12 @@ export declare const DisputeSchema: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     order: string;
-    proposition: string[];
     fee: {
         balance: string | number;
     } | {
         coin: string;
     };
+    proposition: string[];
     description?: string | undefined;
     namedArb?: {
         name?: string | undefined;
@@ -49,12 +49,12 @@ export declare const DisputeSchema: z.ZodObject<{
     } | undefined;
 }, {
     order: string;
-    proposition: string[];
     fee: {
         balance: string | number;
     } | {
         coin: string;
     };
+    proposition: string[];
     description?: string | undefined;
     namedArb?: {
         name?: string | undefined;
@@ -369,12 +369,12 @@ export declare const CallArbitration_DataSchema: z.ZodObject<{
         }>>;
     }, "strict", z.ZodTypeAny, {
         order: string;
-        proposition: string[];
         fee: {
             balance: string | number;
         } | {
             coin: string;
         };
+        proposition: string[];
         description?: string | undefined;
         namedArb?: {
             name?: string | undefined;
@@ -384,12 +384,12 @@ export declare const CallArbitration_DataSchema: z.ZodObject<{
         } | undefined;
     }, {
         order: string;
-        proposition: string[];
         fee: {
             balance: string | number;
         } | {
             coin: string;
         };
+        proposition: string[];
         description?: string | undefined;
         namedArb?: {
             name?: string | undefined;
@@ -681,14 +681,15 @@ export declare const CallArbitration_DataSchema: z.ZodObject<{
         arb: string;
     } | undefined;
     pause?: boolean | undefined;
+    fee?: string | number | undefined;
     dispute?: {
         order: string;
-        proposition: string[];
         fee: {
             balance: string | number;
         } | {
             coin: string;
         };
+        proposition: string[];
         description?: string | undefined;
         namedArb?: {
             name?: string | undefined;
@@ -756,7 +757,6 @@ export declare const CallArbitration_DataSchema: z.ZodObject<{
     arb_withdraw?: {
         arb: string;
     } | undefined;
-    fee?: string | number | undefined;
     voting_deadline_change?: {
         arb: string;
         voting_deadline: number | null;
@@ -791,14 +791,15 @@ export declare const CallArbitration_DataSchema: z.ZodObject<{
         arb: string;
     } | undefined;
     pause?: boolean | undefined;
+    fee?: string | number | undefined;
     dispute?: {
         order: string;
-        proposition: string[];
         fee: {
             balance: string | number;
         } | {
             coin: string;
         };
+        proposition: string[];
         description?: string | undefined;
         namedArb?: {
             name?: string | undefined;
@@ -866,7 +867,6 @@ export declare const CallArbitration_DataSchema: z.ZodObject<{
     arb_withdraw?: {
         arb: string;
     } | undefined;
-    fee?: string | number | undefined;
     voting_deadline_change?: {
         arb: string;
         voting_deadline: number | null;
@@ -964,12 +964,12 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
             }>>;
         }, "strict", z.ZodTypeAny, {
             order: string;
-            proposition: string[];
             fee: {
                 balance: string | number;
             } | {
                 coin: string;
             };
+            proposition: string[];
             description?: string | undefined;
             namedArb?: {
                 name?: string | undefined;
@@ -979,12 +979,12 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
             } | undefined;
         }, {
             order: string;
-            proposition: string[];
             fee: {
                 balance: string | number;
             } | {
                 coin: string;
             };
+            proposition: string[];
             description?: string | undefined;
             namedArb?: {
                 name?: string | undefined;
@@ -1276,14 +1276,15 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
             arb: string;
         } | undefined;
         pause?: boolean | undefined;
+        fee?: string | number | undefined;
         dispute?: {
             order: string;
-            proposition: string[];
             fee: {
                 balance: string | number;
             } | {
                 coin: string;
             };
+            proposition: string[];
             description?: string | undefined;
             namedArb?: {
                 name?: string | undefined;
@@ -1351,7 +1352,6 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
         arb_withdraw?: {
             arb: string;
         } | undefined;
-        fee?: string | number | undefined;
         voting_deadline_change?: {
             arb: string;
             voting_deadline: number | null;
@@ -1386,14 +1386,15 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
             arb: string;
         } | undefined;
         pause?: boolean | undefined;
+        fee?: string | number | undefined;
         dispute?: {
             order: string;
-            proposition: string[];
             fee: {
                 balance: string | number;
             } | {
                 coin: string;
             };
+            proposition: string[];
             description?: string | undefined;
             namedArb?: {
                 name?: string | undefined;
@@ -1461,7 +1462,6 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
         arb_withdraw?: {
             arb: string;
         } | undefined;
-        fee?: string | number | undefined;
         voting_deadline_change?: {
             arb: string;
             voting_deadline: number | null;
@@ -1477,10 +1477,11 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
         user_intent_phrases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         project: z.ZodOptional<z.ZodString>;
         client_schema_version: z.ZodOptional<z.ZodString>;
-        schema_strict_mode: z.ZodOptional<z.ZodBoolean>;
+        schema_strict_mode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         dry_run: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         account: string;
+        schema_strict_mode: boolean;
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
@@ -1489,7 +1490,6 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
         client_schema_version?: string | undefined;
-        schema_strict_mode?: boolean | undefined;
         dry_run?: boolean | undefined;
     }, {
         no_cache?: boolean | undefined;
@@ -1715,14 +1715,15 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
             arb: string;
         } | undefined;
         pause?: boolean | undefined;
+        fee?: string | number | undefined;
         dispute?: {
             order: string;
-            proposition: string[];
             fee: {
                 balance: string | number;
             } | {
                 coin: string;
             };
+            proposition: string[];
             description?: string | undefined;
             namedArb?: {
                 name?: string | undefined;
@@ -1790,7 +1791,6 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
         arb_withdraw?: {
             arb: string;
         } | undefined;
-        fee?: string | number | undefined;
         voting_deadline_change?: {
             arb: string;
             voting_deadline: number | null;
@@ -1825,6 +1825,7 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
     } | undefined;
     env?: {
         account: string;
+        schema_strict_mode: boolean;
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
@@ -1833,7 +1834,6 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
         client_schema_version?: string | undefined;
-        schema_strict_mode?: boolean | undefined;
         dry_run?: boolean | undefined;
     } | undefined;
 }, {
@@ -1867,14 +1867,15 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
             arb: string;
         } | undefined;
         pause?: boolean | undefined;
+        fee?: string | number | undefined;
         dispute?: {
             order: string;
-            proposition: string[];
             fee: {
                 balance: string | number;
             } | {
                 coin: string;
             };
+            proposition: string[];
             description?: string | undefined;
             namedArb?: {
                 name?: string | undefined;
@@ -1942,7 +1943,6 @@ export declare const CallArbitration_InputSchema: z.ZodObject<{
         arb_withdraw?: {
             arb: string;
         } | undefined;
-        fee?: string | number | undefined;
         voting_deadline_change?: {
             arb: string;
             voting_deadline: number | null;

package/dist/schema/call/arbitration.js

@@ -1,26 +1,47 @@
 import { z } from "zod";
 import { TypedPermissionObjectSchema, CoinParamSchema, NamedObjectSchema, CallEnvSchema, SubmissionCallSchema } from "./base.js";
 import { VotingGuardSchema } from "../query/index.js";
-import { BalanceTypeSchema, DescriptionSchema, LongNameSchema, NameOrAddressSchema, NameSchema, ReceivedObjectsOrRecentlySchema } from "../common/index.js";
+import { BalanceTypeSchema, DescriptionSchema, LongNameSchema, NameOrAddressSchema, NameSchema, ReceivedObjectsOrRecentlySchema, RECEIVE_FORMAT_BLOCK_OBJECTS } from "../common/index.js";
 export const DisputeSchema = z.object({
     order: NameOrAddressSchema.describe("Order ID or name."),
     description: DescriptionSchema.optional().describe("Dispute description."),
     proposition: z.array(LongNameSchema).describe("List of dispute propositions."),
-    fee: CoinParamSchema.describe("Dispute processing fee."),
-    namedArb: NamedObjectSchema.optional().describe("Name for the newly created arbitration object.")
+    fee: CoinParamSchema.describe("Dispute processing fee. FORMAT: {balance: <amount_in_smallest_unit>} — field name is 'balance' (NOT 'amount'). " +
+        "The token type and precision are determined by the Arbitration object's type_parameter (the generic type set when the Arbitration was created). " +
+        "For WOW (9 decimals): {balance: 50000000} = 0.05 WOW. For SUI (9 decimals): {balance: 50000000} = 0.05 SUI. " +
+        "For tokens with different decimals, adjust accordingly (e.g. USDC has 6 decimals, so {balance: 50000} = 0.05 USDC)."),
+    namedArb: NamedObjectSchema.optional().describe("RECOMMENDED: Set a local name for the newly created Arb (arbitration case) object. " +
+        "Without this, the Arb is only referenceable by its on-chain address. " +
+        "Example: {name: 'my_dispute_v1'} allows subsequent vote/feedback operations to use 'my_dispute_v1'.")
 }).strict();
 export const ConfirmSchema = z.object({
     arb: NameOrAddressSchema,
-    voting_deadline: z.union([z.number().int().min(0), z.null()])
+    voting_deadline: z.union([z.number().int().min(0), z.null()]).describe("Voting deadline as Unix timestamp in MILLISECONDS (ms). SEMANTICS OF SPECIAL VALUES: " +
+        "0 = deadline already passed → voting is IMPOSSIBLE and the arbitrator may deliver the verdict immediately (direct-verdict flow); " +
+        "null = open-ended voting with no deadline (verdict allowed anytime); " +
+        "a future timestamp = normal voting window (recommended: now + at least 86400000 ms = 24 hours). " +
+        "COMMON MISTAKE: using seconds instead of milliseconds (multiply by 1000). " +
+        "Example: Date.now() + 259200000 for 3 days from now.")
 }).strict();
 export const VotingDeadlineChangeSchema = z.object({
     arb: NameOrAddressSchema,
-    voting_deadline: z.union([z.number(), z.null()])
+    voting_deadline: z.union([z.number(), z.null()]).describe("New voting deadline as Unix timestamp in MILLISECONDS (ms). SEMANTICS OF SPECIAL VALUES: " +
+        "0 = deadline already passed → voting is IMPOSSIBLE and the arbitrator may deliver the verdict immediately; " +
+        "null = open-ended voting with no deadline (verdict allowed anytime); " +
+        "a future timestamp = normal voting window (recommended: now + at least 86400000 ms = 24 hours). " +
+        "COMMON MISTAKE: using seconds instead of milliseconds (multiply by 1000). " +
+        "Example: Date.now() + 259200000 for 3 days from now.")
 }).strict();
 export const VoteSchema = z.object({
     arb: NameOrAddressSchema,
-    votes: z.array(z.number().int().min(0).max(255)),
-    voting_guard: NameOrAddressSchema.optional()
+    votes: z.array(z.number().int().min(0).max(255)).describe("Proposition INDICES (0-based, u8) the voter agrees with — e.g. [0] votes for the first proposition. " +
+        "Re-voting REPLACES the voter's previous vote (old weight removed, new applied). " +
+        "Out-of-range index aborts with E_PROPOSITION_NOT_FOUND."),
+    voting_guard: NameOrAddressSchema.optional().describe("Optional Voting Guard for weighted voting. THREE PATHS are supported by the SDK and Move contract: " +
+        "(1) voting_guard PROVIDED → vote_with_voting_guard (Guard verifies voter + determines vote weight via VoteWeight config); " +
+        "(2) voting_guard OMITTED but other guards trigger passport creation (e.g. env.permission_guard or usage_guard) → vote_with_passport (permission-only via passport); " +
+        "(3) voting_guard OMITTED and no passport context → vote (plain permission-only vote, no Guard). " +
+        "The Guard (when provided) must be in the Arbitration's voting_guard list."),
 }).strict();
 export const FeedbackSchema = z.object({
     arb: NameOrAddressSchema,
@@ -82,9 +103,9 @@ export const CallArbitration_DataSchema = z.object({
     fees_transfer: FeesTransferSchema.optional().describe("Distribute the withdrawn arbitration fees."),
     usage_guard: z.union([NameOrAddressSchema, z.null()]).optional().describe("Set Guard for verification when users apply for arbitration; if Guard verification fails, users will not be able to apply for arbitration."),
     voting_guard: VotingGuardActionSchema.optional().describe("Set Guard for verification during arbitration voting; if Guard verification fails, arbitration voting will fail."),
-    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."),
+    owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects and other objects received by this Arbitration object and send them to the owner of its Permission object." + RECEIVE_FORMAT_BLOCK_OBJECTS),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object ID or name.")
-}).strict().describe("On-chain Arbitration operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, type_parameter, permission, ...} to create an Arbitration. 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.");
+}).strict().describe("On-chain Arbitration operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, type_parameter, permission, ...} to create an Arbitration. 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. ⚠️ PERMISSION RULE (contract-enforced, service.move arbitration_add_imp): the Arbitration's permission MUST be DIFFERENT from the permission of any Service it will be bound to — binding an Arbitration that SHARES the Service's Permission aborts with E_ARBITRATION_PERMISSION_CONFLICT (error 33). Always create a DEDICATED Permission object for each Arbitration. (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 CallArbitration_InputSchema = z.object({
     data: CallArbitration_DataSchema,
     env: CallEnvSchema.optional(),

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

@@ -222,10 +222,11 @@ export declare const CallEnvSchema: z.ZodObject<{
     user_intent_phrases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     project: z.ZodOptional<z.ZodString>;
     client_schema_version: z.ZodOptional<z.ZodString>;
-    schema_strict_mode: z.ZodOptional<z.ZodBoolean>;
+    schema_strict_mode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     dry_run: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     account: string;
+    schema_strict_mode: boolean;
     no_cache?: boolean | undefined;
     network?: ENTRYPOINT | undefined;
     permission_guard?: string[] | undefined;
@@ -234,7 +235,6 @@ export declare const CallEnvSchema: z.ZodObject<{
     user_intent_phrases?: string[] | undefined;
     project?: string | undefined;
     client_schema_version?: string | undefined;
-    schema_strict_mode?: boolean | undefined;
     dry_run?: boolean | undefined;
 }, {
     no_cache?: boolean | undefined;

package/dist/schema/call/base.js

@@ -89,7 +89,7 @@ export const CallEnvSchema = z.object({
     user_intent_phrases: z.array(z.string()).optional().describe("Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches."),
     project: z.string().optional().describe("Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects."),
     client_schema_version: z.string().optional().describe("Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."),
-    schema_strict_mode: z.boolean().optional().describe("When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."),
+    schema_strict_mode: z.boolean().optional().default(false).describe("When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."),
     dry_run: z.boolean().optional().describe("Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."),
 }).strict().describe(`IMPORTANT: Execution environment includes: account for signing operations, network selection (${ENTRYPOINT}), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account ("") will be used.`);
 export const ObjectsOpSchema = z.union([