@jini-ai/integrations 0.1.0

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

@@ -0,0 +1,150 @@
+/**
+ * Provider: xAI Grok — image generation via an OpenAI-images-compatible
+ * `/images/generations` endpoint (`renderGrokImage`), plus text-to-speech
+ * via a dedicated `/tts` endpoint (`renderXAITTS`). Ported near-verbatim
+ * from Open Design's `apps/daemon/src/media/index.ts` `renderGrokImage`/
+ * `renderXAITTS` — see `source-map.md`.
+ *
+ * Image response shape (`{ data: [{ b64_json | url }] }`) is identical to
+ * OpenAI's images API, so `renderGrokImage` routes through
+ * `openai-compatible.ts`'s already-ported JSON-parsing/byte-extraction/
+ * URL-building helpers rather than re-implementing them. `/tts` is xAI's
+ * own dedicated endpoint (not the OpenAI `/audio/speech` shape) — it
+ * returns raw audio bytes directly from a plain JSON POST, with no
+ * per-request format negotiation the caller can control, so `renderXAITTS`
+ * doesn't route through `openai-compatible.ts` at all (only the generic
+ * `truncate`/`withRequestInit` helpers are shared).
+ *
+ * Dropped from the origin's no-credential error messages (both
+ * functions): the OD-specific "sign in with your SuperGrok subscription
+ * (in OD or via `hermes auth add xai-oauth`)" OAuth guidance — this
+ * package has no OAuth chain or local-CLI-login concept; credentials are
+ * always host-injected (see `types.ts`'s `ProviderCredentials`), matching
+ * every other ported provider's error-message style (e.g. `openai.ts`'s
+ * `OPENAI_IMAGE_NO_CREDENTIAL_MESSAGE`).
+ *
+ * 2026-07-21: migrated onto the generic vendor-adapter dispatch engine
+ * (`vendor-adapter.ts`/`vendor-registry.ts`) — two adapters registered on
+ * the same `grok` provider id (`image`/`audio:speech`). External behavior
+ * is unchanged (verified against `grok.test.ts`, which asserts URL/body/
+ * header/error-message/providerNote shape and passes unmodified) — only
+ * the internal implementation moved. The image adapter is not routed
+ * through `response-parsers.ts`'s factories (reuses
+ * `openai-compatible.ts`'s JSON-parsing helpers directly, same as before —
+ * see `imagerouter.ts`'s module doc for the identical reasoning); the TTS
+ * adapter's response (raw bytes, no envelope) is the same shape
+ * `fishaudio.ts`/`openai.ts`'s speech renderer return, so it now shares
+ * `response-parsers.ts`'s `createRawBytesParser`.
+ */
+import { buildOpenAIImageUrl, bytesFromOpenAICompatibleData, parseOpenAICompatibleJson, sniffImageExt, withRequestInit } from '../openai-compatible.js';
+import { createRawBytesParser } from '../response-parsers.js';
+import { dispatchVendorRequest, requireApiKey } from '../vendor-adapter.js';
+import { mediaVendorRegistry } from '../vendor-registry.js';
+/**
+ * xAI's Imagine API accepts a wide list of aspect ratios (1:1, 16:9, 9:16,
+ * 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, auto) —
+ * `providers.ts`'s `MEDIA_ASPECTS` is a strict subset, so a recognized
+ * value passes through and anything else defaults to 16:9. 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 grokAspectFor(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 xAI credential — configure an API key or set XAI_API_KEY.';
+const grokImageAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const baseUrl = (credentials.baseUrl || 'https://api.x.ai/v1').replace(/\/$/, '');
+        const aspectRatio = grokAspectFor(ctx.aspect);
+        const body = {
+            model: ctx.wireModel,
+            prompt: ctx.prompt || 'A high-quality reference image.',
+            n: 1,
+            aspect_ratio: aspectRatio,
+            response_format: 'b64_json',
+        };
+        return {
+            url: buildOpenAIImageUrl(baseUrl, false),
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            }),
+            meta: { wireModel: ctx.wireModel, aspectRatio },
+        };
+    },
+    async parseResponse(resp, ctx, request) {
+        const data = await parseOpenAICompatibleJson(resp, 'grok image');
+        const bytes = await bytesFromOpenAICompatibleData(data, 'grok image', ctx.requestInit);
+        return {
+            bytes,
+            providerNote: `grok/${request.meta.wireModel} · ${request.meta.aspectRatio} · ${bytes.length} bytes`,
+            suggestedExt: sniffImageExt(bytes),
+        };
+    },
+};
+mediaVendorRegistry.register('grok', 'image', grokImageAdapter);
+export async function renderGrokImage(ctx, credentials) {
+    return dispatchVendorRequest(grokImageAdapter, ctx, credentials);
+}
+const XAI_TTS_DEFAULT_VOICE_ID = 'eve';
+const XAI_TTS_DEFAULT_LANGUAGE = 'en';
+/**
+ * xAI's `/tts` endpoint takes only `{ text, voice_id, language }` — no
+ * per-request output-format field — and always returns mp3/24kHz/128kbps
+ * audio bytes directly (not wrapped in JSON), matching the origin exactly.
+ * `ctx.speechFormat` (used by `openai.ts`'s `renderOpenAISpeech`/AIHubMix's
+ * TTS) has no equivalent here since the wire protocol offers nothing to
+ * set it with.
+ */
+const xaiTTSAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const baseUrl = (credentials.baseUrl || 'https://api.x.ai/v1').replace(/\/$/, '');
+        const text = (ctx.prompt && ctx.prompt.trim()) || 'This is a test.';
+        const voiceId = (ctx.voice && ctx.voice.trim()) || XAI_TTS_DEFAULT_VOICE_ID;
+        const language = ctx.language.trim() || XAI_TTS_DEFAULT_LANGUAGE;
+        const body = { text, voice_id: voiceId, language };
+        return {
+            url: `${baseUrl}/tts`,
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            }),
+            meta: { wireModel: ctx.wireModel, voiceId, language },
+        };
+    },
+    parseResponse: createRawBytesParser({
+        errorTag: 'xai tts',
+        zeroBytesMessage: 'xai tts response had zero bytes',
+        note: (bytes, meta) => `xai/${meta.wireModel} · voice=${meta.voiceId} · ${meta.language} · ${bytes.length} bytes`,
+        suggestedExt: '.mp3',
+    }),
+};
+mediaVendorRegistry.register('grok', 'audio:speech', xaiTTSAdapter);
+export async function renderXAITTS(ctx, credentials) {
+    return dispatchVendorRequest(xaiTTSAdapter, ctx, credentials);
+}
+//# sourceMappingURL=grok.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { ProviderCredentials, RenderContext, RenderResult } from '../types.js';
+/** ImageRouter's image/video generation `size` string for a given aspect ratio. */
+export declare function imageRouterSizeFor(aspect: string | undefined, surface: 'image' | 'video'): string;
+export declare function renderImageRouterImage(ctx: RenderContext, credentials: ProviderCredentials): Promise<RenderResult>;
+export declare function renderImageRouterVideo(ctx: RenderContext, credentials: ProviderCredentials): Promise<RenderResult>;
+//# sourceMappingURL=imagerouter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imagerouter.d.ts","sourceRoot":"","sources":["../../../../src/media-providers/dispatch/providers/imagerouter.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKpF,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAajG;AAqDD,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAExH;AAqDD,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAExH"}

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

@@ -0,0 +1,131 @@
+/**
+ * Provider: ImageRouter — OpenAI-compatible image + video generation
+ * routing (`https://api.imagerouter.io/v1/openai`). Ported near-verbatim
+ * from Open Design's `apps/daemon/src/media/index.ts`
+ * `renderImageRouterImage`/`renderImageRouterVideo` — see `source-map.md`.
+ *
+ * 2026-07-21: migrated onto the generic vendor-adapter dispatch engine
+ * (`vendor-adapter.ts`/`vendor-registry.ts`) — two adapters registered on
+ * the same `imagerouter` provider id, one per surface (`image`/`video`).
+ * External behavior is unchanged (verified against `imagerouter.test.ts`,
+ * which asserts URL/body/error-message/providerNote shape and passes
+ * unmodified) — only the internal implementation moved. Neither adapter
+ * routes through `response-parsers.ts`'s factories — this vendor's
+ * `{ data: [...] }` JSON envelope isn't the "no envelope" raw-bytes shape
+ * either factory covers; both keep reusing `openai-compatible.ts`'s
+ * `parseOpenAICompatibleJson`/`bytesFromOpenAICompatibleData` helpers
+ * directly, same as before this pass.
+ */
+import { buildOpenAIImageUrl, buildOpenAIVideoUrl, bytesFromOpenAICompatibleData, parseOpenAICompatibleJson, sniffImageExt, withRequestInit, } from '../openai-compatible.js';
+import { dispatchVendorRequest, requireApiKey } from '../vendor-adapter.js';
+import { mediaVendorRegistry } from '../vendor-registry.js';
+/** ImageRouter's image/video generation `size` string for a given aspect ratio. */
+export function imageRouterSizeFor(aspect, surface) {
+    if (surface === 'video') {
+        if (aspect === '1:1')
+            return '1024x1024';
+        if (aspect === '9:16')
+            return '576x1024';
+        if (aspect === '4:3')
+            return '1024x768';
+        if (aspect === '3:4')
+            return '768x1024';
+        return '1024x576';
+    }
+    if (aspect === '16:9')
+        return '1024x576';
+    if (aspect === '9:16')
+        return '576x1024';
+    if (aspect === '4:3')
+        return '1024x768';
+    if (aspect === '3:4')
+        return '768x1024';
+    return '1024x1024';
+}
+const NO_CREDENTIAL_MESSAGE = 'no ImageRouter API key — configure it or set IMAGEROUTER_API_KEY';
+const imageRouterImageAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const baseUrl = (credentials.baseUrl || 'https://api.imagerouter.io/v1/openai').trim();
+        const wireModel = (credentials.model || ctx.wireModel).trim();
+        const size = imageRouterSizeFor(ctx.aspect, 'image');
+        const body = {
+            prompt: ctx.prompt || 'A high-quality reference image.',
+            model: wireModel,
+            quality: 'auto',
+            size,
+            response_format: 'b64_json',
+            output_format: 'png',
+        };
+        return {
+            url: buildOpenAIImageUrl(baseUrl, false),
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            }),
+            meta: { wireModel, size },
+        };
+    },
+    async parseResponse(resp, ctx, request) {
+        const data = await parseOpenAICompatibleJson(resp, 'imagerouter image');
+        const bytes = await bytesFromOpenAICompatibleData(data, 'imagerouter image', ctx.requestInit);
+        return {
+            bytes,
+            providerNote: `imagerouter/${request.meta.wireModel} · ${request.meta.size} · ${bytes.length} bytes`,
+            suggestedExt: sniffImageExt(bytes),
+        };
+    },
+};
+mediaVendorRegistry.register('imagerouter', 'image', imageRouterImageAdapter);
+export async function renderImageRouterImage(ctx, credentials) {
+    return dispatchVendorRequest(imageRouterImageAdapter, ctx, credentials);
+}
+const imageRouterVideoAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const baseUrl = (credentials.baseUrl || 'https://api.imagerouter.io/v1/openai').trim();
+        const wireModel = (credentials.model || ctx.wireModel).trim();
+        const seconds = typeof ctx.length === 'number' ? ctx.length : 'auto';
+        const size = imageRouterSizeFor(ctx.aspect, 'video');
+        const body = {
+            prompt: ctx.prompt || 'A short cinematic clip.',
+            model: wireModel,
+            size,
+            seconds,
+            response_format: 'b64_json',
+        };
+        return {
+            url: buildOpenAIVideoUrl(baseUrl),
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            }),
+            meta: { wireModel, size, seconds },
+        };
+    },
+    async parseResponse(resp, ctx, request) {
+        const data = await parseOpenAICompatibleJson(resp, 'imagerouter video');
+        const bytes = await bytesFromOpenAICompatibleData(data, 'imagerouter video', ctx.requestInit);
+        const { wireModel, size, seconds } = request.meta;
+        return {
+            bytes,
+            providerNote: `imagerouter/${wireModel} · ${size} · ${seconds === 'auto' ? 'auto' : `${seconds}s`} · ${bytes.length} bytes`,
+            suggestedExt: '.mp4',
+        };
+    },
+};
+mediaVendorRegistry.register('imagerouter', 'video', imageRouterVideoAdapter);
+export async function renderImageRouterVideo(ctx, credentials) {
+    return dispatchVendorRequest(imageRouterVideoAdapter, ctx, credentials);
+}
+//# sourceMappingURL=imagerouter.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"minimax.d.ts","sourceRoot":"","sources":["../../../../src/media-providers/dispatch/providers/minimax.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkEpF,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAElH"}

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

@@ -0,0 +1,96 @@
+/**
+ * Provider: MiniMax — Speech-02 family text-to-speech (synchronous,
+ * `POST /t2a_v2`). Ported near-verbatim from Open Design's
+ * `apps/daemon/src/media/index.ts` `renderMinimaxTTS` — see
+ * `source-map.md`.
+ *
+ * 2026-07-21: migrated onto the generic vendor-adapter dispatch engine
+ * (`vendor-adapter.ts`/`vendor-registry.ts`) — `renderMinimaxTTS`'s
+ * external behavior (URL, body, headers, every error message,
+ * `providerNote` format) is unchanged; only the internal implementation
+ * moved from one hand-written async function into a registered
+ * `VendorAdapter` dispatched via `dispatchVendorRequest`. Its response
+ * envelope (hex-encoded audio inside a `base_resp`-wrapped JSON body) is
+ * identical to `senseaudio.ts`'s TTS renderer, so both now share
+ * `response-parsers.ts`'s `createHexEnvelopeAudioParser` — the first real,
+ * observable de-duplication this engine buys, not just a mechanical
+ * reshuffle.
+ *
+ * Not OpenAI-wire-compatible — MiniMax's request body
+ * (`voice_setting`/`audio_setting`) and response shape share nothing with
+ * `/audio/speech`, so this does not route through `openai-compatible.ts`'s
+ * JSON-parsing helpers — only the genuinely vendor-agnostic
+ * `withRequestInit` is reused (matching `nanobanana.ts`'s/`openrouter.ts`'s
+ * reasoning for the same call).
+ *
+ * `renderMinimaxImage` (a *different* surface on the same provider slot,
+ * gated behind its own `OD_MINIMAX_IMAGE_BASE_URL` env var read directly
+ * from `process.env` in the origin) is intentionally not ported — this
+ * package never reads `process.env` itself (see `providers.ts`'s standing
+ * invariant) and the task for this pass only covers MiniMax TTS.
+ *
+ * Dropped from the origin's no-credential error message: the `OD_`-
+ * prefixed override env var (`OD_MINIMAX_API_KEY`) — `providers.ts`'s
+ * `PROVIDER_CREDENTIAL_ENV_VARS.minimax` already de-branded this to plain
+ * `MINIMAX_API_KEY`.
+ */
+import { withRequestInit } from '../openai-compatible.js';
+import { createHexEnvelopeAudioParser } from '../response-parsers.js';
+import { dispatchVendorRequest, requireApiKey } from '../vendor-adapter.js';
+import { mediaVendorRegistry } from '../vendor-registry.js';
+const MINIMAX_DEFAULT_BASE_URL = 'https://api.minimaxi.chat/v1';
+const MINIMAX_DEFAULT_VOICE_ID = 'male-qn-qingse';
+const MINIMAX_TTS_MODEL_MAP = {
+    'minimax-tts': 'speech-02-turbo',
+};
+const NO_CREDENTIAL_MESSAGE = 'no MiniMax credential — configure an API key or set MINIMAX_API_KEY.';
+const minimaxTTSAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        // Safe: `requireCredential` above already validated this is set before
+        // `dispatchVendorRequest` ever calls `buildRequest`.
+        const apiKey = credentials.apiKey;
+        const baseUrl = (credentials.baseUrl || MINIMAX_DEFAULT_BASE_URL).replace(/\/$/, '');
+        // Precedence: an explicit caller alias (ctx.wireModel set to something
+        // other than the catalog id) wins over the legacy MiniMax rename map,
+        // which in turn wins over passing the catalog id through unchanged.
+        const wireModel = ctx.wireModel !== ctx.model ? ctx.wireModel : MINIMAX_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()) || MINIMAX_DEFAULT_VOICE_ID;
+        const languageBoost = ctx.language.trim();
+        const body = {
+            model: wireModel,
+            text,
+            stream: false,
+            ...(languageBoost ? { language_boost: languageBoost } : {}),
+            voice_setting: {
+                voice_id: voiceId,
+                speed: 1.0,
+                vol: 1.0,
+                pitch: 0,
+            },
+            audio_setting: {
+                sample_rate: 32000,
+                format: 'mp3',
+            },
+        };
+        return {
+            url: `${baseUrl}/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: 'minimax tts', providerId: 'minimax' }),
+};
+mediaVendorRegistry.register('minimax', 'audio:speech', minimaxTTSAdapter);
+export async function renderMinimaxTTS(ctx, credentials) {
+    return dispatchVendorRequest(minimaxTTSAdapter, ctx, credentials);
+}
+//# sourceMappingURL=minimax.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,142 @@
+/**
+ * Provider: Nano Banana (Google Gemini image generation) —
+ * `POST /v1beta/models/{model}:generateContent`. Ported near-verbatim from
+ * Open Design's `apps/daemon/src/media/index.ts` `renderNanoBananaImage`
+ * (plus its `nanoBananaHeaders`/`usesOfficialGoogleApiKeyHeader`/
+ * `nanoBananaAspectFor`/`inlineImageBytesFromGenerateContent` helpers) —
+ * see `source-map.md`.
+ *
+ * Not OpenAI-images-wire-compatible — Gemini's `generateContent` request
+ * shape (`contents[].parts[].text` + `generationConfig`) and response shape
+ * (`candidates[].content.parts[].inlineData.data`) are unrelated to
+ * `/images/generations`'s `{ data: [{ b64_json | url }] }` — so this does
+ * not route through `openai-compatible.ts`'s OpenAI-images helpers; only
+ * its genuinely vendor-agnostic utilities (`truncate`, `sniffImageExt`,
+ * `withRequestInit`) are reused.
+ *
+ * 2026-07-21: migrated onto the generic vendor-adapter dispatch engine
+ * (`vendor-adapter.ts`/`vendor-registry.ts`). External behavior is
+ * unchanged (verified against `nanobanana.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:
+ * this Gemini `candidates[].content.parts[].inlineData.data` shape has no
+ * other current consumer with byte-for-byte identical error messages (see
+ * `aihubmix.ts`'s own Gemini-native branch, which throws differently-
+ * tagged errors), so it correctly stays a bespoke `parseResponse`.
+ */
+import { sniffImageExt, truncate, withRequestInit } from '../openai-compatible.js';
+import { dispatchVendorRequest, requireApiKey } from '../vendor-adapter.js';
+import { mediaVendorRegistry } from '../vendor-registry.js';
+const NANOBANANA_DEFAULT_BASE_URL = 'https://generativelanguage.googleapis.com';
+const NANOBANANA_DEFAULT_MODEL = 'gemini-3.1-flash-image-preview';
+const NANOBANANA_DEFAULT_IMAGE_SIZE = '1K';
+/** Google's official Gemini API wants an `x-goog-api-key` header; any other host (a custom gateway/proxy) gets a standard `Authorization: Bearer` header instead. */
+function usesOfficialGoogleApiKeyHeader(baseUrl) {
+    try {
+        return new URL(baseUrl).hostname === 'generativelanguage.googleapis.com';
+    }
+    catch {
+        return false;
+    }
+}
+function nanoBananaHeaders(baseUrl, apiKey) {
+    const headers = { 'content-type': 'application/json' };
+    if (usesOfficialGoogleApiKeyHeader(baseUrl)) {
+        headers['x-goog-api-key'] = apiKey;
+        return headers;
+    }
+    headers.authorization = `Bearer ${apiKey}`;
+    return headers;
+}
+/**
+ * `providers.ts`'s `MEDIA_ASPECTS` are all natively supported by Nano
+ * Banana's `imageConfig.aspectRatio`; anything else defaults to `'1:1'`.
+ * 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.
+ */
+function nanoBananaAspectFor(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 '1:1';
+}
+function inlineImageBytesFromGenerateContent(data) {
+    const candidates = data?.candidates;
+    if (Array.isArray(candidates)) {
+        for (const candidate of candidates) {
+            const parts = candidate?.content?.parts;
+            if (Array.isArray(parts)) {
+                for (const part of parts) {
+                    const inline = part?.inlineData;
+                    if (typeof inline?.data === 'string' && inline.data) {
+                        return Buffer.from(inline.data, 'base64');
+                    }
+                }
+            }
+        }
+    }
+    throw new Error('nano-banana image response missing candidates[].content.parts[].inlineData.data');
+}
+const NO_CREDENTIAL_MESSAGE = 'no Nano Banana credential — configure an API key or set GOOGLE_API_KEY / GEMINI_API_KEY.';
+const nanoBananaImageAdapter = {
+    requireCredential: requireApiKey(NO_CREDENTIAL_MESSAGE),
+    buildRequest(ctx, credentials) {
+        const apiKey = credentials.apiKey; // requireCredential already validated this.
+        const baseUrl = (credentials.baseUrl || NANOBANANA_DEFAULT_BASE_URL).replace(/\/$/, '');
+        const wireModel = (credentials.model || ctx.wireModel || NANOBANANA_DEFAULT_MODEL).trim();
+        const aspectRatio = nanoBananaAspectFor(ctx.aspect);
+        const body = {
+            contents: [{ parts: [{ text: ctx.prompt || 'A high-quality reference image.' }] }],
+            generationConfig: {
+                responseModalities: ['IMAGE'],
+                imageConfig: {
+                    aspectRatio,
+                    imageSize: NANOBANANA_DEFAULT_IMAGE_SIZE,
+                },
+            },
+        };
+        return {
+            url: `${baseUrl}/v1beta/models/${encodeURIComponent(wireModel)}:generateContent`,
+            init: withRequestInit(ctx, {
+                method: 'POST',
+                headers: nanoBananaHeaders(baseUrl, apiKey),
+                body: JSON.stringify(body),
+            }),
+            meta: { wireModel, aspectRatio },
+        };
+    },
+    async parseResponse(resp, _ctx, request) {
+        const text = await resp.text();
+        if (!resp.ok) {
+            throw new Error(`nano-banana image ${resp.status}: ${truncate(text, 240)}`);
+        }
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`nano-banana image non-JSON response: ${truncate(text, 200)}`);
+        }
+        const bytes = inlineImageBytesFromGenerateContent(data);
+        return {
+            bytes,
+            providerNote: `nano-banana/${request.meta.wireModel} · ${request.meta.aspectRatio} · ${NANOBANANA_DEFAULT_IMAGE_SIZE} · ${bytes.length} bytes`,
+            suggestedExt: sniffImageExt(bytes),
+        };
+    },
+};
+mediaVendorRegistry.register('nanobanana', 'image', nanoBananaImageAdapter);
+export async function renderNanoBananaImage(ctx, credentials) {
+    return dispatchVendorRequest(nanoBananaImageAdapter, ctx, credentials);
+}
+//# sourceMappingURL=nanobanana.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/media-providers/dispatch/providers/openai.ts"],"names":[],"mappings":"AAyDA,OAAO,KAAK,EAAqB,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAyHvG,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAEnH;AAkFD,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAEpH"}