@atomic-chat/core 0.5.1 → 0.13.6

package/dist/diffusion/video-job.js

@@ -8,7 +8,10 @@ import { buildVidGenRequest } from './args.js';
 import { diffusionError, internalError } from './errors.js';
 import { redactSource, resolveSource } from './image-job.js';
 import { validateVideoRequest } from './validate.js';
+import { VideoEta } from './video-eta.js';
 import { isWebm } from './video-gallery.js';
+/** A clip's progress goes out at least once a second while it generates, whether or not a step landed. */
+export const VIDEO_PROGRESS_HEARTBEAT_MS = 1_000;
 /** The first and last frames as the base64 `sd-server` takes; nothing is read for text-to-video. */
 export async function resolveVideoInputs(request, deps) {
     const inputs = { refs: [] };
@@ -54,13 +57,14 @@ export function decodeVideo(job) {
 }
 /** Refuse anything that is not a WebM, then write the clip and its sidecar into the video gallery. */
 export async function saveVideoOutput(deps, ctx, decoded) {
-    const { id, request, spec, seed, startedAt } = ctx;
+    const { id, request, spec, seed, startedAt, decodeStartedAt } = ctx;
     if (!isWebm(decoded.bytes))
         throw diffusionError('INVALID_OUTPUT', 'The video engine returned something that is not a WebM.');
     const video = spec.defaults.video;
     const frames = request.frames ?? video?.frames ?? decoded.frameCount;
     const fps = request.fps ?? video?.fps ?? decoded.fps;
     const createdAtMs = deps.now();
+    const durationMs = Math.max(createdAtMs - startedAt, 0);
     const recipe = {
         jobId: id,
         prompt: request.prompt,
@@ -93,22 +97,41 @@ export async function saveVideoOutput(deps, ctx, decoded) {
             cpuFallback: spec.cpuFallback,
         },
         createdAtMs,
-        durationMs: Math.max(createdAtMs - startedAt, 0),
+        durationMs,
+        // What the history calibrates the decode with, apart from the steps.
+        ...(decodeStartedAt === undefined
+            ? {}
+            : { decodeMs: Math.min(Math.max(createdAtMs - decodeStartedAt, 0), durationMs) }),
     };
     const saved = await deps.videoGallery.save(deps.state.videoOutputDir(), recipe, decoded.bytes);
+    deps.videoSaved?.();
     deps.state.updateJob(id, (record) => record.job.outputs.push(saved.item));
     return { items: [saved.item], bytes: [saved.bytes] };
 }
-/** The wire progress of a clip: the tracker's snapshot without the batch fields. */
-export function videoProgress(snapshot) {
-    return {
-        phase: snapshot.phase,
-        step: snapshot.step,
-        totalSteps: snapshot.totalSteps,
-        fraction: snapshot.fraction,
-        etaSeconds: snapshot.etaSeconds,
-        elapsedMs: snapshot.elapsedMs,
-    };
+/** The estimate and its forecast for a job about to start; a failure only costs the job its estimate. */
+export async function prepareVideoJob(deps, request, spec) {
+    if (!deps.planVideo)
+        return undefined;
+    try {
+        return await deps.planVideo(request, spec);
+    }
+    catch (error) {
+        deps.log('warn', `video estimate failed: ${error instanceof Error ? error.message : String(error)}`);
+        return 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 function videoProgressModel(record, startedAt) {
+    const estimate = record.job.estimate;
+    const eta = new VideoEta({
+        startedAt,
+        ...(record.forecast ? { forecast: record.forecast } : {}),
+        estimated: estimate?.seconds != null,
+    });
+    return (snapshot, now, decodeTiles) => eta.progress(snapshot, now, decodeTiles);
 }
 /** A build without libwebm cannot write the one container the app plays; say so before submitting. */
 export function checkWebmSupport(capabilities) {
@@ -127,7 +150,8 @@ export const VIDEO_JOB_KIND = {
         failed: 'The video server failed to generate.',
     },
     validate: (request, spec, deps) => validateVideoRequest(request, spec, deps),
-    newJob: (id, spec, request, now) => ({
+    prepare: prepareVideoJob,
+    newJob: (id, spec, request, now, plan) => ({
         id,
         state: 'queued',
         modelId: spec.modelId,
@@ -135,11 +159,14 @@ export const VIDEO_JOB_KIND = {
         createdAtMs: now,
         progress: null,
         outputs: [],
+        ...(plan?.estimate ? { estimate: plan.estimate } : {}),
     }),
     resolveInputs: resolveVideoInputs,
-    buildBody: (request, spec, seed, inputs) => buildVidGenRequest(request, spec.defaults, seed, inputs),
+    // The plan tiled the decode for the device; on the CPU fallback the threshold decides again.
+    buildBody: (request, spec, seed, inputs, plan) => buildVidGenRequest(request, spec.defaults, seed, inputs, spec.cpuFallback ? undefined : plan?.decodeTiling),
     trackerShape: (request) => ({ steps: Math.max(request.steps, 1), batch: 1 }),
-    progress: videoProgress,
+    progressModel: videoProgressModel,
+    heartbeatMs: VIDEO_PROGRESS_HEARTBEAT_MS,
     emitJob: (emit, job) => emit('diffusion:video-job', { job }),
     emitProgress: (emit, jobId, progress) => emit('diffusion:video-progress', { jobId, progress }),
     cancelGenerating: (capabilities) => capabilities.vidGen?.cancelGenerating ?? false,

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

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

package/dist/diffusion/video-recipe.js

@@ -56,6 +56,7 @@ export function serializeVideoRecipe(recipe) {
         },
         createdAtMs: recipe.createdAtMs,
         durationMs: recipe.durationMs,
+        ...(recipe.decodeMs === undefined ? {} : { decodeMs: recipe.decodeMs }),
     };
     return `${JSON.stringify(ordered, null, 2)}\n`;
 }
@@ -136,6 +137,8 @@ export function parseVideoRecipe(text) {
         },
         createdAtMs: raw['createdAtMs'],
         durationMs: raw['durationMs'],
+        // Older clips have none; a malformed one is dropped rather than the clip.
+        ...(isWhole(raw['decodeMs']) ? { decodeMs: raw['decodeMs'] } : {}),
     };
 }
 //# sourceMappingURL=video-recipe.js.map

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

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

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

@@ -0,0 +1,54 @@
+/**
+ * How a clip's VAE decode is split into spatial tiles, as sd.cpp splits it. Every tile runs the
+ * decoder over all the clip's frames and the tiles overlap by half, so a tiled decode recomputes the
+ * overlap: 704×1280 on the Wan 2.2 VAE (a 44×80 latent) in sd.cpp's default 32-pixel tiles is 2×4
+ * tiles, 2.33 times the work of one graph. Pure; the choice of tiling is `planDecodeTiling` in
+ * `video-estimate.ts`.
+ */
+/**
+ * The tiles across and down a decode is asked for; 1 × 1 is one graph over the whole frame. Sent as
+ * tile counts (`rel_size_*` above 1), which sd.cpp reads the same way in every build, where the unit
+ * of an absolute tile size changed from latent to image pixels upstream (sd.cpp #2059).
+ */
+export interface VideoDecodeTiling {
+    tilesX: number;
+    tilesY: number;
+}
+/** sd.cpp's default tile before #2059: 32 latent pixels on a side. */
+export declare const ENGINE_TILE_LATENT = 32;
+/** sd.cpp's default overlap between neighbouring tiles, a share of the tile. */
+export declare const DECODE_TILE_OVERLAP = 0.5;
+/** sd.cpp's smallest tile side in latent pixels. */
+export declare const MIN_TILE_LATENT = 4;
+/**
+ * Tiles along one axis of `size` latent pixels for tiles of `tile`, counted as sd.cpp's
+ * `sd_tiling_calc_tiles` counts them (the non-circular branch): an extra tile when the last one would
+ * overshoot by little, and never fewer than two once the axis is longer than a tile.
+ */
+export declare function tilesAlong(size: number, tile: number, overlap?: number): number;
+/**
+ * The tile side sd.cpp takes for `count` tiles along `size` (`rel_size` above 1): `size / (count −
+ * count·overlap + overlap)`, rounded as the pinned build rounds it; the whole axis for one tile.
+ */
+export declare function tileSideFor(size: number, count: number, overlap?: number): number;
+/** What one tiling costs: the tiles the engine will run, their side in latent pixels, and the work. */
+export interface DecodeLayout {
+    tiled: boolean;
+    tilesX: number;
+    tilesY: number;
+    /** Latent pixels on a side of one tile. */
+    tileWidth: number;
+    tileHeight: number;
+    /** The decoder's work against one graph over the frame: the tiles' area over the latent's. */
+    work: number;
+}
+/** The layout of `tiling` over a latent of `width` × `height` pixels; one graph when `tiling` is 1 × 1. */
+export declare function tilingLayout(width: number, height: number, tiling: VideoDecodeTiling): DecodeLayout;
+/** The layout of sd.cpp's own tiles (32 latent pixels) when a request only switches tiling on. */
+export declare function engineDefaultLayout(width: number, height: number): DecodeLayout;
+/**
+ * The `vae_tiling_params` of a tiled decode: tile counts under both spellings sd.cpp has used
+ * (`rel_size_x/y` up to the pinned build, `rel_size_w/h` after #2059); a build reads its own and
+ * ignores the other. Undefined for one graph.
+ */
+export declare function decodeTilingParams(tiling: VideoDecodeTiling): Record<string, unknown> | undefined;

package/dist/diffusion/video-tiling.js

@@ -0,0 +1,70 @@
+/**
+ * How a clip's VAE decode is split into spatial tiles, as sd.cpp splits it. Every tile runs the
+ * decoder over all the clip's frames and the tiles overlap by half, so a tiled decode recomputes the
+ * overlap: 704×1280 on the Wan 2.2 VAE (a 44×80 latent) in sd.cpp's default 32-pixel tiles is 2×4
+ * tiles, 2.33 times the work of one graph. Pure; the choice of tiling is `planDecodeTiling` in
+ * `video-estimate.ts`.
+ */
+/** sd.cpp's default tile before #2059: 32 latent pixels on a side. */
+export const ENGINE_TILE_LATENT = 32;
+/** sd.cpp's default overlap between neighbouring tiles, a share of the tile. */
+export const DECODE_TILE_OVERLAP = 0.5;
+/** sd.cpp's smallest tile side in latent pixels. */
+export const MIN_TILE_LATENT = 4;
+/**
+ * Tiles along one axis of `size` latent pixels for tiles of `tile`, counted as sd.cpp's
+ * `sd_tiling_calc_tiles` counts them (the non-circular branch): an extra tile when the last one would
+ * overshoot by little, and never fewer than two once the axis is longer than a tile.
+ */
+export function tilesAlong(size, tile, overlap = DECODE_TILE_OVERLAP) {
+    if (size <= tile)
+        return 1;
+    const tileOverlap = Math.trunc(tile * overlap);
+    const nonOverlap = tile - tileOverlap;
+    let count = Math.trunc((size - tileOverlap) / nonOverlap);
+    const overshoot = ((count + 1) * nonOverlap + tileOverlap) % size;
+    if (overshoot !== nonOverlap && overshoot <= count * (Math.trunc(tile / 2) - tileOverlap))
+        count += 1;
+    return Math.max(count, 2);
+}
+/**
+ * The tile side sd.cpp takes for `count` tiles along `size` (`rel_size` above 1): `size / (count −
+ * count·overlap + overlap)`, rounded as the pinned build rounds it; the whole axis for one tile.
+ */
+export function tileSideFor(size, count, overlap = DECODE_TILE_OVERLAP) {
+    if (count <= 1)
+        return size;
+    const side = Math.round(size / (count - count * overlap + overlap));
+    return Math.max(Math.min(side, size), Math.min(MIN_TILE_LATENT, size));
+}
+/** The layout of `tiling` over a latent of `width` × `height` pixels; one graph when `tiling` is 1 × 1. */
+export function tilingLayout(width, height, tiling) {
+    if (tiling.tilesX <= 1 && tiling.tilesY <= 1)
+        return { tiled: false, tilesX: 1, tilesY: 1, tileWidth: width, tileHeight: height, work: 1 };
+    const tileWidth = tileSideFor(width, tiling.tilesX);
+    const tileHeight = tileSideFor(height, tiling.tilesY);
+    return tiledLayout(width, height, tileWidth, tileHeight);
+}
+/** The layout of sd.cpp's own tiles (32 latent pixels) when a request only switches tiling on. */
+export function engineDefaultLayout(width, height) {
+    return tiledLayout(width, height, Math.min(ENGINE_TILE_LATENT, width), Math.min(ENGINE_TILE_LATENT, height));
+}
+function tiledLayout(width, height, tileWidth, tileHeight) {
+    const tilesX = tilesAlong(width, tileWidth);
+    const tilesY = tilesAlong(height, tileHeight);
+    const work = (tilesX * tileWidth * tilesY * tileHeight) / Math.max(width * height, 1);
+    return { tiled: true, tilesX, tilesY, tileWidth, tileHeight, work };
+}
+/**
+ * The `vae_tiling_params` of a tiled decode: tile counts under both spellings sd.cpp has used
+ * (`rel_size_x/y` up to the pinned build, `rel_size_w/h` after #2059); a build reads its own and
+ * ignores the other. Undefined for one graph.
+ */
+export function decodeTilingParams(tiling) {
+    if (tiling.tilesX <= 1 && tiling.tilesY <= 1)
+        return undefined;
+    const x = Math.max(tiling.tilesX, 1);
+    const y = Math.max(tiling.tilesY, 1);
+    return { enabled: true, rel_size_x: x, rel_size_y: y, rel_size_w: x, rel_size_h: y };
+}
+//# sourceMappingURL=video-tiling.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-tiling.js","sourceRoot":"","sources":["../../src/diffusion/video-tiling.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AACpC,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AACtC,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEhC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,OAAO,GAAG,mBAAmB;IAClF,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,CAAC,CAAA;IAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,CAAA;IAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,WAAW,CAAA;IACrC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,WAAW,CAAC,GAAG,UAAU,CAAC,CAAA;IACzD,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,IAAI,CAAA;IACjE,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC;QAAE,KAAK,IAAI,CAAC,CAAA;IACrG,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAa,EAAE,OAAO,GAAG,mBAAmB;IACpF,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAA;IACnE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAA;AACxE,CAAC;AAcD,2GAA2G;AAC3G,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,MAAc,EAAE,MAAyB;IACnF,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IAC9F,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACrD,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;AAC1D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,MAAc;IAC/D,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAA;AAC9G,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,SAAiB,EAAE,UAAkB;IACvF,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAA;IACrF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IAC9D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAA;AACtF,CAAC"}

package/dist/diffusion/wiring.d.ts

@@ -4,8 +4,9 @@
  * bus. Kept out of `create.ts`, which stays a list of `await`s.
  */
 import type { DataLayout } from '../config/index.js';
-import type { CoreEvents } from '../contracts/index.js';
+import type { CoreEvents, HardwareInfoResponse, SystemInfo } from '../contracts/index.js';
 import type { ProcessJournal } from '../lock/index.js';
+import type { BackendOutputSink, GpuClaimHook } from '../runtime/shared/index.js';
 import { DiffusionService } from './service.js';
 import type { DiffusionServiceDeps } from './service.js';
 export interface WireDiffusionOptions {
@@ -14,11 +15,23 @@ export interface WireDiffusionOptions {
     instanceId: string;
     emit: <K extends keyof CoreEvents>(name: K, payload: CoreEvents[K]) => void;
     log: (level: 'info' | 'warn' | 'debug', msg: string) => void;
+    /** Every stdout/stderr line `sd-server` prints, for the life of the session. */
+    backendOutput?: BackendOutputSink;
+    /** The core's hardware service; the video estimate reads its facts, the override applied. */
+    hardware?: {
+        info(): Promise<HardwareInfoResponse>;
+    };
     platform?: NodeJS.Platform;
     env?: NodeJS.ProcessEnv;
+    /** Core's GPU residency (task 2.15), asked before every `sd-server` spawn. */
+    claimGpu?: GpuClaimHook;
     /** Test seams, straight through to the service. */
     overrides?: Pick<DiffusionServiceDeps, 'http' | 'spawn' | 'timings' | 'idleTickMs' | 'now' | 'sleep' | 'drawSeed'>;
 }
 /** The journal entry an `sd-server` gets the moment it starts, so a crashed owner's successor can reap it. */
 export declare function diffusionJournal(journal: Pick<ProcessJournal, 'add' | 'remove'>, instanceId: string, now?: () => number): NonNullable<DiffusionServiceDeps['journal']>;
+/** The facts the video estimate reads, out of the hardware service's answer. */
+export declare function hardwareSystemInfo(hardware: {
+    info(): Promise<HardwareInfoResponse>;
+}): () => Promise<SystemInfo>;
 export declare function wireDiffusion(options: WireDiffusionOptions): DiffusionService;

package/dist/diffusion/wiring.js

@@ -21,6 +21,10 @@ export function diffusionJournal(journal, instanceId, now = Date.now) {
         remove: (pid) => journal.remove(pid),
     };
 }
+/** The facts the video estimate reads, out of the hardware service's answer. */
+export function hardwareSystemInfo(hardware) {
+    return async () => (await hardware.info()).info;
+}
 export function wireDiffusion(options) {
     const service = new DiffusionService({
         paths: options.layout.diffusion,
@@ -28,8 +32,11 @@ export function wireDiffusion(options) {
         emit: options.emit,
         log: options.log,
         journal: diffusionJournal(options.journal, options.instanceId),
+        ...(options.hardware ? { systemInfo: hardwareSystemInfo(options.hardware) } : {}),
         ...(options.platform ? { platform: options.platform } : {}),
         ...(options.env ? { env: options.env } : {}),
+        ...(options.claimGpu ? { claimGpu: options.claimGpu } : {}),
+        ...(options.backendOutput ? { backendOutput: options.backendOutput } : {}),
         ...options.overrides,
     });
     service.start();

package/dist/diffusion/wiring.js.map

@@ -1 +1 @@
-{"version":3,"file":"wiring.js","sourceRoot":"","sources":["../../src/diffusion/wiring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAkB/C,8GAA8G;AAC9G,MAAM,UAAU,gBAAgB,CAC9B,OAA+C,EAC/C,UAAkB,EAClB,MAAoB,IAAI,CAAC,GAAG;IAE5B,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CACrC,OAAO,CAAC,GAAG,CAAC;YACV,WAAW,EAAE,UAAU;YACvB,GAAG;YACH,gBAAgB,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI;YACrD,GAAG;YACH,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,OAAO;YACjB,IAAI;YACJ,UAAU,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;SAC1C,CAAC;QACJ,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;KACrC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;QACnC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;QAC/B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,OAAO,CAAC,SAAS;KACrB,CAAC,CAAA;IACF,OAAO,CAAC,KAAK,EAAE,CAAA;IACf,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"wiring.js","sourceRoot":"","sources":["../../src/diffusion/wiring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAwB/C,8GAA8G;AAC9G,MAAM,UAAU,gBAAgB,CAC9B,OAA+C,EAC/C,UAAkB,EAClB,MAAoB,IAAI,CAAC,GAAG;IAE5B,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CACrC,OAAO,CAAC,GAAG,CAAC;YACV,WAAW,EAAE,UAAU;YACvB,GAAG;YACH,gBAAgB,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI;YACrD,GAAG;YACH,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,OAAO;YACjB,IAAI;YACJ,UAAU,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;SAC1C,CAAC;QACJ,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;KACrC,CAAA;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,QAElC;IACC,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;QACnC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;QAC/B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,OAAO,CAAC,SAAS;KACrB,CAAC,CAAA;IACF,OAAO,CAAC,KAAK,EAAE,CAAA;IACf,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/diffusion/workflow.d.ts

@@ -17,12 +17,18 @@ export declare function usesReferences(workflow: ImageWorkflowId): boolean;
  * `upscale` is a re-detail pass that keeps most of the enlarged source.
  */
 export declare function defaultStrength(workflow: ImageWorkflowId): number;
+/**
+ * Qwen Image 2.1 and its 8-step Turbo checkpoint: one architecture, the same text encoder, vision
+ * projector and VAE, so the same workflows and the same engine floor.
+ */
+export declare function isQwenImage21(family: string): boolean;
 /**
  * img2img and masking are generic in sd.cpp (the init image is VAE-encoded and noised to `strength`,
  * a mask blends latents), so the established base families get them; a distilled model such as
  * Krea 2 Turbo keeps to its verified Create. Reference-guided generation and instruction edits need
- * a model trained on reference images: FLUX.2 Klein and Qwen Image 2.1, which also needs its vision
- * projector loaded (`workflowsForSpec`). Anything else, video families included, only creates.
+ * a model trained on reference images: FLUX.2 Klein and Qwen Image 2.1 (Turbo included, which the
+ * official checkpoint trains for editing), which also needs its vision projector loaded
+ * (`workflowsForSpec`). Anything else, video families included, only creates.
  */
 export declare function workflowsForFamily(family: string): ImageWorkflowId[];
 /** The workflows the loaded server can actually run: Qwen Image 2.1 without `llmVision` only creates. */

package/dist/diffusion/workflow.js

@@ -37,19 +37,27 @@ export function defaultStrength(workflow) {
         return 0.35;
     return 0.75;
 }
+/**
+ * Qwen Image 2.1 and its 8-step Turbo checkpoint: one architecture, the same text encoder, vision
+ * projector and VAE, so the same workflows and the same engine floor.
+ */
+export function isQwenImage21(family) {
+    return family === 'qwen-image-2.1' || family === 'qwen-image-2.1-turbo';
+}
 /**
  * img2img and masking are generic in sd.cpp (the init image is VAE-encoded and noised to `strength`,
  * a mask blends latents), so the established base families get them; a distilled model such as
  * Krea 2 Turbo keeps to its verified Create. Reference-guided generation and instruction edits need
- * a model trained on reference images: FLUX.2 Klein and Qwen Image 2.1, which also needs its vision
- * projector loaded (`workflowsForSpec`). Anything else, video families included, only creates.
+ * a model trained on reference images: FLUX.2 Klein and Qwen Image 2.1 (Turbo included, which the
+ * official checkpoint trains for editing), which also needs its vision projector loaded
+ * (`workflowsForSpec`). Anything else, video families included, only creates.
  */
 export function workflowsForFamily(family) {
+    if (isQwenImage21(family))
+        return ['create', 'reference', 'edit'];
     switch (family) {
         case 'flux.2-klein':
             return ['create', 'transform', 'inpaint', 'extend', 'upscale', 'reference', 'edit'];
-        case 'qwen-image-2.1':
-            return ['create', 'reference', 'edit'];
         case 'krea-2-turbo':
             return ['create'];
         case 'z-image':
@@ -65,7 +73,7 @@ export function workflowsForFamily(family) {
 /** The workflows the loaded server can actually run: Qwen Image 2.1 without `llmVision` only creates. */
 export function workflowsForSpec(spec) {
     const workflows = workflowsForFamily(spec.family);
-    if (spec.family === 'qwen-image-2.1' && spec.files.llmVision === undefined)
+    if (isQwenImage21(spec.family) && spec.files.llmVision === undefined)
         return workflows.filter((workflow) => !usesReferences(workflow));
     return workflows;
 }

package/dist/diffusion/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/diffusion/workflow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,eAAe,GAA+B;IACzD,QAAQ;IACR,WAAW;IACX,SAAS;IACT,QAAQ;IACR,SAAS;IACT,WAAW;IACX,MAAM;CACP,CAAA;AAED,MAAM,UAAU,UAAU,CAAC,OAA+C;IACxE,OAAO,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAA;AACrC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,QAAyB;IACrD,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS,CAAA;AAC9G,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAyB;IAChD,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,CAAA;AACxD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,QAAyB;IACtD,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,MAAM,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAyB;IACvD,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IACrC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACvC,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,cAAc;YACjB,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;QACrF,KAAK,gBAAgB;YACnB,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;QACxC,KAAK,cAAc;YACjB,OAAO,CAAC,QAAQ,CAAC,CAAA;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,YAAY;YACf,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;QAChE;YACE,kFAAkF;YAClF,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;YAC/F,OAAO,CAAC,QAAQ,CAAC,CAAA;IACrB,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,gBAAgB,CAAC,IAA0C;IACzE,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjD,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;QACxE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAA;IAClE,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,eAAe,GAA+B,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;AAEvF,qFAAqF;AACrF,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAA;AACnB,CAAC"}
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/diffusion/workflow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,eAAe,GAA+B;IACzD,QAAQ;IACR,WAAW;IACX,SAAS;IACT,QAAQ;IACR,SAAS;IACT,WAAW;IACX,MAAM;CACP,CAAA;AAED,MAAM,UAAU,UAAU,CAAC,OAA+C;IACxE,OAAO,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAA;AACrC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,QAAyB;IACrD,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS,CAAA;AAC9G,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAyB;IAChD,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,CAAA;AACxD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,QAAyB;IACtD,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,MAAM,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAyB;IACvD,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IACrC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACvC,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,KAAK,gBAAgB,IAAI,MAAM,KAAK,sBAAsB,CAAA;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IACjE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,cAAc;YACjB,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;QACrF,KAAK,cAAc;YACjB,OAAO,CAAC,QAAQ,CAAC,CAAA;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,YAAY;YACf,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;QAChE;YACE,kFAAkF;YAClF,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;YAC/F,OAAO,CAAC,QAAQ,CAAC,CAAA;IACrB,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,gBAAgB,CAAC,IAA0C;IACzE,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjD,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;QAClE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAA;IAClE,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,eAAe,GAA+B,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;AAEvF,qFAAqF;AACrF,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAA;AACnB,CAAC"}

package/dist/downloads/downloader.d.ts

@@ -8,6 +8,10 @@
  * - `Range: bytes=N-` → 206 + validated `Content-Range`; 200/416 → restart from 0; 408/429/5xx retry
  * - 5 retries per stall, counter reset after every 1 MiB of fresh progress
  * - combined progress `{transferred,total}` after resume, every 10 MiB per file, per file end, task end
+ *   (with `streams` > 1 also every 250 ms while bytes flow: a terminal draws from it, the app's bar
+ *   does not, and the app never sets `streams`)
+ * - with `streams` > 1, a hash-pinned file of at least 32 MiB downloads over byte ranges in parallel
+ *   (`segmented.ts`), falling back to one stream when the server cannot serve ranges
  * - verification (size, sha256) after all files; on failure the file and its directory (non-recursive)
  *   are removed and the task fails; cancel keeps every partial and finished file
  * - preflight: Windows path limit, free space with 512 MiB headroom (skipped when unknown)
@@ -34,6 +38,10 @@ export interface DownloadOptions {
 }
 export declare const DOWNLOAD_CANCELLED = "Download cancelled";
 export interface DownloaderDeps {
+    /** Parallel byte-range streams for a hash-pinned file of at least 32 MiB (`segmented.ts`); one by default. */
+    streams?: number;
+    /** Milliseconds, for the time-based progress cadence `streams` > 1 adds. */
+    now?: () => number;
     dataFolder: string;
     platform: NodeJS.Platform;
     fetch: typeof fetch;
@@ -50,6 +58,15 @@ export interface DownloaderDeps {
 /** The events a download raises; narrow on purpose, so a caller cannot be handed anything else. */
 export type DownloaderEventName = 'download:progress' | 'download:stage' | 'model:validation-started';
 export type DownloaderEmit = <K extends DownloaderEventName>(name: K, payload: CoreEvents[K]) => void;
+/** One running task's combined progress, as its last `download:progress` event said. */
+export interface DownloadProgress {
+    taskId: string;
+    transferred: number;
+    total: number;
+    percent: number;
+}
+/** With `streams` > 1, progress is also reported this often while bytes flow. */
+export declare const TIMED_PROGRESS_INTERVAL_MS = 250;
 export declare function defaultAvailableSpace(path: string): Promise<number | undefined>;
 export declare function defaultSleep(ms: number, signal: AbortSignal): Promise<void>;
 /** Resolve the longest existing prefix through symlinks, then re-append the rest (Rust `canonicalize_existing_prefix`). */
@@ -60,6 +77,11 @@ export declare class Downloader {
     constructor(deps: DownloaderDeps);
     /** Task ids currently running. */
     active(): string[];
+    /**
+     * Every running task's last combined progress (zeros before its first report): what a client that
+     * reconnects mid-transfer reads from the control snapshot instead of waiting for the next event.
+     */
+    snapshot(): DownloadProgress[];
     /** Cancel a running task. Keeps partials and finished files. */
     cancel(taskId: string): boolean;
     /**

package/dist/downloads/downloader.js

@@ -8,6 +8,10 @@
  * - `Range: bytes=N-` → 206 + validated `Content-Range`; 200/416 → restart from 0; 408/429/5xx retry
  * - 5 retries per stall, counter reset after every 1 MiB of fresh progress
  * - combined progress `{transferred,total}` after resume, every 10 MiB per file, per file end, task end
+ *   (with `streams` > 1 also every 250 ms while bytes flow: a terminal draws from it, the app's bar
+ *   does not, and the app never sets `streams`)
+ * - with `streams` > 1, a hash-pinned file of at least 32 MiB downloads over byte ranges in parallel
+ *   (`segmented.ts`), falling back to one stream when the server cannot serve ranges
  * - verification (size, sha256) after all files; on failure the file and its directory (non-recursive)
  *   are removed and the task fails; cancel keeps every partial and finished file
  * - preflight: Windows path limit, free space with 512 MiB headroom (skipped when unknown)
@@ -22,8 +26,11 @@ import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
 import { checkFreeSpace, checkPathWithinLimit, diskErrToString, remainingBytes } from './disk.js';
 import { classifyDownloadStatus, classifyResumeStatus, DownloadRequestError, downloadStage, expectedDownloadSize, HEAD_TIMEOUT_MS, MAX_STREAM_RETRIES, PROGRESS_EMIT_INTERVAL_BYTES, RETRY_RESET_PROGRESS_BYTES, retryDelayMs, shouldBypassProxy, sidecarPath, validateContentRange, validateProxyConfig, } from './protocol.js';
 import { policyFetchFor } from './proxy-fetch.js';
+import { downloadSegments, SEGMENTED_MIN_BYTES } from './segmented.js';
 import { verifyDownloadedFile } from './verify.js';
 export const DOWNLOAD_CANCELLED = 'Download cancelled';
+/** With `streams` > 1, progress is also reported this often while bytes flow. */
+export const TIMED_PROGRESS_INTERVAL_MS = 250;
 export async function defaultAvailableSpace(path) {
     let probe = path;
     for (;;) {
@@ -87,6 +94,7 @@ export class Downloader {
             sleep: defaultSleep,
             retryBaseMs: 1000,
             log: () => { },
+            now: Date.now,
             ...deps,
         };
     }
@@ -94,6 +102,13 @@ export class Downloader {
     active() {
         return [...this.tasks.keys()];
     }
+    /**
+     * Every running task's last combined progress (zeros before its first report): what a client that
+     * reconnects mid-transfer reads from the control snapshot instead of waiting for the next event.
+     */
+    snapshot() {
+        return [...this.tasks.entries()].map(([taskId, task]) => task.progress ?? { taskId, transferred: 0, total: 0, percent: 0 });
+    }
     /** Cancel a running task. Keeps partials and finished files. */
     cancel(taskId) {
         const task = this.tasks.get(taskId);
@@ -171,7 +186,11 @@ export class Downloader {
         const emitProgress = () => {
             const transferred = [...progress.values()].reduce((a, b) => a + b, 0);
             const percent = totalSize > 0 ? Math.min(100, (transferred / totalSize) * 100) : 0;
-            this.deps.emit('download:progress', { taskId, transferred, total: totalSize, percent });
+            const current = { taskId, transferred, total: totalSize, percent };
+            const task = this.tasks.get(taskId);
+            if (task !== undefined && task.controller.signal === signal)
+                task.progress = current;
+            this.deps.emit('download:progress', current);
         };
         const results = await Promise.all(items.map((item, i) => this.downloadOne(item, savePaths[i], `${taskId}-${i}`, sizes.get(item.url) ?? 0, {
             headers,
@@ -303,6 +322,36 @@ export class Downloader {
             throw disk(e);
         });
         const expectedSize = expectedDownloadSize(item.size, fileSize);
+        const streams = this.deps.streams ?? 1;
+        if (!shouldResume && item.sha256 && expectedSize >= SEGMENTED_MIN_BYTES && streams > 1) {
+            reportStage('connecting', 0);
+            const done = await downloadSegments({
+                url: item.url,
+                destination: savePath,
+                size: expectedSize,
+                sha256: item.sha256,
+                streams,
+                fetch: fetchImpl,
+                headers,
+                signal,
+                sleep: this.deps.sleep,
+                retryBaseMs: this.deps.retryBaseMs,
+                now: this.deps.now,
+                progress: (bytes) => {
+                    progress.set(fileId, bytes);
+                    emitProgress();
+                },
+            }).catch((e) => {
+                if (signal.aborted)
+                    throw new Error(DOWNLOAD_CANCELLED);
+                throw new Error(`Download failed for '${item.url}': ${e.message}`);
+            });
+            if (done) {
+                await rm(urlPath, { force: true }).catch(() => { });
+                return savePath;
+            }
+            this.deps.log('info', `Ranges are unavailable for '${item.url}'; downloading in one stream`);
+        }
         let res;
         let totalTransferred = 0;
         if (shouldResume) {
@@ -351,6 +400,10 @@ export class Downloader {
         const close = () => new Promise((ok, fail) => writer.end((e) => (e ? fail(disk(e)) : ok())));
         let body = res.body ?? new ReadableStream({ start: (c) => c.close() });
         let reader = body.getReader();
+        // The app's bar is fed every 10 MiB and nothing more; a client that asked for parallel streams
+        // also gets a report every `TIMED_PROGRESS_INTERVAL_MS` while bytes flow.
+        const timedProgress = streams > 1;
+        let reportedAt = this.deps.now();
         let delta = 0;
         let retryCount = 0;
         let sinceReset = 0;
@@ -379,7 +432,9 @@ export class Downloader {
                         retryCount = 0;
                         sinceReset = 0;
                     }
-                    if (delta >= PROGRESS_EMIT_INTERVAL_BYTES) {
+                    if (delta >= PROGRESS_EMIT_INTERVAL_BYTES ||
+                        (timedProgress && this.deps.now() - reportedAt >= TIMED_PROGRESS_INTERVAL_MS)) {
+                        reportedAt = this.deps.now();
                         progress.set(fileId, totalTransferred);
                         emitProgress();
                         delta = 0;