pmx-canvas 0.10.0 → 0.11.0

package/src/server/html-primitives.ts

@@ -812,13 +812,12 @@ function page(input: {
   * { box-sizing: border-box; }
   body { margin: 0; padding: 22px; background: radial-gradient(circle at top left, color-mix(in srgb, var(--color-accent, #4a9eff) 18%, transparent), transparent 34rem), var(--color-bg, #0b0f14); color: var(--color-text, #e8edf2); font-family: var(--font-sans, ui-sans-serif, system-ui, sans-serif); }
   .shell { max-width: 1160px; margin: 0 auto; }
-  header.hero { display: grid; grid-template-columns: 1fr auto; gap: 16px; align-items: start; margin-bottom: 20px; }
+  header.hero { margin-bottom: 20px; }
   .kicker { color: var(--color-accent, #4a9eff); text-transform: uppercase; letter-spacing: .16em; font-size: 11px; font-weight: 800; }
   h1 { margin: 5px 0 8px; font-size: clamp(28px, 4vw, 46px); line-height: .95; letter-spacing: -.04em; }
   h2 { margin: 0 0 12px; font-size: 19px; letter-spacing: -.02em; }
   h3 { margin: 0 0 8px; font-size: 15px; }
   p { color: var(--color-text-secondary, #aeb8c2); margin: 0 0 12px; }
-  .actions { display: flex; gap: 8px; flex-wrap: wrap; justify-content: flex-end; }
   button { border: 1px solid var(--color-border, #263241); background: var(--color-panel, #111821); color: var(--color-text, #e8edf2); border-radius: 999px; padding: 8px 12px; font: inherit; cursor: pointer; }
   button:hover { border-color: var(--color-accent, #4a9eff); transform: translateY(-1px); }
   table { width: 100%; border-collapse: collapse; color: var(--color-text-secondary, #aeb8c2); font-size: 13px; }
@@ -861,20 +860,20 @@ function page(input: {
   .slide h2 { font-size: clamp(30px, 5vw, 58px); line-height: .95; }
   .preview { white-space: pre-wrap; min-height: 220px; }
   .figure svg { width: 100%; min-height: 220px; border-radius: 14px; background: color-mix(in srgb, var(--color-bg, #0b0f14) 86%, white); border: 1px solid var(--color-border, #263241); }
-  @media (max-width: 760px) { body { padding: 14px; } header.hero, .two, .three { grid-template-columns: 1fr; } .actions { justify-content: flex-start; } .sticky { position: static; } }
+  @media (max-width: 760px) { body { padding: 14px; } .two, .three { grid-template-columns: 1fr; } .sticky { position: static; } }
 </style>
 </head>
 <body>
 <div class="shell">
   <header class="hero">
     <div><div class="kicker">PMX HTML primitive / ${escapeHtml(input.kind)}</div><h1>${escapeHtml(input.title)}</h1><p>${escapeHtml(input.summary)}</p></div>
-    <div class="actions"><button type="button" data-copy-json>Copy JSON</button><button type="button" data-copy-prompt>Copy prompt</button></div>
   </header>
   ${input.body}
 </div>
 <script type="application/json" id="pmx-data">${safeJson(input.data)}</script>
 <script>
 const PMX_DATA = JSON.parse(document.getElementById('pmx-data').textContent);
+window.__pmxGetCopyJson = () => PMX_DATA;
 function fallbackCopy(text) {
   const el = document.createElement('textarea');
   el.value = text;
@@ -890,11 +889,6 @@ async function copyText(text) {
   if (navigator.clipboard && window.isSecureContext) await navigator.clipboard.writeText(text);
   else fallbackCopy(text);
 }
-document.querySelector('[data-copy-json]')?.addEventListener('click', () => {
-  const payload = typeof window.__pmxGetCopyJson === 'function' ? window.__pmxGetCopyJson() : PMX_DATA;
-  copyText(JSON.stringify(payload, null, 2));
-});
-document.querySelector('[data-copy-prompt]')?.addEventListener('click', () => copyText('Use this PMX Canvas HTML primitive output as context:\\n\\n' + JSON.stringify(PMX_DATA, null, 2)));
 ${input.script ?? ''}
 </script>
 </body>

package/src/server/html-surface.ts

@@ -61,6 +61,14 @@ const PMX_CANVAS_THEME_TOKEN = ${token};
 window.addEventListener('message', (event) => {
   const message = event.data;
   if (event.source !== window.parent || !message || message.source !== '${HTML_SURFACE_PUSH_SOURCE}' || message.token !== PMX_CANVAS_THEME_TOKEN) return;
+  if (message.type === 'copy-json' && PMX_CANVAS_THEME_TOKEN && typeof message.requestId === 'string') {
+    let json;
+    try {
+      if (typeof window.__pmxGetCopyJson === 'function') json = JSON.stringify(window.__pmxGetCopyJson(), null, 2);
+    } catch {}
+    window.parent.postMessage({ source: '${HTML_SURFACE_PUSH_SOURCE}', type: 'copy-json-result', token: PMX_CANVAS_THEME_TOKEN, requestId: message.requestId, json }, '*');
+    return;
+  }
   if (message.type === 'check-ready') {
     const reply = (type) => window.parent.postMessage({ source: '${HTML_SURFACE_PUSH_SOURCE}', type, token: PMX_CANVAS_THEME_TOKEN }, '*');
     reply('mounted');

package/src/server/index.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'node:events';
-import type { Camera, Tour, TourStop } from '../shared/tour.js';
+import type { Camera, Tour, TourPresenter, TourStop } from '../shared/tour.js';
 import {
   currentTour,
   exitTour,
@@ -8,9 +8,10 @@ import {
   type TourState,
   type TourStep,
   type TourStepResult,
+  type TourSuperseded,
 } from './tour-control.js';
-export type { Tour, TourStop } from '../shared/tour.js';
-export type { TourState, TourStep, TourStepResult } from './tour-control.js';
+export type { Tour, TourPresenter, TourStop } from '../shared/tour.js';
+export type { TourState, TourStep, TourStepResult, TourSuperseded } from './tour-control.js';
 import { agentPresence } from './agent-presence.js';
 import { checkFenceTarget, type FenceTarget } from './scope-fence.js';
 import type { AgentPhase, AgentPresence, AgentPresenceSnapshot } from '../shared/agent-presence.js';
@@ -631,16 +632,25 @@ export class PmxCanvas extends EventEmitter {
   }
 
   /** Present a tour stop (index, `next` or `previous`) in the workbench. Not recorded in undo history. */
-  goToTourStop(step: TourStep, options?: { present?: boolean }): TourStepResult {
-    const result = goToTourStop(step);
-    emitPrimaryWorkbenchEvent('canvas-tour-step', { ...result, present: options?.present !== false });
+  goToTourStop(step: TourStep, options?: { present?: boolean; presenter?: undefined }): TourStepResult;
+  goToTourStop(
+    step: TourStep,
+    options: { present?: boolean; presenter?: TourPresenter },
+  ): TourStepResult | TourSuperseded;
+  goToTourStop(
+    step: TourStep,
+    options?: { present?: boolean; presenter?: TourPresenter },
+  ): TourStepResult | TourSuperseded {
+    const result = goToTourStop(step, options?.presenter);
+    if (!('superseded' in result))
+      emitPrimaryWorkbenchEvent('canvas-tour-step', { ...result, present: options?.present !== false });
     return result;
   }
 
   /** Leave presentation in every viewer. */
-  exitTour(): void {
-    exitTour();
-    emitPrimaryWorkbenchEvent('canvas-tour-exit', {});
+  exitTour(presenter?: TourPresenter): void {
+    const result = exitTour(presenter);
+    if (!('superseded' in result)) emitPrimaryWorkbenchEvent('canvas-tour-exit', { ...result });
   }
 
   /** Ease the camera to a node, world rect or viewport. Not recorded in undo history. */

package/src/server/operations/mcp-contracts.ts

@@ -11,6 +11,7 @@ import { tourSchema, tourStopSchema } from '../../shared/tour.js';
 const id = z.string().min(1);
 const count = z.number().int().nonnegative();
 const ok = z.looseObject({ ok: z.boolean() });
+const tourSuperseded = z.object({ ok: z.literal(true), superseded: z.literal(true) });
 const identified = z.looseObject({ id });
 const message = z.strictObject({ message: z.string() });
 const node = z.looseObject({
@@ -123,8 +124,22 @@ const payloads: Record<string, ZodType> = {
   'canvas.redo': history,
   'tour.get': z.looseObject({ tour: tourSchema, derived: z.boolean(), position: count.nullable() }),
   'tour.set': ok,
-  'tour.go': z.looseObject({ ok: z.boolean(), index: count, total: count, stop: tourStopSchema }),
-  'tour.exit': ok,
+  'tour.go': z.union([
+    z.looseObject({
+      ok: z.boolean(),
+      catalogEpoch: z.string(),
+      boardGeneration: count,
+      sequence: count,
+      index: count,
+      total: count,
+      stop: tourStopSchema,
+    }),
+    tourSuperseded,
+  ]),
+  'tour.exit': z.union([
+    z.looseObject({ ok: z.boolean(), catalogEpoch: z.string(), boardGeneration: count, sequence: count }),
+    tourSuperseded,
+  ]),
   'camera.move': z.looseObject({ ok: z.boolean(), stop: tourStopSchema, viewport }),
   arrange: z.looseObject({ ok: z.boolean(), layout: z.enum(['grid', 'column', 'flow']) }),
   'node.focus': z.looseObject({ ok: z.boolean(), focused: id, panned: z.boolean() }),

package/src/server/operations/ops/boards.ts

@@ -12,11 +12,10 @@
  *
  * This module must never import server.ts or index.ts.
  */
-import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { normalizeBoardFolder } from '../../../shared/boards.js';
 import { relationVocabularySchema } from '../../../shared/relations.js';
-import { canvasState, type CanvasLayout } from '../../canvas-state.js';
+import { boardCatalogEpoch, canvasState, type CanvasLayout } from '../../canvas-state.js';
 import { openCanvasBoard } from '../../canvas-operations.js';
 import { summarizeNodeForAgentContext } from '../../../shared/agent-context.js';
 import { BRIEF_SUMMARY_LENGTH } from '../../context-brief.js';
@@ -25,7 +24,6 @@ import { defineOperation, OperationError, type Operation, type OperationContext
 
 /** The most cards a Home thumbnail draws (the largest first); the rest are noise at that size. */
 const PREVIEW_CARDS = 24;
-export const boardCatalogEpoch = randomUUID();
 let catalogRevision = 0;
 let reloadRevision = 0;
 

package/src/server/operations/ops/viewport.ts

@@ -13,7 +13,7 @@
  * This module must never import server.ts or index.ts.
  */
 import { z } from 'zod';
-import { tourSchema, rectSchema, cameraSchema, tourStopSchema } from '../../../shared/tour.js';
+import { tourSchema, rectSchema, cameraSchema, tourStopSchema, tourPresenterSchema } from '../../../shared/tour.js';
 import { canvasState } from '../../canvas-state.js';
 import {
   arrangeCanvasNodes,
@@ -339,6 +339,7 @@ const tourGetOperation = defineOperation({
 const tourGoShape = {
   stop: z.number().int().nonnegative().optional().describe('Zero-based stop index to go to'),
   step: z.enum(['next', 'previous']).optional().describe('Step relative to the current stop (clamped at the ends)'),
+  presenter: tourPresenterSchema.optional().describe('Document intent order and expected board activation'),
   present: z
     .boolean()
     .optional()
@@ -360,23 +361,24 @@ const tourGoOperation = defineOperation({
     if ((input.stop === undefined) === (input.step === undefined)) {
       throw new OperationError('Give exactly one of stop (index) or step ("next" | "previous").');
     }
-    const result = goToTourStop(input.stop ?? (input.step as 'next' | 'previous'));
-    ctx.emit('canvas-tour-step', { ...result, present: input.present !== false });
+    const result = goToTourStop(input.stop ?? (input.step as 'next' | 'previous'), input.presenter);
+    if (!('superseded' in result)) ctx.emit('canvas-tour-step', { ...result, present: input.present !== false });
     return { ok: true, ...result };
   },
 });
 
+const tourExitShape = { presenter: tourGoShape.presenter };
 const tourExitOperation = defineOperation({
   name: 'tour.exit',
   mutates: false,
-  input: z.object({}),
-  inputShape: {},
+  input: z.object(tourExitShape),
+  inputShape: tourExitShape,
   http: { method: 'POST', path: '/api/canvas/tour/exit' },
   mcp: { toolName: 'canvas_tour_exit', description: 'Leave presentation in every viewer.' },
-  handler: (_input, ctx) => {
-    exitTour();
-    ctx.emit('canvas-tour-exit', {});
-    return { ok: true };
+  handler: (input, ctx) => {
+    const result = exitTour(input.presenter);
+    if (!('superseded' in result)) ctx.emit('canvas-tour-exit', { ...result });
+    return { ok: true, ...result };
   },
 });
 

package/src/server/server.ts

@@ -47,8 +47,8 @@ import { basename, extname, isAbsolute, join, relative, resolve, sep } from 'nod
 import * as marked from 'marked';
 import { renderWikiMarkdown, resolveWikiLinks, wikiReferences } from './wiki-links.js';
 import { wikiLinksFromData } from '../shared/memory-graph.js';
-import { type CanvasNodeState, IMAGE_MIME_MAP, canvasState } from './canvas-state.js';
-import { boardCatalogEpoch, boardsPayload } from './operations/ops/boards.js';
+import { type CanvasNodeState, IMAGE_MIME_MAP, boardCatalogEpoch, canvasState } from './canvas-state.js';
+import { boardsPayload } from './operations/ops/boards.js';
 import {
   buildAxBridge,
   buildAxStateBridge,
@@ -72,7 +72,7 @@ import { buildAgentContextPreamble } from '../shared/agent-context.js';
 import { buildCanvasAxSurfaceSnapshot } from './ax-context.js';
 import { resolveNodeAxCapabilities } from './ax-interaction.js';
 import { normalizeCanvasTheme, type CanvasTheme } from './canvas-db.js';
-import { canvasThemeScheme, isCanvasTheme } from '../shared/themes.js';
+import { isCanvasTheme } from '../shared/themes.js';
 import { canOpenNodeAsSurface } from '../shared/surface.js';
 import { validateLocalImageFile } from './image-source.js';
 import {
@@ -1504,44 +1504,6 @@ function handleIframeProbe(): Response {
   );
 }
 
-// ── Ext-app recovery diagnostics (0.3.2 report Finding N) ──────
-//
-// The WebKit black-tile recovery trail is otherwise trapped inside host panels
-// without devtools (the Copilot WKWebView). Clients mirror their bounded
-// recovery log here; agents/testers read it back over HTTP. In-memory only,
-// diagnostics-grade: no persistence, no snapshots.
-const EXT_APP_RECOVERY_LOG_MAX = 500;
-const EXT_APP_RECOVERY_FIELD_MAX = 300;
-const extAppRecoveryEntries: Array<Record<string, unknown>> = [];
-
-/**
- * Clamp a reported entry to the known trail shape ({ t, nodeId, event,
- * visibility }) with bounded string lengths. The count trim below caps the
- * number of entries; this caps bytes per entry, so the in-memory log stays
- * diagnostics-sized no matter what a client posts.
- */
-function clampExtAppRecoveryEntry(entry: Record<string, unknown>): Record<string, unknown> {
-  const clamped: Record<string, unknown> = {};
-  if (typeof entry.t === 'number' && Number.isFinite(entry.t)) clamped.t = entry.t;
-  for (const key of ['nodeId', 'event', 'visibility'] as const) {
-    const value = entry[key];
-    if (typeof value === 'string') clamped[key] = value.slice(0, EXT_APP_RECOVERY_FIELD_MAX);
-  }
-  return clamped;
-}
-
-function handleExtAppRecoveryReport(entries: unknown): Response {
-  if (!Array.isArray(entries)) return responseJson({ ok: false, error: 'entries must be an array' }, 400);
-  for (const entry of entries.slice(0, 100)) {
-    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) continue;
-    extAppRecoveryEntries.push(clampExtAppRecoveryEntry(entry as Record<string, unknown>));
-  }
-  if (extAppRecoveryEntries.length > EXT_APP_RECOVERY_LOG_MAX) {
-    extAppRecoveryEntries.splice(0, extAppRecoveryEntries.length - EXT_APP_RECOVERY_LOG_MAX);
-  }
-  return responseJson({ ok: true, total: extAppRecoveryEntries.length });
-}
-
 // ── Node surfaces ("Open as site") ─────────────────────────────
 //
 // One stable, node-addressable URL — /api/canvas/surface/:nodeId — that serves
@@ -1841,14 +1803,7 @@ async function handleJsonRenderView(url: URL): Promise<Response> {
   );
 
   const themeValue = url.searchParams.get('theme');
-  // The viewer bundle themes dark/light/high-contrast directly; other named
-  // canvas themes (midnight, sepia, …) collapse to their dark/light scheme.
-  const theme =
-    themeValue === 'dark' || themeValue === 'light' || themeValue === 'high-contrast'
-      ? themeValue
-      : isCanvasTheme(themeValue)
-        ? canvasThemeScheme(themeValue)
-        : undefined;
+  const theme = themeValue === 'dark' || themeValue === 'light' || isCanvasTheme(themeValue) ? themeValue : 'harbor';
   const title = (node.data.title as string) || node.id;
   // Devtools panel is double-gated: the operator must opt in via the env flag
   // AND the request must carry ?devtools=1. Off by default in all normal runs.
@@ -2274,6 +2229,9 @@ function buildWorkbenchConnectSnapshot(
       timestamp: new Date().toISOString(),
     },
   });
+  // Establish ownership in this ordered stream before layouts and live tour
+  // commands. The separate catalog HTTP response may arrive after either.
+  events.push({ event: 'boards-changed', payload: boardsPayload() });
   if (primaryWorkbenchPath) {
     events.push({
       event: 'workbench-open',
@@ -3571,16 +3529,6 @@ export function startCanvasServer(options: CanvasServerOptions = {}): string | n
             return handleJsonRenderView(url);
           }
 
-          if (url.pathname === '/api/canvas/debug/ext-app-recovery' && req.method === 'POST') {
-            const body = await readJson(req);
-            if (body === null) return malformedJsonResponse();
-            return handleExtAppRecoveryReport(body.entries);
-          }
-
-          if (url.pathname === '/api/canvas/debug/ext-app-recovery' && req.method === 'GET') {
-            return responseJson({ ok: true, entries: extAppRecoveryEntries });
-          }
-
           if (url.pathname === '/api/canvas/frame-documents' && req.method === 'POST') {
             return handleCreateFrameDocument(req);
           }

package/src/server/tour-control.ts

@@ -8,19 +8,38 @@
  *
  * This module must never import server.ts or index.ts.
  */
-import { derivedTour, resolveStop, tourStopSchema, type Camera, type Tour, type TourStop } from '../shared/tour.js';
-import { canvasState } from './canvas-state.js';
+import {
+  derivedTour,
+  resolveStop,
+  tourPresenterSchema,
+  tourStopSchema,
+  type Camera,
+  type Tour,
+  type TourPresenter,
+  type TourStop,
+} from '../shared/tour.js';
+import { boardCatalogEpoch, canvasState } from './canvas-state.js';
 import { getClientViewportSize } from './canvas-operations.js';
 import { OperationError } from './operations/types.js';
 
 export type TourStep = number | 'next' | 'previous';
 
-export interface TourStepResult {
+export interface TourDelivery {
+  catalogEpoch: string;
+  boardGeneration: number;
+  sequence: number;
+}
+
+export interface TourStepResult extends TourDelivery {
   index: number;
   total: number;
   stop: TourStop;
 }
 
+export interface TourSuperseded {
+  superseded: true;
+}
+
 export interface TourState {
   tour: Tour;
   derived: boolean;
@@ -28,6 +47,35 @@ export interface TourState {
 }
 
 let cursor: { boardGeneration: number; tour: string; index: number } | null = null;
+// One order for both HTTP acknowledgements and event delivery in this server run.
+let sequence = 0;
+let presenterGeneration = -1;
+const presenterIntents = new Map<string, number>();
+
+function claimPresenter(presenter: TourPresenter | undefined): boolean {
+  if (presenter === undefined) return true;
+  const { clientId, intent, catalogEpoch, boardGeneration } = tourPresenterSchema.parse(presenter);
+  if (catalogEpoch !== boardCatalogEpoch || boardGeneration !== canvasState.boardGeneration) return false;
+  if (presenterGeneration !== boardGeneration) {
+    presenterIntents.clear();
+    presenterGeneration = boardGeneration;
+  }
+  const previous = presenterIntents.get(clientId);
+  if (previous !== undefined && intent <= previous) return false;
+  // Never evict an identity: that would make its delayed requests valid again.
+  if (previous === undefined && presenterIntents.size >= 4096)
+    throw new OperationError(
+      'Too many presentation documents on this board activation. Reopen the board to continue.',
+      409,
+    );
+  // Even a later invalid stop supersedes older commands. Claim before resolving it.
+  presenterIntents.set(clientId, intent);
+  return true;
+}
+
+function nextDelivery(): TourDelivery {
+  return { catalogEpoch: boardCatalogEpoch, boardGeneration: canvasState.boardGeneration, sequence: ++sequence };
+}
 
 export function currentTour(): TourState {
   const saved = canvasState.getTour();
@@ -44,7 +92,10 @@ function tourPosition(tour: Tour): number | null {
 }
 
 /** Move the shared cursor. `next`/`previous` clamp at the ends; an explicit index must exist. */
-export function goToTourStop(step: TourStep): TourStepResult {
+export function goToTourStop(step: TourStep): TourStepResult;
+export function goToTourStop(step: TourStep, presenter: TourPresenter | undefined): TourStepResult | TourSuperseded;
+export function goToTourStop(step: TourStep, presenter?: TourPresenter): TourStepResult | TourSuperseded {
+  if (!claimPresenter(presenter)) return { superseded: true };
   const { tour, position: at } = currentTour();
   const { stops } = tour;
   if (stops.length === 0) {
@@ -56,11 +107,20 @@ export function goToTourStop(step: TourStep): TourStepResult {
   else if (Number.isInteger(step) && step >= 0 && step < stops.length) index = step;
   else throw new OperationError(`Tour stop ${step} does not exist (stops 0–${stops.length - 1}).`, 400);
   cursor = { boardGeneration: canvasState.boardGeneration, tour: JSON.stringify(tour), index };
-  return { index, total: stops.length, stop: stops[index] as TourStop };
+  return {
+    ...nextDelivery(),
+    index,
+    total: stops.length,
+    stop: stops[index] as TourStop,
+  };
 }
 
-export function exitTour(): void {
+export function exitTour(): TourDelivery;
+export function exitTour(presenter: TourPresenter | undefined): TourDelivery | TourSuperseded;
+export function exitTour(presenter?: TourPresenter): TourDelivery | TourSuperseded {
+  if (!claimPresenter(presenter)) return { superseded: true };
   cursor = null;
+  return nextDelivery();
 }
 
 /**

package/src/shared/ax-surface-protocol.ts

@@ -20,14 +20,3 @@ export const HTML_SURFACE_PUSH_SOURCE = 'pmx-canvas-html-node';
 
 /** Tab-local JSON viewer state handoff, independent of AX capabilities. */
 export const JSON_VIEWER_STATE_SOURCE = 'pmx-canvas-json-state';
-
-/** Ext-app boot beacon: the iframe's scripts executed (WebKit watchdog liveness). */
-export const EXT_APP_BOOT_BEACON_SOURCE = 'pmx-canvas-ext-app-alive';
-
-/**
- * Parent→ext-app paint probe (Finding N): the parent asks the app document to
- * answer with a double-rAF `paint-tick` beacon. A frame whose rendering
- * pipeline is live answers within a frame or two; silence past the timeout is
- * the paint-fail signal that drives the recovery ladder.
- */
-export const EXT_APP_PAINT_PROBE_SOURCE = 'pmx-canvas-ext-app-paint-probe';

package/src/shared/content-height-reporter.ts

@@ -22,11 +22,12 @@ export function sanitizeFrameToken(token: string): string {
 export function contentHeightReporterSource(frameToken: string): string {
   const token = JSON.stringify(sanitizeFrameToken(frameToken));
   return (
-    `(function(){var T=${token};var last=0,timer=null;` +
+    `(function(){var T=${token};var last=0,lastViewport=0,timer=null;` +
     `function m(){var d=document.documentElement;return Math.max(d?d.scrollHeight:0,document.body?document.body.scrollHeight:0);}` +
-    `function r(){var h=m();if(Math.abs(h-last)<=4)return;last=h;window.parent.postMessage({source:'pmx-canvas-frame',type:'content-height',token:T,height:h},'*');}` +
+    `function r(force){var h=m(),v=window.innerHeight;if(!force&&Math.abs(h-last)<=4&&v===lastViewport)return;last=h;lastViewport=v;window.parent.postMessage({source:'pmx-canvas-frame',type:'content-height',token:T,height:h},'*');}` +
     `function s(){if(timer)return;timer=setTimeout(function(){timer=null;r();},100);}` +
-    `if(document.readyState!=='loading')s();window.addEventListener('load',s,true);` +
+    `window.addEventListener('message',function(e){var d=e.data;if(e.source===window.parent&&d&&d.source==='pmx-canvas-frame'&&d.type==='measure-content'&&d.token===T)r(true);});` +
+    `if(document.readyState!=='loading')s();window.addEventListener('load',s,true);window.addEventListener('resize',s);` +
     `try{new ResizeObserver(s).observe(document.documentElement);}catch(e){}` +
     `new MutationObserver(s).observe(document.documentElement,{subtree:true,childList:true,characterData:true,attributes:true});` +
     `if(document.fonts)document.fonts.ready.then(s);setTimeout(s,60);})();`

package/src/shared/tour.ts

@@ -21,6 +21,14 @@ export const tourStopSchema = z.object({
   pullback: z.number().min(0).max(4).optional(),
 });
 export const tourSchema = z.object({ stops: z.array(tourStopSchema).max(1000) });
+/** Latest intent from one document, scoped to the server's board activation. */
+export const tourPresenterSchema = z.object({
+  clientId: z.string().min(1).max(128),
+  intent: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+  catalogEpoch: z.string().min(1).max(128),
+  boardGeneration: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
+});
+export type TourPresenter = z.infer<typeof tourPresenterSchema>;
 export type Tour = z.infer<typeof tourSchema>;
 export type TourStop = z.infer<typeof tourStopSchema>;
 export type Camera = z.infer<typeof cameraSchema>;