trace-avatar-render 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * trace-avatar-render invoice.trace.json --url http://localhost:3000/app --out invoice.gif --out invoice.mp4\n *\n * Exit codes: 0 rendered, 1 the render failed (a stalled guide, an error in the app), 2 wrong usage.\n */\n\nimport { readFileSync, writeFileSync } from 'node:fs';\nimport { apply as applySuggestions, suggest } from 'trace-avatar/assist';\nimport type { Suggestion } from 'trace-avatar/assist';\nimport { providerOf } from './ai';\nimport { suggestScript } from './narration';\nimport { voiceOf } from './voice';\nimport { parseArgs } from 'node:util';\nimport { RenderError } from './capture';\nimport { render } from './render';\n\nexport const USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gif|file.mp4> [options]\n\n --url <url> the page the guide starts on (required)\n --out <file> .gif or .mp4; repeat for several (required)\n --mode <overlay|perform> Show me (default) or Do it for me\n --allow-perform needed for perform: it clicks and types for real (use a sandbox account)\n --width <px> output width (GIF default 800, MP4 the capture's)\n --fps <n> frames per second (GIF default 12, MP4 30)\n --viewport <WxH> default: the trace's meta.viewport, else 1280x800\n --scale <n> device pixel ratio of the capture (2 for crisp video)\n --storage-state <file> a signed-in Playwright session\n --max-wait <ms> waits longer than this are cut to it (default 800, 0 keeps them)\n --hide <selector> hidden before capture; repeatable\n --blur <selector> blurred before capture (as well as [data-trace-blur]); repeatable\n --allow-stall render a stalled guide anyway instead of failing\n --player <file> the trace-perform.min.js to use (default: the installed trace-avatar)\n --timeline <file> write the timeline and the cuts as JSON\n --timeout <ms> give up after this long (default 120000)\n --headed show the browser\n\n Polish (all off by default):\n --frame <none|browser> a browser window around the app, on a background\n --background <css> the background behind the window and on the cards\n --camera zoom in on each action and pan between close ones\n --zoom <n> how far the camera goes in (default 1.6; implies --camera)\n --captions <burn|vtt|both> burn the steps' words in, write <out>.vtt + <out>.chapters.vtt, or both\n --poster [file] a PNG at the first click (default <out>.png)\n --title-card [title] a 1.5 s card first (default: the trace's title)\n --end-card [title] a 2 s card last (default: \"Done\")\n\n AI (nothing calls a model without --ai):\n --ai <provider> gateway: our AI gateway (AI_GATEWAY_URL, AI_GATEWAY_KEY), DeepSeek first, then Gemini,\n then OpenAI; or gateway:<provider>[/<model>][,<provider>…]; openai:<model> (OPENAI_API_KEY,\n OPENAI_BASE_URL for any OpenAI-compatible server); or ./provider.js\n --ai-vision <model> the model for --qa's frames (gateway's DeepSeek default: deepseek-flash)\n --qa [strict] send a frame per step to the AI to look for errors, empty states, a stall, personal\n data; strict exits 1 when anything is flagged (needs a vision model)\n --alt write <out>.alt.txt; with --captions vtt, AI names the chapters\n --repair when a step can't find its element, propose a fix in <out>.repair.json (verified by\n playing again); still exits 1. With --ai, unsure cases are asked (DeepSeek first)\n --repair-vision with --repair and --ai: send a screenshot of the stalled page too\n\n Narration (MP4 only; nothing speaks without --voice):\n --voice <voice> gateway (our AI gateway: Gemini speech, AI_GATEWAY_URL/KEY), gateway:gemini/<model>:<voice>,\n openai:<model>[:<voice>] (OPENAI_API_KEY / OPENAI_BASE_URL), say[:<voice>] (macOS, offline),\n or ./voice.js. Each step's caption is spoken; the video holds where a line runs long\n --script <file.json> the spoken lines instead: { \"lines\": [{ \"n\": 1, \"text\": \"…\" }] }\n --voice-out <file.wav> also write the narration track\n --voice-strict fail when a line needs a hold longer than 8 s\n --no-voice-cache don't keep spoken lines in .trace-avatar-cache/voice\n\nSuggestions for a person to accept (the renderer never changes a trace):\n trace-avatar-render suggest <trace.json> --task captions|title|waits|narration --ai <provider> [--tone friendly|terse|formal]\n [--hints hints.json] [--out suggestions.json]\n trace-avatar-render apply <trace.json> <suggestions.json> --accept 1,3|all --out <new.trace.json>\n`;\n\nexport interface Parsed { trace: string; options: Parameters<typeof render>[0]; /** --ai, made into a provider by main(). */ ai?: string; /** --ai-vision */ aiVision?: string; /** --voice, made into a Voice by main() */ voice?: string; /** --no-voice-cache */ noVoiceCache?: boolean; /** --qa strict */ strict?: boolean }\n\n/** Parse the command line. Throws a usage message (exit 2) on mistakes. Exported for tests. */\nexport function parse(argv: string[]): Parsed {\n // --poster, --title-card and --end-card take an optional value: take it here when one follows (a\n // following *.json is the trace, not the value).\n const extra: { poster?: string | true; title?: string | true; end?: string | true; qa?: string | true } = {};\n const flags: Record<string, 'poster' | 'title' | 'end' | 'qa'> = { '--poster': 'poster', '--title-card': 'title', '--end-card': 'end', '--qa': 'qa' };\n const rest: string[] = [];\n for (let k = 0; k < argv.length; k += 1) {\n const a = argv[k];\n const eq = a.indexOf('=');\n const name = eq > 0 ? a.slice(0, eq) : a;\n if (flags[name]) {\n if (eq > 0) extra[flags[name]] = a.slice(eq + 1);\n else if (argv[k + 1] !== undefined && !argv[k + 1].startsWith('-') && !/\\.json$/i.test(argv[k + 1]) && (flags[name] !== 'qa' || argv[k + 1] === 'strict')) { extra[flags[name]] = argv[k + 1]; k += 1; }\n else extra[flags[name]] = true;\n continue;\n }\n rest.push(a);\n }\n const { values, positionals } = parseArgs({\n args: rest,\n allowPositionals: true,\n options: {\n url: { type: 'string' }, out: { type: 'string', multiple: true }, mode: { type: 'string' },\n 'allow-perform': { type: 'boolean' }, width: { type: 'string' }, fps: { type: 'string' },\n viewport: { type: 'string' }, scale: { type: 'string' }, 'storage-state': { type: 'string' },\n 'max-wait': { type: 'string' }, hide: { type: 'string', multiple: true }, blur: { type: 'string', multiple: true },\n 'allow-stall': { type: 'boolean' }, player: { type: 'string' }, timeline: { type: 'string' },\n timeout: { type: 'string' }, headed: { type: 'boolean' }, help: { type: 'boolean', short: 'h' },\n frame: { type: 'string' }, background: { type: 'string' }, camera: { type: 'boolean' }, zoom: { type: 'string' },\n captions: { type: 'string' }, ai: { type: 'string' }, 'ai-vision': { type: 'string' }, alt: { type: 'boolean' },\n voice: { type: 'string' }, script: { type: 'string' }, 'voice-out': { type: 'string' }, 'voice-strict': { type: 'boolean' }, 'no-voice-cache': { type: 'boolean' },\n repair: { type: 'boolean' }, 'repair-vision': { type: 'boolean' },\n },\n });\n if (values.help) throw new UsageError('');\n const trace = positionals[0];\n if (!trace) throw new UsageError('a trace file is needed');\n if (positionals.length > 1) throw new UsageError(`one trace at a time (got ${positionals.join(', ')})`);\n if (!values.url) throw new UsageError('--url is needed');\n if (!values.out?.length) throw new UsageError('--out is needed');\n const num = (name: string, v: string | undefined, min = 0) => {\n if (v === undefined) return undefined;\n const n = Number(v);\n if (!Number.isFinite(n) || n < min) throw new UsageError(`--${name} must be a number ≥ ${min}`);\n return n;\n };\n const mode = values.mode ?? 'overlay';\n if (mode !== 'overlay' && mode !== 'perform') throw new UsageError('--mode is overlay or perform');\n let viewport: { w: number; h: number } | undefined;\n if (values.viewport) {\n const m = /^(\\d+)x(\\d+)$/i.exec(values.viewport);\n if (!m) throw new UsageError('--viewport is WIDTHxHEIGHT, e.g. 1280x800');\n viewport = { w: Number(m[1]), h: Number(m[2]) };\n }\n if (values.frame && values.frame !== 'none' && values.frame !== 'browser') throw new UsageError('--frame is none or browser');\n const captions = values.captions;\n if (captions !== undefined && captions !== 'burn' && captions !== 'vtt' && captions !== 'both') throw new UsageError('--captions is burn, vtt or both');\n const zoom = num('zoom', values.zoom, 1);\n if (extra.qa !== undefined && extra.qa !== true && extra.qa !== 'strict') throw new UsageError('--qa takes nothing or strict');\n if ((extra.qa !== undefined || values.alt || values['ai-vision']) && !values.ai) throw new UsageError('--qa, --alt and --ai-vision need --ai');\n if (values['repair-vision'] && !(values.repair && values.ai)) throw new UsageError('--repair-vision needs --repair and --ai');\n if ((values.script || values['voice-out'] || values['voice-strict'] || values['no-voice-cache']) && !values.voice) throw new UsageError('--script, --voice-out, --voice-strict and --no-voice-cache need --voice');\n if (values.voice && !values.out.some((f) => /\\.mp4$/i.test(f))) throw new UsageError('--voice needs an .mp4 output (a GIF has no sound)');\n const width = num('width', values.width, 16);\n const fps = num('fps', values.fps, 1);\n const maxWait = num('max-wait', values['max-wait']);\n return {\n trace,\n options: {\n trace,\n url: values.url,\n mode,\n allowPerform: !!values['allow-perform'],\n out: values.out.map((file) => ({ file, ...(width ? { width } : {}), ...(fps ? { fps } : {}) })),\n ...(viewport ? { viewport } : {}),\n ...(values.scale ? { scale: num('scale', values.scale, 1) } : {}),\n ...(values['storage-state'] ? { storageState: values['storage-state'] } : {}),\n ...(maxWait !== undefined ? { cuts: { maxWaitMs: maxWait } } : {}),\n ...(values.hide ? { hide: values.hide } : {}),\n ...(values.blur ? { blur: values.blur } : {}),\n allowStall: !!values['allow-stall'],\n ...(values.player ? { player: values.player } : {}),\n ...(values.timeline ? { timeline: values.timeline } : {}),\n ...(values.timeout ? { timeoutMs: num('timeout', values.timeout, 1) } : {}),\n headless: !values.headed,\n ...(values.frame ? { frame: values.frame as 'none' | 'browser' } : {}),\n ...(values.background ? { background: values.background } : {}),\n ...(zoom ? { camera: { zoom } } : values.camera ? { camera: true } : {}),\n ...(captions ? { captions } : {}),\n ...(extra.poster !== undefined ? { poster: extra.poster } : {}),\n ...(extra.title !== undefined ? { titleCard: extra.title } : {}),\n ...(extra.end !== undefined ? { endCard: extra.end } : {}),\n ...(extra.qa !== undefined ? { qa: true } : {}),\n ...(values.alt ? { alt: true } : {}),\n ...(values.script ? { script: values.script } : {}),\n ...(values['voice-out'] ? { voiceOut: values['voice-out'] } : {}),\n ...(values['voice-strict'] ? { voiceStrict: true } : {}),\n ...(values.repair ? { repair: true } : {}),\n ...(values['repair-vision'] ? { repairVision: true } : {}),\n },\n ...(values.ai ? { ai: values.ai } : {}),\n ...(values['ai-vision'] ? { aiVision: values['ai-vision'] } : {}),\n ...(values.voice ? { voice: values.voice } : {}),\n ...(values['no-voice-cache'] ? { noVoiceCache: true } : {}),\n ...(extra.qa === 'strict' ? { strict: true } : {}),\n };\n}\n\nexport class UsageError extends Error {}\n\nexport async function main(argv: string[], io = { log: console.log, error: console.error }): Promise<number> {\n if (argv[0] === 'suggest' || argv[0] === 'apply') {\n try { return await (argv[0] === 'suggest' ? suggestCmd(argv.slice(1), io) : applyCmd(argv.slice(1), io)); } catch (e) {\n io.error(`trace-avatar-render ${argv[0]}: ${(e as Error).message}`);\n if (e instanceof UsageError) io.error(USAGE);\n return e instanceof UsageError ? 2 : 1;\n }\n }\n let p: Parsed;\n try { p = parse(argv); } catch (e) {\n const msg = (e as Error).message;\n if (msg) io.error(`trace-avatar-render: ${msg}\\n`);\n io.error(USAGE);\n return e instanceof UsageError && !msg ? 0 : 2;\n }\n try {\n if (p.ai) p.options.ai = await providerOf(p.ai, process.env, p.aiVision ? { vision: p.aiVision } : {});\n if (p.voice) p.options.voice = await voiceOf(p.voice, process.env, p.noVoiceCache ? { cacheDir: null } : {});\n const r = await render(p.options);\n for (const o of r.outputs) io.log(`${o.file} ${o.width}×${o.height} ${o.fps} fps ${(r.durationMs / 1000).toFixed(1)} s ${(o.bytes / 1024).toFixed(0)} KB`);\n if (r.rawMs > r.durationMs + 50) io.log(`cut ${((r.rawMs - r.durationMs) / 1000).toFixed(1)} s of waiting`);\n for (const f of [r.poster, r.vtt, r.chapters, r.alt]) if (f) io.log(f);\n if (r.narration) {\n io.log(`narration: ${r.narration.lines.length} line${r.narration.lines.length === 1 ? '' : 's'}${r.narration.holdMs ? `, the video holds ${(r.narration.holdMs / 1000).toFixed(1)} s for them` : ''} ${r.narration.text}`);\n if (r.narration.wav) io.log(r.narration.wav);\n }\n for (const w of r.warnings ?? []) io.error(`warning: ${w}`);\n if (r.qa) {\n if (!r.qa.length) io.log('qa: nothing flagged');\n for (const f of r.qa) io.log(`qa: ${(f.at / 1000).toFixed(1)} s ${f.kind} ${f.note}`);\n if (p.strict && r.qa.length) { io.error(`trace-avatar-render: qa flagged ${r.qa.length} problem${r.qa.length > 1 ? 's' : ''} (--qa strict)`); return 1; }\n }\n return 0;\n } catch (e) {\n io.error(`trace-avatar-render: ${(e as Error).message}`);\n if (e instanceof RenderError && e.screenshot) {\n const first = p.options.out[0];\n const shot = `${(typeof first === 'string' ? first : first.file).replace(/\\.[^./]+$/, '')}.failure.png`;\n writeFileSync(shot, e.screenshot);\n io.error(`the page at that moment: ${shot}`);\n }\n return 1;\n }\n}\n\nconst readJson = (file: string): unknown => {\n try { return JSON.parse(readFileSync(file, 'utf8')); } catch (e) { throw new Error(`could not read ${file}: ${(e as Error).message}`); }\n};\n\n/** suggest <trace.json> --task … --ai …: suggestions, numbered, as JSON (stdout or --out). */\nasync function suggestCmd(argv: string[], io: { log: (m: string) => void }): Promise<number> {\n const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: {\n task: { type: 'string' }, ai: { type: 'string' }, tone: { type: 'string' }, hints: { type: 'string' }, out: { type: 'string' }, 'send-typed': { type: 'boolean' },\n } });\n const [file] = positionals;\n if (!file) throw new UsageError('suggest needs a trace file');\n const task = values.task;\n if (task !== 'captions' && task !== 'title' && task !== 'waits' && task !== 'narration') throw new UsageError('--task is captions, title, waits or narration');\n if (!values.ai) throw new UsageError('suggest needs --ai');\n if (task === 'narration') {\n // A script file for --script: a person edits it before rendering.\n const r = await suggestScript(await providerOf(values.ai), readJson(file) as Parameters<typeof suggestScript>[1]);\n const out = JSON.stringify({ ...r.script, ...(r.dropped.length ? { dropped: r.dropped } : {}) }, null, 2);\n if (values.out) { writeFileSync(values.out, `${out}\\n`); io.log(`${r.script.lines.length} line${r.script.lines.length === 1 ? '' : 's'} in ${values.out}: edit them, then --script ${values.out}`); } else io.log(out);\n return 0;\n }\n const tone = values.tone;\n if (tone !== undefined && tone !== 'friendly' && tone !== 'terse' && tone !== 'formal') throw new UsageError('--tone is friendly, terse or formal');\n const trace = readJson(file) as Parameters<typeof suggest>[1];\n const hints = values.hints ? (readJson(values.hints) as Parameters<typeof suggest>[2]['hints']) : undefined;\n const r = await suggest(task, trace, { ai: await providerOf(values.ai), ...(hints ? { hints } : {}), ...(tone ? { tone } : {}), ...(values['send-typed'] ? { sendTyped: true } : {}) });\n const out = JSON.stringify({ task, suggestions: r.suggestions.map((sg, k) => ({ id: k + 1, ...sg })), dropped: r.dropped }, null, 2);\n if (values.out) { writeFileSync(values.out, `${out}\\n`); io.log(`${r.suggestions.length} suggestion${r.suggestions.length === 1 ? '' : 's'} in ${values.out}`); } else io.log(out);\n return 0;\n}\n\n/** apply <trace.json> <suggestions.json> --accept 1,3|all --out new.trace.json */\nasync function applyCmd(argv: string[], io: { log: (m: string) => void }): Promise<number> {\n const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: { accept: { type: 'string' }, out: { type: 'string' } } });\n const [file, sugFile] = positionals;\n if (!file || !sugFile) throw new UsageError('apply needs a trace file and a suggestions file');\n if (!values.accept) throw new UsageError('apply needs --accept 1,3 (or all): a person picks what goes in');\n if (!values.out) throw new UsageError('apply needs --out for the new trace');\n const all = (readJson(sugFile) as { suggestions?: Array<Suggestion & { id: number }> }).suggestions ?? [];\n const ids = values.accept === 'all' ? all.map((x) => x.id) : values.accept.split(',').map((x) => Number(x.trim()));\n const missing = ids.filter((id) => !all.some((x) => x.id === id));\n if (missing.length) throw new UsageError(`no suggestion ${missing.join(', ')} in ${sugFile}`);\n const next = applySuggestions(readJson(file) as Parameters<typeof applySuggestions>[0], all.filter((x) => ids.includes(x.id)));\n writeFileSync(values.out, `${JSON.stringify(next, null, 2)}\\n`);\n io.log(`applied ${ids.length} of ${all.length} to ${values.out}`);\n return 0;\n}\n\nconst isMain = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('/trace-avatar-render') || process.argv[1]?.endsWith('/cli.js');\nif (isMain) void main(process.argv.slice(2)).then((code) => { process.exitCode = code; });\n"],"mappings":"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","names":["r","out"]}
1
+ {"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * trace-avatar-render invoice.trace.json --url http://localhost:3000/app --out invoice.gif --out invoice.mp4\n *\n * Exit codes: 0 rendered, 1 the render failed (a stalled guide, an error in the app), 2 wrong usage.\n */\n\nimport { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { apply as applySuggestions, suggest } from 'trace-avatar/assist';\nimport type { Suggestion } from 'trace-avatar/assist';\nimport { providerOf } from './ai';\nimport { suggestScript } from './narration';\nimport { voiceOf } from './voice';\nimport { parseArgs } from 'node:util';\nimport { RenderError } from './capture';\nimport { render } from './render';\n\nexport const USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gif|file.mp4> [options]\n\n --url <url> the page the guide starts on (required)\n --out <file> .gif or .mp4; repeat for several (required)\n --mode <overlay|perform> Show me (default) or Do it for me\n --allow-perform needed for perform: it clicks and types for real (use a sandbox account)\n --width <px> output width (GIF default 800, MP4 the capture's)\n --fps <n> frames per second (GIF default 12, MP4 30)\n --viewport <WxH> default: the trace's meta.viewport, else 1280x800\n --scale <n> device pixel ratio of the capture (2 for crisp video)\n --storage-state <file> a signed-in Playwright session\n --max-wait <ms> waits longer than this are cut to it (default 800, 0 keeps them)\n --hide <selector> hidden before capture; repeatable\n --blur <selector> blurred before capture (as well as [data-trace-blur]); repeatable\n --allow-stall render a stalled guide anyway instead of failing\n --navigate a step on another page: load that page, as the app's router would (without it, a\n Show me guide that crosses pages waits on \"Open … to continue\")\n --security [guards] perform: leave these to the viewer (a hand-off): all, or secrets,money,files\n --value <name=text> perform: a value to type, by name or field label (e.g. password=demo-pass); repeatable\n --player <file> the trace-perform.min.js to use (default: the installed trace-avatar)\n --timeline <file> write the timeline and the cuts as JSON\n --timeout <ms> give up after this long (default 120000)\n --report <file> write what happened as JSON: { outcome: passed|stalled|failed, step, reason, message }\n (for CI: one result per guide, whatever the exit code)\n --headed show the browser\n\n Polish (all off by default):\n --frame <none|browser> a browser window around the app, on a background\n --background <css> the background behind the window and on the cards\n --camera zoom in on each action and pan between close ones\n --zoom <n> how far the camera goes in (default 1.6; implies --camera)\n --captions <burn|vtt|both> burn the steps' words in, write <out>.vtt + <out>.chapters.vtt, or both\n --poster [file] a PNG at the first click (default <out>.png)\n --title-card [title] a 1.5 s card first (default: the trace's title)\n --end-card [title] a 2 s card last (default: \"Done\")\n\n AI (nothing calls a model without --ai):\n --ai <provider> gateway: our AI gateway (AI_GATEWAY_URL, AI_GATEWAY_KEY), DeepSeek first, then Gemini,\n then OpenAI; or gateway:<provider>[/<model>][,<provider>…]; openai:<model> (OPENAI_API_KEY,\n OPENAI_BASE_URL for any OpenAI-compatible server); or ./provider.js\n --ai-vision <model> the model for --qa's frames (gateway's DeepSeek default: deepseek-flash)\n --qa [strict] send a frame per step to the AI to look for errors, empty states, a stall, personal\n data; strict exits 1 when anything is flagged (needs a vision model)\n --alt write <out>.alt.txt; with --captions vtt, AI names the chapters\n --repair when a step can't find its element, or a wait's text never shows, propose a fix in\n <out>.repair.json (verified by playing again); still exits 1. With --ai, unsure\n cases are asked (DeepSeek first)\n --repair-vision with --repair and --ai: send a screenshot of the stalled page too (elements only)\n\n Narration (MP4 only; nothing speaks without --voice):\n --voice <voice> gateway (our AI gateway: Gemini speech, AI_GATEWAY_URL/KEY), gateway:gemini/<model>:<voice>,\n openai:<model>[:<voice>] (OPENAI_API_KEY / OPENAI_BASE_URL), say[:<voice>] (macOS, offline),\n or ./voice.js. Each step's caption is spoken; the video holds where a line runs long\n --script <file.json> the spoken lines instead: { \"lines\": [{ \"n\": 1, \"text\": \"…\" }] }\n --voice-out <file.wav> also write the narration track\n --voice-strict fail when a line needs a hold longer than 8 s\n --no-voice-cache don't keep spoken lines in .trace-avatar-cache/voice\n\nSuggestions for a person to accept (the renderer never changes a trace):\n trace-avatar-render suggest <trace.json> --task captions|title|waits|narration --ai <provider> [--tone friendly|terse|formal]\n [--hints hints.json] [--out suggestions.json]\n trace-avatar-render apply <trace.json> <suggestions.json> --accept 1,3|all --out <new.trace.json>\n`;\n\nexport interface Parsed { /** --report */ report?: string; trace: string; options: Parameters<typeof render>[0]; /** --ai, made into a provider by main(). */ ai?: string; /** --ai-vision */ aiVision?: string; /** --voice, made into a Voice by main() */ voice?: string; /** --no-voice-cache */ noVoiceCache?: boolean; /** --qa strict */ strict?: boolean }\n\n/** Parse the command line. Throws a usage message (exit 2) on mistakes. Exported for tests. */\nexport function parse(argv: string[]): Parsed {\n // --poster, --title-card and --end-card take an optional value: take it here when one follows (a\n // following *.json is the trace, not the value).\n const extra: { poster?: string | true; title?: string | true; end?: string | true; qa?: string | true } = {};\n const flags: Record<string, 'poster' | 'title' | 'end' | 'qa'> = { '--poster': 'poster', '--title-card': 'title', '--end-card': 'end', '--qa': 'qa' };\n const rest: string[] = [];\n for (let k = 0; k < argv.length; k += 1) {\n const a = argv[k];\n const eq = a.indexOf('=');\n const name = eq > 0 ? a.slice(0, eq) : a;\n if (flags[name]) {\n if (eq > 0) extra[flags[name]] = a.slice(eq + 1);\n else if (argv[k + 1] !== undefined && !argv[k + 1].startsWith('-') && !/\\.json$/i.test(argv[k + 1]) && (flags[name] !== 'qa' || argv[k + 1] === 'strict')) { extra[flags[name]] = argv[k + 1]; k += 1; }\n else extra[flags[name]] = true;\n continue;\n }\n rest.push(a);\n }\n const { values, positionals } = parseArgs({\n args: rest,\n allowPositionals: true,\n options: {\n url: { type: 'string' }, out: { type: 'string', multiple: true }, mode: { type: 'string' },\n 'allow-perform': { type: 'boolean' }, width: { type: 'string' }, fps: { type: 'string' },\n viewport: { type: 'string' }, scale: { type: 'string' }, 'storage-state': { type: 'string' },\n 'max-wait': { type: 'string' }, hide: { type: 'string', multiple: true }, blur: { type: 'string', multiple: true },\n 'allow-stall': { type: 'boolean' }, navigate: { type: 'boolean' }, security: { type: 'string' }, value: { type: 'string', multiple: true }, player: { type: 'string' }, timeline: { type: 'string' },\n timeout: { type: 'string' }, headed: { type: 'boolean' }, help: { type: 'boolean', short: 'h' },\n frame: { type: 'string' }, background: { type: 'string' }, camera: { type: 'boolean' }, zoom: { type: 'string' },\n captions: { type: 'string' }, ai: { type: 'string' }, 'ai-vision': { type: 'string' }, alt: { type: 'boolean' },\n voice: { type: 'string' }, script: { type: 'string' }, 'voice-out': { type: 'string' }, 'voice-strict': { type: 'boolean' }, 'no-voice-cache': { type: 'boolean' },\n repair: { type: 'boolean' }, 'repair-vision': { type: 'boolean' }, report: { type: 'string' },\n },\n });\n if (values.help) throw new UsageError('');\n const trace = positionals[0];\n if (!trace) throw new UsageError('a trace file is needed');\n if (positionals.length > 1) throw new UsageError(`one trace at a time (got ${positionals.join(', ')})`);\n if (!values.url) throw new UsageError('--url is needed');\n if (!values.out?.length) throw new UsageError('--out is needed');\n const num = (name: string, v: string | undefined, min = 0) => {\n if (v === undefined) return undefined;\n const n = Number(v);\n if (!Number.isFinite(n) || n < min) throw new UsageError(`--${name} must be a number ≥ ${min}`);\n return n;\n };\n const mode = values.mode ?? 'overlay';\n if (mode !== 'overlay' && mode !== 'perform') throw new UsageError('--mode is overlay or perform');\n let viewport: { w: number; h: number } | undefined;\n if (values.viewport) {\n const m = /^(\\d+)x(\\d+)$/i.exec(values.viewport);\n if (!m) throw new UsageError('--viewport is WIDTHxHEIGHT, e.g. 1280x800');\n viewport = { w: Number(m[1]), h: Number(m[2]) };\n }\n if (values.frame && values.frame !== 'none' && values.frame !== 'browser') throw new UsageError('--frame is none or browser');\n const captions = values.captions;\n if (captions !== undefined && captions !== 'burn' && captions !== 'vtt' && captions !== 'both') throw new UsageError('--captions is burn, vtt or both');\n const zoom = num('zoom', values.zoom, 1);\n if (extra.qa !== undefined && extra.qa !== true && extra.qa !== 'strict') throw new UsageError('--qa takes nothing or strict');\n if ((extra.qa !== undefined || values.alt || values['ai-vision']) && !values.ai) throw new UsageError('--qa, --alt and --ai-vision need --ai');\n if (values['repair-vision'] && !(values.repair && values.ai)) throw new UsageError('--repair-vision needs --repair and --ai');\n if ((values.script || values['voice-out'] || values['voice-strict'] || values['no-voice-cache']) && !values.voice) throw new UsageError('--script, --voice-out, --voice-strict and --no-voice-cache need --voice');\n if (values.voice && !values.out.some((f) => /\\.mp4$/i.test(f))) throw new UsageError('--voice needs an .mp4 output (a GIF has no sound)');\n let security: boolean | string[] | undefined;\n if (values.security !== undefined) {\n const s = values.security.trim().toLowerCase();\n const guards = s === '' || s === 'all' || s === 'true' ? true : s.split(/[\\s,]+/).filter(Boolean);\n if (Array.isArray(guards) && guards.some((g) => !['secrets', 'money', 'files'].includes(g))) throw new UsageError('--security is all, or a list of secrets, money, files');\n security = guards;\n }\n const typed: Record<string, string> = {};\n for (const v of values.value ?? []) {\n const k = v.indexOf('=');\n if (k < 1) throw new UsageError('--value is name=text, e.g. password=demo-pass');\n typed[v.slice(0, k)] = v.slice(k + 1);\n }\n if ((security !== undefined || values.value?.length) && mode !== 'perform') throw new UsageError('--security and --value are for --mode perform');\n const width = num('width', values.width, 16);\n const fps = num('fps', values.fps, 1);\n const maxWait = num('max-wait', values['max-wait']);\n return {\n trace,\n options: {\n trace,\n url: values.url,\n mode,\n allowPerform: !!values['allow-perform'],\n out: values.out.map((file) => ({ file, ...(width ? { width } : {}), ...(fps ? { fps } : {}) })),\n ...(viewport ? { viewport } : {}),\n ...(values.scale ? { scale: num('scale', values.scale, 1) } : {}),\n ...(values['storage-state'] ? { storageState: values['storage-state'] } : {}),\n ...(maxWait !== undefined ? { cuts: { maxWaitMs: maxWait } } : {}),\n ...(values.hide ? { hide: values.hide } : {}),\n ...(values.blur ? { blur: values.blur } : {}),\n allowStall: !!values['allow-stall'],\n ...(values.navigate ? { navigate: true } : {}),\n ...(security !== undefined ? { security } : {}),\n ...(values.value?.length ? { values: typed } : {}),\n ...(values.player ? { player: values.player } : {}),\n ...(values.timeline ? { timeline: values.timeline } : {}),\n ...(values.timeout ? { timeoutMs: num('timeout', values.timeout, 1) } : {}),\n headless: !values.headed,\n ...(values.frame ? { frame: values.frame as 'none' | 'browser' } : {}),\n ...(values.background ? { background: values.background } : {}),\n ...(zoom ? { camera: { zoom } } : values.camera ? { camera: true } : {}),\n ...(captions ? { captions } : {}),\n ...(extra.poster !== undefined ? { poster: extra.poster } : {}),\n ...(extra.title !== undefined ? { titleCard: extra.title } : {}),\n ...(extra.end !== undefined ? { endCard: extra.end } : {}),\n ...(extra.qa !== undefined ? { qa: true } : {}),\n ...(values.alt ? { alt: true } : {}),\n ...(values.script ? { script: values.script } : {}),\n ...(values['voice-out'] ? { voiceOut: values['voice-out'] } : {}),\n ...(values['voice-strict'] ? { voiceStrict: true } : {}),\n ...(values.repair ? { repair: true } : {}),\n ...(values['repair-vision'] ? { repairVision: true } : {}),\n },\n ...(values.ai ? { ai: values.ai } : {}),\n ...(values['ai-vision'] ? { aiVision: values['ai-vision'] } : {}),\n ...(values.voice ? { voice: values.voice } : {}),\n ...(values['no-voice-cache'] ? { noVoiceCache: true } : {}),\n ...(extra.qa === 'strict' ? { strict: true } : {}),\n ...(values.report ? { report: values.report } : {}),\n };\n}\n\n/** What --report writes: one guide's outcome, for CI. */\nexport interface Report {\n outcome: 'passed' | 'stalled' | 'failed';\n /** The stalled step (from 0); null otherwise. */\n step: number | null;\n reason: 'not-found' | 'until-timeout' | null;\n /** The stalled step's caption, or the error. */\n message: string | null;\n /** The repair file, when --repair wrote one. */\n repair?: string;\n}\n\n/** The report for a render's outcome (exported for tests). */\nexport function reportOf(err: unknown, traceFile: string, repairFile?: string): Report {\n if (!err) return { outcome: 'passed', step: null, reason: null, message: null };\n const stall = err instanceof RenderError ? err.stall : undefined;\n if (stall && Number.isInteger(stall.index)) {\n let say: string | null = null;\n try { say = ((JSON.parse(readFileSync(traceFile, 'utf8')) as { steps?: Array<{ say?: string }> }).steps?.[stall.index]?.say) ?? null; } catch { /* the error is enough */ }\n return {\n outcome: 'stalled', step: stall.index, reason: stall.reason === 'until-timeout' ? 'until-timeout' : 'not-found',\n message: say ?? (err as Error).message, ...(repairFile && existsSync(repairFile) ? { repair: repairFile } : {}),\n };\n }\n return { outcome: 'failed', step: null, reason: null, message: (err as Error)?.message ?? String(err) };\n}\n\nexport class UsageError extends Error {}\n\nexport async function main(argv: string[], io = { log: console.log, error: console.error }): Promise<number> {\n if (argv[0] === 'suggest' || argv[0] === 'apply') {\n try { return await (argv[0] === 'suggest' ? suggestCmd(argv.slice(1), io) : applyCmd(argv.slice(1), io)); } catch (e) {\n io.error(`trace-avatar-render ${argv[0]}: ${(e as Error).message}`);\n if (e instanceof UsageError) io.error(USAGE);\n return e instanceof UsageError ? 2 : 1;\n }\n }\n let p: Parsed;\n try { p = parse(argv); } catch (e) {\n const msg = (e as Error).message;\n if (msg) io.error(`trace-avatar-render: ${msg}\\n`);\n io.error(USAGE);\n return e instanceof UsageError && !msg ? 0 : 2;\n }\n try {\n if (p.ai) p.options.ai = await providerOf(p.ai, process.env, p.aiVision ? { vision: p.aiVision } : {});\n if (p.voice) p.options.voice = await voiceOf(p.voice, process.env, p.noVoiceCache ? { cacheDir: null } : {});\n const r = await render(p.options);\n for (const o of r.outputs) io.log(`${o.file} ${o.width}×${o.height} ${o.fps} fps ${(r.durationMs / 1000).toFixed(1)} s ${(o.bytes / 1024).toFixed(0)} KB`);\n if (r.rawMs > r.durationMs + 50) io.log(`cut ${((r.rawMs - r.durationMs) / 1000).toFixed(1)} s of waiting`);\n for (const f of [r.poster, r.vtt, r.chapters, r.alt]) if (f) io.log(f);\n if (r.narration) {\n io.log(`narration: ${r.narration.lines.length} line${r.narration.lines.length === 1 ? '' : 's'}${r.narration.holdMs ? `, the video holds ${(r.narration.holdMs / 1000).toFixed(1)} s for them` : ''} ${r.narration.text}`);\n if (r.narration.wav) io.log(r.narration.wav);\n }\n for (const w of r.warnings ?? []) io.error(`warning: ${w}`);\n if (p.report) writeFileSync(p.report, `${JSON.stringify(reportOf(null, p.trace), null, 2)}\\n`);\n if (r.qa) {\n if (!r.qa.length) io.log('qa: nothing flagged');\n for (const f of r.qa) io.log(`qa: ${(f.at / 1000).toFixed(1)} s ${f.kind} ${f.note}`);\n if (p.strict && r.qa.length) { io.error(`trace-avatar-render: qa flagged ${r.qa.length} problem${r.qa.length > 1 ? 's' : ''} (--qa strict)`); return 1; }\n }\n return 0;\n } catch (e) {\n io.error(`trace-avatar-render: ${(e as Error).message}`);\n if (p.report) {\n const first = p.options.out[0];\n const base = (typeof first === 'string' ? first : first.file).replace(/\\.[^./]+$/, '');\n writeFileSync(p.report, `${JSON.stringify(reportOf(e, p.trace, `${base}.repair.json`), null, 2)}\\n`);\n }\n if (e instanceof RenderError && e.screenshot) {\n const first = p.options.out[0];\n const shot = `${(typeof first === 'string' ? first : first.file).replace(/\\.[^./]+$/, '')}.failure.png`;\n writeFileSync(shot, e.screenshot);\n io.error(`the page at that moment: ${shot}`);\n }\n return 1;\n }\n}\n\nconst readJson = (file: string): unknown => {\n try { return JSON.parse(readFileSync(file, 'utf8')); } catch (e) { throw new Error(`could not read ${file}: ${(e as Error).message}`); }\n};\n\n/** suggest <trace.json> --task … --ai …: suggestions, numbered, as JSON (stdout or --out). */\nasync function suggestCmd(argv: string[], io: { log: (m: string) => void }): Promise<number> {\n const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: {\n task: { type: 'string' }, ai: { type: 'string' }, tone: { type: 'string' }, hints: { type: 'string' }, out: { type: 'string' }, 'send-typed': { type: 'boolean' },\n } });\n const [file] = positionals;\n if (!file) throw new UsageError('suggest needs a trace file');\n const task = values.task;\n if (task !== 'captions' && task !== 'title' && task !== 'waits' && task !== 'narration') throw new UsageError('--task is captions, title, waits or narration');\n if (!values.ai) throw new UsageError('suggest needs --ai');\n if (task === 'narration') {\n // A script file for --script: a person edits it before rendering.\n const r = await suggestScript(await providerOf(values.ai), readJson(file) as Parameters<typeof suggestScript>[1]);\n const out = JSON.stringify({ ...r.script, ...(r.dropped.length ? { dropped: r.dropped } : {}) }, null, 2);\n if (values.out) { writeFileSync(values.out, `${out}\\n`); io.log(`${r.script.lines.length} line${r.script.lines.length === 1 ? '' : 's'} in ${values.out}: edit them, then --script ${values.out}`); } else io.log(out);\n return 0;\n }\n const tone = values.tone;\n if (tone !== undefined && tone !== 'friendly' && tone !== 'terse' && tone !== 'formal') throw new UsageError('--tone is friendly, terse or formal');\n const trace = readJson(file) as Parameters<typeof suggest>[1];\n const hints = values.hints ? (readJson(values.hints) as Parameters<typeof suggest>[2]['hints']) : undefined;\n const r = await suggest(task, trace, { ai: await providerOf(values.ai), ...(hints ? { hints } : {}), ...(tone ? { tone } : {}), ...(values['send-typed'] ? { sendTyped: true } : {}) });\n const out = JSON.stringify({ task, suggestions: r.suggestions.map((sg, k) => ({ id: k + 1, ...sg })), dropped: r.dropped }, null, 2);\n if (values.out) { writeFileSync(values.out, `${out}\\n`); io.log(`${r.suggestions.length} suggestion${r.suggestions.length === 1 ? '' : 's'} in ${values.out}`); } else io.log(out);\n return 0;\n}\n\n/** apply <trace.json> <suggestions.json> --accept 1,3|all --out new.trace.json */\nasync function applyCmd(argv: string[], io: { log: (m: string) => void }): Promise<number> {\n const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: { accept: { type: 'string' }, out: { type: 'string' } } });\n const [file, sugFile] = positionals;\n if (!file || !sugFile) throw new UsageError('apply needs a trace file and a suggestions file');\n if (!values.accept) throw new UsageError('apply needs --accept 1,3 (or all): a person picks what goes in');\n if (!values.out) throw new UsageError('apply needs --out for the new trace');\n const all = (readJson(sugFile) as { suggestions?: Array<Suggestion & { id: number }> }).suggestions ?? [];\n const ids = values.accept === 'all' ? all.map((x) => x.id) : values.accept.split(',').map((x) => Number(x.trim()));\n const missing = ids.filter((id) => !all.some((x) => x.id === id));\n if (missing.length) throw new UsageError(`no suggestion ${missing.join(', ')} in ${sugFile}`);\n const next = applySuggestions(readJson(file) as Parameters<typeof applySuggestions>[0], all.filter((x) => ids.includes(x.id)));\n writeFileSync(values.out, `${JSON.stringify(next, null, 2)}\\n`);\n io.log(`applied ${ids.length} of ${all.length} to ${values.out}`);\n return 0;\n}\n\nconst isMain = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('/trace-avatar-render') || process.argv[1]?.endsWith('/cli.js');\nif (isMain) void main(process.argv.slice(2)).then((code) => { process.exitCode = code; });\n"],"mappings":"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","names":["r","out"]}
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { Page, Browser } from 'playwright';
2
- import { Ai, preview, Suggestion, Candidate, applyRaw } from 'trace-avatar/assist';
2
+ import { Ai, preview, Suggestion, Candidate, TextCandidate, applyRaw } from 'trace-avatar/assist';
3
3
 
4
4
  /**
5
5
  * The guide's own timeline, and the edit list made from it. PURE: plain numbers in, plain numbers out.
@@ -102,6 +102,12 @@ interface CaptureOptions {
102
102
  /** Selectors blurred before capture, as well as [data-trace-blur]. */
103
103
  blur?: string[];
104
104
  rate?: number;
105
+ /** When a step is on another page, load that page (as an app's router would) instead of waiting for it. */
106
+ navigate?: boolean;
107
+ /** Perform mode: what the guide leaves to the viewer (trace-avatar's `security`). */
108
+ security?: boolean | string[];
109
+ /** Perform mode: values to type, by name or field label (trace-avatar's `values`). */
110
+ values?: Record<string, string>;
105
111
  /** The player's own captions: 'none' when the renderer burns them in itself. Default: the player's. */
106
112
  captions?: 'bubble' | 'bar' | 'none';
107
113
  /** A guide's own pause (or a hand-off) is held this long, then it plays on. Default 1200. */
@@ -531,6 +537,15 @@ interface RenderOptions {
531
537
  };
532
538
  /** Render a stalled guide anyway instead of failing. */
533
539
  allowStall?: boolean;
540
+ /**
541
+ * When a step is on another page, load it, as the app's router would (`navigate` in the player). Without it, a
542
+ * Show me guide that crosses pages waits on "Open … to continue" until the render times out.
543
+ */
544
+ navigate?: boolean;
545
+ /** Perform mode: what the guide leaves to the viewer, as trace-avatar's `security` (true, or 'secrets', 'money', 'files'). Default none. */
546
+ security?: boolean | string[];
547
+ /** Perform mode: values to type, by name or field label, e.g. { password: 'demo-pass' } (trace-avatar's `values`). */
548
+ values?: Record<string, string>;
534
549
  hide?: string[];
535
550
  blur?: string[];
536
551
  rate?: number;
@@ -571,8 +586,9 @@ interface RenderOptions {
571
586
  voiceStrict?: boolean;
572
587
  /** Also write the narration track here (WAV). */
573
588
  voiceOut?: string;
574
- /** When a step can't find its element: propose a fix (<out>.repair.json, for `apply`), verified by playing
575
- * the guide again with it. The render still fails: a person accepts the fix. With `ai`, unsure cases are asked. */
589
+ /** When a step can't find its element, or a wait's text never shows: propose a fix (<out>.repair.json, for
590
+ * `apply`), verified by playing the guide again with it. The render still fails: a person accepts the fix.
591
+ * With `ai`, unsure cases are asked; a wait with no clear text is offered as a guess (`by: 'guess'`). */
576
592
  repair?: boolean;
577
593
  /** With repair and ai: send a screenshot of the stalled page too. */
578
594
  repairVision?: boolean;
@@ -764,23 +780,26 @@ declare function cueAt(cues: readonly Cue[], t: number, fadeMs?: number): {
764
780
  /**
765
781
  * --repair: when a step can't find its element, look at the page as it is now, choose what the step means
766
782
  * (code first, the AI only when unsure), re-record that element as the step's target, and play the guide
767
- * again with the fix (in memory) to see that it gets past the step. Up to `maxStalls` stalls in one run.
783
+ * again with the fix (in memory) to see that it gets past the step. A wait whose text never showed is fixed
784
+ * the same way: the texts on the page (and those that showed while it waited) are scored, and the chosen one
785
+ * becomes what the step waits for. Up to `maxStalls` stalls in one run.
768
786
  *
769
787
  * Nothing is written to the trace: the fixes are suggestions in a file that `apply` takes once a person agrees.
770
788
  */
771
789
 
772
790
  type Trace = Parameters<typeof applyRaw>[0];
791
+ /** `by: 'guess'`: a wait's text that was not a clear winner (the best that scored well, or what showed after the action), kept only when the replay passes. */
773
792
  interface RepairSuggestion extends Suggestion {
774
793
  id: number;
775
- by: 'score' | 'ai';
794
+ by: 'score' | 'ai' | 'guess';
776
795
  score?: number;
777
796
  }
778
797
  interface Unresolved {
779
798
  index: number;
780
799
  reason: string;
781
800
  why: string;
782
- /** The best candidates by score, for a person to pick from. */
783
- top: Array<Omit<Candidate, 'key'> & {
801
+ /** The best candidates by score, for a person to pick from: elements, or (for a wait) texts. */
802
+ top: Array<(Omit<Candidate, 'key'> | Omit<TextCandidate, 'id'>) & {
784
803
  score: number;
785
804
  }>;
786
805
  }
@@ -797,6 +816,13 @@ interface Found {
797
816
  score?: number;
798
817
  why?: string;
799
818
  };
819
+ /** For a wait: the text to wait for now. */
820
+ text?: {
821
+ value: string;
822
+ by: 'score' | 'ai' | 'guess';
823
+ score?: number;
824
+ why?: string;
825
+ };
800
826
  why?: string;
801
827
  top: Unresolved['top'];
802
828
  }
package/dist/index.js CHANGED
@@ -66,7 +66,7 @@ import {
66
66
  trimSilence,
67
67
  voiceOf,
68
68
  withHolds
69
- } from "./chunk-BM26YQ4L.js";
69
+ } from "./chunk-VTXIXGG4.js";
70
70
  export {
71
71
  DEFAULT_BACKGROUND,
72
72
  DEFAULT_MAX_WAIT_MS,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "trace-avatar-render",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Render a trace-avatar guide to a GIF or MP4 by playing it on your real app in headless Chromium.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -60,7 +60,7 @@
60
60
  "gifenc": "^1.0.3",
61
61
  "playwright": "^1.65.0",
62
62
  "pngjs": "^7.0.0",
63
- "trace-avatar": "^0.1.7"
63
+ "trace-avatar": "^0.1.13"
64
64
  },
65
65
  "devDependencies": {
66
66
  "@types/node": "^22.0.0",