@withpica/mcp-server 2.33.0 → 2.39.0

package/dist/tools/subscription.js

@@ -0,0 +1,440 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/* eslint-disable @typescript-eslint/no-explicit-any -- ToolExecutor signature uses Record<string, any> */
+/**
+ * Subscription Tools — ADR-210 Phase 2.
+ *
+ * Two MCP tools that surface the explicit billing read + action layer
+ * complementing the ambient `_meta.session_state.billing_slice` shipped
+ * in Phase 1:
+ *
+ *   - pica_subscription_status (read; readOnlyHint=true)
+ *       Wraps `GET /api/admin/subscription`, flattens the response into
+ *       the 9-field shape ADR-210 § Phase 2 specifies, and composes a
+ *       templated `summary` line the agent uses verbatim.
+ *
+ *   - pica_subscription_manage (action; readOnlyHint=false)
+ *       Single-verb dispatcher over the existing
+ *       `POST /api/admin/subscription` (subscribe / upgrade) and
+ *       `POST /api/admin/subscription/portal` (manage / cancel) routes.
+ *       Returns a `resource_link` content block (universal MCP floor)
+ *       and uses `elicitation/create url` only when the client
+ *       advertises `capabilities.elicitation.url` per ADR-200 Phase 1
+ *       (capability-gated; `feedback_mcp_sdk_capability_gates_elicitation.md`).
+ *
+ * No new Stripe SDK calls — both routes are reused as-is.
+ */
+import { randomUUID } from "node:crypto";
+import { clientSupportsUrlElicitation } from "@withpica/mcp-utils";
+// ADR-205 D7: enterprise is sales-led, not bookable through Checkout.
+// Mirror the route-layer allowlist here for a better tool-side error
+// message before the request leaves the agent.
+const VALID_PAID_TIERS = [
+    "solo",
+    "indie",
+    "pro",
+    "established",
+];
+const VALID_ACTIONS = [
+    "subscribe",
+    "upgrade",
+    "manage",
+    "cancel",
+];
+/**
+ * Compose the flat 9-field response from the existing GET admin route's
+ * shape. Mirrors `getOrgBillingSlice`'s "no meaningful cap" rule for
+ * `capacity_pct` (0 whenever current_tier is null OR enterprise) and
+ * carries through `overflow.recommendedTier` (already
+ * `inferTierFromCount`-derived) per Stage 1 Q2.
+ *
+ * Exported for unit tests.
+ */
+export function flattenStatus(status) {
+    const trialEndsAt = status.trialEndsAt;
+    const trialDaysRemaining = status.billingState === "trial" && trialEndsAt
+        ? Math.max(0, Math.ceil((new Date(trialEndsAt).getTime() - Date.now()) / 86_400_000))
+        : null;
+    const capacityUsed = status.overflow?.currentCount ?? 0;
+    const capacityLimit = status.overflow?.capacity ?? null;
+    const recommendedTier = status.overflow?.recommendedTier ?? null;
+    // Same rule `getOrgBillingSlice` uses — `capacity_pct` is 0 whenever
+    // there's no meaningful cap to compare against (trial / enterprise /
+    // no overflow row). Avoids fabricating a meaningful percentage from
+    // the trial-time inferred recommended tier.
+    const hasMeaningfulCap = status.tier !== null &&
+        status.tier !== "enterprise" &&
+        capacityLimit !== null &&
+        capacityLimit > 0;
+    const capacityPct = hasMeaningfulCap
+        ? Math.round((capacityUsed / capacityLimit) * 100)
+        : 0;
+    return {
+        billing_state: status.billingState,
+        trial_days_remaining: trialDaysRemaining,
+        trial_ends_at: trialEndsAt,
+        current_tier: status.tier,
+        capacity_used: capacityUsed,
+        capacity_limit: capacityLimit,
+        capacity_pct: capacityPct,
+        recommended_tier: recommendedTier,
+        summary: composeSummary({
+            billing_state: status.billingState,
+            trial_days_remaining: trialDaysRemaining,
+            current_tier: status.tier,
+            capacity_used: capacityUsed,
+            capacity_limit: capacityLimit,
+            recommended_tier: recommendedTier,
+        }),
+    };
+}
+/**
+ * Server-side template per Stage 1 Q1 option A. Predictable wording,
+ * less variance across connectors. Phase 2.5 may add agent
+ * paraphrasing if telemetry shows demand.
+ *
+ * Exported for unit tests.
+ */
+export function composeSummary(fields) {
+    const { billing_state, trial_days_remaining, current_tier, capacity_used, capacity_limit, recommended_tier, } = fields;
+    const slotsClause = `${capacity_used} active work${capacity_used === 1 ? "" : "s"}`;
+    if (billing_state === "trial") {
+        let daysClause;
+        if (trial_days_remaining === null) {
+            daysClause = "your trial";
+        }
+        else if (trial_days_remaining === 0) {
+            daysClause = "the final day of your trial";
+        }
+        else if (trial_days_remaining === 1) {
+            daysClause = "1 day left of your trial";
+        }
+        else {
+            daysClause = `a ${trial_days_remaining}-day window of your trial`;
+        }
+        const tierHint = recommended_tier
+            ? ` Today's catalogue fits the ${recommended_tier} tier.`
+            : "";
+        return `You're on ${daysClause}. ${slotsClause} so far.${tierHint}`;
+    }
+    if (billing_state === "hibernated") {
+        return `Your trial has ended and the catalogue is read-only. Subscribe to restore writes (${slotsClause} currently held).`;
+    }
+    // active
+    if (current_tier === "enterprise") {
+        return `On the enterprise plan (unbounded). ${slotsClause}.`;
+    }
+    const limitClause = capacity_limit === null
+        ? slotsClause
+        : `${capacity_used} of ${capacity_limit} slots used`;
+    const tierClause = current_tier
+        ? `Currently on ${current_tier}.`
+        : "Tier unclassified.";
+    return `${tierClause} ${limitClause}.`;
+}
+export class SubscriptionTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_subscription_status",
+                    description: "Read the org's current billing posture. Use when the user asks " +
+                        "'what's my plan?', 'how many days left on the trial?', 'any " +
+                        "room left in my tier?', or before nudging them to upgrade. " +
+                        "Returns billing_state (trial / active / hibernated), trial " +
+                        "days remaining, current tier, capacity (used / limit / %), " +
+                        "the smallest tier the catalogue fits today, and a one-line " +
+                        "summary the agent can use verbatim. ADR-210 Phase 2 — " +
+                        "complement to the ambient _meta.session_state.billing_slice; " +
+                        "use this tool when an explicit answer is needed.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                        additionalProperties: false,
+                    },
+                    annotations: {
+                        readOnlyHint: true,
+                        destructiveHint: false,
+                        idempotentHint: true,
+                        openWorldHint: false,
+                    },
+                },
+                executor: this.status.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_subscription_manage",
+                    description: "Mint a Stripe-hosted URL for a billing action. " +
+                        "action='subscribe' or 'upgrade' opens Stripe Checkout for the " +
+                        "given tier (one of solo / indie / pro / established — " +
+                        "enterprise is sales-led). action='manage' or 'cancel' opens " +
+                        "the Stripe Billing Portal where the customer can update " +
+                        "payment methods, change tier, or cancel. Returns the URL, " +
+                        "an ISO expires_at, and `surface` ('checkout' or 'portal'). " +
+                        "ADR-210 Phase 2 — wraps the existing /api/admin/subscription " +
+                        "POST + /portal routes; no new Stripe SDK calls. Subscribe / " +
+                        "upgrade without `tier` returns an error referencing " +
+                        "pica_subscription_status so the agent can read recommended_tier first.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            action: {
+                                type: "string",
+                                enum: [...VALID_ACTIONS],
+                                description: "subscribe / upgrade open Stripe Checkout (require tier); " +
+                                    "manage / cancel open Stripe Billing Portal (no tier).",
+                            },
+                            tier: {
+                                type: "string",
+                                enum: [...VALID_PAID_TIERS],
+                                description: "Required for subscribe / upgrade. Solo: 250 active works. " +
+                                    "Indie: 1,000. Pro: 4,000. Established: 15,000.",
+                            },
+                            currency: {
+                                type: "string",
+                                enum: ["gbp", "usd", "eur"],
+                                description: "Optional. Defaults to gbp. Honoured only on subscribe / upgrade.",
+                            },
+                        },
+                        required: ["action"],
+                        additionalProperties: false,
+                    },
+                    annotations: {
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                },
+                executor: this.manage.bind(this),
+            },
+        ];
+    }
+    async status(_args) {
+        const status = await this.pica.subscription.getStatus();
+        if (!status) {
+            // STRIPE_SECRET_KEY unset on this deployment — preview/dev path.
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Billing is not configured on this deployment. " +
+                            "Subscription status is unavailable.",
+                    },
+                ],
+                structuredContent: {
+                    kind: "pica.card.subscription_status",
+                    version: 1,
+                    data: { billing_unavailable: true },
+                },
+            };
+        }
+        const flat = flattenStatus(status);
+        return {
+            content: [{ type: "text", text: flat.summary }],
+            structuredContent: {
+                kind: "pica.card.subscription_status",
+                version: 1,
+                data: flat,
+            },
+        };
+    }
+    async manage(args, ctx) {
+        const action = args.action;
+        if (!action || !VALID_ACTIONS.includes(action)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: action must be one of ${VALID_ACTIONS.join(", ")}.`,
+                    },
+                ],
+                structuredContent: {
+                    kind: "pica.error.invalid_argument",
+                    version: 1,
+                    data: {
+                        argument: "action",
+                        valid: [...VALID_ACTIONS],
+                    },
+                },
+                isError: true,
+            };
+        }
+        const isCheckoutAction = action === "subscribe" || action === "upgrade";
+        if (isCheckoutAction) {
+            const tier = args.tier;
+            if (!tier) {
+                // Stage 1 Q3 / coordinator-pinned: return a recoverable error
+                // with `next_tool` so the agent can chain to status first
+                // rather than auto-pick a tier.
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `subscribe and upgrade require a tier. Call ` +
+                                `pica_subscription_status to see the recommended tier ` +
+                                `for this org's current capacity, then retry with that tier.`,
+                        },
+                    ],
+                    structuredContent: {
+                        kind: "pica.error.missing_argument",
+                        version: 1,
+                        data: {
+                            argument: "tier",
+                            next_tool: "pica_subscription_status",
+                        },
+                    },
+                    isError: true,
+                };
+            }
+            if (!VALID_PAID_TIERS.includes(tier)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: tier must be one of ${VALID_PAID_TIERS.join(", ")}. ` +
+                                `Enterprise is sales-led — contact PICA directly.`,
+                        },
+                    ],
+                    structuredContent: {
+                        kind: "pica.error.invalid_argument",
+                        version: 1,
+                        data: {
+                            argument: "tier",
+                            valid: [...VALID_PAID_TIERS],
+                        },
+                    },
+                    isError: true,
+                };
+            }
+            try {
+                const result = await this.pica.subscription.mintCheckout({
+                    tier,
+                    currency: typeof args.currency === "string" ? args.currency : "gbp",
+                });
+                return this.buildLinkResult({
+                    url: result.checkoutUrl,
+                    expiresAt: result.expiresAt,
+                    surface: "checkout",
+                    name: `Subscribe to PICA (${tier})`,
+                    description: `Open Stripe Checkout to subscribe to the ${tier} tier.`,
+                    ctx,
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : "checkout mint failed";
+                return {
+                    content: [
+                        { type: "text", text: `Could not mint checkout: ${message}` },
+                    ],
+                    structuredContent: {
+                        kind: "pica.error.checkout_mint_failed",
+                        version: 1,
+                        data: { error: message },
+                    },
+                    isError: true,
+                };
+            }
+        }
+        // manage / cancel → portal
+        try {
+            const result = await this.pica.subscription.mintPortal();
+            return this.buildLinkResult({
+                url: result.portalUrl,
+                expiresAt: result.expiresAt,
+                surface: "portal",
+                name: action === "cancel"
+                    ? "Cancel subscription"
+                    : "Manage subscription",
+                description: action === "cancel"
+                    ? "Open the Stripe Billing Portal to cancel your subscription."
+                    : "Open the Stripe Billing Portal to update payment, change tier, or cancel.",
+                ctx,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "portal mint failed";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Could not open billing portal: ${message}`,
+                    },
+                ],
+                structuredContent: {
+                    kind: "pica.error.portal_mint_failed",
+                    version: 1,
+                    data: {
+                        error: message,
+                        // The route returns "No Stripe customer found — subscribe first"
+                        // when the org has no stripeCustomerId; surface a recovery hint
+                        // so the agent can chain.
+                        next_tool: message.toLowerCase().includes("subscribe first") ||
+                            message.toLowerCase().includes("no stripe customer")
+                            ? "pica_subscription_manage"
+                            : undefined,
+                    },
+                },
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Universal-floor return per ADR-200 Phase 1: every successful manage
+     * response carries a `resource_link` so any compliant MCP client can
+     * render or open the URL. Clients that advertise
+     * `capabilities.elicitation.url` additionally receive a server-issued
+     * elicitation/create request — the gate is mandatory because
+     * `elicitInput` with `mode: "url"` throws synchronously against
+     * non-supporters (`feedback_mcp_sdk_capability_gates_elicitation.md`).
+     */
+    async buildLinkResult(opts) {
+        const { url, expiresAt, surface, name, description, ctx } = opts;
+        const summary = surface === "checkout"
+            ? `${name} ready. Open ${url} to complete checkout. Link expires ${expiresAt}.`
+            : `${name} ready. Open ${url} to manage your subscription. Link expires ${expiresAt}.`;
+        const content = [
+            { type: "text", text: summary },
+            {
+                type: "resource_link",
+                uri: url,
+                name,
+                description,
+                mimeType: "text/html",
+            },
+        ];
+        // Capability-gated elicitation/create url — silently degrade on
+        // decline / cancel / timeout; the resource_link in the response
+        // remains usable.
+        if (clientSupportsUrlElicitation(ctx?.server)) {
+            try {
+                await ctx.server.elicitInput({
+                    mode: "url",
+                    url,
+                    elicitationId: `pica-subscription-${surface}-${randomUUID()}`,
+                    message: description,
+                }, { timeout: 60_000 });
+            }
+            catch {
+                // User declined / cancelled / elicitation timed out. Not an error
+                // — the resource_link below is the universal-floor fallback.
+            }
+        }
+        return {
+            content,
+            structuredContent: {
+                kind: "pica.card.subscription_link",
+                version: 1,
+                data: {
+                    url,
+                    expires_at: expiresAt,
+                    surface,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/tools/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/tools/subscription.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@withpica/mcp-server",
   "mcpName": "io.github.withpica/pica",
-  "version": "2.33.0",
+  "version": "2.39.0",
   "description": "MCP Server for PICA Platform - enables AI assistants to interact with PICA",
   "type": "module",
   "main": "dist/index.js",
@@ -31,8 +31,8 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@withpica/mcp-sdk": "^1.0.0",
-    "@withpica/mcp-utils": "^1.10.0",
+    "@withpica/mcp-sdk": "^1.17.0",
+    "@withpica/mcp-utils": "^1.12.0",
     "mppx": "^0.5.0"
   },
   "devDependencies": {

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/withpica/pica",
     "source": "github"
   },
-  "version": "2.33.0",
+  "version": "2.39.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@withpica/mcp-server",
-      "version": "2.33.0",
+      "version": "2.39.0",
       "transport": {
         "type": "stdio"
       }

package/dist/__mocks__/mppx-mcp-sdk-server.d.ts

@@ -1,6 +0,0 @@
-export declare const Transport: {
-  mcpSdk: () => {
-    name: string;
-  };
-};
-//# sourceMappingURL=mppx-mcp-sdk-server.d.ts.map

package/dist/__mocks__/mppx-mcp-sdk-server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mppx-mcp-sdk-server.d.ts","sourceRoot":"","sources":["../../src/__mocks__/mppx-mcp-sdk-server.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS;;;;CAErB,CAAC"}

package/dist/__mocks__/mppx-mcp-sdk-server.js

@@ -1,6 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-// Mock for mppx/mcp-sdk/server — used in test environment where mppx is not installed
-export const Transport = {
-    mcpSdk: () => ({ name: "mcp-sdk" }),
-};
-//# sourceMappingURL=mppx-mcp-sdk-server.js.map

package/dist/__mocks__/mppx-mcp-sdk-server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mppx-mcp-sdk-server.js","sourceRoot":"","sources":["../../src/__mocks__/mppx-mcp-sdk-server.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,sFAAsF;AAEtF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;CACpC,CAAC"}

package/dist/__mocks__/mppx-server.d.ts

@@ -1,12 +0,0 @@
-export declare const Mppx: {
-  create: () => {
-    charge: () => Promise<{
-      success: boolean;
-    }>;
-  };
-};
-export declare const stripe: {
-  charge: () => Promise<{}>;
-};
-export declare const Transport: {};
-//# sourceMappingURL=mppx-server.d.ts.map

package/dist/__mocks__/mppx-server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mppx-server.d.ts","sourceRoot":"","sources":["../../src/__mocks__/mppx-server.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,IAAI;;;;;;CAIhB,CAAC;AAEF,eAAO,MAAM,MAAM;;CAElB,CAAC;AAEF,eAAO,MAAM,SAAS,IAAK,CAAC"}

package/dist/__mocks__/mppx-server.js

@@ -1,12 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-// Mock for mppx/server — used in test environment where mppx is not installed
-export const Mppx = {
-    create: () => ({
-        charge: async () => ({ success: true }),
-    }),
-};
-export const stripe = {
-    charge: async () => ({}),
-};
-export const Transport = {};
-//# sourceMappingURL=mppx-server.js.map

package/dist/__mocks__/mppx-server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mppx-server.js","sourceRoot":"","sources":["../../src/__mocks__/mppx-server.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACb,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KACxC,CAAC;CACH,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC"}