@sakupa/mcp 0.7.26 → 0.7.28

package/dist/bin.js

@@ -129,7 +129,7 @@ var FORBIDDEN_PATH_SEGMENTS = [
 var ALLOWED_HIDDEN_PATHS = [".well-known/"];
 
 // ../core/dist/domain/version.js
-var SAKUPA_MCP_VERSION = "0.7.26";
+var SAKUPA_MCP_VERSION = "0.7.28";
 
 // ../core/dist/domain/errors.js
 var HTTP_STATUS = {
@@ -2631,7 +2631,7 @@ NO content was uploaded or changed by this call \u2014 to publish new or edited
   server.registerTool(
     "status",
     {
-      description: "Show the current status of this project's Sakupa site: URL, mode (free/paid), expiry, subscription state, custom domains, size, last deployment and warnings.",
+      description: "Show the current status of this project's Sakupa site: URL, mode (free/paid), expiry, custom domains, size, last deployment and warnings. For a paid site this tool also automatically returns the complete authoritative billing snapshot; users never need to know or name a separate billing tool to get accurate subscription information.",
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
       inputSchema: { projectDir: projectDirInput }
@@ -2642,12 +2642,18 @@ NO content was uploaded or changed by this call \u2014 to publish new or edited
         const site = requireSiteFile(ctx);
         const res = await ctx.client.getSiteStatus(site.siteId, site.credential);
         noteSiteMode(res.siteId, res.mode);
+        const billing = res.mode === "paid" ? await ctx.client.getBillingStatus(site.siteId, site.credential) : void 0;
         const binding = res.pendingDomainBinding ? await describePendingBinding(ctx.client, site.credential, res.pendingDomainBinding) : void 0;
-        return textJson("status_returned", `Site status:${binding?.note ?? ""}`, {
-          ...res,
-          projectDir: ctx.projectDir,
-          ...binding?.checklist ? { dnsChecklist: binding.checklist } : {}
-        });
+        return textJson(
+          "status_returned",
+          billing ? `Site status with AUTHORITATIVE BILLING SNAPSHOT. When answering any subscription question, use the nested billing object and report the current plan, scheduled renewal or cancellation, effective time, current entitlement, billing period, usage state and one-time carry when present:${binding?.note ?? ""}` : `Site status:${binding?.note ?? ""}`,
+          {
+            ...res,
+            projectDir: ctx.projectDir,
+            ...billing ? { billing } : {},
+            ...binding?.checklist ? { dnsChecklist: binding.checklist } : {}
+          }
+        );
       } catch (e) {
         return toolError(e);
       }
@@ -2819,7 +2825,7 @@ When the user says the TXT is set, run bind "status". It verifies ownership and
   server.registerTool(
     "billing",
     {
-      description: "Show this site's hosting subscription: current plan, next renewal plan, payment state, current paid entitlement, reconciled usage, estimated usage tier, bound custom domains and risks. Owner-only (uses the credential in .sakupa/site.json).",
+      description: "Return the sole authoritative source for this site's hosting subscription: current plan, next renewal plan or cancellation, effective time, payment state, current paid entitlement, reconciled usage, estimated usage tier, bound custom domains and risks. Owner-only (uses the credential in .sakupa/site.json).",
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
       inputSchema: { projectDir: projectDirInput }
@@ -2831,15 +2837,20 @@ When the user says the TXT is set, run bind "status". It verifies ownership and
         const res = await ctx.client.getBillingStatus(site.siteId, site.credential);
         noteSiteMode(res.siteId, res.mode);
         const lines = [
-          `Billing status for site ${res.siteId} (mode: ${res.mode})`,
+          `AUTHORITATIVE BILLING SNAPSHOT for site ${res.siteId} (mode: ${res.mode})`,
           res.permanentUrl ? `Permanent URL: ${res.permanentUrl}` : void 0,
           res.plan ? `Current plan: ${res.plan} (JPY ${res.monthlyPriceJpy ?? tierPriceJpy(res.plan)}/month)` : "Current plan: (no subscription yet)",
           res.subscriptionStatus ? `Subscription payment state: ${res.subscriptionStatus}` : void 0,
-          res.cancelAtPeriodEnd ? "Renewal: CANCELED \u2014 the site reverts to free at the end of the already-paid month" : res.renewalPlan ? `Next renewal plan: ${res.renewalPlan} (JPY ${res.renewalMonthlyPriceJpy ?? tierPriceJpy(res.renewalPlan)}/month)` + (res.renewalEffectiveAt ? `, effective ${res.renewalEffectiveAt}` : " (unchanged)") : void 0,
+          res.cancelAtPeriodEnd === true ? "Renewal: CANCELED \u2014 the site reverts to free at the end of the already-paid month" : res.renewalPlan ? `Next renewal plan: ${res.renewalPlan} (JPY ${res.renewalMonthlyPriceJpy ?? tierPriceJpy(res.renewalPlan)}/month)` + (res.renewalEffectiveAt ? `, effective ${res.renewalEffectiveAt}` : " (unchanged)") : res.cancelAtPeriodEnd === false ? "Renewal cancellation: no" : void 0,
           res.periodEntitlementPlan ? `Current paid entitlement: ${res.periodEntitlementPlan}` : void 0,
           res.currentPeriodStart ? `Current paid period: ${res.currentPeriodStart} -> ${res.currentPeriodEnd ?? "?"}` : void 0,
+          `Usage state: ${res.usageState}`,
+          res.currentPeriodUsage ? `Current usage: storage ${res.currentPeriodUsage.storageBytes} bytes; transfer ${res.currentPeriodUsage.transferBytes} bytes; requests ${res.currentPeriodUsage.requests}` : void 0,
+          res.currentPeriodCountedTransferBytes !== void 0 ? `Transfer counted against current plan: ${res.currentPeriodCountedTransferBytes} bytes` : void 0,
+          res.currentPlanLimits ? `Current plan limits: storage ${res.currentPlanLimits.storageBytes} bytes; transfer ${res.currentPlanLimits.transferBytes} bytes; requests ${res.currentPlanLimits.requests}` : void 0,
           res.estimatedUsageTier ? `Estimated usage tier: ${res.estimatedUsageTier}` : void 0,
           res.lastReconciledAt ? `Last usage reconciliation: ${res.lastReconciledAt}` : void 0,
+          res.usageLagSeconds !== void 0 ? `Usage lag: ${res.usageLagSeconds} seconds` : void 0,
           res.oneTimeTransferCarry ? `One-time transfer carry: ${res.oneTimeTransferCarry.remainingBytes} bytes remaining (granted ${res.oneTimeTransferCarry.grantedBytes}, expires ${res.oneTimeTransferCarry.expiresAt})` : void 0,
           res.boundHostnames.length > 0 ? `Bound custom domains: ${res.boundHostnames.join(", ")}` : void 0,
           res.risks.pastDue ? "ATTENTION: renewal payment failing \u2014 update the payment method (portal). Serving continues while Stripe retries; if Stripe gives up, the site reverts to free." : void 0
@@ -3322,7 +3333,6 @@ Summary: ${res.sanitizedSummary}`,
 
 // src/tools/billing.ts
 import { z as z4 } from "zod";
-var plan = z4.enum(["water", "personal", "share", "business"]);
 function registerBillingTools(server, baseCtx) {
   server.registerTool(
     "plans",
@@ -3350,12 +3360,11 @@ function registerBillingTools(server, baseCtx) {
     }
   );
   server.registerTool(
-    "upgrade",
+    "change",
     {
-      description: "Create a Stripe-hosted confirmation link for a manually selected subscription plan. Creating the link does not change billing; only the user can confirm on Stripe.",
+      description: "Create one Stripe-hosted subscription-management link. The user chooses the plan or period-end cancellation on Stripe; Sakupa never infers intent from the conversation. Creating the link does not change billing.",
       inputSchema: {
         projectDir: projectDirInput,
-        targetPlan: plan,
         operationId: z4.string().min(1)
       },
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
@@ -3367,21 +3376,20 @@ function registerBillingTools(server, baseCtx) {
         const site = requireSiteFile(ctx);
         const result = await ctx.client.changeSubscriptionPlan(site.credential, {
           siteId: site.siteId,
-          targetPlan: args.targetPlan,
           operationId: args.operationId
         });
         return structuredToolResult({
           schemaVersion: 1,
           outcome: "waiting_user",
-          resultCode: "stripe_plan_change_confirmation_required",
+          resultCode: "stripe_subscription_management_required",
           operationId: args.operationId,
-          summary: `Stripe confirmation link created for ${result.currentPlan} -> ${result.targetPlan}; the subscription has NOT changed yet. ` + (result.direction === "upgrade" ? "Confirming starts a new paid month immediately at the full target price; Sakupa applies the plan only after invoice payment and carries unused transfer once." : result.direction === "downgrade" ? "The downgrade is scheduled for the end of the already-paid period." : "Confirming cancels the scheduled plan change and keeps the current plan without a new charge."),
+          summary: "Stripe subscription-management link created; the subscription has NOT changed yet. Stripe is the authoritative place to choose Water, Personal, Share, Business, or period-end cancellation. Query billing after the user finishes.",
           data: { result },
           userAction: {
             type: "open_url",
             provider: "stripe",
             url: result.portalUrl,
-            expectedOutcome: "After the user confirms on the Stripe-hosted page, the webhook updates the Sakupa subscription state"
+            expectedOutcome: "After the user finishes on Stripe, webhooks update Sakupa and billing reports the authoritative result"
           },
           nextActions: [{ tool: "billing", allowed: true }]
         });
@@ -3611,7 +3619,7 @@ Workflow:
 4. Optionally bind a custom domain to the subscribed site (bind): an included extra
    serving surface alongside the permanent URL. Ownership is proven only by DNS control; the
    first verified request wins; unverified requests expire after 72 hours. billing,
-   upgrade, portal and recover manage the paid
+   change, portal and recover manage the paid
    lifecycle; delete tears the whole site down after explicit confirmation. Binding a
    NEW domain while one is live is a zero-downtime SWITCH: the old domain keeps serving
    until the new domain's www is confirmed live, then it is replaced automatically.

package/dist/index.js

@@ -124,7 +124,7 @@ var FORBIDDEN_PATH_SEGMENTS = [
 var ALLOWED_HIDDEN_PATHS = [".well-known/"];
 
 // ../core/dist/domain/version.js
-var SAKUPA_MCP_VERSION = "0.7.26";
+var SAKUPA_MCP_VERSION = "0.7.28";
 
 // ../core/dist/domain/errors.js
 var HTTP_STATUS = {
@@ -2720,7 +2720,7 @@ NO content was uploaded or changed by this call \u2014 to publish new or edited
   server.registerTool(
     "status",
     {
-      description: "Show the current status of this project's Sakupa site: URL, mode (free/paid), expiry, subscription state, custom domains, size, last deployment and warnings.",
+      description: "Show the current status of this project's Sakupa site: URL, mode (free/paid), expiry, custom domains, size, last deployment and warnings. For a paid site this tool also automatically returns the complete authoritative billing snapshot; users never need to know or name a separate billing tool to get accurate subscription information.",
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
       inputSchema: { projectDir: projectDirInput }
@@ -2731,12 +2731,18 @@ NO content was uploaded or changed by this call \u2014 to publish new or edited
         const site = requireSiteFile(ctx);
         const res = await ctx.client.getSiteStatus(site.siteId, site.credential);
         noteSiteMode(res.siteId, res.mode);
+        const billing = res.mode === "paid" ? await ctx.client.getBillingStatus(site.siteId, site.credential) : void 0;
         const binding = res.pendingDomainBinding ? await describePendingBinding(ctx.client, site.credential, res.pendingDomainBinding) : void 0;
-        return textJson("status_returned", `Site status:${binding?.note ?? ""}`, {
-          ...res,
-          projectDir: ctx.projectDir,
-          ...binding?.checklist ? { dnsChecklist: binding.checklist } : {}
-        });
+        return textJson(
+          "status_returned",
+          billing ? `Site status with AUTHORITATIVE BILLING SNAPSHOT. When answering any subscription question, use the nested billing object and report the current plan, scheduled renewal or cancellation, effective time, current entitlement, billing period, usage state and one-time carry when present:${binding?.note ?? ""}` : `Site status:${binding?.note ?? ""}`,
+          {
+            ...res,
+            projectDir: ctx.projectDir,
+            ...billing ? { billing } : {},
+            ...binding?.checklist ? { dnsChecklist: binding.checklist } : {}
+          }
+        );
       } catch (e) {
         return toolError(e);
       }
@@ -2908,7 +2914,7 @@ When the user says the TXT is set, run bind "status". It verifies ownership and
   server.registerTool(
     "billing",
     {
-      description: "Show this site's hosting subscription: current plan, next renewal plan, payment state, current paid entitlement, reconciled usage, estimated usage tier, bound custom domains and risks. Owner-only (uses the credential in .sakupa/site.json).",
+      description: "Return the sole authoritative source for this site's hosting subscription: current plan, next renewal plan or cancellation, effective time, payment state, current paid entitlement, reconciled usage, estimated usage tier, bound custom domains and risks. Owner-only (uses the credential in .sakupa/site.json).",
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
       inputSchema: { projectDir: projectDirInput }
@@ -2920,15 +2926,20 @@ When the user says the TXT is set, run bind "status". It verifies ownership and
         const res = await ctx.client.getBillingStatus(site.siteId, site.credential);
         noteSiteMode(res.siteId, res.mode);
         const lines = [
-          `Billing status for site ${res.siteId} (mode: ${res.mode})`,
+          `AUTHORITATIVE BILLING SNAPSHOT for site ${res.siteId} (mode: ${res.mode})`,
           res.permanentUrl ? `Permanent URL: ${res.permanentUrl}` : void 0,
           res.plan ? `Current plan: ${res.plan} (JPY ${res.monthlyPriceJpy ?? tierPriceJpy(res.plan)}/month)` : "Current plan: (no subscription yet)",
           res.subscriptionStatus ? `Subscription payment state: ${res.subscriptionStatus}` : void 0,
-          res.cancelAtPeriodEnd ? "Renewal: CANCELED \u2014 the site reverts to free at the end of the already-paid month" : res.renewalPlan ? `Next renewal plan: ${res.renewalPlan} (JPY ${res.renewalMonthlyPriceJpy ?? tierPriceJpy(res.renewalPlan)}/month)` + (res.renewalEffectiveAt ? `, effective ${res.renewalEffectiveAt}` : " (unchanged)") : void 0,
+          res.cancelAtPeriodEnd === true ? "Renewal: CANCELED \u2014 the site reverts to free at the end of the already-paid month" : res.renewalPlan ? `Next renewal plan: ${res.renewalPlan} (JPY ${res.renewalMonthlyPriceJpy ?? tierPriceJpy(res.renewalPlan)}/month)` + (res.renewalEffectiveAt ? `, effective ${res.renewalEffectiveAt}` : " (unchanged)") : res.cancelAtPeriodEnd === false ? "Renewal cancellation: no" : void 0,
           res.periodEntitlementPlan ? `Current paid entitlement: ${res.periodEntitlementPlan}` : void 0,
           res.currentPeriodStart ? `Current paid period: ${res.currentPeriodStart} -> ${res.currentPeriodEnd ?? "?"}` : void 0,
+          `Usage state: ${res.usageState}`,
+          res.currentPeriodUsage ? `Current usage: storage ${res.currentPeriodUsage.storageBytes} bytes; transfer ${res.currentPeriodUsage.transferBytes} bytes; requests ${res.currentPeriodUsage.requests}` : void 0,
+          res.currentPeriodCountedTransferBytes !== void 0 ? `Transfer counted against current plan: ${res.currentPeriodCountedTransferBytes} bytes` : void 0,
+          res.currentPlanLimits ? `Current plan limits: storage ${res.currentPlanLimits.storageBytes} bytes; transfer ${res.currentPlanLimits.transferBytes} bytes; requests ${res.currentPlanLimits.requests}` : void 0,
           res.estimatedUsageTier ? `Estimated usage tier: ${res.estimatedUsageTier}` : void 0,
           res.lastReconciledAt ? `Last usage reconciliation: ${res.lastReconciledAt}` : void 0,
+          res.usageLagSeconds !== void 0 ? `Usage lag: ${res.usageLagSeconds} seconds` : void 0,
           res.oneTimeTransferCarry ? `One-time transfer carry: ${res.oneTimeTransferCarry.remainingBytes} bytes remaining (granted ${res.oneTimeTransferCarry.grantedBytes}, expires ${res.oneTimeTransferCarry.expiresAt})` : void 0,
           res.boundHostnames.length > 0 ? `Bound custom domains: ${res.boundHostnames.join(", ")}` : void 0,
           res.risks.pastDue ? "ATTENTION: renewal payment failing \u2014 update the payment method (portal). Serving continues while Stripe retries; if Stripe gives up, the site reverts to free." : void 0
@@ -3515,7 +3526,6 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/tools/billing.ts
 import { z as z5 } from "zod";
-var plan = z5.enum(["water", "personal", "share", "business"]);
 function registerBillingTools(server, baseCtx) {
   server.registerTool(
     "plans",
@@ -3543,12 +3553,11 @@ function registerBillingTools(server, baseCtx) {
     }
   );
   server.registerTool(
-    "upgrade",
+    "change",
     {
-      description: "Create a Stripe-hosted confirmation link for a manually selected subscription plan. Creating the link does not change billing; only the user can confirm on Stripe.",
+      description: "Create one Stripe-hosted subscription-management link. The user chooses the plan or period-end cancellation on Stripe; Sakupa never infers intent from the conversation. Creating the link does not change billing.",
       inputSchema: {
         projectDir: projectDirInput,
-        targetPlan: plan,
         operationId: z5.string().min(1)
       },
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
@@ -3560,21 +3569,20 @@ function registerBillingTools(server, baseCtx) {
         const site = requireSiteFile(ctx);
         const result = await ctx.client.changeSubscriptionPlan(site.credential, {
           siteId: site.siteId,
-          targetPlan: args.targetPlan,
           operationId: args.operationId
         });
         return structuredToolResult({
           schemaVersion: 1,
           outcome: "waiting_user",
-          resultCode: "stripe_plan_change_confirmation_required",
+          resultCode: "stripe_subscription_management_required",
           operationId: args.operationId,
-          summary: `Stripe confirmation link created for ${result.currentPlan} -> ${result.targetPlan}; the subscription has NOT changed yet. ` + (result.direction === "upgrade" ? "Confirming starts a new paid month immediately at the full target price; Sakupa applies the plan only after invoice payment and carries unused transfer once." : result.direction === "downgrade" ? "The downgrade is scheduled for the end of the already-paid period." : "Confirming cancels the scheduled plan change and keeps the current plan without a new charge."),
+          summary: "Stripe subscription-management link created; the subscription has NOT changed yet. Stripe is the authoritative place to choose Water, Personal, Share, Business, or period-end cancellation. Query billing after the user finishes.",
           data: { result },
           userAction: {
             type: "open_url",
             provider: "stripe",
             url: result.portalUrl,
-            expectedOutcome: "After the user confirms on the Stripe-hosted page, the webhook updates the Sakupa subscription state"
+            expectedOutcome: "After the user finishes on Stripe, webhooks update Sakupa and billing reports the authoritative result"
           },
           nextActions: [{ tool: "billing", allowed: true }]
         });
@@ -3606,7 +3614,7 @@ Workflow:
 4. Optionally bind a custom domain to the subscribed site (bind): an included extra
    serving surface alongside the permanent URL. Ownership is proven only by DNS control; the
    first verified request wins; unverified requests expire after 72 hours. billing,
-   upgrade, portal and recover manage the paid
+   change, portal and recover manage the paid
    lifecycle; delete tears the whole site down after explicit confirmation. Binding a
    NEW domain while one is live is a zero-downtime SWITCH: the old domain keeps serving
    until the new domain's www is confirmed live, then it is replaced automatically.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sakupa/mcp",
-  "version": "0.7.26",
+  "version": "0.7.28",
   "description": "Sakupa MCP server: publish AI-made static sites from your AI tool. AI-made pages, live in seconds.",
   "type": "module",
   "main": "dist/index.js",