reelforge 1.18.2

package/dist/commands/script.js

@@ -0,0 +1,128 @@
+import fs from "node:fs/promises";
+import { info, isJson, print } from "../utils/output.js";
+const CHARS_PER_SEC_ZH = 5;
+const WORDS_PER_SEC_EN = 2.7;
+const TTS_PRICES_USD_PER_CHAR = {
+    "vox/index-tts-2": 1.575 / 1e6,
+    "edge": 0,
+};
+function countCjk(s) {
+    const re = /[一-鿿㐀-䶿豈-﫿　-〿＀-￯]/gu;
+    return (s.match(re) || []).length;
+}
+function countAscii(s) {
+    const re = /[A-Za-z0-9]/g;
+    return (s.match(re) || []).length;
+}
+function countWords(s) {
+    return s.split(/\s+/).filter(Boolean).length;
+}
+function detectLang(text) {
+    const cjk = countCjk(text);
+    const ascii = countAscii(text);
+    return cjk * 5 >= ascii ? "zh" : "en";
+}
+function estimate(text, langOverride) {
+    const lang = langOverride ?? detectLang(text);
+    const cjk = countCjk(text);
+    const ascii = countAscii(text);
+    const words = countWords(text);
+    const chars = cjk + ascii;
+    const seconds = lang === "zh"
+        ? chars / CHARS_PER_SEC_ZH
+        : words > 0 ? words / WORDS_PER_SEC_EN : chars / 12;
+    const billedChars = text.length;
+    const tts = {};
+    for (const [model, pricePerChar] of Object.entries(TTS_PRICES_USD_PER_CHAR)) {
+        tts[model] = Number((billedChars * pricePerChar).toFixed(6));
+    }
+    const totalSec = Math.round(seconds);
+    const min = Math.floor(totalSec / 60);
+    const sec = totalSec % 60;
+    const hhmmss = `${min}:${String(sec).padStart(2, "0")}`;
+    const notes = lang === "zh"
+        ? `中文口播按 ${CHARS_PER_SEC_ZH} 字 / 秒估算 (普通播报速度)`
+        : `English narration estimated at ${WORDS_PER_SEC_EN} words / sec`;
+    return {
+        lang,
+        chars,
+        ascii_chars: ascii,
+        cjk_chars: cjk,
+        words,
+        seconds: Number(seconds.toFixed(2)),
+        hhmmss,
+        tts_cost_usd_by_model: tts,
+        notes,
+    };
+}
+async function loadText(input) {
+    if (input.startsWith("@")) {
+        const file = input.slice(1);
+        return (await fs.readFile(file, "utf-8")).trim();
+    }
+    return input;
+}
+export function registerScript(program) {
+    const scriptCmd = program
+        .command("script")
+        .description("脚本相关原子能力 (零 LLM / 零网络的本地工具)。")
+        .helpOption("-h, --help", "show help");
+    scriptCmd
+        .command("estimate <text-or-@file>")
+        .description("估算脚本字数 / 口播时长 / TTS 成本。零网络, 零调用 — 在送 TTS 或 scene-plan 之前快速判断 \"这段念出来多久 / 多少钱\"。")
+        .helpOption("-h, --help", "show help")
+        .option("--lang <zh|en>", "强制语言 (默认按 CJK 比例自动判断)")
+        .addHelpText("after", [
+        "",
+        "Examples:",
+        "  # 字符串直传",
+        "  rf script estimate '为什么我们还没有找到外星文明？我们在听, 也在被听。'",
+        "",
+        "  # 从文件读 (适合长脚本)",
+        "  rf script estimate @./draft.txt",
+        "",
+        "  # JSON 模式 (agent 解析)",
+        "  rf script estimate @./draft.txt --json",
+        "",
+        "  # 强制按英文估时",
+        "  rf script estimate @./english.txt --lang en",
+        "",
+        "速率假设:",
+        "  中文: 5 字 / 秒 (普通抖音口播速度)",
+        "  英文: 2.7 words / sec (~ 160 wpm)",
+        "",
+        "TTS 成本估算 (按云端 list price):",
+        "  云端 TTS:  $1.575 / 1M chars",
+        "  本地 TTS:  $0",
+        "",
+        "成本: $0 (纯本地计算, 无服务端调用)",
+    ].join("\n"))
+        .action(async (input, opts) => {
+        const text = await loadText(input);
+        if (!text)
+            throw new Error("script is empty");
+        let langOverride;
+        if (opts.lang !== undefined) {
+            if (opts.lang !== "zh" && opts.lang !== "en") {
+                throw new Error(`--lang must be zh or en (got: ${opts.lang})`);
+            }
+            langOverride = opts.lang;
+        }
+        const r = estimate(text, langOverride);
+        if (isJson()) {
+            print(r);
+            return;
+        }
+        info(`lang:          ${r.lang}`);
+        info(`chars:         ${r.chars}  (CJK ${r.cjk_chars} + ASCII letters/digits ${r.ascii_chars})`);
+        if (r.lang === "en")
+            info(`words:         ${r.words}`);
+        info(`narration:     ${r.seconds.toFixed(1)}s  (${r.hhmmss})`);
+        info("TTS cost estimate:");
+        for (const [model, cost] of Object.entries(r.tts_cost_usd_by_model)) {
+            const costStr = cost === 0 ? "$0 (free)" : `$${cost.toFixed(6)}`;
+            info(`  ${model.padEnd(20)} ${costStr}`);
+        }
+        info(`note:          ${r.notes}`);
+    });
+}

package/dist/commands/styles.js

@@ -0,0 +1,113 @@
+import { get } from "../client.js";
+import { isJson, print } from "../utils/output.js";
+import kleur from "kleur";
+function displayWidth(s) {
+    let w = 0;
+    for (const c of s)
+        w += c.charCodeAt(0) > 0x7f ? 2 : 1;
+    return w;
+}
+function padDisplay(s, width) {
+    const pad = Math.max(0, width - displayWidth(s));
+    return s + " ".repeat(pad);
+}
+function renderTable(presets) {
+    if (!presets.length) {
+        process.stdout.write("(empty)\n");
+        return;
+    }
+    const idW = Math.max(2, ...presets.map((p) => p.id.length));
+    const labelW = Math.max(5, ...presets.map((p) => displayWidth(p.label)));
+    const sceneW = Math.max(5, ...presets.map((p) => displayWidth(p.scene)));
+    const hasPreview = presets.some((p) => p.preview_url);
+    const header = hasPreview
+        ? `${padDisplay("id", idW)}  ${padDisplay("label", labelW)}  ${padDisplay("scene", sceneW)}  preview`
+        : `${padDisplay("id", idW)}  ${padDisplay("label", labelW)}  ${padDisplay("scene", sceneW)}  prefix`;
+    process.stdout.write(kleur.bold(header) + "\n");
+    process.stdout.write(`${"-".repeat(idW)}  ${"-".repeat(labelW)}  ${"-".repeat(sceneW)}  ${"-".repeat(7)}\n`);
+    for (const p of presets) {
+        const last = hasPreview ? p.preview_url || "" : p.prefix;
+        process.stdout.write(`${padDisplay(p.id, idW)}  ${padDisplay(p.label, labelW)}  ${padDisplay(p.scene, sceneW)}  ${last}\n`);
+    }
+}
+function renderDetail(p, preview) {
+    process.stdout.write(`\n● ${p.id}  ${p.label}\n`);
+    if (p.preview_url) {
+        process.stdout.write(`  预览 (直接浏览器打开): ${p.preview_url}\n`);
+    }
+    if (preview) {
+        process.stdout.write(`  样图基线 → subject="${preview.subject}"\n`);
+        if (preview.model || preview.size) {
+            process.stdout.write(`               model=${preview.model || "?"} · size=${preview.size || "?"}\n`);
+        }
+    }
+    process.stdout.write(`  scene: ${p.scene}\n`);
+    process.stdout.write(`  prefix: ${p.prefix}\n`);
+}
+export function registerStyles(program) {
+    const group = program
+        .command("styles")
+        .description("图像风格预设清单 (供 --style / body.style 使用)")
+        .helpOption("-h, --help", "show help");
+    group
+        .command("list")
+        .description("List all image style presets from the server (with preview URLs).")
+        .helpOption("-h, --help", "show help")
+        .option("--id <styleId>", "只看某个风格的详细信息 (id, label, scene, prefix, preview_url)")
+        .option("--json", "JSON 输出 (默认人读表格); 适合 agent / 脚本消费")
+        .addHelpText("after", [
+        "",
+        "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
+        "AGENT 帮用户选风格的标准流程 (LLM 必读)",
+        "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
+        "  当用户没明确指定 --style,或说『我不知道选哪个』时,不要替用户拍板,",
+        "  也不要按 prefix 文字给用户脑补描述 — 直接走这条路径:",
+        "",
+        "  Step 1. 拉 catalog (含 preview_url):",
+        "    rf styles list --json",
+        "",
+        "  Step 2. 把 17 张 preview_url 列表丢给用户 (markdown 图片格式效果最好,",
+        "         用户在你的聊天界面里能直接看到缩略图):",
+        "    ![cinematic](https://rf-cdn.oss-cn-hangzhou.aliyuncs.com/image-style-samples/cinematic.png)",
+        "    ![watercolor](https://rf-cdn.oss-cn-hangzhou.aliyuncs.com/image-style-samples/watercolor.png)",
+        "    ... (其余 15 个同样格式)",
+        "",
+        "  Step 3. 用户照图选,把 id 喂给 `rf create --style <id>`.",
+        "",
+        "  17 张 preview 都是同一个 subject (一座黄昏悬崖上的灯塔) 在不同风格下的",
+        "  渲染样本,只有风格变量在动 — 用户看一眼立刻知道每个风格实际长啥样,",
+        "  不需要现场跑图.",
+        "",
+        "Use the id with `rf create --style <id>` or write it into a recipe:",
+        "  rf create --script @x.txt --style flat",
+        '  { "voice_id": "熊小二", "style": "flat" }   # recipe',
+        "",
+        "Examples:",
+        "  rf styles list                       # 全部 17 个风格 + preview URL 表格",
+        "  rf styles list --id watercolor       # 单看 watercolor 的详情 (含 prefix)",
+        "  rf styles list --json                # JSON 输出 (agent 必跑这条)",
+    ].join("\n"))
+        .action(async (opts) => {
+        const data = await get("/api/v1/styles");
+        const presets = Array.isArray(data.styles) ? data.styles : [];
+        const filtered = opts.id ? presets.filter((s) => s.id === opts.id) : presets;
+        if (opts.id && filtered.length === 0) {
+            throw new Error(`unknown style id "${opts.id}". Known: ${presets.map((s) => s.id).join(", ")}`);
+        }
+        if (opts.json || isJson()) {
+            const payload = opts.id ? filtered[0] : { preview: data.preview, styles: filtered };
+            print(payload);
+            return;
+        }
+        if (opts.id) {
+            renderDetail(filtered[0], data.preview);
+        }
+        else {
+            if (data.preview?.subject) {
+                process.stdout.write(`\n样图基线 (preview_url 都是按这个 subject 渲的):\n  ${data.preview.subject}\n\n`);
+            }
+            renderTable(filtered);
+            process.stdout.write(`\n(用 \`rf styles list --id <id>\` 看单个风格的详情,或 --json 拿结构化输出)\n\n`);
+        }
+    });
+}

package/dist/commands/subtitles.js

@@ -0,0 +1,246 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getApiKey, getServer, post } from "../client.js";
+import { info, print, success } from "../utils/output.js";
+export function registerSubtitles(program) {
+    const sub = program
+        .command("subtitles")
+        .alias("subtitle")
+        .description("字幕原子能力: split (确定性 token-atomic 分段, 单条/批量) + translate (双语第二行) + ledger (历史切分质量数据)")
+        .helpOption("-h, --help", "show help");
+    sub
+        .command("split")
+        .description("把文本切成字幕分段 (分段). 单条 (--text) 或批量分镜列表 (--scenes). 与线上视频 pipeline 同一个切分器。")
+        .helpOption("-h, --help", "show help")
+        .option("-t, --text <text>", "单条: 要切分的文本. 用 @file 从磁盘读。")
+        .option("-S, --scenes <input>", "批量: 分镜列表. JSON 字符串数组 / [{text}] / storyboard.json ({scenes:[{text}]}). 用 @file。")
+        .option("--bilingual", "双语模式: min/max 缺省时用 6/14 (而非单语 10/28), 与线上双语视频一致")
+        .option("--min <N>", "最小分段字数 (缺省: 单语 10 / 双语 6)", (v) => parseInt(v, 10))
+        .option("--max <N>", "最大分段字数 (缺省: 单语 28 / 双语 14 ≈ 2/1 视觉行)", (v) => parseInt(v, 10))
+        .addHelpText("after", [
+        "",
+        "Segment vs line:",
+        "  一个 segment 是一条上屏字幕单元 (一张 PNG / 一个时间窗), 不是视觉行。",
+        "  视觉换行是模板的事 (默认 clamp 2 行)。",
+        "",
+        "Examples:",
+        "  # 单条",
+        "  rf subtitles split -t '雨水缓缓滑落在玻璃窗上，像是无声的泪珠。'",
+        "",
+        "  # 批量: 一个分镜列表 → 二级 list (每个分镜一组字幕分段)",
+        "  rf subtitles split --scenes '[\"第一镜旁白\",\"第二镜旁白\"]' --json",
+        "",
+        "  # 直接喂真实 storyboard.json (取 scenes[].text), 双语参数验证线上切分",
+        "  rf subtitles split --scenes @storyboard.json --bilingual --json",
+    ].join("\n"))
+        .action(async (opts) => {
+        const body = {};
+        if (opts.min !== undefined)
+            body.min_chars = opts.min;
+        if (opts.max !== undefined)
+            body.max_chars = opts.max;
+        if (opts.bilingual)
+            body.bilingual = true;
+        if (opts.scenes) {
+            body.scenes = await parseScenesInput(await readInput(opts.scenes));
+            const r = await post("/api/v1/subtitles/split", body);
+            print({
+                scene_count: r.scene_count,
+                scenes: r.scenes.map((s, i) => ({
+                    scene: i,
+                    count: s.count,
+                    segments: s.segments.map((g) => g.text),
+                })),
+            });
+            return;
+        }
+        if (!opts.text)
+            throw new Error("提供 --text (单条) 或 --scenes (批量) 其一");
+        let text = opts.text;
+        if (text.startsWith("@"))
+            text = (await fs.readFile(text.slice(1), "utf-8")).trim();
+        body.text = text;
+        const r = await post("/api/v1/subtitles/split", body);
+        print({ count: r.count, segments: r.segments });
+    });
+    sub
+        .command("translate")
+        .description("字幕分段翻译 (双语字幕第二行). 接受一个分段数组 + 目标语言, 返回一一对应的译文。")
+        .helpOption("-h, --help", "show help")
+        .option("-s, --segments <input>", "字幕分段数组. 支持: @file (JSON 数组 或每行一段) / JSON 字符串 / 多段用 \\n 分隔")
+        .option("--from-split <input>", "直接接 rf subtitles split 的 JSON 输出 (file 或 stdin) — 自动提取 segments 字段")
+        .option("-l, --lang <code>", "目标语言, 如 en / ja / English / 日本語 (必填)")
+        .option("--master <text>", "完整旁白脚本 (上下文, 帮助术语一致). @file 读文件。可选, 缺省用 segments 拼接")
+        .option("--llm-model <id>", "覆盖默认 LLM 模型")
+        .addHelpText("after", [
+        "",
+        "Input 三种形式:",
+        "  --segments @file.json        分段 JSON 数组",
+        "  --segments @lines.txt        每行一段",
+        "  --from-split @split.json     rf subtitles split 的输出直接喂进来",
+        "",
+        "Examples:",
+        "  # 直接给分段数组",
+        "  rf subtitles translate -s '[\"第一段\",\"第二段\"]' -l en",
+        "",
+        "  # 链式: split → translate (agent 工作流)",
+        "  rf subtitles split -t @./script.txt --json > /tmp/segs.json",
+        "  rf subtitles translate --from-split @/tmp/segs.json -l en",
+        "",
+        "  # 加完整 master 让术语一致",
+        "  rf subtitles translate --from-split @/tmp/segs.json -l ja --master @/tmp/script.txt",
+        "",
+        "成本估算: 单次 LLM 调用 (~$0.001-0.003 取决于段数 + 模型)",
+    ].join("\n"))
+        .action(async (opts) => {
+        if (!opts.lang)
+            throw new Error("--lang is required (e.g. en, ja, English)");
+        let segments;
+        if (opts.fromSplit) {
+            const raw = await readInput(opts.fromSplit);
+            const parsed = JSON.parse(raw);
+            const arr = Array.isArray(parsed?.segments) ? parsed.segments : parsed;
+            if (!Array.isArray(arr)) {
+                throw new Error("--from-split: expected an object with `segments` array or a bare array");
+            }
+            segments = arr.map((s) => typeof s === "string" ? s : (s?.text ?? "")).filter((s) => s.length > 0);
+        }
+        else if (opts.segments) {
+            const raw = await readInput(opts.segments);
+            segments = parseSegmentsInput(raw);
+        }
+        else {
+            throw new Error("--segments or --from-split is required");
+        }
+        if (segments.length === 0)
+            throw new Error("no segments to translate");
+        let master;
+        if (opts.master) {
+            master = await readInput(opts.master);
+        }
+        const body = {
+            segments,
+            target_lang: opts.lang,
+        };
+        if (master)
+            body.master_script = master;
+        if (opts.llmModel)
+            body.llm_model = opts.llmModel;
+        const r = await post("/api/v1/subtitles/translate", body);
+        print({
+            count: r.translations.length,
+            translations: r.translations.map((t, i) => ({
+                id: i + 1,
+                src: segments[i],
+                translated: t,
+            })),
+            cost_usd: r.cost_usd,
+            duration_ms: r.duration_ms,
+        });
+    });
+    const ledger = sub
+        .command("ledger")
+        .description("Production subtitle ledger (每段字幕一行 JSONL,跨任务汇总)")
+        .helpOption("-h, --help", "show help");
+    ledger
+        .command("dump")
+        .description("从服务器下载字幕 ledger 到本地 JSONL 用于离线分析(每段一行,含切分质量评分)")
+        .helpOption("-h, --help", "show help")
+        .option("--since <iso>", "只拉 ts >= 这个时间的记录(ISO 8601,如 2026-06-01 或 2026-06-01T00:00:00Z)")
+        .option("--until <iso>", "只拉 ts <= 这个时间的记录")
+        .option("--task-id <id>", "只拉某一个 task 的记录")
+        .option("--limit <n>", "最多拉多少条(默认 10000, 上限 100000)", (v) => parseInt(v, 10))
+        .option("-o, --output <file>", "输出文件路径(默认 ./subtitle-ledger.jsonl)", "./subtitle-ledger.jsonl")
+        .addHelpText("after", [
+        "",
+        "字段:",
+        "  ts / task_id / scene_idx / seg_idx       数据点定位",
+        "  input_text                                该 scene 切分前完整文本",
+        "  display_text / text_secondary             实际上字幕的文字 + 译文",
+        "  length / start_sec / end_sec              出现时长",
+        "  cut_reason                                llm | tail | fallback-*",
+        "  split_score (0-100)                       该 scene LLM 切分评分",
+        "  split_attempts / split_source             重试次数 / llm or fallback",
+        "  splitter_version / llm_model              生成这条记录的版本组合",
+        "  subtitle_translate_to                     en / null / 等",
+        "",
+        "Examples:",
+        "  # 全量(上限 10000)",
+        "  rf subtitles ledger dump -o ./ledger.jsonl",
+        "",
+        "  # 只看最近一周",
+        "  rf subtitles ledger dump --since 2026-06-01 -o ./recent.jsonl",
+        "",
+        "  # 单个 task 复盘",
+        "  rf subtitles ledger dump --task-id 0eebc40f -o ./one-task.jsonl",
+        "",
+        "拉完后用 jq / awk / 自己写脚本分析。常见查询:",
+        "  jq 'select(.split_score < 80)' ledger.jsonl     # 低质量 case",
+        "  jq 'select(.length > 25)' ledger.jsonl          # 偏长 segment",
+        "  jq -s 'group_by(.task_id) | length' ledger.jsonl  # task 数",
+    ].join("\n"))
+        .action(async (opts) => {
+        const server = getServer().replace(/\/+$/, "");
+        const apiKey = getApiKey();
+        const qs = new URLSearchParams({ format: "jsonl" });
+        if (opts.since)
+            qs.set("since", opts.since);
+        if (opts.until)
+            qs.set("until", opts.until);
+        if (opts.taskId)
+            qs.set("task_id", opts.taskId);
+        if (opts.limit)
+            qs.set("limit", String(opts.limit));
+        const headers = {};
+        if (apiKey)
+            headers["authorization"] = `Bearer ${apiKey}`;
+        info(`Fetching ledger from ${server}/api/v1/subtitles/ledger?${qs.toString()}`);
+        const resp = await fetch(`${server}/api/v1/subtitles/ledger?${qs.toString()}`, { headers });
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => "");
+            throw new Error(`Ledger fetch failed: HTTP ${resp.status}\n${text.slice(0, 500)}`);
+        }
+        const text = await resp.text();
+        const count = parseInt(resp.headers.get("x-ledger-count") || "0", 10);
+        const totalBytes = parseInt(resp.headers.get("x-ledger-bytes") || "0", 10);
+        const outAbs = path.resolve(opts.output);
+        await fs.mkdir(path.dirname(outAbs), { recursive: true });
+        await fs.writeFile(outAbs, text);
+        success(`Saved ${count} entries → ${outAbs}  ` +
+            `(${(text.length / 1024).toFixed(1)} KB; server ledger size: ${(totalBytes / 1024).toFixed(1)} KB)`);
+    });
+}
+async function readInput(input) {
+    if (input.startsWith("@")) {
+        return (await fs.readFile(input.slice(1), "utf-8")).trim();
+    }
+    return input;
+}
+async function parseScenesInput(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error("--scenes 必须是 JSON (数组 或 含 scenes 数组的对象, 如 storyboard.json)");
+    }
+    const arr = Array.isArray(parsed)
+        ? parsed
+        : Array.isArray(parsed?.scenes)
+            ? parsed.scenes
+            : null;
+    if (!arr)
+        throw new Error("--scenes: 期望 JSON 数组, 或含 `scenes` 数组的对象 (storyboard.json)");
+    return arr.map((s) => ({ text: typeof s === "string" ? s : (s?.text ?? "") }));
+}
+function parseSegmentsInput(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.startsWith("[")) {
+        const parsed = JSON.parse(trimmed);
+        if (!Array.isArray(parsed))
+            throw new Error("--segments JSON must be an array");
+        return parsed.filter((s) => typeof s === "string" && s.length > 0);
+    }
+    const unescaped = trimmed.replace(/\\n/g, "\n");
+    return unescaped.split("\n").map((s) => s.trim()).filter(Boolean);
+}

package/dist/commands/tasks.js

@@ -0,0 +1,59 @@
+import { del, get } from "../client.js";
+import { waitForTask } from "../utils/task-waiter.js";
+import { print, table } from "../utils/output.js";
+export function registerTasks(program) {
+    const tasks = program
+        .command("tasks")
+        .alias("task")
+        .description("任务队列管理: 查看 / 等待 / 取消")
+        .helpOption("-h, --help", "show help");
+    tasks
+        .command("list")
+        .description("List recent tasks")
+        .helpOption("-h, --help", "show help")
+        .option("--status <s>", "filter by status: pending | running | completed | failed | cancelled")
+        .option("--limit <n>", "max number of tasks", parseInt)
+        .action(async (opts) => {
+        const qs = new URLSearchParams();
+        if (opts.status)
+            qs.set("status", opts.status);
+        if (opts.limit)
+            qs.set("limit", String(opts.limit));
+        const r = await get(`/api/v1/tasks${qs.toString() ? `?${qs}` : ""}`);
+        table(r.tasks.map((t) => ({
+            id: t.id.slice(0, 8),
+            kind: t.kind,
+            status: t.status,
+            progress: `${(t.progress * 100).toFixed(0)}%`,
+            created_at: t.created_at,
+        })));
+    });
+    tasks
+        .command("get <id>")
+        .description("Show full task detail (status, progress, events, result)")
+        .helpOption("-h, --help", "show help")
+        .action(async (id) => {
+        const r = await get(`/api/v1/tasks/${id}`);
+        print(r);
+    });
+    tasks
+        .command("wait <id>")
+        .description("Poll a task until it reaches a terminal state (live progress on stderr)")
+        .helpOption("-h, --help", "show help")
+        .option("--poll-ms <ms>", "poll interval", parseInt, 1500)
+        .option("--timeout-ms <ms>", "max wait time", parseInt)
+        .action(async (id, opts) => {
+        const t = await waitForTask(id, { pollMs: opts.pollMs, timeoutMs: opts.timeoutMs });
+        print({ id: t.id, status: t.status, error: t.error, result: t.result });
+        if (t.status !== "completed")
+            process.exit(1);
+    });
+    tasks
+        .command("cancel <id>")
+        .description("Cancel a running task")
+        .helpOption("-h, --help", "show help")
+        .action(async (id) => {
+        const r = await del(`/api/v1/tasks/${id}`);
+        print(r);
+    });
+}