@vgai/editor-sdk 0.5.40 → 0.5.42

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/editor-sdk",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.40",
+  "version": "0.5.42",
   "type": "module",
   "repository": {
     "type": "git",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@types/three": "^0.180.0",
-    "@vgai/sdk": "0.5.40"
+    "@vgai/sdk": "0.5.42"
   },
   "peerDependencies": {
     "@vgai/engine": "*",

package/src/client.ts

@@ -16,6 +16,7 @@ import type {
   GameplayRecordingCapture,
   GameplayRecordingOptions,
   GameplayRecordingStarted,
+  GameplayRecordingTimeline,
   HelperVisibility,
   InspectedFieldWrite,
   InspectedHierarchy,
@@ -457,6 +458,15 @@ export class EditorClient {
     return this.command<GameplayRecordingCapture>({ type: 'bridge-recording-stop' });
   }
 
+  /** Read the active capture's monotonic media position. This is the only clock
+   * suitable for selecting intervals inside the finalized recording. */
+  async getGameplayRecordingTimeline(): Promise<GameplayRecordingTimeline> {
+    const timeline = await this.command<GameplayRecordingTimeline>({
+      type: 'bridge-recording-timeline',
+    });
+    return { startedAt: timeline.startedAt, elapsedMs: timeline.elapsedMs };
+  }
+
   /**
    * Capture an isolated, deterministic four-view preview through the editor's
    * native Asset Lab. The SDK delegates rendering to the editor; it never
@@ -672,6 +682,11 @@ export class EditorClient {
     return data.hierarchy;
   }
 
+  /** Run the Hierarchy panel's own Expand All action. */
+  async expandHierarchyAll(): Promise<void> {
+    await this.command<Record<string, never>>({ type: 'expand-hierarchy-all' });
+  }
+
   /**
    * Write one editable path through the active Inspector's own IO.
    *

package/src/index.ts

@@ -58,6 +58,7 @@ export type {
   GameplayRecordingCapture,
   GameplayRecordingOptions,
   GameplayRecordingStarted,
+  GameplayRecordingTimeline,
   HelperVisibility,
   InspectedAction,
   InspectedField,
@@ -74,6 +75,7 @@ export type {
   InspectionSurface,
   LabeledShotSetCapture,
   PlayStarted,
+  PlayRecordingStatus,
   PresentedEditorView,
   ProjectInfo,
   ProjectTemplate,

package/src/types.ts

@@ -141,11 +141,30 @@ export interface GameplayRecordingCapture extends GameplayRecordingStarted {
   hidden: boolean;
 }
 
+/** A position on the active recorder's authoritative monotonic timeline.
+ * `startedAt` identifies the recording; `elapsedMs` shares the exact origin
+ * used to calculate the finalized capture's `durationMs`. */
+export interface GameplayRecordingTimeline {
+  startedAt: string;
+  elapsedMs: number;
+}
+
+/** What Play can report while its recording is still open. Geometry, layers, media cadence, and
+ * final health are deliberately absent: those facts are only authoritative after Stop finalizes
+ * the capture. */
+export interface PlayRecordingStatus {
+  path: string;
+  startedAt: string;
+  rotates: boolean;
+  logFile: string | null;
+  idleAutoStopMs: number;
+}
+
 /** What `play` reports back once the run is up and recording. */
 export interface PlayStarted {
   /** Absent only when the recorder could not start; play is up either way and
    *  the editor console carries the reason. */
-  recording?: GameplayRecordingStarted;
+  recording?: PlayRecordingStatus;
 }
 
 export type AssetPreviewView = 'front' | 'right' | 'top' | 'perspective';
@@ -439,6 +458,16 @@ export interface EditorState {
   activeViewportTab: ViewportTab;
   /** The actual active center document, including tool/source documents. */
   activeDocumentId?: string | null;
+  /** The visible bottom utility, or null when that drawer is collapsed. */
+  activeUtilityId?: string | null;
+  /** The shared Analytics rail's current durable-session selection. */
+  gameplaySession?: {
+    selectedSessionId: string | null;
+    latestSessionId: string | null;
+    selectedStatus: 'live' | 'completed' | null;
+    cursorMs: number;
+    liveEdgeMs: number;
+  };
   /** Every center document the editor currently has open, by stable registry id. */
   openDocumentIds?: string[];
   activeTabKey: string;
@@ -527,6 +556,18 @@ export interface EditorState {
     unresponsive: boolean;
     commandListener?: 'ready' | 'not attached' | (string & {});
     pageErrors?: string[];
+    /**
+     * The control-plane generation handshake for each page load currently
+     * associated with this physical tab. Anything other than `aligned` is a
+     * lifecycle contradiction or a handshake still in progress.
+     */
+    controlLifecycles?: Array<{
+      status: 'aligned' | 'awaiting-heartbeat' | 'unconfirmed' | 'mismatch';
+      serverGeneration8: string;
+      connectionGeneration8: string;
+      pageGeneration8: string;
+      clientId8: string;
+    }>;
     census?: RecordedTabCensus | null;
     censusAgeMs?: number | null;
   }>;