@jini-ai/integrations 0.1.0

package/dist/media-providers/dispatch/providers/openai.js

@@ -0,0 +1,231 @@
+/**
+ * Provider: OpenAI Images API (gpt-image-2, gpt-image-1.5, dall-e-3, ...)
+ * and text-to-speech via `/v1/audio/speech`. Ported near-verbatim from
+ * Open Design's `apps/daemon/src/media/index.ts` `renderOpenAIImage`/
+ * `renderOpenAISpeech` — see `source-map.md`.
+ *
+ * 2026-07-21: migrated onto the generic vendor-adapter dispatch engine
+ * (`vendor-adapter.ts`/`vendor-registry.ts`). External behavior is
+ * unchanged (verified against `openai.test.ts`, which asserts URL/body/
+ * header/error-message/providerNote shape and passes unmodified) — only
+ * the internal implementation moved into two registered `VendorAdapter`s.
+ * `renderOpenAISpeech`'s response (raw bytes, no envelope) is the same
+ * shape `fishaudio.ts` returns, so it now shares
+ * `response-parsers.ts`'s `createRawBytesParser`. `renderOpenAIImage`
+ * keeps a custom `parseResponse`, deliberately NOT routed through
+ * `openai-compatible.ts`'s `parseOpenAICompatibleJson`/
+ * `bytesFromOpenAICompatibleData` helpers despite the superficially
+ * matching `{ data: [...] }` shape: the origin's non-JSON-parse-failure
+ * error message is the literal string `"openai non-JSON response: ..."`
+ * regardless of whether the request was Azure-routed (unlike its
+ * non-OK-status error, which IS azure-tag-aware) — a real, tested
+ * asymmetry in the origin (`openai.test.ts` has no azure-tagged non-JSON
+ * assertion, and the origin's own catch block never references the azure
+ * tag at all). Forcing this through the shared helper (which always tags
+ * both messages the same way) would have silently changed that specific
+ * corner's message text — exactly the kind of behavior drift this port's
+ * "no scope cuts" constraint forbids, so it stays a bespoke parser
+ * instead.
+ *
+ * Supports both the canonical OpenAI endpoint AND Azure-hosted OpenAI
+ * deployments behind the same provider slot — Azure is detected from the
+ * base URL (`*.azure.com` host or a `/deployments/<name>` path segment).
+ * For Azure this additionally:
+ *   - appends `?api-version=...` (default 2024-02-01, unless the caller
+ *     already encoded one into the base URL),
+ *   - sends the `api-key` header in addition to `Authorization` (Azure
+ *     accepts either; some deployments only honor `api-key`),
+ *   - drops the `model` field from the body, since the deployment in the
+ *     path already names the model.
+ *
+ * Dropped from the origin: the local Codex-CLI-subscription image
+ * fallback (`codex-gpt-image-2` etc.) — an OD-specific local-CLI-login
+ * integration already excluded from `providers.ts`'s catalogue, not a REST
+ * credential shape any other Jini consumer could use.
+ */
+import { FETCH_TIMEOUT_MS, fetchWithTimeout } from '@jini-ai/platform';
+import { Agent as UndiciAgent } from 'undici';
+import { buildOpenAIImageUrl, buildOpenAISpeechUrl, detectAzureEndpoint, openaiSizeFor, OPENAI_TTS_VOICES, truncate, withRequestInit, } from '../openai-compatible.js';
+import { createRawBytesParser } from '../response-parsers.js';
+import { dispatchVendorRequest, requireApiKey } from '../vendor-adapter.js';
+import { mediaVendorRegistry } from '../vendor-registry.js';
+// Image generation can legitimately take minutes (gpt-image-2 4K renders
+// especially). A generous default headers/body timeout dispatcher is
+// applied so a caller-configured global fetch default doesn't cut a
+// legitimately-slow-but-succeeding generation short; a caller can still
+// override via `requestInit.dispatcher`.
+const OPENAI_IMAGE_HEADERS_TIMEOUT_MS = 10 * 60 * 1000;
+const OPENAI_IMAGE_BODY_TIMEOUT_MS = 10 * 60 * 1000;
+const openAIImageDispatcher = new UndiciAgent({
+    headersTimeout: OPENAI_IMAGE_HEADERS_TIMEOUT_MS,
+    bodyTimeout: OPENAI_IMAGE_BODY_TIMEOUT_MS,
+});
+const OPENAI_IMAGE_NO_CREDENTIAL_MESSAGE = 'no OpenAI credential — configure an API key or set OPENAI_API_KEY.';
+const OPENAI_SPEECH_NO_CREDENTIAL_MESSAGE = 'no OpenAI credential — configure an API key or set OPENAI_API_KEY';
+const openAIImageAdapter = {
+    requireCredential: requireApiKey(OPENAI_IMAGE_NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const rawBase = credentials.baseUrl || 'https://api.openai.com/v1';
+        const azure = detectAzureEndpoint(rawBase);
+        const url = buildOpenAIImageUrl(rawBase, azure);
+        const body = {
+            prompt: ctx.prompt || 'A high-quality reference image.',
+            n: 1,
+            size: openaiSizeFor(ctx.model, ctx.aspect),
+        };
+        // For non-Azure calls, include `model` in the body. Azure infers it from
+        // the deployment in the path so omitting it keeps payloads compatible
+        // across both flavors. The wire-name (post-alias) goes on the body so a
+        // host's model-aliasing layer, if any, reaches the API.
+        if (!azure) {
+            body.model = ctx.wireModel;
+        }
+        // Capability branches key off the CATALOG id (not the wire alias) so a
+        // host that aliased `dall-e-3` to a custom Azure/proxy deployment still
+        // gets the DALL-E-specific quality + response_format flags.
+        if (ctx.model.startsWith('dall-e-')) {
+            body.response_format = 'b64_json';
+            body.quality = ctx.model === 'dall-e-3' ? 'hd' : 'standard';
+        }
+        else {
+            // gpt-image-* accepts quality 'high' | 'medium' | 'low'.
+            body.quality = 'high';
+        }
+        const headers = {
+            authorization: `Bearer ${apiKey}`,
+            'content-type': 'application/json',
+        };
+        if (azure) {
+            // Azure's canonical auth header. Some deployments accept Bearer too,
+            // but api-key is what their docs document, so both are sent. OpenAI
+            // ignores unknown headers, so this is harmless on the standard
+            // endpoint too.
+            headers['api-key'] = apiKey;
+        }
+        return {
+            url,
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+                dispatcher: ctx.requestInit.dispatcher ?? openAIImageDispatcher,
+                signal: AbortSignal.timeout(Math.max(OPENAI_IMAGE_HEADERS_TIMEOUT_MS, OPENAI_IMAGE_BODY_TIMEOUT_MS)),
+            }),
+            meta: { tag: azure ? 'azure-openai' : 'openai', wireModel: ctx.wireModel },
+        };
+    },
+    async parseResponse(resp, ctx, request) {
+        const text = await resp.text();
+        if (!resp.ok) {
+            throw new Error(`${request.meta.tag} ${resp.status}: ${truncate(text, 240)}`);
+        }
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            // Deliberately not azure-tag-aware — matches the origin exactly, see
+            // this module's doc comment for why.
+            throw new Error(`openai non-JSON response: ${truncate(text, 200)}`);
+        }
+        const entry = Array.isArray(data.data) ? data.data[0] : null;
+        if (!entry)
+            throw new Error('openai response had no data[0]');
+        let bytes;
+        if (entry.b64_json) {
+            bytes = Buffer.from(entry.b64_json, 'base64');
+        }
+        else if (entry.url) {
+            // Downloading already-generated bytes, not waiting on generation — UPLOAD-class (2min), not
+            // the 10-minute GENERATE-class timeout the generation call itself uses above.
+            const imgResp = await fetchWithTimeout(entry.url, withRequestInit(ctx), { timeoutMs: FETCH_TIMEOUT_MS.UPLOAD });
+            if (!imgResp.ok)
+                throw new Error(`openai image fetch ${imgResp.status}`);
+            const arr = await imgResp.arrayBuffer();
+            bytes = Buffer.from(arr);
+        }
+        else {
+            throw new Error('openai response had neither b64_json nor url');
+        }
+        return {
+            bytes,
+            providerNote: `${request.meta.tag}/${request.meta.wireModel} · ${ctx.aspect} · ${bytes.length} bytes`,
+            suggestedExt: '.png',
+        };
+    },
+};
+mediaVendorRegistry.register('openai', 'image', openAIImageAdapter);
+export async function renderOpenAIImage(ctx, credentials) {
+    return dispatchVendorRequest(openAIImageAdapter, ctx, credentials);
+}
+const openAISpeechAdapter = {
+    requireCredential: requireApiKey(OPENAI_SPEECH_NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const rawBase = credentials.baseUrl || 'https://api.openai.com/v1';
+        const azure = detectAzureEndpoint(rawBase);
+        const url = buildOpenAISpeechUrl(rawBase, azure);
+        const format = ctx.speechFormat;
+        const text = (ctx.prompt && ctx.prompt.trim()) || 'This is a test.';
+        let voiceId = 'alloy';
+        let instructions = '';
+        const requestedVoice = (ctx.voice && ctx.voice.trim()) || '';
+        if (requestedVoice) {
+            if (OPENAI_TTS_VOICES.has(requestedVoice)) {
+                voiceId = requestedVoice;
+            }
+            else {
+                // gpt-4o-mini-tts accepts free-form speaking-style instructions. If
+                // the caller passed prose rather than a concrete voice id, preserve
+                // it here instead of surfacing a provider error.
+                instructions = requestedVoice;
+            }
+        }
+        const body = {
+            input: text,
+            voice: voiceId,
+            response_format: format,
+        };
+        if (!azure) {
+            body.model = ctx.wireModel;
+        }
+        if (instructions && ctx.model === 'gpt-4o-mini-tts') {
+            body.instructions = instructions;
+        }
+        const headers = {
+            authorization: `Bearer ${apiKey}`,
+            'content-type': 'application/json',
+        };
+        if (azure) {
+            headers['api-key'] = apiKey;
+        }
+        return {
+            url,
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+            }),
+            meta: { tag: azure ? 'azure-openai' : 'openai', wireModel: ctx.wireModel, voiceId, format, instructions },
+        };
+    },
+    parseResponse: createRawBytesParser({
+        errorTag: (meta) => `${meta.tag} speech`,
+        // Deliberately not azure-tag-aware — matches the origin exactly (see
+        // this module's doc comment).
+        zeroBytesMessage: 'openai speech returned zero bytes',
+        note: (bytes, meta) => {
+            const noteBits = [`${meta.tag}/${meta.wireModel}`, meta.voiceId, meta.format, `${bytes.length} bytes`];
+            if (meta.instructions)
+                noteBits.splice(2, 0, 'styled');
+            return noteBits.join(' · ');
+        },
+        suggestedExt: (_bytes, meta) => (meta.format === 'opus' ? '.ogg' : `.${meta.format}`),
+    }),
+};
+mediaVendorRegistry.register('openai', 'audio:speech', openAISpeechAdapter);
+export async function renderOpenAISpeech(ctx, credentials) {
+    return dispatchVendorRequest(openAISpeechAdapter, ctx, credentials);
+}
+//# sourceMappingURL=openai.js.map

package/dist/media-providers/dispatch/providers/openai.js.map

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

package/dist/media-providers/dispatch/providers/openrouter.d.ts

@@ -0,0 +1,13 @@
+import type { ProviderCredentials, RenderContext, RenderResult } from '../types.js';
+/**
+ * OpenRouter normalizes aspect ratios across the providers it fronts;
+ * `providers.ts`'s `MEDIA_ASPECTS` are all natively supported, default to
+ * 16:9 for anything else. Written as independent `if` returns (rather than
+ * the origin's one `||`-chained condition) to match this package's
+ * established aspect-mapping style (see `imagerouter.ts`'s
+ * `imageRouterSizeFor`) — same input -> output mapping for every case, not
+ * a behavior change.
+ */
+export declare function openRouterAspectFor(aspect: string | undefined): string;
+export declare function renderOpenRouterImage(ctx: RenderContext, credentials: ProviderCredentials): Promise<RenderResult>;
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/media-providers/dispatch/providers/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../../../src/media-providers/dispatch/providers/openrouter.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAYpF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOtE;AAmGD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAEvH"}

package/dist/media-providers/dispatch/providers/openrouter.js

@@ -0,0 +1,152 @@
+/**
+ * Provider: OpenRouter — unified multi-vendor image generation via the
+ * Chat Completions API (`POST /chat/completions` with
+ * `modalities: ["image"]`), not the dedicated `/images/generations` shape
+ * OpenRouter's own *video* generation uses. Ported near-verbatim from Open
+ * Design's `apps/daemon/src/media/index.ts` `renderOpenRouterImage` — see
+ * `source-map.md`.
+ *
+ * Not OpenAI-images-wire-compatible (chat-completions request shape;
+ * `choices[0].message.images[].image_url.url` response shape), so this
+ * does not route through `openai-compatible.ts`'s OpenAI-images helpers —
+ * only its vendor-agnostic utilities (`truncate`, `sniffImageExt`,
+ * `withRequestInit`) are reused.
+ *
+ * Dropped from the origin: the `HTTP-Referer: https://opendesign.dev` /
+ * `X-Title: Open Design` request headers — these are OpenRouter's optional
+ * app-attribution headers (used for their model leaderboard, not required
+ * for the request to succeed) and both values are OD product identity, out
+ * of scope per AGENTS.md's no-product-identity-strings boundary. This
+ * package has no host-identity concept to substitute one with; a host that
+ * wants attribution would need its own request-building layer.
+ *
+ * 2026-07-21: migrated onto the generic vendor-adapter dispatch engine
+ * (`vendor-adapter.ts`/`vendor-registry.ts`). External behavior is
+ * unchanged (verified against `openrouter.test.ts`, which asserts URL/
+ * body/header/error-message/providerNote shape and passes unmodified) —
+ * only the internal implementation moved into a registered
+ * `VendorAdapter`. Not routed through `response-parsers.ts`'s factories —
+ * the three-way image-decode (`data:` URI / http(s) download / bare
+ * base64) has no other current consumer, so it correctly stays a bespoke
+ * `parseResponse`.
+ */
+import { FETCH_TIMEOUT_MS, fetchWithTimeout } from '@jini-ai/platform';
+import { sniffImageExt, truncate, withRequestInit } from '../openai-compatible.js';
+import { dispatchVendorRequest, requireApiKey } from '../vendor-adapter.js';
+import { mediaVendorRegistry } from '../vendor-registry.js';
+// Chat-completions image generation can take a while for some routed
+// models; matches the same 10-minute ceiling `openai.ts`'s image dispatcher
+// uses for the same reason (see `OPENAI_IMAGE_HEADERS_TIMEOUT_MS`/
+// `OPENAI_IMAGE_BODY_TIMEOUT_MS` there — this vendor has no separate
+// headers/body distinction, so a single `AbortSignal.timeout` suffices).
+const OPENROUTER_IMAGE_TIMEOUT_MS = 10 * 60 * 1000;
+/**
+ * OpenRouter normalizes aspect ratios across the providers it fronts;
+ * `providers.ts`'s `MEDIA_ASPECTS` are all natively supported, default to
+ * 16:9 for anything else. Written as independent `if` returns (rather than
+ * the origin's one `||`-chained condition) to match this package's
+ * established aspect-mapping style (see `imagerouter.ts`'s
+ * `imageRouterSizeFor`) — same input -> output mapping for every case, not
+ * a behavior change.
+ */
+export function openRouterAspectFor(aspect) {
+    if (aspect === '1:1')
+        return '1:1';
+    if (aspect === '16:9')
+        return '16:9';
+    if (aspect === '9:16')
+        return '9:16';
+    if (aspect === '4:3')
+        return '4:3';
+    if (aspect === '3:4')
+        return '3:4';
+    return '16:9';
+}
+const NO_CREDENTIAL_MESSAGE = 'no OpenRouter API key — configure it or set OPENROUTER_API_KEY';
+const openRouterImageAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const baseUrl = (credentials.baseUrl || 'https://openrouter.ai/api/v1').replace(/\/$/, '');
+        // credentials.model (a host's own model-aliasing layer) wins over
+        // ctx.wireModel; strip the catalogue's `openrouter/` prefix so the wire
+        // model name matches OpenRouter's canonical slug.
+        const resolved = (credentials.model || ctx.wireModel).trim();
+        const wireModel = resolved.startsWith('openrouter/') ? resolved.slice('openrouter/'.length) : resolved;
+        // Multi-modal models (Gemini variants) accept both image and text
+        // output; image-only models (Flux, Recraft, Sourceful) only accept
+        // ["image"]. A simple heuristic on the slug, matching the origin.
+        const modalities = wireModel.includes('gemini') ? ['image', 'text'] : ['image'];
+        const aspectRatio = openRouterAspectFor(ctx.aspect);
+        const body = {
+            model: wireModel,
+            messages: [{ role: 'user', content: ctx.prompt || 'A high-quality reference image.' }],
+            modalities,
+            stream: false,
+            image_config: { aspect_ratio: aspectRatio, image_size: '1K' },
+        };
+        return {
+            url: `${baseUrl}/chat/completions`,
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(OPENROUTER_IMAGE_TIMEOUT_MS),
+            }),
+            meta: { wireModel, aspectRatio },
+        };
+    },
+    async parseResponse(resp, ctx, request) {
+        const { wireModel, aspectRatio } = request.meta;
+        const text = await resp.text();
+        if (!resp.ok) {
+            throw new Error(`openrouter image ${resp.status}: ${truncate(text, 240)}`);
+        }
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`openrouter image non-JSON response: ${truncate(text, 200)}`);
+        }
+        const images = data?.choices?.[0]?.message?.images;
+        if (!Array.isArray(images) || images.length === 0) {
+            throw new Error(`openrouter image response contained no images for model ${wireModel}: ${truncate(text, 200)}`);
+        }
+        const dataUrl = images[0]?.image_url?.url;
+        if (typeof dataUrl !== 'string' || !dataUrl) {
+            throw new Error(`openrouter image response missing image_url.url: ${truncate(text, 200)}`);
+        }
+        // Strip a "data:image/...;base64," prefix and decode; fall back to
+        // downloading a plain URL, or treating the string as raw base64.
+        const b64Match = dataUrl.match(/^data:image\/[^;]+;base64,(.+)$/s);
+        let bytes;
+        if (b64Match) {
+            bytes = Buffer.from(b64Match[1], 'base64');
+        }
+        else if (dataUrl.startsWith('http')) {
+            // Downloading already-generated bytes, not waiting on generation — UPLOAD-class (2min), not
+            // the 10-minute GENERATE-class timeout the chat-completions call itself uses above.
+            const imgResp = await fetchWithTimeout(dataUrl, withRequestInit(ctx), { timeoutMs: FETCH_TIMEOUT_MS.UPLOAD });
+            if (!imgResp.ok)
+                throw new Error(`openrouter image download ${imgResp.status}`);
+            bytes = Buffer.from(await imgResp.arrayBuffer());
+        }
+        else {
+            bytes = Buffer.from(dataUrl, 'base64');
+        }
+        return {
+            bytes,
+            providerNote: `openrouter/${wireModel} · ${aspectRatio} · ${bytes.length} bytes`,
+            suggestedExt: sniffImageExt(bytes),
+        };
+    },
+};
+mediaVendorRegistry.register('openrouter', 'image', openRouterImageAdapter);
+export async function renderOpenRouterImage(ctx, credentials) {
+    return dispatchVendorRequest(openRouterImageAdapter, ctx, credentials);
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/media-providers/dispatch/providers/openrouter.js.map

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

package/dist/media-providers/dispatch/providers/senseaudio.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderCredentials, RenderContext, RenderResult } from '../types.js';
+export declare function renderSenseAudioTTS(ctx: RenderContext, credentials: ProviderCredentials): Promise<RenderResult>;
+export declare function renderSenseAudioImage(ctx: RenderContext, credentials: ProviderCredentials): Promise<RenderResult>;
+//# sourceMappingURL=senseaudio.d.ts.map

package/dist/media-providers/dispatch/providers/senseaudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senseaudio.d.ts","sourceRoot":"","sources":["../../../../src/media-providers/dispatch/providers/senseaudio.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA8DpF,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAErH;AA0GD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAEvH"}

package/dist/media-providers/dispatch/providers/senseaudio.js

@@ -0,0 +1,190 @@
+/**
+ * Provider: SenseAudio — `senseaudio-tts-1.5` text-to-speech
+ * (`renderSenseAudioTTS`, `POST /v1/t2a_v2`) and text-to-image
+ * (`renderSenseAudioImage`, `POST /v1/image/sync`), both synchronous.
+ * Ported near-verbatim from Open Design's
+ * `apps/daemon/src/media/index.ts` `renderSenseAudioTTS`/
+ * `renderSenseAudioImage` — see `source-map.md`.
+ *
+ * 2026-07-21: migrated onto the generic vendor-adapter dispatch engine
+ * (`vendor-adapter.ts`/`vendor-registry.ts`). External behavior (URLs,
+ * bodies, headers, every error message, `providerNote` format, the SSRF
+ * guard on the image download) is unchanged; only the internal
+ * implementation moved into two registered `VendorAdapter`s. TTS's
+ * response envelope is identical to `minimax.ts`'s, so both now share
+ * `response-parsers.ts`'s `createHexEnvelopeAudioParser`. Image's response
+ * (`{ url }`, downloaded through an SSRF-guarded second fetch, with two
+ * independent failure-signaling paths — `base_resp` AND a separate
+ * `error_message`) has no equivalent elsewhere in this package, so it
+ * keeps a custom `parseResponse` — the generic engine's `parseResponse`
+ * hook is a full function precisely so a second network call mid-parse
+ * (the SSRF-guarded download) stays possible; see `vendor-adapter.ts`'s
+ * module doc.
+ *
+ * Neither endpoint is OpenAI-wire-compatible: TTS mirrors MiniMax's own
+ * `voice_setting`/`audio_setting` body shape and `base_resp` response
+ * envelope (an HTTP 200 can still be a logical failure), and image returns
+ * `{ url }` rather than `{ data: [...] }`, so only the generic
+ * `withRequestInit` helper is reused from `openai-compatible.ts` (matching
+ * `minimax.ts`'s reasoning).
+ *
+ * `renderSenseAudioImage`'s `url` is fetched through `ssrf-guard.ts`'s
+ * `assertAndFetchExternalAsset` — same as the real origin — because it is
+ * attacker-controllable inside an otherwise-successful response (a
+ * compromised/misconfigured gateway could point it at internal
+ * infrastructure); `assertAndFetchExternalAsset` DNS-resolves the host,
+ * rejects loopback/RFC1918/link-local/CGNAT/metadata-service addresses,
+ * and pins `redirect: 'error'` so a validated public URL can't 302 into
+ * private space either.
+ *
+ * Dropped from the origin's no-credential error messages (both
+ * functions): the `OD_`-prefixed override env var
+ * (`OD_SENSEAUDIO_API_KEY`) — `providers.ts`'s
+ * `PROVIDER_CREDENTIAL_ENV_VARS.senseaudio` already de-branded this to
+ * plain `SENSEAUDIO_API_KEY`.
+ */
+import { truncate, withRequestInit } from '../openai-compatible.js';
+import { createHexEnvelopeAudioParser } from '../response-parsers.js';
+import { assertAndFetchExternalAsset } from '../ssrf-guard.js';
+import { dispatchVendorRequest, requireApiKey } from '../vendor-adapter.js';
+import { mediaVendorRegistry } from '../vendor-registry.js';
+const SENSEAUDIO_DEFAULT_BASE_URL = 'https://api.senseaudio.cn';
+const SENSEAUDIO_DEFAULT_VOICE_ID = 'female_0033_b';
+const SENSEAUDIO_IMAGE_PROMPT_LIMIT = 2000;
+const SENSEAUDIO_TTS_MODEL_MAP = {
+    'senseaudio-tts': 'senseaudio-tts-1.5-260319',
+};
+const NO_CREDENTIAL_MESSAGE = 'no SenseAudio credential — configure an API key or set SENSEAUDIO_API_KEY.';
+const senseAudioTTSAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const baseUrl = (credentials.baseUrl || SENSEAUDIO_DEFAULT_BASE_URL).replace(/\/$/, '');
+        const wireModel = SENSEAUDIO_TTS_MODEL_MAP[ctx.model] || ctx.model;
+        const text = (ctx.prompt && ctx.prompt.trim()) || 'This is a test.';
+        const voiceId = (ctx.voice && ctx.voice.trim()) || SENSEAUDIO_DEFAULT_VOICE_ID;
+        const body = {
+            model: wireModel,
+            text,
+            stream: false,
+            voice_setting: {
+                voice_id: voiceId,
+                speed: 1,
+                vol: 1,
+                pitch: 0,
+            },
+            audio_setting: {
+                format: 'mp3',
+                sample_rate: 32000,
+                bitrate: 128000,
+                channel: 2,
+            },
+        };
+        return {
+            url: `${baseUrl}/v1/t2a_v2`,
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            }),
+            meta: { wireModel, voiceId },
+        };
+    },
+    parseResponse: createHexEnvelopeAudioParser({ errorTag: 'senseaudio tts', providerId: 'senseaudio' }),
+};
+mediaVendorRegistry.register('senseaudio', 'audio:speech', senseAudioTTSAdapter);
+export async function renderSenseAudioTTS(ctx, credentials) {
+    return dispatchVendorRequest(senseAudioTTSAdapter, ctx, credentials);
+}
+/** SenseAudio's image gateway rejects non-standard pixel sizes with a 400; keep this mapping in sync with any other SenseAudio-image call site a future host adds. */
+function senseAudioImageSize(aspect) {
+    if (aspect === '16:9')
+        return '1280x720';
+    if (aspect === '9:16')
+        return '720x1280';
+    if (aspect === '4:3')
+        return '1024x768';
+    if (aspect === '3:4')
+        return '768x1024';
+    return '1024x1024';
+}
+const senseAudioImageAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const baseUrl = (credentials.baseUrl || SENSEAUDIO_DEFAULT_BASE_URL).replace(/\/$/, '');
+        const promptRaw = (ctx.prompt && ctx.prompt.trim()) || 'A high-quality reference image.';
+        // SenseAudio rejects prompts over 2000 chars with a 4xx; trim
+        // defensively so a verbose caller doesn't dead-end the generation.
+        const prompt = promptRaw.length > SENSEAUDIO_IMAGE_PROMPT_LIMIT ? promptRaw.slice(0, SENSEAUDIO_IMAGE_PROMPT_LIMIT) : promptRaw;
+        const size = senseAudioImageSize(ctx.aspect);
+        const reference = ctx.imageRef?.dataUrl;
+        const body = {
+            model: ctx.wireModel,
+            prompt,
+            size,
+        };
+        if (reference) {
+            // The API documents `size` as optional when a reference image is
+            // supplied; it is still sent so output dimensions stay deterministic
+            // across t2i/i2i calls for the same model.
+            body.reference = reference;
+        }
+        return {
+            url: `${baseUrl}/v1/image/sync`,
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            }),
+            meta: { size, hasReference: Boolean(reference) },
+        };
+    },
+    async parseResponse(resp, ctx, request) {
+        const respText = await resp.text();
+        if (!resp.ok) {
+            throw new Error(`senseaudio image ${resp.status}: ${truncate(respText, 240)}`);
+        }
+        let data;
+        try {
+            data = JSON.parse(respText);
+        }
+        catch {
+            throw new Error(`senseaudio image non-JSON: ${truncate(respText, 200)}`);
+        }
+        if (data.base_resp && data.base_resp.status_code !== 0) {
+            throw new Error(`senseaudio image api error ${data.base_resp.status_code}: ${data.base_resp.status_msg || 'unknown'}`);
+        }
+        if (typeof data.error_message === 'string' && data.error_message) {
+            throw new Error(`senseaudio image api error: ${data.error_message}`);
+        }
+        const url = typeof data.url === 'string' ? data.url : '';
+        if (!url) {
+            throw new Error('senseaudio image response missing url');
+        }
+        const imgResp = await assertAndFetchExternalAsset(url, withRequestInit(ctx));
+        if (!imgResp.ok) {
+            throw new Error(`senseaudio image fetch ${imgResp.status}`);
+        }
+        const bytes = Buffer.from(await imgResp.arrayBuffer());
+        if (bytes.length === 0) {
+            throw new Error('senseaudio image fetch returned zero bytes');
+        }
+        return {
+            bytes,
+            providerNote: `senseaudio/${ctx.wireModel} · ${request.meta.size}${request.meta.hasReference ? ' · i2i' : ''} · ${bytes.length} bytes`,
+            suggestedExt: '.png',
+        };
+    },
+};
+mediaVendorRegistry.register('senseaudio', 'image', senseAudioImageAdapter);
+export async function renderSenseAudioImage(ctx, credentials) {
+    return dispatchVendorRequest(senseAudioImageAdapter, ctx, credentials);
+}
+//# sourceMappingURL=senseaudio.js.map

package/dist/media-providers/dispatch/providers/senseaudio.js.map

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

package/dist/media-providers/dispatch/providers/volcengine.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderCredentials, RenderContext, RenderResult } from '../types.js';
+export declare function renderVolcengineImage(ctx: RenderContext, credentials: ProviderCredentials): Promise<RenderResult>;
+//# sourceMappingURL=volcengine.d.ts.map

package/dist/media-providers/dispatch/providers/volcengine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volcengine.d.ts","sourceRoot":"","sources":["../../../../src/media-providers/dispatch/providers/volcengine.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmDpF,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAEvH"}