@vosjs/cli 0.9.0 → 0.9.2

package/dist/cli.js

@@ -484,7 +484,7 @@ async function cmdCheck(argv) {
   return result.ok ? EXIT_OK : EXIT_ERROR;
 }
 async function delegate(argv, viaAlias = false) {
-  const { run } = await import("./run-22RIQESF.js");
+  const { run } = await import("./run-OBJBU7X6.js");
   if (viaAlias && argv[0]) {
     process.stderr.write(
       `note: "vos voila ${argv[0]}" is now "vos ${argv[0]}".

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Browser } from 'playwright';
+import { Browser, Page } from 'playwright';
 import { CursorTrack, RecordingMeta, ProjectDoc, CursorEvent, TranscriptSegment, Digest } from '@vosjs/studio-core';
 export { Digest } from '@vosjs/studio-core';
 
@@ -112,11 +112,20 @@ type ActionStep = ({
 } | {
     do: 'click';
     selector: string;
-} | {
+}
+/**
+ * Type into `selector`. The recorder clicks the field first, which is what
+ * opens the typing zoom on it; `focus: false` types into the field as it is
+ * already focused, for a keystroke that follows earlier typing (a submitting
+ * Enter) rather than starting it — a second click there rings a click effect
+ * on empty space beside the text.
+ */
+ | {
     do: 'type';
     selector: string;
     text: string;
     delayMs?: number;
+    focus?: boolean;
 } | {
     do: 'scroll';
     dy: number;
@@ -149,6 +158,7 @@ type ActionStep = ({
 /** Structural validation with actionable messages. Returns [] when valid. */
 declare function validateActions(value: unknown): string[];
 
+declare const RECORDING_NAME = "recording.webm";
 interface TakePaths {
     dir: string;
     recording: string;
@@ -456,6 +466,22 @@ declare function splitCommand(command: string): string[];
 /** The walk, as steps the recorder can replay. Pure. */
 declare function convertAgentBrowser(records: AgentBrowserRecord[], opts?: ConvertOptions): ConvertResult;
 
+interface TakeServer {
+    base: string;
+    close: () => void;
+}
+/**
+ * Static server over the take dir + generated pages + a POST /save endpoint
+ * the in-page encoder/renderer uses to hand bytes back to node. The recording
+ * is fetched → blob URL (seekable), but a take-dir VIDEO BACKGROUND
+ * (frame.backgroundMedia.key = "/bg.webm") is loaded directly by ON_FRAME and
+ * seeked during export — so this serves Range/206 (an HTMLVideoElement hangs
+ * forever seeking a naive 200-only static server).
+ */
+declare function startTakeServer(rootDir: string, pages: Record<string, string>): Promise<TakeServer>;
+/** Poll a capture/encode page for window.__done / __error / __progress. */
+declare function waitForPageDone(page: Page, label: string, onProgress: (fraction: number) => void, timeoutMs: number): Promise<Record<string, unknown>>;
+
 /**
  * Origin resolution: --origin (or legacy --api) → VOS_ORIGIN → legacy
  * VOS_API_BASE (which historically carried a trailing /api) → https://vos.so.
@@ -476,6 +502,20 @@ declare function parseVosId(input: string): string;
  * Returns null when nothing resolves — callers decide whether auth is needed.
  */
 declare function resolveCredential(explicit?: string): string | null;
+interface ApiResult {
+    status: number;
+    body: Record<string, unknown>;
+}
+declare function apiJson(origin: string, path: string, init?: {
+    method?: string;
+    key?: string | null;
+    body?: unknown;
+    /** Raw request body (uploads) — used verbatim, with `headers`. */
+    raw?: Uint8Array;
+    headers?: Record<string, string>;
+}): Promise<ApiResult>;
+/** Human-readable error line for a failed platform response. Never echoes credentials. */
+declare function apiError(what: string, r: ApiResult): string;
 interface SyncState {
     vosId: string;
     /** The hosted version this directory is based on — the next push's base. */
@@ -504,4 +544,4 @@ interface VersionChange {
     summary?: string;
 }
 
-export { type ActionStep, type ActionsFile, type AgentBrowserRecord, BrowserUnavailableError, type ConvertOptions, type ConvertResult, type DigestOptions, type DigestResult, type LoadedConfig, type RenderAnimationOptions, type RenderAnimationResult, type RenderResult, type RenderStillOptions, type RenderTakeOptions, type RenderTakeResult, type RenderVideoOptions, type SyncState, type TakeData, type TakePaths, type VersionChange, configDuration, convertAgentBrowser, digestTake, encodeRecording, launchBrowser, loadTake, loadVosConfig, manifest, parseAgentBrowserLog, parseTranscript, parseVosId, planTake, platformOrigin, previewPages, pullMedia, readSyncState, recordTake, renderAnimation, renderStill, renderTake, renderVideo, resolveCredential, run, splitCommand, takePaths, validateActions, writeSyncState };
+export { type ActionStep, type ActionsFile, type AgentBrowserRecord, BrowserUnavailableError, type ConvertOptions, type ConvertResult, type DigestOptions, type DigestResult, type LoadedConfig, RECORDING_NAME, type RenderAnimationOptions, type RenderAnimationResult, type RenderResult, type RenderStillOptions, type RenderTakeOptions, type RenderTakeResult, type RenderVideoOptions, type SyncState, type TakeData, type TakePaths, type TakeServer, type VersionChange, apiError, apiJson, configDuration, convertAgentBrowser, digestTake, encodeRecording, launchBrowser, loadTake, loadVosConfig, manifest, parseAgentBrowserLog, parseTranscript, parseVosId, planTake, platformOrigin, previewPages, pullMedia, readSyncState, recordTake, renderAnimation, renderStill, renderTake, renderVideo, resolveCredential, run, splitCommand, startTakeServer, takePaths, validateActions, waitForPageDone, writeSyncState };

package/dist/index.js

@@ -7,6 +7,9 @@ import {
   renderVideo
 } from "./chunk-X2BKHZ56.js";
 import {
+  RECORDING_NAME,
+  apiError,
+  apiJson,
   convertAgentBrowser,
   digestTake,
   encodeRecording,
@@ -24,10 +27,12 @@ import {
   resolveCredential,
   run,
   splitCommand,
+  startTakeServer,
   takePaths,
   validateActions,
+  waitForPageDone,
   writeSyncState
-} from "./chunk-6JJETC43.js";
+} from "./chunk-NKUOT5JE.js";
 import {
   BrowserUnavailableError,
   launchBrowser
@@ -37,6 +42,9 @@ import {
 } from "./chunk-5BFGODBI.js";
 export {
   BrowserUnavailableError,
+  RECORDING_NAME,
+  apiError,
+  apiJson,
   configDuration,
   convertAgentBrowser,
   digestTake,
@@ -61,8 +69,10 @@ export {
   resolveCredential,
   run,
   splitCommand,
+  startTakeServer,
   takePaths,
   validateActions,
+  waitForPageDone,
   writeSyncState
 };
 //# sourceMappingURL=index.js.map

package/dist/{run-22RIQESF.js → run-OBJBU7X6.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-6JJETC43.js";
+} from "./chunk-NKUOT5JE.js";
 import "./chunk-A2VSDK3C.js";
 export {
   run
 };
-//# sourceMappingURL=run-22RIQESF.js.map
+//# sourceMappingURL=run-OBJBU7X6.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "The vos CLI: record the real product from a scripted browser flow, auto-zoom from the cursor track, cut as data in doc.json, render deterministic video and stills, deliver a release's media per destination spec, and sync with vos.so. One binary, every verb, MIT.",
   "type": "module",
   "license": "MIT",
@@ -48,13 +48,13 @@
   "dependencies": {
     "mediabunny": "^1.27.3",
     "playwright": "^1.49.0",
-    "@vosjs/core": "^0.23.1",
-    "@vosjs/editor": "^1.3.0",
     "@vosjs/elements": "^0.8.0",
-    "@vosjs/render-core": "^0.1.0",
+    "@vosjs/editor": "^1.3.0",
+    "@vosjs/core": "^0.23.1",
     "@vosjs/shared": "^0.1.0",
-    "@vosjs/studio-core": "^0.1.0",
+    "@vosjs/render-core": "^0.1.0",
     "@vosjs/timeline": "^0.4.0",
+    "@vosjs/studio-core": "^0.1.0",
     "@vosjs/tween": "^0.8.1"
   },
   "devDependencies": {

package/schema/actions.schema.json

@@ -115,6 +115,11 @@
                 "minimum": 0,
                 "default": 40
               },
+              "focus": {
+                "type": "boolean",
+                "default": true,
+                "description": "The recorder clicks the field before typing, and that click is what opens the typing zoom on it. false types into the field as it is already focused: for a keystroke that finishes earlier typing (a submitting Enter) rather than starting it, where a second click rings a click effect on empty space beside the text."
+              },
               "id": {
                 "type": "string",
                 "minLength": 1,