@vgai/editor-sdk 0.5.41 → 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.41",
+  "version": "0.5.42",
   "type": "module",
   "repository": {
     "type": "git",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@types/three": "^0.180.0",
-    "@vgai/sdk": "0.5.41"
+    "@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';