trace-avatar-render 0.1.0 → 0.1.1
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/CHANGELOG.md +12 -0
- package/README.md +8 -1
- package/dist/{chunk-BM26YQ4L.js → chunk-PE3MNBRB.js} +35 -7
- package/dist/chunk-PE3MNBRB.js.map +1 -0
- package/dist/cli.js +41 -8
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +18 -7
- package/dist/index.js +1 -1
- package/package.json +2 -2
- package/dist/chunk-BM26YQ4L.js.map +0 -1
package/dist/cli.js
CHANGED
|
@@ -5,10 +5,10 @@ import {
|
|
|
5
5
|
render,
|
|
6
6
|
suggestScript,
|
|
7
7
|
voiceOf
|
|
8
|
-
} from "./chunk-
|
|
8
|
+
} from "./chunk-PE3MNBRB.js";
|
|
9
9
|
|
|
10
10
|
// src/cli.ts
|
|
11
|
-
import { readFileSync, writeFileSync } from "fs";
|
|
11
|
+
import { existsSync, readFileSync, writeFileSync } from "fs";
|
|
12
12
|
import { apply as applySuggestions, suggest } from "trace-avatar/assist";
|
|
13
13
|
import { parseArgs } from "util";
|
|
14
14
|
var USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gif|file.mp4> [options]
|
|
@@ -29,6 +29,8 @@ var USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gi
|
|
|
29
29
|
--player <file> the trace-perform.min.js to use (default: the installed trace-avatar)
|
|
30
30
|
--timeline <file> write the timeline and the cuts as JSON
|
|
31
31
|
--timeout <ms> give up after this long (default 120000)
|
|
32
|
+
--report <file> write what happened as JSON: { outcome: passed|stalled|failed, step, reason, message }
|
|
33
|
+
(for CI: one result per guide, whatever the exit code)
|
|
32
34
|
--headed show the browser
|
|
33
35
|
|
|
34
36
|
Polish (all off by default):
|
|
@@ -49,9 +51,10 @@ var USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gi
|
|
|
49
51
|
--qa [strict] send a frame per step to the AI to look for errors, empty states, a stall, personal
|
|
50
52
|
data; strict exits 1 when anything is flagged (needs a vision model)
|
|
51
53
|
--alt write <out>.alt.txt; with --captions vtt, AI names the chapters
|
|
52
|
-
--repair when a step can't find its element, propose a fix in
|
|
53
|
-
playing again); still exits 1. With --ai, unsure
|
|
54
|
-
|
|
54
|
+
--repair when a step can't find its element, or a wait's text never shows, propose a fix in
|
|
55
|
+
<out>.repair.json (verified by playing again); still exits 1. With --ai, unsure
|
|
56
|
+
cases are asked (DeepSeek first)
|
|
57
|
+
--repair-vision with --repair and --ai: send a screenshot of the stalled page too (elements only)
|
|
55
58
|
|
|
56
59
|
Narration (MP4 only; nothing speaks without --voice):
|
|
57
60
|
--voice <voice> gateway (our AI gateway: Gemini speech, AI_GATEWAY_URL/KEY), gateway:gemini/<model>:<voice>,
|
|
@@ -121,7 +124,8 @@ function parse(argv) {
|
|
|
121
124
|
"voice-strict": { type: "boolean" },
|
|
122
125
|
"no-voice-cache": { type: "boolean" },
|
|
123
126
|
repair: { type: "boolean" },
|
|
124
|
-
"repair-vision": { type: "boolean" }
|
|
127
|
+
"repair-vision": { type: "boolean" },
|
|
128
|
+
report: { type: "string" }
|
|
125
129
|
}
|
|
126
130
|
});
|
|
127
131
|
if (values.help) throw new UsageError("");
|
|
@@ -194,9 +198,29 @@ function parse(argv) {
|
|
|
194
198
|
...values["ai-vision"] ? { aiVision: values["ai-vision"] } : {},
|
|
195
199
|
...values.voice ? { voice: values.voice } : {},
|
|
196
200
|
...values["no-voice-cache"] ? { noVoiceCache: true } : {},
|
|
197
|
-
...extra.qa === "strict" ? { strict: true } : {}
|
|
201
|
+
...extra.qa === "strict" ? { strict: true } : {},
|
|
202
|
+
...values.report ? { report: values.report } : {}
|
|
198
203
|
};
|
|
199
204
|
}
|
|
205
|
+
function reportOf(err, traceFile, repairFile) {
|
|
206
|
+
if (!err) return { outcome: "passed", step: null, reason: null, message: null };
|
|
207
|
+
const stall = err instanceof RenderError ? err.stall : void 0;
|
|
208
|
+
if (stall && Number.isInteger(stall.index)) {
|
|
209
|
+
let say = null;
|
|
210
|
+
try {
|
|
211
|
+
say = JSON.parse(readFileSync(traceFile, "utf8")).steps?.[stall.index]?.say ?? null;
|
|
212
|
+
} catch {
|
|
213
|
+
}
|
|
214
|
+
return {
|
|
215
|
+
outcome: "stalled",
|
|
216
|
+
step: stall.index,
|
|
217
|
+
reason: stall.reason === "until-timeout" ? "until-timeout" : "not-found",
|
|
218
|
+
message: say ?? err.message,
|
|
219
|
+
...repairFile && existsSync(repairFile) ? { repair: repairFile } : {}
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
return { outcome: "failed", step: null, reason: null, message: err?.message ?? String(err) };
|
|
223
|
+
}
|
|
200
224
|
var UsageError = class extends Error {
|
|
201
225
|
};
|
|
202
226
|
async function main(argv, io = { log: console.log, error: console.error }) {
|
|
@@ -231,6 +255,8 @@ async function main(argv, io = { log: console.log, error: console.error }) {
|
|
|
231
255
|
if (r.narration.wav) io.log(r.narration.wav);
|
|
232
256
|
}
|
|
233
257
|
for (const w of r.warnings ?? []) io.error(`warning: ${w}`);
|
|
258
|
+
if (p.report) writeFileSync(p.report, `${JSON.stringify(reportOf(null, p.trace), null, 2)}
|
|
259
|
+
`);
|
|
234
260
|
if (r.qa) {
|
|
235
261
|
if (!r.qa.length) io.log("qa: nothing flagged");
|
|
236
262
|
for (const f of r.qa) io.log(`qa: ${(f.at / 1e3).toFixed(1)} s ${f.kind} ${f.note}`);
|
|
@@ -242,6 +268,12 @@ async function main(argv, io = { log: console.log, error: console.error }) {
|
|
|
242
268
|
return 0;
|
|
243
269
|
} catch (e) {
|
|
244
270
|
io.error(`trace-avatar-render: ${e.message}`);
|
|
271
|
+
if (p.report) {
|
|
272
|
+
const first = p.options.out[0];
|
|
273
|
+
const base = (typeof first === "string" ? first : first.file).replace(/\.[^./]+$/, "");
|
|
274
|
+
writeFileSync(p.report, `${JSON.stringify(reportOf(e, p.trace, `${base}.repair.json`), null, 2)}
|
|
275
|
+
`);
|
|
276
|
+
}
|
|
245
277
|
if (e instanceof RenderError && e.screenshot) {
|
|
246
278
|
const first = p.options.out[0];
|
|
247
279
|
const shot = `${(typeof first === "string" ? first : first.file).replace(/\.[^./]+$/, "")}.failure.png`;
|
|
@@ -319,6 +351,7 @@ export {
|
|
|
319
351
|
USAGE,
|
|
320
352
|
UsageError,
|
|
321
353
|
main,
|
|
322
|
-
parse
|
|
354
|
+
parse,
|
|
355
|
+
reportOf
|
|
323
356
|
};
|
|
324
357
|
//# sourceMappingURL=cli.js.map
|
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 --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' }, 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 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 ...(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.
|
|
@@ -571,8 +571,9 @@ interface RenderOptions {
|
|
|
571
571
|
voiceStrict?: boolean;
|
|
572
572
|
/** Also write the narration track here (WAV). */
|
|
573
573
|
voiceOut?: string;
|
|
574
|
-
/** When a step can't find its element: propose a fix (<out>.repair.json, for
|
|
575
|
-
* the guide again with it. The render still fails: a person accepts the fix.
|
|
574
|
+
/** When a step can't find its element, or a wait's text never shows: propose a fix (<out>.repair.json, for
|
|
575
|
+
* `apply`), verified by playing the guide again with it. The render still fails: a person accepts the fix.
|
|
576
|
+
* With `ai`, unsure cases are asked; a wait with no clear text is offered as a guess (`by: 'guess'`). */
|
|
576
577
|
repair?: boolean;
|
|
577
578
|
/** With repair and ai: send a screenshot of the stalled page too. */
|
|
578
579
|
repairVision?: boolean;
|
|
@@ -764,23 +765,26 @@ declare function cueAt(cues: readonly Cue[], t: number, fadeMs?: number): {
|
|
|
764
765
|
/**
|
|
765
766
|
* --repair: when a step can't find its element, look at the page as it is now, choose what the step means
|
|
766
767
|
* (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.
|
|
768
|
+
* again with the fix (in memory) to see that it gets past the step. A wait whose text never showed is fixed
|
|
769
|
+
* the same way: the texts on the page (and those that showed while it waited) are scored, and the chosen one
|
|
770
|
+
* becomes what the step waits for. Up to `maxStalls` stalls in one run.
|
|
768
771
|
*
|
|
769
772
|
* Nothing is written to the trace: the fixes are suggestions in a file that `apply` takes once a person agrees.
|
|
770
773
|
*/
|
|
771
774
|
|
|
772
775
|
type Trace = Parameters<typeof applyRaw>[0];
|
|
776
|
+
/** `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
777
|
interface RepairSuggestion extends Suggestion {
|
|
774
778
|
id: number;
|
|
775
|
-
by: 'score' | 'ai';
|
|
779
|
+
by: 'score' | 'ai' | 'guess';
|
|
776
780
|
score?: number;
|
|
777
781
|
}
|
|
778
782
|
interface Unresolved {
|
|
779
783
|
index: number;
|
|
780
784
|
reason: string;
|
|
781
785
|
why: string;
|
|
782
|
-
/** The best candidates by score, for a person to pick from. */
|
|
783
|
-
top: Array<Omit<Candidate, 'key'> & {
|
|
786
|
+
/** The best candidates by score, for a person to pick from: elements, or (for a wait) texts. */
|
|
787
|
+
top: Array<(Omit<Candidate, 'key'> | Omit<TextCandidate, 'id'>) & {
|
|
784
788
|
score: number;
|
|
785
789
|
}>;
|
|
786
790
|
}
|
|
@@ -797,6 +801,13 @@ interface Found {
|
|
|
797
801
|
score?: number;
|
|
798
802
|
why?: string;
|
|
799
803
|
};
|
|
804
|
+
/** For a wait: the text to wait for now. */
|
|
805
|
+
text?: {
|
|
806
|
+
value: string;
|
|
807
|
+
by: 'score' | 'ai' | 'guess';
|
|
808
|
+
score?: number;
|
|
809
|
+
why?: string;
|
|
810
|
+
};
|
|
800
811
|
why?: string;
|
|
801
812
|
top: Unresolved['top'];
|
|
802
813
|
}
|
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "trace-avatar-render",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
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.
|
|
63
|
+
"trace-avatar": "^0.1.9"
|
|
64
64
|
},
|
|
65
65
|
"devDependencies": {
|
|
66
66
|
"@types/node": "^22.0.0",
|