@vosjs/cli 0.84.0 → 0.86.0

package/dist/cli.js

@@ -19,7 +19,7 @@ import {
   stillOutFor,
   stillWarnings,
   videoFormat
-} from "./chunk-Q47FUCYN.js";
+} from "./chunk-2LAXJZCG.js";
 import {
   ASSET_ROUTE,
   MEDIA_HEAD_BYTES,
@@ -38,7 +38,7 @@ import {
   serveFile,
   unusedFlagsMessage,
   writeOutput
-} from "./chunk-EPSYIF2S.js";
+} from "./chunk-PZP76YJI.js";
 
 // src/cli.ts
 import { existsSync, readFileSync, statSync } from "fs";
@@ -842,7 +842,7 @@ async function cmdCheck(argv) {
   const result = runCheck(parsed);
   if (result.config) {
     const baseDir = baseDirOf(source);
-    const { hostedLiteralWarnings } = await import("./assetManifest-32VI7OK7.js");
+    const { hostedLiteralWarnings } = await import("./assetManifest-QFJ7X6TT.js");
     const extra = [
       ...baseDir ? missingManifestFiles(result.config, baseDir) : [],
       ...hostedLiteralWarnings(result.config)
@@ -876,12 +876,12 @@ async function cmdCheck(argv) {
   return result.ok ? EXIT_OK : EXIT_ERROR;
 }
 async function delegate(argv) {
-  const { run } = await import("./run-J5Z32LEB.js");
+  const { run } = await import("./run-KB36L2ZI.js");
   return await run(argv);
 }
 async function printHelp() {
   process.stdout.write(HELP_ENGINE);
-  const { manifest } = await import("./manifest-VTOIEUHJ.js");
+  const { manifest } = await import("./manifest-OLVFUZTW.js");
   process.stdout.write("\nTake pipeline + vos.so verbs\n");
   for (const v of manifest.verbs) {
     if (v.name === "render") continue;
@@ -910,7 +910,7 @@ async function main() {
     const engine = HELP_ENGINE.split("\n").filter(
       (l) => l.startsWith(`  vos ${cmd} `)
     );
-    const { verbHelp } = await import("./run-J5Z32LEB.js");
+    const { verbHelp } = await import("./run-KB36L2ZI.js");
     const take = verbHelp(cmd);
     process.stdout.write(
       `${engine.join("\n")}
@@ -938,7 +938,7 @@ ${take.includes("no such verb") ? "" : take}`
 main().then(async (code) => {
   if (code === EXIT_OK) {
     const verb = process.argv[2] ?? "";
-    const { HELP } = await import("./run-J5Z32LEB.js");
+    const { HELP } = await import("./run-KB36L2ZI.js");
     const documented = [
       ...helpFlagsFor(HELP_ENGINE, verb),
       ...helpFlagsFor(HELP, verb)

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import { ActionsFile, RecordOpts as RecordOpts$1 } from '@vosjs/render-core/reco
 export { ActionStep, ActionsFile, validateActions } from '@vosjs/render-core/record';
 import { CursorTrack, RecordingMeta, ProjectDoc, TemplateAnchor, Backdrop, LayoutParts, TranscriptSegment, Digest } from '@vosjs/studio-core';
 export { Digest } from '@vosjs/studio-core';
+import { BedTrack, FilmSummary } from '@vosjs/shared/music';
 
 interface ProgramAssets {
     /** Name → the URL (or URLs) the page reads as `ctx.assets.<name>`. */
@@ -144,14 +145,13 @@ interface ReleaseWords {
     brand?: string | null;
     release?: string | null;
 }
+/**
+ * The catalog as `GET /api/music` answers it: each track with what the
+ * library measured and a person wrote about it (`BedTrack`, the ranking's
+ * input), plus the built-in effects.
+ */
 interface MusicCatalog {
-    tracks: {
-        slug: string;
-        title: string;
-        mood?: string;
-        duration: number;
-        url: string;
-    }[];
+    tracks: BedTrack[];
     sfx: {
         slug: string;
         title: string;
@@ -177,6 +177,12 @@ interface MotionProposalInput {
         caption: string;
     }[];
     catalog: MusicCatalog | null;
+    /**
+     * The film as the music ranking reads it (`filmSummaryOf`), so a mood
+     * or a few words in `music:` pick the bed that fits THIS cut; absent,
+     * a mood picks the first track of that mood.
+     */
+    film?: FilmSummary;
     /** The templates the recipe or the flags named, resolved, in order. */
     templates?: MotionTemplate[];
 }
@@ -512,6 +518,12 @@ declare function startTakeServer(rootDir: string, pages: Record<string, string>)
 /** 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>>;
 
+/** Where the store lives; tests hand in a scratch pair. */
+interface Store {
+    credentialsPath: string;
+    accountsDir: string;
+}
+
 /**
  * Origin resolution: --origin (or legacy --api) → VOS_ORIGIN → legacy
  * VOS_API_BASE (which historically carried a trailing /api) → https://vos.so.
@@ -526,14 +538,26 @@ declare function platformOrigin(flags?: {
  * (/embed/vos/{id}), or a studio/stage URL (?vos={id}).
  */
 declare function parseVosId(input: string): string;
+interface CredentialAsk {
+    /** `--key`: goes where the command goes. */
+    key?: string;
+    /** `--account <handle|id>`: a stored credential for the origin, by name. */
+    account?: string;
+    /** The origin in use; the store is read for it. Default: the platform origin. */
+    origin?: string;
+    /** Tests hand in a scratch store. */
+    store?: Store;
+}
 /**
- * The full documented ladder: explicit --key → VOS_API_KEY → the
- * credential `vos login` stored. A vos_rg_ remix grant is just a key here.
- * Returns null when nothing resolves — callers decide whether auth is needed.
- * A stored key is remembered with its origin: it is only ever SENT there
- * (`bearerFor`).
+ * The full documented ladder: `--key` → `--account` → VOS_API_KEY →
+ * VOS_ACCOUNT → the active credential `vos login` stored. A vos_rg_ remix
+ * grant is just a key here. Returns null when nothing resolves — callers
+ * decide whether auth is needed. A stored key is remembered with its
+ * origin: it is only ever SENT there (`bearerFor`). A name that names no
+ * stored credential is an error in words, never a silent fall-through,
+ * because the person said which account and must not get another.
  */
-declare function resolveCredential(explicit?: string, path?: string): string | null;
+declare function resolveCredential(explicit?: string | CredentialAsk, path?: string): string | null;
 interface ApiResult {
     status: number;
     body: Record<string, unknown>;

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   startTakeServer,
   validateActions,
   waitForPageDone
-} from "./chunk-DM7ADA77.js";
+} from "./chunk-ZXFO32KW.js";
 import {
   BrowserUnavailableError,
   configDuration,
@@ -23,13 +23,13 @@ import {
   previewPages,
   renderStill,
   renderVideo
-} from "./chunk-Q47FUCYN.js";
+} from "./chunk-2LAXJZCG.js";
 import {
   RECORDING_NAME,
   loadTake,
   pullMedia,
   takePaths
-} from "./chunk-M5ZBQFPG.js";
+} from "./chunk-V3RUNUNP.js";
 import {
   apiError,
   apiJson,
@@ -38,11 +38,11 @@ import {
   readSyncState,
   resolveCredential,
   writeSyncState
-} from "./chunk-EPSYIF2S.js";
+} from "./chunk-PZP76YJI.js";
 import "./chunk-6XPFWQKP.js";
 import {
   manifest
-} from "./chunk-OWYOJB7K.js";
+} from "./chunk-7A3PZARL.js";
 export {
   BrowserUnavailableError,
   RECORDING_NAME,

package/dist/manifest-OLVFUZTW.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  manifest
+} from "./chunk-7A3PZARL.js";
+export {
+  manifest
+};
+//# sourceMappingURL=manifest-OLVFUZTW.js.map

package/dist/{run-J5Z32LEB.js → run-KB36L2ZI.js}

@@ -9,10 +9,10 @@ import {
   takeBackdrop,
   takeBrowserArgs,
   verbHelp
-} from "./chunk-DM7ADA77.js";
-import "./chunk-Q47FUCYN.js";
-import "./chunk-M5ZBQFPG.js";
-import "./chunk-EPSYIF2S.js";
+} from "./chunk-ZXFO32KW.js";
+import "./chunk-2LAXJZCG.js";
+import "./chunk-V3RUNUNP.js";
+import "./chunk-PZP76YJI.js";
 import "./chunk-6XPFWQKP.js";
 export {
   HELP,
@@ -25,4 +25,4 @@ export {
   takeBrowserArgs,
   verbHelp
 };
-//# sourceMappingURL=run-J5Z32LEB.js.map
+//# sourceMappingURL=run-KB36L2ZI.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.84.0",
+  "version": "0.86.0",
   "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, deliver a release's video cuts per destination spec, and sync with vos.so. One binary, every verb, MIT.",
   "type": "module",
   "license": "MIT",
@@ -51,14 +51,14 @@
     "acorn-walk": "^8.3.5",
     "mediabunny": "^1.55.7",
     "playwright": "^1.49.0",
-    "@vosjs/elements": "^0.12.1",
-    "@vosjs/render-core": "^0.12.0",
-    "@vosjs/shared": "^0.7.0",
-    "@vosjs/studio-core": "^0.46.0",
+    "@vosjs/core": "^0.31.0",
+    "@vosjs/shared": "^0.8.0",
     "@vosjs/editor": "^1.6.0",
-    "@vosjs/tween": "^0.8.3",
+    "@vosjs/elements": "^0.12.1",
+    "@vosjs/render-core": "^0.12.1",
     "@vosjs/timeline": "^0.5.0",
-    "@vosjs/core": "^0.31.0"
+    "@vosjs/studio-core": "^0.47.0",
+    "@vosjs/tween": "^0.8.3"
   },
   "devDependencies": {
     "@types/node": "^22",

package/skills/VERSION

@@ -1 +1 @@
-0.28.0
+0.29.0

package/skills/launch-kit/SKILL.md

@@ -58,7 +58,7 @@ Five facts before any recording:
   ```yaml
   headline: "Two to six words\nover up to three lines"   # the end card
   kicker: "PRODUCT  V2.1"       # absent = the wordmark plus --release
-  music: upbeat                 # a catalog slug or mood; none = silent
+  music: upbeat                 # a catalog slug, a mood or a few words (ranked against the cut by vos plan); none = silent
   entrance: tilt-in             # tilt-in | pull-out | rise | none
   endCard: on                   # the official End card template; none switches it off; a title, vos id or doc.json names another
   with: "<template>@start"      # optional: any template laid at an anchor (@end | @start | @step:<id> | @<seconds>)
@@ -132,7 +132,11 @@ arriving word by word, the release line and the URL settle on the ground;
 its clips are stamped `from: endcard`), any template `with:` names at its
 anchor, a caption per step, a music bed and a click sound on every press
 when the take has no mic; every proposal carries a stable id (`bed`,
-`click-<n>`, `caption-<step>`). On an existing cut `--motion` re-proposes;
+`click-<n>`, `caption-<step>`). The bed is RANKED against the cut, never
+the first track of a mood: `music: upbeat` (or a few words) goes through
+`vos music pick`'s ranking inside the plan, its report names the pick and
+the runner-up, and a slug stays that track; name the runner-up in the
+version note and ask the person to listen. On an existing cut `--motion` re-proposes;
 a refresh never does, so a deleted end card stays deleted. A template is a
 plain take on a shelf whose clips carry stable ids; a ref is a title on the
 official shelf (`"End card"`), a vos id, or a document on disk. Open the

package/skills/product-video/SKILL.md

@@ -133,7 +133,13 @@ person before recording**; an answer that does neither was not an answer.
    heard, and a downloaded output's own sound rides as a clip through
    `vos join`. When the sound IS the point (a voice preview, a generated
    clip) and the product synthesizes it, say so before recording and plan
-   the download; when it is not, say the video is silent and score it.
+   the download; when it is not, say the video is silent and score it:
+   `vos music pick <take>` ranks the library against THIS cut (its length,
+   its captions and joins as the beats, its payoff, whether a voice plays)
+   and prints the `vos score` line that places each pick, so run
+   `vos score <take> --track best` (or the pick you prefer), name the
+   runner-up in the version note, and ask the person to listen, because
+   you cannot.
 
 ## The core loop (every destination)
 
@@ -309,8 +315,12 @@ person before recording**; an answer that does neither was not an answer.
      video needs `duration` (OUTPUT-anchored modulo loop); `dim` 0..1 scrim.
      Ambience, not a subject — dim it behind dense UI.
    - `audio`: OUTPUT-anchored clips; `key` may be a file dropped into the
-     take dir (`"/music.mp3"`); gain/fades/loop. Muxed on full renders
-     (Opus/AAC); `--range` stays silent; forces single-flight.
+     take dir (`"/music.mp3"`) or a library track; gain/fades/loop. Muxed
+     on full renders (Opus/AAC); `--range` stays silent; forces
+     single-flight. A library bed is picked by `vos music pick`, never by
+     a mood alone: the library knows each track's beat, intro, seam,
+     ending and vocals, and the ranking refuses what cannot cover the
+     cut, starts in a quiet intro, or sings under a voice.
    - export: `{"resolution": "720p|1080p|2k|4k", "fps": 30}` — never above
      the footage (validate warns).
    Then `vos validate take --json` — lints must pass.

package/skills/vos-cut/SKILL.md

@@ -192,8 +192,12 @@ Per beat, against `plan` and the recipe:
   the last frame, with `still` on it and the one `"zoom": true` mark;
   a recap card listing the path in the captions' words on the plate after
   the card fades; an off-camera wait said in measured time (`{elapsed}`
-  in the caption after it); music scored `--at` the result's step. Never
-  a caption the footage does not show, never a second door.
+  in the caption after it); music picked for the cut (`vos music pick
+  <take> --at <result step>`: the library's beats, intros and vocals
+  against this cut's length, captions, joins and voice) and scored `--at`
+  the result's step (`vos score <take> --track best` places the first
+  pick there), the runner-up named in the version note, the person asked
+  to listen. Never a caption the footage does not show, never a second door.
 - **Style.** In a series, `vos plan --style <seed>` BEFORE you cut: it copies
   the seed's `zoomStyle`/`zoomParams`/`speedParams`/`tiltStyle`/`frame`/
   `cursor`/`cam`/`export` and re-plans the auto spans under them. Never

package/skills/vos-score/SKILL.md

@@ -6,11 +6,21 @@ license: MIT
 
 # Compose a score for a vos program
 
-A catalog track (`GET https://vos.so/api/music`: CC0, a slug, a mood, a
-length) carries no tempo and no downbeats, and you cannot listen to it. Under
-an ambient picture that is fine. Under a picture that moves on a beat, it is
-wrong in ways you will not hear: the kick lands between the poses, the drop
-arrives two bars early, the loud part sits under the quiet scene.
+Try the library first: `vos music pick <take|config.json>` ranks every
+catalog track (`GET https://vos.so/api/music`: CC0, each with its beat grid
+and a confidence, its quiet intro, its loop seam, its ending, its sections,
+its vocals and a sentence a person wrote) against THIS film's length, cuts
+and payoff, and prints the `vos score` line that places each pick with its
+swell on the payoff and its beats under the cuts. Under an ambient picture,
+or a how-to that cuts on a few captions, the first pick is the answer:
+`vos score <take> --track best`.
+
+Compose when the picture is CHOREOGRAPHED: `pick` says no bed reaches the
+beat fit the picture needs (every cut a tenth of a beat off, an uncertain
+beat it would not score, every track refused), or the film dances, snaps
+poses or animates on a grid of its own. A catalog track cannot be bent to
+that grid, and you cannot listen to it: the kick lands between the poses,
+the drop arrives two bars early, the loud part sits under the quiet scene.
 
 So write the music instead. The score is a spec (tempo, chords, a riff, a
 hook, sections by bar) that `scripts/compose.py` synthesizes into a WAV at