@continuumdao/ctm-mpc-defi 0.2.11 → 0.2.12

package/dist/agent/catalog.js

@@ -413,6 +413,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)."
     }
   }
 };
@@ -481,6 +489,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(schema, {
     target: "openApi3",
@@ -521,23 +545,30 @@ var chainDetailSchema = z.object({
 );
 var evmMultisignCommonInputSchema = z.object({
   keyGenId: 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: 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: z.boolean().describe(
+  useCustomGas: z.boolean().default(false).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."
   ),
   chainId: z.number().int().positive().describe("EVM chain id (decimal). Becomes destinationChainID on the sign request."),
-  rpcUrl: 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,
+  rpcUrl: 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: z.record(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 = z.object({
   bodyForSign: z.record(z.unknown()).describe(
     "POST body fields without clientSig: keyList, pubKey, msgHash, msgRaw, destinationChainID, purpose, extraJSON, proposalTxParams (batch), messageHashes/messageRawBatch when N>1 txs."
@@ -585,18 +616,20 @@ var mcpUniswapV4CreateSwapOutputSchema = z.object({
   gasFee: 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: z.object({
+var mcpUniswapV4BuildSwapMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    tokenIn: evmAddressSchema.describe("Token in; 0x0 for native ETH"),
     swap: swapTxRequestSchema,
-    requestId: z.string().optional(),
-    gasFee: z.string().optional()
-  }).passthrough().describe("Full create_swap response"),
-  fullQuoteSnapshot: jsonObjectSchema.describe("Quote JSON used for the swap"),
-  swapDeadlineUnix: z.number().describe("Same deadline passed to create_swap"),
-  slippagePercent: z.number().optional().describe("Extra approve headroom for EXACT_OUTPUT")
-});
+    createSwapResponse: z.object({
+      swap: swapTxRequestSchema,
+      requestId: z.string().optional(),
+      gasFee: z.string().optional()
+    }).passthrough().describe("Full create_swap response"),
+    fullQuoteSnapshot: jsonObjectSchema.describe("Quote JSON used for the swap"),
+    swapDeadlineUnix: z.number().describe("Same deadline passed to create_swap"),
+    slippagePercent: z.number().optional().describe("Extra approve headroom for EXACT_OUTPUT")
+  })
+);
 var lpExistingPoolSchema = z.object({
   token0Address: evmAddressSchema,
   token1Address: evmAddressSchema,
@@ -736,21 +769,27 @@ var lpBuildCommonSchema = {
   nativeWrapped: evmAddressSchema.optional(),
   poolReference: z.string().optional()
 };
-var mcpUniswapV4BuildMintLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend(
-  lpBuildCommonSchema
+var mcpUniswapV4BuildMintLiquidityMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend(lpBuildCommonSchema)
+);
+var mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    ...lpBuildCommonSchema,
+    nftTokenId: z.union([z.string(), z.number()])
+  })
+);
+var mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    ...lpBuildCommonSchema,
+    nftTokenId: z.union([z.string(), z.number()])
+  })
+);
+var mcpUniswapV4BuildCollectFeesMultisignInputSchema = withMultisignKeySourceRefine(
+  evmMultisignCommonInputSchema.extend({
+    ...lpBuildCommonSchema,
+    nftTokenId: z.union([z.string(), z.number()])
+  })
 );
-var mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  ...lpBuildCommonSchema,
-  nftTokenId: z.union([z.string(), z.number()])
-});
-var mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  ...lpBuildCommonSchema,
-  nftTokenId: z.union([z.string(), z.number()])
-});
-var mcpUniswapV4BuildCollectFeesMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  ...lpBuildCommonSchema,
-  nftTokenId: z.union([z.string(), z.number()])
-});
 var mcpCurveDaoQuoteInputSchema = z.object({
   chainId: z.number().int().positive().describe("EVM chain id (rpcUrl resolved from get_chain_registry rpcGateway)"),
   rpcUrl: z.string().min(1).optional().describe("JSON-RPC URL; continuum-mcp-server injects from chain registry \u2014 do not pass a public RPC URL"),
@@ -762,12 +801,14 @@ var mcpCurveDaoQuoteInputSchema = 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: z.string().min(1).describe("Output token or 0xeeee\u2026 native placeholder"),
-  amountHuman: z.string().min(1).describe("Human-readable amount of tokenIn"),
-  slippagePercent: 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: z.string().min(1).describe("Output token or 0xeeee\u2026 native placeholder"),
+    amountHuman: z.string().min(1).describe("Human-readable amount of tokenIn"),
+    slippagePercent: z.number().gt(0).lt(100).describe("Slippage 0\u2013100 exclusive")
+  })
+);
 var mcpServerCommonInputSchema = z.object({
   keyGenId: z.string().min(1).describe("KeyGen id from fetch_key_gen_result / node preferred KeyGen"),
   chainId: z.number().int().positive().describe("EVM chain id; RPC and gas config resolved from chain registry"),
@@ -778,7 +819,11 @@ function mcpServerMultisignInput(fields) {
   return mcpServerCommonInputSchema.extend(fields);
 }
 var mcpServerSubmitOutputSchema = z.object({
-  requestId: z.string().min(1).describe("Sign request id from POST /multiSignRequest \u2014 success; do not retry the same build tool.")
+  requestId: z.string().min(1).describe("Sign request id from POST /multiSignRequest \u2014 success; do not retry the same build tool."),
+  status: z.literal("submitted").optional().describe("Present when POST /multiSignRequest succeeded. Confirms the request exists on the node."),
+  followUp: 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."
 );
@@ -789,7 +834,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: z.string().min(1).describe("ETH to stake (wei decimal string)"),
@@ -996,7 +1041,7 @@ var mcpMorphoFetchEarnVaultsOutputSchema = z.object({
   )
 });
 function mcpGmxMultisignInput(fields) {
-  return evmMultisignCommonInputSchema.extend(fields);
+  return withMultisignKeySourceRefine(evmMultisignCommonInputSchema.extend(fields));
 }
 var gmxDirectionSchema = z.enum(["long", "short"]);
 var gmxOrderTypeSchema = z.enum(["market", "limit"]);
@@ -1144,7 +1189,7 @@ var mcpGmxFetchOhlcvOutputSchema = z.object({
   candles: z.array(gmxOhlcvCandleSchema)
 });
 function mcpHyperliquidMultisignInput(fields) {
-  return evmMultisignCommonInputSchema.extend(fields);
+  return withMultisignKeySourceRefine(evmMultisignCommonInputSchema.extend(fields));
 }
 var hyperliquidTifSchema = z.enum(["alo", "gtc", "ioc"]);
 var hyperliquidOhlcvIntervalSchema = z.enum([
@@ -1457,7 +1502,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)
@@ -2018,12 +2063,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({