@wowok/agent-mcp 2.6.0 → 2.6.3

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

@@ -9,7 +9,7 @@ export declare const ProgressNextSchema: z.ZodObject<{
     forward: string;
     next_node_name: string;
 }>;
-export declare const OperateSchema: z.ZodObject<{
+export declare const OperateSchema: z.ZodEffects<z.ZodObject<{
     operation: z.ZodObject<{
         next_node_name: z.ZodEffects<z.ZodString, string, string>;
         forward: z.ZodEffects<z.ZodString, string, string>;
@@ -36,11 +36,18 @@ export declare const OperateSchema: z.ZodObject<{
         next_node_name: string;
     };
     message?: string | undefined;
-}>;
+}>, {
+    op: "next" | "hold" | "unhold" | "adminUnhold";
+    operation: {
+        forward: string;
+        next_node_name: string;
+    };
+    message?: string | undefined;
+}, unknown>;
 export declare const CallProgress_DataSchema: z.ZodObject<{
     object: z.ZodEffects<z.ZodString, string, string>;
     task: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
-    repository: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+    repository: 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, {
@@ -64,7 +71,15 @@ export declare const CallProgress_DataSchema: z.ZodObject<{
         op: "clear";
     }, {
         op: "clear";
-    }>]>>;
+    }>]>, {
+        op: "set" | "add";
+        objects: string[];
+    } | {
+        op: "remove";
+        objects: string[];
+    } | {
+        op: "clear";
+    }, unknown>>;
     progress_namedOperator: z.ZodOptional<z.ZodObject<{
         op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">, z.ZodLiteral<"remove">]>;
         name: z.ZodEffects<z.ZodString, string, string>;
@@ -114,7 +129,7 @@ export declare const CallProgress_DataSchema: z.ZodObject<{
             check_all_founded?: boolean | undefined;
         };
     }>>;
-    operate: z.ZodOptional<z.ZodObject<{
+    operate: z.ZodOptional<z.ZodEffects<z.ZodObject<{
         operation: z.ZodObject<{
             next_node_name: z.ZodEffects<z.ZodString, string, string>;
             forward: z.ZodEffects<z.ZodString, string, string>;
@@ -141,7 +156,14 @@ export declare const CallProgress_DataSchema: z.ZodObject<{
             next_node_name: string;
         };
         message?: string | undefined;
-    }>>;
+    }>, {
+        op: "next" | "hold" | "unhold" | "adminUnhold";
+        operation: {
+            forward: string;
+            next_node_name: string;
+        };
+        message?: string | undefined;
+    }, unknown>>;
 }, "strict", z.ZodTypeAny, {
     object: string;
     repository?: {
@@ -175,23 +197,8 @@ export declare const CallProgress_DataSchema: z.ZodObject<{
     } | undefined;
 }, {
     object: string;
-    repository?: {
-        op: "set" | "add";
-        objects: string[];
-    } | {
-        op: "remove";
-        objects: string[];
-    } | {
-        op: "clear";
-    } | undefined;
-    operate?: {
-        op: "next" | "hold" | "unhold" | "adminUnhold";
-        operation: {
-            forward: string;
-            next_node_name: string;
-        };
-        message?: string | undefined;
-    } | undefined;
+    repository?: unknown;
+    operate?: unknown;
     task?: string | undefined;
     progress_namedOperator?: {
         name: string;
@@ -209,7 +216,7 @@ export declare const CallProgress_InputSchema: z.ZodObject<{
     data: z.ZodObject<{
         object: z.ZodEffects<z.ZodString, string, string>;
         task: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
-        repository: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        repository: 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, {
@@ -233,7 +240,15 @@ export declare const CallProgress_InputSchema: z.ZodObject<{
             op: "clear";
         }, {
             op: "clear";
-        }>]>>;
+        }>]>, {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        }, unknown>>;
         progress_namedOperator: z.ZodOptional<z.ZodObject<{
             op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">, z.ZodLiteral<"remove">]>;
             name: z.ZodEffects<z.ZodString, string, string>;
@@ -283,7 +298,7 @@ export declare const CallProgress_InputSchema: z.ZodObject<{
                 check_all_founded?: boolean | undefined;
             };
         }>>;
-        operate: z.ZodOptional<z.ZodObject<{
+        operate: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             operation: z.ZodObject<{
                 next_node_name: z.ZodEffects<z.ZodString, string, string>;
                 forward: z.ZodEffects<z.ZodString, string, string>;
@@ -310,7 +325,14 @@ export declare const CallProgress_InputSchema: z.ZodObject<{
                 next_node_name: string;
             };
             message?: string | undefined;
-        }>>;
+        }>, {
+            op: "next" | "hold" | "unhold" | "adminUnhold";
+            operation: {
+                forward: string;
+                next_node_name: string;
+            };
+            message?: string | undefined;
+        }, unknown>>;
     }, "strict", z.ZodTypeAny, {
         object: string;
         repository?: {
@@ -344,23 +366,8 @@ export declare const CallProgress_InputSchema: z.ZodObject<{
         } | undefined;
     }, {
         object: string;
-        repository?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
-        operate?: {
-            op: "next" | "hold" | "unhold" | "adminUnhold";
-            operation: {
-                forward: string;
-                next_node_name: string;
-            };
-            message?: string | undefined;
-        } | undefined;
+        repository?: unknown;
+        operate?: unknown;
         task?: string | undefined;
         progress_namedOperator?: {
             name: string;
@@ -667,23 +674,8 @@ export declare const CallProgress_InputSchema: z.ZodObject<{
 }, {
     data: {
         object: string;
-        repository?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
-        operate?: {
-            op: "next" | "hold" | "unhold" | "adminUnhold";
-            operation: {
-                forward: string;
-                next_node_name: string;
-            };
-            message?: string | undefined;
-        } | undefined;
+        repository?: unknown;
+        operate?: unknown;
         task?: string | undefined;
         progress_namedOperator?: {
             name: string;

package/dist/schema/call/progress.js

@@ -6,15 +6,29 @@ export const ProgressNextSchema = z.object({
     next_node_name: NameSchema.describe("Next node name."),
     forward: NameSchema.describe("Next forward name."),
 }).strict().describe("Specify a specific operation between current node and next node.");
-export const OperateSchema = z.object({
+export const OperateSchema = z.preprocess((val) => {
+    if (val && typeof val === "object" && !Array.isArray(val)) {
+        const obj = val;
+        if (obj.op === undefined && "hold" in obj) {
+            const holdVal = obj.hold;
+            if (typeof holdVal === "boolean") {
+                obj.op = holdVal ? "hold" : "next";
+                delete obj.hold;
+            }
+        }
+    }
+    return val;
+}, z.object({
     operation: ProgressNextSchema,
-    op: z.enum(["next", "hold", "unhold", "adminUnhold"]).describe("Operation type on the forward: " +
+    op: z.enum(["next", "hold", "unhold", "adminUnhold"]).describe("Operation type on the forward (CANONICAL form — prefer this): " +
         "'next' = advance the forward (accomplish); " +
         "'hold' = set hold to block the forward; " +
         "'unhold' = self-unhold, release own hold (no 224 permission needed); " +
-        "'adminUnhold' = force-release hold via 224 permission (PROGRESS_UNHOLD)."),
+        "'adminUnhold' = force-release hold via 224 permission (PROGRESS_UNHOLD). " +
+        "LEGACY ALIAS: `hold: boolean` is auto-converted to `op` — `hold:true`→`op:'hold'`, `hold:false`→`op:'next'`. " +
+        "New code should use `op` directly."),
     message: z.string().optional().describe("Operation result message."),
-}).strict().describe("Advance Progress object with explicit operation type.");
+}).strict()).describe("Advance Progress object. CANONICAL form: {operation, op: 'next'|'hold'|'unhold'|'adminUnhold', message?}. LEGACY form (auto-converted): {operation, hold: boolean, message?} where hold:true→op:'hold', hold:false→op:'next'.");
 export const CallProgress_DataSchema = z.object({
     object: NameOrAddressSchema.describe("Progress object ID or name."),
     task: NameOrAddressSchema.optional().describe("Task ID. Cannot be changed after setting."),

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

@@ -1064,7 +1064,7 @@ export declare const CallRepository_DataSchema: z.ZodObject<{
             write_guard?: string | undefined;
         }[];
     }>]>>;
-    rewards: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+    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, {
@@ -1088,7 +1088,15 @@ export declare const CallRepository_DataSchema: z.ZodObject<{
         op: "clear";
     }, {
         op: "clear";
-    }>]>>;
+    }>]>, {
+        op: "set" | "add";
+        objects: string[];
+    } | {
+        op: "remove";
+        objects: string[];
+    } | {
+        op: "clear";
+    }, unknown>>;
     owner_receive: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         type: z.ZodString;
@@ -1238,15 +1246,7 @@ export declare const CallRepository_DataSchema: z.ZodObject<{
         onChain?: boolean | undefined;
     };
     description?: string | undefined;
-    rewards?: {
-        op: "set" | "add";
-        objects: string[];
-    } | {
-        op: "remove";
-        objects: string[];
-    } | {
-        op: "clear";
-    } | undefined;
+    rewards?: unknown;
     um?: string | null | undefined;
     owner_receive?: {
         received: {
@@ -1660,7 +1660,7 @@ export declare const CallRepository_InputSchema: z.ZodObject<{
                 write_guard?: string | undefined;
             }[];
         }>]>>;
-        rewards: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        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, {
@@ -1684,7 +1684,15 @@ export declare const CallRepository_InputSchema: z.ZodObject<{
             op: "clear";
         }, {
             op: "clear";
-        }>]>>;
+        }>]>, {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        }, unknown>>;
         owner_receive: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             type: z.ZodString;
@@ -1834,15 +1842,7 @@ export declare const CallRepository_InputSchema: z.ZodObject<{
             onChain?: boolean | undefined;
         };
         description?: string | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
+        rewards?: unknown;
         um?: string | null | undefined;
         owner_receive?: {
             received: {
@@ -2271,15 +2271,7 @@ export declare const CallRepository_InputSchema: z.ZodObject<{
             onChain?: boolean | undefined;
         };
         description?: string | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
+        rewards?: unknown;
         um?: string | null | undefined;
         owner_receive?: {
             received: {

package/dist/schema/call/repository.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { WithPermissionObjectSchema, ObjectsSchema, CallEnvSchema, SubmissionCallSchema, } from "./base.js";
-import { AccountOrMark_AddressSchema, DescriptionSchema, NameOrAddressSchema, NameSchema, ReceivedObjectsOrRecentlySchema } from "../common/index.js";
+import { AccountOrMark_AddressSchema, DescriptionSchema, NameOrAddressSchema, NameSchema, ReceivedObjectsOrRecentlySchema, RECEIVE_FORMAT_BLOCK_OBJECTS } from "../common/index.js";
 import { PolicyRuleSchema } from "../query/index.js";
 import { SupportedValueSchema } from "../common/index.js";
 export const RepositoryIdSchema = z.union([
@@ -67,7 +67,7 @@ export const CallRepository_DataSchema = z.object({
     data_add: DataAddSchema.optional().describe("Add data items"),
     data_remove: DataRemoveSchema.optional().describe("Delete data items"),
     rewards: ObjectsSchema.optional().describe("Reward object list. Used for data contribution incentives."),
-    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 Repository 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 Repository operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, permission, ...} to create a Repository. 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 CallRepository_InputSchema = z.object({

package/dist/schema/call/reward.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { TypedPermissionObjectSchema, CoinParamSchema, CallEnvSchema, SubmissionCallSchema, } from "./base.js";
 import { RewardGuardSchema } from "../query/index.js";
-import { BalanceTypeSchema, ReceivedObjectsOrRecentlySchema, ReceivedBalanceOrRecentlySchema, NameOrAddressSchema, DescriptionSchema } from "../common/index.js";
+import { BalanceTypeSchema, ReceivedObjectsOrRecentlySchema, ReceivedBalanceOrRecentlySchema, NameOrAddressSchema, DescriptionSchema, RECEIVE_FORMAT_BLOCK_OBJECTS, RECEIVE_FORMAT_BLOCK_BALANCE } from "../common/index.js";
 export const RewardRecordSchema = z.object({
     amount: BalanceTypeSchema,
     time: z.number().int(),
@@ -16,11 +16,11 @@ export const CallReward_DataSchema = z.object({
     claim: NameOrAddressSchema.optional().describe("Guard object ID. Used to verify Guard and start the reward distribution process corresponding to this Guard."),
     description: DescriptionSchema.optional(),
     coin_add: CoinParamSchema.optional().describe("Add amount to Reward object."),
-    receive: ReceivedBalanceOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects received by Reward object and store them in pending balance."),
+    receive: ReceivedBalanceOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects received by Reward object and store them in pending balance." + RECEIVE_FORMAT_BLOCK_BALANCE),
     guard_add: z.array(RewardGuardSchema).optional().describe("Add Guard to Reward object."),
     guard_remove_expired: z.boolean().optional().describe("Whether to remove expired Guard."),
     guard_expiration_time: z.union([z.number().int().min(1), z.null()]).optional().describe("Add expiration time(ms). Before this time expires, new Guard and fund allocation rules cannot be added."),
-    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 Reward 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 Reward operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, type_parameter, permission, ...} to create a Reward. 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 CallReward_InputSchema = z.object({

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

@@ -8,7 +8,7 @@ export interface SemanticContext {
     pre_warnings?: string[];
     schema_check?: import("../schema-version.js").SchemaCheckResult;
 }
-export type ErrorCode = "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | "rate_limit" | "gas_exceeded" | "bcs_error" | "signature_error" | "config_error" | "unknown";
+export type ErrorCode = "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | "rate_limit" | "gas_exceeded" | "bcs_error" | "signature_error" | "config_error" | "wip_verification_failed" | "unknown";
 export interface MoveAbortInfo {
     module: string;
     code: number;

package/dist/schema/call/semantic.js

@@ -141,6 +141,32 @@ const ERROR_RULES = [
         retryable: false,
         recovery_hint: "Fill the Guard submission data (see the 'submission' field) and resubmit via call_with_submission",
     },
+    {
+        patterns: [
+            /WIP file verification failed/i,
+            /Failed to load WIP file/i,
+            /WIP.*hash\s*mismatch/i,
+            /Invalid WIP file structure/i,
+            /wip.*not\s*found/i,
+            /wip.*unreachable/i,
+            /wip_file.*error/i,
+        ],
+        error_code: "wip_verification_failed",
+        retryable: false,
+        recovery_hint: [
+            "WIP file must be publicly accessible via HTTP(S) URL — local file paths cannot be stored on-chain.",
+            "Deployment options (pick one):",
+            "  1. GitHub Pages (free, stable): upload .wip file to a repo, enable Pages, use raw URL.",
+            "     Example: https://<user>.github.io/<repo>/<file>.wip",
+            "     Or raw URL: https://raw.githubusercontent.com/<user>/<repo>/<branch>/<file>.wip",
+            "  2. IPFS (free, decentralized): upload via Pinata (https://pinata.cloud) or nft.storage.",
+            "     Use the ipfs://<CID> or https://<gateway>/ipfs/<CID> URL form.",
+            "     Common gateways: https://ipfs.io/ipfs/, https://cloudflare-ipfs.com/ipfs/, https://dweb.link/ipfs/",
+            "  3. User's own website: serve the .wip file from your static site.",
+            "  4. Generate a fresh WIP file locally first via wip_file (type='generate'), upload it, then re-submit the URL.",
+            "After updating the sale's wip URL, re-run the operation."
+        ].join("\n"),
+    },
     {
         patterns: [
             /already\s*publish/i,
@@ -427,7 +453,8 @@ const INTENT_RULES = [
     { operation_type: "progress", intent: "update_progress", confidence: 0.9 },
     { operation_type: "order", signals: (d) => !!d?.arb, intent: "apply_arbitration", confidence: 0.9 },
     { operation_type: "order", intent: "manage_order", confidence: 0.85 },
-    { operation_type: "payment", intent: "send_payment", confidence: 0.95 },
+    { operation_type: "payment", signals: (d) => d?.receive === true, intent: "claim_escrow_payment", confidence: 0.95 },
+    { operation_type: "payment", intent: "send_payment", confidence: 0.9 },
     { operation_type: "reward", intent: "manage_reward", confidence: 0.9 },
     { operation_type: "demand", intent: "post_demand", confidence: 0.9 },
     { operation_type: "treasury", intent: "manage_treasury", confidence: 0.9 },
@@ -573,6 +600,11 @@ const FUND_ROLE_RULES = [
         role: "release",
         confidence: 0.9,
     },
+    {
+        when: (ctx) => ctx.operation_type === "payment" && ctx.data?.receive === true,
+        role: "release",
+        confidence: 0.95,
+    },
     {
         when: (ctx) => ctx.operation_type === "payment" && isNegative(ctx.amount),
         role: "payment",
@@ -1495,6 +1527,9 @@ export function buildDataSemantic(data, context, isError, errorMsg) {
         return undefined;
     const intent = inferIntent(context.operation_type, context.data);
     const warnings = [];
+    if (context.pre_warnings && context.pre_warnings.length > 0) {
+        warnings.push(...context.pre_warnings);
+    }
     let status;
     if (isError) {
         status = "failed";
@@ -1530,7 +1565,7 @@ export function buildDataSemantic(data, context, isError, errorMsg) {
     const intentVerb = intent.replace(/_/g, " ");
     let summary;
     if (status === "failed") {
-        summary = `Failed to ${intentVerb}`;
+        summary = errorMsg ? `Failed to ${intentVerb}: ${errorMsg}` : `Failed to ${intentVerb}`;
     }
     else if (status === "partial") {
         summary = `${intentVerb} completed with no results`;