@mulmoclaude/core 0.5.1 → 0.6.0

package/dist/remote-view/index.cjs

@@ -0,0 +1,192 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/remote-view/index.ts
+/** Bump when the bootstrap/message contract changes shape; the bootstrap
+*  exposes it as `__MC_VIEW.protocol` so a parent can refuse a stale view. */
+var REMOTE_VIEW_PROTOCOL = 1;
+/** postMessage types between the sandboxed view and its parent page.
+*  `startChat` reuses the desktop custom-view message type on purpose — the
+*  desktop parent already understands it. */
+var REMOTE_VIEW_MESSAGES = {
+	/** view → parent: request one page of records ({ requestId, offset, limit, fields }). */
+	getItems: "mc-remote-get-items",
+	/** parent → view: the reply ({ requestId, ok, page | error }). */
+	items: "mc-remote-items",
+	/** view → parent: open a new chat with a prefilled, NOT auto-sent draft. */
+	startChat: "mc-start-chat"
+};
+/** Pagination defaults — mirrored by the phase-2 record handlers
+*  (`server/remoteHost/handlers/collectionPage.ts` imports these) so a view
+*  page can never outgrow what the command channel itself serves. */
+var DEFAULT_PAGE_LIMIT = 50;
+var MAX_PAGE_LIMIT = 200;
+/** Hard cap on the wrapped srcdoc: it travels to the phone INSIDE a Firestore
+*  command document (1 MiB total), so leave envelope headroom. */
+var REMOTE_VIEW_MAX_BYTES = 9e5;
+/** In-iframe `getItems` timeout — matches the remote client's `callHost`
+*  response timeout so the two layers give up together. */
+var GET_ITEMS_TIMEOUT_MS = 3e4;
+var SANDBOXED_VIEW_CDN_ALLOWLIST = [
+	"https://cdn.jsdelivr.net",
+	"https://unpkg.com",
+	"https://cdnjs.cloudflare.com",
+	"https://fonts.googleapis.com",
+	"https://fonts.gstatic.com",
+	"https://cdn.plot.ly"
+];
+var toInt = (value) => {
+	const num = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+	return Number.isFinite(num) ? Math.floor(num) : null;
+};
+/** Coerce a channel/postMessage offset (arrives as untyped JSON) to a non-negative int. */
+var clampOffset = (value) => Math.max(0, toInt(value) ?? 0);
+/** Coerce a channel/postMessage limit to [1, MAX_PAGE_LIMIT] (default 50). */
+var clampLimit = (value) => {
+	const num = toInt(value);
+	if (num === null || num <= 0) return 50;
+	return Math.min(num, 200);
+};
+/** Coerce a `fields` projection list from untyped message JSON. */
+var normalizeFields = (value) => {
+	if (!Array.isArray(value)) return void 0;
+	const cleaned = value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+	return cleaned.length > 0 ? cleaned : void 0;
+};
+/** Keep only `fields` (+ always the primary key) on each record. Parents apply
+*  this uniformly — the desktop preview via `pageFromItems`, the phone parent
+*  over the page it fetched through the channel — so a view sees the same
+*  projection everywhere. No-op without `fields`. */
+function projectItems(items, fields, primaryKey) {
+	if (!fields || fields.length === 0) return items;
+	const keep = /* @__PURE__ */ new Set([primaryKey, ...fields]);
+	return items.map((item) => Object.fromEntries(Object.entries(item).filter(([key]) => keep.has(key))));
+}
+/** Answer a page request from an already-loaded record array (the desktop
+*  preview's data source): slice + project. Observable behavior matches the
+*  phone paging over the command channel. */
+function pageFromItems(items, request, primaryKey) {
+	return {
+		items: projectItems(items.slice(request.offset, request.offset + request.limit), request.fields, primaryKey),
+		total: items.length,
+		offset: request.offset,
+		limit: request.limit
+	};
+}
+/**
+* CSP for a remote (mobile) custom view. Stricter than the desktop custom-view
+* policy: the view's data arrives over postMessage, so `connect-src` is
+* `'none'` — no fetch / XHR / WebSocket / sendBeacon to ANY origin, which
+* closes the bidirectional-exfiltration channel completely (there is no token
+* to steal either). Script/style/font keep the curated CDN allowlist (the
+* phone can reach the internet; only the host is unreachable), and
+* `img-src`/`media-src` allow any `https:` host so record image/media URLs
+* render — the same knowingly-accepted one-way GET-exfil tradeoff as the
+* desktop policy (see buildCustomViewCsp in src/utils/html/previewCsp.ts).
+*/
+function buildRemoteViewCsp(cdns = SANDBOXED_VIEW_CDN_ALLOWLIST) {
+	const cdnList = cdns.join(" ");
+	return [
+		"default-src 'none'",
+		`script-src 'unsafe-inline' ${cdnList}`,
+		`style-src 'unsafe-inline' ${cdnList}`,
+		`font-src ${cdnList}`,
+		`img-src ${cdnList} data: blob: https:`,
+		"media-src https: data: blob:",
+		"connect-src 'none'"
+	].join("; ");
+}
+/** The in-iframe bootstrap installed before any of the view's own scripts.
+*  Owns the fiddly part of the contract — request/response correlation — so an
+*  LLM-authored view only ever awaits `__MC_VIEW.getItems(...)`:
+*
+*  - `getItems({ offset, limit, fields })`: posts an `mc-remote-get-items`
+*    with a fresh `requestId`, resolves on the matching `mc-remote-items`
+*    reply (validated to come from `window.parent`), rejects on `ok: false`
+*    or after 30 s. targetOrigin `'*'` is safe: the request carries no secret
+*    and the parent is by construction the party supplying the data.
+*  - `startChat(prompt, role)`: same message type + semantics as the desktop
+*    bridge — the parent opens a new chat with `prompt` prefilled as an
+*    editable draft, never auto-sent.
+*  - `t(key, named)`: the same vue-i18n-compatible dict helper as the desktop
+*    bootstrap (named interpolation only), over the host-picked `dict`.
+*
+*  Self-contained one-line string (no `<`, no `<\/script>`, `${}` only for the
+*  interpolated constants). */
+function remoteViewBootstrap() {
+	return `(function(){var v=window.__MC_VIEW,seq=0,pend={};window.addEventListener('message',function(e){if(e.source!==window.parent)return;var d=e.data;if(!d||d.type!=='${REMOTE_VIEW_MESSAGES.items}')return;var p=pend[d.requestId];if(!p)return;delete pend[d.requestId];clearTimeout(p.timer);if(d.ok)p.resolve(d.page);else p.reject(new Error(typeof d.error==='string'?d.error:'load failed'));});v.getItems=function(opts){opts=opts&&typeof opts==='object'?opts:{};return new Promise(function(resolve,reject){var id='q'+(++seq);var timer=setTimeout(function(){delete pend[id];reject(new Error('getItems timed out'));},${GET_ITEMS_TIMEOUT_MS});pend[id]={resolve:resolve,reject:reject,timer:timer};window.parent.postMessage({type:'${REMOTE_VIEW_MESSAGES.getItems}',slug:v.slug,requestId:id,offset:opts.offset,limit:opts.limit,fields:opts.fields},'*');});};v.startChat=function(prompt,role){window.parent.postMessage({type:'${REMOTE_VIEW_MESSAGES.startChat}',slug:v.slug,prompt:String(prompt),role:typeof role==='string'?role:undefined},'*');};v.dict=v.dict||{};v.t=function(key,named){var s=v.dict[key];if(typeof s!=='string')return typeof key==='string'?key:String(key);if(!named||typeof named!=='object')return s;return s.replace(/\\{(\\w+)\\}/g,function(m,n){var x=named[n];return x==null?m:String(x);});};})();`;
+}
+/** Wrap a view's HTML into the sandboxed srcdoc: CSP meta + `__MC_VIEW` boot +
+*  bridge bootstrap injected at the start of `<head>` (before any view
+*  script). Runs HOST-side (`getRemoteView`) so the phone and the desktop
+*  preview receive the identical finished artifact. */
+function buildRemoteViewSrcdoc(html, boot) {
+	const injection = `${`<meta http-equiv="Content-Security-Policy" content="${buildRemoteViewCsp()}">`}<script>window.__MC_VIEW=${JSON.stringify({
+		slug: boot.slug,
+		locale: boot.locale ?? "",
+		dict: boot.dict ?? {},
+		target: "mobile",
+		protocol: 1
+	}).replace(/</g, "\\u003c")};${remoteViewBootstrap()}<\/script>`;
+	if (/<head\b[^>]*>/i.test(html)) return html.replace(/(<head\b[^>]*>)/i, `$1${injection}`);
+	return `<!DOCTYPE html><html><head>${injection}</head><body>${html}</body></html>`;
+}
+async function answerGetItems(requestId, request, handlers, reply) {
+	try {
+		const page = await handlers.getPage(request);
+		reply({
+			type: REMOTE_VIEW_MESSAGES.items,
+			requestId,
+			ok: true,
+			page
+		});
+	} catch (err) {
+		reply({
+			type: REMOTE_VIEW_MESSAGES.items,
+			requestId,
+			ok: false,
+			error: err instanceof Error ? err.message : String(err)
+		});
+	}
+}
+/**
+* Handle one message-event payload from a sandboxed remote view. DOM- and
+* framework-free: the caller owns the `message` listener (and MUST verify
+* `event.source === iframe.contentWindow` before calling), `reply` posts the
+* response back into the iframe (targetOrigin `"*"` — the sandboxed document's
+* origin is opaque, so nothing else can match). Returns true when the payload
+* was a remote-view request for this slug (callers ignore everything else).
+*/
+async function handleRemoteViewMessage(data, handlers, reply) {
+	if (typeof data !== "object" || data === null) return false;
+	const msg = data;
+	if (msg.slug !== handlers.slug) return false;
+	if (msg.type === REMOTE_VIEW_MESSAGES.startChat) {
+		const prompt = typeof msg.prompt === "string" ? msg.prompt.trim() : "";
+		if (prompt) handlers.onStartChat?.(prompt, typeof msg.role === "string" ? msg.role : void 0);
+		return true;
+	}
+	if (msg.type !== REMOTE_VIEW_MESSAGES.getItems || typeof msg.requestId !== "string") return false;
+	const request = {
+		offset: clampOffset(msg.offset),
+		limit: clampLimit(msg.limit),
+		fields: normalizeFields(msg.fields)
+	};
+	await answerGetItems(msg.requestId, request, handlers, reply);
+	return true;
+}
+//#endregion
+exports.DEFAULT_PAGE_LIMIT = DEFAULT_PAGE_LIMIT;
+exports.MAX_PAGE_LIMIT = MAX_PAGE_LIMIT;
+exports.REMOTE_VIEW_MAX_BYTES = REMOTE_VIEW_MAX_BYTES;
+exports.REMOTE_VIEW_MESSAGES = REMOTE_VIEW_MESSAGES;
+exports.REMOTE_VIEW_PROTOCOL = REMOTE_VIEW_PROTOCOL;
+exports.SANDBOXED_VIEW_CDN_ALLOWLIST = SANDBOXED_VIEW_CDN_ALLOWLIST;
+exports.buildRemoteViewCsp = buildRemoteViewCsp;
+exports.buildRemoteViewSrcdoc = buildRemoteViewSrcdoc;
+exports.clampLimit = clampLimit;
+exports.clampOffset = clampOffset;
+exports.handleRemoteViewMessage = handleRemoteViewMessage;
+exports.normalizeFields = normalizeFields;
+exports.pageFromItems = pageFromItems;
+exports.projectItems = projectItems;
+
+//# sourceMappingURL=index.cjs.map

package/dist/remote-view/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/remote-view/index.ts"],"sourcesContent":["// The remote custom-view contract (phase 3 — plans/feat-remote-custom-view.md).\n//\n// Browser-safe single source of truth shared by the host server (which wraps\n// the view HTML into a sandboxed srcdoc), the desktop phone-frame preview, and\n// the mulmoserver mobile client (post-publish). A remote view runs on a phone\n// that can reach the internet but NOT the host's localhost, so — unlike the\n// desktop custom view (token + fetch to the view-data route) — its records\n// arrive over an async postMessage bridge owned by the parent page, and its\n// CSP locks `connect-src` to 'none' entirely.\n\n/** Bump when the bootstrap/message contract changes shape; the bootstrap\n *  exposes it as `__MC_VIEW.protocol` so a parent can refuse a stale view. */\nexport const REMOTE_VIEW_PROTOCOL = 1;\n\n/** postMessage types between the sandboxed view and its parent page.\n *  `startChat` reuses the desktop custom-view message type on purpose — the\n *  desktop parent already understands it. */\nexport const REMOTE_VIEW_MESSAGES = {\n  /** view → parent: request one page of records ({ requestId, offset, limit, fields }). */\n  getItems: \"mc-remote-get-items\",\n  /** parent → view: the reply ({ requestId, ok, page | error }). */\n  items: \"mc-remote-items\",\n  /** view → parent: open a new chat with a prefilled, NOT auto-sent draft. */\n  startChat: \"mc-start-chat\",\n} as const;\n\n/** Pagination defaults — mirrored by the phase-2 record handlers\n *  (`server/remoteHost/handlers/collectionPage.ts` imports these) so a view\n *  page can never outgrow what the command channel itself serves. */\nexport const DEFAULT_PAGE_LIMIT = 50;\nexport const MAX_PAGE_LIMIT = 200;\n\n/** Hard cap on the wrapped srcdoc: it travels to the phone INSIDE a Firestore\n *  command document (1 MiB total), so leave envelope headroom. */\nexport const REMOTE_VIEW_MAX_BYTES = 900_000;\n\n/** In-iframe `getItems` timeout — matches the remote client's `callHost`\n *  response timeout so the two layers give up together. */\nconst GET_ITEMS_TIMEOUT_MS = 30_000;\n\n// CDN allowlist for sandboxed LLM-authored HTML (script/style/font loads).\n// Shared with the desktop preview + custom-view CSPs\n// (src/utils/html/previewCsp.ts re-exports it as its default) so the two\n// policies can't drift. Keep the list audited — every entry is a potential\n// supply-chain surface; the hosts here are reputable infrastructure that does\n// not expose per-request logs to third parties.\nexport const SANDBOXED_VIEW_CDN_ALLOWLIST: readonly string[] = [\n  \"https://cdn.jsdelivr.net\",\n  \"https://unpkg.com\",\n  \"https://cdnjs.cloudflare.com\",\n  \"https://fonts.googleapis.com\",\n  \"https://fonts.gstatic.com\",\n  // Plotly's first-party CDN — the LLM defaults to it for Plotly charts.\n  \"https://cdn.plot.ly\",\n];\n\nconst toInt = (value: unknown): number | null => {\n  const num = typeof value === \"number\" ? value : typeof value === \"string\" ? Number(value) : NaN;\n  return Number.isFinite(num) ? Math.floor(num) : null;\n};\n\n/** Coerce a channel/postMessage offset (arrives as untyped JSON) to a non-negative int. */\nexport const clampOffset = (value: unknown): number => Math.max(0, toInt(value) ?? 0);\n\n/** Coerce a channel/postMessage limit to [1, MAX_PAGE_LIMIT] (default 50). */\nexport const clampLimit = (value: unknown): number => {\n  const num = toInt(value);\n  if (num === null || num <= 0) return DEFAULT_PAGE_LIMIT;\n  return Math.min(num, MAX_PAGE_LIMIT);\n};\n\n/** Coerce a `fields` projection list from untyped message JSON. */\nexport const normalizeFields = (value: unknown): string[] | undefined => {\n  if (!Array.isArray(value)) return undefined;\n  const cleaned = value\n    .filter((entry): entry is string => typeof entry === \"string\")\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  return cleaned.length > 0 ? cleaned : undefined;\n};\n\nexport type RemoteViewItem = Record<string, unknown>;\n\n/** One page of records, the resolved value of the view's `getItems()`. Same\n *  shape as the phase-2 `getCollection` page so a parent can pass a channel\n *  page straight through. */\nexport interface RemoteViewPage {\n  items: RemoteViewItem[];\n  total: number;\n  offset: number;\n  limit: number;\n}\n\n/** A normalized (clamped, fields-cleaned) page request handed to a parent's\n *  `getPage` — `handleRemoteViewMessage` does the coercion so every parent\n *  answers identical values. */\nexport interface RemoteViewPageRequest {\n  offset: number;\n  limit: number;\n  fields?: string[];\n}\n\n/** Keep only `fields` (+ always the primary key) on each record. Parents apply\n *  this uniformly — the desktop preview via `pageFromItems`, the phone parent\n *  over the page it fetched through the channel — so a view sees the same\n *  projection everywhere. No-op without `fields`. */\nexport function projectItems(items: RemoteViewItem[], fields: string[] | undefined, primaryKey: string): RemoteViewItem[] {\n  if (!fields || fields.length === 0) return items;\n  const keep = new Set([primaryKey, ...fields]);\n  return items.map((item) => Object.fromEntries(Object.entries(item).filter(([key]) => keep.has(key))));\n}\n\n/** Answer a page request from an already-loaded record array (the desktop\n *  preview's data source): slice + project. Observable behavior matches the\n *  phone paging over the command channel. */\nexport function pageFromItems(items: RemoteViewItem[], request: RemoteViewPageRequest, primaryKey: string): RemoteViewPage {\n  const pageItems = items.slice(request.offset, request.offset + request.limit);\n  return { items: projectItems(pageItems, request.fields, primaryKey), total: items.length, offset: request.offset, limit: request.limit };\n}\n\n/**\n * CSP for a remote (mobile) custom view. Stricter than the desktop custom-view\n * policy: the view's data arrives over postMessage, so `connect-src` is\n * `'none'` — no fetch / XHR / WebSocket / sendBeacon to ANY origin, which\n * closes the bidirectional-exfiltration channel completely (there is no token\n * to steal either). Script/style/font keep the curated CDN allowlist (the\n * phone can reach the internet; only the host is unreachable), and\n * `img-src`/`media-src` allow any `https:` host so record image/media URLs\n * render — the same knowingly-accepted one-way GET-exfil tradeoff as the\n * desktop policy (see buildCustomViewCsp in src/utils/html/previewCsp.ts).\n */\nexport function buildRemoteViewCsp(cdns: readonly string[] = SANDBOXED_VIEW_CDN_ALLOWLIST): string {\n  const cdnList = cdns.join(\" \");\n  return [\n    \"default-src 'none'\",\n    `script-src 'unsafe-inline' ${cdnList}`,\n    `style-src 'unsafe-inline' ${cdnList}`,\n    `font-src ${cdnList}`,\n    `img-src ${cdnList} data: blob: https:`,\n    \"media-src https: data: blob:\",\n    \"connect-src 'none'\",\n  ].join(\"; \");\n}\n\n/** The in-iframe bootstrap installed before any of the view's own scripts.\n *  Owns the fiddly part of the contract — request/response correlation — so an\n *  LLM-authored view only ever awaits `__MC_VIEW.getItems(...)`:\n *\n *  - `getItems({ offset, limit, fields })`: posts an `mc-remote-get-items`\n *    with a fresh `requestId`, resolves on the matching `mc-remote-items`\n *    reply (validated to come from `window.parent`), rejects on `ok: false`\n *    or after 30 s. targetOrigin `'*'` is safe: the request carries no secret\n *    and the parent is by construction the party supplying the data.\n *  - `startChat(prompt, role)`: same message type + semantics as the desktop\n *    bridge — the parent opens a new chat with `prompt` prefilled as an\n *    editable draft, never auto-sent.\n *  - `t(key, named)`: the same vue-i18n-compatible dict helper as the desktop\n *    bootstrap (named interpolation only), over the host-picked `dict`.\n *\n *  Self-contained one-line string (no `<`, no `</script>`, `${}` only for the\n *  interpolated constants). */\nfunction remoteViewBootstrap(): string {\n  return `(function(){var v=window.__MC_VIEW,seq=0,pend={};window.addEventListener('message',function(e){if(e.source!==window.parent)return;var d=e.data;if(!d||d.type!=='${REMOTE_VIEW_MESSAGES.items}')return;var p=pend[d.requestId];if(!p)return;delete pend[d.requestId];clearTimeout(p.timer);if(d.ok)p.resolve(d.page);else p.reject(new Error(typeof d.error==='string'?d.error:'load failed'));});v.getItems=function(opts){opts=opts&&typeof opts==='object'?opts:{};return new Promise(function(resolve,reject){var id='q'+(++seq);var timer=setTimeout(function(){delete pend[id];reject(new Error('getItems timed out'));},${GET_ITEMS_TIMEOUT_MS});pend[id]={resolve:resolve,reject:reject,timer:timer};window.parent.postMessage({type:'${REMOTE_VIEW_MESSAGES.getItems}',slug:v.slug,requestId:id,offset:opts.offset,limit:opts.limit,fields:opts.fields},'*');});};v.startChat=function(prompt,role){window.parent.postMessage({type:'${REMOTE_VIEW_MESSAGES.startChat}',slug:v.slug,prompt:String(prompt),role:typeof role==='string'?role:undefined},'*');};v.dict=v.dict||{};v.t=function(key,named){var s=v.dict[key];if(typeof s!=='string')return typeof key==='string'?key:String(key);if(!named||typeof named!=='object')return s;return s.replace(/\\\\{(\\\\w+)\\\\}/g,function(m,n){var x=named[n];return x==null?m:String(x);});};})();`;\n}\n\n/** What the host injects into `window.__MC_VIEW` — note what is ABSENT\n *  compared to the desktop boot: no token, no dataUrl, no origin. */\nexport interface RemoteViewBoot {\n  slug: string;\n  /** Locale the dict was picked for; empty string when no translations. */\n  locale?: string;\n  /** Host-picked, locale-filtered flat string map (same contract as the\n   *  desktop custom-view dict). */\n  dict?: Record<string, string>;\n}\n\n/** Wrap a view's HTML into the sandboxed srcdoc: CSP meta + `__MC_VIEW` boot +\n *  bridge bootstrap injected at the start of `<head>` (before any view\n *  script). Runs HOST-side (`getRemoteView`) so the phone and the desktop\n *  preview receive the identical finished artifact. */\nexport function buildRemoteViewSrcdoc(html: string, boot: RemoteViewBoot): string {\n  const cspMeta = `<meta http-equiv=\"Content-Security-Policy\" content=\"${buildRemoteViewCsp()}\">`;\n  // `<`-escape the JSON so a hostile slug/dict string can't break out of the\n  // <script> element (same escape as the desktop srcdoc builder).\n  const json = JSON.stringify({\n    slug: boot.slug,\n    locale: boot.locale ?? \"\",\n    dict: boot.dict ?? {},\n    target: \"mobile\",\n    protocol: REMOTE_VIEW_PROTOCOL,\n  }).replace(/</g, \"\\\\u003c\");\n  const injection = `${cspMeta}<script>window.__MC_VIEW=${json};${remoteViewBootstrap()}</script>`;\n  if (/<head\\b[^>]*>/i.test(html)) {\n    return html.replace(/(<head\\b[^>]*>)/i, `$1${injection}`);\n  }\n  return `<!DOCTYPE html><html><head>${injection}</head><body>${html}</body></html>`;\n}\n\n/** What a parent page provides to answer the sandboxed view. Deliberately\n *  minimal — exactly the phone runtime's capabilities, nothing more, so the\n *  desktop preview can never exceed what works on the phone. */\nexport interface RemoteViewBridgeHandlers {\n  slug: string;\n  /** Answer one normalized page request (already clamped + fields-cleaned). */\n  getPage: (request: RemoteViewPageRequest) => Promise<RemoteViewPage> | RemoteViewPage;\n  /** Relay a `startChat` draft; omit on a parent without a chat surface. */\n  onStartChat?: (prompt: string, role?: string) => void;\n}\n\nasync function answerGetItems(requestId: string, request: RemoteViewPageRequest, handlers: RemoteViewBridgeHandlers, reply: RemoteViewReply): Promise<void> {\n  try {\n    const page = await handlers.getPage(request);\n    reply({ type: REMOTE_VIEW_MESSAGES.items, requestId, ok: true, page });\n  } catch (err) {\n    reply({ type: REMOTE_VIEW_MESSAGES.items, requestId, ok: false, error: err instanceof Error ? err.message : String(err) });\n  }\n}\n\ntype RemoteViewReply = (message: Record<string, unknown>) => void;\n\n/**\n * Handle one message-event payload from a sandboxed remote view. DOM- and\n * framework-free: the caller owns the `message` listener (and MUST verify\n * `event.source === iframe.contentWindow` before calling), `reply` posts the\n * response back into the iframe (targetOrigin `\"*\"` — the sandboxed document's\n * origin is opaque, so nothing else can match). Returns true when the payload\n * was a remote-view request for this slug (callers ignore everything else).\n */\nexport async function handleRemoteViewMessage(data: unknown, handlers: RemoteViewBridgeHandlers, reply: RemoteViewReply): Promise<boolean> {\n  if (typeof data !== \"object\" || data === null) return false;\n  const msg = data as {\n    type?: unknown;\n    slug?: unknown;\n    requestId?: unknown;\n    offset?: unknown;\n    limit?: unknown;\n    fields?: unknown;\n    prompt?: unknown;\n    role?: unknown;\n  };\n  if (msg.slug !== handlers.slug) return false;\n  if (msg.type === REMOTE_VIEW_MESSAGES.startChat) {\n    const prompt = typeof msg.prompt === \"string\" ? msg.prompt.trim() : \"\";\n    if (prompt) handlers.onStartChat?.(prompt, typeof msg.role === \"string\" ? msg.role : undefined);\n    return true;\n  }\n  if (msg.type !== REMOTE_VIEW_MESSAGES.getItems || typeof msg.requestId !== \"string\") return false;\n  const request: RemoteViewPageRequest = { offset: clampOffset(msg.offset), limit: clampLimit(msg.limit), fields: normalizeFields(msg.fields) };\n  await answerGetItems(msg.requestId, request, handlers, reply);\n  return true;\n}\n"],"mappings":"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"}

package/dist/remote-view/index.d.ts

@@ -0,0 +1,104 @@
+/** Bump when the bootstrap/message contract changes shape; the bootstrap
+ *  exposes it as `__MC_VIEW.protocol` so a parent can refuse a stale view. */
+export declare const REMOTE_VIEW_PROTOCOL = 1;
+/** postMessage types between the sandboxed view and its parent page.
+ *  `startChat` reuses the desktop custom-view message type on purpose — the
+ *  desktop parent already understands it. */
+export declare const REMOTE_VIEW_MESSAGES: {
+    /** view → parent: request one page of records ({ requestId, offset, limit, fields }). */
+    readonly getItems: "mc-remote-get-items";
+    /** parent → view: the reply ({ requestId, ok, page | error }). */
+    readonly items: "mc-remote-items";
+    /** view → parent: open a new chat with a prefilled, NOT auto-sent draft. */
+    readonly startChat: "mc-start-chat";
+};
+/** Pagination defaults — mirrored by the phase-2 record handlers
+ *  (`server/remoteHost/handlers/collectionPage.ts` imports these) so a view
+ *  page can never outgrow what the command channel itself serves. */
+export declare const DEFAULT_PAGE_LIMIT = 50;
+export declare const MAX_PAGE_LIMIT = 200;
+/** Hard cap on the wrapped srcdoc: it travels to the phone INSIDE a Firestore
+ *  command document (1 MiB total), so leave envelope headroom. */
+export declare const REMOTE_VIEW_MAX_BYTES = 900000;
+export declare const SANDBOXED_VIEW_CDN_ALLOWLIST: readonly string[];
+/** Coerce a channel/postMessage offset (arrives as untyped JSON) to a non-negative int. */
+export declare const clampOffset: (value: unknown) => number;
+/** Coerce a channel/postMessage limit to [1, MAX_PAGE_LIMIT] (default 50). */
+export declare const clampLimit: (value: unknown) => number;
+/** Coerce a `fields` projection list from untyped message JSON. */
+export declare const normalizeFields: (value: unknown) => string[] | undefined;
+export type RemoteViewItem = Record<string, unknown>;
+/** One page of records, the resolved value of the view's `getItems()`. Same
+ *  shape as the phase-2 `getCollection` page so a parent can pass a channel
+ *  page straight through. */
+export interface RemoteViewPage {
+    items: RemoteViewItem[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+/** A normalized (clamped, fields-cleaned) page request handed to a parent's
+ *  `getPage` — `handleRemoteViewMessage` does the coercion so every parent
+ *  answers identical values. */
+export interface RemoteViewPageRequest {
+    offset: number;
+    limit: number;
+    fields?: string[];
+}
+/** Keep only `fields` (+ always the primary key) on each record. Parents apply
+ *  this uniformly — the desktop preview via `pageFromItems`, the phone parent
+ *  over the page it fetched through the channel — so a view sees the same
+ *  projection everywhere. No-op without `fields`. */
+export declare function projectItems(items: RemoteViewItem[], fields: string[] | undefined, primaryKey: string): RemoteViewItem[];
+/** Answer a page request from an already-loaded record array (the desktop
+ *  preview's data source): slice + project. Observable behavior matches the
+ *  phone paging over the command channel. */
+export declare function pageFromItems(items: RemoteViewItem[], request: RemoteViewPageRequest, primaryKey: string): RemoteViewPage;
+/**
+ * CSP for a remote (mobile) custom view. Stricter than the desktop custom-view
+ * policy: the view's data arrives over postMessage, so `connect-src` is
+ * `'none'` — no fetch / XHR / WebSocket / sendBeacon to ANY origin, which
+ * closes the bidirectional-exfiltration channel completely (there is no token
+ * to steal either). Script/style/font keep the curated CDN allowlist (the
+ * phone can reach the internet; only the host is unreachable), and
+ * `img-src`/`media-src` allow any `https:` host so record image/media URLs
+ * render — the same knowingly-accepted one-way GET-exfil tradeoff as the
+ * desktop policy (see buildCustomViewCsp in src/utils/html/previewCsp.ts).
+ */
+export declare function buildRemoteViewCsp(cdns?: readonly string[]): string;
+/** What the host injects into `window.__MC_VIEW` — note what is ABSENT
+ *  compared to the desktop boot: no token, no dataUrl, no origin. */
+export interface RemoteViewBoot {
+    slug: string;
+    /** Locale the dict was picked for; empty string when no translations. */
+    locale?: string;
+    /** Host-picked, locale-filtered flat string map (same contract as the
+     *  desktop custom-view dict). */
+    dict?: Record<string, string>;
+}
+/** Wrap a view's HTML into the sandboxed srcdoc: CSP meta + `__MC_VIEW` boot +
+ *  bridge bootstrap injected at the start of `<head>` (before any view
+ *  script). Runs HOST-side (`getRemoteView`) so the phone and the desktop
+ *  preview receive the identical finished artifact. */
+export declare function buildRemoteViewSrcdoc(html: string, boot: RemoteViewBoot): string;
+/** What a parent page provides to answer the sandboxed view. Deliberately
+ *  minimal — exactly the phone runtime's capabilities, nothing more, so the
+ *  desktop preview can never exceed what works on the phone. */
+export interface RemoteViewBridgeHandlers {
+    slug: string;
+    /** Answer one normalized page request (already clamped + fields-cleaned). */
+    getPage: (request: RemoteViewPageRequest) => Promise<RemoteViewPage> | RemoteViewPage;
+    /** Relay a `startChat` draft; omit on a parent without a chat surface. */
+    onStartChat?: (prompt: string, role?: string) => void;
+}
+type RemoteViewReply = (message: Record<string, unknown>) => void;
+/**
+ * Handle one message-event payload from a sandboxed remote view. DOM- and
+ * framework-free: the caller owns the `message` listener (and MUST verify
+ * `event.source === iframe.contentWindow` before calling), `reply` posts the
+ * response back into the iframe (targetOrigin `"*"` — the sandboxed document's
+ * origin is opaque, so nothing else can match). Returns true when the payload
+ * was a remote-view request for this slug (callers ignore everything else).
+ */
+export declare function handleRemoteViewMessage(data: unknown, handlers: RemoteViewBridgeHandlers, reply: RemoteViewReply): Promise<boolean>;
+export {};

package/dist/remote-view/index.js

@@ -0,0 +1,178 @@
+//#region src/remote-view/index.ts
+/** Bump when the bootstrap/message contract changes shape; the bootstrap
+*  exposes it as `__MC_VIEW.protocol` so a parent can refuse a stale view. */
+var REMOTE_VIEW_PROTOCOL = 1;
+/** postMessage types between the sandboxed view and its parent page.
+*  `startChat` reuses the desktop custom-view message type on purpose — the
+*  desktop parent already understands it. */
+var REMOTE_VIEW_MESSAGES = {
+	/** view → parent: request one page of records ({ requestId, offset, limit, fields }). */
+	getItems: "mc-remote-get-items",
+	/** parent → view: the reply ({ requestId, ok, page | error }). */
+	items: "mc-remote-items",
+	/** view → parent: open a new chat with a prefilled, NOT auto-sent draft. */
+	startChat: "mc-start-chat"
+};
+/** Pagination defaults — mirrored by the phase-2 record handlers
+*  (`server/remoteHost/handlers/collectionPage.ts` imports these) so a view
+*  page can never outgrow what the command channel itself serves. */
+var DEFAULT_PAGE_LIMIT = 50;
+var MAX_PAGE_LIMIT = 200;
+/** Hard cap on the wrapped srcdoc: it travels to the phone INSIDE a Firestore
+*  command document (1 MiB total), so leave envelope headroom. */
+var REMOTE_VIEW_MAX_BYTES = 9e5;
+/** In-iframe `getItems` timeout — matches the remote client's `callHost`
+*  response timeout so the two layers give up together. */
+var GET_ITEMS_TIMEOUT_MS = 3e4;
+var SANDBOXED_VIEW_CDN_ALLOWLIST = [
+	"https://cdn.jsdelivr.net",
+	"https://unpkg.com",
+	"https://cdnjs.cloudflare.com",
+	"https://fonts.googleapis.com",
+	"https://fonts.gstatic.com",
+	"https://cdn.plot.ly"
+];
+var toInt = (value) => {
+	const num = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+	return Number.isFinite(num) ? Math.floor(num) : null;
+};
+/** Coerce a channel/postMessage offset (arrives as untyped JSON) to a non-negative int. */
+var clampOffset = (value) => Math.max(0, toInt(value) ?? 0);
+/** Coerce a channel/postMessage limit to [1, MAX_PAGE_LIMIT] (default 50). */
+var clampLimit = (value) => {
+	const num = toInt(value);
+	if (num === null || num <= 0) return 50;
+	return Math.min(num, 200);
+};
+/** Coerce a `fields` projection list from untyped message JSON. */
+var normalizeFields = (value) => {
+	if (!Array.isArray(value)) return void 0;
+	const cleaned = value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+	return cleaned.length > 0 ? cleaned : void 0;
+};
+/** Keep only `fields` (+ always the primary key) on each record. Parents apply
+*  this uniformly — the desktop preview via `pageFromItems`, the phone parent
+*  over the page it fetched through the channel — so a view sees the same
+*  projection everywhere. No-op without `fields`. */
+function projectItems(items, fields, primaryKey) {
+	if (!fields || fields.length === 0) return items;
+	const keep = /* @__PURE__ */ new Set([primaryKey, ...fields]);
+	return items.map((item) => Object.fromEntries(Object.entries(item).filter(([key]) => keep.has(key))));
+}
+/** Answer a page request from an already-loaded record array (the desktop
+*  preview's data source): slice + project. Observable behavior matches the
+*  phone paging over the command channel. */
+function pageFromItems(items, request, primaryKey) {
+	return {
+		items: projectItems(items.slice(request.offset, request.offset + request.limit), request.fields, primaryKey),
+		total: items.length,
+		offset: request.offset,
+		limit: request.limit
+	};
+}
+/**
+* CSP for a remote (mobile) custom view. Stricter than the desktop custom-view
+* policy: the view's data arrives over postMessage, so `connect-src` is
+* `'none'` — no fetch / XHR / WebSocket / sendBeacon to ANY origin, which
+* closes the bidirectional-exfiltration channel completely (there is no token
+* to steal either). Script/style/font keep the curated CDN allowlist (the
+* phone can reach the internet; only the host is unreachable), and
+* `img-src`/`media-src` allow any `https:` host so record image/media URLs
+* render — the same knowingly-accepted one-way GET-exfil tradeoff as the
+* desktop policy (see buildCustomViewCsp in src/utils/html/previewCsp.ts).
+*/
+function buildRemoteViewCsp(cdns = SANDBOXED_VIEW_CDN_ALLOWLIST) {
+	const cdnList = cdns.join(" ");
+	return [
+		"default-src 'none'",
+		`script-src 'unsafe-inline' ${cdnList}`,
+		`style-src 'unsafe-inline' ${cdnList}`,
+		`font-src ${cdnList}`,
+		`img-src ${cdnList} data: blob: https:`,
+		"media-src https: data: blob:",
+		"connect-src 'none'"
+	].join("; ");
+}
+/** The in-iframe bootstrap installed before any of the view's own scripts.
+*  Owns the fiddly part of the contract — request/response correlation — so an
+*  LLM-authored view only ever awaits `__MC_VIEW.getItems(...)`:
+*
+*  - `getItems({ offset, limit, fields })`: posts an `mc-remote-get-items`
+*    with a fresh `requestId`, resolves on the matching `mc-remote-items`
+*    reply (validated to come from `window.parent`), rejects on `ok: false`
+*    or after 30 s. targetOrigin `'*'` is safe: the request carries no secret
+*    and the parent is by construction the party supplying the data.
+*  - `startChat(prompt, role)`: same message type + semantics as the desktop
+*    bridge — the parent opens a new chat with `prompt` prefilled as an
+*    editable draft, never auto-sent.
+*  - `t(key, named)`: the same vue-i18n-compatible dict helper as the desktop
+*    bootstrap (named interpolation only), over the host-picked `dict`.
+*
+*  Self-contained one-line string (no `<`, no `<\/script>`, `${}` only for the
+*  interpolated constants). */
+function remoteViewBootstrap() {
+	return `(function(){var v=window.__MC_VIEW,seq=0,pend={};window.addEventListener('message',function(e){if(e.source!==window.parent)return;var d=e.data;if(!d||d.type!=='${REMOTE_VIEW_MESSAGES.items}')return;var p=pend[d.requestId];if(!p)return;delete pend[d.requestId];clearTimeout(p.timer);if(d.ok)p.resolve(d.page);else p.reject(new Error(typeof d.error==='string'?d.error:'load failed'));});v.getItems=function(opts){opts=opts&&typeof opts==='object'?opts:{};return new Promise(function(resolve,reject){var id='q'+(++seq);var timer=setTimeout(function(){delete pend[id];reject(new Error('getItems timed out'));},${GET_ITEMS_TIMEOUT_MS});pend[id]={resolve:resolve,reject:reject,timer:timer};window.parent.postMessage({type:'${REMOTE_VIEW_MESSAGES.getItems}',slug:v.slug,requestId:id,offset:opts.offset,limit:opts.limit,fields:opts.fields},'*');});};v.startChat=function(prompt,role){window.parent.postMessage({type:'${REMOTE_VIEW_MESSAGES.startChat}',slug:v.slug,prompt:String(prompt),role:typeof role==='string'?role:undefined},'*');};v.dict=v.dict||{};v.t=function(key,named){var s=v.dict[key];if(typeof s!=='string')return typeof key==='string'?key:String(key);if(!named||typeof named!=='object')return s;return s.replace(/\\{(\\w+)\\}/g,function(m,n){var x=named[n];return x==null?m:String(x);});};})();`;
+}
+/** Wrap a view's HTML into the sandboxed srcdoc: CSP meta + `__MC_VIEW` boot +
+*  bridge bootstrap injected at the start of `<head>` (before any view
+*  script). Runs HOST-side (`getRemoteView`) so the phone and the desktop
+*  preview receive the identical finished artifact. */
+function buildRemoteViewSrcdoc(html, boot) {
+	const injection = `${`<meta http-equiv="Content-Security-Policy" content="${buildRemoteViewCsp()}">`}<script>window.__MC_VIEW=${JSON.stringify({
+		slug: boot.slug,
+		locale: boot.locale ?? "",
+		dict: boot.dict ?? {},
+		target: "mobile",
+		protocol: 1
+	}).replace(/</g, "\\u003c")};${remoteViewBootstrap()}<\/script>`;
+	if (/<head\b[^>]*>/i.test(html)) return html.replace(/(<head\b[^>]*>)/i, `$1${injection}`);
+	return `<!DOCTYPE html><html><head>${injection}</head><body>${html}</body></html>`;
+}
+async function answerGetItems(requestId, request, handlers, reply) {
+	try {
+		const page = await handlers.getPage(request);
+		reply({
+			type: REMOTE_VIEW_MESSAGES.items,
+			requestId,
+			ok: true,
+			page
+		});
+	} catch (err) {
+		reply({
+			type: REMOTE_VIEW_MESSAGES.items,
+			requestId,
+			ok: false,
+			error: err instanceof Error ? err.message : String(err)
+		});
+	}
+}
+/**
+* Handle one message-event payload from a sandboxed remote view. DOM- and
+* framework-free: the caller owns the `message` listener (and MUST verify
+* `event.source === iframe.contentWindow` before calling), `reply` posts the
+* response back into the iframe (targetOrigin `"*"` — the sandboxed document's
+* origin is opaque, so nothing else can match). Returns true when the payload
+* was a remote-view request for this slug (callers ignore everything else).
+*/
+async function handleRemoteViewMessage(data, handlers, reply) {
+	if (typeof data !== "object" || data === null) return false;
+	const msg = data;
+	if (msg.slug !== handlers.slug) return false;
+	if (msg.type === REMOTE_VIEW_MESSAGES.startChat) {
+		const prompt = typeof msg.prompt === "string" ? msg.prompt.trim() : "";
+		if (prompt) handlers.onStartChat?.(prompt, typeof msg.role === "string" ? msg.role : void 0);
+		return true;
+	}
+	if (msg.type !== REMOTE_VIEW_MESSAGES.getItems || typeof msg.requestId !== "string") return false;
+	const request = {
+		offset: clampOffset(msg.offset),
+		limit: clampLimit(msg.limit),
+		fields: normalizeFields(msg.fields)
+	};
+	await answerGetItems(msg.requestId, request, handlers, reply);
+	return true;
+}
+//#endregion
+export { DEFAULT_PAGE_LIMIT, MAX_PAGE_LIMIT, REMOTE_VIEW_MAX_BYTES, REMOTE_VIEW_MESSAGES, REMOTE_VIEW_PROTOCOL, SANDBOXED_VIEW_CDN_ALLOWLIST, buildRemoteViewCsp, buildRemoteViewSrcdoc, clampLimit, clampOffset, handleRemoteViewMessage, normalizeFields, pageFromItems, projectItems };
+
+//# sourceMappingURL=index.js.map

package/dist/remote-view/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/remote-view/index.ts"],"sourcesContent":["// The remote custom-view contract (phase 3 — plans/feat-remote-custom-view.md).\n//\n// Browser-safe single source of truth shared by the host server (which wraps\n// the view HTML into a sandboxed srcdoc), the desktop phone-frame preview, and\n// the mulmoserver mobile client (post-publish). A remote view runs on a phone\n// that can reach the internet but NOT the host's localhost, so — unlike the\n// desktop custom view (token + fetch to the view-data route) — its records\n// arrive over an async postMessage bridge owned by the parent page, and its\n// CSP locks `connect-src` to 'none' entirely.\n\n/** Bump when the bootstrap/message contract changes shape; the bootstrap\n *  exposes it as `__MC_VIEW.protocol` so a parent can refuse a stale view. */\nexport const REMOTE_VIEW_PROTOCOL = 1;\n\n/** postMessage types between the sandboxed view and its parent page.\n *  `startChat` reuses the desktop custom-view message type on purpose — the\n *  desktop parent already understands it. */\nexport const REMOTE_VIEW_MESSAGES = {\n  /** view → parent: request one page of records ({ requestId, offset, limit, fields }). */\n  getItems: \"mc-remote-get-items\",\n  /** parent → view: the reply ({ requestId, ok, page | error }). */\n  items: \"mc-remote-items\",\n  /** view → parent: open a new chat with a prefilled, NOT auto-sent draft. */\n  startChat: \"mc-start-chat\",\n} as const;\n\n/** Pagination defaults — mirrored by the phase-2 record handlers\n *  (`server/remoteHost/handlers/collectionPage.ts` imports these) so a view\n *  page can never outgrow what the command channel itself serves. */\nexport const DEFAULT_PAGE_LIMIT = 50;\nexport const MAX_PAGE_LIMIT = 200;\n\n/** Hard cap on the wrapped srcdoc: it travels to the phone INSIDE a Firestore\n *  command document (1 MiB total), so leave envelope headroom. */\nexport const REMOTE_VIEW_MAX_BYTES = 900_000;\n\n/** In-iframe `getItems` timeout — matches the remote client's `callHost`\n *  response timeout so the two layers give up together. */\nconst GET_ITEMS_TIMEOUT_MS = 30_000;\n\n// CDN allowlist for sandboxed LLM-authored HTML (script/style/font loads).\n// Shared with the desktop preview + custom-view CSPs\n// (src/utils/html/previewCsp.ts re-exports it as its default) so the two\n// policies can't drift. Keep the list audited — every entry is a potential\n// supply-chain surface; the hosts here are reputable infrastructure that does\n// not expose per-request logs to third parties.\nexport const SANDBOXED_VIEW_CDN_ALLOWLIST: readonly string[] = [\n  \"https://cdn.jsdelivr.net\",\n  \"https://unpkg.com\",\n  \"https://cdnjs.cloudflare.com\",\n  \"https://fonts.googleapis.com\",\n  \"https://fonts.gstatic.com\",\n  // Plotly's first-party CDN — the LLM defaults to it for Plotly charts.\n  \"https://cdn.plot.ly\",\n];\n\nconst toInt = (value: unknown): number | null => {\n  const num = typeof value === \"number\" ? value : typeof value === \"string\" ? Number(value) : NaN;\n  return Number.isFinite(num) ? Math.floor(num) : null;\n};\n\n/** Coerce a channel/postMessage offset (arrives as untyped JSON) to a non-negative int. */\nexport const clampOffset = (value: unknown): number => Math.max(0, toInt(value) ?? 0);\n\n/** Coerce a channel/postMessage limit to [1, MAX_PAGE_LIMIT] (default 50). */\nexport const clampLimit = (value: unknown): number => {\n  const num = toInt(value);\n  if (num === null || num <= 0) return DEFAULT_PAGE_LIMIT;\n  return Math.min(num, MAX_PAGE_LIMIT);\n};\n\n/** Coerce a `fields` projection list from untyped message JSON. */\nexport const normalizeFields = (value: unknown): string[] | undefined => {\n  if (!Array.isArray(value)) return undefined;\n  const cleaned = value\n    .filter((entry): entry is string => typeof entry === \"string\")\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  return cleaned.length > 0 ? cleaned : undefined;\n};\n\nexport type RemoteViewItem = Record<string, unknown>;\n\n/** One page of records, the resolved value of the view's `getItems()`. Same\n *  shape as the phase-2 `getCollection` page so a parent can pass a channel\n *  page straight through. */\nexport interface RemoteViewPage {\n  items: RemoteViewItem[];\n  total: number;\n  offset: number;\n  limit: number;\n}\n\n/** A normalized (clamped, fields-cleaned) page request handed to a parent's\n *  `getPage` — `handleRemoteViewMessage` does the coercion so every parent\n *  answers identical values. */\nexport interface RemoteViewPageRequest {\n  offset: number;\n  limit: number;\n  fields?: string[];\n}\n\n/** Keep only `fields` (+ always the primary key) on each record. Parents apply\n *  this uniformly — the desktop preview via `pageFromItems`, the phone parent\n *  over the page it fetched through the channel — so a view sees the same\n *  projection everywhere. No-op without `fields`. */\nexport function projectItems(items: RemoteViewItem[], fields: string[] | undefined, primaryKey: string): RemoteViewItem[] {\n  if (!fields || fields.length === 0) return items;\n  const keep = new Set([primaryKey, ...fields]);\n  return items.map((item) => Object.fromEntries(Object.entries(item).filter(([key]) => keep.has(key))));\n}\n\n/** Answer a page request from an already-loaded record array (the desktop\n *  preview's data source): slice + project. Observable behavior matches the\n *  phone paging over the command channel. */\nexport function pageFromItems(items: RemoteViewItem[], request: RemoteViewPageRequest, primaryKey: string): RemoteViewPage {\n  const pageItems = items.slice(request.offset, request.offset + request.limit);\n  return { items: projectItems(pageItems, request.fields, primaryKey), total: items.length, offset: request.offset, limit: request.limit };\n}\n\n/**\n * CSP for a remote (mobile) custom view. Stricter than the desktop custom-view\n * policy: the view's data arrives over postMessage, so `connect-src` is\n * `'none'` — no fetch / XHR / WebSocket / sendBeacon to ANY origin, which\n * closes the bidirectional-exfiltration channel completely (there is no token\n * to steal either). Script/style/font keep the curated CDN allowlist (the\n * phone can reach the internet; only the host is unreachable), and\n * `img-src`/`media-src` allow any `https:` host so record image/media URLs\n * render — the same knowingly-accepted one-way GET-exfil tradeoff as the\n * desktop policy (see buildCustomViewCsp in src/utils/html/previewCsp.ts).\n */\nexport function buildRemoteViewCsp(cdns: readonly string[] = SANDBOXED_VIEW_CDN_ALLOWLIST): string {\n  const cdnList = cdns.join(\" \");\n  return [\n    \"default-src 'none'\",\n    `script-src 'unsafe-inline' ${cdnList}`,\n    `style-src 'unsafe-inline' ${cdnList}`,\n    `font-src ${cdnList}`,\n    `img-src ${cdnList} data: blob: https:`,\n    \"media-src https: data: blob:\",\n    \"connect-src 'none'\",\n  ].join(\"; \");\n}\n\n/** The in-iframe bootstrap installed before any of the view's own scripts.\n *  Owns the fiddly part of the contract — request/response correlation — so an\n *  LLM-authored view only ever awaits `__MC_VIEW.getItems(...)`:\n *\n *  - `getItems({ offset, limit, fields })`: posts an `mc-remote-get-items`\n *    with a fresh `requestId`, resolves on the matching `mc-remote-items`\n *    reply (validated to come from `window.parent`), rejects on `ok: false`\n *    or after 30 s. targetOrigin `'*'` is safe: the request carries no secret\n *    and the parent is by construction the party supplying the data.\n *  - `startChat(prompt, role)`: same message type + semantics as the desktop\n *    bridge — the parent opens a new chat with `prompt` prefilled as an\n *    editable draft, never auto-sent.\n *  - `t(key, named)`: the same vue-i18n-compatible dict helper as the desktop\n *    bootstrap (named interpolation only), over the host-picked `dict`.\n *\n *  Self-contained one-line string (no `<`, no `</script>`, `${}` only for the\n *  interpolated constants). */\nfunction remoteViewBootstrap(): string {\n  return `(function(){var v=window.__MC_VIEW,seq=0,pend={};window.addEventListener('message',function(e){if(e.source!==window.parent)return;var d=e.data;if(!d||d.type!=='${REMOTE_VIEW_MESSAGES.items}')return;var p=pend[d.requestId];if(!p)return;delete pend[d.requestId];clearTimeout(p.timer);if(d.ok)p.resolve(d.page);else p.reject(new Error(typeof d.error==='string'?d.error:'load failed'));});v.getItems=function(opts){opts=opts&&typeof opts==='object'?opts:{};return new Promise(function(resolve,reject){var id='q'+(++seq);var timer=setTimeout(function(){delete pend[id];reject(new Error('getItems timed out'));},${GET_ITEMS_TIMEOUT_MS});pend[id]={resolve:resolve,reject:reject,timer:timer};window.parent.postMessage({type:'${REMOTE_VIEW_MESSAGES.getItems}',slug:v.slug,requestId:id,offset:opts.offset,limit:opts.limit,fields:opts.fields},'*');});};v.startChat=function(prompt,role){window.parent.postMessage({type:'${REMOTE_VIEW_MESSAGES.startChat}',slug:v.slug,prompt:String(prompt),role:typeof role==='string'?role:undefined},'*');};v.dict=v.dict||{};v.t=function(key,named){var s=v.dict[key];if(typeof s!=='string')return typeof key==='string'?key:String(key);if(!named||typeof named!=='object')return s;return s.replace(/\\\\{(\\\\w+)\\\\}/g,function(m,n){var x=named[n];return x==null?m:String(x);});};})();`;\n}\n\n/** What the host injects into `window.__MC_VIEW` — note what is ABSENT\n *  compared to the desktop boot: no token, no dataUrl, no origin. */\nexport interface RemoteViewBoot {\n  slug: string;\n  /** Locale the dict was picked for; empty string when no translations. */\n  locale?: string;\n  /** Host-picked, locale-filtered flat string map (same contract as the\n   *  desktop custom-view dict). */\n  dict?: Record<string, string>;\n}\n\n/** Wrap a view's HTML into the sandboxed srcdoc: CSP meta + `__MC_VIEW` boot +\n *  bridge bootstrap injected at the start of `<head>` (before any view\n *  script). Runs HOST-side (`getRemoteView`) so the phone and the desktop\n *  preview receive the identical finished artifact. */\nexport function buildRemoteViewSrcdoc(html: string, boot: RemoteViewBoot): string {\n  const cspMeta = `<meta http-equiv=\"Content-Security-Policy\" content=\"${buildRemoteViewCsp()}\">`;\n  // `<`-escape the JSON so a hostile slug/dict string can't break out of the\n  // <script> element (same escape as the desktop srcdoc builder).\n  const json = JSON.stringify({\n    slug: boot.slug,\n    locale: boot.locale ?? \"\",\n    dict: boot.dict ?? {},\n    target: \"mobile\",\n    protocol: REMOTE_VIEW_PROTOCOL,\n  }).replace(/</g, \"\\\\u003c\");\n  const injection = `${cspMeta}<script>window.__MC_VIEW=${json};${remoteViewBootstrap()}</script>`;\n  if (/<head\\b[^>]*>/i.test(html)) {\n    return html.replace(/(<head\\b[^>]*>)/i, `$1${injection}`);\n  }\n  return `<!DOCTYPE html><html><head>${injection}</head><body>${html}</body></html>`;\n}\n\n/** What a parent page provides to answer the sandboxed view. Deliberately\n *  minimal — exactly the phone runtime's capabilities, nothing more, so the\n *  desktop preview can never exceed what works on the phone. */\nexport interface RemoteViewBridgeHandlers {\n  slug: string;\n  /** Answer one normalized page request (already clamped + fields-cleaned). */\n  getPage: (request: RemoteViewPageRequest) => Promise<RemoteViewPage> | RemoteViewPage;\n  /** Relay a `startChat` draft; omit on a parent without a chat surface. */\n  onStartChat?: (prompt: string, role?: string) => void;\n}\n\nasync function answerGetItems(requestId: string, request: RemoteViewPageRequest, handlers: RemoteViewBridgeHandlers, reply: RemoteViewReply): Promise<void> {\n  try {\n    const page = await handlers.getPage(request);\n    reply({ type: REMOTE_VIEW_MESSAGES.items, requestId, ok: true, page });\n  } catch (err) {\n    reply({ type: REMOTE_VIEW_MESSAGES.items, requestId, ok: false, error: err instanceof Error ? err.message : String(err) });\n  }\n}\n\ntype RemoteViewReply = (message: Record<string, unknown>) => void;\n\n/**\n * Handle one message-event payload from a sandboxed remote view. DOM- and\n * framework-free: the caller owns the `message` listener (and MUST verify\n * `event.source === iframe.contentWindow` before calling), `reply` posts the\n * response back into the iframe (targetOrigin `\"*\"` — the sandboxed document's\n * origin is opaque, so nothing else can match). Returns true when the payload\n * was a remote-view request for this slug (callers ignore everything else).\n */\nexport async function handleRemoteViewMessage(data: unknown, handlers: RemoteViewBridgeHandlers, reply: RemoteViewReply): Promise<boolean> {\n  if (typeof data !== \"object\" || data === null) return false;\n  const msg = data as {\n    type?: unknown;\n    slug?: unknown;\n    requestId?: unknown;\n    offset?: unknown;\n    limit?: unknown;\n    fields?: unknown;\n    prompt?: unknown;\n    role?: unknown;\n  };\n  if (msg.slug !== handlers.slug) return false;\n  if (msg.type === REMOTE_VIEW_MESSAGES.startChat) {\n    const prompt = typeof msg.prompt === \"string\" ? msg.prompt.trim() : \"\";\n    if (prompt) handlers.onStartChat?.(prompt, typeof msg.role === \"string\" ? msg.role : undefined);\n    return true;\n  }\n  if (msg.type !== REMOTE_VIEW_MESSAGES.getItems || typeof msg.requestId !== \"string\") return false;\n  const request: RemoteViewPageRequest = { offset: clampOffset(msg.offset), limit: clampLimit(msg.limit), fields: normalizeFields(msg.fields) };\n  await answerGetItems(msg.requestId, request, handlers, reply);\n  return true;\n}\n"],"mappings":"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"}

package/dist/{server-cmnH6g2O.cjs → server-Ch1cWphH.cjs}

@@ -546,7 +546,7 @@ function sanitizeForPrompt(value) {
 	let prev;
 	do {
 		prev = current;
-		current = current.replace(/<[^>]*>/g, "");
+		current = current.replace(/<[^>]{0,10000}>/g, "");
 	} while (current !== prev);
 	return current.replace(/`/g, "'").replace(/\$\{/g, "\\${");
 }
@@ -570,7 +570,7 @@ function sanitizeDeep(value) {
 *  collections, so it reflects what the host actually reads/writes. */
 function promptPathsFor(collection, workspaceRoot) {
 	const rel = node_path.default.relative(workspaceRoot, collection.skillDir);
-	const skillDir = rel === "" || rel.startsWith("..") ? collection.skillDir : rel;
+	const skillDir = (rel === "" || rel.startsWith("..") ? collection.skillDir : rel).split(node_path.default.sep).join("/");
 	return {
 		slug: collection.slug,
 		dataPath: collection.schema.dataPath,
@@ -859,6 +859,7 @@ var CustomViewSchema = zod.z.object({
 	id: zod.z.string().trim().min(1),
 	label: zod.z.string().trim().min(1),
 	icon: zod.z.string().trim().min(1).optional(),
+	target: zod.z.enum(["desktop", "mobile"]).optional(),
 	file: zod.z.string().trim().min(1).refine(require_collection_paths.isSafeCustomViewPath, "must be a safe path under `views/` ending in `.html` (e.g. `views/year.html`; no `..`, no leading `/`, no backslash)"),
 	i18n: zod.z.string().trim().min(1).refine(require_collection_paths.isSafeCustomViewI18nPath, "must be a safe path under `views/` ending in `.i18n.json` (e.g. `views/year.i18n.json`; no `..`, no leading `/`, no backslash)").optional(),
 	capabilities: zod.z.array(zod.z.enum(["read", "write"])).optional()
@@ -2127,4 +2128,4 @@ Object.defineProperty(exports, "writeItem", {
 	}
 });
 
-//# sourceMappingURL=server-cmnH6g2O.cjs.map
+//# sourceMappingURL=server-Ch1cWphH.cjs.map