@volter/sdk 0.5.205 → 0.5.207

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/sdk",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.205",
+  "version": "0.5.207",
   "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.205",
+    "@volter/project": "0.5.207",
     "mediabunny": "1.56.2",
     "postcss": "8.5.28",
     "rrweb": "2.1.6",

package/src/kit/account-client.ts

@@ -15,6 +15,7 @@ import {
   generationAccountProjection,
   ProviderCredentialTestResultSchema,
 } from '@volter/sdk/account';
+import { LIMITED_VIEW_HEADER } from '@volter/sdk/session/limited-view';
 import { assertEditorServerAnswered } from '@volter/sdk/kit/editor-server-response';
 import { COLLABORATION_REMOTE_SHARE } from '@volter/sdk/kit/editor-session-attribution';
 
@@ -88,9 +89,14 @@ export function subscribeAccount(listener: () => void): () => void {
   listeners.add(listener);
   return () => listeners.delete(listener);
 }
+/** A limited view has no account service and says so once (`x-volter-limited-view: unavailable`);
+ *  asking again every 30 s only fills the page's network log with 503s. */
+let accountUnavailable = false;
 export async function refreshAccount(): Promise<EditorAccountSnapshot> {
   try {
-    const next = await responseSnapshot(await fetch('/__editor/account'), 'Account read failed');
+    const response = await fetch('/__editor/account');
+    if (response.headers.get(LIMITED_VIEW_HEADER) === 'unavailable') accountUnavailable = true;
+    const next = await responseSnapshot(response, 'Account read failed');
     publish(next);
     return next;
   } catch (cause) {
@@ -328,6 +334,6 @@ export function startAccountActivity(): () => void {
   } else {
     void refreshAccount().catch(() => undefined);
   }
-  const timer = window.setInterval(() => void refreshAccount().catch(() => undefined), 30_000);
+  const timer = window.setInterval(() => { if (!accountUnavailable) void refreshAccount().catch(() => undefined); }, 30_000);
   return () => window.clearInterval(timer);
 }

package/src/kit/api/project-open.ts

@@ -202,6 +202,20 @@ export async function revealInFinder(targetPath: string): Promise<void> {
   assertEditorServerResponse(res, `Could not reveal ${targetPath}`);
 }
 
+/**
+ * The file manager `revealInFinder` opens, named for the menus that offer it: Finder on a Mac,
+ * File Explorer on Windows (`explorer /select,`), the desktop's file manager elsewhere (`xdg-open`
+ * on the containing folder). `/__editor/reveal` is never shared (`NEVER_SHARE_PATHS`), so the
+ * person who can use it is at the host and the browser's platform is the host's — WSL aside,
+ * where the label is only a word.
+ */
+export function fileManagerName(): string {
+  const platform = typeof navigator === 'undefined' ? '' : navigator.platform;
+  if (platform.includes('Mac')) return 'Finder';
+  if (platform.startsWith('Win')) return 'File Explorer';
+  return 'File Manager';
+}
+
 /** Save a viewport thumbnail for the current project — background bookkeeping
  *  for the recent-projects list, not a user-facing promise. */
 export async function saveThumbnail(dataUrl: string): Promise<boolean> {

package/src/kit/components/ProjectHeader.tsx

@@ -24,7 +24,7 @@ import {
   contributedHeaderItems,
   subscribeContributedChrome,
 } from '@volter/sdk/kit/chrome-registry';
-import { revealInFinder } from '@volter/sdk/kit/editor-api';
+import { fileManagerName, revealInFinder } from '@volter/sdk/kit/editor-api';
 import { getCurrentProject, onProjectChange } from '@volter/sdk/kit/project-manager';
 import {
   activeEditorWorkspace,
@@ -212,7 +212,7 @@ export function ProjectHeader({
                     revealInFinder(projectPath);
                   }}
                 >
-                  Show in Finder
+                  Show in {fileManagerName()}
                 </MenuItem>
               )}
               <MenuItem

package/src/kit/components/status-contributions.tsx

@@ -62,6 +62,12 @@ import {
   subscribeEditorLeaseView,
 } from '../editor-lease-view';
 import { useEditorStore } from '@volter/sdk/kit/editor-runtime';
+import { documentPlayState, subscribeDocumentPlayState } from '@volter/sdk/kit/document-play-extension';
+import {
+  openWorkspaceDocuments,
+  subscribeWorkspaceDocuments,
+  workspaceDocumentRegistryVersion,
+} from '@volter/sdk/kit/workspace-document-registry';
 import { createHmrRegistrationGroup, type HmrRegistrationContext } from '@volter/sdk/kit/hmr-registration-group';
 import { useProjectMounts } from '../project-shape';
 import { getStorageBackend } from '@volter/sdk/kit/storage/index';
@@ -211,6 +217,19 @@ export function AssetMaterializationStatus() {
   );
 }
 
+/** The open documents' own Play, as one word: playing if any plays, else paused if any is paused. */
+function openDocumentsPlayState(): 'playing' | 'paused' | 'stopped' {
+  let paused = false;
+  for (const document of openWorkspaceDocuments()) {
+    const state = documentPlayState(document.descriptor.id);
+    if (state === 'playing') return 'playing';
+    if (state === 'paused') paused = true;
+  }
+  return paused ? 'paused' : 'stopped';
+}
+
+const stoppedOnServer = (): 'stopped' => 'stopped';
+
 /** §4.1 play state ("Play stopped" quiet; running/paused colored). */
 export function PlayStateStatus() {
   // EVERY hook above the first early return. This component rendered one hook
@@ -222,8 +241,14 @@ export function PlayStateStatus() {
   const mounts = useProjectMounts();
   const store = useEditorStore();
   useSyncExternalStore(store.subscribe, store.getShellSnapshot ?? store.getSnapshot);
+  // A DOCUMENT'S OWN PLAY is Play too. Cyclotron's Play runs a model's play script through the
+  // document Play tool, not the store's game, so this said "Play stopped" while the race ran (the
+  // 0.5.206 blind walk). Any open document counts, not only the active one: a source file opened
+  // beside a running race does not stop it. The store's game wins when it runs.
+  useSyncExternalStore(subscribeWorkspaceDocuments, workspaceDocumentRegistryVersion, workspaceDocumentRegistryVersion);
+  const documentPlay = useSyncExternalStore(subscribeDocumentPlayState, openDocumentsPlayState, stoppedOnServer);
   if (!mounts) return null;
-  const state = store.playState;
+  const state = store.playState === 'stopped' ? documentPlay : store.playState;
   const view = {
     stopped: { label: 'Play stopped', tone: undefined },
     playing: { label: 'Playing', tone: 'success' },

package/src/kit/document-play-extension.ts

@@ -208,6 +208,32 @@ export function subscribeDocumentPlayExtensions(listener: () => void): () => voi
   registry.listeners.add(listener);
   return () => { registry.listeners.delete(listener); };
 }
+/** Whether a document's own Play runs, and whether it is paused: what a status line says. */
+export function documentPlayState(documentId: string): 'playing' | 'paused' | 'stopped' {
+  for (const extension of registry.extensions.values()) {
+    if (!extension.playing(documentId)) continue;
+    return extension.transport?.clock(documentId).paused ? 'paused' : 'playing';
+  }
+  return 'stopped';
+}
+/** Every Play start and stop, and every tool's clock (a pause is a clock change). The clock moves
+ *  every played frame, so this is for a reader whose snapshot changes rarely. */
+export function subscribeDocumentPlayState(listener: () => void): () => void {
+  let clocks: (() => void)[] = [];
+  const rebind = (): void => {
+    for (const stop of clocks) stop();
+    clocks = [...registry.extensions.values()].flatMap((extension) =>
+      extension.transport ? [extension.transport.subscribeClock(listener)] : []);
+  };
+  const onRegistry = (): void => { rebind(); listener(); };
+  registry.listeners.add(onRegistry);
+  rebind();
+  return () => {
+    registry.listeners.delete(onRegistry);
+    for (const stop of clocks) stop();
+    clocks = [];
+  };
+}
 export function registerDocumentPlayExtension(kind: string, extension: DocumentPlayExtension): () => void {
   if (registry.extensions.has(kind)) throw new Error(`A Play tool already owns ${kind} documents.`);
   registry.extensions.set(kind, extension);

package/src/kit/keymap-presets.ts

@@ -349,7 +349,7 @@ export function keymapTable(id: EditorKeymapId): EditorKeymapTable {
 // Display
 // ---------------------------------------------------------------------------
 
-function isMacPlatform(): boolean {
+export function isMacPlatform(): boolean {
   return typeof navigator !== 'undefined' && navigator.platform.includes('Mac');
 }