@atomic-chat/core 0.5.1 → 0.13.2

package/dist/diffusion/video-eta.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The live progress of a clip: how long the whole job has left (encoding, the remaining steps and
+ * the VAE decode), a fraction that never goes back, the decode's tiles, and whether the steps or the
+ * tiles slowed down sharply (the sign of swapping or a stalled engine). One per job, fed the
+ * tracker's snapshot and the decode's tile pass at every emit; it keeps the step and tile marks, the
+ * phase it saw last, the fraction it reported and the sticky slowdown flag. Pure over the times it
+ * is given. The rules are the `video-generation/progress` spec of the `add-video-generation-estimate`
+ * change, ADR 2026-09-29-report-the-tiled-decode-and-tile-it-by-memory for the decode, and ADR
+ * 2026-09-30-keep-the-video-eta-past-its-forecast for a job that outruns its forecast.
+ */
+import type { ImageJobProgress, VideoJobProgress } from '../contracts/index.js';
+import type { DecodeTiles } from './tracker.js';
+import type { VideoForecast } from './video-estimate.js';
+/**
+ * The step-time ratio (measured against forecast) the decode forecast is scaled by stays in here. Steps
+ * faster than forecast never shrink the decode: its own error runs the other way (ADR
+ * 2026-09-30-keep-the-video-eta-past-its-forecast), and a history multiplier raised by slow decodes
+ * would otherwise be divided back out of it.
+ */
+export declare const STEP_RATIO_RANGE: readonly [number, number];
+/** Past its forecast, a stretch of the job is forecast at this many times as long, again and again. */
+export declare const OVERRUN_GROWTH = 2;
+/** Slowdown: the running step (or decode tile) took this many medians of the completed ones… */
+export declare const SLOWDOWN_MEDIANS = 3;
+/** …and at least this long, so a slow first step (graph build, weights paged in) never trips it. */
+export declare const SLOWDOWN_FLOOR_MS = 20000;
+/** Slowdown: a step past this many times the forecast's top of the range. */
+export declare const SLOWDOWN_FORECAST_FACTOR = 3;
+/** The fraction stays below 1 until the job is over. */
+export declare const MAX_FRACTION = 0.99;
+export interface VideoEtaOptions {
+    /** When the runner started the job; `elapsedMs` counts from here. */
+    startedAt: number;
+    /** The parts of the job's estimate; absent when there is none. */
+    forecast?: VideoForecast;
+    /** Whether the job's estimate has a range of seconds (it has none when memory is exceeded). */
+    estimated: boolean;
+}
+/**
+ * Seconds left of a stretch forecast at `forecast` seconds that has run for `spent`: the forecast's
+ * rest, and once that is spent, the rest of the forecast grown by `OVERRUN_GROWTH` until it is ahead
+ * again, so the countdown starts over instead of going blank. Null without a forecast.
+ */
+export declare function leftOf(forecast: number, spent: number): number | null;
+export declare class VideoEta {
+    private readonly options;
+    private marks;
+    /** The decode's tile pass: its start (`step: 0`) and each tile finished (`step` = tiles done). */
+    private tileMarks;
+    private tileTotal;
+    private phase;
+    private phaseAt;
+    private reported;
+    private slow;
+    constructor(options: VideoEtaOptions);
+    /** The wire progress for `snapshot` at `now` (ms), with the decode's tile pass when there is one. */
+    progress(snapshot: ImageJobProgress, now: number, decodeTiles?: DecodeTiles): VideoJobProgress;
+    /** Record a phase change and a new step; a step count that went back is a new attempt. */
+    private observe;
+    /**
+     * Record the decode's tile pass: its start the first time it is seen, then every tile finished. A
+     * new pass (sd.cpp retrying a failed decode, or a later attempt's decode) starts over, and no pass
+     * (another phase, a decode in one graph) forgets the last one.
+     */
+    private observeTiles;
+    /**
+     * The rest of a tiled decode at the measured pace per tile: the running tile's remainder and the
+     * tiles after it; a tile running past the pace stretches the pace, as a step does. Zero once every
+     * tile is done (the clip is being assembled and encoded); undefined before a tile finished.
+     */
+    private tileEta;
+    /** Seconds per step since the first mark; undefined before two marks. */
+    private measuredStep;
+    /** The measured step against the forecast one, for scaling the decode. */
+    private ratio;
+    private eta;
+    /**
+     * The rest of the running step, the steps after it at the measured pace, and the decode forecast
+     * scaled by how the steps compare with theirs. A step running past the pace stretches the pace
+     * instead of freezing the countdown.
+     */
+    private samplingEta;
+    private fraction;
+    private slowNow;
+    /**
+     * A tile of the decode running past three medians of the finished ones (at least two) and past the
+     * floor. Tiles have no forecast of their own to hold them against.
+     */
+    private tileStalled;
+}

package/dist/diffusion/video-eta.js

@@ -0,0 +1,248 @@
+/**
+ * The live progress of a clip: how long the whole job has left (encoding, the remaining steps and
+ * the VAE decode), a fraction that never goes back, the decode's tiles, and whether the steps or the
+ * tiles slowed down sharply (the sign of swapping or a stalled engine). One per job, fed the
+ * tracker's snapshot and the decode's tile pass at every emit; it keeps the step and tile marks, the
+ * phase it saw last, the fraction it reported and the sticky slowdown flag. Pure over the times it
+ * is given. The rules are the `video-generation/progress` spec of the `add-video-generation-estimate`
+ * change, ADR 2026-09-29-report-the-tiled-decode-and-tile-it-by-memory for the decode, and ADR
+ * 2026-09-30-keep-the-video-eta-past-its-forecast for a job that outruns its forecast.
+ */
+/**
+ * The step-time ratio (measured against forecast) the decode forecast is scaled by stays in here. Steps
+ * faster than forecast never shrink the decode: its own error runs the other way (ADR
+ * 2026-09-30-keep-the-video-eta-past-its-forecast), and a history multiplier raised by slow decodes
+ * would otherwise be divided back out of it.
+ */
+export const STEP_RATIO_RANGE = [1, 20];
+/** Past its forecast, a stretch of the job is forecast at this many times as long, again and again. */
+export const OVERRUN_GROWTH = 2;
+/** Slowdown: the running step (or decode tile) took this many medians of the completed ones… */
+export const SLOWDOWN_MEDIANS = 3;
+/** …and at least this long, so a slow first step (graph build, weights paged in) never trips it. */
+export const SLOWDOWN_FLOOR_MS = 20_000;
+/** Slowdown: a step past this many times the forecast's top of the range. */
+export const SLOWDOWN_FORECAST_FACTOR = 3;
+/** The fraction stays below 1 until the job is over. */
+export const MAX_FRACTION = 0.99;
+const clamp = (value, [min, max]) => Math.min(Math.max(value, min), max);
+function median(values) {
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 1
+        ? sorted[mid]
+        : (sorted[mid - 1] + sorted[mid]) / 2;
+}
+/**
+ * Seconds left of a stretch forecast at `forecast` seconds that has run for `spent`: the forecast's
+ * rest, and once that is spent, the rest of the forecast grown by `OVERRUN_GROWTH` until it is ahead
+ * again, so the countdown starts over instead of going blank. Null without a forecast.
+ */
+export function leftOf(forecast, spent) {
+    if (!(forecast > 0))
+        return null;
+    let horizon = forecast;
+    while (horizon <= spent)
+        horizon *= OVERRUN_GROWTH;
+    return horizon - spent;
+}
+/** The duration (ms) of every unit completed after the first mark, one entry per unit. */
+function completedAfter(marks) {
+    const out = [];
+    for (let i = 1; i < marks.length; i++) {
+        const prev = marks[i - 1];
+        const mark = marks[i];
+        const units = mark.step - prev.step;
+        for (let u = 0; u < units; u++)
+            out.push((mark.at - prev.at) / units);
+    }
+    return out;
+}
+export class VideoEta {
+    options;
+    marks = [];
+    /** The decode's tile pass: its start (`step: 0`) and each tile finished (`step` = tiles done). */
+    tileMarks = [];
+    tileTotal;
+    phase;
+    phaseAt = 0;
+    reported = 0;
+    slow = false;
+    constructor(options) {
+        this.options = options;
+    }
+    /** The wire progress for `snapshot` at `now` (ms), with the decode's tile pass when there is one. */
+    progress(snapshot, now, decodeTiles) {
+        this.observe(snapshot, now);
+        this.observeTiles(decodeTiles, now);
+        const elapsedMs = Math.max(now - this.options.startedAt, 0);
+        const etaSeconds = this.eta(snapshot, now, elapsedMs);
+        this.slow ||= this.slowNow(snapshot, now);
+        return {
+            phase: snapshot.phase,
+            step: snapshot.step,
+            totalSteps: snapshot.totalSteps,
+            fraction: this.fraction(snapshot, elapsedMs, etaSeconds),
+            etaSeconds,
+            elapsedMs,
+            ...(decodeTiles ? { decodeTiles: { done: decodeTiles.done, total: decodeTiles.total } } : {}),
+            slowdown: this.slow,
+        };
+    }
+    /** Record a phase change and a new step; a step count that went back is a new attempt. */
+    observe(snapshot, now) {
+        if (snapshot.phase !== this.phase) {
+            this.phase = snapshot.phase;
+            this.phaseAt = now;
+        }
+        const last = this.marks[this.marks.length - 1];
+        if (last !== undefined && snapshot.step < last.step)
+            this.marks = [];
+        const latest = this.marks[this.marks.length - 1];
+        if (snapshot.step > 0 && (latest === undefined || snapshot.step > latest.step))
+            this.marks.push({ step: snapshot.step, at: now });
+    }
+    /**
+     * Record the decode's tile pass: its start the first time it is seen, then every tile finished. A
+     * new pass (sd.cpp retrying a failed decode, or a later attempt's decode) starts over, and no pass
+     * (another phase, a decode in one graph) forgets the last one.
+     */
+    observeTiles(tiles, now) {
+        if (!tiles) {
+            this.tileMarks = [];
+            this.tileTotal = undefined;
+            return;
+        }
+        const last = this.tileMarks[this.tileMarks.length - 1];
+        if (last === undefined || tiles.total !== this.tileTotal || tiles.done < last.step) {
+            this.tileTotal = tiles.total;
+            this.tileMarks = [{ step: 0, at: now }];
+        }
+        const latest = this.tileMarks[this.tileMarks.length - 1];
+        if (tiles.done > latest.step)
+            this.tileMarks.push({ step: tiles.done, at: now });
+    }
+    /**
+     * The rest of a tiled decode at the measured pace per tile: the running tile's remainder and the
+     * tiles after it; a tile running past the pace stretches the pace, as a step does. Zero once every
+     * tile is done (the clip is being assembled and encoded); undefined before a tile finished.
+     */
+    tileEta(now) {
+        const first = this.tileMarks[0];
+        const last = this.tileMarks[this.tileMarks.length - 1];
+        const total = this.tileTotal;
+        if (first === undefined || last === undefined || total === undefined)
+            return undefined;
+        if (last.step <= first.step || last.at <= first.at)
+            return undefined;
+        if (last.step >= total)
+            return 0;
+        const pace = (last.at - first.at) / 1000 / (last.step - first.step);
+        const inTile = (now - last.at) / 1000;
+        const after = Math.max(total - last.step - 1, 0);
+        if (inTile <= pace)
+            return pace - inTile + after * pace;
+        return after * ((now - first.at) / 1000 / (last.step - first.step + 1));
+    }
+    /** Seconds per step since the first mark; undefined before two marks. */
+    measuredStep() {
+        const first = this.marks[0];
+        const last = this.marks[this.marks.length - 1];
+        if (first === undefined || last === undefined || last.step <= first.step)
+            return undefined;
+        return (last.at - first.at) / 1000 / (last.step - first.step);
+    }
+    /** The measured step against the forecast one, for scaling the decode. */
+    ratio(measured) {
+        const forecast = this.options.forecast;
+        if (measured === undefined || forecast === undefined || forecast.stepSeconds <= 0)
+            return 1;
+        return clamp(measured / forecast.stepSeconds, STEP_RATIO_RANGE);
+    }
+    eta(snapshot, now, elapsedMs) {
+        const { forecast, estimated } = this.options;
+        const measured = this.measuredStep();
+        switch (snapshot.phase) {
+            case 'saving':
+                return null;
+            case 'decoding':
+            case 'postprocessing': {
+                const tiles = this.tileEta(now);
+                if (tiles !== undefined)
+                    return tiles > 0 ? tiles : null;
+                if (!forecast)
+                    return null;
+                return leftOf(forecast.decodeSeconds * this.ratio(measured), (now - this.phaseAt) / 1000);
+            }
+            case 'sampling':
+                if (measured !== undefined)
+                    return this.samplingEta(snapshot, now, measured);
+                break;
+            case 'queued':
+            case 'encoding':
+                break;
+        }
+        // Before the first measured step: the estimate's middle, less the time already spent.
+        if (!forecast || !estimated)
+            return null;
+        return leftOf(forecast.totalSeconds, elapsedMs / 1000);
+    }
+    /**
+     * The rest of the running step, the steps after it at the measured pace, and the decode forecast
+     * scaled by how the steps compare with theirs. A step running past the pace stretches the pace
+     * instead of freezing the countdown.
+     */
+    samplingEta(snapshot, now, measured) {
+        const first = this.marks[0];
+        const last = this.marks[this.marks.length - 1];
+        const inStep = (now - last.at) / 1000;
+        const after = Math.max(snapshot.totalSteps - last.step - 1, 0);
+        let sampling;
+        if (inStep <= measured)
+            sampling = measured - inStep + after * measured;
+        else
+            sampling = after * ((now - first.at) / 1000 / (last.step - first.step + 1));
+        const decode = this.options.forecast ? this.options.forecast.decodeSeconds * this.ratio(measured) : 0;
+        return sampling + decode;
+    }
+    fraction(snapshot, elapsedMs, etaSeconds) {
+        const elapsed = elapsedMs / 1000;
+        const byTime = etaSeconds !== null && elapsed + etaSeconds > 0 ? elapsed / (elapsed + etaSeconds) : undefined;
+        const next = Math.min(Math.max(this.reported, byTime ?? snapshot.fraction), MAX_FRACTION);
+        this.reported = next;
+        return next;
+    }
+    slowNow(snapshot, now) {
+        if (this.tileStalled(snapshot, now))
+            return true;
+        const completed = completedAfter(this.marks);
+        const last = this.marks[this.marks.length - 1];
+        const running = snapshot.phase === 'sampling' && last !== undefined && last.step < snapshot.totalSteps
+            ? now - last.at
+            : 0;
+        if (completed.length >= 2 &&
+            running > SLOWDOWN_MEDIANS * median(completed) &&
+            running > SLOWDOWN_FLOOR_MS)
+            return true;
+        const forecast = this.options.forecast;
+        if (!forecast)
+            return false;
+        const slowest = Math.max(running, ...completed);
+        return slowest > SLOWDOWN_FORECAST_FACTOR * forecast.stepSecondsHigh * 1000;
+    }
+    /**
+     * A tile of the decode running past three medians of the finished ones (at least two) and past the
+     * floor. Tiles have no forecast of their own to hold them against.
+     */
+    tileStalled(snapshot, now) {
+        const last = this.tileMarks[this.tileMarks.length - 1];
+        if (snapshot.phase !== 'decoding' || last === undefined || this.tileTotal === undefined)
+            return false;
+        if (last.step >= this.tileTotal)
+            return false;
+        const completed = completedAfter(this.tileMarks);
+        const running = now - last.at;
+        return (completed.length >= 2 && running > SLOWDOWN_MEDIANS * median(completed) && running > SLOWDOWN_FLOOR_MS);
+    }
+}
+//# sourceMappingURL=video-eta.js.map

package/dist/diffusion/video-eta.js.map

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

package/dist/diffusion/video-history.d.ts

@@ -0,0 +1,45 @@
+/**
+ * This machine's own clips as a correction to the heuristic: how many times longer (or shorter) the
+ * last few clips of the same family, backend and offload took than the heuristic said. The
+ * multiplier scales the model, not seconds, so it carries over to another size or length.
+ * Selection and the multiplier are pure; `VideoHistory` caches the gallery's recipes between
+ * estimates.
+ */
+import type { VideoRecipe } from '../contracts/index.js';
+import type { VideoEstimateInput, VideoHistoryMultiplier } from './video-estimate.js';
+/** At most this many clips, the newest first. */
+export declare const HISTORY_LIMIT = 5;
+/** The multiplier never moves the heuristic further than this either way. */
+export declare const HISTORY_MULTIPLIER_RANGE: readonly [number, number];
+/**
+ * The request's inputs with a recipe's own size, length, steps and guidance, and the decode tiling
+ * this machine plans for that clip (the recipe does not record one; a clip made before the plan
+ * existed ran on the pixel-frame threshold instead).
+ */
+export declare function recipeInput(input: VideoEstimateInput, recipe: VideoRecipe): VideoEstimateInput;
+/**
+ * The clips that speak for this request: the same family, backend and offload, not finished on the
+ * CPU fallback, and not a run whose own parameters exceed memory (a clip that swapped says nothing
+ * about the machine's speed). Newest first, at most `HISTORY_LIMIT`.
+ */
+export declare function historyRecipes(recipes: readonly VideoRecipe[], input: VideoEstimateInput): VideoRecipe[];
+/**
+ * The median of `actual / heuristic` over the clips that speak for this request, for the sampling
+ * and for the decode apart, each within `HISTORY_MULTIPLIER_RANGE`; undefined when there are none.
+ * A clip that recorded its `decodeMs` calibrates the two separately: a single-graph decode on Metal
+ * can be most of a short clip's time and miss the table by far more than the steps do, so one ratio
+ * for both under-forecasts a few-step clip. An older clip has only its total, which stands for both.
+ */
+export declare function historyMultiplier(recipes: readonly VideoRecipe[], input: VideoEstimateInput): VideoHistoryMultiplier | undefined;
+/**
+ * The recipes of the video gallery, read once per folder and kept until a clip is added or removed.
+ * A failed read is not cached: the next estimate tries again.
+ */
+export declare class VideoHistory {
+    private readonly read;
+    private cached;
+    constructor(read: (dir: string) => Promise<VideoRecipe[]>);
+    recipes(dir: string): Promise<VideoRecipe[]>;
+    /** A clip was saved or deleted: the next estimate reads the gallery again. */
+    invalidate(): void;
+}

package/dist/diffusion/video-history.js

@@ -0,0 +1,121 @@
+/**
+ * This machine's own clips as a correction to the heuristic: how many times longer (or shorter) the
+ * last few clips of the same family, backend and offload took than the heuristic said. The
+ * multiplier scales the model, not seconds, so it carries over to another size or length.
+ * Selection and the multiplier are pure; `VideoHistory` caches the gallery's recipes between
+ * estimates.
+ */
+import { estimateVideoMemory, heuristicParts, planDecodeTiling } from './video-estimate.js';
+/** At most this many clips, the newest first. */
+export const HISTORY_LIMIT = 5;
+/** The multiplier never moves the heuristic further than this either way. */
+export const HISTORY_MULTIPLIER_RANGE = [0.1, 10];
+/**
+ * The request's inputs with a recipe's own size, length, steps and guidance, and the decode tiling
+ * this machine plans for that clip (the recipe does not record one; a clip made before the plan
+ * existed ran on the pixel-frame threshold instead).
+ */
+export function recipeInput(input, recipe) {
+    const { decodeTiling: _request, ...rest } = input;
+    const base = {
+        ...rest,
+        width: recipe.width,
+        height: recipe.height,
+        frames: recipe.frames,
+        steps: recipe.steps,
+        cfgScale: recipe.cfgScale,
+    };
+    if (!input.decodeTiling)
+        return base;
+    const decodeTiling = planDecodeTiling(base);
+    return decodeTiling ? { ...base, decodeTiling } : base;
+}
+/**
+ * The clips that speak for this request: the same family, backend and offload, not finished on the
+ * CPU fallback, and not a run whose own parameters exceed memory (a clip that swapped says nothing
+ * about the machine's speed). Newest first, at most `HISTORY_LIMIT`.
+ */
+export function historyRecipes(recipes, input) {
+    return recipes
+        .filter((recipe) => recipe.model.family === input.family &&
+        recipe.engine.backend === input.backend &&
+        recipe.engine.offload === input.offload &&
+        !recipe.engine.cpuFallback &&
+        recipe.durationMs > 0 &&
+        estimateVideoMemory(recipeInput(input, recipe))?.verdict !== 'exceeds')
+        .sort((a, b) => b.createdAtMs - a.createdAtMs)
+        .slice(0, HISTORY_LIMIT);
+}
+function median(values) {
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 1
+        ? sorted[mid]
+        : (sorted[mid - 1] + sorted[mid]) / 2;
+}
+/**
+ * The median of `actual / heuristic` over the clips that speak for this request, for the sampling
+ * and for the decode apart, each within `HISTORY_MULTIPLIER_RANGE`; undefined when there are none.
+ * A clip that recorded its `decodeMs` calibrates the two separately: a single-graph decode on Metal
+ * can be most of a short clip's time and miss the table by far more than the steps do, so one ratio
+ * for both under-forecasts a few-step clip. An older clip has only its total, which stands for both.
+ */
+export function historyMultiplier(recipes, input) {
+    const sampling = [];
+    const decode = [];
+    for (const recipe of historyRecipes(recipes, input)) {
+        const clip = recipeInput(input, recipe);
+        const parts = heuristicParts(clip);
+        const samplingSeconds = parts.encodeSeconds + Math.max(clip.steps, 1) * parts.stepSeconds;
+        const seconds = recipe.durationMs / 1000;
+        if (recipe.decodeMs !== undefined && samplingSeconds > 0 && parts.decodeSeconds > 0) {
+            const decodeSeconds = recipe.decodeMs / 1000;
+            sampling.push((seconds - decodeSeconds) / samplingSeconds);
+            decode.push(decodeSeconds / parts.decodeSeconds);
+            continue;
+        }
+        const predicted = samplingSeconds + parts.decodeSeconds;
+        if (predicted > 0) {
+            sampling.push(seconds / predicted);
+            decode.push(seconds / predicted);
+        }
+    }
+    const [min, max] = HISTORY_MULTIPLIER_RANGE;
+    const calibrated = (ratios) => {
+        const finite = ratios.filter(Number.isFinite);
+        return finite.length === 0 ? undefined : Math.min(Math.max(median(finite), min), max);
+    };
+    const samplingK = calibrated(sampling);
+    const decodeK = calibrated(decode);
+    return samplingK === undefined || decodeK === undefined
+        ? undefined
+        : { sampling: samplingK, decode: decodeK };
+}
+/**
+ * The recipes of the video gallery, read once per folder and kept until a clip is added or removed.
+ * A failed read is not cached: the next estimate tries again.
+ */
+export class VideoHistory {
+    read;
+    cached;
+    constructor(read) {
+        this.read = read;
+    }
+    recipes(dir) {
+        if (this.cached?.dir === dir)
+            return this.cached.recipes;
+        const recipes = this.read(dir);
+        const entry = { dir, recipes };
+        this.cached = entry;
+        recipes.catch(() => {
+            if (this.cached === entry)
+                this.cached = undefined;
+        });
+        return recipes;
+    }
+    /** A clip was saved or deleted: the next estimate reads the gallery again. */
+    invalidate() {
+        this.cached = undefined;
+    }
+}
+//# sourceMappingURL=video-history.js.map

package/dist/diffusion/video-history.js.map

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

package/dist/diffusion/video-job.d.ts

@@ -3,10 +3,13 @@
  * saves. One clip per job, VP8 in WebM, the recipe beside it as a sidecar; the shared runner in
  * `jobs.ts` drives it through `VIDEO_JOB_KIND`.
  */
-import type { GalleryVideoItem, ImageJobProgress, VideoGenerateRequest, VideoJob, VideoJobProgress } from '../contracts/index.js';
-import type { JobKind, SaveContext } from './job-kind.js';
+import type { GalleryVideoItem, VideoGenerateRequest, VideoJob, VideoJobProgress } from '../contracts/index.js';
+import type { JobKind, JobPlan, ProgressModel, SaveContext } from './job-kind.js';
 import type { JobDeps } from './jobs.js';
-import type { ResolvedInputs, ServerCapabilities } from './types.js';
+import type { JobRecord } from './state.js';
+import type { ResolvedInputs, ServerCapabilities, ServerSpec } from './types.js';
+/** A clip's progress goes out at least once a second while it generates, whether or not a step landed. */
+export declare const VIDEO_PROGRESS_HEARTBEAT_MS = 1000;
 /** What a completed `vid_gen` job carries once decoded. */
 export interface DecodedVideo {
     bytes: Buffer;
@@ -26,8 +29,13 @@ export declare function saveVideoOutput(deps: JobDeps, ctx: SaveContext<VideoGen
     items: GalleryVideoItem[];
     bytes: Buffer[];
 }>;
-/** The wire progress of a clip: the tracker's snapshot without the batch fields. */
-export declare function videoProgress(snapshot: ImageJobProgress): VideoJobProgress;
+/** The estimate and its forecast for a job about to start; a failure only costs the job its estimate. */
+export declare function prepareVideoJob(deps: Pick<JobDeps, 'planVideo' | 'log'>, request: VideoGenerateRequest, spec: ServerSpec): Promise<JobPlan | undefined>;
+/**
+ * The wire progress of a clip: the tracker's snapshot without the batch fields, with the ETA,
+ * fraction and slowdown of `VideoEta` over the whole job and the decode's tiles.
+ */
+export declare function videoProgressModel(record: JobRecord, startedAt: number): ProgressModel<VideoJobProgress>;
 /** A build without libwebm cannot write the one container the app plays; say so before submitting. */
 export declare function checkWebmSupport(capabilities: ServerCapabilities | undefined): void;
 export declare const VIDEO_JOB_KIND: JobKind<VideoGenerateRequest, VideoJob, GalleryVideoItem, VideoJobProgress, DecodedVideo>;