@wowok/agent-mcp 2.5.5 → 2.6.1

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/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,
@@ -1495,6 +1521,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 +1559,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`;