@usethrottle/mcp 0.2.2 → 0.4.0

package/dist/mcp.js

@@ -1603,14 +1603,22 @@ var ACTIONS = [
     scopes: ["quotes:write"],
     input: [
       { name: "customerId", type: "string", required: true, description: "Customer the quote is for." },
-      { name: "items", type: "array", required: true, description: "Quote line items: { name, unitPrice, quantity }." },
+      {
+        name: "items",
+        type: "array",
+        required: true,
+        description: "Quote line items: { name, unitPrice, quantity }. Add `recurring: { plan, interval | intervalUnit + intervalCount, totalPayments?, trialDays? }` to make a line a subscription (one per line when the quote is paid, quantity = seats; at most 10). unitPrice is then the per-period price; a free-trial line is charged nothing at acceptance."
+      },
       { name: "expiresAt", type: "string", required: false, description: "ISO 8601 expiry." },
-      { name: "netN", type: "number", required: false, description: "Payment terms in days. Omit for pay-in-full." },
+      { name: "netN", type: "number", required: false, description: "Payment terms in days. Omit for pay-in-full. Not allowed when any item is recurring." },
       { name: "notes", type: "string", required: false, description: "Buyer-visible notes." }
     ],
     requests: [{ method: "POST", path: "/api/v1/quotes" }],
     channels: ["mcp", "zapier", "make", "n8n"],
-    idempotent: true
+    idempotent: true,
+    guardrails: [
+      "A quote with a recurring item must be pay-in-full: issuing it with net terms or a deposit fails with 422 recurring_terms_unsupported."
+    ]
   },
   {
     id: "send_quote",
@@ -1717,12 +1725,12 @@ var ACTIONS = [
   {
     id: "send_test_webhook",
     title: "Send a test webhook",
-    description: "Send a synthetic signed event to a webhook endpoint to verify signature handling and reachability.",
+    description: "Send a synthetic signed event to a webhook endpoint to verify signature handling and reachability. The event type must be one the endpoint is subscribed to (an endpoint subscribed to all events accepts any); otherwise the call fails with 400 validation_error naming the allowed types.",
     kind: "write",
     scopes: ["webhooks:write"],
     input: [
       { name: "id", type: "string", required: true, description: "Endpoint id." },
-      { name: "eventType", type: "string", required: false, description: "Event type to simulate." }
+      { name: "eventType", type: "string", required: false, description: "Event type to simulate. Must be in the endpoint's subscribed events unless it subscribes to all." }
     ],
     requests: [{ method: "POST", path: "/api/v1/webhook-endpoints/:id/test" }],
     channels: ["mcp", "n8n"],
@@ -2391,14 +2399,14 @@ var HANDLERS = {
       idempotencyKey: `mcp-manage-subscription-${id}-${action}-${Date.now()}`
     });
   },
-  create_quote: async (ctx, args) => (
-    // The real route's body shape differs from this tool's flatter,
-    // model-facing input: line items are "items" (not "lineItems"), Net-N
-    // terms are nested under paymentTerms.netN with an explicit mode (not a
-    // flat "netN"), and the buyer-visible note field is "buyerNote" (not
-    // "notes"). Confirmed against packages/platform-api/src/validation/quotes.ts's
-    // actual zod schema after a live call 400'd with unrecognized_keys.
-    ctx.client.post("/api/v1/quotes", {
+  create_quote: async (ctx, args) => {
+    const items = Array.isArray(args.items) ? args.items : [];
+    if (args.netN !== void 0 && items.some((item) => item && item.recurring)) {
+      throw new Error(
+        "create_quote: items with `recurring` need pay-in-full terms \u2014 omit netN. Net terms cannot start a subscription."
+      );
+    }
+    return ctx.client.post("/api/v1/quotes", {
       body: {
         customerId: args.customerId,
         items: args.items,
@@ -2407,8 +2415,8 @@ var HANDLERS = {
         buyerNote: args.notes
       },
       idempotencyKey: `mcp-create-quote-${String(args.customerId)}-${Date.now()}`
-    })
-  ),
+    });
+  },
   get_sales_timeseries: async (ctx, args) => ctx.client.get(
     "/api/v1/analytics/orders-timeseries",
     {
@@ -2665,6 +2673,16 @@ var ORDER_DISPLAY_STATUSES = new Set(
 );
 var DISPLAY_STATUS = oneOf(ORDER_DISPLAY_STATUSES);
 var RANGE = { from: S, to: S, timezone: S, groupBy: S };
+var LINE_RECURRING = {
+  plan: S,
+  interval: S,
+  intervalUnit: S,
+  intervalCount: S,
+  totalPayments: S,
+  trialDays: S,
+  // A custom installment schedule: amounts and gaps are numbers and unit tokens, no free text.
+  schedule: [{ amount: S, intervalUnit: S, intervalCount: S }]
+};
 var LINE_ITEM = {
   id: S,
   type: S,
@@ -2674,7 +2692,9 @@ var LINE_ITEM = {
   discountAmount: S,
   taxAmount: S,
   total: S,
-  recurring: S
+  // amount = renewal price on a trial line (whose unitPrice is 0); count = the old display mirror.
+  recurring: { ...LINE_RECURRING, amount: S, count: S, scheduleUnitTotal: S },
+  subscriptionId: S
 };
 var ORDER = {
   id: S,
@@ -2698,6 +2718,7 @@ var ORDER = {
   customerId: S,
   customer: CUSTOMER_REF,
   subscriptionId: S,
+  subscriptionIds: [S],
   shippingAddress: ADDRESS,
   billingAddress: ADDRESS,
   fulfillmentSummary: { itemsFulfilled: S, itemsRemaining: S, itemsTotal: S },
@@ -2779,6 +2800,18 @@ var SUBSCRIPTION = {
   pendingQuantity: S,
   pendingIntervalUnit: S,
   pendingIntervalCount: S,
+  scheduleTotal: S,
+  nextPaymentAmount: S,
+  paymentSchedule: [{
+    index: S,
+    amount: S,
+    discount: S,
+    net: S,
+    intervalUnit: S,
+    intervalCount: S,
+    status: S,
+    dueAt: S
+  }],
   createdAt: S
 };
 var QUOTE_SUMMARY = {
@@ -2820,7 +2853,8 @@ var QUOTE = {
       taxAmount: S,
       total: S,
       optional: S,
-      optionalSelected: S
+      optionalSelected: S,
+      recurring: LINE_RECURRING
     }]
   }],
   // Who commented and when, never what they wrote.
@@ -2986,7 +3020,24 @@ var OAUTH_PROJECTIONS = {
         trialDays: S,
         currency: S,
         firstChargeAmountMinor: S
-      }
+      },
+      hasSubscriptions: S,
+      // One entry per subscription line. No `name`: it is the line's name.
+      subscriptions: [{
+        lineItemId: S,
+        amount: S,
+        quantity: S,
+        interval: S,
+        intervalUnit: S,
+        intervalCount: S,
+        totalPayments: S,
+        trialDays: S,
+        trialEndsAt: S,
+        planChargedToday: S,
+        taxApplies: S,
+        scheduleGapUnits: [S],
+        schedule: [{ net: S, dueAt: S }]
+      }]
     },
     cart: section({
       id: S,
@@ -3127,7 +3178,7 @@ var OAUTH_PROJECTIONS = {
 };
 
 // src/server.ts
-var VERSION = true ? "0.2.2" : "0.0.0-dev";
+var VERSION = true ? "0.4.0" : "0.0.0-dev";
 function registerableActions(policy) {
   const isProduction = policy.identity.environment.providerEnvironment === "production";
   return actionsForChannel("mcp").filter((action) => {