@atomic-chat/core 0.5.1

package/dist/diffusion/tracker.js.map

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

package/dist/diffusion/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * State the diffusion module keeps for itself; nothing here crosses the wire. `state.rs` in
+ * `tauri-plugin-atomic-diffusion` (app commit `767ff6350`).
+ */
+import type { DiffusionBackend, DiffusionEngineId, DiffusionFamilyDefaults, DiffusionFamilyRanges, DiffusionModality, DiffusionModelFiles, DiffusionOffloadPolicy } from '../contracts/index.js';
+/**
+ * Everything needed to (re)spawn the server. Kept after a cancel or a crash took the process down,
+ * so the next job brings it back without the app repeating the load; cleared only by an unload.
+ */
+export interface ServerSpec {
+    /** Directory holding `sd-server`. */
+    binaryDir: string;
+    engine: DiffusionEngineId;
+    backend: DiffusionBackend;
+    backendId: string;
+    tag: string;
+    modelId: string;
+    family: string;
+    modality: DiffusionModality;
+    displayName: string;
+    files: DiffusionModelFiles;
+    defaults: DiffusionFamilyDefaults;
+    ranges: DiffusionFamilyRanges;
+    offload: DiffusionOffloadPolicy;
+    threads?: number;
+    /** Appended last: sd.cpp's argument parser is last-wins. */
+    extraArgs: string[];
+    startupTimeoutMs: number;
+    /** True once the ggml-abort recovery moved everything to the CPU backend. */
+    cpuFallback: boolean;
+}
+/** The engine's generation modes, as `supported_modes` names them. */
+export type SdMode = 'img_gen' | 'vid_gen';
+/** What `GET /sdcpp/v1/capabilities` said after the server came up. */
+export interface ServerCapabilities {
+    /** `features_by_mode.img_gen.cancel_generating`. */
+    cancelGenerating: boolean;
+    imgGenDefaults?: unknown;
+    /** `supported_modes`; absent on builds that predate the field (image only). */
+    supportedModes?: SdMode[];
+    /** The `vid_gen` sections, present when the build reports that mode. */
+    vidGen?: {
+        cancelGenerating: boolean;
+        /** `output_formats_by_mode.vid_gen`; absent when the build does not list formats. */
+        outputFormats?: string[];
+        defaults?: unknown;
+    };
+}
+/** The mode a model of `modality` is served in. */
+export declare const modeOf: (modality: DiffusionModality) => SdMode;
+/** A request's images, already base64, so the argument builders stay free of I/O. */
+export interface ResolvedInputs {
+    init?: string;
+    mask?: string;
+    /** For the reference workflows: the source first, then the extras. */
+    refs: string[];
+    /** Video: the last frame of an image-to-video request. */
+    end?: string;
+}
+export declare const DEFAULT_STARTUP_TIMEOUT_SECS = 600;
+export declare const DEFAULT_IDLE_UNLOAD_SECS = 600;
+export declare const MAX_BATCH = 4;

package/dist/diffusion/types.js

@@ -0,0 +1,10 @@
+/**
+ * State the diffusion module keeps for itself; nothing here crosses the wire. `state.rs` in
+ * `tauri-plugin-atomic-diffusion` (app commit `767ff6350`).
+ */
+/** The mode a model of `modality` is served in. */
+export const modeOf = (modality) => (modality === 'video' ? 'vid_gen' : 'img_gen');
+export const DEFAULT_STARTUP_TIMEOUT_SECS = 600;
+export const DEFAULT_IDLE_UNLOAD_SECS = 600;
+export const MAX_BATCH = 4;
+//# sourceMappingURL=types.js.map

package/dist/diffusion/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/diffusion/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0DH,mDAAmD;AACnD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAA2B,EAAU,EAAE,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AAY7G,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAA;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAA;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAA"}

package/dist/diffusion/validate.d.ts

@@ -0,0 +1,36 @@
+/**
+ * What a generation request must satisfy before anything is spawned or evicted for it.
+ * `validate_request`, `check_source` and `strip_data_url` in `jobs.rs` of
+ * `tauri-plugin-atomic-diffusion` (app commit `ec1fd3ea7`); messages verbatim, checks in the same
+ * order, because the first failing one is what the user is shown.
+ */
+import type { ImageGenerateRequest, VideoGenerateRequest } from '../contracts/index.js';
+import type { ServerSpec } from './types.js';
+export interface ValidateDeps {
+    /** Whether `path` is an existing regular file. */
+    isFile: (path: string) => Promise<boolean>;
+}
+/** `data:image/png;base64,....` → the base64 part. A plain payload is returned unchanged. */
+export declare function stripDataUrl(value: string): string;
+/**
+ * Canonical standard base64, which is what the plugin's decoder insisted on: the standard alphabet,
+ * no whitespace, padding present and exact, unused trailing bits zero. Checked without decoding,
+ * because a payload can be tens of megabytes.
+ */
+export declare function isCanonicalBase64(payload: string): boolean;
+export declare function validateRequest(request: ImageGenerateRequest, spec: ServerSpec, deps: ValidateDeps): Promise<void>;
+/** How a family counts frames: valid counts are `k * step + offset`. */
+export interface FrameRule {
+    step: number;
+    offset: number;
+}
+export declare function isValidFrameCount(frames: number, rule: FrameRule, range: [number, number]): boolean;
+/** The largest valid frame count at most `wanted`; undefined when even the smallest is more. */
+export declare function largestValidFrames(wanted: number, rule: FrameRule, range: [number, number]): number | undefined;
+/** The valid frame count nearest to `wanted`, clamped into the range: what a length in seconds becomes. */
+export declare function nearestValidFrames(wanted: number, rule: FrameRule, range: [number, number]): number;
+/**
+ * A video request against the loaded video family: the image checks that apply, then the frame count
+ * on the family's lattice, the fixed frame rate, and the one workflow this build serves.
+ */
+export declare function validateVideoRequest(request: VideoGenerateRequest, spec: ServerSpec, _deps: ValidateDeps): Promise<void>;

package/dist/diffusion/validate.js

@@ -0,0 +1,166 @@
+/**
+ * What a generation request must satisfy before anything is spawned or evicted for it.
+ * `validate_request`, `check_source` and `strip_data_url` in `jobs.rs` of
+ * `tauri-plugin-atomic-diffusion` (app commit `ec1fd3ea7`); messages verbatim, checks in the same
+ * order, because the first failing one is what the user is shown.
+ */
+import { diffusionError } from './errors.js';
+import { MAX_BATCH } from './types.js';
+import { usesMask, usesReferences, videoWorkflowsForFamily, workflowOf, workflowsForSpec, } from './workflow.js';
+/** `data:image/png;base64,....` → the base64 part. A plain payload is returned unchanged. */
+export function stripDataUrl(value) {
+    if (!value.startsWith('data:'))
+        return value;
+    const rest = value.slice('data:'.length);
+    const comma = rest.indexOf(',');
+    return comma < 0 ? rest : rest.slice(comma + 1);
+}
+const BASE64_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/**
+ * Canonical standard base64, which is what the plugin's decoder insisted on: the standard alphabet,
+ * no whitespace, padding present and exact, unused trailing bits zero. Checked without decoding,
+ * because a payload can be tens of megabytes.
+ */
+export function isCanonicalBase64(payload) {
+    if (payload.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(payload))
+        return false;
+    const padding = payload.endsWith('==') ? 2 : payload.endsWith('=') ? 1 : 0;
+    if (padding === 0)
+        return true;
+    const last = BASE64_ALPHABET.indexOf(payload[payload.length - padding - 1]);
+    // Two padding characters leave 4 unused bits in the last sextet, one leaves 2.
+    return (last & (padding === 2 ? 0x0f : 0x03)) === 0;
+}
+/**
+ * A source must be present and usable: an existing file, or base64 that decodes. Refusing here
+ * keeps a bad input from evicting the chat model and spinning up the server for nothing.
+ */
+async function checkSource(source, what, deps) {
+    if (source === undefined)
+        throw diffusionError('INVALID_REQUEST', `This workflow needs ${what}.`);
+    if ('path' in source) {
+        if (await deps.isFile(source.path))
+            return;
+        throw diffusionError('INVALID_REQUEST', 'The source image could not be found.', source.path);
+    }
+    const payload = stripDataUrl(source.base64);
+    if (payload === '' || !isCanonicalBase64(payload))
+        throw diffusionError('INVALID_REQUEST', 'The inline image is not valid base64.');
+}
+/** Width and height inside the family's range and on its grid; the message names the first offender. */
+function checkDims(request, spec) {
+    const [minDim, maxDim] = spec.ranges.dims;
+    const multiple = Math.max(spec.ranges.dimMultiple, 1);
+    for (const [label, value] of [
+        ['width', request.width],
+        ['height', request.height],
+    ]) {
+        if (value < minDim || value > maxDim)
+            throw diffusionError('INVALID_DIMENSIONS', `${label} must be between ${minDim} and ${maxDim}.`, `${label}=${value}`);
+        if (value % multiple !== 0)
+            throw diffusionError('INVALID_DIMENSIONS', `${label} must be a multiple of ${multiple}.`, `${label}=${value}`);
+    }
+}
+function checkSteps(steps, spec) {
+    const [minSteps, maxSteps] = spec.ranges.steps;
+    if (steps < minSteps || steps > maxSteps)
+        throw diffusionError('INVALID_REQUEST', `Steps must be between ${minSteps} and ${maxSteps}.`, `steps=${steps}`);
+}
+export async function validateRequest(request, spec, deps) {
+    if (request.prompt.trim() === '')
+        throw diffusionError('INVALID_REQUEST', 'Enter a prompt.');
+    checkDims(request, spec);
+    // Qwen-Image past one megapixel faults the GPU on Metal instead of failing cleanly.
+    if (spec.backend === 'metal' &&
+        spec.family === 'qwen-image' &&
+        request.width * request.height > 1024 * 1024)
+        throw diffusionError('INVALID_DIMENSIONS', 'Qwen-Image is limited to about one megapixel on Apple GPUs. Choose a smaller resolution.', `${request.width}x${request.height} exceeds the Metal-safe pixel budget`);
+    checkSteps(request.steps, spec);
+    if (request.batchSize < 1 || request.batchSize > MAX_BATCH)
+        throw diffusionError('INVALID_REQUEST', `Batch size must be between 1 and ${MAX_BATCH}.`, `batchSize=${request.batchSize}`);
+    // Each image records `seed + index` as a double; past 2^53 that sum is rounded, and the recorded seed
+    // would no longer reproduce what sd.cpp (64-bit) generated. A negative seed asks for a random one.
+    if (request.seed !== undefined && request.seed >= 0) {
+        const highest = Number.MAX_SAFE_INTEGER - (request.batchSize - 1);
+        if (request.seed > highest)
+            throw diffusionError('INVALID_REQUEST', `The seed must be at most ${highest} for a batch of ${request.batchSize}.`, `seed=${request.seed}`);
+    }
+    if (!Number.isFinite(request.cfgScale) || request.cfgScale < 0)
+        throw diffusionError('INVALID_REQUEST', 'CFG scale must be a non-negative number.');
+    if (request.strength !== undefined && !(request.strength >= 0 && request.strength <= 1))
+        throw diffusionError('INVALID_REQUEST', 'Strength must be between 0 and 1.');
+    const workflow = workflowOf(request);
+    if (workflow === 'create')
+        return;
+    if (spec.family === 'qwen-image-2.1' && usesReferences(workflow) && spec.files.llmVision === undefined)
+        throw diffusionError('SIDE_FILE_MISSING', 'Qwen Image 2.1 editing needs its Qwen3-VL vision projector.', 'Load the model with llmVision so sd.cpp receives --llm_vision.');
+    if (!workflowsForSpec(spec).includes(workflow))
+        throw diffusionError('UNSUPPORTED_WORKFLOW', `This model cannot run the ${workflow} workflow.`, spec.family);
+    // Every workflow but Create starts from one source image; the reference workflows send it as the
+    // first reference.
+    await checkSource(request.initImage, 'a source image', deps);
+    if (usesMask(workflow))
+        await checkSource(request.maskImage, 'a mask', deps);
+    for (const extra of request.referenceImages ?? [])
+        await checkSource(extra, 'a reference image', deps);
+}
+export function isValidFrameCount(frames, rule, range) {
+    const [min, max] = range;
+    if (!Number.isInteger(frames) || frames < min || frames > max)
+        return false;
+    const step = Math.max(rule.step, 1);
+    return frames >= rule.offset && (frames - rule.offset) % step === 0;
+}
+/** The largest valid frame count at most `wanted`; undefined when even the smallest is more. */
+export function largestValidFrames(wanted, rule, range) {
+    const [min, max] = range;
+    const step = Math.max(rule.step, 1);
+    const ceiling = Math.min(Math.floor(wanted), max);
+    if (ceiling < rule.offset)
+        return undefined;
+    const frames = rule.offset + Math.floor((ceiling - rule.offset) / step) * step;
+    return frames >= min ? frames : undefined;
+}
+/** The valid frame count nearest to `wanted`, clamped into the range: what a length in seconds becomes. */
+export function nearestValidFrames(wanted, rule, range) {
+    const [min, max] = range;
+    const step = Math.max(rule.step, 1);
+    const k = Math.round((wanted - rule.offset) / step);
+    const frames = rule.offset + Math.max(k, 0) * step;
+    if (frames < min)
+        return min;
+    if (frames <= max)
+        return frames;
+    // Past the top: the highest lattice point under it.
+    return Math.max(rule.offset + Math.floor((max - rule.offset) / step) * step, min);
+}
+/**
+ * A video request against the loaded video family: the image checks that apply, then the frame count
+ * on the family's lattice, the fixed frame rate, and the one workflow this build serves.
+ */
+export async function validateVideoRequest(request, spec, _deps) {
+    if (request.prompt.trim() === '')
+        throw diffusionError('INVALID_REQUEST', 'Enter a prompt.');
+    const video = spec.defaults.video;
+    const range = spec.ranges.frames;
+    if (video === undefined || range === undefined)
+        throw diffusionError('INTERNAL', 'The loaded model has no video defaults.', spec.modelId);
+    checkDims(request, spec);
+    checkSteps(request.steps, spec);
+    if (!Number.isFinite(request.cfgScale) || request.cfgScale < 0)
+        throw diffusionError('INVALID_REQUEST', 'CFG scale must be a non-negative number.');
+    // One clip per job: the recipe records the seed as is, so only the double's own limit applies.
+    if (request.seed !== undefined && request.seed > Number.MAX_SAFE_INTEGER)
+        throw diffusionError('INVALID_REQUEST', `The seed must be at most ${Number.MAX_SAFE_INTEGER}.`, `seed=${request.seed}`);
+    if (request.fps !== undefined && request.fps !== video.fps)
+        throw diffusionError('INVALID_REQUEST', `This model generates at ${video.fps} fps.`, `fps=${request.fps}`);
+    const frames = request.frames ?? video.frames;
+    if (!isValidFrameCount(frames, { step: video.frameStep, offset: video.frameOffset }, range))
+        throw diffusionError('INVALID_REQUEST', `Frames must be ${video.frameStep}k+${video.frameOffset} between ${range[0]} and ${range[1]}.`, `frames=${frames}`);
+    const workflow = request.workflow ?? 'create';
+    if (!videoWorkflowsForFamily(spec.family).includes(workflow))
+        throw diffusionError('UNSUPPORTED_WORKFLOW', 'Image-to-video is not available yet.', workflow);
+    if (request.initImage !== undefined || request.endImage !== undefined)
+        throw diffusionError('UNSUPPORTED_WORKFLOW', 'Image-to-video is not available yet.', 'initImage/endImage need the image-to-video workflow');
+}
+//# sourceMappingURL=validate.js.map

package/dist/diffusion/validate.js.map

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

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

@@ -0,0 +1,56 @@
+/**
+ * The video gallery on disk: `<videoOutputDir>/<jobId>.webm` with its recipe as `<jobId>.json`
+ * beside it, a `<jobId>.thumb.png` poster once the app rendered one, and the same `.flags.json`
+ * as the image gallery, in its own folder. The core has no video decoder (AGENTS.md rule 8): it
+ * checks the container's magic, writes the bytes as they came, and reads everything it knows about
+ * a clip from the sidecar.
+ *
+ * A `.webm` without a parseable sidecar is somebody else's: it is never listed and never deleted,
+ * even when it sits in the folder under a name that looks like ours.
+ */
+import type { GalleryFlags, GalleryListOptions, GalleryVideoItem, VideoGalleryPage, VideoRecipe } from '../contracts/index.js';
+import type { GalleryLogger } from './gallery.js';
+export declare const VIDEO_SUFFIX = ".webm";
+export declare const POSTER_SUFFIX = ".thumb.png";
+/** The app's poster is a small PNG; anything larger is not one. */
+export declare const MAX_POSTER_BYTES: number;
+/** The EBML header every WebM (and Matroska) file starts with. */
+export declare const WEBM_MAGIC: Buffer<ArrayBuffer>;
+/**
+ * Whether `bytes` are a WebM file: the EBML magic, then a `DocType` of `webm` inside the header.
+ * The only structural check the core can make without a codec; the app's player does the rest.
+ */
+export declare function isWebm(bytes: Buffer): boolean;
+/** The write messages of the video folder, for the atomic writer the image gallery shares. */
+export declare const VIDEO_WRITE_MESSAGES: {
+    write: string;
+    finish: string;
+};
+/** `^[a-f0-9]{32}$`: the job id, which is also the file stem. */
+export declare function isValidVideoId(id: string): boolean;
+export declare function videoPath(dir: string, id: string): string;
+export declare function videoRecipePath(dir: string, id: string): string;
+export declare function videoPosterPath(dir: string, id: string): string;
+/**
+ * The video gallery's operations. Like the image gallery, everything that touches the flags file
+ * goes through one lock; the clips have unique names and need none.
+ */
+export declare class VideoGallery {
+    private readonly log;
+    private readonly flagsLock;
+    constructor(log?: GalleryLogger);
+    /** Write the sidecar, then the clip, and answer the item with the bytes (the facade streams them). */
+    save(dir: string, recipe: VideoRecipe, webm: Buffer): Promise<{
+        item: GalleryVideoItem;
+        bytes: Buffer;
+    }>;
+    /** The poster the app rendered from the first frame: a PNG with a readable header, kept as is. */
+    setPoster(dir: string, id: string, png: Buffer): Promise<GalleryVideoItem>;
+    get(dir: string, id: string): Promise<GalleryVideoItem | null>;
+    list(dir: string, options: GalleryListOptions): Promise<VideoGalleryPage>;
+    /** Remove each clip, its sidecar, its poster and its flags entry. Foreign clips are left alone. */
+    delete(dir: string, ids: readonly string[]): Promise<void>;
+    setFlags(dir: string, id: string, update: GalleryFlags): Promise<GalleryVideoItem>;
+    /** Byte-for-byte copy of the clip; the recipe stays behind with the gallery. */
+    export(dir: string, id: string, target: string): Promise<void>;
+}

package/dist/diffusion/video-gallery.js

@@ -0,0 +1,252 @@
+/**
+ * The video gallery on disk: `<videoOutputDir>/<jobId>.webm` with its recipe as `<jobId>.json`
+ * beside it, a `<jobId>.thumb.png` poster once the app rendered one, and the same `.flags.json`
+ * as the image gallery, in its own folder. The core has no video decoder (AGENTS.md rule 8): it
+ * checks the container's magic, writes the bytes as they came, and reads everything it knows about
+ * a clip from the sidecar.
+ *
+ * A `.webm` without a parseable sidecar is somebody else's: it is never listed and never deleted,
+ * even when it sits in the folder under a name that looks like ours.
+ */
+import { copyFile, mkdir, readdir, readFile, rm, stat } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { isWithin } from './containment.js';
+import { diffusionError, ioError } from './errors.js';
+import { readFlags, writeAtomic, writeFlags } from './gallery.js';
+import { AsyncMutex } from './mutex.js';
+import { isPng, parseHeader } from './png.js';
+import { parseVideoRecipe, RECIPE_SIDECAR_SUFFIX, serializeVideoRecipe } from './video-recipe.js';
+export const VIDEO_SUFFIX = '.webm';
+export const POSTER_SUFFIX = '.thumb.png';
+/** The app's poster is a small PNG; anything larger is not one. */
+export const MAX_POSTER_BYTES = 16 * 1024 * 1024;
+/** How many sidecars a listing reads at once. */
+const SCAN_CONCURRENCY = 16;
+/** The EBML header every WebM (and Matroska) file starts with. */
+export const WEBM_MAGIC = Buffer.from([0x1a, 0x45, 0xdf, 0xa3]);
+/**
+ * Whether `bytes` are a WebM file: the EBML magic, then a `DocType` of `webm` inside the header.
+ * The only structural check the core can make without a codec; the app's player does the rest.
+ */
+export function isWebm(bytes) {
+    if (bytes.length < 8 || !bytes.subarray(0, 4).equals(WEBM_MAGIC))
+        return false;
+    // The header is small; `DocType` (0x4282) carries its size in one byte for `webm`.
+    const window = bytes.subarray(4, Math.min(bytes.length, 256));
+    const at = window.indexOf(Buffer.from([0x42, 0x82]));
+    if (at < 0 || at + 2 >= window.length)
+        return false;
+    const size = window[at + 2];
+    if ((size & 0x80) === 0)
+        return false;
+    const length = size & 0x7f;
+    return window.subarray(at + 3, at + 3 + length).toString('latin1') === 'webm';
+}
+/** The write messages of the video folder, for the atomic writer the image gallery shares. */
+export const VIDEO_WRITE_MESSAGES = {
+    write: 'Could not write to the videos folder.',
+    finish: 'Could not finish writing the video.',
+};
+/** `^[a-f0-9]{32}$`: the job id, which is also the file stem. */
+export function isValidVideoId(id) {
+    return /^[a-f0-9]{32}$/.test(id);
+}
+export function videoPath(dir, id) {
+    return join(dir, `${id}${VIDEO_SUFFIX}`);
+}
+export function videoRecipePath(dir, id) {
+    return join(dir, `${id}${RECIPE_SIDECAR_SUFFIX}`);
+}
+export function videoPosterPath(dir, id) {
+    return join(dir, `${id}${POSTER_SUFFIX}`);
+}
+function checkedVideoPath(dir, id) {
+    if (!isValidVideoId(id))
+        throw diffusionError('INVALID_REQUEST', 'That is not a gallery video id.', id);
+    const path = videoPath(dir, id);
+    if (!isWithin(path, dir))
+        throw diffusionError('INVALID_REQUEST', 'That video is outside the videos folder.', id);
+    return path;
+}
+const isFile = (path) => stat(path).then((s) => s.isFile(), () => false);
+async function readRecipe(dir, id) {
+    const text = await readFile(videoRecipePath(dir, id), 'utf8').catch(() => undefined);
+    return text === undefined ? undefined : parseVideoRecipe(text);
+}
+async function itemFromRecipe(dir, id, path, recipe, flags) {
+    const meta = await stat(path).catch(() => undefined);
+    if (!meta)
+        return undefined;
+    const poster = videoPosterPath(dir, id);
+    const flag = flags.get(id);
+    return {
+        id,
+        path,
+        posterPath: (await isFile(poster)) ? poster : null,
+        width: recipe.width,
+        height: recipe.height,
+        fps: recipe.fps,
+        frameCount: recipe.frameCount,
+        durationSecs: recipe.fps > 0 ? recipe.frameCount / recipe.fps : 0,
+        sizeBytes: meta.size,
+        createdAtMs: recipe.createdAtMs,
+        pinned: flag?.pinned ?? false,
+        archived: flag?.archived ?? false,
+        recipe,
+    };
+}
+async function itemFromPath(dir, id, path, flags) {
+    const recipe = await readRecipe(dir, id);
+    return recipe ? itemFromRecipe(dir, id, path, recipe, flags) : undefined;
+}
+/** Every owned clip, newest first. */
+async function scan(dir, flags) {
+    const names = await readdir(dir).catch(() => []);
+    const ids = names
+        .filter((name) => name.endsWith(VIDEO_SUFFIX))
+        .map((name) => name.slice(0, -VIDEO_SUFFIX.length))
+        .filter(isValidVideoId);
+    const items = [];
+    for (let at = 0; at < ids.length; at += SCAN_CONCURRENCY) {
+        const batch = ids.slice(at, at + SCAN_CONCURRENCY);
+        const found = await Promise.all(batch.map((id) => itemFromPath(dir, id, videoPath(dir, id), flags)));
+        for (const item of found)
+            if (item)
+                items.push(item);
+    }
+    return items.sort((a, b) => b.createdAtMs - a.createdAtMs || (a.id < b.id ? 1 : a.id > b.id ? -1 : 0));
+}
+/**
+ * The video gallery's operations. Like the image gallery, everything that touches the flags file
+ * goes through one lock; the clips have unique names and need none.
+ */
+export class VideoGallery {
+    log;
+    flagsLock = new AsyncMutex();
+    constructor(log = () => { }) {
+        this.log = log;
+    }
+    /** Write the sidecar, then the clip, and answer the item with the bytes (the facade streams them). */
+    async save(dir, recipe, webm) {
+        await mkdir(dir, { recursive: true }).catch((error) => {
+            throw ioError('Could not create the videos folder.', error);
+        });
+        const id = recipe.jobId;
+        const path = checkedVideoPath(dir, id);
+        if (!isWebm(webm))
+            throw diffusionError('INVALID_OUTPUT', 'The video engine returned something that is not a WebM.');
+        // The sidecar first: a clip without one is foreign, so a crash between the two leaves nothing listed.
+        await writeAtomic(videoRecipePath(dir, id), serializeVideoRecipe(recipe), VIDEO_WRITE_MESSAGES);
+        await writeAtomic(path, webm, VIDEO_WRITE_MESSAGES);
+        const flag = (await this.flagsLock.run(() => readFlags(dir))).get(id);
+        return {
+            item: {
+                id,
+                path,
+                posterPath: null,
+                width: recipe.width,
+                height: recipe.height,
+                fps: recipe.fps,
+                frameCount: recipe.frameCount,
+                durationSecs: recipe.fps > 0 ? recipe.frameCount / recipe.fps : 0,
+                sizeBytes: webm.length,
+                createdAtMs: recipe.createdAtMs,
+                pinned: flag?.pinned ?? false,
+                archived: flag?.archived ?? false,
+                recipe,
+            },
+            bytes: webm,
+        };
+    }
+    /** The poster the app rendered from the first frame: a PNG with a readable header, kept as is. */
+    async setPoster(dir, id, png) {
+        const path = checkedVideoPath(dir, id);
+        if (!(await isFile(path)) || (await readRecipe(dir, id)) === undefined)
+            throw diffusionError('JOB_NOT_FOUND', 'That video is no longer in the gallery.');
+        if (png.length > MAX_POSTER_BYTES)
+            throw diffusionError('INVALID_REQUEST', 'The poster is too large.', `${png.length} bytes`);
+        const header = isPng(png) ? parseHeader(png) : 'not-png';
+        if (header === 'not-png' || header.header === undefined)
+            throw diffusionError('INVALID_REQUEST', 'The poster is not a PNG.');
+        await writeAtomic(videoPosterPath(dir, id), png, VIDEO_WRITE_MESSAGES);
+        const flags = await this.flagsLock.run(() => readFlags(dir));
+        const item = await itemFromPath(dir, id, path, flags);
+        if (!item)
+            throw diffusionError('JOB_NOT_FOUND', 'That video is no longer in the gallery.');
+        return item;
+    }
+    async get(dir, id) {
+        const path = checkedVideoPath(dir, id);
+        if (!(await isFile(path)))
+            return null;
+        const flags = await this.flagsLock.run(() => readFlags(dir));
+        return (await itemFromPath(dir, id, path, flags)) ?? null;
+    }
+    async list(dir, options) {
+        const flags = await this.flagsLock.run(() => readFlags(dir));
+        const all = (await scan(dir, flags)).filter((item) => options.includeArchived === true || !item.archived);
+        const items = all.slice(options.offset, options.offset + Math.max(options.limit, 1));
+        return { items, hasMore: options.offset + items.length < all.length, total: all.length };
+    }
+    /** Remove each clip, its sidecar, its poster and its flags entry. Foreign clips are left alone. */
+    delete(dir, ids) {
+        return this.flagsLock.run(async () => {
+            const flags = await readFlags(dir);
+            let changed = false;
+            for (const id of ids) {
+                const path = checkedVideoPath(dir, id);
+                if (await isFile(path)) {
+                    if ((await readRecipe(dir, id)) === undefined) {
+                        this.log('warn', `refusing to delete foreign video ${id}`);
+                        continue;
+                    }
+                    await rm(path).catch((error) => {
+                        throw ioError('Could not delete the video.', error);
+                    });
+                }
+                await rm(videoRecipePath(dir, id), { force: true }).catch(() => { });
+                await rm(videoPosterPath(dir, id), { force: true }).catch(() => { });
+                if (flags.delete(id))
+                    changed = true;
+            }
+            if (changed)
+                await writeFlags(dir, flags);
+        });
+    }
+    setFlags(dir, id, update) {
+        return this.flagsLock.run(async () => {
+            const path = checkedVideoPath(dir, id);
+            if (!(await isFile(path)))
+                throw diffusionError('JOB_NOT_FOUND', 'That video is no longer in the gallery.');
+            const flags = await readFlags(dir);
+            const entry = { ...(flags.get(id) ?? { pinned: false, archived: false }) };
+            if (update.pinned !== undefined)
+                entry.pinned = update.pinned;
+            if (update.archived !== undefined)
+                entry.archived = update.archived;
+            // An entry with nothing set is not worth a line in the file.
+            if (entry.pinned || entry.archived)
+                flags.set(id, entry);
+            else
+                flags.delete(id);
+            await writeFlags(dir, flags);
+            const item = await itemFromPath(dir, id, path, flags);
+            if (!item)
+                throw diffusionError('JOB_NOT_FOUND', 'That video is not an Atomic Chat gallery video.');
+            return item;
+        });
+    }
+    /** Byte-for-byte copy of the clip; the recipe stays behind with the gallery. */
+    async export(dir, id, target) {
+        const path = checkedVideoPath(dir, id);
+        if (!(await isFile(path)))
+            throw diffusionError('JOB_NOT_FOUND', 'That video is no longer in the gallery.');
+        await mkdir(dirname(target), { recursive: true }).catch((error) => {
+            throw ioError('Could not create the destination folder.', error);
+        });
+        await copyFile(path, target).catch((error) => {
+            throw ioError('Could not export the video.', error);
+        });
+    }
+}
+//# sourceMappingURL=video-gallery.js.map

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

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