@atomic-chat/core 0.13.2 → 0.17.0

package/dist/media/adapters/minimax-video-v2.js

@@ -0,0 +1,191 @@
+/**
+ * `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 { callProvider, downloadResult, MAX_VIDEO_BYTES, providerMessage, remoteError, remoteHttpError, sniffVideoMime, toDataUrl, } from '../http.js';
+import { minimaxCodeError } from './minimax-video.js';
+const fields = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+const textOf = (value) => typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
+/** A content refusal the provider names by MiniMax's code in its message: `... (1026)`. */
+const BLOCKED_CODE = /\((1026|1027)\)/;
+/** The V2 base next to the registered V1 one: `…/v1` → `…/v2`; a base without a version gets `/v2`. */
+export function minimaxV2Base(baseUrl) {
+    const trimmed = baseUrl.replace(/\/+$/, '');
+    if (/\/v2$/.test(trimmed))
+        return trimmed;
+    if (/\/v1$/.test(trimmed))
+        return trimmed.replace(/\/v1$/, '/v2');
+    return `${trimmed}/v2`;
+}
+/** A V2 non-2xx answer as a `REMOTE_*` error: 422 and a 1026/1027 message are content refusals. */
+export function minimaxV2HttpError(provider, status, body, text = '') {
+    const said = providerMessage(body, text);
+    if (status === 422 || (said && BLOCKED_CODE.test(said)))
+        return remoteError('REMOTE_CONTENT_BLOCKED', said ? `${provider} refused the content: ${said}` : `${provider} refused the content.`, `HTTP ${status}${said ? `: ${said}` : ''}`);
+    return remoteHttpError(provider, status, body, text);
+}
+/** A failed task's `error {code, message}` as a `REMOTE_*` error. */
+export function minimaxTaskError(provider, error) {
+    const said = textOf(fields(error)['message']);
+    const raw = fields(error)['code'];
+    const code = typeof raw === 'number' ? raw : typeof raw === 'string' && /^\d+$/.test(raw.trim()) ? Number(raw) : NaN;
+    if (Number.isFinite(code))
+        return minimaxCodeError(provider, code, said);
+    // No numeric code: the same words-based reading as an HTTP refusal.
+    if (said) {
+        const mapped = remoteHttpError(provider, 400, { message: said });
+        if (mapped.code === 'REMOTE_CONTENT_BLOCKED')
+            return mapped;
+    }
+    return remoteError('REMOTE_UNAVAILABLE', said ? `${provider} could not make the clip: ${said}` : `${provider} could not make the clip.`, typeof raw === 'string' ? raw : undefined);
+}
+/** One V2 request: a 400 or 422 read with `minimaxV2HttpError`, other statuses as `callProvider` does. */
+async function callV2(ctx, url, options = {}) {
+    const answer = await callProvider(ctx, url, { ...options, accept: [400, 422] });
+    if (answer.status === 400 || answer.status === 422)
+        throw minimaxV2HttpError(ctx.provider, answer.status, answer.json, answer.text);
+    return fields(answer.json);
+}
+/** 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.`);
+}
+/**
+ * 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 function minimaxV2Body(job) {
+    checkInputs(job);
+    const params = job.model.params;
+    const content = [{ type: 'text', text: job.prompt }];
+    if (job.workflow === 'image-to-video' && job.firstFrame) {
+        content.push({
+            type: 'image_url',
+            image_url: { url: toDataUrl(job.firstFrame.bytes, job.firstFrame.mime) },
+            role: 'first_frame',
+        });
+        if (job.lastFrame)
+            content.push({
+                type: 'image_url',
+                image_url: { url: toDataUrl(job.lastFrame.bytes, job.lastFrame.mime) },
+                role: 'last_frame',
+            });
+    }
+    const body = {
+        model: job.model.id,
+        content,
+        resolution: job.resolution ?? params.resolutions?.default ?? params.resolutions?.values[0] ?? '768P',
+        duration: Math.round(job.durationSecs ?? params.durations?.default ?? params.durations?.min ?? 6),
+    };
+    if (job.workflow === 'create')
+        body['ratio'] = job.aspectRatio ?? params.aspect_ratios?.default ?? '16:9';
+    return body;
+}
+async function pollTask(ctx, id) {
+    const body = await callV2(ctx, `${minimaxV2Base(ctx.baseUrl)}/query/video_generation/${encodeURIComponent(id)}`);
+    const task = 'task' in body ? fields(body['task']) : body;
+    const status = typeof task['status'] === 'string' ? task['status'].toLowerCase() : '';
+    switch (status) {
+        case 'queued':
+            return { state: 'queued' };
+        case 'succeeded': {
+            const url = textOf(fields(task['content'])['url']);
+            if (!url)
+                return {
+                    state: 'failed',
+                    error: remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} finished without a clip.`),
+                };
+            return { state: 'completed', result: { url } };
+        }
+        case 'failed':
+            return { state: 'failed', error: minimaxTaskError(ctx.provider, task['error']) };
+        case 'cancelled':
+            return { state: 'failed', error: remoteError('CANCELLED', `${ctx.provider} cancelled the generation.`) };
+        default:
+            return { state: 'running' };
+    }
+}
+/** A clip the provider pointed at, refused unless its bytes are a video. */
+async function fetchClip(ctx, url) {
+    const file = await downloadResult(ctx, 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 };
+}
+/** The clip's link as the task gives it now. */
+async function refreshedUrl(ctx, id) {
+    const poll = await pollTask(ctx, id);
+    if (poll.state === 'completed' && poll.result.url)
+        return poll.result.url;
+    if (poll.state === 'failed')
+        throw poll.error;
+    throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} has no clip for this task.`, poll.state);
+}
+/** A link refused like this has most likely expired; the task hands out a fresh one. */
+const EXPIRED = ['REMOTE_AUTH_FAILED', 'REMOTE_REJECTED'];
+export const MINIMAX_VIDEO_V2 = {
+    dialect: 'minimax-video-v2',
+    kind: 'video',
+    pollIntervalMs: { first: 5000, max: 15000 },
+    async submit(ctx, job) {
+        const body = await callV2(ctx, `${minimaxV2Base(ctx.baseUrl)}/video_generation`, {
+            json: minimaxV2Body(job),
+        });
+        const id = textOf(body['task_id']) ?? (typeof body['task_id'] === 'number' ? String(body['task_id']) : undefined);
+        if (!id)
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} answered without a task id.`);
+        return { id };
+    },
+    poll(ctx, submission) {
+        return pollTask(ctx, submission.id);
+    },
+    async download(ctx, submission, result) {
+        const first = result.url ?? (await refreshedUrl(ctx, submission.id));
+        try {
+            return await fetchClip(ctx, first);
+        }
+        catch (error) {
+            const code = error?.code;
+            if (!result.url || typeof code !== 'string' || !EXPIRED.includes(code))
+                throw error;
+            const fresh = await refreshedUrl(ctx, submission.id);
+            if (fresh === first)
+                throw error;
+            return fetchClip(ctx, fresh);
+        }
+    },
+    async cancel(ctx, submission) {
+        try {
+            await callProvider(ctx, `${minimaxV2Base(ctx.baseUrl)}/video_generation/${encodeURIComponent(submission.id)}`, {
+                method: 'DELETE',
+            });
+        }
+        catch (error) {
+            // Only a queued task can be cancelled; a running one just finishes.
+            ctx.log('debug', `${ctx.provider}: cancel of ${submission.id} refused: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=minimax-video-v2.js.map

package/dist/media/adapters/minimax-video-v2.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * `minimax-video`: MiniMax's V1 video API (Hailuo 2.3, Hailuo 2.3 Fast, Hailuo 02) on the registered
+ * base, `https://api.minimax.io/v1` (`https://api.minimaxi.com/v1` in mainland China).
+ *
+ * - submit → `POST {base}/video_generation` `{model, prompt, prompt_optimizer, duration, resolution,
+ *   first_frame_image, last_frame_image}` (frames as data URLs) → `{task_id}`;
+ * - poll → `GET {base}/query/video_generation?task_id=` → `status` Preparing | Queueing | Processing |
+ *   Success | Fail, and `file_id` once it succeeded;
+ * - download → `GET {base}/files/retrieve?file_id=` → `file.download_url` (a CDN link valid for an
+ *   hour, fetched without the key) → the clip.
+ *
+ * No cancel and no listing: the catalog names the models. V1 answers most failures as HTTP 200 with
+ * `base_resp.status_code` other than 0; `minimaxStatusError` maps those codes.
+ */
+import type { AtomicCoreError } from '../../contracts/index.js';
+import type { VideoAdapter, VideoGenerationJob } from './types.js';
+type Fields = Record<string, unknown>;
+/** A MiniMax status code (`base_resp.status_code`, a failed task's `error.code`) as a `REMOTE_*` error. */
+export declare function minimaxCodeError(provider: string, code: number, said: string | undefined): AtomicCoreError;
+/**
+ * The failure a V1 answer carries in `base_resp` (MiniMax answers errors as HTTP 200), or `undefined`
+ * when `status_code` is 0 or absent.
+ */
+export declare function minimaxStatusError(provider: string, body: unknown): AtomicCoreError | undefined;
+/** The `POST /video_generation` body: what the job set and the model offers. */
+export declare function minimaxV1Body(job: VideoGenerationJob): Fields;
+export declare const MINIMAX_VIDEO: VideoAdapter;
+export {};

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

@@ -0,0 +1,155 @@
+/**
+ * `minimax-video`: MiniMax's V1 video API (Hailuo 2.3, Hailuo 2.3 Fast, Hailuo 02) on the registered
+ * base, `https://api.minimax.io/v1` (`https://api.minimaxi.com/v1` in mainland China).
+ *
+ * - submit → `POST {base}/video_generation` `{model, prompt, prompt_optimizer, duration, resolution,
+ *   first_frame_image, last_frame_image}` (frames as data URLs) → `{task_id}`;
+ * - poll → `GET {base}/query/video_generation?task_id=` → `status` Preparing | Queueing | Processing |
+ *   Success | Fail, and `file_id` once it succeeded;
+ * - download → `GET {base}/files/retrieve?file_id=` → `file.download_url` (a CDN link valid for an
+ *   hour, fetched without the key) → the clip.
+ *
+ * No cancel and no listing: the catalog names the models. V1 answers most failures as HTTP 200 with
+ * `base_resp.status_code` other than 0; `minimaxStatusError` maps those codes.
+ */
+import { callProvider, downloadResult, joinUrl, MAX_VIDEO_BYTES, providerMessage, remoteError, sniffVideoMime, toDataUrl, } from '../http.js';
+const fields = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+/** A string, or a number the provider sent where a string id was meant. */
+const idOf = (value) => typeof value === 'string' && value.trim() !== ''
+    ? value.trim()
+    : typeof value === 'number' && Number.isFinite(value)
+        ? String(value)
+        : undefined;
+/** A MiniMax status code (`base_resp.status_code`, a failed task's `error.code`) as a `REMOTE_*` error. */
+export function minimaxCodeError(provider, code, said) {
+    const details = `status_code ${code}${said ? `: ${said}` : ''}`;
+    switch (code) {
+        case 1002:
+        case 1039:
+            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 or the model.`, 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', said ? `${provider} refused the content: ${said}` : `${provider} refused the content.`, details);
+        case 2013:
+            return remoteError('REMOTE_REJECTED', said ? `${provider}: ${said}` : `${provider} refused the request.`, details);
+        default:
+            return remoteError('REMOTE_UNAVAILABLE', said ? `${provider} failed: ${said}` : `${provider} failed.`, details);
+    }
+}
+/**
+ * The failure a V1 answer carries in `base_resp` (MiniMax answers errors as HTTP 200), or `undefined`
+ * when `status_code` is 0 or absent.
+ */
+export function minimaxStatusError(provider, body) {
+    const base = fields(fields(body)['base_resp']);
+    const raw = base['status_code'];
+    const code = typeof raw === 'number' ? raw : typeof raw === 'string' ? Number(raw) : 0;
+    if (!Number.isFinite(code) || code === 0)
+        return undefined;
+    return minimaxCodeError(provider, code, providerMessage(base));
+}
+/** One V1 request: HTTP errors as `REMOTE_*`, then a non-zero `base_resp` as one too. */
+async function callV1(ctx, url, options = {}) {
+    const answer = await callProvider(ctx, url, options);
+    const failure = minimaxStatusError(ctx.provider, answer.json);
+    if (failure)
+        throw failure;
+    return fields(answer.json);
+}
+/** 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.`);
+}
+/** The `POST /video_generation` body: what the job set and the model offers. */
+export function minimaxV1Body(job) {
+    checkInputs(job);
+    const params = job.model.params;
+    const body = { model: job.model.id };
+    if (job.prompt.trim() !== '')
+        body['prompt'] = job.prompt;
+    body['prompt_optimizer'] = true;
+    if (job.durationSecs !== undefined && params.durations)
+        body['duration'] = Math.round(job.durationSecs);
+    if (job.resolution && params.resolutions)
+        body['resolution'] = job.resolution;
+    if (job.workflow === 'image-to-video' && job.firstFrame) {
+        body['first_frame_image'] = toDataUrl(job.firstFrame.bytes, job.firstFrame.mime);
+        if (job.lastFrame)
+            body['last_frame_image'] = toDataUrl(job.lastFrame.bytes, job.lastFrame.mime);
+    }
+    return body;
+}
+/** A clip the provider pointed at, refused unless its bytes are a video. */
+async function fetchClip(ctx, url) {
+    const file = await downloadResult(ctx, 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 };
+}
+export const MINIMAX_VIDEO = {
+    dialect: 'minimax-video',
+    kind: 'video',
+    pollIntervalMs: { first: 5000, max: 15000 },
+    async submit(ctx, job) {
+        const body = await callV1(ctx, joinUrl(ctx.baseUrl, '/video_generation'), { json: minimaxV1Body(job) });
+        const id = idOf(body['task_id']);
+        if (!id)
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} answered without a task id.`);
+        return { id };
+    },
+    async poll(ctx, submission) {
+        const answer = await callProvider(ctx, joinUrl(ctx.baseUrl, `/query/video_generation?task_id=${encodeURIComponent(submission.id)}`));
+        const body = fields(answer.json);
+        const failure = minimaxStatusError(ctx.provider, body);
+        const status = typeof body['status'] === 'string' ? body['status'].toLowerCase() : '';
+        if (status === 'fail' || status === 'failed')
+            return {
+                state: 'failed',
+                error: failure ?? remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} could not make the clip.`),
+            };
+        // A refused prompt or result ends the job; any other code is the query's own failure.
+        if (failure?.code === 'REMOTE_CONTENT_BLOCKED')
+            return { state: 'failed', error: failure };
+        if (failure)
+            throw failure;
+        if (status === 'success') {
+            const fileId = idOf(body['file_id']);
+            if (!fileId)
+                return {
+                    state: 'failed',
+                    error: remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} finished without a file.`),
+                };
+            return { state: 'completed', result: { data: { file_id: fileId } } };
+        }
+        if (status === 'preparing' || status === 'queueing' || status === 'queued')
+            return { state: 'queued' };
+        return { state: 'running' };
+    },
+    async download(ctx, _submission, result) {
+        const fileId = idOf(result.data?.['file_id']);
+        if (!fileId) {
+            if (result.url)
+                return fetchClip(ctx, result.url);
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} gave no file to download.`);
+        }
+        const body = await callV1(ctx, joinUrl(ctx.baseUrl, `/files/retrieve?file_id=${encodeURIComponent(fileId)}`));
+        const url = fields(body['file'])['download_url'];
+        if (typeof url !== 'string' || url === '')
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} answered without a download link.`, fileId);
+        return fetchClip(ctx, url);
+    },
+};
+//# sourceMappingURL=minimax-video.js.map

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

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

package/dist/media/adapters/mistral-agent-image.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `mistral-agent-image`: Mistral has no image endpoint; its Agents expose an `image_generation` tool
+ * (FLUX1.1 Ultra behind it). One image is one conversation:
+ *
+ * - `POST {base}/conversations` with `{model: model.id, inputs: <instruction + prompt>, tools:
+ *   [{type: 'image_generation'}], store: false}` (base `https://api.mistral.ai/v1`);
+ * - the answer's outputs carry `tool_file` chunks (`{file_id, file_name, file_type}`), found by
+ *   walking the JSON so a reshuffled envelope still reads;
+ * - `GET {base}/files/{file_id}/content` downloads the image (the provider's own origin, so with the key).
+ *
+ * No `tool_file` means the model answered in words instead (a refusal, a question): that is
+ * `REMOTE_REJECTED` carrying what it said. `n` images are `n` conversations.
+ */
+import type { ImageAdapter, ImageGenerationJob } from './types.js';
+/** What the agent is told before the user's prompt. */
+export declare const MISTRAL_IMAGE_INSTRUCTION: string;
+/** A file the image_generation tool made. */
+export interface MistralToolFile {
+    fileId: string;
+    fileName?: string;
+    fileType?: string;
+}
+/**
+ * The `tool_file` chunks of a conversation answer, in order, and the text the model said, wherever
+ * they sit (`outputs[].content[]` today).
+ */
+export declare function mistralToolFiles(json: unknown): {
+    files: MistralToolFile[];
+    text: string;
+};
+/** The conversation that makes one image. */
+export declare function mistralConversation(job: ImageGenerationJob): Record<string, unknown>;
+export declare const MISTRAL_AGENT_IMAGE: ImageAdapter;

package/dist/media/adapters/mistral-agent-image.js

@@ -0,0 +1,108 @@
+/**
+ * `mistral-agent-image`: Mistral has no image endpoint; its Agents expose an `image_generation` tool
+ * (FLUX1.1 Ultra behind it). One image is one conversation:
+ *
+ * - `POST {base}/conversations` with `{model: model.id, inputs: <instruction + prompt>, tools:
+ *   [{type: 'image_generation'}], store: false}` (base `https://api.mistral.ai/v1`);
+ * - the answer's outputs carry `tool_file` chunks (`{file_id, file_name, file_type}`), found by
+ *   walking the JSON so a reshuffled envelope still reads;
+ * - `GET {base}/files/{file_id}/content` downloads the image (the provider's own origin, so with the key).
+ *
+ * No `tool_file` means the model answered in words instead (a refusal, a question): that is
+ * `REMOTE_REJECTED` carrying what it said. `n` images are `n` conversations.
+ */
+import { callProvider, downloadResult, GENERATE_TIMEOUT_MS, joinUrl, MAX_IMAGE_BYTES, remoteError, sniffImageMime, } from '../http.js';
+/** What the agent is told before the user's prompt. */
+export const MISTRAL_IMAGE_INSTRUCTION = 'Generate exactly one image with the image_generation tool. Do not ask questions and do not describe the ' +
+    'image; call the tool once with this description:';
+/** How deep the answer is walked; its chunks sit three or four levels down. */
+const MAX_DEPTH = 8;
+/**
+ * The `tool_file` chunks of a conversation answer, in order, and the text the model said, wherever
+ * they sit (`outputs[].content[]` today).
+ */
+export function mistralToolFiles(json) {
+    const files = [];
+    const said = [];
+    const seen = new Set();
+    const visit = (value, depth) => {
+        if (depth > MAX_DEPTH || value === null || typeof value !== 'object')
+            return;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                visit(item, depth + 1);
+            return;
+        }
+        const fields = value;
+        const type = fields['type'];
+        const fileId = fields['file_id'];
+        if (type === 'tool_file' && typeof fileId === 'string' && fileId !== '') {
+            if (!seen.has(fileId)) {
+                seen.add(fileId);
+                const file = { fileId };
+                if (typeof fields['file_name'] === 'string')
+                    file.fileName = fields['file_name'];
+                if (typeof fields['file_type'] === 'string')
+                    file.fileType = fields['file_type'];
+                files.push(file);
+            }
+            return;
+        }
+        if (type === 'text' && typeof fields['text'] === 'string')
+            said.push(fields['text']);
+        else if (type === 'message.output' && typeof fields['content'] === 'string')
+            said.push(fields['content']);
+        for (const [key, item] of Object.entries(fields))
+            if (key !== 'usage')
+                visit(item, depth + 1);
+    };
+    visit(json, 0);
+    return { files, text: said.join(' ').replace(/\s+/g, ' ').trim() };
+}
+/** The conversation that makes one image. */
+export function mistralConversation(job) {
+    return {
+        model: job.model.id,
+        inputs: `${MISTRAL_IMAGE_INSTRUCTION}\n\n${job.prompt}`,
+        tools: [{ type: 'image_generation' }],
+        store: false,
+    };
+}
+async function oneImage(ctx, job) {
+    const answer = await callProvider(ctx, joinUrl(ctx.baseUrl, '/conversations'), {
+        json: mistralConversation(job),
+        timeoutMs: GENERATE_TIMEOUT_MS,
+    });
+    const { files, text } = mistralToolFiles(answer.json);
+    if (files.length === 0)
+        throw remoteError('REMOTE_REJECTED', text ? `${ctx.provider}: ${text.slice(0, 300)}` : `${ctx.provider} answered without an image.`, text.slice(0, 1000) || undefined);
+    const out = [];
+    // The tool makes one image per call; a second file is taken too rather than dropped.
+    for (const file of files) {
+        const url = joinUrl(ctx.baseUrl, `/files/${encodeURIComponent(file.fileId)}/content`);
+        const { bytes } = await downloadResult(ctx, url, { maxBytes: MAX_IMAGE_BYTES, what: 'image' });
+        const mime = sniffImageMime(bytes);
+        if (!mime)
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} returned a file that is not an image.`, file.fileId);
+        out.push({ bytes, mime });
+    }
+    return out;
+}
+export const MISTRAL_AGENT_IMAGE = {
+    dialect: 'mistral-agent-image',
+    kind: 'image',
+    async generate(ctx, job, report) {
+        report({ phase: 'generating' });
+        if (job.workflow !== 'create')
+            throw remoteError('REMOTE_UNSUPPORTED', 'This model only creates images from a prompt here.', job.workflow);
+        const count = Math.max(1, job.n);
+        const out = [];
+        while (out.length < count) {
+            out.push(...(await oneImage(ctx, job)));
+            if (count > 1)
+                report({ phase: 'generating', fraction: Math.min(out.length / count, 1) });
+        }
+        return out.slice(0, count);
+    },
+};
+//# sourceMappingURL=mistral-agent-image.js.map

package/dist/media/adapters/mistral-agent-image.js.map

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

package/dist/media/adapters/nvidia-genai.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `nvidia-genai`: NVIDIA's Visual GenAI image models — the hosted API catalog and self-hosted NIMs.
+ *
+ * Where a request goes:
+ * - the API catalog (registered base `https://integrate.api.nvidia.com/v1`) serves visual models on a
+ *   different host: `POST https://ai.api.nvidia.com/v1/genai/{model.id}`. This host mapping is
+ *   hardcoded here — the one sanctioned exception to "every URL from the base" — and applies only
+ *   when the base's host is `integrate.api.nvidia.com`;
+ * - any other base is a self-hosted NIM: `POST {base without its /v1}/v1/infer`.
+ *
+ * The body follows the model's `options.schema` (each NVIDIA endpoint rejects fields it does not
+ * know): `flux-schnell`, `flux-dev`, `flux2-klein`, `sd3`; a model without one gets the prompt and
+ * only what the job set. The answer is `{artifacts: [{base64, finishReason, seed}]}` (SD3:
+ * `{image, finish_reason, seed}`), one JPEG per call, so `n` images are `n` calls. A
+ * `CONTENT_FILTERED` finish is `REMOTE_CONTENT_BLOCKED`. When the hosted API answers 202 (NVCF: the
+ * job outlived its synchronous window) the request id is polled on
+ * `https://ai.api.nvidia.com/v1/status/{id}` — NVIDIA documents several spellings of that path and
+ * none for these models, so this one is unverified; a wrong one ends as the provider's 404.
+ */
+import type { MediaContext } from '../http.js';
+import type { GeneratedImage, ImageAdapter, ImageGenerationJob } from './types.js';
+/** Where a model's generation goes (see the file comment). */
+export declare function nvidiaInferUrl(baseUrl: string, modelId: string): string;
+/** The request body for image `index` of a job, by the model's `options.schema`. */
+export declare function nvidiaBody(job: ImageGenerationJob, index?: number): Record<string, unknown>;
+/** The images of an answer; a filtered or failed finish throws. */
+export declare function nvidiaImages(ctx: Pick<MediaContext, 'provider'>, json: unknown): GeneratedImage[];
+export declare const NVIDIA_GENAI: ImageAdapter;