@atomic-chat/core 0.5.1

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

@@ -0,0 +1,33 @@
+/**
+ * The video side of the job runner: what a video job validates, sends to `vid_gen`, decodes and
+ * 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 { JobDeps } from './jobs.js';
+import type { ResolvedInputs, ServerCapabilities } from './types.js';
+/** What a completed `vid_gen` job carries once decoded. */
+export interface DecodedVideo {
+    bytes: Buffer;
+    fps: number;
+    frameCount: number;
+    outputFormat: string;
+    mimeType: string;
+}
+/** The first and last frames as the base64 `sd-server` takes; nothing is read for text-to-video. */
+export declare function resolveVideoInputs(request: VideoGenerateRequest, deps: Pick<JobDeps, 'readSource'>): Promise<ResolvedInputs>;
+/** The request as the job record carries it: file paths stay, inline bytes are blanked. */
+export declare function withoutVideoSources(request: VideoGenerateRequest): VideoGenerateRequest;
+/** The clip of a completed job: `result.b64_json` in the container the request asked for. */
+export declare function decodeVideo(job: Record<string, unknown>): DecodedVideo;
+/** Refuse anything that is not a WebM, then write the clip and its sidecar into the video gallery. */
+export declare function saveVideoOutput(deps: JobDeps, ctx: SaveContext<VideoGenerateRequest>, decoded: DecodedVideo): Promise<{
+    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;
+/** 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>;

package/dist/diffusion/video-job.js

@@ -0,0 +1,150 @@
+/**
+ * The video side of the job runner: what a video job validates, sends to `vid_gen`, decodes and
+ * 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 { basename } from 'node:path';
+import { buildVidGenRequest } from './args.js';
+import { diffusionError, internalError } from './errors.js';
+import { redactSource, resolveSource } from './image-job.js';
+import { validateVideoRequest } from './validate.js';
+import { isWebm } from './video-gallery.js';
+/** 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: [] };
+    if ((request.workflow ?? 'create') !== 'image-to-video')
+        return inputs;
+    if (request.initImage !== undefined)
+        inputs.init = await resolveSource(request.initImage, deps);
+    if (request.endImage !== undefined)
+        inputs.end = await resolveSource(request.endImage, deps);
+    return inputs;
+}
+/** The request as the job record carries it: file paths stay, inline bytes are blanked. */
+export function withoutVideoSources(request) {
+    const copy = { ...request };
+    if (request.initImage)
+        copy.initImage = redactSource(request.initImage);
+    if (request.endImage)
+        copy.endImage = redactSource(request.endImage);
+    return copy;
+}
+/** The clip of a completed job: `result.b64_json` in the container the request asked for. */
+export function decodeVideo(job) {
+    const result = job['result'];
+    const fields = result !== null && typeof result === 'object' ? result : {};
+    const b64 = fields['b64_json'];
+    if (typeof b64 !== 'string' || b64.trim() === '')
+        throw internalError('The video server completed the job but returned no video.');
+    const outputFormat = typeof fields['output_format'] === 'string' ? fields['output_format'] : 'webm';
+    if (outputFormat !== 'webm')
+        throw internalError('The video server returned a video in an unexpected format.', outputFormat);
+    const bytes = Buffer.from(b64.trim(), 'base64');
+    if (bytes.length === 0)
+        throw internalError('sd-server returned an undecodable video.');
+    const fps = fields['fps'];
+    const frameCount = fields['frame_count'];
+    return {
+        bytes,
+        fps: typeof fps === 'number' && Number.isInteger(fps) && fps > 0 ? fps : 0,
+        frameCount: typeof frameCount === 'number' && Number.isInteger(frameCount) && frameCount > 0 ? frameCount : 0,
+        outputFormat,
+        mimeType: typeof fields['mime_type'] === 'string' ? fields['mime_type'] : 'video/webm',
+    };
+}
+/** 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;
+    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 recipe = {
+        jobId: id,
+        prompt: request.prompt,
+        negativePrompt: request.negativePrompt ? request.negativePrompt : null,
+        width: request.width,
+        height: request.height,
+        frames,
+        // What the engine wrote, after its own normalisation; the requested count is `frames`.
+        frameCount: decoded.frameCount > 0 ? decoded.frameCount : frames,
+        fps: decoded.fps > 0 ? decoded.fps : fps,
+        steps: request.steps,
+        cfgScale: request.cfgScale,
+        guidance: request.guidance ?? spec.defaults.guidance ?? null,
+        seed,
+        samplingMethod: request.samplingMethod ?? spec.defaults.samplingMethod ?? null,
+        flowShift: request.flowShift ?? spec.defaults.flowShift ?? null,
+        workflow: request.workflow ?? 'create',
+        outputFormat: 'webm',
+        model: {
+            modelId: spec.modelId,
+            family: spec.family,
+            displayName: spec.displayName,
+            filename: basename(spec.files.diffusionModel),
+        },
+        engine: {
+            kind: spec.engine,
+            backend: spec.backend,
+            tag: spec.tag,
+            offload: spec.offload,
+            cpuFallback: spec.cpuFallback,
+        },
+        createdAtMs,
+        durationMs: Math.max(createdAtMs - startedAt, 0),
+    };
+    const saved = await deps.videoGallery.save(deps.state.videoOutputDir(), recipe, decoded.bytes);
+    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,
+    };
+}
+/** A build without libwebm cannot write the one container the app plays; say so before submitting. */
+export function checkWebmSupport(capabilities) {
+    const formats = capabilities?.vidGen?.outputFormats;
+    if (formats !== undefined && !formats.includes('webm'))
+        throw diffusionError('UNSUPPORTED_BACKEND', 'This engine build was made without WebM support.', `output formats: ${formats.join(', ') || 'none'}`);
+}
+export const VIDEO_JOB_KIND = {
+    id: 'video',
+    modality: 'video',
+    submitPath: '/sdcpp/v1/vid_gen',
+    messages: {
+        busy: 'A video is already being generated.',
+        wrongModel: 'The loaded model generates images, not video. Load a video model first.',
+        outOfMemory: 'sd-server ran out of memory while generating the clip: a clip this long at this size does not fit. Fewer frames or a smaller size will.',
+        failed: 'The video server failed to generate.',
+    },
+    validate: (request, spec, deps) => validateVideoRequest(request, spec, deps),
+    newJob: (id, spec, request, now) => ({
+        id,
+        state: 'queued',
+        modelId: spec.modelId,
+        request: withoutVideoSources(request),
+        createdAtMs: now,
+        progress: null,
+        outputs: [],
+    }),
+    resolveInputs: resolveVideoInputs,
+    buildBody: (request, spec, seed, inputs) => buildVidGenRequest(request, spec.defaults, seed, inputs),
+    trackerShape: (request) => ({ steps: Math.max(request.steps, 1), batch: 1 }),
+    progress: videoProgress,
+    emitJob: (emit, job) => emit('diffusion:video-job', { job }),
+    emitProgress: (emit, jobId, progress) => emit('diffusion:video-progress', { jobId, progress }),
+    cancelGenerating: (capabilities) => capabilities.vidGen?.cancelGenerating ?? false,
+    preflight: checkWebmSupport,
+    decode: decodeVideo,
+    save: saveVideoOutput,
+};
+//# sourceMappingURL=video-job.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * The generation recipe of a video, written as `<jobId>.json` beside the clip (WebM has no text
+ * chunk to carry it). Exactly `VideoRecipe`, every key present and absent values `null`, in the
+ * order of `ImageRecipe`'s sibling, so a clip copied anywhere can be reproduced. The parser is as
+ * strict as `parseRecipe`, because it decides whether a `.webm` in the folder is ours.
+ */
+import type { VideoRecipe } from '../contracts/index.js';
+export declare const RECIPE_SIDECAR_SUFFIX = ".json";
+/** The sidecar's text: every key, fixed order, `null`s, two-space indent like the flags file. */
+export declare function serializeVideoRecipe(recipe: VideoRecipe): string;
+/** The recipe out of a sidecar, or `undefined` when the text is not one. */
+export declare function parseVideoRecipe(text: string): VideoRecipe | undefined;

package/dist/diffusion/video-recipe.js

@@ -0,0 +1,141 @@
+/**
+ * The generation recipe of a video, written as `<jobId>.json` beside the clip (WebM has no text
+ * chunk to carry it). Exactly `VideoRecipe`, every key present and absent values `null`, in the
+ * order of `ImageRecipe`'s sibling, so a clip copied anywhere can be reproduced. The parser is as
+ * strict as `parseRecipe`, because it decides whether a `.webm` in the folder is ours.
+ */
+import { VIDEO_WORKFLOWS } from './workflow.js';
+export const RECIPE_SIDECAR_SUFFIX = '.json';
+const ENGINES = ['sd-cpp', 'diffusers'];
+const BACKENDS = ['cpu', 'metal', 'cuda', 'vulkan', 'rocm'];
+const OFFLOADS = ['none', 'group', 'model'];
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const isWhole = (value) => typeof value === 'number' && Number.isInteger(value) && value >= 0;
+/** Seeds as `parseRecipe` takes them: an `i64` as a double sees it. */
+const isI64 = (value) => typeof value === 'number' && Number.isInteger(value) && Math.abs(value) <= 2 ** 63;
+const isNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+const isString = (value) => typeof value === 'string';
+const among = (value, allowed) => isString(value) && allowed.includes(value);
+/** `value` when it passes, `null` when it is absent or `null`, `undefined` (a failure) otherwise. */
+function optional(value, check) {
+    if (value === undefined || value === null)
+        return null;
+    return check(value) ? value : undefined;
+}
+/** The sidecar's text: every key, fixed order, `null`s, two-space indent like the flags file. */
+export function serializeVideoRecipe(recipe) {
+    const ordered = {
+        jobId: recipe.jobId,
+        prompt: recipe.prompt,
+        negativePrompt: recipe.negativePrompt,
+        width: recipe.width,
+        height: recipe.height,
+        frames: recipe.frames,
+        frameCount: recipe.frameCount,
+        fps: recipe.fps,
+        steps: recipe.steps,
+        cfgScale: recipe.cfgScale,
+        guidance: recipe.guidance,
+        seed: recipe.seed,
+        samplingMethod: recipe.samplingMethod,
+        flowShift: recipe.flowShift,
+        workflow: recipe.workflow,
+        outputFormat: recipe.outputFormat,
+        model: {
+            modelId: recipe.model.modelId,
+            family: recipe.model.family,
+            displayName: recipe.model.displayName,
+            filename: recipe.model.filename,
+        },
+        engine: {
+            kind: recipe.engine.kind,
+            backend: recipe.engine.backend,
+            tag: recipe.engine.tag,
+            offload: recipe.engine.offload,
+            cpuFallback: recipe.engine.cpuFallback,
+        },
+        createdAtMs: recipe.createdAtMs,
+        durationMs: recipe.durationMs,
+    };
+    return `${JSON.stringify(ordered, null, 2)}\n`;
+}
+/** The recipe out of a sidecar, or `undefined` when the text is not one. */
+export function parseVideoRecipe(text) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isObject(raw) || !isObject(raw['model']) || !isObject(raw['engine']))
+        return undefined;
+    const { model, engine } = raw;
+    const negativePrompt = optional(raw['negativePrompt'], isString);
+    const guidance = optional(raw['guidance'], isNumber);
+    const samplingMethod = optional(raw['samplingMethod'], isString);
+    const flowShift = optional(raw['flowShift'], isNumber);
+    const ok = isString(raw['jobId']) &&
+        isString(raw['prompt']) &&
+        isWhole(raw['width']) &&
+        isWhole(raw['height']) &&
+        isWhole(raw['frames']) &&
+        isWhole(raw['frameCount']) &&
+        isWhole(raw['fps']) &&
+        isWhole(raw['steps']) &&
+        isNumber(raw['cfgScale']) &&
+        isI64(raw['seed']) &&
+        among(raw['workflow'], VIDEO_WORKFLOWS) &&
+        raw['outputFormat'] === 'webm' &&
+        isString(model['modelId']) &&
+        isString(model['family']) &&
+        isString(model['displayName']) &&
+        isString(model['filename']) &&
+        among(engine['kind'], ENGINES) &&
+        among(engine['backend'], BACKENDS) &&
+        isString(engine['tag']) &&
+        among(engine['offload'], OFFLOADS) &&
+        typeof engine['cpuFallback'] === 'boolean' &&
+        isWhole(raw['createdAtMs']) &&
+        isWhole(raw['durationMs']) &&
+        negativePrompt !== undefined &&
+        guidance !== undefined &&
+        samplingMethod !== undefined &&
+        flowShift !== undefined;
+    if (!ok)
+        return undefined;
+    return {
+        jobId: raw['jobId'],
+        prompt: raw['prompt'],
+        negativePrompt,
+        width: raw['width'],
+        height: raw['height'],
+        frames: raw['frames'],
+        frameCount: raw['frameCount'],
+        fps: raw['fps'],
+        steps: raw['steps'],
+        cfgScale: raw['cfgScale'],
+        guidance,
+        seed: raw['seed'],
+        samplingMethod,
+        flowShift,
+        workflow: raw['workflow'],
+        outputFormat: 'webm',
+        model: {
+            modelId: model['modelId'],
+            family: model['family'],
+            displayName: model['displayName'],
+            filename: model['filename'],
+        },
+        engine: {
+            kind: engine['kind'],
+            backend: engine['backend'],
+            tag: engine['tag'],
+            offload: engine['offload'],
+            cpuFallback: engine['cpuFallback'],
+        },
+        createdAtMs: raw['createdAtMs'],
+        durationMs: raw['durationMs'],
+    };
+}
+//# sourceMappingURL=video-recipe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-recipe.js","sourceRoot":"","sources":["../../src/diffusion/video-recipe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAA;AAI5C,MAAM,OAAO,GAAiC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;AACrE,MAAM,QAAQ,GAAgC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AACxF,MAAM,QAAQ,GAAsC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAE9E,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CACnD,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AACtE,MAAM,OAAO,GAAG,CAAC,KAAc,EAAmB,EAAE,CAClD,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AACpE,uEAAuE;AACvE,MAAM,KAAK,GAAG,CAAC,KAAc,EAAmB,EAAE,CAChD,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;AACpF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACzG,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAA;AAC/E,MAAM,KAAK,GAAG,CAAmB,KAAc,EAAE,OAAqB,EAAc,EAAE,CACpF,QAAQ,CAAC,KAAK,CAAC,IAAK,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAEnE,qGAAqG;AACrG,SAAS,QAAQ,CAAI,KAAc,EAAE,KAA6B;IAChE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACtD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACzC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,MAAM,OAAO,GAAgB;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE;YACL,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;YAC7B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;YAC3B,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;YACrC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;SAChC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;YACxB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;YAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG;YACtB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;YAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW;SACvC;QACD,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAA;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AAChD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,GAAY,CAAA;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3F,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IAC7B,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAA;IAChE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAA;IACpD,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAA;IAChE,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAA;IACtD,MAAM,EAAE,GACN,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtB,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClB,KAAK,CAAkB,GAAG,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;QACxD,GAAG,CAAC,cAAc,CAAC,KAAK,MAAM;QAC9B,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1B,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzB,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9B,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAC9B,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;QAClC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;QAClC,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,SAAS;QAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,cAAc,KAAK,SAAS;QAC5B,QAAQ,KAAK,SAAS;QACtB,cAAc,KAAK,SAAS;QAC5B,SAAS,KAAK,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAA;IACzB,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,OAAO,CAAW;QAC7B,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAW;QAC/B,cAAc;QACd,KAAK,EAAE,GAAG,CAAC,OAAO,CAAW;QAC7B,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAW;QAC/B,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAW;QAC/B,UAAU,EAAE,GAAG,CAAC,YAAY,CAAW;QACvC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAW;QACzB,KAAK,EAAE,GAAG,CAAC,OAAO,CAAW;QAC7B,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAW;QACnC,QAAQ;QACR,IAAI,EAAE,GAAG,CAAC,MAAM,CAAW;QAC3B,cAAc;QACd,SAAS;QACT,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAoB;QAC5C,YAAY,EAAE,MAAM;QACpB,KAAK,EAAE;YACL,OAAO,EAAE,KAAK,CAAC,SAAS,CAAW;YACnC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAW;YACjC,WAAW,EAAE,KAAK,CAAC,aAAa,CAAW;YAC3C,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAW;SACtC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,CAAC,MAAM,CAAsB;YACzC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAqB;YAC9C,GAAG,EAAE,MAAM,CAAC,KAAK,CAAW;YAC5B,OAAO,EAAE,MAAM,CAAC,SAAS,CAA2B;YACpD,WAAW,EAAE,MAAM,CAAC,aAAa,CAAY;SAC9C;QACD,WAAW,EAAE,GAAG,CAAC,aAAa,CAAW;QACzC,UAAU,EAAE,GAAG,CAAC,YAAY,CAAW;KACxC,CAAA;AACH,CAAC"}

package/dist/diffusion/wiring.d.ts

@@ -0,0 +1,24 @@
+/**
+ * How the owner builds the image-generation service: the child journal adapter (an `sd-server` is
+ * journalled like any backend, under `provider: 'diffusion'`, right after it spawns) and the event
+ * 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 { ProcessJournal } from '../lock/index.js';
+import { DiffusionService } from './service.js';
+import type { DiffusionServiceDeps } from './service.js';
+export interface WireDiffusionOptions {
+    layout: DataLayout;
+    journal: Pick<ProcessJournal, 'add' | 'remove'>;
+    instanceId: string;
+    emit: <K extends keyof CoreEvents>(name: K, payload: CoreEvents[K]) => void;
+    log: (level: 'info' | 'warn' | 'debug', msg: string) => void;
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    /** 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']>;
+export declare function wireDiffusion(options: WireDiffusionOptions): DiffusionService;

package/dist/diffusion/wiring.js

@@ -0,0 +1,38 @@
+/**
+ * How the owner builds the image-generation service: the child journal adapter (an `sd-server` is
+ * journalled like any backend, under `provider: 'diffusion'`, right after it spawns) and the event
+ * bus. Kept out of `create.ts`, which stays a list of `await`s.
+ */
+import { processStartId } from '../lock/index.js';
+import { DiffusionService } from './service.js';
+/** The journal entry an `sd-server` gets the moment it starts, so a crashed owner's successor can reap it. */
+export function diffusionJournal(journal, instanceId, now = Date.now) {
+    return {
+        add: async (pid, port, exe, modelId) => journal.add({
+            instance_id: instanceId,
+            pid,
+            process_start_id: (await processStartId(pid)) ?? null,
+            exe,
+            provider: 'diffusion',
+            model_id: modelId,
+            port,
+            started_at: new Date(now()).toISOString(),
+        }),
+        remove: (pid) => journal.remove(pid),
+    };
+}
+export function wireDiffusion(options) {
+    const service = new DiffusionService({
+        paths: options.layout.diffusion,
+        dataFolder: options.layout.root,
+        emit: options.emit,
+        log: options.log,
+        journal: diffusionJournal(options.journal, options.instanceId),
+        ...(options.platform ? { platform: options.platform } : {}),
+        ...(options.env ? { env: options.env } : {}),
+        ...options.overrides,
+    });
+    service.start();
+    return service;
+}
+//# sourceMappingURL=wiring.js.map

package/dist/diffusion/wiring.js.map

@@ -0,0 +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"}

package/dist/diffusion/workflow.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What each workflow sends to `img_gen`, and which model family can run which. `ImageWorkflow` in
+ * `state.rs` and `workflows_for_family` / `workflows_for_spec` in `session.rs` (app commit
+ * `ec1fd3ea7`).
+ */
+import type { ImageGenerateRequest, ImageWorkflowId, VideoWorkflowId } from '../contracts/index.js';
+import type { ServerSpec } from './types.js';
+export declare const IMAGE_WORKFLOWS: readonly ImageWorkflowId[];
+export declare function workflowOf(request: Pick<ImageGenerateRequest, 'workflow'>): ImageWorkflowId;
+/** Workflows that send an `init_image`, and therefore a `strength`. */
+export declare function usesInitImage(workflow: ImageWorkflowId): boolean;
+export declare function usesMask(workflow: ImageWorkflowId): boolean;
+/** Workflows that send `ref_images` instead of an init image. */
+export declare function usesReferences(workflow: ImageWorkflowId): boolean;
+/**
+ * The denoise strength when the request leaves it unset. `extend` repaints its blank border fully;
+ * `upscale` is a re-detail pass that keeps most of the enlarged source.
+ */
+export declare function defaultStrength(workflow: ImageWorkflowId): number;
+/**
+ * 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.
+ */
+export declare function workflowsForFamily(family: string): ImageWorkflowId[];
+/** The workflows the loaded server can actually run: Qwen Image 2.1 without `llmVision` only creates. */
+export declare function workflowsForSpec(spec: Pick<ServerSpec, 'family' | 'files'>): ImageWorkflowId[];
+/** The video workflows on the wire; `image-to-video` is parsed and recorded but not served yet. */
+export declare const VIDEO_WORKFLOWS: readonly VideoWorkflowId[];
+/** What a video family can run in this build: text-to-video, whatever the family. */
+export declare function videoWorkflowsForFamily(_family: string): VideoWorkflowId[];

package/dist/diffusion/workflow.js

@@ -0,0 +1,78 @@
+/**
+ * What each workflow sends to `img_gen`, and which model family can run which. `ImageWorkflow` in
+ * `state.rs` and `workflows_for_family` / `workflows_for_spec` in `session.rs` (app commit
+ * `ec1fd3ea7`).
+ */
+export const IMAGE_WORKFLOWS = [
+    'create',
+    'transform',
+    'inpaint',
+    'extend',
+    'upscale',
+    'reference',
+    'edit',
+];
+export function workflowOf(request) {
+    return request.workflow ?? 'create';
+}
+/** Workflows that send an `init_image`, and therefore a `strength`. */
+export function usesInitImage(workflow) {
+    return workflow === 'transform' || workflow === 'inpaint' || workflow === 'extend' || workflow === 'upscale';
+}
+export function usesMask(workflow) {
+    return workflow === 'inpaint' || workflow === 'extend';
+}
+/** Workflows that send `ref_images` instead of an init image. */
+export function usesReferences(workflow) {
+    return workflow === 'reference' || workflow === 'edit';
+}
+/**
+ * The denoise strength when the request leaves it unset. `extend` repaints its blank border fully;
+ * `upscale` is a re-detail pass that keeps most of the enlarged source.
+ */
+export function defaultStrength(workflow) {
+    if (workflow === 'extend')
+        return 1.0;
+    if (workflow === 'upscale')
+        return 0.35;
+    return 0.75;
+}
+/**
+ * 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.
+ */
+export function workflowsForFamily(family) {
+    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':
+        case 'qwen-image':
+            return ['create', 'transform', 'inpaint', 'extend', 'upscale'];
+        default:
+            // flux.1 and its variants: flux.1-uncensored, -abliterated, -nsfw-realism, -krea.
+            if (family.startsWith('flux.1'))
+                return ['create', 'transform', 'inpaint', 'extend', 'upscale'];
+            return ['create'];
+    }
+}
+/** 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)
+        return workflows.filter((workflow) => !usesReferences(workflow));
+    return workflows;
+}
+/** The video workflows on the wire; `image-to-video` is parsed and recorded but not served yet. */
+export const VIDEO_WORKFLOWS = ['create', 'image-to-video'];
+/** What a video family can run in this build: text-to-video, whatever the family. */
+export function videoWorkflowsForFamily(_family) {
+    return ['create'];
+}
+//# sourceMappingURL=workflow.js.map

package/dist/diffusion/workflow.js.map

@@ -0,0 +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"}

package/dist/downloads/archive.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Archive extraction and backend-pack layout normalisation. Port of `decompress` and
+ * `normalize_backend_layout` in `src-tauri/src/core/filesystem/commands.rs`.
+ *
+ * Only `.tar.gz` and `.zip` are supported (same error text as the app). Zip entries are guarded
+ * against zip-slip, directory entries are created, and the unix mode bits are applied.
+ */
+export declare const UNSUPPORTED_ARCHIVE_MESSAGE = "Unsupported file format. Only .tar.gz and .zip are supported.";
+export declare function extractArchive(archivePath: string, outputDir: string): Promise<void>;
+/**
+ * Ensure `<outputDir>/build/bin/<exe>` exists after extraction: a flat archive (exe at the root) is
+ * moved into `build/bin/` (except `build`, `version.txt`, `backend.txt`); a single nested `llama-*`
+ * directory holding the exe is unpacked into `build/bin/` and removed.
+ */
+export declare function normalizeBackendLayout(outputDir: string, exeName: string): Promise<void>;