@usethrottle/mcp 0.2.1 → 0.3.0

package/dist/lib.js

@@ -1471,14 +1471,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",
@@ -1585,12 +1593,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"],
@@ -1696,6 +1704,7 @@ var ThrottleError = class extends Error {
   statusCode;
   details;
   body;
+  requestId;
   constructor(args) {
     super(args.message);
     this.name = "ThrottleError";
@@ -1703,14 +1712,17 @@ var ThrottleError = class extends Error {
     this.statusCode = args.statusCode;
     this.details = args.details;
     this.body = args.body;
+    const fromBody = args.body?.meta?.requestId;
+    const fromHeader = typeof args.responseHeaders?.get === "function" ? args.responseHeaders.get("x-request-id") : args.responseHeaders?.["x-request-id"];
+    this.requestId = args.requestId ?? (typeof fromBody === "string" ? fromBody : void 0) ?? (typeof fromHeader === "string" ? fromHeader : void 0);
     Object.setPrototypeOf(this, new.target.prototype);
   }
 };
 
 // src/client.ts
 var ThrottleApiError = class extends ThrottleError {
-  constructor(code, message, statusCode, details) {
-    super({ code, message, statusCode, details });
+  constructor(code, message, statusCode, details, responseHeaders) {
+    super({ code, message, statusCode, details, responseHeaders });
     this.name = "ThrottleApiError";
   }
 };
@@ -1776,7 +1788,8 @@ var ThrottleClient = class {
         err?.code ?? `http_${res.status}`,
         err?.message ?? `Request failed (${res.status}): ${text.slice(0, 200)}`,
         res.status,
-        err?.details
+        err?.details,
+        res.headers
       );
     }
     return parsed;
@@ -2381,14 +2394,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,
@@ -2397,8 +2410,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",
     {
@@ -2655,6 +2668,14 @@ 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
+};
 var LINE_ITEM = {
   id: S,
   type: S,
@@ -2664,7 +2685,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 },
+  subscriptionId: S
 };
 var ORDER = {
   id: S,
@@ -2688,6 +2711,7 @@ var ORDER = {
   customerId: S,
   customer: CUSTOMER_REF,
   subscriptionId: S,
+  subscriptionIds: [S],
   shippingAddress: ADDRESS,
   billingAddress: ADDRESS,
   fulfillmentSummary: { itemsFulfilled: S, itemsRemaining: S, itemsTotal: S },
@@ -2810,7 +2834,8 @@ var QUOTE = {
       taxAmount: S,
       total: S,
       optional: S,
-      optionalSelected: S
+      optionalSelected: S,
+      recurring: LINE_RECURRING
     }]
   }],
   // Who commented and when, never what they wrote.
@@ -2976,7 +3001,22 @@ 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
+      }]
     },
     cart: section({
       id: S,
@@ -3117,7 +3157,7 @@ var OAUTH_PROJECTIONS = {
 };
 
 // src/server.ts
-var VERSION = true ? "0.2.1" : "0.0.0-dev";
+var VERSION = true ? "0.3.0" : "0.0.0-dev";
 function registerableActions(policy) {
   const isProduction = policy.identity.environment.providerEnvironment === "production";
   return actionsForChannel("mcp").filter((action) => {