@vosjs/cli 0.66.0 → 0.67.0

package/dist/cli.js

@@ -19,7 +19,7 @@ import {
   stillOutFor,
   stillWarnings,
   videoFormat
-} from "./chunk-TYGDQEEI.js";
+} from "./chunk-MDRYSHOF.js";
 import {
   ASSET_ROUTE,
   MEDIA_HEAD_BYTES,
@@ -34,7 +34,7 @@ import {
   resolveMediaType,
   serveFile,
   unusedFlagsMessage
-} from "./chunk-UQLC4BEZ.js";
+} from "./chunk-C5VKACGQ.js";
 
 // src/cli.ts
 import { writeFile } from "fs/promises";
@@ -822,7 +822,7 @@ async function cmdCheck(argv) {
   const result = runCheck(parsed);
   if (result.config) {
     const baseDir = baseDirOf(source);
-    const { hostedLiteralWarnings } = await import("./assetManifest-RDHHKAAM.js");
+    const { hostedLiteralWarnings } = await import("./assetManifest-DU5ZEIDE.js");
     const extra = [
       ...baseDir ? missingManifestFiles(result.config, baseDir) : [],
       ...hostedLiteralWarnings(result.config)
@@ -856,7 +856,7 @@ async function cmdCheck(argv) {
   return result.ok ? EXIT_OK : EXIT_ERROR;
 }
 async function delegate(argv, viaAlias = false) {
-  const { run } = await import("./run-OY6B5AFZ.js");
+  const { run } = await import("./run-QSV3VXKE.js");
   if (viaAlias && argv[0]) {
     process.stderr.write(
       `note: "vos voila ${argv[0]}" is now "vos ${argv[0]}".
@@ -896,7 +896,7 @@ async function main() {
     const engine = HELP_ENGINE.split("\n").filter(
       (l) => l.startsWith(`  vos ${cmd} `)
     );
-    const { verbHelp } = await import("./run-OY6B5AFZ.js");
+    const { verbHelp } = await import("./run-QSV3VXKE.js");
     const take = verbHelp(cmd);
     process.stdout.write(
       `${engine.join("\n")}
@@ -928,7 +928,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-OY6B5AFZ.js");
+    const { HELP } = await import("./run-QSV3VXKE.js");
     const documented = [
       ...helpFlagsFor(HELP_ENGINE, verb),
       ...helpFlagsFor(HELP, verb)

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   startTakeServer,
   validateActions,
   waitForPageDone
-} from "./chunk-SFU4U3GM.js";
+} from "./chunk-XCWC7SUS.js";
 import {
   BrowserUnavailableError,
   configDuration,
@@ -23,13 +23,13 @@ import {
   previewPages,
   renderStill,
   renderVideo
-} from "./chunk-TYGDQEEI.js";
+} from "./chunk-MDRYSHOF.js";
 import {
   RECORDING_NAME,
   loadTake,
   pullMedia,
   takePaths
-} from "./chunk-63KINQOJ.js";
+} from "./chunk-OFTRK3Y3.js";
 import {
   apiError,
   apiJson,
@@ -38,7 +38,7 @@ import {
   readSyncState,
   resolveCredential,
   writeSyncState
-} from "./chunk-UQLC4BEZ.js";
+} from "./chunk-C5VKACGQ.js";
 import "./chunk-6XPFWQKP.js";
 import {
   manifest

package/dist/{run-OY6B5AFZ.js → run-QSV3VXKE.js}

@@ -6,10 +6,10 @@ import {
   takeBackdrop,
   takeBrowserArgs,
   verbHelp
-} from "./chunk-SFU4U3GM.js";
-import "./chunk-TYGDQEEI.js";
-import "./chunk-63KINQOJ.js";
-import "./chunk-UQLC4BEZ.js";
+} from "./chunk-XCWC7SUS.js";
+import "./chunk-MDRYSHOF.js";
+import "./chunk-OFTRK3Y3.js";
+import "./chunk-C5VKACGQ.js";
 import "./chunk-6XPFWQKP.js";
 export {
   HELP,
@@ -19,4 +19,4 @@ export {
   takeBrowserArgs,
   verbHelp
 };
-//# sourceMappingURL=run-OY6B5AFZ.js.map
+//# sourceMappingURL=run-QSV3VXKE.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.66.0",
+  "version": "0.67.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 and stills, deliver a release's media per destination spec, and sync with vos.so. One binary, every verb, MIT.",
   "type": "module",
   "license": "MIT",
@@ -53,12 +53,12 @@
     "playwright": "^1.49.0",
     "@vosjs/core": "^0.27.1",
     "@vosjs/editor": "^1.4.0",
-    "@vosjs/elements": "^0.10.3",
     "@vosjs/render-core": "^0.3.21",
+    "@vosjs/elements": "^0.10.3",
     "@vosjs/shared": "^0.7.0",
     "@vosjs/studio-core": "^0.38.0",
-    "@vosjs/timeline": "^0.5.0",
-    "@vosjs/tween": "^0.8.3"
+    "@vosjs/tween": "^0.8.3",
+    "@vosjs/timeline": "^0.5.0"
   },
   "devDependencies": {
     "@types/node": "^22",

package/skills/VERSION

@@ -1 +1 @@
-0.21.0
+0.22.0

package/skills/launch-kit/SKILL.md

@@ -285,11 +285,14 @@ kit's stills into the release's project so the human can retrospect without
 a terminal:
 
 ```
-vos push take --folder <project-slug> --label "v2.1 launch" --note "<what shipped, one line>"
+vos push take --folder <project-slug> --label "v2.1 launch" --note "<what shipped, one line>" \
+  --prompt "<the person's prompt, as they wrote it>"
 vos push poster/landscape --folder <project-slug> --label "v2.1 poster, landscape"
 vos asset push kit/*.png --folder <project-slug>
 ```
 
+`--prompt` shows the person's prompt on the watch page by default: their words as they wrote them, never yours, with no file path, key or email they did not mean to publish. Say it is shown, and that they can take it off from the watch page.
+
 End by handing the human the loop, not the files: the watch page plays the
 latest version, the studio edits the cut AND the posters (the card is a
 layer you drag; the words are retyped in place), and `vos pull --media`

package/skills/vos-authoring/SKILL.md

@@ -56,10 +56,20 @@ Find a credential in this order, without printing it: `VOS_API_KEY`, then
 the first line of `~/.config/vos/credentials`. With one, push:
 
 ```bash
-vos push my-config.json --title "…" --desc "one line" --wait
+vos push my-config.json --title "…" --desc "one line" \
+  --prompt "<the person's prompt, as they wrote it>" --wait
 # --wait stays until the cover has rendered, then prints the links
 ```
 
+**Show the prompt that made it.** Pass the person's prompt with `--prompt`
+on the push that creates the vos: the watch page shows it by default, so
+whoever watches sees what was asked. Use their words as they wrote them,
+typos included, and never add your own; leave out a file path, key, email
+or name they did not mean to publish. The vos lands private, so its owner
+sees the prompt before anyone else: say it is shown, and that they can take
+it off from the watch page. A push without one prints the command that
+adds it.
+
 The vos lands PRIVATE on the key owner's shelf: only they can open the
 links, and publishing stays their act on vos.so. Keyed pushes never expire;
 iterate with `vos push my-config.json --vos <id>`.
@@ -67,13 +77,14 @@ iterate with `vos push my-config.json --vos <id>`.
 No credential at all? Use the claimable push instead of stopping:
 
 ```bash
-vos push my-config.json --claimable --title "…"
+vos push my-config.json --claimable --title "…" \
+  --prompt "<the person's prompt, as they wrote it>"
 # → claim: https://vos.so/claim/…   expires: <72h from now>
 
 # No CLI, or an older one? The same thing over plain HTTP:
 curl -s -X POST https://vos.so/api/claim \
   -H 'content-type: application/json' \
-  -d '{"title": "…", "config": <the VosConfigJson>}'
+  -d '{"title": "…", "prompt": "<their prompt>", "config": <the VosConfigJson>}'
 # → { "claimUrl": "https://vos.so/claim/…", "expiresAt": "…" }
 ```
 

package/skills/vos-create/SKILL.md

@@ -165,9 +165,12 @@ from what it produced.
 
 ```bash
 vos push <file>.json --title "…" --desc "one line" --tags a,b \
-  --folder <folderId|slug> --label "what you did" --note "why: the ask"
+  --folder <folderId|slug> --label "what you did" --note "why: the ask" \
+  --prompt "<the person's prompt, as they wrote it>"
 ```
 
+`--prompt` shows the person's prompt on the watch page by default: their words as they wrote them, never yours, with no file path, key or email they did not mean to publish. Say it is shown, and that they can take it off from the watch page.
+
 Pass `--label` and `--note` on EVERY push, the first one included: a
 create stamps them on v1, and the history is the conversation the human
 reads. The push creates a PRIVATE vos on the key owner's shelf, filed

package/skills/vos-footage/SKILL.md

@@ -69,9 +69,12 @@ sliced to the window); the editorial cut still trims `segments`.
 ## 4. The shelf is the record — push BEFORE the handoff
 
 ```bash
-vos push take --label "footage handoff" --note "<what it shows; which composition it feeds>"
+vos push take --label "footage handoff" --note "<what it shows; which composition it feeds>" \
+  --prompt "<the person's prompt, as they wrote it>"
 ```
 
+`--prompt` shows the person's prompt on the watch page by default: their words as they wrote them, never yours, with no file path, key or email they did not mean to publish. Say it is shown, and that they can take it off from the watch page.
+
 The take goes to the maker's shelf first, so the clip is never the only
 copy of the work. Two cases where you ASK before pushing instead: there is
 no vos.so credential (`vos login` needs the human), or the footage shows a

package/skills/vos-port/SKILL.md

@@ -195,7 +195,8 @@ approximation.
 6. **Knob honesty**: one `--set data.<key>=<value>` still per param.
 7. **Push** with the score: `vos push config.json --folder <slug> --label
    "port of <source>" --note "<what was substituted, what is a painter>"
-   --wait`, and hand over the watch and studio links.
+   --prompt "<the person's prompt, as they wrote it>" --wait`, and hand over
+   the watch and studio links. `--prompt` shows the person's prompt on the watch page by default: their words as they wrote them, never yours, with no file path, key or email they did not mean to publish. Say it is shown, and that they can take it off from the watch page.
 
 ## The honest gaps (say them in the push note)
 

package/skills/vos-port/references/elements-and-context.md

@@ -1,4 +1,4 @@
-<!-- Generated by scripts/build-element-reference.mjs from @vosjs/core 0.27.0, @vosjs/elements 0.10.2, @vosjs/timeline 0.5.0 and @vosjs/shared 0.7.0. Do not edit by hand: re-run the script. -->
+<!-- Generated by scripts/build-element-reference.mjs from @vosjs/core 0.27.1, @vosjs/elements 0.10.3, @vosjs/timeline 0.5.0 and @vosjs/shared 0.7.0. Do not edit by hand: re-run the script. -->
 
 # Elements, the context and eases: the declarations
 
@@ -208,7 +208,10 @@ interface BaseElement {
     type: 'text' | 'image' | 'svg' | 'video' | 'audio';
     /** Position on screen */
     position: ElementPosition;
-    /** Transform origin */
+    /**
+     * The point of the box an `{x, y}` position names (absent: its top-left
+     * corner). Ignored for a preset position, which places the whole box.
+     */
     anchor?: Anchor;
     /** Layer order (higher = on top, default: 100) */
     zIndex?: number;

package/skills/vos-remix/SKILL.md

@@ -33,7 +33,8 @@ Two shapes, both used as `Authorization: Bearer`:
    Humans mint keys at https://vos.so/app/api.
 3. **No credential at all** — the claimable push (programs only):
    ```bash
-   vos push my-remix.json --claimable --title "My remix"
+   vos push my-remix.json --claimable --title "My remix" \
+     --prompt "<the person's prompt, as they wrote it>"
    # → claim: https://vos.so/claim/…   expires: <72h from now>
 
    # No CLI, or an older one? The same thing over plain HTTP:
@@ -88,11 +89,13 @@ vos.so.
 5. **Push** as a private vos with lineage (the CLI reads `vos.json` beside
    the config for the `remixOfId` credit):
    ```bash
-   vos push <slug>/config.json --title "Aurora Ribbons — dusk"
+   vos push <slug>/config.json --title "Aurora Ribbons — dusk" \
+     --prompt "<the person's prompt, as they wrote it>"
    # → Created private vos <id>
    #   watch:  https://vos.so/vos/<id>
    #   studio: https://vos.so/studio?vos=<id>
    ```
+   `--prompt` shows the person's prompt on the watch page by default: their words as they wrote them, never yours, with no file path, key or email they did not mean to publish. Say it is shown, and that they can take it off from the watch page.
 
 6. **Iterate** — further edits become versions of the same vos:
    ```bash