rivet-design 0.13.4 → 0.14.0

package/dist/agent-variants/directionAuthoring.js

@@ -0,0 +1,348 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authorDirections = exports.fallbackDirections = exports.fallbackRunLabel = void 0;
+const child_process_1 = require("child_process");
+const logger_1 = require("../utils/logger");
+const log = (0, logger_1.createLogger)('DirectionAuthoring');
+/**
+ * Server-side direction authoring for fresh (zero-to-one) variant runs.
+ *
+ * Historically the coordinating host agent authored the direction briefs
+ * in-conversation before calling `variants start` — 60–160s of wall-clock
+ * spent before any worker could spawn, on prose the workers treat only as
+ * steering (they view the reference media natively). This module moves that
+ * authorship onto the server: one fast vision tool-use call produces the
+ * labels, bodies, and steering notes, and a deterministic archetype fallback
+ * guarantees the run starts even when the gateway is unreachable.
+ *
+ * Quality note: reference FIDELITY comes from the implementation worker's
+ * model tier (see `workerDefaults.RIVET_WORKER_REFERENCE_CREATE_DEFAULTS`),
+ * not from brief prose — the briefs only need distinct, plausible direction
+ * concepts, which a fast model produces reliably.
+ */
+const DIRECTION_AUTHOR_MODEL = 'claude-haiku-4-5-20251001';
+const DIRECTION_AUTHOR_MAX_TOKENS = 1200;
+const DIRECTION_AUTHOR_TIMEOUT_MS = 25_000;
+const LABEL_MAX_LENGTH = 48;
+const BODY_MAX_LENGTH = 200;
+const NOTES_MAX_LENGTH = 1200;
+const RUN_LABEL_MAX_LENGTH = 40;
+/** Archetype directions used when the gateway cannot author. Ordered so the
+ *  first N slots always cover the faithful → reinterpreted spectrum. */
+const FALLBACK_ARCHETYPES = [
+    { label: 'Faithful', body: 'Faithful recreation of the reference design language' },
+    { label: 'Expressive', body: 'Amplify the boldest visual ideas in the request' },
+    { label: 'Structural Remix', body: 'Same design system, different layout architecture' },
+    { label: 'Editorial', body: 'Typography-led, editorial interpretation' },
+    { label: 'Minimal', body: 'Pared-back, spacious, minimal interpretation' },
+];
+const FALLBACK_NOTES = 'Derive every design decision directly from the visual references and the ' +
+    'request: match palette, typography, spacing, shapes, and energy. Ship every ' +
+    'section and interaction the request names — never a stripped-down subset. ' +
+    'When the request names motion, design and IMPLEMENT a concrete motion spec ' +
+    '(trigger, timing, easing, choreography) grounded in what the references show.';
+const clip = (value, max) => value.length <= max ? value : `${value.slice(0, max - 1).trimEnd()}…`;
+/** Deterministic 1–3 word run label from the request text. */
+const fallbackRunLabel = (prompt) => {
+    const words = prompt
+        .split(/\s+/)
+        .map((word) => word.replace(/[^\p{L}\p{N}-]/gu, ''))
+        .filter((word) => word.length > 2);
+    const label = words.slice(0, 3).join(' ');
+    return clip(label || 'Design directions', RUN_LABEL_MAX_LENGTH);
+};
+exports.fallbackRunLabel = fallbackRunLabel;
+const fallbackDirections = (prompt, count) => ({
+    briefs: Array.from({ length: count }, (_, index) => {
+        const archetype = FALLBACK_ARCHETYPES[index % FALLBACK_ARCHETYPES.length];
+        const suffix = index >= FALLBACK_ARCHETYPES.length
+            ? ` ${Math.floor(index / FALLBACK_ARCHETYPES.length) + 1}`
+            : '';
+        return {
+            label: `${archetype.label}${suffix}`,
+            body: archetype.body,
+            notes: FALLBACK_NOTES,
+        };
+    }),
+    runLabel: (0, exports.fallbackRunLabel)(prompt),
+});
+exports.fallbackDirections = fallbackDirections;
+const AUTHOR_DIRECTIONS_TOOL = {
+    name: 'author_directions',
+    description: 'Record the design directions for this variants run. Every direction ' +
+        'must name a materially different layout or interaction architecture — ' +
+        'never a recolor or a near-duplicate of another direction.',
+    strict: true,
+    input_schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['runLabel', 'directions'],
+        properties: {
+            runLabel: {
+                type: 'string',
+                description: '1–3 word summary of the whole batch',
+            },
+            directions: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    required: ['label', 'body', 'notes'],
+                    properties: {
+                        label: {
+                            type: 'string',
+                            description: 'Distinct 1–4 word direction title',
+                        },
+                        body: {
+                            type: 'string',
+                            description: 'At most 12 words naming the layout/interaction direction',
+                        },
+                        notes: {
+                            type: 'string',
+                            description: 'Steering notes for the implementer. START with "Sections: ' +
+                                '<5-7 concrete sections this direction ships>." Then concrete ' +
+                                'observations from the references (palette hexes, type, ' +
+                                'spacing, shapes, energy). When the request involves motion ' +
+                                'or interaction, the notes MUST include a concrete motion ' +
+                                'spec — trigger (scroll, hover, click), timing, easing, ' +
+                                'choreography — that the page implements visibly. For ' +
+                                'navigation/header motion, scroll-linked state change ' +
+                                '(condense, invert, hide-reveal) is the default expectation ' +
+                                'unless the request names another trigger. The implementer ' +
+                                'views the references natively — steer interpretation, do ' +
+                                'not replace looking.',
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+const buildAuthorPrompt = (input) => {
+    const lines = [
+        `Design request:`,
+        input.prompt.trim(),
+        '',
+        `Author exactly ${input.count} genuinely distinct, comparison-ready design directions for this request.`,
+    ];
+    if (input.images?.length) {
+        lines.push('', 'The attached images are the primary design signal (uploaded references, rendered page screenshots, or video keyframes in order). Ground every direction in what they actually show.');
+    }
+    if (input.referenceNotes?.length) {
+        lines.push('', 'Reference evidence:', ...input.referenceNotes.map((note) => `- ${note}`));
+    }
+    lines.push('', 'Each direction must preserve the full user deliverable (for a landing page: complete page scope, not just a hero). Call the author_directions tool once.');
+    return lines.join('\n');
+};
+const sanitizeDirections = (raw, input) => {
+    if (!Array.isArray(raw.directions))
+        return undefined;
+    const seenLabels = new Set();
+    const briefs = [];
+    for (const entry of raw.directions) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const candidate = entry;
+        const label = typeof candidate.label === 'string' ? candidate.label.trim() : '';
+        const body = typeof candidate.body === 'string' ? candidate.body.trim() : '';
+        const notes = typeof candidate.notes === 'string' ? candidate.notes.trim() : '';
+        if (!label || !body)
+            continue;
+        const key = label.toLowerCase();
+        if (seenLabels.has(key))
+            continue;
+        seenLabels.add(key);
+        briefs.push({
+            label: clip(label, LABEL_MAX_LENGTH),
+            body: clip(body, BODY_MAX_LENGTH),
+            ...(notes ? { notes: clip(notes, NOTES_MAX_LENGTH) } : {}),
+        });
+        if (briefs.length === input.count)
+            break;
+    }
+    if (briefs.length === 0)
+        return undefined;
+    // Pad any shortfall deterministically so the run always gets `count`.
+    const fallback = (0, exports.fallbackDirections)(input.prompt, input.count);
+    for (const spare of fallback.briefs) {
+        if (briefs.length === input.count)
+            break;
+        if (seenLabels.has(spare.label.toLowerCase()))
+            continue;
+        briefs.push(spare);
+    }
+    const runLabel = typeof raw.runLabel === 'string' && raw.runLabel.trim()
+        ? clip(raw.runLabel.trim(), RUN_LABEL_MAX_LENGTH)
+        : fallback.runLabel;
+    return { briefs: briefs.slice(0, input.count), runLabel };
+};
+// Sonnet over haiku: measured 2026-07-16, the haiku pool showed 4x latency
+// variance under concurrent load (12s → 45s+ timeouts) while sonnet held
+// steady; the call is ~250 output tokens so per-token speed barely matters.
+const CLAUDE_AUTHOR_MODEL = 'claude-sonnet-5';
+const CLAUDE_AUTHOR_TIMEOUT_MS = 25_000;
+/** Extract the first balanced JSON object from free text. */
+const extractJsonObject = (text) => {
+    const start = text.indexOf('{');
+    if (start === -1)
+        return undefined;
+    for (let end = text.length; end > start; end -= 1) {
+        const candidate = text.slice(start, end);
+        if (!candidate.trimEnd().endsWith('}'))
+            continue;
+        try {
+            return JSON.parse(candidate);
+        }
+        catch {
+            // keep shrinking
+        }
+    }
+    return undefined;
+};
+/**
+ * Author directions with the local `claude` runtime — the same binary (and
+ * the same user subscription) the worker executor runs, so this path works
+ * wherever the executor works, including machines whose gateway spend limit
+ * is exhausted. Reference imagery rides INLINE as image content blocks via
+ * `--input-format stream-json`, so the whole call is a single model turn —
+ * no temp files, no Read-tool round trip, no turn-count variance.
+ */
+const authorViaClaudeRuntime = async (input, options) => {
+    const command = options?.command ?? process.env.RIVET_EXECUTOR_COMMAND ?? 'claude';
+    const prompt = [
+        input.images?.length
+            ? 'The attached images are the primary design signal (uploaded references, rendered page screenshots, or video keyframes in order).\n'
+            : '',
+        buildAuthorPrompt(input),
+        '',
+        'Respond with ONLY a compact single-line JSON object of the shape',
+        '{"runLabel": "1-3 word batch summary", "directions": [{"label": "1-4 word title", "body": "<=12 word direction", "notes": "<=350 chars. START with: Sections: <5-7 concrete sections this direction ships>. Then concrete steering (palette hexes, type, spacing, energy). When the request names motion or interaction, notes MUST carry a terse motion spec — trigger (scroll/hover/click), timing, easing — the page implements visibly; for nav/header motion default to scroll-linked state change (condense/invert/hide-reveal)."}]}',
+        `with exactly ${input.count} directions. Speed matters: no deliberation, no tool use, no prose, no markdown fences.`,
+    ]
+        .filter(Boolean)
+        .join('\n');
+    const userMessage = JSON.stringify({
+        type: 'user',
+        message: {
+            role: 'user',
+            content: [
+                ...(input.images ?? []).map((image) => ({
+                    type: 'image',
+                    source: {
+                        type: 'base64',
+                        media_type: image.mediaType,
+                        data: image.data,
+                    },
+                })),
+                { type: 'text', text: prompt },
+            ],
+        },
+    });
+    const startedAt = Date.now();
+    const stdout = await new Promise((resolve, reject) => {
+        const child = (0, child_process_1.execFile)(command, [
+            '--print',
+            '--input-format',
+            'stream-json',
+            '--output-format',
+            'stream-json',
+            '--verbose',
+            '--model',
+            CLAUDE_AUTHOR_MODEL,
+            '--effort',
+            'low',
+            '--dangerously-skip-permissions',
+            '--exclude-dynamic-system-prompt-sections',
+        ], {
+            timeout: options?.timeoutMs ?? CLAUDE_AUTHOR_TIMEOUT_MS,
+            maxBuffer: 16 * 1024 * 1024,
+        }, (error, out, err) => error
+            ? reject(new Error(`${error.message}${err ? ` — stderr: ${String(err).slice(-400)}` : ''}`))
+            : resolve(out));
+        child.stdin?.write(`${userMessage}\n`);
+        child.stdin?.end();
+    });
+    let resultText = '';
+    let childDurationMs;
+    for (const line of stdout.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('{'))
+            continue;
+        try {
+            const event = JSON.parse(trimmed);
+            if (event.type === 'result') {
+                resultText = typeof event.result === 'string' ? event.result : '';
+                childDurationMs = event.duration_ms;
+            }
+        }
+        catch {
+            // Non-JSON noise on stdout — skip.
+        }
+    }
+    log.info(`claude runtime authored directions in ${Date.now() - startedAt}ms (child duration_ms=${String(childDurationMs)})`);
+    const parsed = extractJsonObject(resultText || stdout);
+    if (parsed && typeof parsed === 'object') {
+        return parsed;
+    }
+    return undefined;
+};
+/**
+ * Author the direction briefs for a fresh run. Ladder: one fast gateway
+ * vision call → the local `claude` runtime (subscription-billed, available
+ * wherever the executor is) → deterministic archetypes. Never throws — any
+ * failure degrades a rung so intake keeps its latency contract.
+ */
+const authorDirections = async (gateway, input, options) => {
+    const startedAt = Date.now();
+    try {
+        const raw = await gateway.sendToolUse({
+            model: DIRECTION_AUTHOR_MODEL,
+            maxTokens: DIRECTION_AUTHOR_MAX_TOKENS,
+            temperature: 1,
+            system: 'You are the direction planner for Rivet, which builds N parallel ' +
+                'design variants of a web page. You author short, materially ' +
+                'different direction briefs; separate implementers build each one ' +
+                'with the same reference media you see.',
+            prompt: buildAuthorPrompt(input),
+            tool: AUTHOR_DIRECTIONS_TOOL,
+            ...(input.images?.length ? { images: input.images } : {}),
+            timeoutMs: options?.timeoutMs ?? DIRECTION_AUTHOR_TIMEOUT_MS,
+        });
+        const sanitized = sanitizeDirections(raw, input);
+        if (sanitized) {
+            return {
+                ...sanitized,
+                source: 'gateway',
+                durationMs: Date.now() - startedAt,
+            };
+        }
+        log.warn('gateway direction author returned no usable directions');
+    }
+    catch (error) {
+        log.warn('gateway direction authoring failed — trying claude runtime', error);
+    }
+    try {
+        const raw = await authorViaClaudeRuntime(input, {
+            ...(options?.claudeCommand ? { command: options.claudeCommand } : {}),
+        });
+        const sanitized = raw ? sanitizeDirections(raw, input) : undefined;
+        if (sanitized) {
+            return {
+                ...sanitized,
+                source: 'claude_runtime',
+                durationMs: Date.now() - startedAt,
+            };
+        }
+        log.warn('claude runtime direction author returned no usable directions');
+    }
+    catch (error) {
+        log.warn('claude runtime direction authoring failed — using archetype fallback', error);
+    }
+    return {
+        ...(0, exports.fallbackDirections)(input.prompt, input.count),
+        source: 'fallback',
+        durationMs: Date.now() - startedAt,
+    };
+};
+exports.authorDirections = authorDirections;
+//# sourceMappingURL=directionAuthoring.js.map

package/dist/agent-variants/directionAuthoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directionAuthoring.js","sourceRoot":"","sources":["../../src/agent-variants/directionAuthoring.ts"],"names":[],"mappings":"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"}

package/dist/agent-variants/runLabel.d.ts

@@ -1,8 +1,7 @@
 /**
- * Derive a short "run label" — a 1–2 word, plain-English description of the
- * INTENT behind the prompt that kicked off a variant run. Every variant in a
- * run shares this label; it's what the variant table shows on each row so the
- * user can tell which prompt a direction came from.
+ * Derive a short run label from the prompt for human-direct starts. Every
+ * variant in a run shares this label so the user can tell which prompt a
+ * direction came from.
  *
  * Deterministic (no LLM): strip a leading command phrase ("make it", "add a",
  * …), truncate at the first conjunction so only the primary intent survives
@@ -14,5 +13,7 @@
  *   "add a sticky header"               → "Sticky Header"
  *   "dark mode"                         → "Dark Mode"
  */
+export declare const RUN_LABEL_MAX_LENGTH = 24;
+export declare const RUN_LABEL_MAX_WORDS = 3;
 export declare function deriveRunLabel(prompt: string): string;
 //# sourceMappingURL=runLabel.d.ts.map

package/dist/agent-variants/runLabel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runLabel.d.ts","sourceRoot":"","sources":["../../src/agent-variants/runLabel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAyGH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BrD"}
+{"version":3,"file":"runLabel.d.ts","sourceRoot":"","sources":["../../src/agent-variants/runLabel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmGH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAerC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BrD"}

package/dist/agent-variants/runLabel.js

@@ -1,9 +1,8 @@
 "use strict";
 /**
- * Derive a short "run label" — a 1–2 word, plain-English description of the
- * INTENT behind the prompt that kicked off a variant run. Every variant in a
- * run shares this label; it's what the variant table shows on each row so the
- * user can tell which prompt a direction came from.
+ * Derive a short run label from the prompt for human-direct starts. Every
+ * variant in a run shares this label so the user can tell which prompt a
+ * direction came from.
  *
  * Deterministic (no LLM): strip a leading command phrase ("make it", "add a",
  * …), truncate at the first conjunction so only the primary intent survives
@@ -16,6 +15,7 @@
  *   "dark mode"                         → "Dark Mode"
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUN_LABEL_MAX_WORDS = exports.RUN_LABEL_MAX_LENGTH = void 0;
 exports.deriveRunLabel = deriveRunLabel;
 // Leading imperative phrasing that carries no intent — stripped from the front.
 // Longest-first so "make it" wins over "make".
@@ -111,10 +111,18 @@ const FILLER = new Set([
     'overall',
     'all',
 ]);
-const titleCase = (words) => words
-    .map((w) => (w ? w[0].toUpperCase() + w.slice(1) : w))
-    .join(' ')
-    .slice(0, 24);
+exports.RUN_LABEL_MAX_LENGTH = 24;
+exports.RUN_LABEL_MAX_WORDS = 3;
+const titleCase = (words) => {
+    const titledWords = words.map((word) => word ? word[0].toUpperCase() + word.slice(1) : word);
+    const fittingWords = titledWords.reduce((selected, word) => {
+        const candidate = [...selected, word].join(' ');
+        return candidate.length <= exports.RUN_LABEL_MAX_LENGTH
+            ? [...selected, word]
+            : selected;
+    }, []);
+    return fittingWords.join(' ') || titledWords[0] || '';
+};
 function deriveRunLabel(prompt) {
     const raw = (prompt ?? '').trim();
     if (!raw)

package/dist/agent-variants/runLabel.js.map

@@ -1 +1 @@
-{"version":3,"file":"runLabel.js","sourceRoot":"","sources":["../../src/agent-variants/runLabel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runLabel.js","sourceRoot":"","sources":["../../src/agent-variants/runLabel.ts"],"names":[],"mappings":"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"}

package/dist/agent-variants/videoKeyframes.d.ts

@@ -0,0 +1,19 @@
+export type KeyframeResult = {
+    ok: true;
+    framePaths: string[];
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Sample a local reference video into evenly spaced PNG keyframes so vision
+ * models (direction authoring) and implementation workers can observe the
+ * motion without any host-agent ffmpeg work. Requires `ffmpeg`/`ffprobe` on
+ * PATH; any failure is reported, never thrown — reference prep must degrade,
+ * not block intake.
+ */
+export declare const extractVideoKeyframes: (videoPath: string, options?: {
+    frameCount?: number;
+    outDir?: string;
+}) => Promise<KeyframeResult>;
+//# sourceMappingURL=videoKeyframes.d.ts.map

package/dist/agent-variants/videoKeyframes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoKeyframes.d.ts","sourceRoot":"","sources":["../../src/agent-variants/videoKeyframes.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,EACjB,UAAU;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KACjD,OAAO,CAAC,cAAc,CAoExB,CAAC"}

package/dist/agent-variants/videoKeyframes.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractVideoKeyframes = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const util_1 = require("util");
+const logger_1 = require("../utils/logger");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+const log = (0, logger_1.createLogger)('VideoKeyframes');
+const FFMPEG_TIMEOUT_MS = 30_000;
+const DEFAULT_FRAME_COUNT = 5;
+/**
+ * Sample a local reference video into evenly spaced PNG keyframes so vision
+ * models (direction authoring) and implementation workers can observe the
+ * motion without any host-agent ffmpeg work. Requires `ffmpeg`/`ffprobe` on
+ * PATH; any failure is reported, never thrown — reference prep must degrade,
+ * not block intake.
+ */
+const extractVideoKeyframes = async (videoPath, options) => {
+    const frameCount = options?.frameCount ?? DEFAULT_FRAME_COUNT;
+    let duration;
+    try {
+        const probe = await execFileAsync('ffprobe', [
+            '-v',
+            'error',
+            '-show_entries',
+            'format=duration',
+            '-of',
+            'default=noprint_wrappers=1:nokey=1',
+            videoPath,
+        ], { timeout: FFMPEG_TIMEOUT_MS });
+        duration = Number.parseFloat(probe.stdout.trim());
+        if (!Number.isFinite(duration) || duration <= 0) {
+            return { ok: false, reason: `ffprobe reported no duration for ${videoPath}` };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, reason: `ffprobe unavailable or failed: ${message}` };
+    }
+    const outDir = options?.outDir ?? fs.mkdtempSync(path.join(os.tmpdir(), 'rivet-keyframes-'));
+    const stamps = Array.from({ length: frameCount }, (_, index) => (duration * (index + 0.5)) / frameCount);
+    const framePaths = [];
+    try {
+        await Promise.all(stamps.map(async (stamp, index) => {
+            const framePath = path.join(outDir, `frame-${index + 1}.png`);
+            await execFileAsync('ffmpeg', [
+                '-ss',
+                stamp.toFixed(2),
+                '-i',
+                videoPath,
+                '-frames:v',
+                '1',
+                '-q:v',
+                '3',
+                '-y',
+                framePath,
+            ], { timeout: FFMPEG_TIMEOUT_MS });
+            framePaths[index] = framePath;
+        }));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log.warn(`keyframe extraction failed for ${videoPath}`, error);
+        return { ok: false, reason: `ffmpeg failed: ${message}` };
+    }
+    const existing = framePaths.filter((framePath) => framePath && fs.existsSync(framePath));
+    if (existing.length === 0) {
+        return { ok: false, reason: 'ffmpeg produced no frames' };
+    }
+    return { ok: true, framePaths: existing };
+};
+exports.extractVideoKeyframes = extractVideoKeyframes;
+//# sourceMappingURL=videoKeyframes.js.map

package/dist/agent-variants/videoKeyframes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoKeyframes.js","sourceRoot":"","sources":["../../src/agent-variants/videoKeyframes.ts"],"names":[],"mappings":"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"}

package/dist/agent-variants/workItemBriefing.d.ts

@@ -22,5 +22,7 @@ export declare const workItemBriefingPath: (sessionId: string, workId: string) =
 export declare const workItemCompleteCommand: (workId: string) => string;
 /** The ~40-token prompt the coordinator passes to each worker verbatim. */
 export declare const workItemWorkerPrompt: (sessionId: string, item: HostVariantImplementationWorkItemSnapshot) => string;
-export declare const renderWorkItemBriefing: (item: HostVariantImplementationWorkItemSnapshot) => string;
+export declare const renderWorkItemBriefing: (item: HostVariantImplementationWorkItemSnapshot, options?: {
+    completion?: "self" | "executor";
+}) => string;
 //# sourceMappingURL=workItemBriefing.d.ts.map

package/dist/agent-variants/workItemBriefing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workItemBriefing.d.ts","sourceRoot":"","sources":["../../src/agent-variants/workItemBriefing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,aAAa,CAAC;AAK7E;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,EACjB,QAAQ,MAAM,KACb,MACwE,CAAC;AAE5E,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,KAAG,MACD,CAAC;AAEzD,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,EACjB,MAAM,yCAAyC,KAC9C,MAG4E,CAAC;AAuBhF,eAAO,MAAM,sBAAsB,GACjC,MAAM,yCAAyC,KAC9C,MAkDF,CAAC"}
+{"version":3,"file":"workItemBriefing.d.ts","sourceRoot":"","sources":["../../src/agent-variants/workItemBriefing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,aAAa,CAAC;AAK7E;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,EACjB,QAAQ,MAAM,KACb,MACwE,CAAC;AAE5E,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,KAAG,MACD,CAAC;AAEzD,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,EACjB,MAAM,yCAAyC,KAC9C,MAG4E,CAAC;AAuBhF,eAAO,MAAM,sBAAsB,GACjC,MAAM,yCAAyC,EAC/C,UAAU;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,KAC7C,MAiIF,CAAC"}