@continuumdao/ctm-mpc-defi 0.2.11 → 0.2.13

package/dist/agent/catalog.cjs

@@ -416,6 +416,14 @@ var MULTISIGN_SUBMIT_OUTPUT_DOC = {
     requestId: {
       type: "string",
       description: "Sign request id from POST /multiSignRequest."
+    },
+    status: {
+      type: "string",
+      description: "submitted when POST succeeded \u2014 do not call the same build tool again."
+    },
+    followUp: {
+      type: "string",
+      description: "Lifecycle next steps (wait_for_sign_request_ready \u2192 agree \u2192 trigger \u2192 broadcast)."
     }
   }
 };
@@ -484,6 +492,22 @@ function withMultisignSubmitMcpMeta(description, followUp = MCP_MULTISIGN_SUBMIT
     followUp: [...followUp]
   };
 }
+var MULTISIGN_SERVER_RESOLVED_KEYS = /* @__PURE__ */ new Set([
+  "keyGen",
+  "rpcUrl",
+  "executorAddress",
+  "chainDetail",
+  "customGasChainDetails"
+]);
+function agentFacingMultisignJsonSchema(schema) {
+  const raw = zodSchemaToMcpJsonSchema(schema);
+  const prevRequired = Array.isArray(raw.required) ? [...raw.required] : [];
+  const agentRequired = prevRequired.filter((k) => !MULTISIGN_SERVER_RESOLVED_KEYS.has(k));
+  if (!agentRequired.includes("keyGenId")) {
+    agentRequired.unshift("keyGenId");
+  }
+  return { ...raw, required: agentRequired };
+}
 function zodSchemaToMcpJsonSchema(schema) {
   const raw = zodToJsonSchema.zodToJsonSchema(schema, {
     target: "openApi3",
@@ -503,6 +527,41 @@ function zodSchemaToMcpJsonSchema(schema) {
   }
   return raw;
 }
+function parseAgentBoolean(raw, defaultValue = false) {
+  if (raw === void 0 || raw === null) return defaultValue;
+  if (typeof raw === "boolean") return raw;
+  if (typeof raw === "number") return raw !== 0;
+  if (typeof raw === "string") {
+    const t = raw.trim().toLowerCase();
+    if (t === "true" || t === "1" || t === "yes") return true;
+    if (t === "false" || t === "0" || t === "no" || t === "") return false;
+  }
+  return Boolean(raw);
+}
+var CHAIN_ID_DECIMAL_HEX_TYPOS = {
+  33875: 8453
+};
+function parseAgentEvmChainId(raw) {
+  if (typeof raw === "number" && Number.isInteger(raw) && raw > 0) return raw;
+  if (typeof raw !== "string") return Number.NaN;
+  const t = raw.trim();
+  if (!t) return Number.NaN;
+  if (t.toLowerCase().startsWith("0x")) {
+    const hexVal = Number.parseInt(t, 16);
+    if (!Number.isFinite(hexVal) || hexVal <= 0) return Number.NaN;
+    return CHAIN_ID_DECIMAL_HEX_TYPOS[hexVal] ?? hexVal;
+  }
+  const dec = Number.parseInt(t, 10);
+  return Number.isFinite(dec) && dec > 0 ? dec : Number.NaN;
+}
+var agentBooleanSchema = (defaultValue = false) => zod.z.preprocess((val) => parseAgentBoolean(val, defaultValue), zod.z.boolean());
+var agentOptionalBooleanSchema = () => zod.z.preprocess((val) => val === void 0 || val === null ? void 0 : parseAgentBoolean(val, false), zod.z.boolean().optional());
+var agentEvmChainIdSchema = zod.z.preprocess(
+  (val) => parseAgentEvmChainId(val),
+  zod.z.number().int().positive().describe("EVM chain id (decimal, e.g. 8453 for Base \u2014 not 0x8453).")
+);
+
+// src/agent/schemas/common.ts
 var evmAddressSchema = zod.z.string().min(1).describe("EVM address (0x-prefixed, 40 hex nibbles)");
 var keyGenSchema = zod.z.object({
   pubkeyhex: zod.z.string().min(1).describe("MPC secp256k1 public key hex (required for multiSignRequest pubKey)"),
@@ -524,23 +583,30 @@ var chainDetailSchema = zod.z.object({
 );
 var evmMultisignCommonInputSchema = zod.z.object({
   keyGenId: zod.z.string().min(1).optional().describe(
-    "KeyGen request id from get_preferred_key_gen / conversation context. MCP server resolves keyGen, executorAddress, rpcUrl, and chainDetail \u2014 do not pass those fields when keyGenId is set."
+    "KeyGen request id from get_preferred_key_gen / conversation context. MCP server resolves keyGen, executorAddress, rpcUrl, and chainDetail \u2014 agents must pass keyGenId only."
   ),
-  keyGen: keyGenSchema,
+  keyGen: keyGenSchema.optional().describe("Server-filled from keyGenId. Agents must not pass keyGen."),
   purposeText: zod.z.string().min(1).describe(
     "Human-readable purpose for the sign request. Stored in bodyForSign.purpose (may be appended with an automatic batch suffix)."
   ),
-  useCustomGas: zod.z.boolean().describe(
-    "When true, apply Custom Gas Config from chainDetail / customGasChainDetails. Omitted baseFee/priorityFee is valid \u2014 builder uses live RPC fees; configured values are optional floors/multipliers. When false, use live RPC estimates only."
+  useCustomGas: agentBooleanSchema(false).describe(
+    "JSON boolean only: false = live RPC fees (default), true = chain registry Custom Gas Config. Omitted baseFee/priorityFee is valid when true."
   ),
-  chainId: zod.z.number().int().positive().describe("EVM chain id (decimal). Becomes destinationChainID on the sign request."),
-  rpcUrl: zod.z.string().min(1).describe("HTTPS JSON-RPC URL for gas estimation, nonce, and allowance reads."),
-  executorAddress: evmAddressSchema.describe(
-    "MPC wallet address (from keyGen ethereumaddress) \u2014 tx sender for estimates and approvals."
-  ),
-  chainDetail: chainDetailSchema,
+  chainId: agentEvmChainIdSchema,
+  rpcUrl: zod.z.string().min(1).optional().describe("Server-filled from chain registry when keyGenId is set. Agents must not pass rpcUrl."),
+  executorAddress: evmAddressSchema.optional().describe("Server-filled MPC wallet from keyGenId. Agents must not pass executorAddress."),
+  chainDetail: chainDetailSchema.optional().describe("Server-filled gas row from chain registry when keyGenId is set."),
   customGasChainDetails: zod.z.record(zod.z.unknown()).optional().describe("Snapshot written to extraJSON.customGasChainDetails when useCustomGas is true.")
 });
+function withMultisignKeySourceRefine(schema) {
+  return schema.refine(
+    (d) => Boolean(d.keyGenId?.trim()) || Boolean(d.keyGen?.pubkeyhex?.trim() && d.executorAddress?.trim() && d.rpcUrl?.trim()),
+    {
+      message: "keyGenId is required for MCP agents (or pass keyGen + executorAddress + rpcUrl for manual calls).",
+      path: ["keyGenId"]
+    }
+  );
+}
 var multisignOutputSchema = zod.z.object({
   bodyForSign: zod.z.record(zod.z.unknown()).describe(
     "POST body fields without clientSig: keyList, pubKey, msgHash, msgRaw, destinationChainID, purpose, extraJSON, proposalTxParams (batch), messageHashes/messageRawBatch when N>1 txs."
@@ -588,18 +654,20 @@ var mcpUniswapV4CreateSwapOutputSchema = zod.z.object({
   gasFee: zod.z.string().optional()
 }).passthrough().describe("{ swap: TransactionRequest, requestId?, gasFee? }");
 var swapTxRequestSchema = jsonObjectSchema.describe("swap field from create_swap response (to, data, value)");
-var mcpUniswapV4BuildSwapMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  tokenIn: evmAddressSchema.describe("Token in; 0x0 for native ETH"),
-  swap: swapTxRequestSchema,
-  createSwapResponse: zod.z.object({
+var mcpUniswapV4BuildSwapMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    tokenIn: evmAddressSchema.describe("Token in; 0x0 for native ETH"),
     swap: swapTxRequestSchema,
-    requestId: zod.z.string().optional(),
-    gasFee: zod.z.string().optional()
-  }).passthrough().describe("Full create_swap response"),
-  fullQuoteSnapshot: jsonObjectSchema.describe("Quote JSON used for the swap"),
-  swapDeadlineUnix: zod.z.number().describe("Same deadline passed to create_swap"),
-  slippagePercent: zod.z.number().optional().describe("Extra approve headroom for EXACT_OUTPUT")
-});
+    createSwapResponse: zod.z.object({
+      swap: swapTxRequestSchema,
+      requestId: zod.z.string().optional(),
+      gasFee: zod.z.string().optional()
+    }).passthrough().describe("Full create_swap response"),
+    fullQuoteSnapshot: jsonObjectSchema.describe("Quote JSON used for the swap"),
+    swapDeadlineUnix: zod.z.number().describe("Same deadline passed to create_swap"),
+    slippagePercent: zod.z.number().optional().describe("Extra approve headroom for EXACT_OUTPUT")
+  })
+);
 var lpExistingPoolSchema = zod.z.object({
   token0Address: evmAddressSchema,
   token1Address: evmAddressSchema,
@@ -739,21 +807,27 @@ var lpBuildCommonSchema = {
   nativeWrapped: evmAddressSchema.optional(),
   poolReference: zod.z.string().optional()
 };
-var mcpUniswapV4BuildMintLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend(
-  lpBuildCommonSchema
+var mcpUniswapV4BuildMintLiquidityMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend(lpBuildCommonSchema)
+);
+var mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    ...lpBuildCommonSchema,
+    nftTokenId: zod.z.union([zod.z.string(), zod.z.number()])
+  })
+);
+var mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    ...lpBuildCommonSchema,
+    nftTokenId: zod.z.union([zod.z.string(), zod.z.number()])
+  })
+);
+var mcpUniswapV4BuildCollectFeesMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    ...lpBuildCommonSchema,
+    nftTokenId: zod.z.union([zod.z.string(), zod.z.number()])
+  })
 );
-var mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  ...lpBuildCommonSchema,
-  nftTokenId: zod.z.union([zod.z.string(), zod.z.number()])
-});
-var mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  ...lpBuildCommonSchema,
-  nftTokenId: zod.z.union([zod.z.string(), zod.z.number()])
-});
-var mcpUniswapV4BuildCollectFeesMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  ...lpBuildCommonSchema,
-  nftTokenId: zod.z.union([zod.z.string(), zod.z.number()])
-});
 var mcpCurveDaoQuoteInputSchema = zod.z.object({
   chainId: zod.z.number().int().positive().describe("EVM chain id (rpcUrl resolved from get_chain_registry rpcGateway)"),
   rpcUrl: zod.z.string().min(1).optional().describe("JSON-RPC URL; continuum-mcp-server injects from chain registry \u2014 do not pass a public RPC URL"),
@@ -765,12 +839,14 @@ var mcpCurveDaoQuoteInputSchema = zod.z.object({
 var mcpCurveDaoQuoteOutputSchema = jsonObjectSchema.describe(
   "Curve router quote: { inputAmount, output, route, priceImpactPercent?, tokenInRouterId, tokenOutRouterId }"
 );
-var mcpCurveDaoBuildSwapMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  tokenIn: evmAddressSchema.describe("ERC-20 sold (native in uses WETH path in UI)"),
-  tokenOut: zod.z.string().min(1).describe("Output token or 0xeeee\u2026 native placeholder"),
-  amountHuman: zod.z.string().min(1).describe("Human-readable amount of tokenIn"),
-  slippagePercent: zod.z.number().gt(0).lt(100).describe("Slippage 0\u2013100 exclusive")
-});
+var mcpCurveDaoBuildSwapMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    tokenIn: evmAddressSchema.describe("ERC-20 sold (native in uses WETH path in UI)"),
+    tokenOut: zod.z.string().min(1).describe("Output token or 0xeeee\u2026 native placeholder"),
+    amountHuman: zod.z.string().min(1).describe("Human-readable amount of tokenIn"),
+    slippagePercent: zod.z.number().gt(0).lt(100).describe("Slippage 0\u2013100 exclusive")
+  })
+);
 var mcpServerCommonInputSchema = zod.z.object({
   keyGenId: zod.z.string().min(1).describe("KeyGen id from fetch_key_gen_result / node preferred KeyGen"),
   chainId: zod.z.number().int().positive().describe("EVM chain id; RPC and gas config resolved from chain registry"),
@@ -781,7 +857,11 @@ function mcpServerMultisignInput(fields) {
   return mcpServerCommonInputSchema.extend(fields);
 }
 var mcpServerSubmitOutputSchema = zod.z.object({
-  requestId: zod.z.string().min(1).describe("Sign request id from POST /multiSignRequest \u2014 success; do not retry the same build tool.")
+  requestId: zod.z.string().min(1).describe("Sign request id from POST /multiSignRequest \u2014 success; do not retry the same build tool."),
+  status: zod.z.literal("submitted").optional().describe("Present when POST /multiSignRequest succeeded. Confirms the request exists on the node."),
+  followUp: zod.z.string().optional().describe(
+    "Next MCP lifecycle steps. Do not call the same build_*_multisign tool again unless the user explicitly wants a duplicate order."
+  )
 }).describe(
   "Submitted mpc-auth multiSignRequest. Continue with wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result."
 );
@@ -792,7 +872,7 @@ var MCP_NON_SUBMIT_TOOL_NAMES = /* @__PURE__ */ new Set([
 
 // src/agent/schemas/protocols.ts
 function mcpMultisignInput(fields) {
-  return evmMultisignCommonInputSchema.extend(fields);
+  return withMultisignKeySourceRefine(evmMultisignCommonInputSchema.extend(fields));
 }
 var mcpLidoSubmitInputSchema = mcpMultisignInput({
   valueWei: zod.z.string().min(1).describe("ETH to stake (wei decimal string)"),
@@ -934,7 +1014,7 @@ var mcpMorphoVaultDepositInputSchema = mcpMultisignInput({
   vault: evmAddressSchema,
   underlying: evmAddressSchema.describe("Underlying asset; use wrapped native with isNativeIn for ETH."),
   amountHuman: zod.z.string().min(1),
-  isNativeIn: zod.z.boolean().optional()
+  isNativeIn: agentOptionalBooleanSchema()
 });
 var mcpMorphoVaultWithdrawInputSchema = mcpMultisignInput({
   vault: evmAddressSchema,
@@ -944,7 +1024,7 @@ var mcpMorphoBlueCollateralDepositInputSchema = mcpMultisignInput({
   marketId: zod.z.string().min(1).describe("Morpho Blue marketId from API."),
   collateralToken: evmAddressSchema,
   amountHuman: zod.z.string().min(1),
-  isNativeIn: zod.z.boolean().optional()
+  isNativeIn: agentOptionalBooleanSchema()
 });
 var mcpMorphoBlueBorrowInputSchema = mcpMultisignInput({
   marketId: zod.z.string().min(1),
@@ -999,7 +1079,7 @@ var mcpMorphoFetchEarnVaultsOutputSchema = zod.z.object({
   )
 });
 function mcpGmxMultisignInput(fields) {
-  return evmMultisignCommonInputSchema.extend(fields);
+  return withMultisignKeySourceRefine(evmMultisignCommonInputSchema.extend(fields));
 }
 var gmxDirectionSchema = zod.z.enum(["long", "short"]);
 var gmxOrderTypeSchema = zod.z.enum(["market", "limit"]);
@@ -1147,7 +1227,7 @@ var mcpGmxFetchOhlcvOutputSchema = zod.z.object({
   candles: zod.z.array(gmxOhlcvCandleSchema)
 });
 function mcpHyperliquidMultisignInput(fields) {
-  return evmMultisignCommonInputSchema.extend(fields);
+  return withMultisignKeySourceRefine(evmMultisignCommonInputSchema.extend(fields));
 }
 var hyperliquidTifSchema = zod.z.enum(["alo", "gtc", "ioc"]);
 var hyperliquidOhlcvIntervalSchema = zod.z.enum([
@@ -1460,7 +1540,7 @@ function defineProtocolMcpTool(def) {
     description: meta.description,
     followUp: meta.followUp,
     outputZod: mcpServerSubmitOutputSchema,
-    inputSchema: zodSchemaToMcpJsonSchema(def.inputZod),
+    inputSchema: agentFacingMultisignJsonSchema(def.inputZod),
     outputSchema: zodSchemaToMcpJsonSchema(mcpServerSubmitOutputSchema),
     parseInput: (data) => def.inputZod.parse(data),
     parseOutput: (data) => mcpServerSubmitOutputSchema.parse(data)
@@ -2021,12 +2101,16 @@ function defineMcpTool(def) {
 }
 function defineMultisignSubmitMcpTool(def) {
   const meta = withMultisignSubmitMcpMeta(def.description, def.followUp ?? MCP_MULTISIGN_SUBMIT_FOLLOW_UP);
-  return defineMcpTool({
+  return {
     ...def,
     description: meta.description,
     followUp: meta.followUp,
-    outputZod: mcpServerSubmitOutputSchema
-  });
+    outputZod: mcpServerSubmitOutputSchema,
+    inputSchema: agentFacingMultisignJsonSchema(def.inputZod),
+    outputSchema: zodSchemaToMcpJsonSchema(mcpServerSubmitOutputSchema),
+    parseInput: (data) => def.inputZod.parse(data),
+    parseOutput: (data) => mcpServerSubmitOutputSchema.parse(data)
+  };
 }
 var CORE_MCP_TOOL_DEFINITIONS = [
   defineMcpTool({
@@ -3986,6 +4070,8 @@ exports.mcpUniswapV4RegisterPositionFromMintTxOutputSchema = mcpUniswapV4Registe
 exports.mcpUniswapV4RegisterPositionNftInputSchema = mcpUniswapV4RegisterPositionNftInputSchema;
 exports.mcpUniswapV4RegisterPositionNftOutputSchema = mcpUniswapV4RegisterPositionNftOutputSchema;
 exports.multisignOutputSchema = multisignOutputSchema;
+exports.parseAgentBoolean = parseAgentBoolean;
+exports.parseAgentEvmChainId = parseAgentEvmChainId;
 exports.parseMcpToolInput = parseMcpToolInput;
 exports.parseMcpToolOutput = parseMcpToolOutput;
 exports.parseMultisignBuilderOutput = parseMultisignBuilderOutput;