@tomorrowos/sdk 0.9.69 → 0.9.71

package/VERCEL_QUESTIONS.md

@@ -1,6 +1,6 @@
 # Vercel / v0 - Verbatim question bank
 
-> **Protocol:** `vercel-questions/1.5` (pairs with `VERCEL_SETUP.md` 1.14+ / `@tomorrowos/sdk` 0.9.69+)  
+> **Protocol:** `vercel-questions/1.5` (pairs with `VERCEL_SETUP.md` 1.14+ / `@tomorrowos/sdk` 0.9.70+)  
 > **For Agents:** When asking the user a setup question, **copy-paste the block below for that step EXACTLY**.  
 > Do **not** paraphrase, reorder, rename options, or invent alternatives (no S3, no Supabase Storage, no "Blob recommended", no "disable media").  
 > After each answer, configure per `VERCEL_SETUP.md`, then paste the **next** block.  

package/VERCEL_SETUP.md

@@ -5,7 +5,7 @@
 >
 > **On Vercel, this file is the setup questionnaire** (not `REPLIT_SETUP.md`).
 >
-> Protocol id: `vercel-setup/1.14` - pairs with `@tomorrowos/sdk` **0.9.69+** (`templates/cms-starter-v0`, Fluid Functions WebSockets).
+> Protocol id: `vercel-setup/1.14` - pairs with `@tomorrowos/sdk` **0.9.70+** (`templates/cms-starter-v0`, Fluid Functions WebSockets).
 >
 > **Questions source of truth:** `VERCEL_QUESTIONS.md` - Agents must **open that file and paste each Q block verbatim**. Do not paraphrase.  
 > **Q1/Q2 = choice questions. Q3 = form only:** open **all seven optional inputs at once**, then **HARD STOP and WAIT** for submit or "skip". Never auto-skip because fields are optional. Never ask a branding choice first. Never show only Name + Primary colour. Logo = **Upload** above **Logo URL**.  
@@ -465,7 +465,7 @@ Adapt script names / process runners as needed. **Invariant:**
 
 Use the latest published `@tomorrowos/sdk` when scaffolding (do not invent versions).
 
-Add nothing extra for Blob when using `@tomorrowos/sdk@0.9.69+` (`@vercel/blob` is bundled). Only ensure `BLOB_READ_WRITE_TOKEN` + `TOMORROWOS_MEDIA=vercel-blob` when the user chooses **Vercel Blob** in Question 2.
+Add nothing extra for Blob when using `@tomorrowos/sdk@0.9.70+` (`@vercel/blob` is bundled). Only ensure `BLOB_READ_WRITE_TOKEN` + `TOMORROWOS_MEDIA=vercel-blob` when the user chooses **Vercel Blob** in Question 2.
 
 For Preview shell only, add as needed: `next`, `react`, `react-dom`, and a process runner (`concurrently` or equivalent). These must **not** become the Production CMS.
 
@@ -736,7 +736,7 @@ The SDK auto-detects these env vars.
 
 1. Set Vercel Env Var: `BLOB_READ_WRITE_TOKEN=<token>` (if not auto-injected). Prefer the Env popup when available.
 2. Set Vercel Env Var yourself (agent-owned): `TOMORROWOS_MEDIA=vercel-blob`. **Do not** ask the user to type this.
-3. Ensure `@tomorrowos/sdk@0.9.69+` is installed (`@vercel/blob` is a transitive dependency ? no project-level Blob bridge / custom `put()` middleware).
+3. Ensure `@tomorrowos/sdk@0.9.70+` is installed (`@vercel/blob` is a transitive dependency ? no project-level Blob bridge / custom `put()` middleware).
 4. The SDK **natively** uploads via Vercel Blob when the token is present (same HTTP routes as local: `/media/upload` and chunked complete). Returned asset URLs are absolute `https://*.public.blob.vercel-storage.com/...`.
 5. Confirm Control Panel **Media Server** shows provider **Blob** (not Local). Do **not** invent status copy about "Blob bridge" or paste the URL pattern as a status detail.
 6. Do **not** proceed to Question 3 until `BLOB_READ_WRITE_TOKEN` exists (or Blob is linked and token is confirmed in the Vercel dashboard).
@@ -1013,7 +1013,7 @@ Protocol complete when:
 
 ## Protocol version
 
-`vercel-setup/1.14` - pairs with `@tomorrowos/sdk` 0.9.69+ and `VERCEL_QUESTIONS.md` 1.5.
+`vercel-setup/1.14` - pairs with `@tomorrowos/sdk` 0.9.70+ and `VERCEL_QUESTIONS.md` 1.5.
 
 **Changelog 1.14:** Vercel Blob is **SDK-native** (`BLOB_READ_WRITE_TOKEN` + `TOMORROWOS_MEDIA=vercel-blob`). No project Blob bridge. Status providers use display names (Neon, Supabase, Blob, Cloudinary, Replit Object Storage). Forbidden marketing status copy about blob URL patterns.
 

package/dist/cli.js

@@ -85,6 +85,7 @@ function copyStarter(destDir, force, hosting) {
     console.log(`[tomorrowos] Template: ${templateName} (--hosting ${hosting})`);
     console.log(`[tomorrowos] @tomorrowos/sdk dependency: ^${sdkVer}`);
     console.log(`[tomorrowos] Initialized SQLite database: ${dbPath}`);
+    console.log(`[tomorrowos] Env template: ${path.join(resolved, ".env.example")}`);
     if (hosting === "replit") {
         console.log("Next: npm install, then npm start (see REPLIT_SETUP.md on Replit)");
     }
@@ -102,10 +103,12 @@ function parseHostingFlag(argv) {
 }
 function cmdBuild(argv) {
     const platformIdx = argv.indexOf("--platform");
-    const platform = platformIdx >= 0 && argv[platformIdx + 1] ? argv[platformIdx + 1] : "tizen";
-    console.log(`[tomorrowos] Player packaging for "${platform}" is not bundled in @tomorrowos/sdk yet.`);
-    console.log("Use your TomorrowOS player repository (assemble Web app + config), then run the platform SDK (e.g. Tizen CLI tizen package) from the build output directory.");
-    process.exitCode = 0;
+    const platform = platformIdx >= 0 && argv[platformIdx + 1] ? argv[platformIdx + 1] : "(unspecified)";
+    console.error(`[tomorrowos] "tomorrowos build" does not package players. No file was produced for platform "${platform}".`);
+    console.error("Download a verified prebuilt player from your running Control Panel (Download Players), or from the player repositories.");
+    console.error("Tizen: Control Panel → Download Players → Samsung (or https://tmr.sh/app/tizen/). BrightSign: Control Panel → Download Players → BrightSign (GET /players/brightsign.zip).");
+    console.error("See PLAYER_INSTALL.md for install and pairing steps.");
+    process.exit(1);
 }
 function optionValue(argv, name) {
     const withEquals = `${name}=`;
@@ -194,7 +197,6 @@ function printHelp() {
 Usage:
   tomorrowos init [directory]     Copy cms-starter template (default: Replit / Railway)
   tomorrowos migrate [options]    Migrate TomorrowOS data between supported databases
-  tomorrowos build --platform …   Placeholder; player packaging lives in the player repo
 
 Options:
   --hosting replit|v0|vercel      init template: replit (default) or Vercel/v0 (cms-starter-v0)
@@ -205,6 +207,8 @@ Examples:
   npx @tomorrowos/sdk@latest init ./my-cms --hosting replit
   npx @tomorrowos/sdk@latest init ./my-cms --hosting v0
   npx @tomorrowos/sdk@latest migrate --from sqlite --from-sqlite ./data/tomorrowos.db --to supabase --to-database-url "$DATABASE_URL"
+
+Player packages are not built by this CLI. Use Control Panel → Download Players, or see PLAYER_INSTALL.md.
 `);
 }
 function printMigrateHelp() {

package/dist/playlist-catalog.d.ts

@@ -8,9 +8,6 @@ export interface SavePlaylistInput {
 export interface BuiltDevicePolicy {
     policy: {
         playlists: PublishedPlaylistSnapshot[];
-        fallback: {
-            type: "brand";
-        };
         revision?: number;
         syncMode?: "latest" | "snapshot";
     };

package/dist/playlist-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playlist-catalog.d.ts","sourceRoot":"","sources":["../src/playlist-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,SAAS,EAAE,yBAAyB,EAAE,CAAC;QACvC,QAAQ,EAAE;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyDD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1C,6BAA6B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8B/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcnD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAIhC,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAiEvB,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAO7B,mFAAmF;IAC7E,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKjF;;;OAGG;IACG,+BAA+B,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IA4BrD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAKf,0BAA0B;IAgCxC,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}
+{"version":3,"file":"playlist-catalog.d.ts","sourceRoot":"","sources":["../src/playlist-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,SAAS,EAAE,yBAAyB,EAAE,CAAC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyDD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1C,6BAA6B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8B/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcnD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAIhC,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAiEvB,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAO7B,mFAAmF;IAC7E,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKjF;;;OAGG;IACG,+BAA+B,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IA4BrD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAKf,0BAA0B;IA+BxC,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}

package/dist/playlist-catalog.js

@@ -219,7 +219,6 @@ export class PlaylistCatalog {
         return {
             policy: {
                 playlists,
-                fallback: { type: "brand" },
                 revision: Date.now(),
                 syncMode: useLatest ? "latest" : "snapshot"
             }

package/dist/tomorrowos.js

@@ -1663,7 +1663,7 @@ export class TomorrowOS extends EventEmitter {
         return this.getLegacyDeviceScreenshot(deviceId);
     }
     async captureDeviceScreenshot(deviceId) {
-        const result = await this.sendDeviceCommand(deviceId, "device.captureScreen", {});
+        const result = await this.sendDeviceCommand(deviceId, "device.telemetry.captureScreen", {});
         if (result.status === "failed") {
             throw new Error(String(result.error ?? "Screenshot failed"));
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.9.69",
-  "description": "TomorrowOS CMS server SDK - WebSocket transport, pairing, device commands, optional static CMS UI. Includes CLI (tomorrowos init / build) and starter templates.",
+  "version": "0.9.71",
+  "description": "Server SDK for building and self-hosting digital signage CMS products with TomorrowOS players.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -32,7 +32,7 @@
     "prepublishOnly": "npm run build"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "dependencies": {
     "@replit/object-storage": "^1.0.0",

package/templates/cms-starter/.env.example

@@ -0,0 +1,19 @@
+# Default: SQLite.
+# TOMORROWOS_STORE=sqlite
+# TOMORROWOS_DB_PATH=./data/tomorrowos.db
+
+# Supabase/Postgres.
+# On Replit use SUPABASE_URL — DATABASE_URL is often a reserved Secret.
+# TOMORROWOS_STORE=supabase
+# SUPABASE_URL=postgresql://postgres:[PASSWORD]@[HOST]:5432/postgres
+# DATABASE_SSL=true
+# DATABASE_URL=postgresql://...   # optional fallback outside Replit
+
+# Optional: upload media to Cloudinary instead of local / Object Storage.
+# CLOUDINARY_CLOUD_NAME=
+# CLOUDINARY_API_KEY=
+# CLOUDINARY_API_SECRET=
+# CLOUDINARY_FOLDER=tomorrowos
+
+# Optional: override the default deterministic pairing-code secret.
+# PAIRING_CODE_SECRET=

package/templates/cms-starter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-cms",
-  "version": "0.9.69",
+  "version": "0.9.71",
   "description": "CMS server on @tomorrowos/sdk. Add your UI (React, static files, etc.) alongside this server.",
   "private": true,
   "type": "module",
@@ -9,11 +9,10 @@
   },
   "scripts": {
     "dev": "tsx watch server.ts",
-    "start": "tsx server.ts",
-    "build-player": "tomorrowos build --platform tizen"
+    "start": "tsx server.ts"
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.9.69",
+    "@tomorrowos/sdk": "^0.9.71",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.0"
   },

package/templates/cms-starter/policy.example.json

@@ -23,7 +23,6 @@
           }
         ]
       }
-    ],
-    "fallback": { "type": "brand" }
+    ]
   }
 }

package/templates/cms-starter/public/index.html

@@ -231,11 +231,15 @@
         <p class="hint">Current installed SDK version:</p>
         <p class="update-sdk-version" id="updateSdkVersionLabel">Loading…</p>
         <p class="hint">
-          To upgrade on AI agent platforms (Replit, Vercel, etc.), paste this prompt into the Agent chat:
+          To upgrade on AI agent platforms, paste the matching prompt into the Agent chat:
         </p>
-        <pre class="update-sdk-prompt" id="updateSdkPromptText">Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
+        <p class="update-sdk-prompt-label">Replit</p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptReplit">Follow NPM package @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
+        <p class="update-sdk-prompt-label">Vercel</p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptVercel">Follow NPM package @tomorrowos/sdk VERCEL_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
         <div class="modal-actions update-sdk-modal-actions">
-          <button type="button" id="copyUpdateSdkPromptBtn" class="primary">Copy prompt</button>
+          <button type="button" id="copyUpdateSdkPromptReplitBtn" class="primary">Copy Replit prompt</button>
+          <button type="button" id="copyUpdateSdkPromptVercelBtn" class="primary">Copy Vercel prompt</button>
           <button type="button" data-close-update-sdk-modal="1">Close</button>
         </div>
       </div>

package/templates/cms-starter/public/methods.js

@@ -33,8 +33,10 @@ let cachedSdkVersion = "";
 /** @type {number|null} CMS server boot time (ms) from GET /devices. */
 let serverStartedAtMs = null;
 
-const UPDATE_SDK_PROMPT =
-  "Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
+const UPDATE_SDK_PROMPT_REPLIT =
+  "Follow NPM package @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
+const UPDATE_SDK_PROMPT_VERCEL =
+  "Follow NPM package @tomorrowos/sdk VERCEL_UPGRADE.md to upgrade my CMS with the latest SDK.";
 /** @type {ReturnType<typeof setTimeout>|null} */
 let reconnectGraceTimer = null;
 let uploadQueue = [];
@@ -2364,8 +2366,10 @@ function setUpdateSdkVersionLabel(version) {
 
 async function openUpdateSdkModal() {
   const modal = document.getElementById("updateSdkModal");
-  const promptEl = document.getElementById("updateSdkPromptText");
-  if (promptEl) promptEl.textContent = UPDATE_SDK_PROMPT;
+  const replitEl = document.getElementById("updateSdkPromptReplit");
+  const vercelEl = document.getElementById("updateSdkPromptVercel");
+  if (replitEl) replitEl.textContent = UPDATE_SDK_PROMPT_REPLIT;
+  if (vercelEl) vercelEl.textContent = UPDATE_SDK_PROMPT_VERCEL;
   setUpdateSdkVersionLabel(cachedSdkVersion || "Loading…");
   modal?.classList.remove("hidden");
 
@@ -2379,18 +2383,21 @@ function closeUpdateSdkModal() {
   document.getElementById("updateSdkModal")?.classList.add("hidden");
 }
 
-async function copyUpdateSdkPrompt() {
+async function copyUpdateSdkPrompt(which) {
+  const isVercel = which === "vercel";
   const text =
-    document.getElementById("updateSdkPromptText")?.textContent?.trim() ||
-    UPDATE_SDK_PROMPT;
+    document.getElementById(isVercel ? "updateSdkPromptVercel" : "updateSdkPromptReplit")
+      ?.textContent?.trim() ||
+    (isVercel ? UPDATE_SDK_PROMPT_VERCEL : UPDATE_SDK_PROMPT_REPLIT);
+  const btnId = isVercel ? "copyUpdateSdkPromptVercelBtn" : "copyUpdateSdkPromptReplitBtn";
   try {
     await navigator.clipboard.writeText(text);
-    const btn = document.getElementById("copyUpdateSdkPromptBtn");
+    const btn = document.getElementById(btnId);
     if (btn) {
       const prev = btn.textContent;
       btn.textContent = "Copied";
       setTimeout(() => {
-        btn.textContent = prev || "Copy prompt";
+        btn.textContent = prev || (isVercel ? "Copy Vercel prompt" : "Copy Replit prompt");
       }, 1200);
     }
   } catch {
@@ -2679,8 +2686,11 @@ document.addEventListener("DOMContentLoaded", () => {
     el.addEventListener("click", closeUpdateSdkModal);
   });
   document
-    .getElementById("copyUpdateSdkPromptBtn")
-    ?.addEventListener("click", () => void copyUpdateSdkPrompt());
+    .getElementById("copyUpdateSdkPromptReplitBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt("replit"));
+  document
+    .getElementById("copyUpdateSdkPromptVercelBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt("vercel"));
 
   document.getElementById("addAssetBtn")?.addEventListener("click", () => {
     if (uploadInProgress) return;

package/templates/cms-starter/public/panel.css

@@ -1034,6 +1034,14 @@ button.danger {
   color: #0a0908;
 }
 
+.update-sdk-prompt-label {
+  margin: 0.85rem 0 0.35rem;
+  font-size: 0.8rem;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  color: #5d554d;
+}
+
 .update-sdk-prompt {
   margin: 0;
   padding: 0.75rem 0.85rem;
@@ -1049,6 +1057,8 @@ button.danger {
 
 .update-sdk-modal-actions {
   justify-content: flex-end;
+  flex-wrap: wrap;
+  gap: 0.5rem;
 }
 
 .download-players-modal-card {

package/templates/cms-starter-v0/.env.example

@@ -0,0 +1,19 @@
+# Default: SQLite.
+# TOMORROWOS_STORE=sqlite
+# TOMORROWOS_DB_PATH=./data/tomorrowos.db
+
+# Supabase/Postgres.
+# On Replit use SUPABASE_URL — DATABASE_URL is often a reserved Secret.
+# TOMORROWOS_STORE=supabase
+# SUPABASE_URL=postgresql://postgres:[PASSWORD]@[HOST]:5432/postgres
+# DATABASE_SSL=true
+# DATABASE_URL=postgresql://...   # optional fallback outside Replit
+
+# Optional: upload media to Cloudinary instead of local / Object Storage.
+# CLOUDINARY_CLOUD_NAME=
+# CLOUDINARY_API_KEY=
+# CLOUDINARY_API_SECRET=
+# CLOUDINARY_FOLDER=tomorrowos
+
+# Optional: override the default deterministic pairing-code secret.
+# PAIRING_CODE_SECRET=

package/templates/cms-starter-v0/cms-panel/index.html

@@ -231,11 +231,15 @@
         <p class="hint">Current installed SDK version:</p>
         <p class="update-sdk-version" id="updateSdkVersionLabel">Loading…</p>
         <p class="hint">
-          To upgrade on AI agent platforms (Replit, Vercel, etc.), paste this prompt into the Agent chat:
+          To upgrade on AI agent platforms, paste the matching prompt into the Agent chat:
         </p>
-        <pre class="update-sdk-prompt" id="updateSdkPromptText">Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
+        <p class="update-sdk-prompt-label">Replit</p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptReplit">Follow NPM package @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
+        <p class="update-sdk-prompt-label">Vercel</p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptVercel">Follow NPM package @tomorrowos/sdk VERCEL_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
         <div class="modal-actions update-sdk-modal-actions">
-          <button type="button" id="copyUpdateSdkPromptBtn" class="primary">Copy prompt</button>
+          <button type="button" id="copyUpdateSdkPromptReplitBtn" class="primary">Copy Replit prompt</button>
+          <button type="button" id="copyUpdateSdkPromptVercelBtn" class="primary">Copy Vercel prompt</button>
           <button type="button" data-close-update-sdk-modal="1">Close</button>
         </div>
       </div>

package/templates/cms-starter-v0/cms-panel/methods.js

@@ -33,8 +33,10 @@ let cachedSdkVersion = "";
 /** @type {number|null} CMS server boot time (ms) from GET /devices. */
 let serverStartedAtMs = null;
 
-const UPDATE_SDK_PROMPT =
-  "Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
+const UPDATE_SDK_PROMPT_REPLIT =
+  "Follow NPM package @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
+const UPDATE_SDK_PROMPT_VERCEL =
+  "Follow NPM package @tomorrowos/sdk VERCEL_UPGRADE.md to upgrade my CMS with the latest SDK.";
 /** @type {ReturnType<typeof setTimeout>|null} */
 let reconnectGraceTimer = null;
 let uploadQueue = [];
@@ -2364,8 +2366,10 @@ function setUpdateSdkVersionLabel(version) {
 
 async function openUpdateSdkModal() {
   const modal = document.getElementById("updateSdkModal");
-  const promptEl = document.getElementById("updateSdkPromptText");
-  if (promptEl) promptEl.textContent = UPDATE_SDK_PROMPT;
+  const replitEl = document.getElementById("updateSdkPromptReplit");
+  const vercelEl = document.getElementById("updateSdkPromptVercel");
+  if (replitEl) replitEl.textContent = UPDATE_SDK_PROMPT_REPLIT;
+  if (vercelEl) vercelEl.textContent = UPDATE_SDK_PROMPT_VERCEL;
   setUpdateSdkVersionLabel(cachedSdkVersion || "Loading…");
   modal?.classList.remove("hidden");
 
@@ -2379,18 +2383,21 @@ function closeUpdateSdkModal() {
   document.getElementById("updateSdkModal")?.classList.add("hidden");
 }
 
-async function copyUpdateSdkPrompt() {
+async function copyUpdateSdkPrompt(which) {
+  const isVercel = which === "vercel";
   const text =
-    document.getElementById("updateSdkPromptText")?.textContent?.trim() ||
-    UPDATE_SDK_PROMPT;
+    document.getElementById(isVercel ? "updateSdkPromptVercel" : "updateSdkPromptReplit")
+      ?.textContent?.trim() ||
+    (isVercel ? UPDATE_SDK_PROMPT_VERCEL : UPDATE_SDK_PROMPT_REPLIT);
+  const btnId = isVercel ? "copyUpdateSdkPromptVercelBtn" : "copyUpdateSdkPromptReplitBtn";
   try {
     await navigator.clipboard.writeText(text);
-    const btn = document.getElementById("copyUpdateSdkPromptBtn");
+    const btn = document.getElementById(btnId);
     if (btn) {
       const prev = btn.textContent;
       btn.textContent = "Copied";
       setTimeout(() => {
-        btn.textContent = prev || "Copy prompt";
+        btn.textContent = prev || (isVercel ? "Copy Vercel prompt" : "Copy Replit prompt");
       }, 1200);
     }
   } catch {
@@ -2679,8 +2686,11 @@ document.addEventListener("DOMContentLoaded", () => {
     el.addEventListener("click", closeUpdateSdkModal);
   });
   document
-    .getElementById("copyUpdateSdkPromptBtn")
-    ?.addEventListener("click", () => void copyUpdateSdkPrompt());
+    .getElementById("copyUpdateSdkPromptReplitBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt("replit"));
+  document
+    .getElementById("copyUpdateSdkPromptVercelBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt("vercel"));
 
   document.getElementById("addAssetBtn")?.addEventListener("click", () => {
     if (uploadInProgress) return;

package/templates/cms-starter-v0/cms-panel/panel.css

@@ -1034,6 +1034,14 @@ button.danger {
   color: #0a0908;
 }
 
+.update-sdk-prompt-label {
+  margin: 0.85rem 0 0.35rem;
+  font-size: 0.8rem;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  color: #5d554d;
+}
+
 .update-sdk-prompt {
   margin: 0;
   padding: 0.75rem 0.85rem;
@@ -1049,6 +1057,8 @@ button.danger {
 
 .update-sdk-modal-actions {
   justify-content: flex-end;
+  flex-wrap: wrap;
+  gap: 0.5rem;
 }
 
 .download-players-modal-card {

package/templates/cms-starter-v0/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-cms",
-  "version": "0.9.69",
+  "version": "0.9.71",
   "description": "TomorrowOS CMS for Vercel / v0 Publish (Fluid Function + WebSockets + optional Next Preview).",
   "private": true,
   "type": "module",
@@ -13,11 +13,10 @@
     "dev:next": "cd preview && next dev -p 3000",
     "dev:preview": "concurrently -k \"npm:dev:tomorrowos\" \"npm:dev:next\"",
     "start": "tsx server.ts",
-    "build": "node -e \"process.exit(0)\"",
-    "build-player": "tomorrowos build --platform tizen"
+    "build": "node -e \"process.exit(0)\""
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.9.69",
+    "@tomorrowos/sdk": "^0.9.71",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.0"
   },

package/templates/cms-starter-v0/policy.example.json

@@ -23,7 +23,6 @@
           }
         ]
       }
-    ],
-    "fallback": { "type": "brand" }
+    ]
   }
 }