@atomic-chat/core 0.13.2 → 0.17.0

package/dist/media/adapters/hf-videos.js

@@ -0,0 +1,265 @@
+/**
+ * `hf-videos`: Hugging Face Inference Providers' video models, through fal-ai's queue behind the HF
+ * router. The provider is registered with the router's OpenAI-compatible base
+ * (`https://router.huggingface.co/v1`); the router proxies each inference provider under
+ * `/{provider}` of its origin, so `hfRouterBase` strips the trailing `/v1` and every call goes to
+ * `{router}/fal-ai/…?_subdomain=queue`, the way huggingface.js routes fal-ai's queue
+ * (`packages/inference/src/providers/fal-ai.ts`). The HF token never goes to `queue.fal.run` itself.
+ *
+ * A catalog model names its route in `options`: `hf_provider` (`fal-ai`, the only one spoken here)
+ * and `provider_model` (fal's endpoint id, e.g. `fal-ai/wan/v2.2-5b/text-to-video`).
+ *
+ * - submit → `POST {router}/fal-ai/{provider_model}?_subdomain=queue` `{prompt, …}` →
+ *   `{request_id, response_url, status_url}`. fal's URLs point at `queue.fal.run`; only their path
+ *   (`/{owner}/{app}/requests/{id}`) is kept, to be asked through the router later;
+ * - poll → `GET {router}/fal-ai{path}/status?_subdomain=queue` → `status` IN_QUEUE | IN_PROGRESS |
+ *   COMPLETED (with `error`/`error_type` when it failed); once completed, `GET
+ *   {router}/fal-ai{path}?_subdomain=queue` → `{video:{url}}`;
+ * - download → `video.url` on fal's CDN, without the key;
+ * - no cancel; the listing is the public Hub API (no key), and only for the real router.
+ */
+import { callProvider, downloadResult, MAX_VIDEO_BYTES, networkError, providerMessage, remoteError, remoteHttpError, SHORT_TIMEOUT_MS, sniffVideoMime, toDataUrl, } from '../http.js';
+const fields = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+const textOf = (value) => typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
+/** The only inference provider this adapter speaks. */
+const FAL_AI = 'fal-ai';
+/** The router asks fal's queue (not its synchronous endpoint) with this. */
+const QUEUE = '?_subdomain=queue';
+/** The host whose models the public Hub lists. */
+const HF_ROUTER_HOST = 'router.huggingface.co';
+/** The Hub's text-to-video models served by fal-ai, with their provider mappings. */
+export const HF_VIDEO_LISTING_URL = 'https://huggingface.co/api/models?inference_provider=fal-ai&pipeline_tag=text-to-video&expand[]=inferenceProviderMapping&limit=100';
+/** A fal endpoint id: `owner/app[/sub/path]`, no empty or dot segments. */
+const ENDPOINT_ID = /^[A-Za-z0-9_-][\w.-]*(\/[A-Za-z0-9_-][\w.-]*)+$/;
+/** A queued request's path: `/{owner}/{app}[/…]/requests/{id}`, no dot segments. */
+const QUEUE_PATH = /^(\/(?!\.{1,2}(\/|$))[^/?#]+){2,}\/requests\/[\w-]+$/;
+/** `https://router.huggingface.co/v1` → `https://router.huggingface.co`. */
+export function hfRouterBase(baseUrl) {
+    return baseUrl.replace(/\/+$/, '').replace(/\/v1$/, '');
+}
+/**
+ * The queue path of a submitted request, `/{owner}/{app}/requests/{id}`: the path of fal's
+ * `response_url` (or `status_url`), as huggingface.js takes it, else built from the endpoint id the
+ * way fal's own client does (its first two segments).
+ */
+export function falRequestPath(answer, providerModel, requestId) {
+    const body = fields(answer);
+    const tail = `/requests/${requestId}`;
+    for (const key of ['response_url', 'status_url']) {
+        const raw = textOf(body[key]);
+        if (!raw)
+            continue;
+        let url;
+        try {
+            url = new URL(raw);
+        }
+        catch {
+            continue;
+        }
+        let path = url.pathname.replace(/\/status$/, '');
+        // A URL the router already rewrote carries its `/fal-ai` prefix; the path is fal's own.
+        if (!url.hostname.endsWith('fal.run') && path.startsWith(`/${FAL_AI}/`))
+            path = path.slice(FAL_AI.length + 1);
+        if (path.endsWith(tail) && QUEUE_PATH.test(path))
+            return path;
+    }
+    const [owner, app] = providerModel.split('/');
+    return `/${owner}/${app}${tail}`;
+}
+/** A fal failure (`error`/`error_type` of a completed request, or its result's error body). */
+export function falError(provider, body, status, text = '') {
+    const fieldsOf = fields(body);
+    const types = [fieldsOf['error_type'], fieldsOf['type']];
+    const detail = fieldsOf['detail'];
+    if (Array.isArray(detail))
+        for (const item of detail)
+            types.push(fields(item)['type']);
+    const typed = types.filter((t) => typeof t === 'string');
+    const said = providerMessage(body, text);
+    const details = [status === undefined ? undefined : `HTTP ${status}`, typed[0], said]
+        .filter(Boolean)
+        .join(': ');
+    if (typed.some((t) => /content_policy|nsfw|safety|moderation/i.test(t)))
+        return remoteError('REMOTE_CONTENT_BLOCKED', said ? `${provider} refused the content: ${said}` : `${provider} refused the content.`, details || undefined);
+    if (status !== undefined)
+        return remoteHttpError(provider, status, body, text);
+    if (typed.some((t) => /timeout/i.test(t)))
+        return remoteError('REMOTE_TIMEOUT', `${provider} took too long to make the clip.`, details || undefined);
+    return remoteError('REMOTE_UNAVAILABLE', said ? `${provider} could not make the clip: ${said}` : `${provider} could not make the clip.`, details || undefined);
+}
+/** The workflow is the model's, and image to video has the frames it needs. */
+function checkInputs(job) {
+    if (!job.model.workflows.includes(job.workflow))
+        throw remoteError('REMOTE_UNSUPPORTED', `${job.model.name} cannot do ${job.workflow}.`, job.workflow);
+    if (job.workflow !== 'image-to-video')
+        return;
+    if (!job.firstFrame)
+        throw remoteError('REMOTE_UNSUPPORTED', 'Image to video needs a first frame.');
+    if (job.lastFrame && !job.model.params.last_frame)
+        throw remoteError('REMOTE_UNSUPPORTED', `${job.model.name} does not take a last frame.`);
+}
+/** Where a model runs: its fal endpoint id, or `REMOTE_UNSUPPORTED` for a model without one. */
+export function falEndpoint(job) {
+    const options = job.model.options ?? {};
+    const provider = options['hf_provider'] ?? FAL_AI;
+    if (provider !== FAL_AI)
+        throw remoteError('REMOTE_UNSUPPORTED', `${job.model.name} runs on ${String(provider)}, which is not supported.`);
+    const endpoint = options['provider_model'];
+    if (typeof endpoint !== 'string' || !ENDPOINT_ID.test(endpoint))
+        throw remoteError('REMOTE_UNSUPPORTED', `${job.model.name} names no fal-ai model to run on.`, job.model.id);
+    return endpoint;
+}
+/** fal's input: what the job set and the model offers. */
+export function falVideoInput(job) {
+    checkInputs(job);
+    const params = job.model.params;
+    const input = { prompt: job.prompt };
+    if (job.negativePrompt && params.negative_prompt)
+        input['negative_prompt'] = job.negativePrompt;
+    if (job.aspectRatio && params.aspect_ratios)
+        input['aspect_ratio'] = job.aspectRatio;
+    if (job.resolution && params.resolutions)
+        input['resolution'] = job.resolution;
+    if (job.durationSecs !== undefined && params.durations)
+        input['duration'] = Math.round(job.durationSecs);
+    if (job.generateAudio !== undefined && params.audio)
+        input['generate_audio'] = job.generateAudio;
+    if (job.seed !== undefined && params.seed)
+        input['seed'] = job.seed;
+    if (job.workflow === 'image-to-video' && job.firstFrame) {
+        input['image_url'] = toDataUrl(job.firstFrame.bytes, job.firstFrame.mime);
+        if (job.lastFrame)
+            input['end_image_url'] = toDataUrl(job.lastFrame.bytes, job.lastFrame.mime);
+    }
+    return input;
+}
+/** The Hub's listing as models: a live fal-ai mapping of a single model each. */
+export function falVideoModels(json) {
+    const out = [];
+    const seen = new Set();
+    for (const item of Array.isArray(json) ? json : []) {
+        const entry = fields(item);
+        const id = textOf(entry['id']) ?? textOf(entry['modelId']);
+        if (!id || seen.has(id))
+            continue;
+        const raw = entry['inferenceProviderMapping'];
+        // The Hub answers a list of mappings; older answers keyed them by provider.
+        const mappings = Array.isArray(raw)
+            ? raw.map(fields)
+            : Object.entries(fields(raw)).map(([provider, value]) => ({ provider, ...fields(value) }));
+        const fal = mappings.find((m) => m['provider'] === FAL_AI &&
+            m['status'] === 'live' &&
+            (m['task'] === undefined || m['task'] === 'text-to-video') &&
+            (m['type'] === undefined || m['type'] === 'single-model') &&
+            typeof m['providerId'] === 'string' &&
+            ENDPOINT_ID.test(m['providerId']));
+        if (!fal)
+            continue;
+        seen.add(id);
+        out.push({
+            id,
+            workflows: ['create'],
+            options: { hf_provider: FAL_AI, provider_model: fal['providerId'] },
+        });
+    }
+    return out;
+}
+/** The router URL of a queued request, from its persisted path. */
+function queueUrl(ctx, path, suffix = '') {
+    return `${hfRouterBase(ctx.baseUrl)}/${FAL_AI}${path}${suffix}${QUEUE}`;
+}
+/** The persisted queue path, checked: it goes to the router with the key. */
+function pathOf(submission) {
+    const path = submission.data?.['path'];
+    if (typeof path === 'string' && QUEUE_PATH.test(path))
+        return path;
+    throw remoteError('REMOTE_UNAVAILABLE', 'The submitted request has no queue path to ask.', submission.id);
+}
+/** Statuses of the result fetch that end the job rather than the poll. */
+const RESULT_REFUSALS = [400, 404, 410, 422];
+async function completed(ctx, path) {
+    const answer = await callProvider(ctx, queueUrl(ctx, path), { accept: RESULT_REFUSALS });
+    if (answer.status >= 300)
+        return { state: 'failed', error: falError(ctx.provider, answer.json, answer.status, answer.text) };
+    const url = textOf(fields(fields(answer.json)['video'])['url']);
+    if (!url)
+        return {
+            state: 'failed',
+            error: remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} finished without a clip.`),
+        };
+    return { state: 'completed', result: { url } };
+}
+export const HF_VIDEOS = {
+    dialect: 'hf-videos',
+    kind: 'video',
+    pollIntervalMs: { first: 5000, max: 15000 },
+    async listModels(ctx) {
+        // The Hub lists the router's models; a base elsewhere (a proxy) has the catalog alone.
+        let host;
+        try {
+            host = new URL(ctx.baseUrl).hostname;
+        }
+        catch {
+            return [];
+        }
+        if (host !== HF_ROUTER_HOST)
+            return [];
+        // A public listing on another origin: neither the key nor custom headers go along.
+        let response;
+        let text;
+        try {
+            response = await ctx.fetch(HF_VIDEO_LISTING_URL, {
+                headers: { Accept: 'application/json' },
+                signal: AbortSignal.any([ctx.signal, AbortSignal.timeout(SHORT_TIMEOUT_MS)]),
+            });
+            text = await response.text();
+        }
+        catch (error) {
+            throw networkError(ctx, error);
+        }
+        let json;
+        try {
+            json = JSON.parse(text);
+        }
+        catch {
+            json = undefined;
+        }
+        if (!response.ok)
+            throw remoteHttpError(ctx.provider, response.status, json, text);
+        return falVideoModels(json);
+    },
+    async submit(ctx, job) {
+        const endpoint = falEndpoint(job);
+        const answer = await callProvider(ctx, `${hfRouterBase(ctx.baseUrl)}/${FAL_AI}/${endpoint}${QUEUE}`, {
+            json: falVideoInput(job),
+        });
+        const body = fields(answer.json);
+        const id = textOf(body['request_id']);
+        if (!id || !/^[\w-]+$/.test(id))
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} answered without a request id.`);
+        return { id, data: { path: falRequestPath(body, endpoint, id) } };
+    },
+    async poll(ctx, submission) {
+        const path = pathOf(submission);
+        const answer = await callProvider(ctx, queueUrl(ctx, path, '/status'));
+        const body = fields(answer.json);
+        const status = (textOf(body['status']) ?? '').toUpperCase();
+        if (status === 'IN_QUEUE')
+            return { state: 'queued' };
+        if (status !== 'COMPLETED')
+            return { state: 'running' };
+        if (body['error'] !== undefined && body['error'] !== null)
+            return { state: 'failed', error: falError(ctx.provider, body) };
+        return completed(ctx, path);
+    },
+    async download(ctx, _submission, result) {
+        if (!result.url)
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} gave no clip to download.`);
+        const file = await downloadResult(ctx, result.url, { maxBytes: MAX_VIDEO_BYTES, what: 'video' });
+        const mime = sniffVideoMime(file.bytes);
+        if (!mime)
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} returned a file that is not a video.`, file.mime || undefined);
+        return { bytes: file.bytes, mime };
+    },
+};
+//# sourceMappingURL=hf-videos.js.map

package/dist/media/adapters/hf-videos.js.map

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

package/dist/media/adapters/minimax-image.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `minimax-image`: MiniMax's image API (`image-01`), registered with base `https://api.minimax.io/v1`,
+ * Bearer key.
+ *
+ * Every workflow is `POST {base}/image_generation` (the registered base joined to the path):
+ * `create` from the prompt, `reference` with the first input as a character `subject_reference`.
+ * MiniMax cannot edit an image or take a mask, so the other workflows are refused. We ask for
+ * `base64`; `image_urls` are taken too. MiniMax answers most failures as HTTP 200 with a non-zero
+ * `base_resp.status_code`, mapped here. It has no model listing: the catalog alone applies.
+ */
+import type { AtomicCoreError } from '../../contracts/index.js';
+import type { MediaContext } from '../http.js';
+import type { GeneratedImage, ImageAdapter, ImageGenerationJob } from './types.js';
+/** The JSON body of `POST /image_generation`. */
+export declare function minimaxImageBody(job: ImageGenerationJob): Record<string, unknown>;
+/**
+ * The `REMOTE_*` error a non-zero `base_resp.status_code` means (MiniMax answers those with HTTP
+ * 200); `undefined` when the body says the call succeeded or says nothing.
+ */
+export declare function minimaxImageStatusError(provider: string, json: unknown): AtomicCoreError | undefined;
+/**
+ * The images of an `/image_generation` answer (base64, or URLs downloaded), or the error it amounts
+ * to: a status code, or every image held back by the safety check (`metadata.failed_count`).
+ */
+export declare function minimaxImages(ctx: MediaContext, json: unknown): Promise<GeneratedImage[]>;
+export declare const MINIMAX_IMAGE: ImageAdapter;

package/dist/media/adapters/minimax-image.js

@@ -0,0 +1,111 @@
+/**
+ * `minimax-image`: MiniMax's image API (`image-01`), registered with base `https://api.minimax.io/v1`,
+ * Bearer key.
+ *
+ * Every workflow is `POST {base}/image_generation` (the registered base joined to the path):
+ * `create` from the prompt, `reference` with the first input as a character `subject_reference`.
+ * MiniMax cannot edit an image or take a mask, so the other workflows are refused. We ask for
+ * `base64`; `image_urls` are taken too. MiniMax answers most failures as HTTP 200 with a non-zero
+ * `base_resp.status_code`, mapped here. It has no model listing: the catalog alone applies.
+ */
+import { callProvider, decodeBase64Image, downloadResult, GENERATE_TIMEOUT_MS, joinUrl, MAX_IMAGE_BYTES, parseWxH, remoteError, sniffImageMime, toDataUrl, } from '../http.js';
+const WORKFLOWS = ['create', 'reference'];
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+/** The JSON body of `POST /image_generation`. */
+export function minimaxImageBody(job) {
+    const body = { model: job.model.id, prompt: job.prompt };
+    if (job.aspectRatio)
+        body['aspect_ratio'] = job.aspectRatio;
+    else {
+        // Used only without an aspect ratio, which MiniMax would put first.
+        const size = job.width && job.height ? { width: job.width, height: job.height } : parseWxH(job.size);
+        if (size) {
+            body['width'] = size.width;
+            body['height'] = size.height;
+        }
+    }
+    body['response_format'] = 'base64';
+    if (job.seed !== undefined && job.model.params.seed)
+        body['seed'] = job.seed;
+    if (job.n > 1)
+        body['n'] = job.n;
+    body['prompt_optimizer'] = false;
+    const subject = job.images[0];
+    if (job.workflow === 'reference' && subject)
+        body['subject_reference'] = [{ type: 'character', image_file: toDataUrl(subject.bytes, subject.mime) }];
+    return body;
+}
+/**
+ * The `REMOTE_*` error a non-zero `base_resp.status_code` means (MiniMax answers those with HTTP
+ * 200); `undefined` when the body says the call succeeded or says nothing.
+ */
+export function minimaxImageStatusError(provider, json) {
+    const base = isObject(json) && isObject(json['base_resp']) ? json['base_resp'] : undefined;
+    const code = base?.['status_code'];
+    if (typeof code !== 'number' || code === 0)
+        return undefined;
+    const said = typeof base?.['status_msg'] === 'string' && base['status_msg'] !== '' ? base['status_msg'] : undefined;
+    const details = `status_code ${code}${said ? `: ${said}` : ''}`;
+    switch (code) {
+        case 1002:
+            return remoteError('REMOTE_RATE_LIMITED', `${provider} is rate-limiting requests.`, details);
+        case 1004:
+        case 2049:
+            return remoteError('REMOTE_AUTH_FAILED', `${provider} refused the API key.`, details);
+        case 1008:
+            return remoteError('REMOTE_QUOTA', `${provider} says the account is out of credit.`, details);
+        case 1026:
+        case 1027:
+            return remoteError('REMOTE_CONTENT_BLOCKED', `${provider} refused the request: ${said ?? 'sensitive content'}`, details);
+        case 2013:
+            return remoteError('REMOTE_REJECTED', said ? `${provider}: ${said}` : `${provider} refused the request.`, details);
+        default:
+            return remoteError('REMOTE_UNAVAILABLE', `${provider} failed to answer.`, details);
+    }
+}
+/** A file the provider pointed at, with the type its bytes say. Local: `http.ts` has no such helper. */
+async function downloadImage(ctx, url) {
+    const file = await downloadResult(ctx, url, { maxBytes: MAX_IMAGE_BYTES, what: 'image' });
+    const mime = sniffImageMime(file.bytes);
+    if (!mime)
+        throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} returned a file that is not an image.`);
+    return { bytes: file.bytes, mime };
+}
+const strings = (value) => Array.isArray(value) ? value.filter((item) => typeof item === 'string' && item !== '') : [];
+/**
+ * The images of an `/image_generation` answer (base64, or URLs downloaded), or the error it amounts
+ * to: a status code, or every image held back by the safety check (`metadata.failed_count`).
+ */
+export async function minimaxImages(ctx, json) {
+    const failed = minimaxImageStatusError(ctx.provider, json);
+    if (failed)
+        throw failed;
+    const data = isObject(json) && isObject(json['data']) ? json['data'] : {};
+    const out = strings(data['image_base64']).map((payload) => decodeBase64Image(payload));
+    for (const url of strings(data['image_urls']))
+        out.push(await downloadImage(ctx, url));
+    if (out.length > 0)
+        return out;
+    const metadata = isObject(json) && isObject(json['metadata']) ? json['metadata'] : {};
+    const blocked = Number(metadata['failed_count'] ?? 0);
+    if (blocked > 0)
+        throw remoteError('REMOTE_CONTENT_BLOCKED', `${ctx.provider} held back the image for its content.`, `failed_count ${blocked}`);
+    throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} answered without an image.`);
+}
+export const MINIMAX_IMAGE = {
+    dialect: 'minimax-image',
+    kind: 'image',
+    async generate(ctx, job, report) {
+        if (!WORKFLOWS.includes(job.workflow))
+            throw remoteError('REMOTE_UNSUPPORTED', `${ctx.provider} does not support this workflow.`, job.workflow);
+        if (job.workflow === 'reference' && job.images.length === 0)
+            throw remoteError('REMOTE_UNSUPPORTED', 'This workflow needs a reference image.', job.workflow);
+        report({ phase: 'generating' });
+        const answer = await callProvider(ctx, joinUrl(ctx.baseUrl, '/image_generation'), {
+            json: minimaxImageBody(job),
+            timeoutMs: GENERATE_TIMEOUT_MS,
+        });
+        return minimaxImages(ctx, answer.json);
+    },
+};
+//# sourceMappingURL=minimax-image.js.map

package/dist/media/adapters/minimax-image.js.map

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

package/dist/media/adapters/minimax-video-v2.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `minimax-video-v2`: MiniMax's V2 video API (MiniMax H3, H3 Max). The provider is registered with its
+ * V1 base (`https://api.minimax.io/v1`); V2 lives next to it, so `minimaxV2Base` swaps the trailing
+ * `/v1` for `/v2` (`https://api.minimax.io/v2`).
+ *
+ * - submit → `POST {v2}/video_generation` `{model, content, resolution, duration, ratio}`, where
+ *   `content` is the prompt as a `text` item and the frames as `image_url` items with a
+ *   `first_frame`/`last_frame` role; `resolution` and `duration` are required, and text to video
+ *   needs a concrete `ratio` (image to video follows the frame) → `{task_id}`;
+ * - poll → `GET {v2}/query/video_generation/{task_id}` → `task.status` queued | running | succeeded |
+ *   failed | cancelled, `task.content.url` once it succeeded, `task.error {code, message}` once it
+ *   failed;
+ * - download → `task.content.url`, time-limited; an expired link is refreshed by asking again;
+ * - cancel → `DELETE {v2}/video_generation/{task_id}` (only a queued task; errors are ignored).
+ *
+ * V2 answers real HTTP statuses with an OpenAI-style error body; 422 is a content refusal.
+ */
+import type { AtomicCoreError } from '../../contracts/index.js';
+import type { VideoAdapter, VideoGenerationJob } from './types.js';
+type Fields = Record<string, unknown>;
+/** The V2 base next to the registered V1 one: `…/v1` → `…/v2`; a base without a version gets `/v2`. */
+export declare function minimaxV2Base(baseUrl: string): string;
+/** A V2 non-2xx answer as a `REMOTE_*` error: 422 and a 1026/1027 message are content refusals. */
+export declare function minimaxV2HttpError(provider: string, status: number, body: unknown, text?: string): AtomicCoreError;
+/** A failed task's `error {code, message}` as a `REMOTE_*` error. */
+export declare function minimaxTaskError(provider: string, error: unknown): AtomicCoreError;
+/**
+ * The `POST /video_generation` body. `resolution` and `duration` are required, so the model's
+ * defaults fill in what the job left out; text to video takes the job's ratio or the model's default
+ * (`16:9` without one), image to video none.
+ */
+export declare function minimaxV2Body(job: VideoGenerationJob): Fields;
+export declare const MINIMAX_VIDEO_V2: VideoAdapter;
+export {};