@workflow/web 5.0.0-beta.37 → 5.0.0-beta.39

package/build/server/assets/{highlighted-body-B3W2YXNL-DE3KXslx.js → highlighted-body-B3W2YXNL-CFlRme7u.js}

@@ -2,13 +2,12 @@ import { createRequire as __wkfCreateRequire } from "node:module";
 if (typeof require === "undefined") {
   globalThis.require = __wkfCreateRequire(import.meta.url);
 }
-import { ax as R, ay as Ks, az as jsxRuntimeExports, aA as Qe } from "./server-build-C11Xqmwk.js";
-import { r as reactExports } from "./app-BaJoK9ck.js";
+import { aA as reactExports, aB as R, aC as Ks, aD as jsxRuntimeExports, aE as Qe } from "./app-Bd12Opaf.js";
 import "node:stream";
+import "stream";
 import "util";
 import "crypto";
 import "async_hooks";
-import "stream";
 import "node:crypto";
 import "node:process";
 import "node:path";
@@ -18,8 +17,8 @@ import "node:fs/promises";
 import "node:module";
 import "node:util";
 import "node:async_hooks";
-import "node:os";
 import "node:fs";
+import "node:os";
 import "node:child_process";
 import "node:timers/promises";
 import "events";

package/build/server/assets/{index-M4Ai7vsa.js → index-B6SJpqpo.js}

@@ -2,12 +2,10 @@ import { createRequire as __wkfCreateRequire } from "node:module";
 if (typeof require === "undefined") {
   globalThis.require = __wkfCreateRequire(import.meta.url);
 }
-import { H as HookSchema } from "./server-build-C11Xqmwk.js";
-import { A, a, b, c, d, e, f, g, h, i, j, k, B, C, D, l, E, m, n, o, p, q, r, s, L, M, P, t, Q, u, R, v, w, S, x, y, z, F, G, I, J, K, O, T, U, V, W, X, Y, Z, _, $, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, aa, ab, ac, ad, ae, af, ag, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw } from "./server-build-C11Xqmwk.js";
-import "./app-BaJoK9ck.js";
-import "stream";
-import "express";
+import { H as HookSchema } from "./app-Bd12Opaf.js";
+import { A, a, b, c, d, e, f, g, h, i, j, k, B, C, D, l, E, m, n, o, p, q, r, s, t, u, v, L, M, P, w, Q, x, R, y, z, S, F, G, I, J, K, O, T, U, V, W, X, Y, Z, _, $, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, aa, ab, ac, ad, ae, af, ag, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az } from "./app-Bd12Opaf.js";
 import "node:stream";
+import "stream";
 import "util";
 import "crypto";
 import "async_hooks";
@@ -20,8 +18,8 @@ import "node:fs/promises";
 import "node:module";
 import "node:util";
 import "node:async_hooks";
-import "node:os";
 import "node:fs";
+import "node:os";
 import "node:child_process";
 import "node:timers/promises";
 import "events";
@@ -45,6 +43,7 @@ import "path";
 import "fs";
 import "os";
 import "net";
+import "express";
 export {
   A as ATTRIBUTE_KEY_MAX_LENGTH,
   a as ATTRIBUTE_MAX_PER_RUN,
@@ -68,68 +67,71 @@ export {
   o as EventTypeSchema,
   p as HOOK_EVENTS_REQUIRING_EXISTENCE,
   q as HOOK_LIFECYCLE_EVENT_TYPES,
-  r as HealthCheckPayloadSchema,
-  s as HookCreatedEventSchema,
+  r as HOOK_RESUME_DEDUP_VERSION,
+  s as HOOK_RESUME_INPUT_VERSION,
+  t as HealthCheckPayloadSchema,
+  u as HookCreatedEventSchema,
+  v as HookResumeCapabilitiesSchema,
   HookSchema,
   L as LegacySerializedDataSchemaV1,
   M as MessageId,
   P as PARENT_RUN_ID_ATTRIBUTE,
-  t as PaginatedResponseSchema,
+  w as PaginatedResponseSchema,
   Q as QueuePayloadSchema,
-  u as QueuePrefix,
+  x as QueuePrefix,
   R as RESERVED_ATTRIBUTE_KEY_PREFIX,
-  v as ROOT_RUN_ID_ATTRIBUTE,
-  w as RunInputSchema,
+  y as ROOT_RUN_ID_ATTRIBUTE,
+  z as RunInputSchema,
   S as SPEC_VERSION_CURRENT,
-  x as SPEC_VERSION_LEGACY,
-  y as SPEC_VERSION_SUPPORTS_ATTRIBUTES,
-  z as SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT,
-  F as SPEC_VERSION_SUPPORTS_COMPRESSION,
-  G as STEP_EVENT_TYPES,
-  I as SerializedDataSchema,
-  J as StepSchema,
-  K as StepStatusSchema,
-  O as StructuredErrorSchema,
-  T as TERMINAL_RUN_EVENT_TYPES,
-  U as TERMINAL_STEP_EVENT_TYPES,
-  V as TERMINAL_STEP_STATUSES,
-  W as TERMINAL_WORKFLOW_RUN_STATUSES,
-  X as TerminalRunEventTypeSchema,
-  Y as TerminalStepStatusSchema,
-  Z as TerminalWorkflowRunStatusSchema,
-  _ as ValidQueueName,
-  $ as WAIT_EVENT_TYPES,
-  a0 as WaitSchema,
-  a1 as WaitStatusSchema,
-  a2 as WorkflowInvokePayloadSchema,
-  a3 as WorkflowRunBaseSchema,
-  a4 as WorkflowRunSchema,
-  a5 as WorkflowRunStatusSchema,
-  a6 as applyAttributeChanges,
-  a7 as envNumber,
-  a8 as getEventDataPayloadField,
-  a9 as getEventDataRefFields,
-  aa as getQueueTopicPrefix,
-  ab as isChildEntityCreationEvent,
-  ac as isChildEntityCreationEventType,
-  ad as isHookEventRequiringExistence,
-  ae as isHookLifecycleEventType,
-  af as isLegacySpecVersion,
-  ag as isStepEventType,
-  ah as isTerminalRunEventType,
-  ai as isTerminalStepEventType,
-  aj as isTerminalStepStatus,
-  ak as isTerminalWorkflowRunStatus,
-  al as isWaitEventType,
-  am as parseQueueName,
-  an as reenqueueActiveRuns,
-  ao as requiresNewerWorld,
-  ap as resolveQueueNamespace,
-  aq as stripEventDataRefs,
-  ar as ulidToDate,
-  as as validateAttributeChanges,
-  at as validateAttributeKey,
-  au as validateAttributeValue,
-  av as validateUlidTimestamp,
-  aw as workflowRunIdSchema
+  F as SPEC_VERSION_LEGACY,
+  G as SPEC_VERSION_SUPPORTS_ATTRIBUTES,
+  I as SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT,
+  J as SPEC_VERSION_SUPPORTS_COMPRESSION,
+  K as STEP_EVENT_TYPES,
+  O as SerializedDataSchema,
+  T as StepSchema,
+  U as StepStatusSchema,
+  V as StructuredErrorSchema,
+  W as TERMINAL_RUN_EVENT_TYPES,
+  X as TERMINAL_STEP_EVENT_TYPES,
+  Y as TERMINAL_STEP_STATUSES,
+  Z as TERMINAL_WORKFLOW_RUN_STATUSES,
+  _ as TerminalRunEventTypeSchema,
+  $ as TerminalStepStatusSchema,
+  a0 as TerminalWorkflowRunStatusSchema,
+  a1 as ValidQueueName,
+  a2 as WAIT_EVENT_TYPES,
+  a3 as WaitSchema,
+  a4 as WaitStatusSchema,
+  a5 as WorkflowInvokePayloadSchema,
+  a6 as WorkflowRunBaseSchema,
+  a7 as WorkflowRunSchema,
+  a8 as WorkflowRunStatusSchema,
+  a9 as applyAttributeChanges,
+  aa as envNumber,
+  ab as getEventDataPayloadField,
+  ac as getEventDataRefFields,
+  ad as getQueueTopicPrefix,
+  ae as isChildEntityCreationEvent,
+  af as isChildEntityCreationEventType,
+  ag as isHookEventRequiringExistence,
+  ah as isHookLifecycleEventType,
+  ai as isLegacySpecVersion,
+  aj as isStepEventType,
+  ak as isTerminalRunEventType,
+  al as isTerminalStepEventType,
+  am as isTerminalStepStatus,
+  an as isTerminalWorkflowRunStatus,
+  ao as isWaitEventType,
+  ap as parseQueueName,
+  aq as reenqueueActiveRuns,
+  ar as requiresNewerWorld,
+  as as resolveQueueNamespace,
+  at as stripEventDataRefs,
+  au as ulidToDate,
+  av as validateAttributeChanges,
+  aw as validateAttributeKey,
+  ax as validateAttributeValue,
+  ay as validateUlidTimestamp,
+  az as workflowRunIdSchema
 };

package/build/server/assets/{mermaid-3ZIDBTTL-DjL45D7x.js → mermaid-3ZIDBTTL-CQsU8DGa.js}

@@ -2,11 +2,9 @@ import { createRequire as __wkfCreateRequire } from "node:module";
 if (typeof require === "undefined") {
   globalThis.require = __wkfCreateRequire(import.meta.url);
 }
-import { N as Nt } from "./server-build-C11Xqmwk.js";
-import "./app-BaJoK9ck.js";
-import "stream";
-import "express";
+import { N as Nt } from "./app-Bd12Opaf.js";
 import "node:stream";
+import "stream";
 import "util";
 import "crypto";
 import "async_hooks";
@@ -19,8 +17,8 @@ import "node:fs/promises";
 import "node:module";
 import "node:util";
 import "node:async_hooks";
-import "node:os";
 import "node:fs";
+import "node:os";
 import "node:child_process";
 import "node:timers/promises";
 import "events";
@@ -44,6 +42,7 @@ import "path";
 import "fs";
 import "os";
 import "net";
+import "express";
 export {
   Nt as Mermaid
 };

package/build/server/assets/{token-Ulh8Tdgw.js → token-XJr1pjmC.js}

@@ -2,8 +2,7 @@ import { createRequire as __wkfCreateRequire } from "node:module";
 if (typeof require === "undefined") {
   globalThis.require = __wkfCreateRequire(import.meta.url);
 }
-import { g as getDefaultExportFromCjs } from "./app-BaJoK9ck.js";
-import { aD as requireTokenError, aC as requireTokenUtil } from "./server-build-C11Xqmwk.js";
+import { aI as requireTokenError, aH as requireTokenUtil, aG as getDefaultExportFromCjs } from "./app-Bd12Opaf.js";
 function _mergeNamespaces(n, m) {
   for (var i = 0; i < m.length; i++) {
     const e = m[i];

package/build/server/assets/{token-util-CiVcDWD3.js → token-util-BJaMxWWP.js}

@@ -2,8 +2,7 @@ import { createRequire as __wkfCreateRequire } from "node:module";
 if (typeof require === "undefined") {
   globalThis.require = __wkfCreateRequire(import.meta.url);
 }
-import { g as getDefaultExportFromCjs } from "./app-BaJoK9ck.js";
-import { aC as requireTokenUtil } from "./server-build-C11Xqmwk.js";
+import { aG as getDefaultExportFromCjs, aH as requireTokenUtil } from "./app-Bd12Opaf.js";
 function _mergeNamespaces(n, m) {
   for (var i = 0; i < m.length; i++) {
     const e = m[i];

package/build/server/assets/{zstd-browser-decoder-tQARkzJ5.js → zstd-browser-decoder-DL7Vc3pV.js}

@@ -2,11 +2,9 @@ import { createRequire as __wkfCreateRequire } from "node:module";
 if (typeof require === "undefined") {
   globalThis.require = __wkfCreateRequire(import.meta.url);
 }
-import { aB as registerZstdDecoder } from "./server-build-C11Xqmwk.js";
-import "./app-BaJoK9ck.js";
-import "stream";
-import "express";
+import { aF as registerZstdDecoder } from "./app-Bd12Opaf.js";
 import "node:stream";
+import "stream";
 import "util";
 import "crypto";
 import "async_hooks";
@@ -19,8 +17,8 @@ import "node:fs/promises";
 import "node:module";
 import "node:util";
 import "node:async_hooks";
-import "node:os";
 import "node:fs";
+import "node:os";
 import "node:child_process";
 import "node:timers/promises";
 import "events";
@@ -44,6 +42,7 @@ import "path";
 import "fs";
 import "os";
 import "net";
+import "express";
 let registered = false;
 let modulePromise;
 function loadWasmModule() {

package/build/server/index.js

@@ -2,9 +2,48 @@ import { createRequire as __wkfCreateRequire } from "node:module";
 if (typeof require === "undefined") {
   globalThis.require = __wkfCreateRequire(import.meta.url);
 }
-import { n } from "./assets/app-BaJoK9ck.js";
+import { aJ, aK } from "./assets/app-Bd12Opaf.js";
 import "express";
+import "node:stream";
 import "stream";
+import "util";
+import "crypto";
+import "async_hooks";
+import "node:crypto";
+import "node:process";
+import "node:path";
+import "node:url";
+import "module";
+import "node:fs/promises";
+import "node:module";
+import "node:util";
+import "node:async_hooks";
+import "node:fs";
+import "node:os";
+import "node:child_process";
+import "node:timers/promises";
+import "events";
+import "node:assert";
+import "node:net";
+import "node:http";
+import "node:querystring";
+import "node:events";
+import "node:diagnostics_channel";
+import "node:tls";
+import "node:buffer";
+import "node:zlib";
+import "node:perf_hooks";
+import "node:util/types";
+import "node:sqlite";
+import "node:worker_threads";
+import "node:console";
+import "node:timers";
+import "node:dns";
+import "path";
+import "fs";
+import "os";
+import "net";
 export {
-  n as app
+  aJ as app,
+  aK as createFetchHandler
 };

package/handler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Options for {@link createWorkflowWebHandler}.
+ */
+export interface CreateWorkflowWebHandlerOptions {
+  /**
+   * Mount path the dashboard is served under (e.g. `"/_workflow"`). Routing and
+   * asset URLs are reprefixed to this base. Defaults to `"/"` (root).
+   */
+  basename?: string;
+}
+
+/**
+ * Create a framework-agnostic Web `Request` -> `Response` handler that serves
+ * the Workflow observability UI (static client assets + React Router SSR)
+ * in-process, suitable for mounting inside another server under `basename`.
+ *
+ * Requires `@workflow/web` to have been built (`build/` must exist); throws
+ * otherwise.
+ */
+export function createWorkflowWebHandler(
+  options?: CreateWorkflowWebHandlerOptions
+): Promise<(request: Request) => Promise<Response>>;

package/handler.js

@@ -0,0 +1,186 @@
+/**
+ * Framework-agnostic, in-process entry point for @workflow/web.
+ *
+ * Unlike `server.js` (which starts a standalone Express HTTP server), this
+ * exports a single Web-standard fetch handler that another server can mount
+ * under an arbitrary base path — e.g. `@workflow/nitro` mounting the dashboard
+ * at `/_workflow` without spawning a second server/port.
+ *
+ *   import { createWorkflowWebHandler } from "@workflow/web/handler";
+ *   const handler = await createWorkflowWebHandler({ basename: "/_workflow" });
+ *   const response = await handler(request); // (request: Request) => Response
+ *
+ * The handler serves both the prebuilt static client assets (from `build/client`)
+ * and the React Router SSR app. It reads the prebuilt `build/` as-is in every
+ * mode (it never runs Vite), so consumers must have built @workflow/web first
+ * (the published package ships `build/`).
+ */
+
+import { existsSync } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { recordDashboard } from './registry.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const buildDir = path.resolve(__dirname, 'build');
+const clientDir = path.join(buildDir, 'client');
+const serverEntry = path.join(buildDir, 'server', 'index.js');
+
+// Minimal extension -> MIME map for serving the static client build. A wrong
+// Content-Type on the entry module breaks the whole app, so be explicit.
+const MIME_TYPES = {
+  '.js': 'text/javascript',
+  '.mjs': 'text/javascript',
+  '.css': 'text/css',
+  '.json': 'application/json',
+  '.map': 'application/json',
+  '.html': 'text/html',
+  '.ico': 'image/x-icon',
+  '.svg': 'image/svg+xml',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.webp': 'image/webp',
+  '.avif': 'image/avif',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.ttf': 'font/ttf',
+  '.otf': 'font/otf',
+  '.txt': 'text/plain',
+  '.wasm': 'application/wasm',
+};
+
+/** Normalize a mount path: `/` or empty -> "" (root); otherwise strip trailing slash. */
+function normalizeBasename(basename) {
+  if (!basename || basename === '/') return '';
+  return basename.endsWith('/') ? basename.slice(0, -1) : basename;
+}
+
+// One handler per basename, lazily constructed and memoized so repeated
+// requests reuse the same React Router handler and module import.
+const handlerCache = new Map();
+
+/**
+ * @param {{ basename?: string }} [options]
+ * @returns {Promise<(request: Request) => Promise<Response>>}
+ */
+export async function createWorkflowWebHandler(options = {}) {
+  const basename = normalizeBasename(options.basename ?? '/');
+  let promise = handlerCache.get(basename);
+  if (!promise) {
+    promise = buildHandler(basename).catch((err) => {
+      handlerCache.delete(basename);
+      throw err;
+    });
+    handlerCache.set(basename, promise);
+  }
+  return promise;
+}
+
+async function buildHandler(basename) {
+  if (!existsSync(serverEntry) || !existsSync(clientDir)) {
+    throw new Error(
+      '@workflow/web has not been built (missing build/). ' +
+        'Run `pnpm --filter @workflow/web build` before embedding the dashboard.'
+    );
+  }
+
+  const mod = await import(pathToFileURL(serverEntry).href);
+  if (typeof mod.createFetchHandler !== 'function') {
+    throw new Error(
+      '@workflow/web build does not export createFetchHandler; rebuild the package.'
+    );
+  }
+  const ssr = mod.createFetchHandler(basename || '/');
+
+  return async (request) => {
+    // Advertise this dashboard so the CLI can defer to it (best-effort, once).
+    // Done on first request because that's when the public origin is known.
+    try {
+      const origin = new URL(request.url).origin;
+      recordDashboard({
+        url: origin + basename,
+        basename,
+        world:
+          process.env.WORKFLOW_TARGET_WORLD ||
+          (process.env.VERCEL_DEPLOYMENT_ID ? 'vercel' : 'local'),
+      });
+    } catch {
+      // ignore — registration must never affect request handling
+    }
+
+    const staticResponse = await tryServeStatic(request, basename);
+    if (staticResponse) return staticResponse;
+    return ssr(request);
+  };
+}
+
+/**
+ * Resolve a request to a path-within-the-client-build (relative to `clientDir`),
+ * stripping `basename` and guarding against traversal. Returns null when the
+ * request can't map to a client file (so it should fall through to the SSR
+ * handler) — e.g. the index, a directory, or an out-of-tree path.
+ */
+function resolveClientFile(request, basename) {
+  if (request.method !== 'GET' && request.method !== 'HEAD') return null;
+
+  let pathname;
+  try {
+    pathname = decodeURIComponent(new URL(request.url).pathname);
+  } catch {
+    return null;
+  }
+
+  if (basename) {
+    if (!pathname.startsWith(`${basename}/`)) return null; // index/other -> SSR
+    pathname = pathname.slice(basename.length);
+  }
+
+  const relative = pathname.replace(/^\/+/, '');
+  if (!relative || relative.endsWith('/')) return null;
+
+  const filePath = path.join(clientDir, relative);
+  // Guard against path traversal escaping the client build directory.
+  if (filePath !== clientDir && !filePath.startsWith(clientDir + path.sep)) {
+    return null;
+  }
+  return { filePath, relative };
+}
+
+/**
+ * Serve a file from the prebuilt client bundle if the request maps to one;
+ * otherwise return null so the request falls through to the SSR handler.
+ */
+async function tryServeStatic(request, basename) {
+  const resolved = resolveClientFile(request, basename);
+  if (!resolved) return null;
+  const { filePath, relative } = resolved;
+
+  let stats;
+  try {
+    stats = await stat(filePath);
+  } catch {
+    return null;
+  }
+  if (!stats.isFile()) return null;
+
+  const ext = path.extname(filePath).toLowerCase();
+  const headers = new Headers({
+    'Content-Type': MIME_TYPES[ext] ?? 'application/octet-stream',
+    // Hashed assets are content-addressed and safe to cache forever; other
+    // client files (e.g. favicon) get a short cache.
+    'Cache-Control': relative.startsWith('assets/')
+      ? 'public, max-age=31536000, immutable'
+      : 'public, max-age=3600',
+  });
+
+  if (request.method === 'HEAD') {
+    headers.set('Content-Length', String(stats.size));
+    return new Response(null, { status: 200, headers });
+  }
+
+  const body = await readFile(filePath);
+  return new Response(body, { status: 200, headers });
+}

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@workflow/web",
   "description": "Workflow Observability UI",
-  "version": "5.0.0-beta.37",
+  "version": "5.0.0-beta.39",
   "type": "module",
   "private": false,
   "files": [
     "build",
     "server.js",
     "server.d.ts",
+    "handler.js",
+    "handler.d.ts",
+    "registry.js",
+    "registry.d.ts",
     "package.json"
   ],
   "exports": {
@@ -15,6 +19,14 @@
       "types": "./server.d.ts",
       "default": "./server.js"
     },
+    "./handler": {
+      "types": "./handler.d.ts",
+      "default": "./handler.js"
+    },
+    "./registry": {
+      "types": "./registry.d.ts",
+      "default": "./registry.js"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -29,7 +41,7 @@
   "dependencies": {
     "express": "^5.2.1",
     "swr": "^2.3.6",
-    "@workflow/world-local": "5.0.0-beta.31"
+    "@workflow/world-local": "5.0.0-beta.33"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.4",
@@ -74,12 +86,12 @@
     "typescript": "^6.0.3",
     "vite": "^6",
     "vitest": "^3.2.7",
-    "@workflow/core": "5.0.0-beta.37",
-    "@workflow/errors": "5.0.0-beta.13",
-    "@workflow/utils": "5.0.0-beta.7",
-    "@workflow/web-shared": "5.0.0-beta.37",
-    "@workflow/world": "5.0.0-beta.23",
-    "@workflow/world-vercel": "5.0.0-beta.33"
+    "@workflow/core": "5.0.0-beta.39",
+    "@workflow/errors": "5.0.0-beta.15",
+    "@workflow/utils": "5.0.0-beta.8",
+    "@workflow/web-shared": "5.0.0-beta.39",
+    "@workflow/world": "5.0.0-beta.24",
+    "@workflow/world-vercel": "5.0.0-beta.35"
   },
   "scripts": {
     "dev": "react-router dev",

package/registry.d.ts

@@ -0,0 +1,29 @@
+/** A recorded embedded-dashboard instance. */
+export interface DashboardRegistryEntry {
+  /** Public base URL the dashboard is reachable at (e.g. `http://localhost:3000/_workflow`). */
+  url: string;
+  /** Mount path the dashboard is served under (e.g. `/_workflow`; `""` at root). */
+  basename: string;
+  /** World backend identifier, for display (e.g. `local`, `@workflow/world-postgres`). */
+  world: string;
+  /** PID of the process hosting the dashboard. */
+  pid: number;
+  /** ISO timestamp the entry was recorded. */
+  startedAt: string;
+}
+
+/** Absolute path of the registry file for the current working directory. */
+export function dashboardRegistryPath(): string;
+
+/** Read the registry entries (always returns an array; never throws). */
+export function readDashboardRegistry(): DashboardRegistryEntry[];
+
+/**
+ * Record this process's embedded dashboard (idempotent per process). Entirely
+ * best-effort — never throws.
+ */
+export function recordDashboard(entry: {
+  url: string;
+  basename?: string;
+  world?: string;
+}): void;