frontpage-host 0.3.12 → 0.3.14

package/AGENTS.md

@@ -298,4 +298,20 @@ For a manual group, `groups.people` accepts `availability: "all" | "available" |
 
 Complete Store edits: use existing items update --file with changed fields and variantUpdates. stock requires expectedStock from a fresh items get. One transaction saves all changes or none. On 409 review current stock; never silently substitute it. firstVariant plus optionNames enables versions. Keep explicit stock/variant commands for single operations. Routines add accepts --request-id UUID; reuse that ID and exact schedule after a lost response. Ordinary form edits live only in the active task; Cancel keeps input, Discard loses unfinished input. Submitted payments, imports, builds, and API-key status are separate operations.
 
-Template history (frontpage-host 0.3.11+): read `mail template get ID` before editing. `mail template history ID --limit 20 --cursor CURSOR` pages saved copies; `mail template history-get ID --history-id COPY_ID` fetches full content. Edit any copy, then `mail template set ID --file content.json` with the stable template ID and content fields only to make a new latest copy. Last template save wins; past copies remain. Campaign and series conflict checks remain. Retry uncertain saves through `mail save` with the same requestKey and exact payload. History begins with content retained at launch; earlier overwritten edits are unavailable. See MAIL.md.
+Template history (frontpage-host 0.3.11+): read `mail template get ID` before editing. `mail template history ID --limit 20 --cursor CURSOR` pages saved copies; `mail template history-get ID --history-id COPY_ID` fetches full content. Edit any copy, then `mail template set ID --file content.json` with the stable template ID and content fields only to make a new latest copy. Last template save wins; past copies remain. Campaign and series conflict checks remain. Retry uncertain saves through `mail save` with the same requestKey and exact payload. History begins with content retained at launch; earlier overwritten edits are unavailable. History reads use the plan’s Rewind window and always include Latest, even when older. Older copies stay stored; lists and direct reads apply the same limit. Window metadata explains the limit and whether older copies exist. See MAIL.md.
+
+## Uploaded video preparation
+
+The current CLI attempts browser-compatible H.264 MP4 preparation after a local video
+upload. This applies to `frontpage media upload` and `frontpage prompt --attach ./clip.mov`.
+Use the returned `sitePath`; do not reconstruct a path from the original filename.
+A successful conversion returns `prepared:true` and the MP4's actual filename, size and
+URL. If preparation fails, the original remains usable as an upload with `prepared:false`
+and a compatibility warning. Warnings print on stderr and appear in JSON success data.
+An original's MP4/MOV extension does not establish browser compatibility.
+
+`frontpage media list` and the website agent's `list_site_assets` prefer a completed
+prepared copy over its exact original. Different uploads with the same display name
+remain distinct. Existing URLs and published videos are not converted automatically.
+Upgrade the CLI to receive upload-time preparation. Source path and access denials
+remain errors; they do not become original-file fallback successes.

package/MAIL.md

@@ -44,9 +44,11 @@ frontpage mail template history TEMPLATE_ID --cursor NEXT_CURSOR --site YOUR_SIT
 frontpage mail template history-get TEMPLATE_ID --history-id SAVED_COPY_ID --site YOUR_SITE --json
 ```
 
-History returns `items` (ID, savedAt, name, subject), `currentId` and `nextCursor`. Fetch the next page until `nextCursor` is null. The default page size is 20, with a maximum of 100. `history-get` returns `copy` with full content and `templateId`, the stable ID. The workspace shows the same history under Sender; scrolling loads the next 20 copies.
+History returns `items` (ID, savedAt, name, subject), `currentId`, `nextCursor`, `windowDays`, `unlimited`, `canUpgrade` and `moreBeyondWindow`. The last field reports hidden older copies when the final page is reached. Fetch the next page until `nextCursor` is null. The default page size is 20, with a maximum of 100. `history-get` returns `copy` with full content and `templateId`, the stable ID. The workspace shows the same history under Sender; scrolling loads the next 20 copies.
 
-To use an old copy, fetch it, edit it if needed, then save normally. Put only `name`, `subject`, `preheader`, `blocks` and `variables` in a JSON file, then run `frontpage mail template set TEMPLATE_ID --file content.json --site YOUR_SITE --json`. Use the stable TEMPLATE_ID, never the saved-copy ID. This creates a new latest copy; it does not change the old one. There is no separate restore command. Read `template get` before each edit so you start with current work. For response-loss retries use `mail save` with one unchanged `requestKey` and payload; replaying that save creates no duplicate copy.
+Template history reads follow the site plan’s Rewind window: Starter 7 days, Growth 30 days, Scale 90 days; Enterprise and Internal use the existing uncapped history rule. Latest remains readable at any age. Older copies stay stored and become readable again within a larger window after an upgrade. Both history lists and history-get enforce the window; direct saved-copy IDs do not bypass it. Existing feature and CLI plan gates still apply.
+
+To use an available old copy, fetch it, edit it if needed, then save normally. Put only `name`, `subject`, `preheader`, `blocks` and `variables` in a JSON file, then run `frontpage mail template set TEMPLATE_ID --file content.json --site YOUR_SITE --json`. Use the stable TEMPLATE_ID, never the saved-copy ID. This creates a new latest copy; it does not change the old one. There is no separate restore command. Read `template get` before each edit so you start with current work. For response-loss retries use `mail save` with one unchanged `requestKey` and payload; replaying that save creates no duplicate copy.
 
 Public API reads: `GET /api/v1/sites/SLUG/mail/templates/TEMPLATE_ID/history?limit=20&cursor=…` and `GET /api/v1/sites/SLUG/mail/templates/TEMPLATE_ID/history/SAVED_COPY_ID`. Viewers may read; editors and owners may save. Site access and plan checks still apply.
 

package/PEOPLE.md

@@ -788,4 +788,4 @@ Writes are not universally idempotent. Preserve documented request keys, receipt
 
 For MCP CSV exports, continue `contacts.export` with `textOffset` set to `textPage.nextOffset` and `expectedTextVersion` set to `textPage.version`. The tool returns bounded `csv` text and a version hash; a changed export returns a conflict instead of combining different snapshots. `textLength` defaults to 4,000 UTF-16 units and accepts up to 8,000.
 
-Template history uses the existing Email tools. Read get_mail_template before editing. list_mail_template_history({id,cursor?,limit?}) pages copies; get_mail_template_history({id,historyId}) reads full content. Edit any copy and save through update_mail_template with the stable ID to make it latest. Both simultaneous saves remain; last template save wins. Group, rule and series checks remain. CLI equivalents and full instructions: MAIL.md, Template history.
+Template history uses the existing Email tools. Read get_mail_template before editing. list_mail_template_history({id,cursor?,limit?}) pages copies; get_mail_template_history({id,historyId}) reads full content. Edit any copy and save through update_mail_template with the stable ID to make it latest. Both simultaneous saves remain; last template save wins. Group, rule and series checks remain. History lists and direct reads follow the plan’s Rewind window, plus Latest at any age. Older copies stay stored. CLI equivalents and full instructions: MAIL.md, Template history.

package/README.md

@@ -122,3 +122,19 @@ GPT 6 Luna is the default for new website runs. Explicit site model preferences
 ### Template history
 
 Template history (0.3.11+): `frontpage mail template history ID` lists saved copies; `history-get ID --history-id COPY_ID` reads full content. Edit any copy and save with `template set ID --file content.json` to make it latest. Use the stable template ID, read current content before editing, and see [MAIL.md](./MAIL.md#template-history) for paging, access and retry-safe saves.
+
+## Uploaded video preparation
+
+The current CLI attempts browser-compatible H.264 MP4 preparation after a local video
+upload. This applies to `frontpage media upload` and `frontpage prompt --attach ./clip.mov`.
+Use the returned `sitePath`; do not reconstruct a path from the original filename.
+A successful conversion returns `prepared:true` and the MP4's actual filename, size and
+URL. If preparation fails, the original remains usable as an upload with `prepared:false`
+and a compatibility warning. Warnings print on stderr and appear in JSON success data.
+An original's MP4/MOV extension does not establish browser compatibility.
+
+`frontpage media list` and the website agent's `list_site_assets` prefer a completed
+prepared copy over its exact original. Different uploads with the same display name
+remain distinct. Existing URLs and published videos are not converted automatically.
+Upgrade the CLI to receive upload-time preparation. Source path and access denials
+remain errors; they do not become original-file fallback successes.

package/dist/commands/prompt-attach.d.ts

@@ -23,6 +23,7 @@ export type PromptAttachmentsPayload = {
         url: string;
         name?: string;
         sizeBytes?: number;
+        warning?: string;
     }>;
 };
 export type MediaUploadResult = UploadedMedia;

package/dist/commands/prompt-attach.js

@@ -101,8 +101,9 @@ export function addUploadResult(out, data) {
             if (!out.videos.some((x) => x.url === data.url)) {
                 out.videos.push({
                     url: data.url,
-                    name,
+                    name: data.prepared ? data.filename ?? name : name,
                     sizeBytes: data.sizeBytes,
+                    ...(data.warning ? { warning: data.warning } : {}),
                 });
             }
             return;
@@ -122,7 +123,7 @@ export async function uploadLocalForAttach(slug, filePath) {
     return uploadLocalMedia({ slug, filePath });
 }
 export async function resolveSitePathUrl(slug, sitePath) {
-    const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/media`);
+    const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/media?path=${encodeURIComponent(sitePath.replace(/\/+/g, "/").replace(/\/$/, ""))}`);
     const norm = (p) => p.replace(/\/+/g, "/").replace(/\/$/, "") || p;
     const want = norm(sitePath);
     const hit = data.assets.find((a) => a.sitePath === sitePath || norm(a.sitePath) === want);

package/dist/media/upload.d.ts

@@ -8,6 +8,8 @@ export type UploadedMedia = {
     contentType?: string;
     content?: string;
     transport?: "proxy" | "client";
+    prepared?: boolean;
+    warning?: string;
 };
 /** Upload a local file using the Phase E transport matrix. */
 export declare function uploadLocalMedia(args: {

package/dist/media/upload.js

@@ -5,7 +5,7 @@ import { randomUUID } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import { basename } from "node:path";
 import { put } from "@vercel/blob/client";
-import { apiBase, CliHttpError, EXIT_AUTH, EXIT_UNEXPECTED, EXIT_USAGE, getBearerAuthHeader, httpErrorFromV1, v1PostMultipart, } from "../http/client.js";
+import { apiBase, CliHttpError, EXIT_AUTH, EXIT_UNEXPECTED, EXIT_USAGE, getBearerAuthHeader, httpErrorFromV1, v1PostMultipart, v1Post, } from "../http/client.js";
 import { contentTypeForExt, sitePathFromKey } from "./limits.js";
 import { selectMediaTransport } from "./select-transport.js";
 async function requestClientToken(args) {
@@ -81,7 +81,7 @@ async function uploadViaClient(args) {
             multipart,
         });
         const key = blob.pathname.replace(/^\//, "");
-        return {
+        const original = {
             kind: args.kind,
             url: blob.url,
             key,
@@ -91,8 +91,28 @@ async function uploadViaClient(args) {
             contentType: args.contentType || contentTypeForExt(args.ext),
             transport: "client",
         };
+        if (args.kind !== "video")
+            return original;
+        try {
+            const prepared = await v1Post(`/api/v1/sites/${encodeURIComponent(args.slug)}/media/prepare`, { key, filename: args.filename }, { timeoutMs: 110000 });
+            if (typeof prepared.url !== "string" || typeof prepared.sitePath !== "string" || typeof prepared.filename !== "string" || typeof prepared.prepared !== "boolean")
+                throw new Error("Invalid video preparation response");
+            const result = { ...prepared, transport: "client" };
+            if (result.warning)
+                console.error(result.warning);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof CliHttpError && error.status >= 400 && error.status < 500 && ![408, 429].includes(error.status))
+                throw error;
+            const warning = "Uploaded original video. Some browsers may not play this format.";
+            console.error(warning);
+            return { ...original, prepared: false, warning };
+        }
     }
     catch (err) {
+        if (err instanceof CliHttpError)
+            throw err;
         const msg = err instanceof Error ? err.message : String(err);
         throw new CliHttpError(`Upload failed: ${msg}`, EXIT_UNEXPECTED, 500);
     }

package/dist/registry.js

@@ -407,6 +407,9 @@ export const COMMANDS = [
         ],
         flags: [
             "Auto-selects proxy (≤4 MB) vs direct-to-Blob for large rasters/PDFs and all video",
+            "Video uploads then attempt browser-compatible MP4 preparation; use the returned sitePath",
+            "Preparation failure keeps the original with a stderr warning and prepared:false in JSON",
+            "media list prefers an exact completed prepared video over its original",
             "Human success: sitePath first (markup-safe), then url: (blob URL for debugging)",
             "Use sitePath (/__media/uploads/<slug>/…) in markup — never raw blob hosts in pages",
             "Text/CSV upload is inline only — not a media-library asset (no /__media link); --json omits full content",
@@ -593,7 +596,7 @@ export const COMMANDS = [
             "sends list --q --status --type campaign|series|confirmation|template|test|inline --page 1 --limit 20.",
             "Series status active means On; paused/draft mean Off. Enrollment while Off waits at step 1, without sending. Existing people resume their next unsent step.",
             "campaign preview|audience|send|get. --id DRAFT_ID, --file audience.json ({audience:{groupIds|stageIds|personIds|filters}}). send requires --request-key; reuse it after a network error. Templates/series are for automation; campaigns have separate drafts. See PEOPLE.md.",
-            "template history <id> pages saved copies with --limit (20 by default, max 100) and --cursor. history-get <id> --history-id reads full content. Use template set with the stable template ID to save edited content as latest; past copies stay unchanged. Read template get before editing. History begins with content retained when history shipped, not lost earlier edits.",
+            "template history <id> pages saved copies with --limit (20 by default, max 100) and --cursor. history-get <id> --history-id reads full content. Both reads follow the plan Rewind window, plus Latest at any age; older copies stay stored. Lists report windowDays, unlimited, canUpgrade and moreBeyondWindow. Use template set with the stable template ID to save edited content as latest; past copies stay unchanged. Read template get before editing. History begins with content retained when history shipped, not lost earlier edits.",
             "email list is unsent drafts only. Sent one-offs are mail sends list",
             "send --file is an inline one-off (no saved document)",
             "Blocks and series steps are JSON (--file). Unknown leftover flags fail closed (exit 2)",

package/llms.txt

@@ -58,4 +58,6 @@ The workspace validates and saves unfinished group settings before opening email
 
 Complete Store edits: use existing items update --file with changed fields and variantUpdates. stock requires expectedStock from a fresh items get. One transaction saves all changes or none. On 409 review current stock; never silently substitute it. firstVariant plus optionNames enables versions. Keep explicit stock/variant commands for single operations. Routines add accepts --request-id UUID; reuse that ID and exact schedule after a lost response. Ordinary form edits live only in the active task; Cancel keeps input, Discard loses unfinished input. Submitted payments, imports, builds, and API-key status are separate operations.
 
-Template history (frontpage-host 0.3.11+): read `mail template get ID` before editing. `mail template history ID --limit 20 --cursor CURSOR` pages saved copies; `mail template history-get ID --history-id COPY_ID` fetches full content. Edit any copy, then `mail template set ID --file content.json` with the stable template ID and content fields only to make a new latest copy. Last template save wins; past copies remain. Campaign and series conflict checks remain. Retry uncertain saves through `mail save` with the same requestKey and exact payload. History begins with content retained at launch; earlier overwritten edits are unavailable. See MAIL.md.
+Template history (frontpage-host 0.3.11+): read `mail template get ID` before editing. `mail template history ID --limit 20 --cursor CURSOR` pages saved copies; `mail template history-get ID --history-id COPY_ID` fetches full content. Edit any copy, then `mail template set ID --file content.json` with the stable template ID and content fields only to make a new latest copy. Last template save wins; past copies remain. Campaign and series conflict checks remain. Retry uncertain saves through `mail save` with the same requestKey and exact payload. History begins with content retained at launch; earlier overwritten edits are unavailable. History reads use the plan’s Rewind window and always include Latest, even when older. Older copies stay stored; lists and direct reads apply the same limit. Window metadata explains the limit and whether older copies exist. See MAIL.md.
+
+Video uploads: the current CLI prepares a browser-compatible MP4 after uploading a local video, including prompt --attach. Use the returned sitePath and actual filename. prepared:false plus warning means the original was retained and playback compatibility is not assured. media list prefers an exact completed prepared copy. Existing video URLs are unchanged. See AGENTS.md for the upload and fallback contract.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontpage-host",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {