@absolutejs/mcp 0.15.1 → 0.17.0

package/dist/browser/billing.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commerce.js

@@ -145,6 +145,227 @@ var createPurchaseStatusTool = (options) => ({
     };
   }
 });
+// node_modules/@absolutejs/billing/dist/reports.js
+var DAY_MS = 86400000;
+var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var record2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var only = (input, keys) => {
+  if (!record2(input) || Object.keys(input).some((key) => !keys.includes(key)))
+    throw new Error("Invalid report input");
+  return input;
+};
+var integer = (value) => {
+  if (!Number.isSafeInteger(value) || value < 0)
+    throw new Error("Invalid report amount");
+  return value;
+};
+var iso = (value) => {
+  if (!Number.isFinite(Date.parse(value)) || new Date(value).toISOString() !== value)
+    throw new Error("Invalid report timestamp");
+  return value;
+};
+var day = (value) => {
+  if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(value) || new Date(value + "T00:00:00.000Z").toISOString().slice(0, 10) !== value)
+    throw new Error("Expected a UTC calendar date");
+  return value;
+};
+var parseUsageRange = (input, now = new Date) => {
+  const args = only(input, ["from", "to"]);
+  const tomorrow = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()) + DAY_MS);
+  const to = day(args.to ?? tomorrow.toISOString().slice(0, 10));
+  const from = day(args.from ?? new Date(Date.parse(to) - 30 * DAY_MS).toISOString().slice(0, 10));
+  const duration = Date.parse(to) - Date.parse(from);
+  if (duration <= 0 || duration > 90 * DAY_MS || Date.parse(to) > tomorrow.getTime())
+    throw new Error("Choose a range of 1\u201390 UTC days, ending no later than tomorrow");
+  return { from, to };
+};
+var parseReceiptPage = (input) => {
+  const args = only(input, ["limit", "cursor"]);
+  const limit = args.limit ?? 20;
+  if (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1 || limit > 50)
+    throw new Error("Receipt limit must be 1\u201350");
+  if (args.cursor === undefined || args.cursor === null)
+    return { limit, cursor: null };
+  if (typeof args.cursor !== "string" || args.cursor.length > 256 || !/^[A-Za-z0-9_-]+$/.test(args.cursor))
+    throw new Error("Invalid receipt cursor");
+  const decoded = JSON.parse(Buffer.from(args.cursor, "base64url").toString("utf8"));
+  if (!record2(decoded) || typeof decoded.at !== "string" || typeof decoded.id !== "string" || !UUID.test(decoded.id))
+    throw new Error("Invalid receipt cursor");
+  return { limit, cursor: { at: iso(decoded.at), id: decoded.id } };
+};
+var projectBillingStatus = (value) => ({
+  portalAccess: value.portalAccess === true,
+  subscription: value.subscription ? {
+    status: String(value.subscription.status).slice(0, 64),
+    renewsAt: value.subscription.renewsAt === null ? null : iso(value.subscription.renewsAt),
+    cancelAtPeriodEnd: value.subscription.cancelAtPeriodEnd === true
+  } : null,
+  credits: {
+    remaining: integer(value.credits.remaining),
+    reserved: integer(value.credits.reserved),
+    purchased: integer(value.credits.purchased),
+    promotional: integer(value.credits.promotional),
+    debt: integer(value.credits.debt)
+  },
+  automaticRefill: false
+});
+var projectReceiptPage = (value, limit) => {
+  if (value.receipts.length > limit)
+    throw new Error("Receipt page exceeds its limit");
+  if (value.nextCursor !== null)
+    parseReceiptPage({ cursor: value.nextCursor });
+  return {
+    receipts: value.receipts.map((row) => {
+      if (!UUID.test(row.id) || !/^[A-Z]{3}$/.test(row.currency) || !["credit_purchase", "initial", "plan_change", "renewal"].includes(row.source) || !["paid", "partially_refunded", "refunded"].includes(row.status) || row.refundedAmountCents > row.amountCents)
+        throw new Error("Invalid receipt");
+      return {
+        id: row.id,
+        issuedAt: iso(row.issuedAt),
+        currency: row.currency,
+        amountCents: integer(row.amountCents),
+        refundedAmountCents: integer(row.refundedAmountCents),
+        source: row.source,
+        status: row.status
+      };
+    }),
+    nextCursor: value.nextCursor
+  };
+};
+var projectUsageReport = (value, range) => {
+  if (value.from !== range.from || value.to !== range.to || value.byDay.length > 90 || value.byFeature.length > 21)
+    throw new Error("Invalid usage report bounds");
+  const byDay = value.byDay.map((row) => ({
+    day: day(row.day),
+    credits: integer(row.credits),
+    events: integer(row.events)
+  }));
+  const byFeature = value.byFeature.map((row) => ({
+    feature: row.feature.slice(0, 128),
+    credits: integer(row.credits),
+    events: integer(row.events)
+  }));
+  const credits = integer(value.creditsConsumed), events = integer(value.events);
+  for (const rows of [byDay, byFeature])
+    if (rows.reduce((sum, row) => sum + row.credits, 0) !== credits || rows.reduce((sum, row) => sum + row.events, 0) !== events)
+      throw new Error("Usage breakdown does not reconcile");
+  if (new Set(byDay.map((row) => row.day)).size !== byDay.length || byDay.some((row) => row.day < range.from || row.day >= range.to))
+    throw new Error("Invalid usage days");
+  return {
+    from: range.from,
+    to: range.to,
+    creditsConsumed: credits,
+    events,
+    byDay,
+    byFeature
+  };
+};
+
+// src/billingTools.ts
+var result = (text, data) => ({
+  content: [{ type: "text", text }],
+  structuredContent: { ...data }
+});
+var empty = (input) => {
+  if (!input || typeof input !== "object" || Array.isArray(input) || Object.keys(input).length)
+    throw new Error("This tool takes no arguments");
+};
+var createBillingReportTools = (readers) => ({
+  get_billing_status: {
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    },
+    commerce: {
+      action: "entitlement_status",
+      categories: ["usage_credits", "subscription"]
+    },
+    description: "Read subscription and service-credit status for this account, including reserved credits and debt. Does not charge, renew or cancel anything. Available at zero balance.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      empty(input);
+      const status = projectBillingStatus(await readers.status());
+      return result(`${status.credits.remaining} service credits available, ${status.credits.reserved} reserved. Portal access: ${status.portalAccess ? "enabled" : "not enabled"}. Automatic refill is off.`, status);
+    }
+  },
+  list_receipts: {
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    },
+    commerce: {
+      action: "entitlement_status",
+      categories: ["usage_credits", "subscription"]
+    },
+    description: "List this account's payment receipts, newest first, with original amounts and refunds recorded to date. Amounts are currency minor units, not consumed credits. Follow nextCursor for more. No payment credentials or provider references are exposed.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "integer", minimum: 1, maximum: 50, default: 20 },
+        cursor: { type: ["string", "null"], maxLength: 256 }
+      },
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      const request = parseReceiptPage(input);
+      const page = projectReceiptPage(await readers.receipts(request), request.limit);
+      return result(`${page.receipts.length} receipts.${page.nextCursor ? " More receipts are available using nextCursor." : ""}`, page);
+    }
+  },
+  get_usage_report: {
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    },
+    commerce: { action: "entitlement_status", categories: ["usage_credits"] },
+    description: "Read recorded service-credit consumption by UTC day and feature. from is inclusive and to is exclusive; at most 90 days, default last 30 days including today. Credits consumed are not dollars paid or the assistant's own tokens. Does not estimate ROI or expose internal provider costs.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        from: { type: "string", format: "date" },
+        to: { type: "string", format: "date" }
+      },
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      const range = parseUsageRange(input, readers.now?.());
+      const usage = projectUsageReport(await readers.usage(range), range);
+      return result(`${usage.creditsConsumed} service credits across ${usage.events} recorded events, ${range.from} inclusive to ${range.to} exclusive (UTC).`, usage);
+    }
+  }
+});
+var createBillingManagementTool = (destination) => {
+  const url = new URL(destination);
+  if (url.protocol !== "https:" || url.username || url.password || url.search || url.hash)
+    throw new Error("Billing management requires a fixed HTTPS page URL");
+  return {
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    },
+    commerce: {
+      action: "external_checkout",
+      categories: ["usage_credits", "subscription"]
+    },
+    description: "Open the service's authenticated billing page to buy credits, review receipts, or manage an existing subscription. Uses a matching browser login; may require sign-in. This link does not grant a login session or authorize any payment.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      empty(input);
+      return result(`Manage billing on ${url.hostname}: ${url.href}. Sign in if needed; changes require your confirmation.`, { url: url.href, requiresBrowserAuthentication: true });
+    }
+  };
+};
 
 // src/commerce.ts
 var COMMERCE_POLICY_VERSION = "2026-09-10.1";
@@ -254,6 +475,8 @@ var evaluateCommerce = (req, context, now = new Date) => {
 export {
   COMMERCE_POLICY_SOURCES,
   COMMERCE_POLICY_VERSION,
+  createBillingManagementTool,
+  createBillingReportTools,
   createCheckoutHandoffTool,
   createCreditBalanceTool,
   createPurchaseStatusTool,