@wowok/agent-mcp 2.3.16 → 2.4.1

package/dist/schema/call/bridge.js

@@ -11,10 +11,13 @@ export const EvmAddressSchema = z.string()
     .describe("EVM address (0x + 40 hex)");
 export const BridgeAmountSchema = z.string()
     .describe("Cross-chain amount as a string in the smallest unit (e.g. wei / token minimal unit). Example: 1 ETH = '1000000000000000000'");
+export const BridgeIdempotencyKeySchema = z.string().min(1).max(128)
+    .describe("Idempotency key (1-128 chars). Prevents duplicate transfers on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true).");
 export const BridgeOperationTypeSchema = z.enum([
     "cross_chain_wow_to_evm",
     "cross_chain_evm_to_wow",
     "claim_wow_to_evm",
+    "resume_transfer",
     "withdraw",
     "query_active_evm_account",
     "query_supported_evm_chains",
@@ -28,6 +31,10 @@ export const BridgeWowToEvmDataSchema = z.object({
     amount: BridgeAmountSchema.describe("Cross-chain amount (WOW-side smallest unit, wowDecimals)"),
     withdrawTo: EvmAddressSchema.optional()
         .describe("Final withdrawal EVM address; if omitted, assets remain in activeEvmAccount. When provided, the SDK uses the activeEvmAccount key to transfer to this address."),
+    idempotencyKey: BridgeIdempotencyKeySchema.optional()
+        .describe("Idempotency key to prevent duplicate deposits on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true)."),
+    idempotentByParams: z.boolean().optional()
+        .describe("If true, auto-generates an idempotency key from token+amount+withdrawTo. Use when you want implicit idempotency without managing explicit keys."),
 }).strict().describe("WOW→EVM cross-chain (step 1: deposit only). " +
     "Returns immediately with depositTxDigest + bridgeSeq + transferId. " +
     "This operation only locks assets on WOW; it does NOT complete the cross-chain. " +
@@ -40,6 +47,10 @@ export const BridgeEvmToWowDataSchema = z.object({
     amount: BridgeAmountSchema.describe("Cross-chain amount (EVM-side smallest unit, evmDecimals)"),
     recipientWowAddress: WowAddressSchema.optional()
         .describe("WOW recipient address or account name; defaults to env.account if omitted"),
+    idempotencyKey: BridgeIdempotencyKeySchema.optional()
+        .describe("Idempotency key to prevent duplicate deposits on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true)."),
+    idempotentByParams: z.boolean().optional()
+        .describe("If true, auto-generates an idempotency key from token+amount+recipientWowAddress. Use when you want implicit idempotency without managing explicit keys."),
 }).strict().describe("EVM→WOW cross-chain (single step: deposit). " +
     "Returns immediately with depositTxHash + transferId. " +
     "Bridge will automatically claim on WOW (no WOW gas needed, no user action required). " +
@@ -59,6 +70,17 @@ export const BridgeClaimWowToEvmDataSchema = z.object({
     "After claim_wow_to_evm returns, the claim tx has been submitted and confirmed (1 block) on EVM. " +
     "Use query_transfer_status(refresh=true) to verify latestState.step = 'completed'. " +
     "[Gas requirements] Requires activeEvmAccount to have target-chain gas (for the claim transaction).");
+export const BridgeResumeTransferDataSchema = z.object({
+    transferId: z.string().describe("Transfer ID to resume (br_<timestamp>_<counter>)"),
+}).strict().describe("Resume an interrupted transfer from its current step. " +
+    "Use this when a transfer was interrupted (e.g. MCP restart, network error) and you want to continue from where it left off. " +
+    "The SDK determines the current step and attempts to advance it: " +
+    "- If deposit step failed: retries the deposit " +
+    "- If deposit is pending/confirmed: waits for bridge signatures and proceeds to claim " +
+    "- If claim step is ready: executes the claim " +
+    "- If transfer is already complete: returns the existing record (idempotentHit=true) " +
+    "[Returns] The updated transfer record after attempting to advance it. " +
+    "[Requires env] WOW env is needed for WOW-side operations; EVM-side operations use activeEvmAccount.");
 export const BridgeWithdrawDataSchema = z.object({
     to: EvmAddressSchema.describe("Withdrawal target EVM address"),
     amount: BridgeAmountSchema.describe("Withdrawal amount (smallest unit)"),
@@ -186,6 +208,11 @@ export const BridgeOperationsSchema = z.preprocess((input) => {
         data: BridgeClaimWowToEvmDataSchema,
         env: CallEnvSchema.optional(),
     }).describe("WOW→EVM claim (step 2): claim assets on EVM after bridge signed. Requires activeEvmAccount to have EVM gas. [Requires WOW mainnet env]"),
+    z.object({
+        operation_type: z.literal("resume_transfer"),
+        data: BridgeResumeTransferDataSchema,
+        env: CallEnvSchema.optional(),
+    }).describe("Resume an interrupted transfer from its current step. Safe to retry. [Requires WOW mainnet env for WOW-side operations]"),
     z.object({
         operation_type: z.literal("withdraw"),
         data: BridgeWithdrawDataSchema,
@@ -258,6 +285,7 @@ export const BridgeTransferRecordSchema = z.object({
     recipientEth: z.string().optional().describe("ETH-side recipient address"),
     recipientWow: z.string().optional().describe("WOW-side recipient address"),
     intermediateEthAccount: z.string().describe("Intermediate EVM account (activeEvmAccount)"),
+    idempotencyKey: z.string().optional().describe("Idempotency key used for this transfer (if any)"),
     step: z.enum(["init", "deposit", "claimed", "withdraw", "withdrawn"]).describe("Current step in the transfer lifecycle: " +
         "init=just created; " +
         "deposit=source chain deposit in progress; " +
@@ -283,11 +311,15 @@ export const BridgeWowToEvmResultSchema = z.object({
     bridgeSeq: z.string().describe("Bridge sequence number"),
     activeEvmAccount: z.string().describe("activeEvmAccount address that will receive the assets"),
     transferId: z.string().describe("Transfer ID (br_<timestamp>_<counter>). Save this for claim_wow_to_evm (step 2) and query_transfer_status"),
+    idempotentHit: z.boolean().optional().describe("true if this result was returned from idempotency cache (no new deposit executed)"),
+    idempotencyKey: z.string().optional().describe("Idempotency key used (if any)"),
 }).strict().describe("WOW→EVM cross-chain step 1 result (deposit only, claim pending)");
 export const BridgeEvmToWowResultSchema = z.object({
     depositTxHash: z.string().describe("EVM deposit tx hash"),
     activeEvmAccount: z.string().describe("activeEvmAccount address that initiated the deposit"),
     transferId: z.string().describe("Transfer ID (br_<timestamp>_<counter>). Save this for query_transfer_status"),
+    idempotentHit: z.boolean().optional().describe("true if this result was returned from idempotency cache (no new deposit executed)"),
+    idempotencyKey: z.string().optional().describe("Idempotency key used (if any)"),
 }).strict().describe("EVM→WOW cross-chain result (deposit submitted, auto-claim in progress)");
 export const BridgeClaimWowToEvmResultSchema = z.object({
     claimTxHash: z.string().describe("EVM claim tx hash"),
@@ -357,6 +389,11 @@ export const BridgeOutputSchema = z.discriminatedUnion("operation_type", [
         result: BridgeClaimWowToEvmResultSchema,
         message: z.string().optional().describe("Result summary or hint message"),
     }).describe("WOW→EVM claim (step 2) result"),
+    z.object({
+        operation_type: z.literal("resume_transfer"),
+        result: BridgeTransferRecordSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("Resume interrupted transfer result"),
     z.object({
         operation_type: z.literal("withdraw"),
         result: BridgeWithdrawResultSchema,

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

@@ -605,6 +605,8 @@ export declare const CallContact_InputSchema: z.ZodObject<{
         confirmed: z.ZodOptional<z.ZodBoolean>;
         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>;
     }, "strict", z.ZodTypeAny, {
         account: string;
         no_cache?: boolean | undefined;
@@ -614,6 +616,8 @@ export declare const CallContact_InputSchema: z.ZodObject<{
         confirmed?: boolean | undefined;
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     }, {
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
@@ -623,6 +627,8 @@ export declare const CallContact_InputSchema: z.ZodObject<{
         confirmed?: boolean | undefined;
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     }>>;
     submission: z.ZodOptional<z.ZodObject<{
         type: z.ZodLiteral<"submission">;
@@ -890,6 +896,8 @@ export declare const CallContact_InputSchema: z.ZodObject<{
         confirmed?: boolean | undefined;
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     } | undefined;
 }, {
     data: {
@@ -977,6 +985,8 @@ export declare const CallContact_InputSchema: z.ZodObject<{
         confirmed?: boolean | undefined;
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     } | undefined;
 }>;
 export type ImEntry = z.infer<typeof ImEntrySchema>;

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

@@ -358,20 +358,6 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
     } | {
         op: "clear";
     } | undefined;
-    location?: string | undefined;
-    owner_receive?: {
-        received: {
-            id: string;
-            balance: string | number;
-            payment: string;
-        }[];
-        balance: string | number;
-        token_type: string;
-    } | "recently" | {
-        type: string;
-        id: string;
-        content_raw?: any;
-    }[] | undefined;
     guards?: {
         op: "add";
         guard: {
@@ -390,6 +376,20 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
     } | {
         op: "clear";
     } | undefined;
+    location?: string | undefined;
+    owner_receive?: {
+        received: {
+            id: string;
+            balance: string | number;
+            payment: string;
+        }[];
+        balance: string | number;
+        token_type: string;
+    } | "recently" | {
+        type: string;
+        id: string;
+        content_raw?: any;
+    }[] | undefined;
     um?: string | null | undefined;
     feedback?: {
         who: {
@@ -428,20 +428,6 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
     } | {
         op: "clear";
     } | undefined;
-    location?: string | undefined;
-    owner_receive?: {
-        received: {
-            id: string;
-            balance: string | number;
-            payment: string;
-        }[];
-        balance: string | number;
-        token_type: string;
-    } | "recently" | {
-        type: string;
-        id: string;
-        content_raw?: any;
-    }[] | undefined;
     guards?: {
         op: "add";
         guard: {
@@ -460,6 +446,20 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
     } | {
         op: "clear";
     } | undefined;
+    location?: string | undefined;
+    owner_receive?: {
+        received: {
+            id: string;
+            balance: string | number;
+            payment: string;
+        }[];
+        balance: string | number;
+        token_type: string;
+    } | "recently" | {
+        type: string;
+        id: string;
+        content_raw?: any;
+    }[] | undefined;
     um?: string | null | undefined;
     feedback?: {
         who: {
@@ -730,20 +730,6 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
-        location?: string | undefined;
-        owner_receive?: {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        } | "recently" | {
-            type: string;
-            id: string;
-            content_raw?: any;
-        }[] | undefined;
         guards?: {
             op: "add";
             guard: {
@@ -762,6 +748,20 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
+        location?: string | undefined;
+        owner_receive?: {
+            received: {
+                id: string;
+                balance: string | number;
+                payment: string;
+            }[];
+            balance: string | number;
+            token_type: string;
+        } | "recently" | {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }[] | undefined;
         um?: string | null | undefined;
         feedback?: {
             who: {
@@ -800,20 +800,6 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
-        location?: string | undefined;
-        owner_receive?: {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        } | "recently" | {
-            type: string;
-            id: string;
-            content_raw?: any;
-        }[] | undefined;
         guards?: {
             op: "add";
             guard: {
@@ -832,6 +818,20 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
+        location?: string | undefined;
+        owner_receive?: {
+            received: {
+                id: string;
+                balance: string | number;
+                payment: string;
+            }[];
+            balance: string | number;
+            token_type: string;
+        } | "recently" | {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }[] | undefined;
         um?: string | null | undefined;
         feedback?: {
             who: {
@@ -856,6 +856,8 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         confirmed: z.ZodOptional<z.ZodBoolean>;
         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>;
     }, "strict", z.ZodTypeAny, {
         account: string;
         no_cache?: boolean | undefined;
@@ -865,6 +867,8 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         confirmed?: boolean | undefined;
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     }, {
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
@@ -874,6 +878,8 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         confirmed?: boolean | undefined;
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     }>>;
     submission: z.ZodOptional<z.ZodObject<{
         type: z.ZodLiteral<"submission">;
@@ -1080,20 +1086,6 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
-        location?: string | undefined;
-        owner_receive?: {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        } | "recently" | {
-            type: string;
-            id: string;
-            content_raw?: any;
-        }[] | undefined;
         guards?: {
             op: "add";
             guard: {
@@ -1112,6 +1104,20 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
+        location?: string | undefined;
+        owner_receive?: {
+            received: {
+                id: string;
+                balance: string | number;
+                payment: string;
+            }[];
+            balance: string | number;
+            token_type: string;
+        } | "recently" | {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }[] | undefined;
         um?: string | null | undefined;
         feedback?: {
             who: {
@@ -1163,6 +1169,8 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         confirmed?: boolean | undefined;
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     } | undefined;
 }, {
     data: {
@@ -1189,20 +1197,6 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
-        location?: string | undefined;
-        owner_receive?: {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        } | "recently" | {
-            type: string;
-            id: string;
-            content_raw?: any;
-        }[] | undefined;
         guards?: {
             op: "add";
             guard: {
@@ -1221,6 +1215,20 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
+        location?: string | undefined;
+        owner_receive?: {
+            received: {
+                id: string;
+                balance: string | number;
+                payment: string;
+            }[];
+            balance: string | number;
+            token_type: string;
+        } | "recently" | {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }[] | undefined;
         um?: string | null | undefined;
         feedback?: {
             who: {
@@ -1272,6 +1280,8 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         confirmed?: boolean | undefined;
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     } | undefined;
 }>;
 export type CallDemand_Data = z.infer<typeof CallDemand_DataSchema>;