@volter/sdk 0.5.204 → 0.5.206

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/sdk",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.204",
+  "version": "0.5.206",
   "publishConfig": {
     "access": "public"
   },
@@ -487,7 +487,7 @@
     "@fortawesome/react-fontawesome": "^3.2.0",
     "@storybook/react": "10.6.0",
     "@types/node": "^22.0.0",
-    "@volter/project": "0.5.204",
+    "@volter/project": "0.5.206",
     "mediabunny": "1.56.2",
     "postcss": "8.5.28",
     "rrweb": "2.1.6",

package/src/kit/command-listener.ts

@@ -765,17 +765,11 @@ async function handleDocumentScript(cmd: EditorCommand): Promise<CommandResult>
       data: { code: 'DOCUMENT_SCRIPT_UNAVAILABLE', documentId },
     };
   }
-  if (context === undefined) {
-    return {
-      ok: false,
-      error:
-        `document-script: the active document (${documentId}) publishes no context to run ` +
-        'against — a document opts in through its `publishContext` prop (the mesh document ' +
-        'publishes its session).',
-      data: { code: 'DOCUMENT_SCRIPT_UNAVAILABLE', documentId },
-    };
-  }
-  let step: (ctx: unknown, info: { documentId: string }) => unknown;
+  // A DOCUMENT WITH NO CONTEXT STILL HAS A PAGE. The step runs with `ctx` null and
+  // `info.context` false, so it can read what the page holds (a registry, the module-change bus,
+  // resource timing) while the UI board is the active document; refusing left no in-page door at
+  // all on that board (2026-10-08, diagnosing its hot reload). The result says it ran context-less.
+  let step: (ctx: unknown, info: { documentId: string; context: boolean }) => unknown;
   try {
     step = new Function('ctx', 'info', `return (${src})(ctx, info)`) as typeof step;
   } catch (err) {
@@ -788,8 +782,11 @@ async function handleDocumentScript(cmd: EditorCommand): Promise<CommandResult>
     };
   }
   try {
-    const result = await step(context, { documentId });
-    return { ok: true, data: { result: result === undefined ? null : result } };
+    const result = await step(context ?? null, { documentId, context: context !== undefined });
+    return {
+      ok: true,
+      data: { result: result === undefined ? null : result, ...(context === undefined ? { context: false } : {}) },
+    };
   } catch (err) {
     return {
       ok: false,

package/src/kit/components/world-documents.tsx

@@ -61,6 +61,7 @@ import { recordViewportFirstFrame } from '@volter/sdk/kit/viewport-activation-ti
 import {
   CANVAS_SCENE_DOCUMENT_ID,
   GAME_DOCUMENT_ID,
+  PINNED_ASYNC_DOCUMENT_IDS,
   SCENE_DOCUMENT_ID,
 } from '@volter/sdk/kit/workspace-document-ids';
 import {
@@ -456,6 +457,13 @@ export function installRootDocuments(
       if (open.some((document) => document.descriptor.id === documentId)) return null;
       const board = componentBoardForDocument(documentId);
       if (board) return board.presence() === 'absent' ? board.absentReason() : null;
+      // A BOARD NOT REGISTERED YET is no verdict either. Its package installs it after
+      // the session's restore has already asked for it (the UI board waits on story
+      // discovery, which waits on the first model frame), so answering "named nothing"
+      // here failed a restored board view at every start (measured 2026-10-08: "Could
+      // not restore shared editor view: No workspace document is named
+      // "workspace:ui-components"", then the board opened a few seconds later).
+      if (PINNED_ASYNC_DOCUMENT_IDS.has(documentId)) return null;
       return (
         `No workspace document is named "${documentId}". Open in this session: ` +
         `${open.map((document) => document.descriptor.id).join(', ') || '(none)'}. A component ` +