@sakupa/mcp 0.7.47 → 0.7.49

package/dist/bin.js

@@ -120,7 +120,7 @@ function resolveLockedProjectRoot(projectDir) {
   if (markerState.kind === "absent") {
     throw new ProjectRootError(
       "not_initialized",
-      `The MCP working directory ${canonical} is not initialized. Run \`npx -y @sakupa/mcp@latest init\` in that directory; do not pass a path argument.`
+      `The MCP working directory ${canonical} is not initialized. Call the init MCP tool with no path argument. If help confirms that this client has no MCP Roots, the AI may run \`npx -y @sakupa/mcp@latest init\` itself as the fallback.`
     );
   }
   return {
@@ -400,7 +400,7 @@ function isFreeSiteAllowanceNetworkReference(value) {
 }
 
 // ../core/dist/domain/version.js
-var SAKUPA_MCP_VERSION = "0.7.47";
+var SAKUPA_MCP_VERSION = "0.7.49";
 
 // ../core/dist/domain/errors.js
 var HTTP_STATUS = {
@@ -729,6 +729,7 @@ var EPHEMERAL_RETENTION_HOURS = 90 * 24;
 
 // src/config.ts
 var TEST_API_BASE_URL = "https://api-test.sakupa.com";
+var PRODUCTION_API_BASE_URL = DEFAULT_API_BASE_URL;
 function previewHostPatternFor(apiBaseUrl) {
   return environmentFor(apiBaseUrl) === "test" ? "{shortId}-test.sakupa.com" : "{shortId}.sakupa.com";
 }
@@ -743,6 +744,11 @@ function loadMcpRuntimeConfig(env = process.env) {
     }
     return { apiBaseUrl, testAccessToken };
   }
+  if (apiBaseUrl !== PRODUCTION_API_BASE_URL) {
+    throw new Error(
+      `Unsupported Sakupa API origin: ${apiBaseUrl}. Only ${PRODUCTION_API_BASE_URL} and ${TEST_API_BASE_URL} are accepted; refusing to classify an unknown endpoint as Production.`
+    );
+  }
   if (testAccessToken.length > 0) {
     throw new Error(
       `SAKUPA_TEST_ACCESS_TOKEN may only be used with ${TEST_API_BASE_URL}. Remove it before connecting to any other API.`
@@ -751,7 +757,9 @@ function loadMcpRuntimeConfig(env = process.env) {
   return { apiBaseUrl };
 }
 function environmentFor(apiBaseUrl) {
-  return apiBaseUrl === TEST_API_BASE_URL ? "test" : "production";
+  if (apiBaseUrl === TEST_API_BASE_URL) return "test";
+  if (apiBaseUrl === PRODUCTION_API_BASE_URL) return "production";
+  return "unknown";
 }
 
 // src/server.ts
@@ -3122,7 +3130,7 @@ var ProjectBindingResolver = class {
         snapshot,
         this.processCwd,
         rootCandidates,
-        "This IDE did not provide MCP Roots and the MCP process cwd is not an initialized project. Do not write into the IDE installation directory. Run `npx -y @sakupa/mcp@latest init` with no path arguments from the intended project terminal, then configure/restart the MCP process in that directory."
+        "This IDE did not provide MCP Roots and the MCP process cwd is not an initialized project. Do not write into the IDE installation directory. Run help from the intended project context. If help confirms the missing-Roots diagnosis, the AI may run `npx -y @sakupa/mcp@latest init` with no path arguments from that directory. Never ask the user to run it."
       )
     };
   }
@@ -3229,6 +3237,19 @@ var STRUCTURED_TOOL_OUTPUT_SCHEMA = {
   operationId: z.string().optional(),
   summary: z.string(),
   data: z.record(z.string(), z.unknown()),
+  presentation: z.object({
+    userLanguage: z.literal("infer_from_conversation"),
+    userTimeZone: z.literal("infer_from_conversation"),
+    answerScope: z.literal("current_user_question"),
+    retainTechnicalContext: z.literal(true),
+    productionEnvironmentDisclosure: z.literal("only_when_asked_or_relevant"),
+    nonProductionEnvironmentDisclosure: z.literal("always"),
+    translateFields: z.array(z.string()),
+    preserveExactFields: z.array(z.string()),
+    mustTellUser: z.array(z.string()),
+    tellWhenRelevant: z.array(z.string()),
+    agentInstructions: z.array(z.string())
+  }).optional(),
   decision: z.object({
     decisionVersion: z.literal(1),
     prompt: z.string(),
@@ -3282,9 +3303,54 @@ var STRUCTURED_TOOL_OUTPUT_SCHEMA = {
   )
 };
 function structuredToolResult(envelope) {
+  const presentation = {
+    userLanguage: "infer_from_conversation",
+    userTimeZone: "infer_from_conversation",
+    answerScope: "current_user_question",
+    retainTechnicalContext: true,
+    productionEnvironmentDisclosure: "only_when_asked_or_relevant",
+    nonProductionEnvironmentDisclosure: "always",
+    translateFields: [
+      "summary",
+      "userAction.expectedOutcome",
+      "userAction.options[].label",
+      "userAction.options[].expectedOutcome",
+      ...envelope.presentation?.translateFields ?? []
+    ],
+    preserveExactFields: [
+      "data",
+      "nextActions",
+      "operationId",
+      "embedded URLs, paths, IDs, code tokens, tool names, arguments, DNS values, field names, amounts and exact timestamps",
+      ...envelope.presentation?.preserveExactFields ?? []
+    ],
+    mustTellUser: [
+      "the requested result and whether the operation changed anything",
+      "any action the user must personally complete",
+      "material charges, deadlines, cancellation, replacement, credential revocation and other security or irreversible consequences",
+      ...envelope.presentation?.mustTellUser ?? []
+    ],
+    tellWhenRelevant: [
+      "local paths, internal IDs, raw enums, exact arguments, provider state and diagnostic details",
+      "normal Production environment details, unless the user asks or environment identity matters to the task",
+      ...envelope.presentation?.tellWhenRelevant ?? []
+    ],
+    agentInstructions: [
+      "Keep every technical fact available for reasoning and exact continuation; never discard it merely because it is technical.",
+      "Answer the current user question instead of mechanically dumping every returned field. Explain relevant technical terms in plain language while retaining the exact term when it helps accuracy.",
+      "Do not ask the user to copy or run tool arguments that this AI can execute. Use exact nextActions internally after any required user choice.",
+      "Translate human-readable explanations into the language the user is using and present dates and sizes in locally understandable form alongside exact values when precision matters.",
+      "Do not proactively mention a normal Production environment. Always disclose Test or unknown/non-production environments prominently.",
+      ...envelope.presentation?.agentInstructions ?? []
+    ]
+  };
+  const structuredEnvelope = { ...envelope, presentation };
+  const presentationFallback = "AGENT PRESENTATION CONTRACT: Retain every technical fact below for reasoning and exact follow-up. Tell the user the requested result, required next step, and every material charge, deadline, security or irreversible consequence. Answer only the current question instead of dumping all fields; explain relevant technical terms in plain language while keeping exact terms available. Translate human-readable explanations into the user's language, but preserve URLs, paths, IDs, tool names, arguments, DNS values, field names, amounts and exact timestamps. Do not proactively show a normal Production environment; always disclose Test or unknown environments. Never ask the user to run exact tool arguments that this AI can execute.";
   return {
-    content: [{ type: "text", text: envelope.summary }],
-    structuredContent: envelope
+    content: [{ type: "text", text: `${envelope.summary}
+
+${presentationFallback}` }],
+    structuredContent: structuredEnvelope
   };
 }
 
@@ -3435,14 +3501,22 @@ function toolError(e) {
   const timeoutSummary = timedOut ? timeoutRetrySafe ? `${timeoutOperation} exceeded its ${timeoutMs ?? "configured"}ms deadline. Sakupa made zero automatic retries; this was a read, so retry it manually or run help if it repeats.` : `${timeoutOperation} exceeded its ${timeoutMs ?? "configured"}ms deadline. Sakupa made zero automatic retries. The remote outcome may be unknown; do not repeat the write automatically. Query current status or run help first.` : void 0;
   const serverGuidance = isSakupaError(e) && errorCode !== "internal" && errorCode !== "unauthorized" && errorCode !== "upgrade_required" && e.message.trim().length > 0 ? e.message : void 0;
   const safeSummary = timeoutSummary ?? (e instanceof LocalGuidanceError ? e.message : errorCode === "upgrade_required" ? `This Sakupa MCP client is v${MCP_VERSION}, older than the server's minimum supported version${minimumVersion !== void 0 ? ` (v${minimumVersion})` : ""}, so the server refused the call. To fix it: ask the user to fully restart their MCP client session \u2014 "npx -y @sakupa/mcp@latest" setups fetch the current version on restart (run "npx clear-npx-cache" first if the old version persists); global installs need "npm install -g @sakupa/mcp@latest". After the restart, retry this exact tool call.` : errorCode === "unauthorized" ? UNAUTHORIZED_SUMMARY : serverGuidance ?? (retryable ? "An upstream service is temporarily unavailable or busy; retry shortly." : opaqueUnclassified ? "This failed with an error Sakupa could not classify, and retrying the same call will not help. Run help with the failed tool and error code first; only use report if help explicitly recommends it." : "The operation failed; no server-internal details are exposed."));
+  const customerMeaning = timedOut ? timeoutRetrySafe ? "Sakupa did not receive this read result before the deadline; no automatic retry occurred." : "Sakupa did not receive a final result before the deadline, so the AI must check current state before attempting another write." : errorCode === "unauthorized" ? "The cloud site is still intact, but this project no longer has a valid management credential for it." : errorCode === "upgrade_required" ? "The installed Sakupa MCP version is too old for the current API and must be refreshed before retrying." : errorCode === "payment_required" ? "This action needs an active subscription or a payment issue must be resolved first." : errorCode === "rate_limited" ? "Sakupa temporarily refused this operation because a usage or frequency limit was reached." : errorCode === "not_found" ? "The requested Sakupa site, project binding, or operation could not be found." : errorCode === "forbidden" ? "Sakupa refused this operation because the current authority or site state does not allow it." : errorCode === "conflict" || errorCode === "state_conflict" || errorCode === "confirmation_required" ? "Sakupa safely stopped because the site, billing state, or required confirmation no longer matches." : errorCode === "invalid_request" || errorCode === "validation_failed" ? "Sakupa could not complete the operation because required input or current state was invalid." : retryable ? "A temporary Sakupa dependency problem prevented completion." : "Sakupa did not complete the operation; use the retained diagnostics to determine the safe next step.";
+  const userFacingSummary = `Customer meaning: ${customerMeaning}
+Technical context for the AI: ${safeSummary}`;
   const result = structuredToolResult({
     schemaVersion: 1,
     outcome: "failed",
     resultCode: `error_${errorCode}`,
-    summary: safeSummary,
+    summary: userFacingSummary,
     data: {
       errorCode,
       retryable,
+      customerMeaning,
+      diagnosticContext: {
+        technicalMessage: safeSummary,
+        source: serverGuidance ? "sakupa_business_guidance" : "mcp_safe_diagnostic"
+      },
       ...safeDetails && Object.keys(safeDetails).length > 0 ? { details: safeDetails } : {}
     },
     nextActions: [
@@ -3458,6 +3532,26 @@ function toolError(e) {
 }
 
 // src/tools/decision.ts
+var DECISION_PRESENTATION_POLICY = {
+  translateFields: [
+    "decision.prompt",
+    "decision.options[].label",
+    "decision.options[].description",
+    "decision.options[].consequences[]"
+  ],
+  preserveExactFields: [
+    "decision.options[].id",
+    "decision.options[].nextAction",
+    "userAction.resumeWith",
+    "userAction.options[].value",
+    "nextActions",
+    "decision option IDs and confirmation values"
+  ],
+  mustTellUser: ["every decision option, with no option selected by default"],
+  agentInstructions: [
+    "Wait for the user's selection, then copy only that option's exact nextAction without reconstructing arguments."
+  ]
+};
 var FORBIDDEN_DECISION_ARGUMENT_KEYS = /* @__PURE__ */ new Set([
   "credential",
   "candidatecredential",
@@ -3598,6 +3692,7 @@ function decisionToolResult(input) {
 
 ${formatDecisionFallback(decision)}`,
     data: input.data,
+    presentation: DECISION_PRESENTATION_POLICY,
     decision,
     ...userAction === void 0 ? {} : { userAction },
     nextActions
@@ -3655,6 +3750,15 @@ var severityEnum = z2.enum(["low", "medium", "high", "critical"]);
 function planCatalog() {
   return TIER_ORDER.map((p) => `${p} JPY ${tierPriceJpy(p)}/month`).join(", ");
 }
+function deploymentEnvironmentContext(apiBaseUrl) {
+  const environment = environmentFor(apiBaseUrl);
+  if (environment === "production") {
+    return `Agent context \u2014 environment: PRODUCTION (${apiBaseUrl}). Retain this fact, but do not proactively show it to the user unless asked or relevant.
+`;
+  }
+  return `IMPORTANT USER NOTICE \u2014 environment: ${environment.toUpperCase()} (${apiBaseUrl}). The user must be told prominently that this is not the normal Production environment.
+`;
+}
 var ticketCategoryEnum = z2.enum([
   "billing",
   "payment",
@@ -3905,7 +4009,7 @@ Next action: ${analysis.suggestedNextAction}`,
   server.registerTool(
     "deploy",
     {
-      description: `Deploy the local static output to Sakupa. First deploy creates a free temporary site (valid ${FREE_SITE_TTL_HOURS}h, public URL like https://${previewHostPattern}) and stores the management credential in .sakupa/site.json. Later runs update the existing site (free sites also refresh their validity; subscribed sites are permanent). Runs analyze first and refuses to upload source projects, secrets, .env files, archives, media or server code. The MCP process is locked to the current directory initialized by \`npx -y @sakupa/mcp@latest init\`; no tool argument can change that root. outputDir is a separate REQUIRED relative path supplied from the current project inspection. Never uploads anything when analysis says the project is not deployable.`,
+      description: `Deploy the local static output to Sakupa. First deploy creates a free temporary site (valid ${FREE_SITE_TTL_HOURS}h, public URL like https://${previewHostPattern}) and stores the management credential in .sakupa/site.json. Later runs update the existing site (free sites also refresh their validity; subscription-backed sites have no free-site expiry while the subscription remains active). Runs analyze first and refuses to upload source projects, secrets, .env files, archives, media or server code. The MCP process is locked to the current directory initialized by the no-argument init MCP tool; no tool argument can change that root. outputDir is a separate REQUIRED relative path supplied from the current project inspection. Never uploads anything when analysis says the project is not deployable.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
       inputSchema: {
@@ -4396,12 +4500,11 @@ Next action: ${analysis.suggestedNextAction}`,
           return text(
             "site_published",
             `Site published: ${finalized2.url}
-Environment: ${environmentFor(ctx.apiBaseUrl).toUpperCase()} (${ctx.apiBaseUrl})
-Project directory: ${ctx.projectDir}
+` + deploymentEnvironmentContext(ctx.apiBaseUrl) + `Project directory: ${ctx.projectDir}
 Files uploaded: ${uploaded2} (${finalized2.totalBytes} bytes)
 ` + (finalized2.expiresAt ? `Expires at: ${finalized2.expiresAt}
 ` : "") + `
-This is a FREE temporary preview: it stays live for ${FREE_SITE_TTL_HOURS} hours. Deploying again or calling refresh extends the validity; subscribing the site (subscribe) makes this URL permanent. The management credential was saved to .sakupa/site.json \u2014 keep that file: it is the only way to manage this site.
+This is a FREE temporary preview: it stays live for ${FREE_SITE_TTL_HOURS} hours. Deploying again or calling refresh extends the validity; while a subscription remains active, this URL stays live without the free-site expiry. The management credential was saved to .sakupa/site.json \u2014 keep that file: it is the only way to manage this site.
 ` + credentialGitReminder(ctx.projectDir) + (finalized2.warnings.length > 0 ? `
 Warnings:
 ${JSON.stringify(finalized2.warnings, null, 2)}` : ""),
@@ -4486,14 +4589,13 @@ ${JSON.stringify(finalized2.warnings, null, 2)}` : ""),
         return text(
           handoffPerformed ? "free_site_slot_reassigned" : "site_updated",
           `Site updated: ${finalized.url}
-Environment: ${environmentFor(ctx.apiBaseUrl).toUpperCase()} (${ctx.apiBaseUrl})
-Project directory: ${ctx.projectDir}
+` + deploymentEnvironmentContext(ctx.apiBaseUrl) + `Project directory: ${ctx.projectDir}
 Files uploaded: ${uploaded} (${finalized.totalBytes} bytes)
 ` + (finalized.expiresAt ? `Validity refreshed \u2014 expires at: ${finalized.expiresAt}
 ` : "") + (credentialRelocatedFrom.length > 0 ? `Credential binding relocated from ${credentialRelocatedFrom.join(", ")} to ${ctx.projectDir}/.sakupa; the existing site was preserved.
 ` : "") + (handoffPerformed ? `Site handoff completed from the authenticated device list. The existing free-site URL stayed the same, the cloud site was NOT deleted, and its content was replaced. Sakupa issued a fresh project credential and revoked ${handoffRevokedCredentials} previous credential(s), so no old project can continue managing this URL.` + (handoffCleanup?.sourceCredentialRemoved ? " A matching obsolete local site.json was removed automatically.\n" : "\n") : "") + (credentialRotationResumed ? "A previously confirmed credential rotation was resumed safely before this deploy; every older credential is revoked.\n" : "") + (finalized.mode === "free" ? `
-Reminder: free sites stay live for ${FREE_SITE_TTL_HOURS} hours after the last deploy or refresh call. Subscribing (subscribe) makes the site permanent.
-` : "\nThis site is subscribed and permanent \u2014 no expiry.\n") + (finalized.warnings.length > 0 ? `
+Reminder: free sites stay live for ${FREE_SITE_TTL_HOURS} hours after the last deploy or refresh call. While a subscription remains active, the site stays live without this free-site expiry.
+` : "\nThis site is subscription-backed and has no free-site expiry while the subscription remains active.\n") + (finalized.warnings.length > 0 ? `
 Warnings:
 ${JSON.stringify(finalized.warnings, null, 2)}` : "") + (credentialSecurity?.rotationRecommended ? `
 
@@ -4549,7 +4651,7 @@ Optional security recommendation: this management credential was created at ${cr
   server.registerTool(
     "refresh",
     {
-      description: "Refresh the validity of the free temporary site WITHOUT uploading content. Uses the local credential in .sakupa/site.json. Subscribed sites are permanent and need no refresh.",
+      description: "Refresh the validity of the free temporary site WITHOUT uploading content. Uses the local credential in .sakupa/site.json. Subscription-backed sites have no free-site expiry while the subscription remains active and need no refresh.",
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
       inputSchema: {}
@@ -4613,7 +4715,7 @@ NO content was uploaded or changed by this call \u2014 to publish new or edited
   server.registerTool(
     "subscribe",
     {
-      description: `Create a Stripe Checkout link that subscribes THIS site to a Sakupa Hosting monthly plan (${planCatalog()}). Paying makes the site PERMANENT on its ${previewHostPattern} URL \u2014 no more 24h expiry; that is the core value of paying. Binding a custom domain afterwards (bind) is an optional included extra and requires DNS control of that domain. Owner-only: requires this project's site credential (.sakupa/site.json) \u2014 deploy first. If the site outgrows its plan, Sakupa shows an over-limit notice and never changes billing automatically. The owner can explicitly choose another plan through Stripe Customer Portal. Card details are entered only on the Stripe-hosted page \u2014 never through the AI tool. Opening and completing Stripe Checkout is the final subscription confirmation.`,
+      description: `Create a Stripe Checkout link that subscribes THIS site to a Sakupa Hosting monthly plan (${planCatalog()}). While the subscription remains active, its ${previewHostPattern} URL stays live without the free 24-hour expiry. Binding a custom domain afterwards (bind) is an optional included extra and requires DNS control of that domain. Owner-only: requires this project's site credential (.sakupa/site.json) \u2014 deploy first. If the site outgrows its plan, Sakupa shows an over-limit notice and never changes billing automatically. The owner can explicitly choose another plan through Stripe Customer Portal. Card details are entered only on the Stripe-hosted page \u2014 never through the AI tool. Opening and completing Stripe Checkout is the final subscription confirmation.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
       inputSchema: {
@@ -4640,7 +4742,7 @@ NO content was uploaded or changed by this call \u2014 to publish new or edited
 ${res.checkoutUrl}
 
 Open this link in a browser to subscribe. Card data is entered only on the Stripe-hosted page \u2014 never give card numbers, passwords or security codes to the AI tool.
-Once payment confirms, the site becomes permanent on its current URL. Binding a custom domain (bind) is optional and still requires DNS verification.`,
+Once Stripe confirms payment and Sakupa synchronizes the subscription, the current URL stays live while that subscription remains active. Binding a custom domain (bind) is optional and still requires DNS verification.`,
           {
             siteId: res.siteId,
             plan: res.plan,
@@ -4659,7 +4761,7 @@ Once payment confirms, the site becomes permanent on its current URL. Binding a
   server.registerTool(
     "bind",
     {
-      description: `Bind a custom domain to this subscribed site \u2014 an OPTIONAL extra serving surface; the permanent ${previewHostPattern} URL keeps working alongside it. The binding unit is the APEX domain: binding example.com reserves routes for example.com and www.example.com, but ONLY www is required and judged for activation; the naked apex is optional because many DNS providers cannot point it. One apex TXT verification covers both, and one site binds at most ONE apex domain \u2014 a second domain needs a second subscribed site. Requires an ACTIVE subscription (subscribe). Ownership is proven ONLY by DNS control of the apex \u2014 payment never grants ownership, and bindings are ALWAYS challengeable: whoever proves CURRENT DNS control takes the domain, even from an existing binding (the displaced site keeps its subscription, content and permanent URL). Unverified requests expire after 72 hours. Call again with action "status" to check progress.`,
+      description: `Bind a custom domain to this subscribed site \u2014 an OPTIONAL extra serving surface; the subscription-backed ${previewHostPattern} URL keeps working alongside it while the subscription is active. The binding unit is the APEX domain: binding example.com reserves routes for example.com and www.example.com, but ONLY www is required and judged for activation; the naked apex is optional because many DNS providers cannot point it. One apex TXT verification covers both, and one site binds at most ONE apex domain \u2014 a second domain needs a second subscribed site. Requires an ACTIVE subscription (subscribe). Ownership is proven ONLY by DNS control of the apex \u2014 payment never grants ownership, and bindings are ALWAYS challengeable: whoever proves CURRENT DNS control takes the domain, even from an existing binding (the displaced site keeps its subscription, content and subscription-backed Sakupa URL). Unverified requests expire after 72 hours. Call again with action "status" to check progress.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
       inputSchema: {
@@ -4787,7 +4889,7 @@ When the user says the TXT is set, run bind "status". It verifies ownership and
         noteSiteMode(res.siteId, res.mode);
         const lines = [
           `AUTHORITATIVE BILLING SNAPSHOT for site ${res.siteId} (mode: ${res.mode})`,
-          res.permanentUrl ? `Permanent URL: ${res.permanentUrl}` : void 0,
+          res.permanentUrl ? `Subscription-backed Sakupa 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 === true ? `Renewal: CANCELED \u2014 the site reverts to free at ${res.cancellationEffectiveAt ?? res.currentPeriodEnd ?? "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,
@@ -5486,7 +5588,7 @@ var TOOL_MANUALS = {
   init: {
     purpose: "Initialize the active IDE workspace as one Sakupa project.",
     sideEffects: "Creates only .sakupa/project.json locally; no API call, site or charge.",
-    preconditions: "Exactly one usable MCP workspace Root. Clients without Roots use CLI init.",
+    preconditions: "Exactly one usable MCP workspace Root. If Roots are unavailable, help may authorize the AI to use CLI init.",
     parameterNames: [],
     parameters: "No parameters and no path argument.",
     warnings: [
@@ -5535,7 +5637,9 @@ var TOOL_MANUALS = {
     preconditions: "A valid local site credential.",
     parameterNames: [],
     parameters: "No parameters.",
-    warnings: ["Subscribed sites are permanent and do not need refresh."],
+    warnings: [
+      "Subscription-backed sites have no free-site expiry while the subscription remains active and do not need refresh."
+    ],
     nextStep: "Call status to verify the new expiry."
   },
   status: {
@@ -5677,7 +5781,7 @@ function registerHelpTools(server, baseCtx) {
   server.registerTool(
     "init",
     {
-      description: "Initialize the active MCP workspace Root as a Sakupa project. Takes no path argument, creates only .sakupa/project.json at that exact Root, preserves site/recovery state, makes no API call and is idempotent. Clients without MCP Roots must use the no-argument CLI init.",
+      description: "Initialize the active MCP workspace Root as a Sakupa project. Takes no path argument, creates only .sakupa/project.json at that exact Root, preserves site/recovery state, makes no API call and is idempotent. If MCP Roots are unavailable, call help; the AI may then use the no-argument CLI init itself.",
       inputSchema: {},
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
@@ -6154,14 +6258,14 @@ Workflow:
    current deployment and serving state at any time. Every update checks the credential's
    server-side issue time. When it is older than 7 days, deploy succeeds and only SUGGESTS the
    optional rotate tool; never rotate without the user's explicit confirmation.
-3. To make the site PERMANENT, subscribe it to a monthly hosting plan (plans
+3. To keep the site live beyond the free period, subscribe it to a monthly hosting plan (plans
    shows the catalog; subscribe -> Stripe-hosted checkout;
-   water/personal/share/business). Paying makes the
-   ${hostPattern} URL permanent \u2014 that is what payment buys. Usage over the chosen plan
+   water/personal/share/business). While the subscription remains active, the
+   ${hostPattern} URL stays live without the free 24-hour expiry. Usage over the chosen plan
    shows an over-limit notice by default. An external AI may periodically query usage and
    recommend a plan, but Sakupa never changes a subscription automatically.
 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
+   serving surface alongside the subscription-backed Sakupa URL. Ownership is proven only by DNS control; the
    first verified request wins; unverified requests expire after 72 hours. billing,
    change, portal and recover manage the paid lifecycle. Binding a
    NEW domain while one is live is a zero-downtime SWITCH: the old domain keeps serving
@@ -6181,13 +6285,17 @@ context, paraphrase a selection into different arguments, or invent another opti
 selects, copy that option's exact nextAction. Legacy userAction and nextActions mirror the same
 choice for older clients; decision is the authoritative choice set. A type "none" option means call
 no tool and change nothing. Stripe-hosted links remain direct links because Stripe itself owns plan
-selection and confirmation.
+selection and confirmation. Before showing any decision, infer the language the user is using and
+translate every human-readable summary, prompt, option label, description and consequence into that
+language. Keep option IDs, tool names, exact arguments, URLs, field names and confirmation values
+unchanged.
 
-Project directory contract: before the first deploy or a new recovery, initialize the intended
-project by calling init with NO path argument. init uses the IDE's exact MCP Root and creates the
-non-secret .sakupa/project.json directly there. The CLI command
-"npx -y @sakupa/mcp@latest init" remains the safe fallback for clients without MCP Roots and
-also accepts NO path argument. ONE MCP process = ONE Roots-first locked project = ONE site.
+Project directory contract: before the first deploy or a new recovery, CALL the init MCP tool with
+NO path argument. init uses the IDE's exact MCP Root and creates the non-secret
+.sakupa/project.json directly there. Do not merely print installation or CLI instructions when the
+init tool is available. Only after help confirms that the client does not provide MCP Roots may the
+AI itself use the CLI command "npx -y @sakupa/mcp@latest init" as a fallback; never ask the user to
+run it. The CLI also accepts NO path argument. ONE MCP process = ONE Roots-first locked project = ONE site.
 Site tools do not accept projectDir and cannot select another root; help, plans and report preview
 and public_recovery portal remain project-independent.
 Sakupa stores .sakupa/site.json and recovery state only in the locked directory; it never uses
@@ -6200,11 +6308,21 @@ before retrying with outputDirChangeConfirmed: true.
 After init, require sakupaAtProjectRoot=true. Before deploy, Sakupa checks every directory segment
 between the project Root and outputDir for a misplaced .sakupa and safely relocates only validated,
 non-conflicting state; never copy, delete or overwrite site.json by shell command.
-After every deploy, TELL the user which environment it went to (deploy results carry an
-Explicit Environment line: TEST vs PRODUCTION). analyze, deploy, status,
-and refresh echo
+Every result retains the exact environment for AI reasoning. Prominently tell the user when the
+environment is TEST or unknown/non-production. Do not proactively mention a normal PRODUCTION
+environment unless the user asks or the distinction is relevant to the current question. analyze,
+deploy, status, and refresh echo
 the Roots-first locked directory they acted on.
 
+Presentation contract: preserve every returned technical fact for reasoning and exact continuation,
+including paths, IDs, enums, tool names, arguments, DNS values, provider states, amounts and exact
+timestamps. Do not mechanically dump every field. Answer the user's current question first, explain
+relevant technical terms in plain language while retaining the exact term, translate human-readable
+explanations into the user's language, and always disclose material charges, deadlines, cancellation,
+replacement, credential revocation, security effects and irreversible consequences. A technical fact
+may be omitted from the immediate user-facing answer only when it is irrelevant to the current
+question; it must remain available in the tool result for follow-up.
+
 On any difficulty, call help before retrying or escalating. Only offer report when help returns
 reportRecommended:true; attach your own factual account via agentContext and show the exact
 sanitized preview before asking the user to confirm submission.

package/dist/index.js

@@ -145,7 +145,7 @@ function isFreeSiteAllowanceNetworkReference(value) {
 }
 
 // ../core/dist/domain/version.js
-var SAKUPA_MCP_VERSION = "0.7.47";
+var SAKUPA_MCP_VERSION = "0.7.49";
 
 // ../core/dist/domain/errors.js
 var HTTP_STATUS = {
@@ -478,6 +478,7 @@ var CLIENT_TYPE = "sakupa-mcp";
 
 // src/config.ts
 var TEST_API_BASE_URL = "https://api-test.sakupa.com";
+var PRODUCTION_API_BASE_URL = DEFAULT_API_BASE_URL;
 function previewHostPatternFor(apiBaseUrl) {
   return environmentFor(apiBaseUrl) === "test" ? "{shortId}-test.sakupa.com" : "{shortId}.sakupa.com";
 }
@@ -492,6 +493,11 @@ function loadMcpRuntimeConfig(env = process.env) {
     }
     return { apiBaseUrl, testAccessToken };
   }
+  if (apiBaseUrl !== PRODUCTION_API_BASE_URL) {
+    throw new Error(
+      `Unsupported Sakupa API origin: ${apiBaseUrl}. Only ${PRODUCTION_API_BASE_URL} and ${TEST_API_BASE_URL} are accepted; refusing to classify an unknown endpoint as Production.`
+    );
+  }
   if (testAccessToken.length > 0) {
     throw new Error(
       `SAKUPA_TEST_ACCESS_TOKEN may only be used with ${TEST_API_BASE_URL}. Remove it before connecting to any other API.`
@@ -500,7 +506,9 @@ function loadMcpRuntimeConfig(env = process.env) {
   return { apiBaseUrl };
 }
 function environmentFor(apiBaseUrl) {
-  return apiBaseUrl === TEST_API_BASE_URL ? "test" : "production";
+  if (apiBaseUrl === TEST_API_BASE_URL) return "test";
+  if (apiBaseUrl === PRODUCTION_API_BASE_URL) return "production";
+  return "unknown";
 }
 
 // src/timeout.ts
@@ -1646,7 +1654,7 @@ function resolveLockedProjectRoot(projectDir) {
   if (markerState.kind === "absent") {
     throw new ProjectRootError(
       "not_initialized",
-      `The MCP working directory ${canonical} is not initialized. Run \`npx -y @sakupa/mcp@latest init\` in that directory; do not pass a path argument.`
+      `The MCP working directory ${canonical} is not initialized. Call the init MCP tool with no path argument. If help confirms that this client has no MCP Roots, the AI may run \`npx -y @sakupa/mcp@latest init\` itself as the fallback.`
     );
   }
   return {
@@ -1932,7 +1940,7 @@ var ProjectBindingResolver = class {
         snapshot,
         this.processCwd,
         rootCandidates,
-        "This IDE did not provide MCP Roots and the MCP process cwd is not an initialized project. Do not write into the IDE installation directory. Run `npx -y @sakupa/mcp@latest init` with no path arguments from the intended project terminal, then configure/restart the MCP process in that directory."
+        "This IDE did not provide MCP Roots and the MCP process cwd is not an initialized project. Do not write into the IDE installation directory. Run help from the intended project context. If help confirms the missing-Roots diagnosis, the AI may run `npx -y @sakupa/mcp@latest init` with no path arguments from that directory. Never ask the user to run it."
       )
     };
   }
@@ -2039,6 +2047,19 @@ var STRUCTURED_TOOL_OUTPUT_SCHEMA = {
   operationId: z.string().optional(),
   summary: z.string(),
   data: z.record(z.string(), z.unknown()),
+  presentation: z.object({
+    userLanguage: z.literal("infer_from_conversation"),
+    userTimeZone: z.literal("infer_from_conversation"),
+    answerScope: z.literal("current_user_question"),
+    retainTechnicalContext: z.literal(true),
+    productionEnvironmentDisclosure: z.literal("only_when_asked_or_relevant"),
+    nonProductionEnvironmentDisclosure: z.literal("always"),
+    translateFields: z.array(z.string()),
+    preserveExactFields: z.array(z.string()),
+    mustTellUser: z.array(z.string()),
+    tellWhenRelevant: z.array(z.string()),
+    agentInstructions: z.array(z.string())
+  }).optional(),
   decision: z.object({
     decisionVersion: z.literal(1),
     prompt: z.string(),
@@ -2092,9 +2113,54 @@ var STRUCTURED_TOOL_OUTPUT_SCHEMA = {
   )
 };
 function structuredToolResult(envelope) {
+  const presentation = {
+    userLanguage: "infer_from_conversation",
+    userTimeZone: "infer_from_conversation",
+    answerScope: "current_user_question",
+    retainTechnicalContext: true,
+    productionEnvironmentDisclosure: "only_when_asked_or_relevant",
+    nonProductionEnvironmentDisclosure: "always",
+    translateFields: [
+      "summary",
+      "userAction.expectedOutcome",
+      "userAction.options[].label",
+      "userAction.options[].expectedOutcome",
+      ...envelope.presentation?.translateFields ?? []
+    ],
+    preserveExactFields: [
+      "data",
+      "nextActions",
+      "operationId",
+      "embedded URLs, paths, IDs, code tokens, tool names, arguments, DNS values, field names, amounts and exact timestamps",
+      ...envelope.presentation?.preserveExactFields ?? []
+    ],
+    mustTellUser: [
+      "the requested result and whether the operation changed anything",
+      "any action the user must personally complete",
+      "material charges, deadlines, cancellation, replacement, credential revocation and other security or irreversible consequences",
+      ...envelope.presentation?.mustTellUser ?? []
+    ],
+    tellWhenRelevant: [
+      "local paths, internal IDs, raw enums, exact arguments, provider state and diagnostic details",
+      "normal Production environment details, unless the user asks or environment identity matters to the task",
+      ...envelope.presentation?.tellWhenRelevant ?? []
+    ],
+    agentInstructions: [
+      "Keep every technical fact available for reasoning and exact continuation; never discard it merely because it is technical.",
+      "Answer the current user question instead of mechanically dumping every returned field. Explain relevant technical terms in plain language while retaining the exact term when it helps accuracy.",
+      "Do not ask the user to copy or run tool arguments that this AI can execute. Use exact nextActions internally after any required user choice.",
+      "Translate human-readable explanations into the language the user is using and present dates and sizes in locally understandable form alongside exact values when precision matters.",
+      "Do not proactively mention a normal Production environment. Always disclose Test or unknown/non-production environments prominently.",
+      ...envelope.presentation?.agentInstructions ?? []
+    ]
+  };
+  const structuredEnvelope = { ...envelope, presentation };
+  const presentationFallback = "AGENT PRESENTATION CONTRACT: Retain every technical fact below for reasoning and exact follow-up. Tell the user the requested result, required next step, and every material charge, deadline, security or irreversible consequence. Answer only the current question instead of dumping all fields; explain relevant technical terms in plain language while keeping exact terms available. Translate human-readable explanations into the user's language, but preserve URLs, paths, IDs, tool names, arguments, DNS values, field names, amounts and exact timestamps. Do not proactively show a normal Production environment; always disclose Test or unknown environments. Never ask the user to run exact tool arguments that this AI can execute.";
   return {
-    content: [{ type: "text", text: envelope.summary }],
-    structuredContent: envelope
+    content: [{ type: "text", text: `${envelope.summary}
+
+${presentationFallback}` }],
+    structuredContent: structuredEnvelope
   };
 }
 
@@ -2245,14 +2311,22 @@ function toolError(e) {
   const timeoutSummary = timedOut ? timeoutRetrySafe ? `${timeoutOperation} exceeded its ${timeoutMs ?? "configured"}ms deadline. Sakupa made zero automatic retries; this was a read, so retry it manually or run help if it repeats.` : `${timeoutOperation} exceeded its ${timeoutMs ?? "configured"}ms deadline. Sakupa made zero automatic retries. The remote outcome may be unknown; do not repeat the write automatically. Query current status or run help first.` : void 0;
   const serverGuidance = isSakupaError(e) && errorCode !== "internal" && errorCode !== "unauthorized" && errorCode !== "upgrade_required" && e.message.trim().length > 0 ? e.message : void 0;
   const safeSummary = timeoutSummary ?? (e instanceof LocalGuidanceError ? e.message : errorCode === "upgrade_required" ? `This Sakupa MCP client is v${MCP_VERSION}, older than the server's minimum supported version${minimumVersion !== void 0 ? ` (v${minimumVersion})` : ""}, so the server refused the call. To fix it: ask the user to fully restart their MCP client session \u2014 "npx -y @sakupa/mcp@latest" setups fetch the current version on restart (run "npx clear-npx-cache" first if the old version persists); global installs need "npm install -g @sakupa/mcp@latest". After the restart, retry this exact tool call.` : errorCode === "unauthorized" ? UNAUTHORIZED_SUMMARY : serverGuidance ?? (retryable ? "An upstream service is temporarily unavailable or busy; retry shortly." : opaqueUnclassified ? "This failed with an error Sakupa could not classify, and retrying the same call will not help. Run help with the failed tool and error code first; only use report if help explicitly recommends it." : "The operation failed; no server-internal details are exposed."));
+  const customerMeaning = timedOut ? timeoutRetrySafe ? "Sakupa did not receive this read result before the deadline; no automatic retry occurred." : "Sakupa did not receive a final result before the deadline, so the AI must check current state before attempting another write." : errorCode === "unauthorized" ? "The cloud site is still intact, but this project no longer has a valid management credential for it." : errorCode === "upgrade_required" ? "The installed Sakupa MCP version is too old for the current API and must be refreshed before retrying." : errorCode === "payment_required" ? "This action needs an active subscription or a payment issue must be resolved first." : errorCode === "rate_limited" ? "Sakupa temporarily refused this operation because a usage or frequency limit was reached." : errorCode === "not_found" ? "The requested Sakupa site, project binding, or operation could not be found." : errorCode === "forbidden" ? "Sakupa refused this operation because the current authority or site state does not allow it." : errorCode === "conflict" || errorCode === "state_conflict" || errorCode === "confirmation_required" ? "Sakupa safely stopped because the site, billing state, or required confirmation no longer matches." : errorCode === "invalid_request" || errorCode === "validation_failed" ? "Sakupa could not complete the operation because required input or current state was invalid." : retryable ? "A temporary Sakupa dependency problem prevented completion." : "Sakupa did not complete the operation; use the retained diagnostics to determine the safe next step.";
+  const userFacingSummary = `Customer meaning: ${customerMeaning}
+Technical context for the AI: ${safeSummary}`;
   const result = structuredToolResult({
     schemaVersion: 1,
     outcome: "failed",
     resultCode: `error_${errorCode}`,
-    summary: safeSummary,
+    summary: userFacingSummary,
     data: {
       errorCode,
       retryable,
+      customerMeaning,
+      diagnosticContext: {
+        technicalMessage: safeSummary,
+        source: serverGuidance ? "sakupa_business_guidance" : "mcp_safe_diagnostic"
+      },
       ...safeDetails && Object.keys(safeDetails).length > 0 ? { details: safeDetails } : {}
     },
     nextActions: [
@@ -3574,6 +3648,26 @@ async function resumeCredentialRotation(client, projectDir, site, apiBaseUrl) {
 }
 
 // src/tools/decision.ts
+var DECISION_PRESENTATION_POLICY = {
+  translateFields: [
+    "decision.prompt",
+    "decision.options[].label",
+    "decision.options[].description",
+    "decision.options[].consequences[]"
+  ],
+  preserveExactFields: [
+    "decision.options[].id",
+    "decision.options[].nextAction",
+    "userAction.resumeWith",
+    "userAction.options[].value",
+    "nextActions",
+    "decision option IDs and confirmation values"
+  ],
+  mustTellUser: ["every decision option, with no option selected by default"],
+  agentInstructions: [
+    "Wait for the user's selection, then copy only that option's exact nextAction without reconstructing arguments."
+  ]
+};
 var FORBIDDEN_DECISION_ARGUMENT_KEYS = /* @__PURE__ */ new Set([
   "credential",
   "candidatecredential",
@@ -3714,6 +3808,7 @@ function decisionToolResult(input) {
 
 ${formatDecisionFallback(decision)}`,
     data: input.data,
+    presentation: DECISION_PRESENTATION_POLICY,
     decision,
     ...userAction === void 0 ? {} : { userAction },
     nextActions
@@ -3771,6 +3866,15 @@ var severityEnum = z2.enum(["low", "medium", "high", "critical"]);
 function planCatalog() {
   return TIER_ORDER.map((p) => `${p} JPY ${tierPriceJpy(p)}/month`).join(", ");
 }
+function deploymentEnvironmentContext(apiBaseUrl) {
+  const environment = environmentFor(apiBaseUrl);
+  if (environment === "production") {
+    return `Agent context \u2014 environment: PRODUCTION (${apiBaseUrl}). Retain this fact, but do not proactively show it to the user unless asked or relevant.
+`;
+  }
+  return `IMPORTANT USER NOTICE \u2014 environment: ${environment.toUpperCase()} (${apiBaseUrl}). The user must be told prominently that this is not the normal Production environment.
+`;
+}
 var ticketCategoryEnum = z2.enum([
   "billing",
   "payment",
@@ -4021,7 +4125,7 @@ Next action: ${analysis.suggestedNextAction}`,
   server.registerTool(
     "deploy",
     {
-      description: `Deploy the local static output to Sakupa. First deploy creates a free temporary site (valid ${FREE_SITE_TTL_HOURS}h, public URL like https://${previewHostPattern}) and stores the management credential in .sakupa/site.json. Later runs update the existing site (free sites also refresh their validity; subscribed sites are permanent). Runs analyze first and refuses to upload source projects, secrets, .env files, archives, media or server code. The MCP process is locked to the current directory initialized by \`npx -y @sakupa/mcp@latest init\`; no tool argument can change that root. outputDir is a separate REQUIRED relative path supplied from the current project inspection. Never uploads anything when analysis says the project is not deployable.`,
+      description: `Deploy the local static output to Sakupa. First deploy creates a free temporary site (valid ${FREE_SITE_TTL_HOURS}h, public URL like https://${previewHostPattern}) and stores the management credential in .sakupa/site.json. Later runs update the existing site (free sites also refresh their validity; subscription-backed sites have no free-site expiry while the subscription remains active). Runs analyze first and refuses to upload source projects, secrets, .env files, archives, media or server code. The MCP process is locked to the current directory initialized by the no-argument init MCP tool; no tool argument can change that root. outputDir is a separate REQUIRED relative path supplied from the current project inspection. Never uploads anything when analysis says the project is not deployable.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
       inputSchema: {
@@ -4512,12 +4616,11 @@ Next action: ${analysis.suggestedNextAction}`,
           return text(
             "site_published",
             `Site published: ${finalized2.url}
-Environment: ${environmentFor(ctx.apiBaseUrl).toUpperCase()} (${ctx.apiBaseUrl})
-Project directory: ${ctx.projectDir}
+` + deploymentEnvironmentContext(ctx.apiBaseUrl) + `Project directory: ${ctx.projectDir}
 Files uploaded: ${uploaded2} (${finalized2.totalBytes} bytes)
 ` + (finalized2.expiresAt ? `Expires at: ${finalized2.expiresAt}
 ` : "") + `
-This is a FREE temporary preview: it stays live for ${FREE_SITE_TTL_HOURS} hours. Deploying again or calling refresh extends the validity; subscribing the site (subscribe) makes this URL permanent. The management credential was saved to .sakupa/site.json \u2014 keep that file: it is the only way to manage this site.
+This is a FREE temporary preview: it stays live for ${FREE_SITE_TTL_HOURS} hours. Deploying again or calling refresh extends the validity; while a subscription remains active, this URL stays live without the free-site expiry. The management credential was saved to .sakupa/site.json \u2014 keep that file: it is the only way to manage this site.
 ` + credentialGitReminder(ctx.projectDir) + (finalized2.warnings.length > 0 ? `
 Warnings:
 ${JSON.stringify(finalized2.warnings, null, 2)}` : ""),
@@ -4602,14 +4705,13 @@ ${JSON.stringify(finalized2.warnings, null, 2)}` : ""),
         return text(
           handoffPerformed ? "free_site_slot_reassigned" : "site_updated",
           `Site updated: ${finalized.url}
-Environment: ${environmentFor(ctx.apiBaseUrl).toUpperCase()} (${ctx.apiBaseUrl})
-Project directory: ${ctx.projectDir}
+` + deploymentEnvironmentContext(ctx.apiBaseUrl) + `Project directory: ${ctx.projectDir}
 Files uploaded: ${uploaded} (${finalized.totalBytes} bytes)
 ` + (finalized.expiresAt ? `Validity refreshed \u2014 expires at: ${finalized.expiresAt}
 ` : "") + (credentialRelocatedFrom.length > 0 ? `Credential binding relocated from ${credentialRelocatedFrom.join(", ")} to ${ctx.projectDir}/.sakupa; the existing site was preserved.
 ` : "") + (handoffPerformed ? `Site handoff completed from the authenticated device list. The existing free-site URL stayed the same, the cloud site was NOT deleted, and its content was replaced. Sakupa issued a fresh project credential and revoked ${handoffRevokedCredentials} previous credential(s), so no old project can continue managing this URL.` + (handoffCleanup?.sourceCredentialRemoved ? " A matching obsolete local site.json was removed automatically.\n" : "\n") : "") + (credentialRotationResumed ? "A previously confirmed credential rotation was resumed safely before this deploy; every older credential is revoked.\n" : "") + (finalized.mode === "free" ? `
-Reminder: free sites stay live for ${FREE_SITE_TTL_HOURS} hours after the last deploy or refresh call. Subscribing (subscribe) makes the site permanent.
-` : "\nThis site is subscribed and permanent \u2014 no expiry.\n") + (finalized.warnings.length > 0 ? `
+Reminder: free sites stay live for ${FREE_SITE_TTL_HOURS} hours after the last deploy or refresh call. While a subscription remains active, the site stays live without this free-site expiry.
+` : "\nThis site is subscription-backed and has no free-site expiry while the subscription remains active.\n") + (finalized.warnings.length > 0 ? `
 Warnings:
 ${JSON.stringify(finalized.warnings, null, 2)}` : "") + (credentialSecurity?.rotationRecommended ? `
 
@@ -4665,7 +4767,7 @@ Optional security recommendation: this management credential was created at ${cr
   server.registerTool(
     "refresh",
     {
-      description: "Refresh the validity of the free temporary site WITHOUT uploading content. Uses the local credential in .sakupa/site.json. Subscribed sites are permanent and need no refresh.",
+      description: "Refresh the validity of the free temporary site WITHOUT uploading content. Uses the local credential in .sakupa/site.json. Subscription-backed sites have no free-site expiry while the subscription remains active and need no refresh.",
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
       inputSchema: {}
@@ -4729,7 +4831,7 @@ NO content was uploaded or changed by this call \u2014 to publish new or edited
   server.registerTool(
     "subscribe",
     {
-      description: `Create a Stripe Checkout link that subscribes THIS site to a Sakupa Hosting monthly plan (${planCatalog()}). Paying makes the site PERMANENT on its ${previewHostPattern} URL \u2014 no more 24h expiry; that is the core value of paying. Binding a custom domain afterwards (bind) is an optional included extra and requires DNS control of that domain. Owner-only: requires this project's site credential (.sakupa/site.json) \u2014 deploy first. If the site outgrows its plan, Sakupa shows an over-limit notice and never changes billing automatically. The owner can explicitly choose another plan through Stripe Customer Portal. Card details are entered only on the Stripe-hosted page \u2014 never through the AI tool. Opening and completing Stripe Checkout is the final subscription confirmation.`,
+      description: `Create a Stripe Checkout link that subscribes THIS site to a Sakupa Hosting monthly plan (${planCatalog()}). While the subscription remains active, its ${previewHostPattern} URL stays live without the free 24-hour expiry. Binding a custom domain afterwards (bind) is an optional included extra and requires DNS control of that domain. Owner-only: requires this project's site credential (.sakupa/site.json) \u2014 deploy first. If the site outgrows its plan, Sakupa shows an over-limit notice and never changes billing automatically. The owner can explicitly choose another plan through Stripe Customer Portal. Card details are entered only on the Stripe-hosted page \u2014 never through the AI tool. Opening and completing Stripe Checkout is the final subscription confirmation.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
       inputSchema: {
@@ -4756,7 +4858,7 @@ NO content was uploaded or changed by this call \u2014 to publish new or edited
 ${res.checkoutUrl}
 
 Open this link in a browser to subscribe. Card data is entered only on the Stripe-hosted page \u2014 never give card numbers, passwords or security codes to the AI tool.
-Once payment confirms, the site becomes permanent on its current URL. Binding a custom domain (bind) is optional and still requires DNS verification.`,
+Once Stripe confirms payment and Sakupa synchronizes the subscription, the current URL stays live while that subscription remains active. Binding a custom domain (bind) is optional and still requires DNS verification.`,
           {
             siteId: res.siteId,
             plan: res.plan,
@@ -4775,7 +4877,7 @@ Once payment confirms, the site becomes permanent on its current URL. Binding a
   server.registerTool(
     "bind",
     {
-      description: `Bind a custom domain to this subscribed site \u2014 an OPTIONAL extra serving surface; the permanent ${previewHostPattern} URL keeps working alongside it. The binding unit is the APEX domain: binding example.com reserves routes for example.com and www.example.com, but ONLY www is required and judged for activation; the naked apex is optional because many DNS providers cannot point it. One apex TXT verification covers both, and one site binds at most ONE apex domain \u2014 a second domain needs a second subscribed site. Requires an ACTIVE subscription (subscribe). Ownership is proven ONLY by DNS control of the apex \u2014 payment never grants ownership, and bindings are ALWAYS challengeable: whoever proves CURRENT DNS control takes the domain, even from an existing binding (the displaced site keeps its subscription, content and permanent URL). Unverified requests expire after 72 hours. Call again with action "status" to check progress.`,
+      description: `Bind a custom domain to this subscribed site \u2014 an OPTIONAL extra serving surface; the subscription-backed ${previewHostPattern} URL keeps working alongside it while the subscription is active. The binding unit is the APEX domain: binding example.com reserves routes for example.com and www.example.com, but ONLY www is required and judged for activation; the naked apex is optional because many DNS providers cannot point it. One apex TXT verification covers both, and one site binds at most ONE apex domain \u2014 a second domain needs a second subscribed site. Requires an ACTIVE subscription (subscribe). Ownership is proven ONLY by DNS control of the apex \u2014 payment never grants ownership, and bindings are ALWAYS challengeable: whoever proves CURRENT DNS control takes the domain, even from an existing binding (the displaced site keeps its subscription, content and subscription-backed Sakupa URL). Unverified requests expire after 72 hours. Call again with action "status" to check progress.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
       inputSchema: {
@@ -4903,7 +5005,7 @@ When the user says the TXT is set, run bind "status". It verifies ownership and
         noteSiteMode(res.siteId, res.mode);
         const lines = [
           `AUTHORITATIVE BILLING SNAPSHOT for site ${res.siteId} (mode: ${res.mode})`,
-          res.permanentUrl ? `Permanent URL: ${res.permanentUrl}` : void 0,
+          res.permanentUrl ? `Subscription-backed Sakupa 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 === true ? `Renewal: CANCELED \u2014 the site reverts to free at ${res.cancellationEffectiveAt ?? res.currentPeriodEnd ?? "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,
@@ -5605,7 +5707,7 @@ var TOOL_MANUALS = {
   init: {
     purpose: "Initialize the active IDE workspace as one Sakupa project.",
     sideEffects: "Creates only .sakupa/project.json locally; no API call, site or charge.",
-    preconditions: "Exactly one usable MCP workspace Root. Clients without Roots use CLI init.",
+    preconditions: "Exactly one usable MCP workspace Root. If Roots are unavailable, help may authorize the AI to use CLI init.",
     parameterNames: [],
     parameters: "No parameters and no path argument.",
     warnings: [
@@ -5654,7 +5756,9 @@ var TOOL_MANUALS = {
     preconditions: "A valid local site credential.",
     parameterNames: [],
     parameters: "No parameters.",
-    warnings: ["Subscribed sites are permanent and do not need refresh."],
+    warnings: [
+      "Subscription-backed sites have no free-site expiry while the subscription remains active and do not need refresh."
+    ],
     nextStep: "Call status to verify the new expiry."
   },
   status: {
@@ -5796,7 +5900,7 @@ function registerHelpTools(server, baseCtx) {
   server.registerTool(
     "init",
     {
-      description: "Initialize the active MCP workspace Root as a Sakupa project. Takes no path argument, creates only .sakupa/project.json at that exact Root, preserves site/recovery state, makes no API call and is idempotent. Clients without MCP Roots must use the no-argument CLI init.",
+      description: "Initialize the active MCP workspace Root as a Sakupa project. Takes no path argument, creates only .sakupa/project.json at that exact Root, preserves site/recovery state, makes no API call and is idempotent. If MCP Roots are unavailable, call help; the AI may then use the no-argument CLI init itself.",
       inputSchema: {},
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
@@ -6122,14 +6226,14 @@ Workflow:
    current deployment and serving state at any time. Every update checks the credential's
    server-side issue time. When it is older than 7 days, deploy succeeds and only SUGGESTS the
    optional rotate tool; never rotate without the user's explicit confirmation.
-3. To make the site PERMANENT, subscribe it to a monthly hosting plan (plans
+3. To keep the site live beyond the free period, subscribe it to a monthly hosting plan (plans
    shows the catalog; subscribe -> Stripe-hosted checkout;
-   water/personal/share/business). Paying makes the
-   ${hostPattern} URL permanent \u2014 that is what payment buys. Usage over the chosen plan
+   water/personal/share/business). While the subscription remains active, the
+   ${hostPattern} URL stays live without the free 24-hour expiry. Usage over the chosen plan
    shows an over-limit notice by default. An external AI may periodically query usage and
    recommend a plan, but Sakupa never changes a subscription automatically.
 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
+   serving surface alongside the subscription-backed Sakupa URL. Ownership is proven only by DNS control; the
    first verified request wins; unverified requests expire after 72 hours. billing,
    change, portal and recover manage the paid lifecycle. Binding a
    NEW domain while one is live is a zero-downtime SWITCH: the old domain keeps serving
@@ -6149,13 +6253,17 @@ context, paraphrase a selection into different arguments, or invent another opti
 selects, copy that option's exact nextAction. Legacy userAction and nextActions mirror the same
 choice for older clients; decision is the authoritative choice set. A type "none" option means call
 no tool and change nothing. Stripe-hosted links remain direct links because Stripe itself owns plan
-selection and confirmation.
+selection and confirmation. Before showing any decision, infer the language the user is using and
+translate every human-readable summary, prompt, option label, description and consequence into that
+language. Keep option IDs, tool names, exact arguments, URLs, field names and confirmation values
+unchanged.
 
-Project directory contract: before the first deploy or a new recovery, initialize the intended
-project by calling init with NO path argument. init uses the IDE's exact MCP Root and creates the
-non-secret .sakupa/project.json directly there. The CLI command
-"npx -y @sakupa/mcp@latest init" remains the safe fallback for clients without MCP Roots and
-also accepts NO path argument. ONE MCP process = ONE Roots-first locked project = ONE site.
+Project directory contract: before the first deploy or a new recovery, CALL the init MCP tool with
+NO path argument. init uses the IDE's exact MCP Root and creates the non-secret
+.sakupa/project.json directly there. Do not merely print installation or CLI instructions when the
+init tool is available. Only after help confirms that the client does not provide MCP Roots may the
+AI itself use the CLI command "npx -y @sakupa/mcp@latest init" as a fallback; never ask the user to
+run it. The CLI also accepts NO path argument. ONE MCP process = ONE Roots-first locked project = ONE site.
 Site tools do not accept projectDir and cannot select another root; help, plans and report preview
 and public_recovery portal remain project-independent.
 Sakupa stores .sakupa/site.json and recovery state only in the locked directory; it never uses
@@ -6168,11 +6276,21 @@ before retrying with outputDirChangeConfirmed: true.
 After init, require sakupaAtProjectRoot=true. Before deploy, Sakupa checks every directory segment
 between the project Root and outputDir for a misplaced .sakupa and safely relocates only validated,
 non-conflicting state; never copy, delete or overwrite site.json by shell command.
-After every deploy, TELL the user which environment it went to (deploy results carry an
-Explicit Environment line: TEST vs PRODUCTION). analyze, deploy, status,
-and refresh echo
+Every result retains the exact environment for AI reasoning. Prominently tell the user when the
+environment is TEST or unknown/non-production. Do not proactively mention a normal PRODUCTION
+environment unless the user asks or the distinction is relevant to the current question. analyze,
+deploy, status, and refresh echo
 the Roots-first locked directory they acted on.
 
+Presentation contract: preserve every returned technical fact for reasoning and exact continuation,
+including paths, IDs, enums, tool names, arguments, DNS values, provider states, amounts and exact
+timestamps. Do not mechanically dump every field. Answer the user's current question first, explain
+relevant technical terms in plain language while retaining the exact term, translate human-readable
+explanations into the user's language, and always disclose material charges, deadlines, cancellation,
+replacement, credential revocation, security effects and irreversible consequences. A technical fact
+may be omitted from the immediate user-facing answer only when it is irrelevant to the current
+question; it must remain available in the tool result for follow-up.
+
 On any difficulty, call help before retrying or escalating. Only offer report when help returns
 reportRecommended:true; attach your own factual account via agentContext and show the exact
 sanitized preview before asking the user to confirm submission.
@@ -6256,10 +6374,12 @@ export {
   FetchTransport,
   HttpApiClient,
   MCP_VERSION,
+  PRODUCTION_API_BASE_URL,
   TEST_API_BASE_URL,
   analyzeProject,
   createSakupaMcpServer,
   deleteSiteFile,
+  environmentFor,
   loadMcpRuntimeConfig,
   loadSiteFile,
   registerTools,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sakupa/mcp",
-  "version": "0.7.47",
+  "version": "0.7.49",
   "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",