@quackai/q402-mcp 0.6.6 → 0.7.0

package/dist/index.js

@@ -211,7 +211,7 @@ var isValidPrivateKey = (s) => typeof s === "string" && PRIVATE_KEY_RE.test(s);
 
 // src/version.ts
 var PACKAGE_NAME = "@quackai/q402-mcp";
-var PACKAGE_VERSION = "0.6.6";
+var PACKAGE_VERSION = "0.7.0";
 
 // src/tools/quote.ts
 import { z } from "zod";
@@ -2971,6 +2971,255 @@ async function runRecurringFires(input) {
   }
 }
 
+// src/tools/recurring-pause.ts
+import { z as z14 } from "zod";
+var RecurringPauseInputSchema = z14.object({
+  ruleId: z14.string().min(1).describe(
+    "Rule id to pause. Obtain from q402_recurring_list \u2014 each entry's `ruleId` field. Pausing is immediate and reversible."
+  ),
+  walletId: z14.string().optional().describe(
+    "Optional lowercased Agent Wallet address when the user holds multiple wallets. Defaults to Q402_AGENT_WALLET_ADDRESS env, then the owner's default wallet."
+  )
+});
+var RECURRING_PAUSE_TOOL = {
+  name: "q402_recurring_pause",
+  description: `Pause an active recurring-payment rule. Takes a ruleId (from q402_recurring_list). The rule transitions to status "paused" \u2014 the cron skips it on every tick until you resume. Fully reversible via q402_recurring_resume. Use this when the user says 'pause my Friday payout' or 'hold on, stop my recurring rule for now' \u2014 gentler than cancel, no re-authoring required. Authenticated by the paid Multichain API key (same gate as create/cancel). Read q402_recurring_list first to find the matching ruleId.`,
+  inputSchema: {
+    type: "object",
+    properties: {
+      ruleId: {
+        type: "string",
+        description: "Rule id from q402_recurring_list. Required."
+      },
+      walletId: {
+        type: "string",
+        description: "Optional. Lowercased Agent Wallet address when the user holds multiple wallets. Defaults to Q402_AGENT_WALLET_ADDRESS env, then the owner's default wallet on the server."
+      }
+    },
+    required: ["ruleId"],
+    additionalProperties: false
+  }
+};
+async function runRecurringPause(input) {
+  const base = CONFIG.relayBaseUrl;
+  const dashboardUrl = base.replace(/\/api$/, "") + "/dashboard?tab=agent";
+  if (!CONFIG.apiKey || !CONFIG.apiKey.startsWith("q402_live_")) {
+    return {
+      ok: false,
+      walletId: null,
+      rule: null,
+      error: "API_KEY_REQUIRED",
+      message: "No live Q402 API key configured. Run q402_doctor to set one up.",
+      dashboardUrl
+    };
+  }
+  const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
+  try {
+    const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        apiKey: CONFIG.apiKey,
+        action: "pause",
+        ruleId: input.ruleId,
+        ...explicitWalletId ? { walletId: explicitWalletId } : {}
+      })
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      return {
+        ok: false,
+        walletId: explicitWalletId,
+        rule: null,
+        error: data.error ?? `HTTP_${res.status}`,
+        message: data.message ?? `Pause failed with HTTP ${res.status}.`,
+        dashboardUrl
+      };
+    }
+    return {
+      ok: true,
+      walletId: data.walletId ?? explicitWalletId,
+      rule: data.rule ?? null,
+      dashboardUrl
+    };
+  } catch (e) {
+    return {
+      ok: false,
+      walletId: explicitWalletId,
+      rule: null,
+      error: "NETWORK_ERROR",
+      message: e instanceof Error ? e.message : String(e),
+      dashboardUrl
+    };
+  }
+}
+
+// src/tools/recurring-resume.ts
+import { z as z15 } from "zod";
+var RecurringResumeInputSchema = z15.object({
+  ruleId: z15.string().min(1).describe(
+    "Rule id to resume. Obtain from q402_recurring_list \u2014 each entry's `ruleId` field. Resume is immediate; nextRunAt advances to the next valid slot."
+  ),
+  walletId: z15.string().optional().describe(
+    "Optional lowercased Agent Wallet address when the user holds multiple wallets. Defaults to Q402_AGENT_WALLET_ADDRESS env, then the owner's default wallet."
+  )
+});
+var RECURRING_RESUME_TOOL = {
+  name: "q402_recurring_resume",
+  description: "Resume a paused or stopped recurring-payment rule. Takes a ruleId (from q402_recurring_list). Supported transitions: paused \u2192 active, paused-by-archive \u2192 active (after restoring the wallet), and fired-cap-exceeded \u2192 active (after raising the per-tx cap or re-subscribing). nextRunAt is advanced to the next valid slot so the rule doesn't immediately fire on a stale schedule. Cancelled rules cannot be resumed \u2014 re-author via q402_recurring_create. Authenticated by the paid Multichain API key.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      ruleId: {
+        type: "string",
+        description: "Rule id from q402_recurring_list. Required."
+      },
+      walletId: {
+        type: "string",
+        description: "Optional. Lowercased Agent Wallet address when the user holds multiple wallets. Defaults to Q402_AGENT_WALLET_ADDRESS env, then the owner's default wallet on the server."
+      }
+    },
+    required: ["ruleId"],
+    additionalProperties: false
+  }
+};
+async function runRecurringResume(input) {
+  const base = CONFIG.relayBaseUrl;
+  const dashboardUrl = base.replace(/\/api$/, "") + "/dashboard?tab=agent";
+  if (!CONFIG.apiKey || !CONFIG.apiKey.startsWith("q402_live_")) {
+    return {
+      ok: false,
+      walletId: null,
+      rule: null,
+      error: "API_KEY_REQUIRED",
+      message: "No live Q402 API key configured. Run q402_doctor to set one up.",
+      dashboardUrl
+    };
+  }
+  const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
+  try {
+    const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        apiKey: CONFIG.apiKey,
+        action: "resume",
+        ruleId: input.ruleId,
+        ...explicitWalletId ? { walletId: explicitWalletId } : {}
+      })
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      return {
+        ok: false,
+        walletId: explicitWalletId,
+        rule: null,
+        error: data.error ?? `HTTP_${res.status}`,
+        message: data.message ?? `Resume failed with HTTP ${res.status}.`,
+        dashboardUrl
+      };
+    }
+    return {
+      ok: true,
+      walletId: data.walletId ?? explicitWalletId,
+      rule: data.rule ?? null,
+      dashboardUrl
+    };
+  } catch (e) {
+    return {
+      ok: false,
+      walletId: explicitWalletId,
+      rule: null,
+      error: "NETWORK_ERROR",
+      message: e instanceof Error ? e.message : String(e),
+      dashboardUrl
+    };
+  }
+}
+
+// src/tools/recurring-skip-next.ts
+import { z as z16 } from "zod";
+var RecurringSkipNextInputSchema = z16.object({
+  ruleId: z16.string().min(1).describe(
+    "Rule id whose next scheduled fire to skip. Obtain from q402_recurring_list \u2014 each entry's `ruleId` field."
+  ),
+  walletId: z16.string().optional().describe(
+    "Optional lowercased Agent Wallet address when the user holds multiple wallets. Defaults to Q402_AGENT_WALLET_ADDRESS env, then the owner's default wallet."
+  )
+});
+var RECURRING_SKIP_NEXT_TOOL = {
+  name: "q402_recurring_skip_next",
+  description: "Skip ONLY the next scheduled fire of a recurring-payment rule. Cadence is preserved \u2014 the fire after the skipped one runs normally. Use this when the user says 'skip the next Friday payout, Alice is on holiday' or 'don't fire this month's subscription, charge it next month'. The rule must be in active status; paused / cancelled rules must be resumed first. Authenticated by the paid Multichain API key. Call q402_recurring_list first to confirm the ruleId and current schedule.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      ruleId: {
+        type: "string",
+        description: "Rule id from q402_recurring_list. Required."
+      },
+      walletId: {
+        type: "string",
+        description: "Optional. Lowercased Agent Wallet address when the user holds multiple wallets. Defaults to Q402_AGENT_WALLET_ADDRESS env, then the owner's default wallet on the server."
+      }
+    },
+    required: ["ruleId"],
+    additionalProperties: false
+  }
+};
+async function runRecurringSkipNext(input) {
+  const base = CONFIG.relayBaseUrl;
+  const dashboardUrl = base.replace(/\/api$/, "") + "/dashboard?tab=agent";
+  if (!CONFIG.apiKey || !CONFIG.apiKey.startsWith("q402_live_")) {
+    return {
+      ok: false,
+      walletId: null,
+      rule: null,
+      error: "API_KEY_REQUIRED",
+      message: "No live Q402 API key configured. Run q402_doctor to set one up.",
+      dashboardUrl
+    };
+  }
+  const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
+  try {
+    const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        apiKey: CONFIG.apiKey,
+        action: "skip-next",
+        ruleId: input.ruleId,
+        ...explicitWalletId ? { walletId: explicitWalletId } : {}
+      })
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      return {
+        ok: false,
+        walletId: explicitWalletId,
+        rule: null,
+        error: data.error ?? `HTTP_${res.status}`,
+        message: data.message ?? `Skip-next failed with HTTP ${res.status}.`,
+        dashboardUrl
+      };
+    }
+    return {
+      ok: true,
+      walletId: data.walletId ?? explicitWalletId,
+      rule: data.rule ?? null,
+      dashboardUrl
+    };
+  } catch (e) {
+    return {
+      ok: false,
+      walletId: explicitWalletId,
+      rule: null,
+      error: "NETWORK_ERROR",
+      message: e instanceof Error ? e.message : String(e),
+      dashboardUrl
+    };
+  }
+}
+
 // src/index.ts
 function jsonText(value) {
   return { type: "text", text: JSON.stringify(value, null, 2) };
@@ -2995,6 +3244,9 @@ async function main() {
       RECURRING_LIST_TOOL,
       RECURRING_CREATE_TOOL,
       RECURRING_FIRES_TOOL,
+      RECURRING_PAUSE_TOOL,
+      RECURRING_RESUME_TOOL,
+      RECURRING_SKIP_NEXT_TOOL,
       RECURRING_CANCEL_TOOL,
       CLEAR_DELEGATION_TOOL
     ]
@@ -3055,6 +3307,18 @@ async function main() {
           const parsed = RecurringFiresInputSchema.parse(args ?? {});
           return { content: [jsonText(await runRecurringFires(parsed))] };
         }
+        case "q402_recurring_pause": {
+          const parsed = RecurringPauseInputSchema.parse(args ?? {});
+          return { content: [jsonText(await runRecurringPause(parsed))] };
+        }
+        case "q402_recurring_resume": {
+          const parsed = RecurringResumeInputSchema.parse(args ?? {});
+          return { content: [jsonText(await runRecurringResume(parsed))] };
+        }
+        case "q402_recurring_skip_next": {
+          const parsed = RecurringSkipNextInputSchema.parse(args ?? {});
+          return { content: [jsonText(await runRecurringSkipNext(parsed))] };
+        }
         default:
           return {
             isError: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quackai/q402-mcp",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "MCP server for Q402 — gasless USDC, USDT, and RLUSD payments across 9 EVM chains, callable from Claude (Desktop / Code), OpenAI Codex CLI, and any other Model Context Protocol client.",
   "mcpName": "io.github.bitgett/q402-mcp",
   "keywords": [