webcake-landing-mcp 1.3.0 → 1.4.0

package/dist/changelog.json

@@ -1,4 +1,11 @@
 [
+  {
+    "v": "1.4.0",
+    "d": "23/07/2026",
+    "type": "Changed",
+    "en": "publish_page now reuses the page's currently-attached domain when custom_domain is omitted — mirroring the editor's publish modal, a plain…",
+    "vi": "publish_page nay tự động dùng lại domain đang gắn với trang khi bỏ trống custom_domain — giống cách modal publish của editor hoạt động, gọi…"
+  },
   {
     "v": "1.3.0",
     "d": "17/07/2026",
@@ -33,12 +40,5 @@
     "type": "Added",
     "en": "create_page now sends a by_ai field in the create request body (default value \"mcp\") so the backend can stamp each MCP-generated page in its by_ai…",
     "vi": "create_page nay gửi thêm trường by_ai trong body của request tạo trang (giá trị mặc định \"mcp\") để backend có thể đánh dấu từng trang được tạo qua…"
-  },
-  {
-    "v": "1.0.83",
-    "d": "16/06/2026",
-    "type": "Added",
-    "en": "The server web guide (GET /) now includes a bilingual video guides section with per-app installation walkthrough cards (Claude, Codex, Antigravity);…",
-    "vi": "Web guide của server (GET /) nay có thêm mục video hướng dẫn cài đặt song ngữ với các card theo từng ứng dụng (Claude, Codex, Antigravity); card có…"
   }
 ]

package/dist/persistence/webcake-client.js

@@ -338,6 +338,10 @@ export async function getPageSource(config, pageId) {
         page_id: d.page_id,
         name: d.name,
         organization_id: d.organization_id ?? null,
+        // The page's currently-attached domain, when the record carries it — lets
+        // publish_page reuse it instead of dropping to a domain-less preview.
+        custom_domain: d.custom_domain ?? null,
+        custom_path: d.custom_path ?? null,
         source: d.source,
     };
 }

package/dist/tools/persistence.js

@@ -1221,12 +1221,12 @@ export function registerPersistenceTools(server, domain) {
         });
     });
     // 15) Publish page (go live) -------------------------------------------------
-    server.tool("publish_page", "Publishes an EXISTING page LIVE via the editor's publish_html route: builds the rendered app on the Webcake build host (POST <buildBase>/render/build; prod default https://build.webcake.io, override with WEBCAKE_BUILD_BASE env / x-webcake-build-base header), then creates/updates the PagePublishedV2 record — the record ALL public serving reads. With custom_domain the page goes live at that domain (it must already point at Webcake). WITHOUT a domain there is NO permanent public URL: the returned preview link (<previewBase>/preview/<page_id>) only renders for ~10 minutes after the publish, then shows 'Preview page is expired' — tell the user to attach a domain for a lasting URL. If no build host is configured or the build fails, falls back to the LEGACY source-only publish route with a warning (saves a version; nothing goes live; the page stays blank). DEFAULTS to dry_run=true (network-free: does NOT call the build host on dry_run). Needs WEBCAKE_API_BASE + WEBCAKE_JWT.", {
+    server.tool("publish_page", "Publishes an EXISTING page LIVE via the editor's publish_html route: builds the rendered app on the Webcake build host (POST <buildBase>/render/build; prod default https://build.webcake.io, override with WEBCAKE_BUILD_BASE env / x-webcake-build-base header), then creates/updates the PagePublishedV2 record — the record ALL public serving reads. With custom_domain the page goes live at that domain (it must already point at Webcake); OMIT custom_domain to reuse the page's currently-attached domain (mirrors the editor's publish modal — republishing keeps the page live at the same URL), falling back to a find_pages lookup by id. WITHOUT any domain (the page has none, or you pass custom_domain='') there is NO permanent public URL: the returned preview link (<previewBase>/preview/<page_id>) only renders for ~10 minutes after the publish, then shows 'Preview page is expired' — tell the user to attach a domain for a lasting URL. If no build host is configured or the build fails, falls back to the LEGACY source-only publish route with a warning (saves a version; nothing goes live; the page stays blank). DEFAULTS to dry_run=true (network-free: does NOT call the build host on dry_run). Needs WEBCAKE_API_BASE + WEBCAKE_JWT.", {
         page_id: z.string().describe("The page id to publish (must be owned by the account)."),
         custom_domain: z
             .string()
             .optional()
-            .describe("Optional custom domain to serve the page at (e.g. 'shop.example.com' — must already point at Webcake). Omit to publish without a domain (served at the preview-host URL)."),
+            .describe("Optional custom domain to serve the page at (e.g. 'shop.example.com' — must already point at Webcake). OMIT to reuse the page's CURRENTLY-ATTACHED domain (so republishing keeps it live at the same URL, like the editor's publish modal); if the page has none it publishes domain-less (preview-host URL). Pass an empty string '' to force a domain-less publish even when the page has a domain."),
         custom_path: z.string().optional().describe("Optional path under the custom domain (e.g. 'sale')."),
         dry_run: z.boolean().optional().describe("Default TRUE — preview the request without sending. Does NOT call the build host. Set false to actually publish (build + publish)."),
     }, { title: "Publish Webcake Page", readOnlyHint: false, destructiveHint: true, openWorldHint: true }, async ({ page_id, custom_domain, custom_path, dry_run }, extra) => {
@@ -1241,11 +1241,37 @@ export function registerPersistenceTools(server, domain) {
         if (!res.ok || res.source == null) {
             return text({ published: false, reason: "page_not_found", status: res.status, error: res.error ?? "No source on this page." });
         }
-        const opts = { customDomain: custom_domain, customPath: custom_path };
+        // Resolve the domain to publish to the way the editor's publish modal does:
+        // an explicit arg wins, otherwise reuse the page's CURRENTLY-ATTACHED domain
+        // so a plain publish_page({ page_id }) keeps the page live at the same URL
+        // instead of silently dropping to an ephemeral /preview. The page record from
+        // getPageSource carries it when the backend returns it; if not, fall back to a
+        // find_pages lookup by id (custom_path only comes from the record). Passing
+        // custom_domain:'' explicitly opts OUT (publish domain-less on purpose).
+        let effectiveDomain = custom_domain ?? res.custom_domain ?? undefined;
+        let effectivePath = custom_path ?? res.custom_path ?? undefined;
+        let domainInherited = false;
+        if (custom_domain == null && (effectiveDomain == null || effectiveDomain === "")) {
+            const found = await searchPages(config, { id: page_id, limit: 1 });
+            const row = found.pages?.find((p) => `${p.id}` === `${page_id}`) ?? found.pages?.[0];
+            if (row?.custom_domain) {
+                effectiveDomain = row.custom_domain;
+                domainInherited = true;
+            }
+        }
+        else if (custom_domain == null && effectiveDomain) {
+            domainInherited = true;
+        }
+        // Normalize an empty-string domain to "no domain" so downstream !! checks agree.
+        if (!effectiveDomain)
+            effectiveDomain = undefined;
+        const opts = { customDomain: effectiveDomain, customPath: effectivePath };
         const buildBase = config.buildBase;
         // Only the preview window serves a domain-less publish, and only briefly.
-        const previewExpiryNote = custom_domain
-            ? undefined
+        const previewExpiryNote = effectiveDomain
+            ? domainInherited
+                ? `Reused the page's attached domain (${effectiveDomain}) — pass custom_domain to override, or custom_domain:'' to publish without one.`
+                : undefined
             : "No custom_domain — the page has NO permanent public URL. The preview link only renders for ~10 minutes after the publish, then shows 'Preview page is expired'. Attach a custom_domain (already pointed at Webcake) for a lasting URL.";
         if (isDry) {
             // dry_run is network-free — do NOT call the build host.
@@ -1253,8 +1279,8 @@ export function registerPersistenceTools(server, domain) {
                 dry_run: true,
                 page_id,
                 name: res.name,
-                would_publish_to: custom_domain
-                    ? `https://${custom_domain}${custom_path ? `/${custom_path}` : ""}`
+                would_publish_to: effectiveDomain
+                    ? `https://${effectiveDomain}${effectivePath ? `/${effectivePath}` : ""}`
                     : toPreviewUrl(config, `/preview/${page_id}`),
                 build_step: buildBase
                     ? { would_run: true, build_host: buildBase, note: "Build host will be called on dry_run=false to produce rendered app/app_css, then the page is published live via the editor's publish_html route." }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-landing-mcp",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "MCP server exposing Webcake landing-page element schemas + AI usage hints, and persisting LLM-generated page sources to a Webcake backend.",
   "mcpName": "io.github.vuluu2k/webcake-landing-mcp",
   "type": "module",