brewpage-mcp 1.8.0 → 1.9.0

package/README.md

@@ -12,7 +12,7 @@ MCP server for [BrewPage](https://brewpage.app) -- publish and manage HTML, KV,
 ## Quick Start
 
 ```bash
-npx -y brewpage-mcp@1.8.0
+npx -y brewpage-mcp@1.9.0
 ```
 
 Requires Node.js 20 or newer. This starts the stdio server for an MCP client.
@@ -28,7 +28,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.8.0"]
+      "args": ["-y", "brewpage-mcp@1.9.0"]
     }
   }
 }
@@ -39,7 +39,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 Register a project-scoped stdio server:
 
 ```bash
-claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.8.0
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.9.0
 ```
 
 This writes `.mcp.json` in the project root. Use `--scope user` for user-scoped registration. See the [official Claude Code MCP guide](https://code.claude.com/docs/en/mcp).
@@ -53,7 +53,7 @@ Open **Settings > MCP** and add:
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.8.0"]
+      "args": ["-y", "brewpage-mcp@1.9.0"]
     }
   }
 }
@@ -67,7 +67,7 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.8.0"]
+    "args": ["-y", "brewpage-mcp@1.9.0"]
   }
 }
 ```
@@ -75,7 +75,7 @@ Open the Cline MCP settings panel and add:
 ### Global Install
 
 ```bash
-npm install -g brewpage-mcp@1.8.0
+npm install -g brewpage-mcp@1.9.0
 brewpage-mcp
 ```
 
@@ -108,6 +108,8 @@ For a fresh publication, sites and non-public namespaces require Dedicated subdo
 
 Responses use the server's primary `link` verbatim, including the root slash, and expose `routingCohort`, actual/requested/effective modes, `deliveryModeMatched`, `modeLocked`, `hostingVersion`, access and the trusted-apex `managementLink` when present. Never reconstruct a host from namespace or ID. NEW password links are clean URLs: do not add `?p=`; browser readers unlock through the trusted gateway. Owner tokens and API calls stay on the configured apex API origin.
 
+When `deliveryMode` is omitted for a `public` HTML or Markdown page, the server may publish it on its own subdomain if the page needs browser features a BrewPage link does not provide. `publish_html` then prints `deliveryModeReason: "auto:<codes>"` and a `Delivery notice:` line with the server's explanation; pass `deliveryMode: "path"` to keep a BrewPage link, or change it later with `update_hosting`. `advisory:<codes>` (from `publish_html` or `update_html`) means the address was not changed but such features were found. Codes are comma-separated, drawn from `storage`, `cookies`, `history`, `downloads`, `top-navigation`, `media-capture`, `pointer-lock`, `embeds`, `fullscreen`. Neither line appears when nothing applies.
+
 An existing deduplication winner keeps its actual URL, cohort and mode, even when another mode was requested. OLD publications display **Existing link**, with null mode metadata; their legacy links and behavior remain unchanged. Ordinary content updates and site republishing preserve hosting. An eligible NEW public non-site may change mode separately with `update_hosting`.
 
 ### Hosting
@@ -130,6 +132,8 @@ Publish HTML or Markdown content to BrewPage. Returns a public URL and owner tok
 
 Parameters: `content` (string), `format` (`HTML` | `MARKDOWN`, default `HTML`), `namespace` (optional -- **omit for unlisted content**; pass `public` only for gallery/search eligibility, except when password-protected), `password` (optional), `ttlDays` (1--30, default 15), `filename` (optional, used as title fallback), `showTopBar` (optional boolean -- adds a toolbar with filename, Download button, and theme toggle), `deliveryMode` (optional).
 
+The result includes `deliveryModeReason` and a `Delivery notice:` line when the server returns them (see above).
+
 Example prompt that invokes this tool:
 
 > "Save this HTML report so I can share the link with my team."
@@ -146,6 +150,8 @@ Update an existing HTML or Markdown page in place, preserving its short URL. Req
 
 Parameters: `namespace` (string), `id` (string), `content` (string, the new body), `ownerToken` (string), `format` (optional HTML/Markdown alias or supported code language such as `json`, `yaml`, or `typescript`; omitted preserves the stored format).
 
+An update never changes the link or delivery mode; an advisory `deliveryModeReason` and `Delivery notice:` line are printed when the server returns them.
+
 Example prompt:
 
 > "Fix the typo in the report I published earlier -- same link."

package/dist/index.js

@@ -5,7 +5,7 @@ import { z } from "zod";
 const BASE_URL = process.env.BREWPAGE_URL || "https://brewpage.app";
 const server = new McpServer({
     name: "brewpage-mcp",
-    version: "1.8.0",
+    version: "1.9.0",
 });
 const PUBLIC_NAMESPACE = "public";
 /**
@@ -47,6 +47,17 @@ function hostingResponseLines(data) {
         lines.push("Hosting: Existing link");
     if (data.deliveryModeMatched === false)
         lines.push("Requested hosting differs from the existing winner; its URL and mode were preserved.");
+    lines.push(...deliveryReasonLines(data));
+    return lines;
+}
+/** Optional HTML create/update fields: why the delivery mode was chosen or flagged. */
+function deliveryReasonLines(data) {
+    const { deliveryModeReason: reason, deliveryNotice: notice } = data;
+    const lines = [];
+    if (typeof reason === "string" && reason.length > 0)
+        lines.push(`deliveryModeReason: ${JSON.stringify(reason)}`);
+    if (typeof notice === "string" && notice.length > 0)
+        lines.push(`Delivery notice: ${notice}`);
     return lines;
 }
 async function apiRequest(method, path, body, headers, responseType = "json") {
@@ -97,7 +108,9 @@ function formatUpdateResponse(data) {
     lines.push(...hostingResponseLines(data));
     return lines.join("\n");
 }
-server.tool("publish_html", "Publish HTML or Markdown content to BrewPage. Returns a public URL and owner token. Supports password protection, custom TTL, optional filename, and an opt-in top toolbar (showTopBar).", {
+server.tool("publish_html", "Publish HTML or Markdown content to BrewPage. Returns a public URL and owner token. Supports password protection, custom TTL, optional filename, and an opt-in top toolbar (showTopBar). " +
+    "When deliveryMode is omitted for a `public` page, the server may publish it on its own subdomain if the page needs browser features a BrewPage link does not provide; " +
+    "the result then includes deliveryModeReason and a delivery notice. Always share the returned URL.", {
     content: z.string().describe("HTML or Markdown content to publish"),
     deliveryMode: DELIVERY_MODE_SCHEMA,
     format: z
@@ -567,7 +580,8 @@ server.tool("republish_site", "Republish (full-replace) an existing multi-file B
         content: [{ type: "text", text: lines.join("\n") }],
     };
 });
-server.tool("update_html", "Update an existing BrewPage HTML/Markdown page. Requires owner token. Returns the updated page metadata.", {
+server.tool("update_html", "Update an existing BrewPage HTML/Markdown page. Requires owner token. Returns the updated page metadata. " +
+    "The link and delivery mode never change on update; an advisory deliveryModeReason and delivery notice are included when the new content uses browser features that may not work fully on a BrewPage link.", {
     namespace: z.string().describe("Page namespace"),
     id: z.string().describe("Page ID"),
     content: z.string().describe("New HTML or Markdown content"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brewpage-mcp",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "mcpName": "io.github.kochetkov-ma/brewpage-mcp",
   "description": "MCP server for BrewPage — publish and manage HTML, KV, JSON, and file content from AI assistants",
   "type": "module",