@volter/editor-core 0.5.59 → 0.5.61

package/BUNDLED_NOTICES

@@ -31,7 +31,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
-@volter/editor-project@0.5.59
+@volter/editor-project@0.5.61
 Declared license: Apache-2.0
 
 --- packages/editor-project/LICENSE ---
@@ -240,7 +240,7 @@ Declared license: Apache-2.0
    limitations under the License.
 
 
-@volter/editor-sdk@0.5.59
+@volter/editor-sdk@0.5.61
 Declared license: Apache-2.0
 
 --- packages/editor-sdk/LICENSE ---
@@ -461,7 +461,7 @@ The project output-root policy is Apache-2.0, transferred from the original
 SDK; its exact source is recorded in provenance/editor-server.json.
 
 
-@volter/editor-threejs@0.5.59
+@volter/editor-threejs@0.5.61
 Declared license: AGPL-3.0-only AND Apache-2.0
 
 --- packages/editor-threejs/LICENSE ---

package/dist-server/packaged.mjs

@@ -77339,11 +77339,12 @@ function createControlPlane(router, ctx) {
     if (typeof type === "string") {
       const contributed = contributedCommandTimeouts.get(type);
       if (contributed !== void 0) return contributed;
+      if (!isRelayCommandType(type)) return RELAY_DELIVERY_MAX_WAIT_MS;
     }
     return relayCommandTimeoutMs(type);
   }
   function commandAckDeadlineMs(type) {
-    if (typeof type === "string" && contributedCommandTimeouts.has(type))
+    if (typeof type === "string" && !isRelayCommandType(type))
       return commandTimeoutMs(type) > RELAY_DELIVERY_ACK_MS ? RELAY_DELIVERY_ACK_MS : null;
     return relayCommandAckDeadlineMs(type);
   }
@@ -77365,6 +77366,10 @@ function createControlPlane(router, ctx) {
     }
     contributedCommandTimeouts.clear();
     for (const [type, timeoutMs] of next) contributedCommandTimeouts.set(type, timeoutMs);
+    for (const pending of pendingCommands.values()) {
+      const type = pending.command?.["type"];
+      if (typeof type === "string" && next.has(type)) pending.refreshWorkTimer?.();
+    }
     return CONTROL_OK;
   }
   function armDeliveryReceiptWindow(requestId, type) {
@@ -78089,7 +78094,8 @@ data: ${data}
     }
     const requestId = randomUUID11();
     const commandWithId = { ...body, _requestId: requestId };
-    const timeoutMs = commandTimeoutMs(body["type"]);
+    let timeoutMs = commandTimeoutMs(body["type"]);
+    let workStartedAt = Date.now();
     const hasSeparateDeliveryBudget = commandAckDeadlineMs(body["type"]) !== null;
     const resultPromise = new Promise((resolve37) => {
       const expire = () => {
@@ -78128,18 +78134,24 @@ data: ${data}
         });
       };
       const timer = setTimeout(expire, timeoutMs);
+      const refreshWorkTimer = () => {
+        const pending = pendingCommands.get(requestId);
+        if (pending === void 0) return;
+        timeoutMs = commandTimeoutMs(body["type"]);
+        clearTimeout(pending.timer);
+        pending.timer = setTimeout(expire, Math.max(0, workStartedAt + timeoutMs - Date.now()));
+      };
       pendingCommands.set(requestId, {
         resolve: resolve37,
         timer,
         tabId: targetTabId,
         command: commandWithId,
+        refreshWorkTimer,
         epochAtRelay: table?.tab(targetTabId)?.epochCount ?? 0,
         ...hasSeparateDeliveryBudget ? {
           restartWorkTimerAfterReceipt: () => {
-            const pending = pendingCommands.get(requestId);
-            if (pending === void 0) return;
-            clearTimeout(pending.timer);
-            pending.timer = setTimeout(expire, timeoutMs);
+            workStartedAt = Date.now();
+            refreshWorkTimer();
           }
         } : {}
       });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/editor-core",
   "author": "Volter AI, Inc.",
-  "version": "0.5.59",
+  "version": "0.5.61",
   "publishConfig": {
     "access": "public"
   },
@@ -82,9 +82,9 @@
     "three.quarks": "0.16.0",
     "typescript": "5.9.3",
     "zod": "4.3.6",
-    "@volter/editor-project": "0.5.59",
-    "@volter/editor-sdk": "0.5.59",
-    "@volter/editor-threejs": "0.5.59",
+    "@volter/editor-project": "0.5.61",
+    "@volter/editor-sdk": "0.5.61",
+    "@volter/editor-threejs": "0.5.61",
     "vite": "^6.4.3",
     "express": "^5.2.1",
     "chokidar": "^5.0.0",

package/server/routes/control-plane.ts

@@ -31,6 +31,7 @@ import {
   parseEditorControlLifecycle,
 } from '@volter/editor-sdk/session/editor-control-lifecycle';
 import { COMMAND_RESULT_RECEIPT_EVENT } from '@volter/editor-sdk/session/editor-control-protocol';
+import { isRelayCommandType } from '@volter/editor-sdk/session/command-table';
 import type { Request, Response } from 'express';
 import {
   ABNORMAL_SOCKET_CLOSE,
@@ -358,6 +359,8 @@ export function createControlPlane(router: EditorServerRouter, ctx: RouteContext
        *  restarts it so time spent queued behind a blocked main thread cannot
        *  consume the work budget before the page begins the work. */
       restartWorkTimerAfterReceipt?: () => void;
+      /** Adopt a late contribution's declared budget without resetting elapsed work. */
+      refreshWorkTimer?: () => void;
       controller?: EditorEventClient;
       controllerClientId?: string;
     }
@@ -460,11 +463,14 @@ export function createControlPlane(router: EditorServerRouter, ctx: RouteContext
     if (typeof type === 'string') {
       const contributed = contributedCommandTimeouts.get(type);
       if (contributed !== undefined) return contributed;
+      // The listener can receive a package command before discovery reports
+      // its row. Allow bounded discovery, then adopt its real work budget.
+      if (!isRelayCommandType(type)) return RELAY_DELIVERY_MAX_WAIT_MS;
     }
     return relayCommandTimeoutMs(type);
   }
   function commandAckDeadlineMs(type: unknown): number | null {
-    if (typeof type === 'string' && contributedCommandTimeouts.has(type))
+    if (typeof type === 'string' && !isRelayCommandType(type))
       return commandTimeoutMs(type) > RELAY_DELIVERY_ACK_MS ? RELAY_DELIVERY_ACK_MS : null;
     return relayCommandAckDeadlineMs(type);
   }
@@ -486,6 +492,10 @@ export function createControlPlane(router: EditorServerRouter, ctx: RouteContext
     }
     contributedCommandTimeouts.clear();
     for (const [type, timeoutMs] of next) contributedCommandTimeouts.set(type, timeoutMs);
+    for (const pending of pendingCommands.values()) {
+      const type = pending.command?.['type'];
+      if (typeof type === 'string' && next.has(type)) pending.refreshWorkTimer?.();
+    }
     return CONTROL_OK;
   }
 
@@ -1703,7 +1713,8 @@ export function createControlPlane(router: EditorServerRouter, ctx: RouteContext
     const requestId = randomUUID();
     const commandWithId = { ...body, _requestId: requestId };
 
-    const timeoutMs = commandTimeoutMs(body['type']);
+    let timeoutMs = commandTimeoutMs(body['type']);
+    let workStartedAt = Date.now();
     const hasSeparateDeliveryBudget = commandAckDeadlineMs(body['type']) !== null;
     const resultPromise = new Promise<SettledCommandResult>((resolve) => {
       const expire = (): void => {
@@ -1752,19 +1763,25 @@ export function createControlPlane(router: EditorServerRouter, ctx: RouteContext
         });
       };
       const timer = setTimeout(expire, timeoutMs);
+      const refreshWorkTimer = (): void => {
+        const pending = pendingCommands.get(requestId);
+        if (pending === undefined) return;
+        timeoutMs = commandTimeoutMs(body['type']);
+        clearTimeout(pending.timer);
+        pending.timer = setTimeout(expire, Math.max(0, workStartedAt + timeoutMs - Date.now()));
+      };
       pendingCommands.set(requestId, {
         resolve,
         timer,
         tabId: targetTabId,
         command: commandWithId,
+        refreshWorkTimer,
         epochAtRelay: table?.tab(targetTabId)?.epochCount ?? 0,
         ...(hasSeparateDeliveryBudget
           ? {
               restartWorkTimerAfterReceipt: () => {
-                const pending = pendingCommands.get(requestId);
-                if (pending === undefined) return;
-                clearTimeout(pending.timer);
-                pending.timer = setTimeout(expire, timeoutMs);
+                workStartedAt = Date.now();
+                refreshWorkTimer();
               },
             }
           : {}),

package/src/command-listener.ts

@@ -51,7 +51,7 @@ import {
 } from './authoring/shell-document-ops';
 import { parseCameraChoice, parsePoseChoice } from './capture-camera-pose';
 import { noteCommandDispatched } from './command-dispatch';
-import { contributedCommand, contributedCommandDerivedRefresh } from './command-registry';
+import { resolveContributedCommand, contributedCommandDerivedRefresh } from './command-registry';
 import {
   isAssetDocumentId,
   openAssetDocument,
@@ -1237,7 +1237,7 @@ export async function handleCommand(
   // answered by its own handler, through the same relay, ack and derivation
   // as the host's table below. Asked first so a contributed verb never
   // reads as "editor page predates this CLI".
-  const contributed = contributedCommand(cmd['type']);
+  const contributed = await resolveContributedCommand(cmd['type']);
   if (contributed) {
     try {
       const answer = await contributed.handle(cmd);

package/src/command-registry.ts

@@ -55,6 +55,17 @@ export function contributedCommand(type: unknown): CommandSpec | null {
   return typeof type === 'string' ? (registered.get(type)?.spec ?? null) : null;
 }
 
+/** A listener can attach before the presentation-deferred contribution pass.
+ * A requested package command needs that pass now; absence is only meaningful
+ * after the current project's contributions have finished installing. */
+export async function resolveContributedCommand(type: unknown): Promise<CommandSpec | null> {
+  const found = contributedCommand(type);
+  if (found || typeof type !== 'string' || isRelayCommandType(type)) return found;
+  await (await import('./initial-project')).projectBootstrapSettled();
+  await (await import('./tool-loader')).refreshProjectToolContributions();
+  return contributedCommand(type);
+}
+
 export function contributedCommandDerivedRefresh(type: unknown): CommandDerivedRefresh | null {
   const spec = contributedCommand(type);
   return spec ? (spec.derivedRefresh ?? 'always') : null;

package/src/editor-host-door.ts

@@ -32,6 +32,7 @@ import {
 } from './document-context-registry';
 import { openRegisteredDocumentAsync } from './document-open-registry';
 import { editorConsole } from './editor-console';
+import { resolvedProjectDocumentTable } from './project-adapter';
 import { notify } from './editor-notifications';
 import { registerEditorStateFacet } from './editor-state-facets';
 import { setFilesProvider } from './files/file-provider';
@@ -259,6 +260,7 @@ export function installEditorHostDoor(): void {
       reportWorkerCallMeter: setBlenderCallMeter,
     },
     project: {
+      documentTable: resolvedProjectDocumentTable,
       mounts: projectMounts,
       // The ONE reading of the pinned engine version — `ProjectHeader.tsx`'s
       // `v{engineVersion}` and a package's status item are the same number

package/src/project-adapter.ts

@@ -255,6 +255,19 @@ export function waitForProjectAdapter(): Promise<void> {
   });
 }
 
+/** A package opening a document during boot needs the final finder-backed
+ * table, not the initial declaration with contributed finders still pending. */
+export async function resolvedProjectDocumentTable(): Promise<ResolvedDocumentTable> {
+  await (await import('./initial-project')).projectBootstrapSettled();
+  await refreshProjectToolContributions();
+  await refreshProjectAdapter();
+  while (_inFlight) await _inFlight;
+  const facet = projectAdapterFacet();
+  if (!facet || facet.documentsPending)
+    throw new Error('The project document table could not finish loading; inspect the project diagnostics.');
+  return facet.scenes;
+}
+
 export function subscribeProjectAdapter(fn: () => void): () => void {
   _listeners.add(fn);
   return () => _listeners.delete(fn);