@atomic-chat/core 0.13.2 → 0.17.0

package/dist/media/http.d.ts

@@ -0,0 +1,125 @@
+/**
+ * How every media adapter talks to a provider: the request context, the provider's own headers, one
+ * call shape that turns a non-2xx answer into a `REMOTE_*` error, and the download of a file a
+ * provider pointed at. Two rules hold for every adapter:
+ *
+ * - every request to the provider goes to a URL derived from the registered `base_url` in code; the
+ *   catalog never names a host, so it can never send a key anywhere new;
+ * - a file the provider points at is fetched with the provider's key and custom headers only on the
+ *   provider's own origin; anywhere else it goes bare, and only over https.
+ */
+import type { AtomicCoreError } from '../contracts/index.js';
+import type { DiffusionErrorCode } from '../contracts/index.js';
+/** A generated image larger than this is not one. */
+export declare const MAX_IMAGE_BYTES: number;
+/** A clip larger than this is refused rather than held in memory. */
+export declare const MAX_VIDEO_BYTES: number;
+/** A generation call that answers with the result (images): the slowest providers take minutes. */
+export declare const GENERATE_TIMEOUT_MS: number;
+/** Listing, submitting and polling. */
+export declare const SHORT_TIMEOUT_MS = 60000;
+/** Redirects a download may follow. */
+export declare const MAX_REDIRECTS = 5;
+export type MediaLog = (level: 'info' | 'warn' | 'debug', message: string) => void;
+/** What every adapter call gets: who the provider is, how to reach it, and when to stop. */
+export interface MediaContext {
+    provider: string;
+    /** The registered base URL without a trailing slash, e.g. `https://api.openai.com/v1`. */
+    baseUrl: string;
+    apiKey: string | null;
+    customHeaders: ReadonlyArray<{
+        header: string;
+        value: string;
+    }>;
+    /** Fires when the job is cancelled; every request and wait of the call stops with it. */
+    signal: AbortSignal;
+    fetch: typeof fetch;
+    now: () => number;
+    /** Waits `ms`, or rejects with `CANCELLED` when `signal` fires first. */
+    sleep: (ms: number) => Promise<void>;
+    log: MediaLog;
+}
+/** How a provider takes its key: `Authorization: Bearer`, Google's `x-goog-api-key`, or not at all. */
+export type AuthStyle = 'bearer' | 'goog' | 'none';
+export declare function remoteError(code: DiffusionErrorCode, message: string, details?: string): AtomicCoreError;
+/** The base URL without a trailing slash, joined to `path` (which starts with `/`). */
+export declare function joinUrl(base: string, path: string): string;
+/** `scheme://host[:port]` of an absolute URL, or `undefined` when it is not one. */
+export declare function originOf(url: string): string | undefined;
+/** The headers of a request to the provider itself: its custom headers, then its key. */
+export declare function providerHeaders(ctx: Pick<MediaContext, 'apiKey' | 'customHeaders'>, auth?: AuthStyle, extra?: Record<string, string>): Headers;
+/** The provider's own words out of an error body, whatever shape it uses. */
+export declare function providerMessage(body: unknown, text?: string): string | undefined;
+/** A provider's non-2xx answer as the closest `REMOTE_*` code, with its words in the message. */
+export declare function remoteHttpError(provider: string, status: number, body: unknown, text?: string): AtomicCoreError;
+/** A request that never got an answer: cancelled, timed out, or the provider unreachable. */
+export declare function networkError(ctx: Pick<MediaContext, 'provider' | 'signal'>, error: unknown): AtomicCoreError;
+export interface CallOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** A JSON body. */
+    json?: unknown;
+    /** A multipart body; the boundary is set by `fetch`. */
+    form?: FormData;
+    auth?: AuthStyle;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    /** Statuses outside 2xx answered as they are instead of thrown (a 202 poll, a 404 that means "gone"). */
+    accept?: readonly number[];
+}
+export interface CallAnswer {
+    status: number;
+    headers: Headers;
+    text: string;
+    /** The body as JSON, or `undefined` when it is not JSON. */
+    json: unknown;
+}
+/**
+ * One request to the provider. A 2xx (or a status in `accept`) is answered; anything else is thrown
+ * as a `REMOTE_*` error carrying the provider's words.
+ */
+export declare function callProvider(ctx: MediaContext, url: string, options?: CallOptions): Promise<CallAnswer>;
+export interface DownloadOptions {
+    maxBytes: number;
+    /** How the key goes along when the file is on the provider's own origin. */
+    auth?: AuthStyle;
+    timeoutMs?: number;
+    /** What the file is, for messages: `image`, `video`. */
+    what?: string;
+}
+/**
+ * Fetch a file the provider pointed at. Redirects are followed by hand so the key never follows one
+ * off the provider's origin; a URL off that origin must be https.
+ */
+export declare function downloadResult(ctx: MediaContext, url: string, options: DownloadOptions): Promise<{
+    bytes: Buffer;
+    mime: string;
+}>;
+/** What the first bytes of an image say it is. */
+export declare function sniffImageMime(bytes: Buffer): string | undefined;
+/** What the first bytes of a clip say it is. */
+export declare function sniffVideoMime(bytes: Buffer): string | undefined;
+/** Base64 or a data URL as bytes and the type the bytes themselves say. */
+export declare function decodeBase64Image(payload: string, what?: string): {
+    bytes: Buffer;
+    mime: string;
+};
+export declare function toDataUrl(bytes: Buffer, mime: string): string;
+/** `'1024x768'` → its dimensions; anything else (`auto`, a tier) → `undefined`. */
+export declare function parseWxH(size: string | undefined): {
+    width: number;
+    height: number;
+} | undefined;
+export interface PollOptions {
+    /** The first wait, and the wait between attempts until backoff grows it. */
+    intervalMs: number;
+    /** The wait never grows past this. */
+    maxIntervalMs?: number;
+    /** Give up with `REMOTE_TIMEOUT` after this long. */
+    timeoutMs: number;
+}
+/**
+ * Ask `step` until it answers something, waiting in between (growing by half each time up to
+ * `maxIntervalMs`). Stops with `CANCELLED` when the job is cancelled, `REMOTE_TIMEOUT` past
+ * `timeoutMs`. For adapters whose image API is a job to poll.
+ */
+export declare function pollUntil<T>(ctx: MediaContext, step: () => Promise<T | undefined>, options: PollOptions): Promise<T>;

package/dist/media/http.js

@@ -0,0 +1,308 @@
+/**
+ * How every media adapter talks to a provider: the request context, the provider's own headers, one
+ * call shape that turns a non-2xx answer into a `REMOTE_*` error, and the download of a file a
+ * provider pointed at. Two rules hold for every adapter:
+ *
+ * - every request to the provider goes to a URL derived from the registered `base_url` in code; the
+ *   catalog never names a host, so it can never send a key anywhere new;
+ * - a file the provider points at is fetched with the provider's key and custom headers only on the
+ *   provider's own origin; anywhere else it goes bare, and only over https.
+ */
+import { diffusionError } from '../diffusion/index.js';
+/** A generated image larger than this is not one. */
+export const MAX_IMAGE_BYTES = 64 * 1024 * 1024;
+/** A clip larger than this is refused rather than held in memory. */
+export const MAX_VIDEO_BYTES = 1024 * 1024 * 1024;
+/** A generation call that answers with the result (images): the slowest providers take minutes. */
+export const GENERATE_TIMEOUT_MS = 10 * 60_000;
+/** Listing, submitting and polling. */
+export const SHORT_TIMEOUT_MS = 60_000;
+/** Redirects a download may follow. */
+export const MAX_REDIRECTS = 5;
+export function remoteError(code, message, details) {
+    return diffusionError(code, message, details);
+}
+/** The base URL without a trailing slash, joined to `path` (which starts with `/`). */
+export function joinUrl(base, path) {
+    return `${base.replace(/\/+$/, '')}${path.startsWith('/') ? path : `/${path}`}`;
+}
+/** `scheme://host[:port]` of an absolute URL, or `undefined` when it is not one. */
+export function originOf(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The headers of a request to the provider itself: its custom headers, then its key. */
+export function providerHeaders(ctx, auth = 'bearer', extra = {}) {
+    const headers = new Headers();
+    for (const { header, value } of ctx.customHeaders)
+        headers.set(header, value);
+    const key = ctx.apiKey?.trim();
+    // A custom `Authorization` (basic auth in front of a self-hosted server) is the provider's own.
+    if (key && auth === 'bearer' && !headers.has('authorization'))
+        headers.set('Authorization', `Bearer ${key}`);
+    if (key && auth === 'goog')
+        headers.set('x-goog-api-key', key);
+    for (const [name, value] of Object.entries(extra))
+        headers.set(name, value);
+    return headers;
+}
+/** The provider's own words out of an error body, whatever shape it uses. */
+export function providerMessage(body, text = '') {
+    const pick = (value) => typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
+    if (body && typeof body === 'object' && !Array.isArray(body)) {
+        const fields = body;
+        const error = fields['error'];
+        if (error && typeof error === 'object' && !Array.isArray(error)) {
+            const inner = error;
+            const said = pick(inner['message']) ?? pick(inner['msg']);
+            if (said)
+                return said;
+        }
+        const said = pick(error) ??
+            pick(fields['message']) ??
+            pick(fields['detail']) ??
+            pick(fields['msg']) ??
+            pick(fields['status_msg']);
+        if (said)
+            return said;
+        const detail = fields['detail'];
+        if (Array.isArray(detail) && detail.length > 0) {
+            const first = detail[0];
+            const message = pick(first?.['msg']);
+            if (message)
+                return message;
+        }
+        const base = fields['base_resp'];
+        if (base && typeof base === 'object') {
+            const message = pick(base['status_msg']);
+            if (message)
+                return message;
+        }
+    }
+    const trimmed = text.trim();
+    return trimmed === '' ? undefined : trimmed.slice(0, 500);
+}
+const BLOCKED = /moderation|content[ _-]?polic|safety|nsfw|sensitive|prohibited|blocked by|flagged/i;
+/** A provider's non-2xx answer as the closest `REMOTE_*` code, with its words in the message. */
+export function remoteHttpError(provider, status, body, text = '') {
+    const said = providerMessage(body, text);
+    const details = `HTTP ${status}${said ? `: ${said}` : ''}`;
+    if (status === 401 || status === 403)
+        return remoteError('REMOTE_AUTH_FAILED', `${provider} refused the API key or the model.`, details);
+    if (status === 402)
+        return remoteError('REMOTE_QUOTA', `${provider} says the account is out of credit.`, details);
+    if (status === 429)
+        return remoteError('REMOTE_RATE_LIMITED', `${provider} is rate-limiting requests.`, details);
+    if (status === 408 || status === 504)
+        return remoteError('REMOTE_TIMEOUT', `${provider} took too long to answer.`, details);
+    if (status >= 500)
+        return remoteError('REMOTE_UNAVAILABLE', `${provider} failed to answer.`, details);
+    if (said && BLOCKED.test(said))
+        return remoteError('REMOTE_CONTENT_BLOCKED', `${provider} refused the request: ${said}`, details);
+    return remoteError('REMOTE_REJECTED', said ? `${provider}: ${said}` : `${provider} refused the request.`, details);
+}
+/** A request that never got an answer: cancelled, timed out, or the provider unreachable. */
+export function networkError(ctx, error) {
+    if (ctx.signal.aborted)
+        return diffusionError('CANCELLED', 'Generation was cancelled.');
+    const message = error instanceof Error ? error.message : String(error);
+    if (error instanceof Error && (error.name === 'TimeoutError' || error.name === 'AbortError'))
+        return remoteError('REMOTE_TIMEOUT', `${ctx.provider} took too long to answer.`, message);
+    return remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} could not be reached.`, message);
+}
+function parseJson(text) {
+    if (text.trim() === '')
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The job's signal and a timeout as one. */
+function deadline(ctx, timeoutMs) {
+    return AbortSignal.any([ctx.signal, AbortSignal.timeout(timeoutMs)]);
+}
+/**
+ * One request to the provider. A 2xx (or a status in `accept`) is answered; anything else is thrown
+ * as a `REMOTE_*` error carrying the provider's words.
+ */
+export async function callProvider(ctx, url, options = {}) {
+    const extra = { Accept: 'application/json', ...options.headers };
+    let body;
+    if (options.json !== undefined) {
+        extra['Content-Type'] = 'application/json';
+        body = JSON.stringify(options.json);
+    }
+    else if (options.form !== undefined)
+        body = options.form;
+    const headers = providerHeaders(ctx, options.auth ?? 'bearer', extra);
+    let response;
+    try {
+        response = await ctx.fetch(url, {
+            method: options.method ?? (body === undefined ? 'GET' : 'POST'),
+            headers,
+            ...(body === undefined ? {} : { body }),
+            signal: deadline(ctx, options.timeoutMs ?? SHORT_TIMEOUT_MS),
+        });
+    }
+    catch (error) {
+        throw networkError(ctx, error);
+    }
+    let text;
+    try {
+        text = await response.text();
+    }
+    catch (error) {
+        throw networkError(ctx, error);
+    }
+    const json = parseJson(text);
+    const ok = response.status >= 200 && response.status < 300;
+    if (!ok && !(options.accept ?? []).includes(response.status))
+        throw remoteHttpError(ctx.provider, response.status, json, text);
+    return { status: response.status, headers: response.headers, text, json };
+}
+/** Read a body into memory, refusing it once it passes `maxBytes`. */
+async function readCapped(response, maxBytes, what) {
+    const declared = Number(response.headers.get('content-length') ?? '');
+    if (Number.isFinite(declared) && declared > maxBytes)
+        throw diffusionError('INVALID_OUTPUT', `The provider's ${what} is larger than the core accepts.`, `${declared} bytes`);
+    if (!response.body)
+        return Buffer.from(await response.arrayBuffer());
+    const chunks = [];
+    let total = 0;
+    const reader = response.body.getReader();
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > maxBytes) {
+            // Not awaited: a body teed elsewhere only settles its cancel once every branch is cancelled.
+            void reader.cancel().catch(() => undefined);
+            throw diffusionError('INVALID_OUTPUT', `The provider's ${what} is larger than the core accepts.`, `over ${maxBytes} bytes`);
+        }
+        chunks.push(Buffer.from(value));
+    }
+    return Buffer.concat(chunks);
+}
+/**
+ * Fetch a file the provider pointed at. Redirects are followed by hand so the key never follows one
+ * off the provider's origin; a URL off that origin must be https.
+ */
+export async function downloadResult(ctx, url, options) {
+    const home = originOf(ctx.baseUrl);
+    const what = options.what ?? 'file';
+    let target = url;
+    for (let hop = 0; hop <= MAX_REDIRECTS; hop++) {
+        const origin = originOf(target);
+        if (!origin)
+            throw remoteError('REMOTE_REJECTED', `${ctx.provider} pointed at an invalid ${what} URL.`, target);
+        const own = origin === home;
+        if (!own && !target.startsWith('https://'))
+            throw remoteError('REMOTE_REJECTED', `${ctx.provider} pointed at a ${what} over plain http.`, origin);
+        const headers = own ? providerHeaders(ctx, options.auth ?? 'bearer') : new Headers();
+        let response;
+        try {
+            response = await ctx.fetch(target, {
+                headers,
+                redirect: 'manual',
+                signal: deadline(ctx, options.timeoutMs ?? GENERATE_TIMEOUT_MS),
+            });
+        }
+        catch (error) {
+            throw networkError(ctx, error);
+        }
+        if (response.status >= 300 && response.status < 400) {
+            const next = response.headers.get('location');
+            await response.body?.cancel().catch(() => undefined);
+            if (!next)
+                throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} redirected without a location.`);
+            target = new URL(next, target).toString();
+            continue;
+        }
+        if (response.status < 200 || response.status >= 300) {
+            const text = await response.text().catch(() => '');
+            throw remoteHttpError(ctx.provider, response.status, parseJson(text), text);
+        }
+        try {
+            const bytes = await readCapped(response, options.maxBytes, what);
+            return { bytes, mime: (response.headers.get('content-type') ?? '').split(';')[0]?.trim() ?? '' };
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'code' in error)
+                throw error;
+            throw networkError(ctx, error);
+        }
+    }
+    throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} redirected the ${what} too many times.`);
+}
+/** What the first bytes of an image say it is. */
+export function sniffImageMime(bytes) {
+    if (bytes.length >= 8 &&
+        bytes.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])))
+        return 'image/png';
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return 'image/jpeg';
+    if (bytes.length >= 12 &&
+        bytes.toString('latin1', 0, 4) === 'RIFF' &&
+        bytes.toString('latin1', 8, 12) === 'WEBP')
+        return 'image/webp';
+    if (bytes.length >= 6 && /^GIF8[79]a$/.test(bytes.toString('latin1', 0, 6)))
+        return 'image/gif';
+    return undefined;
+}
+/** What the first bytes of a clip say it is. */
+export function sniffVideoMime(bytes) {
+    if (bytes.length >= 12 && bytes.toString('latin1', 4, 8) === 'ftyp')
+        return 'video/mp4';
+    if (bytes.length >= 4 && bytes.subarray(0, 4).equals(Buffer.from([0x1a, 0x45, 0xdf, 0xa3])))
+        return 'video/webm';
+    return undefined;
+}
+/** Base64 or a data URL as bytes and the type the bytes themselves say. */
+export function decodeBase64Image(payload, what = 'image') {
+    const comma = payload.startsWith('data:') ? payload.indexOf(',') : -1;
+    const raw = (comma >= 0 ? payload.slice(comma + 1) : payload).trim();
+    const bytes = Buffer.from(raw, 'base64');
+    const mime = sniffImageMime(bytes);
+    if (bytes.length === 0 || !mime)
+        throw diffusionError('INVALID_OUTPUT', `The provider returned a ${what} that is not an image.`);
+    return { bytes, mime };
+}
+export function toDataUrl(bytes, mime) {
+    return `data:${mime};base64,${bytes.toString('base64')}`;
+}
+/** `'1024x768'` → its dimensions; anything else (`auto`, a tier) → `undefined`. */
+export function parseWxH(size) {
+    const match = /^(\d+)\s*[xX*]\s*(\d+)$/.exec(size?.trim() ?? '');
+    if (!match)
+        return undefined;
+    const width = Number(match[1]);
+    const height = Number(match[2]);
+    return width > 0 && height > 0 ? { width, height } : undefined;
+}
+/**
+ * Ask `step` until it answers something, waiting in between (growing by half each time up to
+ * `maxIntervalMs`). Stops with `CANCELLED` when the job is cancelled, `REMOTE_TIMEOUT` past
+ * `timeoutMs`. For adapters whose image API is a job to poll.
+ */
+export async function pollUntil(ctx, step, options) {
+    const started = ctx.now();
+    let wait = options.intervalMs;
+    for (;;) {
+        const answer = await step();
+        if (answer !== undefined)
+            return answer;
+        if (ctx.now() - started > options.timeoutMs)
+            throw remoteError('REMOTE_TIMEOUT', `${ctx.provider} did not finish in time.`, `${options.timeoutMs} ms`);
+        await ctx.sleep(wait);
+        wait = Math.min(Math.round(wait * 1.5), options.maxIntervalMs ?? wait);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/media/http.js.map

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

package/dist/media/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Remote media: the image and video models cloud providers and self-hosted servers offer through the
+ * core (ADR 2026-10-13-remote-media-shares-the-diffusion-job-table). The catalog (conf
+ * `providers/media.json`), one adapter per provider media API, and the service that resolves a
+ * provider's model for the job runner in `src/diffusion/remote-job.ts`.
+ */
+export * from './adapters/types.js';
+export * from './catalog.js';
+export * from './catalog-baseline.js';
+export * from './catalog-service.js';
+export * from './http.js';
+export * from './mask.js';
+export * from './service.js';
+export * from './adapters/registry.js';

package/dist/media/index.js

@@ -0,0 +1,15 @@
+/**
+ * Remote media: the image and video models cloud providers and self-hosted servers offer through the
+ * core (ADR 2026-10-13-remote-media-shares-the-diffusion-job-table). The catalog (conf
+ * `providers/media.json`), one adapter per provider media API, and the service that resolves a
+ * provider's model for the job runner in `src/diffusion/remote-job.ts`.
+ */
+export * from './adapters/types.js';
+export * from './catalog.js';
+export * from './catalog-baseline.js';
+export * from './catalog-service.js';
+export * from './http.js';
+export * from './mask.js';
+export * from './service.js';
+export * from './adapters/registry.js';
+//# sourceMappingURL=index.js.map

package/dist/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA"}

package/dist/media/mask.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Masks between the core's convention and a provider's. The Images page and the control API send a
+ * PNG that is white where the model repaints (sd.cpp's and Automatic1111's convention); OpenAI's
+ * Images API wants the opposite carrier: a transparent pixel is the one to repaint.
+ */
+/** White-means-repaint PNG → an RGBA PNG whose alpha is 0 where the model repaints, 255 elsewhere. */
+export declare function maskToAlpha(png: Buffer): Promise<Buffer>;
+/**
+ * An OpenAI-style mask (transparent where the model repaints) → the core's white-means-repaint PNG.
+ * A mask without an alpha channel is taken to be white-means-repaint already and kept as it is.
+ */
+export declare function alphaMaskToWhite(png: Buffer): Promise<Buffer>;

package/dist/media/mask.js

@@ -0,0 +1,57 @@
+/**
+ * Masks between the core's convention and a provider's. The Images page and the control API send a
+ * PNG that is white where the model repaints (sd.cpp's and Automatic1111's convention); OpenAI's
+ * Images API wants the opposite carrier: a transparent pixel is the one to repaint.
+ */
+import { decodePng, encodePng } from '../diffusion/index.js';
+import { remoteError } from './http.js';
+/** A pixel this bright (every channel) is "repaint". */
+const WHITE_THRESHOLD = 128;
+/** White-means-repaint PNG → an RGBA PNG whose alpha is 0 where the model repaints, 255 elsewhere. */
+export async function maskToAlpha(png) {
+    let image;
+    try {
+        image = await decodePng(png);
+    }
+    catch (error) {
+        throw remoteError('REMOTE_UNSUPPORTED', 'The mask could not be read.', error instanceof Error ? error.message : String(error));
+    }
+    const { width, height, channels, data } = image;
+    const out = Buffer.alloc(width * height * 4);
+    for (let i = 0, o = 0; i < data.length; i += channels, o += 4) {
+        const r = data[i];
+        const g = data[i + 1];
+        const b = data[i + 2];
+        const repaint = r >= WHITE_THRESHOLD && g >= WHITE_THRESHOLD && b >= WHITE_THRESHOLD;
+        out[o] = 0;
+        out[o + 1] = 0;
+        out[o + 2] = 0;
+        out[o + 3] = repaint ? 0 : 255;
+    }
+    return encodePng({ width, height, channels: 4, data: out });
+}
+/**
+ * An OpenAI-style mask (transparent where the model repaints) → the core's white-means-repaint PNG.
+ * A mask without an alpha channel is taken to be white-means-repaint already and kept as it is.
+ */
+export async function alphaMaskToWhite(png) {
+    let image;
+    try {
+        image = await decodePng(png);
+    }
+    catch (error) {
+        throw remoteError('REMOTE_UNSUPPORTED', 'The mask could not be read.', error instanceof Error ? error.message : String(error));
+    }
+    if (image.channels !== 4)
+        return png;
+    const { width, height, data } = image;
+    const out = Buffer.alloc(width * height * 3);
+    for (let i = 0, o = 0; i < data.length; i += 4, o += 3) {
+        const value = data[i + 3] < 128 ? 255 : 0;
+        out[o] = value;
+        out[o + 1] = value;
+        out[o + 2] = value;
+    }
+    return encodePng({ width, height, channels: 3, data: out });
+}
+//# sourceMappingURL=mask.js.map

package/dist/media/mask.js.map

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

package/dist/media/service.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The remote media service: what the control routes answer (the catalog, a provider's models) and
+ * what the job runner resolves a target with (`RemoteMediaGateway`). A provider is usable here once
+ * the app registered it (`cloud.routing()`, which already drops a key bound to another URL); its
+ * adapter is the registration's own (a custom server) or the catalog's.
+ */
+import type { ImageModelDescriptor, MediaCatalogView, MediaDialect, MediaKind, MediaProviderModels, MediaTarget, VideoModelDescriptor } from '../contracts/index.js';
+import type { RemoteMediaGateway, ResolvedRemote } from '../diffusion/index.js';
+import type { RemoteProvider } from '../router/index.js';
+import type { ImageAdapter, MediaAdapter, VideoAdapter } from './adapters/types.js';
+import type { MediaCatalogService } from './catalog-service.js';
+import type { MediaContext, MediaLog } from './http.js';
+export interface MediaServiceDeps {
+    catalog: MediaCatalogService;
+    /** The registered providers, as the router sees them. */
+    providers: () => ReadonlyMap<string, RemoteProvider>;
+    adapters: Partial<Record<MediaDialect, MediaAdapter>>;
+    fetch: typeof fetch;
+    now?: () => number;
+    log: MediaLog;
+}
+/** A wait that ends early, with `CANCELLED`, when `signal` fires. */
+export declare function abortableSleep(ms: number, signal: AbortSignal): Promise<void>;
+export declare class MediaService implements RemoteMediaGateway {
+    private readonly deps;
+    constructor(deps: MediaServiceDeps);
+    /** `GET /media/catalog`. */
+    catalogView(): Promise<MediaCatalogView>;
+    private provider;
+    /** A context for `provider`'s adapter calls under `signal`. */
+    context(provider: RemoteProvider, signal: AbortSignal): MediaContext;
+    private dialectOf;
+    private resolve;
+    image(target: MediaTarget): Promise<ResolvedRemote<ImageModelDescriptor, ImageAdapter>>;
+    video(target: MediaTarget): Promise<ResolvedRemote<VideoModelDescriptor, VideoAdapter>>;
+    find(model: string, kind: MediaKind): MediaTarget | undefined;
+    /**
+     * `GET /media/providers/:provider/models?kind=`: the catalog's models of the provider, then what its
+     * live listing adds. A listing that fails still answers the catalog's models, with the error.
+     */
+    providerModels(name: string, kind: MediaKind): Promise<MediaProviderModels>;
+}