@wowok/agent-mcp 2.3.14 → 2.3.18

package/dist/schema/call/bridge.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { CallEnvSchema } from "./base.js";
+import { CallEnvSchema, SemanticSummarySchema } from "./base.js";
 import { WowAddressSchema } from "../common/index.js";
 export const BridgeTokenSchema = z.enum(["ETH", "WETH", "WBTC", "USDC", "USDT"])
     .describe("Cross-chain token identifier. ETH=native ETH; WETH/WBTC/USDC/USDT=ERC20. Decimals are handled by SDK config.");
@@ -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,
@@ -398,11 +435,22 @@ export const BridgeCallOutputSchema = z.object({
     result: z.discriminatedUnion("type", [
         z.object({
             type: z.literal("data"),
-            data: z.any().describe("Operation result data (structure varies by operation_type)"),
+            data: z.unknown().describe("Operation result data (structure varies by operation_type)"),
         }).describe("Successful result"),
         z.object({
             type: z.literal("error"),
             error: z.string().describe("Error message"),
+            error_code: z
+                .enum([
+                "invalid_parameter", "guard_rejected", "state_conflict",
+                "insufficient_balance", "object_not_found", "permission_denied",
+                "immutable_violation", "network_error", "unknown",
+            ])
+                .optional()
+                .describe("Error classification for programmatic recovery"),
+            retryable: z.boolean().optional().describe("Whether the operation can be retried as-is"),
+            recovery_hint: z.string().optional().describe("Recovery suggestion for AI or user"),
         }).describe("Error result"),
     ]).describe("Bridge operation result (data or error)"),
+    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for bridge operation"),
 }).describe("Bridge operation output (matches CallOutput structure returned by the handler)");

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

@@ -602,18 +602,33 @@ export declare const CallContact_InputSchema: z.ZodObject<{
         no_cache: z.ZodOptional<z.ZodBoolean>;
         network: z.ZodOptional<z.ZodEnum<[import("@wowok/wowok").ENTRYPOINT.Localnet, import("@wowok/wowok").ENTRYPOINT.Testnet, import("@wowok/wowok").ENTRYPOINT.Mainnet]>>;
         referrer: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        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;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
         referrer?: string | undefined;
+        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;
         account?: string | undefined;
         permission_guard?: string[] | undefined;
         referrer?: string | undefined;
+        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">;
@@ -878,6 +893,11 @@ export declare const CallContact_InputSchema: z.ZodObject<{
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
         referrer?: string | undefined;
+        confirmed?: boolean | undefined;
+        user_intent_phrases?: string[] | undefined;
+        project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     } | undefined;
 }, {
     data: {
@@ -962,6 +982,11 @@ export declare const CallContact_InputSchema: z.ZodObject<{
         account?: string | undefined;
         permission_guard?: string[] | undefined;
         referrer?: string | undefined;
+        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

@@ -349,6 +349,15 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
         } | undefined;
     };
     description?: string | undefined;
+    rewards?: {
+        op: "set" | "add";
+        objects: string[];
+    } | {
+        op: "remove";
+        objects: string[];
+    } | {
+        op: "clear";
+    } | undefined;
     location?: string | undefined;
     owner_receive?: {
         received: {
@@ -363,15 +372,6 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
         id: string;
         content_raw?: any;
     }[] | undefined;
-    rewards?: {
-        op: "set" | "add";
-        objects: string[];
-    } | {
-        op: "remove";
-        objects: string[];
-    } | {
-        op: "clear";
-    } | undefined;
     guards?: {
         op: "add";
         guard: {
@@ -419,6 +419,15 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
         } | undefined;
     };
     description?: string | undefined;
+    rewards?: {
+        op: "set" | "add";
+        objects: string[];
+    } | {
+        op: "remove";
+        objects: string[];
+    } | {
+        op: "clear";
+    } | undefined;
     location?: string | undefined;
     owner_receive?: {
         received: {
@@ -433,15 +442,6 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
         id: string;
         content_raw?: any;
     }[] | undefined;
-    rewards?: {
-        op: "set" | "add";
-        objects: string[];
-    } | {
-        op: "remove";
-        objects: string[];
-    } | {
-        op: "clear";
-    } | undefined;
     guards?: {
         op: "add";
         guard: {
@@ -721,6 +721,15 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             } | undefined;
         };
         description?: string | undefined;
+        rewards?: {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        } | undefined;
         location?: string | undefined;
         owner_receive?: {
             received: {
@@ -735,15 +744,6 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             id: string;
             content_raw?: any;
         }[] | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
         guards?: {
             op: "add";
             guard: {
@@ -791,6 +791,15 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             } | undefined;
         };
         description?: string | undefined;
+        rewards?: {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        } | undefined;
         location?: string | undefined;
         owner_receive?: {
             received: {
@@ -805,15 +814,6 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             id: string;
             content_raw?: any;
         }[] | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
         guards?: {
             op: "add";
             guard: {
@@ -853,18 +853,33 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         no_cache: z.ZodOptional<z.ZodBoolean>;
         network: z.ZodOptional<z.ZodEnum<[import("@wowok/wowok").ENTRYPOINT.Localnet, import("@wowok/wowok").ENTRYPOINT.Testnet, import("@wowok/wowok").ENTRYPOINT.Mainnet]>>;
         referrer: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        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;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
         referrer?: string | undefined;
+        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;
         account?: string | undefined;
         permission_guard?: string[] | undefined;
         referrer?: string | undefined;
+        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">;
@@ -1062,6 +1077,15 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             } | undefined;
         };
         description?: string | undefined;
+        rewards?: {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        } | undefined;
         location?: string | undefined;
         owner_receive?: {
             received: {
@@ -1076,15 +1100,6 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             id: string;
             content_raw?: any;
         }[] | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
         guards?: {
             op: "add";
             guard: {
@@ -1151,6 +1166,11 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
         referrer?: string | undefined;
+        confirmed?: boolean | undefined;
+        user_intent_phrases?: string[] | undefined;
+        project?: string | undefined;
+        client_schema_version?: string | undefined;
+        schema_strict_mode?: boolean | undefined;
     } | undefined;
 }, {
     data: {
@@ -1168,6 +1188,15 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             } | undefined;
         };
         description?: string | undefined;
+        rewards?: {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        } | undefined;
         location?: string | undefined;
         owner_receive?: {
             received: {
@@ -1182,15 +1211,6 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             id: string;
             content_raw?: any;
         }[] | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
         guards?: {
             op: "add";
             guard: {
@@ -1257,6 +1277,11 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         account?: string | undefined;
         permission_guard?: string[] | undefined;
         referrer?: string | undefined;
+        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>;