parley-live 0.4.0 → 0.4.1

package/README.md

@@ -28,7 +28,7 @@ parley ugc-ad --product product.jpg --name "Cold Brew Kit" --actor jordan --mark
 | `parley video "<motion prompt>"` | Animate a still (`--image <file\|url\|@last>`) or text-to-video (`--look photoreal`). `--look`, `--move` (repeatable, up to 3), `--duration`, `--ratio`, `--out`. |
 | `parley thumbnail "<title>"` | 1-3 YouTube thumbnail variants. `--overlay`, `--accent`, `--person`, `--out <dir>`. |
 | `parley ugc-ad` | Product photo → spokesperson ad with a marketplace CTA end-card. `--product`, `--name`, `--actor` or `--face`, `--angle`, `--marketplace`, `--points`, `--seconds`, `--url`, `--out`. |
-| `parley youtube` | A complete faceless video from ordered beat stills: animated per beat, cut to `--narration` with crossfades, `--music` ducked, `--captions` burned in. `--beat` (repeatable, hosted https URLs), `--tier fast\|standard\|cinematic`, `--silent`, `--project`, `--out`. |
+| `parley youtube` | A complete faceless video from ordered beat stills: animated per beat (one 5 s clip each, so bring about one beat per 5 s of narration; a narration the beats cannot carry is refused before anything is charged), cut to `--narration` with crossfades, `--music` ducked, `--captions` burned in. `--beat` (repeatable, hosted https URLs), `--tier fast\|standard\|cinematic`, `--silent`, `--project`, `--out`. |
 | `parley api <METHOD> </path>` | A signed raw call to any Parley endpoint, JSON in (`--data '{…}'` or `--data @file.json`), JSON out. This is how the Studio (projects, characters, shots, renders, reels) is driven. |
 | `parley whoami`, `parley logout` | Session management. |
 

package/dist/client.js

@@ -188,7 +188,7 @@ export function rememberLast(kind, entry) {
     try {
         mkdirSync(homeDir(), { recursive: true });
         const cur = loadLast();
-        cur[kind] = { file: path.resolve(entry.file), url: entry.url, at: new Date().toISOString() };
+        cur[kind] = { file: entry.file ? path.resolve(entry.file) : null, url: entry.url, at: new Date().toISOString() };
         writeFileSync(lastPath(), JSON.stringify(cur, null, 2) + '\n');
     }
     catch { /* best effort: chaining is a convenience, never a failure */ }
@@ -198,9 +198,10 @@ export function resolveRef(ref, kind) {
     if (ref !== '@last' && ref !== `@last-${kind}`)
         return ref;
     const last = loadLast()[kind];
-    if (!last)
+    const ref2 = last?.url || last?.file;
+    if (!ref2)
         throw new CliError(`No previous ${kind} on this machine yet. Make one first (parley ${kind} …), then pass @last.`);
-    return last.url || last.file;
+    return ref2;
 }
 export function sleep(ms) {
     return new Promise((r) => setTimeout(r, ms));

package/dist/index.js

@@ -17,7 +17,19 @@
 import { readFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
 import path from 'node:path';
 import { api, authWebUrl, backendUrl, clearCredentials, CliError, downloadTo, fileToDataUri, isUrl, loadCredentials, loadLast, openInBrowser, rememberLast, resolveRef, saveCredentials, sleep, } from './client.js';
-const VERSION = '0.4.0';
+const VERSION = '0.4.1';
+/** Server advice written for Parley's in-app agent names its tools; a CLI user
+ *  has commands instead, so the same advice is re-spoken in CLI terms. */
+function humanizeServerMessage(message) {
+    return message
+        .replace(/\bvia generate_video\b/g, 'with parley video')
+        .replace(/\bcall assemble_video again\b/g, 'run parley youtube again')
+        .replace(/\bgenerate_video\b/g, 'parley video')
+        .replace(/\bassemble_video\b/g, 'parley youtube')
+        .replace(/\bproduce_full_video\b/g, 'parley youtube')
+        .replace(/\bgenerate_voiceover\b/g, 'parley voice')
+        .replace(/\bgenerate_image\b/g, 'parley image');
+}
 /** Semver-ish compare: 1 if a > b, -1 if a < b, 0 if equal (numeric parts only). */
 function compareVersions(a, b) {
     const pa = a.replace(/^v/, '').split('.').map((x) => parseInt(x, 10) || 0);
@@ -347,7 +359,9 @@ async function cmdUgcAd(p) {
         if (job.status === 'failed')
             throw new CliError(job.error || 'Ad generation failed.');
     }
-    const videoUrl = job?.result?.videoUrl || job?.result?.finalVideoUrl || job?.result?.url;
+    // The ad orchestrator reports the finished file as outputUrl; the other
+    // shapes cover older jobs and the generic video result.
+    const videoUrl = job?.result?.outputUrl || job?.result?.videoUrl || job?.result?.finalVideoUrl || job?.result?.url;
     const out = outPathFor(p, `parley-ad-${jobId}.mp4`);
     const bytes = videoUrl ? await downloadTo(videoUrl, out) : 0;
     emit({ ok: true, jobId, file: videoUrl ? out : null, bytes, videoUrl: videoUrl ?? null, result: job?.result ?? null }, videoUrl ? `Saved ${out} (${Math.round(bytes / 1024)} KB)\nHosted: ${videoUrl}` : `Finished. Result:\n${JSON.stringify(job?.result, null, 2)}`);
@@ -364,7 +378,8 @@ const YT_TIERS = ['fast', 'standard', 'cinematic'];
 async function cmdYoutube(p) {
     const beats = list(p.flags.beat);
     if (beats.length === 0) {
-        throw new CliError(`Usage: parley youtube --beat <https still> [--beat ...] [--narration <https audio>] [--music <https audio>] [--tier ${YT_TIERS.join('|')}] [--captions] [--silent] [--project <workspace id>] [--out video.mp4]\n  Beats are the hosted image URLs "parley image" prints, in narration order.`);
+        throw new CliError(`Usage: parley youtube --beat <https still> [--beat ...] [--narration <https audio>] [--music <https audio>] [--tier ${YT_TIERS.join('|')}] [--captions] [--silent] [--project <workspace id>] [--out video.mp4]\n  Beats are the hosted image URLs "parley image" prints, in narration order.
+  Every beat becomes one 5 s clip and the cut refuses more than 15% slow motion: bring about one beat per 5 s of narration.`);
     }
     const bad = beats.find((b) => !isUrl(b));
     if (bad)
@@ -716,8 +731,9 @@ async function cmdStudio(p) {
             body.narrationUrl = resolveRef(narration, 'audio');
         note('Assembling the reel (score generated and ducked automatically)…');
         const reel = await api(`/api/studio/projects/${P}/assemble`, { body });
+        // The reel stays hosted (nothing is downloaded here), so @last carries the URL only.
         if (reel.public_url)
-            rememberLast('video', { file: reel.video_path || reel.public_url, url: reel.public_url });
+            rememberLast('video', { file: null, url: reel.public_url });
         return out({ ok: true, reel }, () => `Reel ${reel.id || ''}: ${reel.public_url || reel.video_path || '(see JSON)'}`);
     }
     if (group === 'reels') {
@@ -787,6 +803,11 @@ async function cmdDeploy(p) {
     const project = str(p.flags.project) || `proj_site-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
     if (!/^proj_[A-Za-z0-9_-]{6,}$/.test(project))
         throw new CliError('--project must look like proj_ followed by at least six letters, digits, _ or -.');
+    // Register the workspace as one of the account's projects first: file writes
+    // accept a brand-new id, but the deploy lane proves ownership against the
+    // projects table and refuses a workspace that was never registered.
+    note(`Registering project ${project}…`);
+    await api(`/v1/projects/${project}`, { method: 'PUT', body: { name, type: 'code' } });
     note(`Uploading ${files.length} files (${Math.round(total / 1024)} KB) into workspace ${project}…`);
     let n = 0;
     for (const f of files) {
@@ -1063,10 +1084,11 @@ async function main(argv) {
     }
     catch (e) {
         const code = e instanceof CliError ? e.exitCode : 1;
+        const message = humanizeServerMessage(e?.message || String(e));
         if (JSON_MODE)
-            console.log(JSON.stringify({ ok: false, error: e?.message || String(e), code }));
+            console.log(JSON.stringify({ ok: false, error: message, code }));
         else
-            console.error(`error: ${e?.message || e}`);
+            console.error(`error: ${message}`);
         return code;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "parley-live",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Generate images, video clips with named camera moves, narration, YouTube thumbnails, product ads, complete videos and Studio films, and deploy static sites, from the terminal with Parley. Built for coding agents: every command has a --json mode.",
   "license": "MIT",
   "type": "module",