Files
OmniRoute/tests/unit/image-generation-handler.test.ts
Diego Rodrigues de Sa e Souza f5073604b3 Release/v3.8.0 (#2430)
* fix(cli-tools): guard modelId type before calling indexOf

E2E shakedown v3.8.0: cli-tools quebrava com TypeError quando dynamicModels
continha entradas sem .id (objeto retornado diretamente em vez de string).

* fix(offline): avoid SSR/CSR hydration mismatch on navigator.onLine

Replace useState+lazy-initializer with useSyncExternalStore so the server
snapshot (() => false) and client snapshot (() => navigator.onLine) are
declared separately. React hydrates with the server value and switches to
the real online status client-side without a mismatch.

* chore(i18n): add missing en.json keys for translator, cli-tools, memory, onboarding

Adds 58 missing keys identified by the new dashboard audit script:
- cliTools: 18 custom CLI builder keys (CustomCliCard)
- translator: 24 keys covering stream transformer, live monitor, test bench
- memory: 12 health/pagination/dialog keys
- onboarding.tier: 8 keys for the tier tour walkthrough

Also adds scripts/i18n/audit-dashboard-pages.mjs which scans all dashboard
pages, reports t() calls referencing missing en.json keys, and flags
candidate hardcoded JSX/attribute strings.

* chore(i18n): replace hardcoded UI text with t() calls across dashboard (round 1)

Subagents refactored 8 high-impact dashboard pages, replacing 81 of the
407 hardcoded English/PT strings flagged by the audit with proper
useTranslations() lookups. Added 73 corresponding keys to en.json across
the home, apiManager, providers, settings, and usage namespaces.

Pages affected:
- BudgetTab (27 → 0)
- HomePageClient (2 → 0)
- RoutingTab (25 → 7)
- ResilienceTab (38 → 18)
- SystemStorageTab (42 → 21)
- providers/[id] (17 → 15)
- ApiManagerPageClient (14 → 13)
- OneproxyTab (13 → 10)

Also adds two helper scripts:
- scripts/i18n/extract-keys-from-diff.mjs — extracts new keys from git diff
- scripts/i18n/merge-keys.mjs — merges a pending-keys JSON into en.json

Remaining hardcoded strings will be addressed in follow-up rounds.

* chore(i18n): replace hardcoded UI text with t() calls across dashboard (round 2)

Continues round 1 (commit 8d34f4c65). Round-2 subagents refactored
additional dashboard pages, replacing 77 more hardcoded strings with
useTranslations() lookups. Added 79 corresponding keys to en.json
across the a2aDashboard, agents, analytics, apiManager, cliTools,
common, and settings namespaces.

Pages affected:
- a2a/page (new useTranslations + 6 keys)
- agent-skills/page (new useTranslations + 9 keys)
- AutoRoutingAnalyticsTab (new useTranslations + 6 keys)
- AppearanceTab (8 → 6 remaining)
- OneproxyTab (10 → 0)
- ResilienceTab (18 → 0 missing key)
- RoutingTab (7 → 0 missing key)
- VisionBridgeSettingsTab (new useTranslations + 6 keys)
- CopilotToolCard (7 → 0 missing key)
- ApiManagerPageClient (13 → 0 missing key)
- gamification/admin (new useTranslations + 7 keys)

Hardcoded total: 326 → 249. Real missing keys: 0 (the 6 still flagged
are false positives in exampleTemplates.tsx where t is passed as a
parameter — keys exist at translator.templatePayloads.*).

* chore(i18n): replace hardcoded UI text with t() calls across dashboard (round 3)

Round-3 subagents and manual edits refactored 9 more dashboard pages
(plus 2 small extras), replacing ~80 hardcoded strings with
useTranslations() lookups. Added 79 corresponding keys to en.json
across analytics, cloudAgents, combos, common, health, settings, and
usage namespaces.

Pages affected:
- analytics/ComboHealthTab (new useTranslations + 15 keys)
- analytics/CompressionAnalyticsTab (new useTranslations + 11 keys)
- settings/SystemStorageTab (21 → 0 missing key)
- tokens/page (new useTranslations + 13 keys)
- usage/BudgetTab (9 missing fixed)
- health/page (manual: 6 keys)
- cloud-agents/page (manual: 3 keys)
- combos/page (manual: 1 key)

Hardcoded total: 249 → 164. Real missing keys: 0 (6 remaining are
exampleTemplates.tsx false positives).

Also adds scripts/i18n/build-pending-from-missing.mjs which reads
_audit.json and locates English values from HEAD to rebuild
_pending-keys.json after race-condition resets between subagent edits.

* chore(i18n): localize remaining dashboard settings labels

Replace hardcoded labels in compression and resilience settings with
translation lookups to continue the dashboard i18n cleanup.

Add the v3.8.0 dashboard shakedown runbook to document the manual
smoke-test process and known dev environment pitfalls.

* chore(i18n): replace hardcoded UI text with t() calls across dashboard (round 4)

Round-4 subagent + manual key-resolution refactored remaining strings in
3 high-traffic settings/API tabs, plus extracted English values for
keys that were already added as t() calls but lost during the previous
en.json race-condition resets.

Pages affected:
- api-manager/ApiManagerPageClient (7 → 0 missing key)
- settings/CompressionSettingsTab (8 → 0 missing key)
- settings/MemorySkillsTab (8 → 0 missing key)
- settings/ResilienceTab (4 more keys recovered)

Hardcoded total: 164 → 140. Real missing keys: 0 (6 remaining are the
exampleTemplates.tsx false positives — t passed as parameter).

* chore(i18n): replace hardcoded UI text with t() calls across dashboard (round 5)

Round-5 agent began processing the remaining smaller dashboard files.
Added 5 more keys to en.json for providers/[id]/page.tsx OAuth flow
labels and the cross-OS auto-detection hint.

Pages affected:
- providers/[id]/page.tsx (5 keys)

Hardcoded total: 140 → 136. Real missing keys: 0.

* chore(i18n): resolve last 2 missing providers/[id] keys

Adds providerDetailMyClaudeAccountPlaceholder and
providerDetailPathAutoDetected — the final user-visible labels in the
providers/[id] page that the round-5 subagent rewrote to t() calls
without yet adding to en.json.

Real missing keys: 0 (6 remaining are exampleTemplates.tsx false
positives — t is passed as a parameter so the audit cannot resolve the
namespace; keys do exist at translator.templatePayloads.*).

* chore(i18n): replace hardcoded UI text with t() calls across dashboard (round 6 — 10 parallel agents)

Round-6 dispatched 10 parallel subagents covering all 57 remaining
dashboard files. Each agent worked on a disjoint file set to avoid
en.json race conditions. Added ~60 new i18n keys across 9 namespaces
covering small UI labels, table headers, search placeholders, and
empty-state messages.

Major changes:
- analytics: SearchAnalyticsTab, ProviderUtilizationTab, DiversityScoreCard, CompressionAnalyticsTab (new useTranslations + keys)
- batch: BatchDetailModal, BatchListTab, FileDetailModal, FilesListTab (new useTranslations + keys)
- settings: CliproxyapiSettingsTab, PayloadRulesTab, ModelCooldownsCard, AppearanceTab, PricingTab (mostly new useTranslations)
- endpoint: TokenSaverCard, ApiEndpointsTab, EndpointPageClient
- cache: CachePerformance, IdempotencyLayer, ReasoningCacheTab, MediaPageClient, page
- combos: IntelligentComboPanel, page
- playground: ChatPlayground, SearchPlayground
- providers: ProviderCard
- onboarding: TierFlowDiagram
- changelog: ChangelogViewer
- home: ProviderTopology, TierCoverageWidget, BootstrapBanner, BadgeToast
- usage: BudgetTab, BudgetTelemetryCards, QuotaTable
- quotaShare: QuotaSharePageClient
- profile: page
- leaderboard: page
- skills: page

Hardcoded total: 131 → 60. Real missing keys: 0 plus 1 false-positive
for combos.modePack (lookup via prop-passed t).

* chore(i18n): finalize round-6 keys for batch/cache/endpoint/usage

Adds the remaining keys produced by parallel agents A4, A6, A8, A9:
- common: batch-related labels (BatchDetailModal, BatchListTab,
  FileDetailModal, FilesListTab, page) + profile/leaderboard
- cache: hit rate, latency, retry, avg chars
- endpoint: token saver, API endpoints, copy URL, cloud/local labels
- usage: noSpend, activeSessions, quotaAlerts, budget timing
- skills: install/marketplace/filter
- proxyRegistry/quotaShare/mcpDashboard: misc labels

Hardcoded total: 60 → 48. Real missing keys: 0 (modePack remaining is a
false positive — combos.modePack exists but the audit can't resolve it
since IntelligentComboPanel receives t as a prop).

* fix(playground): dedupe filteredModels to avoid duplicate React key warning

The /v1/models endpoint can return the same model id twice (e.g., when a
model is listed by both an alias and its canonical provider), which made
the <Select> emit two <option> elements with the same key — triggering
"Encountered two children with the same key, codex/gpt-5.5".

Replace the chained filter + map with a single pass that skips ids
already added.

* fix(playground): guard against non-string model ids before .split/.startsWith

The /v1/models endpoint can include synthetic entries (combos, locals,
in-progress imports) with a null/undefined id. The playground used to
call m.id.split("/") in the provider-discovery loop, which threw on the
first non-string entry; the surrounding .catch(() => {}) silently
swallowed the error, so the provider/model/account dropdowns ended up
empty even though /v1/models returned thousands of valid entries.

- Skip entries without a string id before split/startsWith.
- Log the rejection in the .catch handler so future regressions are
  visible in DevTools instead of silently emptying the UI.

* fix(playground): guard ChatPlayground filteredModels for non-string ids

Same root cause as commit 49fe356b9: ChatPlayground filtered models
with m.id.startsWith(...) which crashed on null/undefined ids returned
by /v1/models (synthetic combo entries). Apply the same defensive guard
and dedupe used in the parent page.

* fix(claude): drop orphan tool_result after fixToolAdjacency strip (discussion #2410)

Discussion #2410 reports Claude returning 400 for sequences like:
  assistant: tool_use(id=X)
  user: <plain text>           ← breaks adjacency
  user: tool_result(id=X)

The previous round added `fixToolAdjacency` (commit 44d9abac9) which
correctly strips the orphan tool_use from the assistant message. But
that left the now-unmatched tool_result intact, so the upstream
rejected the request with:

  messages.N.content.M: unexpected `tool_use_id` found in `tool_result`
  blocks: X. Each tool_result block must have a corresponding tool_use
  block in the previous message.

Fix: after running `fixToolAdjacency`, re-run `fixToolPairs` to drop
the orphaned tool_result blocks. All three call sites updated:
  - contextManager.purifyHistory (both inside the binary-search loop
    and the final pass)
  - BaseExecutor message-prep (Claude path)
  - claudeCodeCompatible request signer

Also tightens an unrelated dynamic-key access in
readNestedString (claudeCodeCompatible) to satisfy the prototype-
pollution scanner triggered by the post-tool semgrep hook.

* fix(mitm): point runtime manager re-export to js entrypoint

Use the emitted `.js` path for the runtime manager re-export so dynamic
runtime loading resolves correctly outside the Turbopack alias handling.

* docs: add AgentRouter setup guide (#2422)

Integrated into release/v3.8.0 — AgentRouter setup guide docs.

* feat: add new feature on combos - falloverBeforeRetry (#2417)

Integrated into release/v3.8.0 — falloverBeforeRetry for per-model quota skipping in combos.

* feat(batch): implement 10 feature requests harvested  (#2414)

Integrated into release/v3.8.0 — batch of 10 feature requests: llama.cpp local provider, upstream error exposure, Termux detection, providers rotate CLI, t3.chat web skeleton, Zed Docker integration, Kiro multi-account OAuth isolation, auto-combo cost blending, auto-combo context filter, combo provider-level exhaustion tracking (#1731). Conflicts with #2417 (falloverBeforeRetry) resolved.

* fix(gamification): resolve SQL bug, auth gap, pagination, and anomaly scoring (#2421)

Integrated into release/v3.8.0 — 6 critical gamification bug fixes: SQL SELECT in checkActionCountBadges, federation auth enforcement, leaderboard pagination offset, real z-score computation, addXp level calculation, and barrel index.ts

* docs(changelog): add post-release entries for #2414 #2417 #2421 #2422

- feat(batch): T3-Chat-Web executor, exhaustedProviders set (#1731), Zed Docker
- feat(combos): falloverBeforeRetry + setTry loop (#2417 — @hartmark)
- fix(gamification): SQL SELECT bug, federation auth, pagination, z-score (#2421 — @oyi77)
- docs: AgentRouter setup guide (#2422 — @leninejunior)

* fix(security): resolve CodeQL random/password-hash alerts and sync docs & tests

* feat/fix: integrate PRs #2423, #2425, #2427, #2428 with test & security fixes

* docs(changelog): credit contributors for PRs #2423, #2425, #2427, #2428

* fix(mitm): drop .js extension on manager.runtime re-export for webpack build (#2425)

Merged into release/v3.8.0

* fix: persist STORAGE_ENCRYPTION_KEY across upgrades (closes #1622) (#2428)

Merged into release/v3.8.0

* fix: auto-reset apiKeyHealth on successful connection test (#2427)

Merged into release/v3.8.0

* fix: support Antigravity image generation, Add Gemini 3.5 Flash (#2423)

Merged into release/v3.8.0

---------

Co-authored-by: diegosouzapw <diego.souza.pw@gmail.com>
Co-authored-by: Lenine Júnior <lenine@engrene.com.br>
Co-authored-by: Markus Hartung <mail@hartmark.se>
Co-authored-by: Paijo <14921983+oyi77@users.noreply.github.com>
Co-authored-by: Anton <39598727+NomenAK@users.noreply.github.com>
Co-authored-by: Chewji <126886556+Chewji9875@users.noreply.github.com>
Co-authored-by: clousky2020 <33016567+clousky2020@users.noreply.github.com>
Co-authored-by: backryun <bakryun0718@proton.me>
2026-05-20 09:12:49 -03:00

1948 lines
57 KiB
TypeScript

import test from "node:test";
import assert from "node:assert/strict";
import { mkdtempSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
process.env.DATA_DIR = mkdtempSync(join(tmpdir(), "omniroute-images-"));
const { IMAGE_PROVIDERS, parseImageModel, getAllImageModels } =
await import("../../open-sse/config/imageRegistry.ts");
const { handleImageGeneration } = await import("../../open-sse/handlers/imageGeneration.ts");
function immediateTimeout(callback, _ms, ...args) {
if (typeof callback === "function") callback(...args);
return 0;
}
function createLogRecorder() {
const entries = [];
return {
entries,
info(tag, message) {
entries.push({ level: "info", tag, message });
},
error(tag, message) {
entries.push({ level: "error", tag, message });
},
warn(tag, message) {
entries.push({ level: "warn", tag, message });
},
};
}
test("handleImageGeneration routes OpenAI-compatible providers and forwards image options", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (url, options = {}) => {
captured = {
url: String(url),
headers: options.headers,
body: JSON.parse(String(options.body || "{}")),
};
return new Response(
JSON.stringify({
created: 123,
data: [{ url: "https://cdn.example.com/image.png" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "openai/gpt-image-2",
prompt: "city skyline",
n: 2,
size: "1024x1536",
quality: "hd",
response_format: "url",
style: "vivid",
},
credentials: { apiKey: "image-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(captured.url, "https://api.openai.com/v1/images/generations");
assert.equal(captured.headers.Authorization, "Bearer image-key");
assert.deepEqual(captured.body, {
model: "gpt-image-2",
prompt: "city skyline",
n: 2,
size: "1024x1536",
quality: "hd",
response_format: "url",
style: "vivid",
});
assert.equal(result.data.data[0].url, "https://cdn.example.com/image.png");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration uses synthetic OpenAI-compatible routing for resolved custom providers", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (url, options = {}) => {
captured = {
url: String(url),
body: JSON.parse(String(options.body || "{}")),
headers: options.headers,
};
return new Response(JSON.stringify({ data: [{ b64_json: "ZmFrZQ==" }] }), {
status: 200,
headers: { "content-type": "application/json" },
});
};
try {
const result = await handleImageGeneration({
body: {
model: "custom-provider/super-image",
prompt: "retro poster",
},
credentials: {
apiKey: "custom-key",
baseUrl: "https://custom.example.com/v1/images/generations",
},
resolvedProvider: "custom-provider",
log: null,
});
assert.equal(result.success, true);
assert.equal(captured.url, "https://custom.example.com/v1/images/generations");
assert.equal(captured.headers.Authorization, "Bearer custom-key");
assert.deepEqual(captured.body, {
model: "super-image",
prompt: "retro poster",
});
assert.equal(result.data.data[0].b64_json, "ZmFrZQ==");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration polls KIE image tasks and returns URLs on success", async () => {
const originalFetch = globalThis.fetch;
let createPayload;
let pollUrl = "";
globalThis.fetch = async (url, options = {}) => {
const stringUrl = String(url);
if (stringUrl === "https://api.kie.ai/api/v1/gpt4o-image/generate") {
createPayload = JSON.parse(String(options.body || "{}"));
return new Response(JSON.stringify({ code: 200, data: { taskId: "kie-task-1" } }), {
status: 200,
headers: { "content-type": "application/json" },
});
}
if (stringUrl.startsWith("https://api.kie.ai/api/v1/gpt4o-image/record-info")) {
pollUrl = stringUrl;
return new Response(
JSON.stringify({
code: 200,
data: {
status: "SUCCESS",
response: {
resultUrls: ["https://example.com/kie-image.png"],
},
},
}),
{
status: 200,
headers: { "content-type": "application/json" },
}
);
}
throw new Error(`Unexpected URL: ${stringUrl}`);
};
try {
const result = await handleImageGeneration({
body: {
model: "kie/gpt4o-image",
prompt: "city skyline at dusk",
size: "1:1",
n: 1,
},
credentials: { apiKey: "kie-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(createPayload.prompt, "city skyline at dusk");
assert.equal(createPayload.size, "1:1");
assert.equal(createPayload.nVariants, 1);
assert.match(pollUrl, /taskId=kie-task-1/);
assert.equal(result.data.data[0].url, "https://example.com/kie-image.png");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration maps Hyperbolic size parameters and normalizes base64 images", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (_url, options = {}) => {
captured = JSON.parse(String(options.body || "{}"));
return new Response(
JSON.stringify({
images: [{ image: "aW1hZ2UtMQ==" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "hyperbolic/FLUX.1-dev",
prompt: "futuristic tower",
size: "512x1024",
},
credentials: { apiKey: "hyper-key" },
log: null,
});
assert.deepEqual(captured, {
model_name: "FLUX.1-dev",
prompt: "futuristic tower",
height: 1024,
width: 512,
backend: "auto",
});
assert.equal(result.success, true);
assert.equal(result.data.data[0].b64_json, "aW1hZ2UtMQ==");
assert.equal(result.data.data[0].revised_prompt, "futuristic tower");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration maps SD WebUI payload shape and batch size", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (_url, options = {}) => {
captured = JSON.parse(String(options.body || "{}"));
return new Response(
JSON.stringify({
images: ["YmFzZTY0LWltYWdl"],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "sdwebui/sdxl-base-1.0",
prompt: "forest cabin",
negative_prompt: "low quality",
size: "768x768",
steps: 30,
cfg_scale: 9,
sampler: "DPM++",
n: 3,
},
credentials: null,
log: null,
});
assert.equal(result.success, true);
assert.deepEqual(captured, {
prompt: "forest cabin",
negative_prompt: "low quality",
width: 768,
height: 768,
steps: 30,
cfg_scale: 9,
sampler_name: "DPM++",
batch_size: 3,
override_settings: {
sd_model_checkpoint: "sdxl-base-1.0",
},
});
assert.equal(result.data.data[0].b64_json, "YmFzZTY0LWltYWdl");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration rejects invalid model strings", async () => {
const result = await handleImageGeneration({
body: {
model: "not-a-provider-qualified-image-model",
prompt: "oops",
},
credentials: { apiKey: "x" },
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 400);
assert.match(result.error, /Invalid image model/);
});
test("handleImageGeneration treats unknown provider prefixes as invalid image models", async () => {
const result = await handleImageGeneration({
body: {
model: "mystery/model-1",
prompt: "oops",
},
credentials: { apiKey: "x" },
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 400);
assert.match(result.error, /Invalid image model: mystery\/model-1/);
});
test("image registry resolves flux aliases and exposes planned catalog aliases", () => {
assert.deepEqual(parseImageModel("flux-kontext"), {
provider: "black-forest-labs",
model: "flux-kontext-pro",
});
assert.deepEqual(parseImageModel("pollinations/kontext"), {
provider: "black-forest-labs",
model: "flux-kontext-pro",
});
assert.deepEqual(parseImageModel("flux-2-dev"), {
provider: "together",
model: "black-forest-labs/FLUX.2-dev",
});
const modelIds = new Set(getAllImageModels().map((model) => model.id));
const flux2Dev = getAllImageModels().find((model) => model.id === "flux-2-dev");
const fluxKontext = getAllImageModels().find((model) => model.id === "flux-kontext");
for (const alias of [
"flux-kontext",
"flux-kontext-max",
"flux-2-max",
"flux-2-pro",
"flux-2-flex",
"flux-2-dev",
]) {
assert.equal(modelIds.has(alias), true, `Expected alias ${alias} in image catalog`);
}
assert.deepEqual(flux2Dev?.inputModalities, ["text", "image"]);
assert.deepEqual(fluxKontext?.inputModalities, ["text", "image"]);
});
test("handleImageGeneration calls Fal AI with Key auth and normalizes URL results to base64", async () => {
const originalFetch = globalThis.fetch;
let requestCapture;
globalThis.fetch = async (url, options = {}) => {
const stringUrl = String(url);
if (stringUrl === "https://fal.run/fal-ai/flux-pro/v1.1-ultra") {
requestCapture = {
url: stringUrl,
headers: options.headers,
body: JSON.parse(String(options.body || "{}")),
};
return new Response(
JSON.stringify({
images: [{ url: "https://cdn.example.com/fal-ultra.png" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
}
if (stringUrl === "https://cdn.example.com/fal-ultra.png") {
return new Response(new Uint8Array([5, 6, 7]), {
status: 200,
headers: { "content-type": "image/png" },
});
}
throw new Error(`Unexpected URL: ${stringUrl}`);
};
try {
const result = await handleImageGeneration({
body: {
model: "fal-ai/fal-ai/flux-pro/v1.1-ultra",
prompt: "cinematic skyline",
size: "1024x1792",
n: 2,
image_url: "https://example.com/source.png",
response_format: "b64_json",
},
credentials: { apiKey: "fal-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(requestCapture.url, "https://fal.run/fal-ai/flux-pro/v1.1-ultra");
assert.equal(requestCapture.headers.Authorization, "Key fal-key");
assert.equal(requestCapture.body.aspect_ratio, "9:16");
assert.equal(requestCapture.body.image_url, "https://example.com/source.png");
assert.equal(requestCapture.body.num_images, 2);
assert.equal(requestCapture.body.sync_mode, true);
assert.equal(result.data.data[0].b64_json, "BQYH");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration routes Stability AI edit models to native endpoints", async () => {
const originalFetch = globalThis.fetch;
let requestCapture;
globalThis.fetch = async (url, options = {}) => {
const stringUrl = String(url);
if (stringUrl === "https://example.com/stability-input.png") {
return new Response(new Uint8Array([4, 5]), {
status: 200,
headers: { "content-type": "image/png" },
});
}
if (stringUrl === "https://api.stability.ai/v2beta/stable-image/edit/inpaint") {
requestCapture = {
url: stringUrl,
headers: options.headers,
body: options.body,
};
return new Response(JSON.stringify({ image: "c3RhYmlsaXR5LWltYWdl" }), {
status: 200,
headers: { "content-type": "application/json" },
});
}
throw new Error(`Unexpected URL: ${stringUrl}`);
};
try {
const result = await handleImageGeneration({
body: {
model: "stability-ai/inpaint",
prompt: "replace the sky with aurora",
negative_prompt: "rain",
image_url: "https://example.com/stability-input.png",
mask: "data:image/png;base64,AA==",
response_format: "b64_json",
},
credentials: { apiKey: "stability-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(requestCapture.url, "https://api.stability.ai/v2beta/stable-image/edit/inpaint");
assert.equal(requestCapture.headers.Authorization, "Bearer stability-key");
assert.equal(requestCapture.headers.Accept, "application/json");
assert.equal(requestCapture.headers["Content-Type"], undefined);
assert.ok(requestCapture.body instanceof FormData);
assert.equal(requestCapture.body.get("prompt"), "replace the sky with aurora");
assert.equal(requestCapture.body.get("negative_prompt"), "rain");
assert.equal(requestCapture.body.get("output_format"), "png");
assert.equal((requestCapture.body.get("image") as Blob).size, 2);
assert.equal((requestCapture.body.get("mask") as Blob).size, 1);
assert.equal(result.data.data[0].b64_json, "c3RhYmlsaXR5LWltYWdl");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration sends Stability AI text generation as multipart form data", async () => {
const originalFetch = globalThis.fetch;
let requestCapture;
globalThis.fetch = async (url, options = {}) => {
const stringUrl = String(url);
if (stringUrl === "https://api.stability.ai/v2beta/stable-image/generate/core") {
requestCapture = {
url: stringUrl,
headers: options.headers,
body: options.body,
};
return new Response(JSON.stringify({ image: "c3RhYmlsaXR5LWNvcmU=" }), {
status: 200,
headers: { "content-type": "application/json" },
});
}
throw new Error(`Unexpected URL: ${stringUrl}`);
};
try {
const result = await handleImageGeneration({
body: {
model: "stability-ai/stable-image-core",
prompt: "city near beach",
size: "1024x1024",
response_format: "b64_json",
},
credentials: { apiKey: "stability-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(requestCapture.url, "https://api.stability.ai/v2beta/stable-image/generate/core");
assert.equal(requestCapture.headers.Authorization, "Bearer stability-key");
assert.equal(requestCapture.headers.Accept, "application/json");
assert.equal(requestCapture.headers["Content-Type"], undefined);
assert.ok(requestCapture.body instanceof FormData);
assert.equal(requestCapture.body.get("prompt"), "city near beach");
assert.equal(requestCapture.body.get("mode"), "text-to-image");
assert.equal(requestCapture.body.get("aspect_ratio"), "1:1");
assert.equal(requestCapture.body.get("output_format"), "png");
assert.equal(result.data.data[0].b64_json, "c3RhYmlsaXR5LWNvcmU=");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration polls Black Forest Labs results and sends base64 input images", async () => {
const originalFetch = globalThis.fetch;
const originalSetTimeout = globalThis.setTimeout;
let createCapture;
let pollCapture;
globalThis.setTimeout = immediateTimeout;
globalThis.fetch = async (url, options = {}) => {
const stringUrl = String(url);
if (stringUrl === "https://example.com/bfl-input.png") {
return new Response(new Uint8Array([1, 2]), {
status: 200,
headers: { "content-type": "image/png" },
});
}
if (stringUrl === "https://api.bfl.ai/v1/flux-kontext-pro") {
createCapture = {
url: stringUrl,
headers: options.headers,
body: JSON.parse(String(options.body || "{}")),
};
return new Response(JSON.stringify({ polling_url: "https://api.bfl.ai/result/123" }), {
status: 200,
headers: { "content-type": "application/json" },
});
}
if (stringUrl === "https://api.bfl.ai/result/123") {
pollCapture = {
url: stringUrl,
headers: options.headers,
};
return new Response(
JSON.stringify({
status: "Ready",
result: { sample: "https://cdn.example.com/bfl-result.png" },
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
}
if (stringUrl === "https://cdn.example.com/bfl-result.png") {
return new Response(new Uint8Array([9, 8, 7]), {
status: 200,
headers: { "content-type": "image/png" },
});
}
throw new Error(`Unexpected URL: ${stringUrl}`);
};
try {
const result = await handleImageGeneration({
body: {
model: "black-forest-labs/flux-kontext-pro",
prompt: "change the car color to blue",
image_url: "https://example.com/bfl-input.png",
size: "1024x1792",
response_format: "b64_json",
},
credentials: { apiKey: "bfl-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(createCapture.url, "https://api.bfl.ai/v1/flux-kontext-pro");
assert.equal(createCapture.headers["x-key"], "bfl-key");
assert.equal(createCapture.body.input_image, "AQI=");
assert.equal(createCapture.body.aspect_ratio, "9:16");
assert.equal(pollCapture.headers["x-key"], "bfl-key");
assert.equal(result.data.data[0].b64_json, "CQgH");
} finally {
globalThis.fetch = originalFetch;
globalThis.setTimeout = originalSetTimeout;
}
});
test("handleImageGeneration calls native Recraft endpoint with model in body", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (url, options = {}) => {
captured = {
url: String(url),
headers: options.headers,
body: JSON.parse(String(options.body || "{}")),
};
return new Response(
JSON.stringify({
data: [{ url: "https://cdn.example.com/recraft.png" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "recraft/recraftv3",
prompt: "vector fox logo",
size: "1024x1024",
style: "digital_illustration",
},
credentials: { apiKey: "recraft-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(captured.url, "https://external.api.recraft.ai/v1/images/generations");
assert.equal(captured.headers.Authorization, "Bearer recraft-key");
assert.deepEqual(captured.body, {
model: "recraftv3",
prompt: "vector fox logo",
size: "1024x1024",
style: "digital_illustration",
});
assert.equal(result.data.data[0].url, "https://cdn.example.com/recraft.png");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration uploads source images to Topaz and returns base64 output", async () => {
const originalFetch = globalThis.fetch;
let requestCapture;
globalThis.fetch = async (url, options = {}) => {
const stringUrl = String(url);
if (stringUrl === "https://example.com/topaz-input.png") {
return new Response(new Uint8Array([1, 2, 3]), {
status: 200,
headers: { "content-type": "image/png" },
});
}
if (stringUrl === "https://api.topazlabs.com/image/v1/enhance") {
const formData = options.body as FormData;
requestCapture = {
url: stringUrl,
headers: options.headers,
outputWidth: formData.get("output_width"),
outputHeight: formData.get("output_height"),
image: formData.get("image"),
};
return new Response(new Uint8Array([7, 7, 7]), {
status: 200,
headers: { "content-type": "image/jpeg" },
});
}
throw new Error(`Unexpected URL: ${stringUrl}`);
};
try {
const result = await handleImageGeneration({
body: {
model: "topaz/topaz-enhance",
prompt: "enhance image",
image_url: "https://example.com/topaz-input.png",
size: "2048x2048",
response_format: "b64_json",
},
credentials: { apiKey: "topaz-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(requestCapture.url, "https://api.topazlabs.com/image/v1/enhance");
assert.equal(requestCapture.headers["X-API-Key"], "topaz-key");
assert.equal(requestCapture.outputWidth, "2048");
assert.equal(requestCapture.outputHeight, "2048");
assert.ok(requestCapture.image instanceof File);
assert.equal(result.data.data[0].b64_json, "BwcH");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration sends Antigravity image requests with native image_gen envelope", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (url, options = {}) => {
captured = {
url: String(url),
headers: options.headers,
body: JSON.parse(String(options.body || "{}")),
};
return new Response(
JSON.stringify({
response: {
candidates: [
{
content: {
parts: [
{
thoughtSignature: "signature",
inlineData: { mimeType: "image/jpeg", data: "YmFzZTY0LWdlbWluaQ==" },
},
],
},
},
],
modelVersion: "gemini-3.1-flash-image",
},
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "antigravity/gemini-3.1-flash-image-preview",
prompt: "painted beach",
size: "1024x1024",
aspect_ratio: "not-a-ratio",
},
credentials: { accessToken: "ag-token", projectId: "project-123" },
log: null,
});
assert.equal(result.success, true);
assert.equal(
captured.url,
"https://daily-cloudcode-pa.googleapis.com/v1internal:generateContent"
);
assert.equal(captured.headers.Authorization, "Bearer ag-token");
assert.equal(captured.headers["x-client-name"], "antigravity");
assert.equal(captured.headers["x-goog-user-project"], "project-123");
assert.ok(captured.headers["User-Agent"].startsWith("Antigravity/"));
assert.equal(captured.body.project, "project-123");
assert.match(captured.body.requestId, /^image_gen\//);
assert.equal(captured.body.model, "gemini-3.1-flash-image");
assert.equal(captured.body.userAgent, "antigravity");
assert.equal(captured.body.requestType, "image_gen");
assert.deepEqual(captured.body.request, {
contents: [{ role: "user", parts: [{ text: "painted beach" }] }],
generationConfig: {
candidateCount: 1,
imageConfig: { aspectRatio: "1:1" },
},
});
assert.deepEqual(result.data.data, [
{ b64_json: "YmFzZTY0LWdlbWluaQ==", revised_prompt: "painted beach" },
]);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration rejects Antigravity image requests without projectId", async () => {
const originalFetch = globalThis.fetch;
globalThis.fetch = async () => {
throw new Error("fetch should not be called without an Antigravity projectId");
};
try {
const result = await handleImageGeneration({
body: {
model: "antigravity/gemini-3.1-flash-image",
prompt: "painted forest",
size: "1024x1024",
},
credentials: { accessToken: "ag-token" },
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 400);
assert.match(String(result.error), /Missing Google projectId/);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration retries Antigravity image requests without billing project on 403", async () => {
const originalFetch = globalThis.fetch;
const calls = [];
globalThis.fetch = async (url, options = {}) => {
calls.push({
url: String(url),
headers: options.headers,
body: JSON.parse(String(options.body || "{}")),
});
if (calls.length === 1) {
return new Response(
JSON.stringify({
error: {
code: 403,
message: "Cloud Code Private API has not been used in project project-123 before.",
status: "PERMISSION_DENIED",
},
}),
{ status: 403, headers: { "content-type": "application/json" } }
);
}
return new Response(
JSON.stringify({
response: {
candidates: [
{
content: {
parts: [
{
inlineData: { mimeType: "image/jpeg", data: "YmFzZTY0LXJldHJ5" },
},
],
},
},
],
modelVersion: "gemini-3.1-flash-image",
},
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "antigravity/gemini-3.1-flash-image",
prompt: "painted forest",
size: "1024x1024",
},
credentials: { accessToken: "ag-token", projectId: "project-123" },
log: null,
});
assert.equal(result.success, true);
assert.equal(calls.length, 2);
assert.equal(calls[0].headers["x-goog-user-project"], "project-123");
assert.equal(calls[1].headers["x-goog-user-project"], undefined);
assert.equal(calls[1].body.project, "project-123");
assert.deepEqual(result.data.data, [
{ b64_json: "YmFzZTY0LXJldHJ5", revised_prompt: "painted forest" },
]);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration sanitizes Antigravity upstream error payloads", async () => {
const originalFetch = globalThis.fetch;
globalThis.fetch = async () =>
new Response(
JSON.stringify({
error: {
code: 500,
message:
"failed at /Users/backryun/OmniRoute/open-sse/handlers/imageGeneration.ts:1\nstack",
status: "INTERNAL",
},
}),
{ status: 500, headers: { "content-type": "application/json" } }
);
try {
const result = await handleImageGeneration({
body: {
model: "antigravity/gemini-3.1-flash-image",
prompt: "painted forest",
size: "1024x1024",
},
credentials: { accessToken: "ag-token", projectId: "project-123" },
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 500);
assert.equal(result.error.error.message, "failed at <path>");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration retries Nebius against the fallback URL after retryable failures", async () => {
const originalFetch = globalThis.fetch;
const calls = [];
globalThis.fetch = async (url, options = {}) => {
calls.push({
url: String(url),
body: JSON.parse(String(options.body || "{}")),
headers: options.headers,
});
if (calls.length === 1) {
return new Response("primary missing", { status: 404 });
}
return new Response(
JSON.stringify({
created: 321,
data: [{ url: "https://cdn.example.com/fallback.png" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "nebius/black-forest-labs/flux-dev",
prompt: "fallback skyline",
},
credentials: { apiKey: "nebius-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(calls.length, 2);
assert.equal(calls[0].url, "https://api.tokenfactory.nebius.com/v1/images/generations");
assert.equal(calls[1].url, "https://api.studio.nebius.com/v1/images/generations");
assert.equal(calls[1].headers.Authorization, "Bearer nebius-key");
assert.deepEqual(calls[1].body, {
model: "black-forest-labs/flux-dev",
prompt: "fallback skyline",
});
assert.deepEqual(result.data.data, [{ url: "https://cdn.example.com/fallback.png" }]);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration supports NanoBanana synchronous flash responses", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (url, options = {}) => {
captured = {
url: String(url),
body: JSON.parse(String(options.body || "{}")),
headers: options.headers,
};
return new Response(JSON.stringify({ image: "bmFub2JhbmFuYS1pbWFnZQ==" }), {
status: 200,
headers: { "content-type": "application/json" },
});
};
try {
const result = await handleImageGeneration({
body: {
model: "nanobanana/nanobanana-flash",
prompt: "banana robot",
n: 2,
size: "1024x1792",
},
credentials: { apiKey: "banana-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(captured.url, "https://api.nanobananaapi.ai/api/v1/nanobanana/generate");
assert.equal(captured.headers.Authorization, "Bearer banana-key");
assert.deepEqual(captured.body, {
prompt: "banana robot",
type: "TEXTTOIAMGE",
numImages: 2,
image_size: "9:16",
});
assert.deepEqual(result.data.data, [
{ b64_json: "bmFub2JhbmFuYS1pbWFnZQ==", revised_prompt: "banana robot" },
]);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration uses the NanoBanana pro endpoint and keeps sync data payloads", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (url, options = {}) => {
captured = {
url: String(url),
body: JSON.parse(String(options.body || "{}")),
};
return new Response(
JSON.stringify({
data: [{ url: "https://cdn.example.com/pro-image.png", revised_prompt: "banana pro" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "nanobanana/nanobanana-pro",
prompt: "banana pro",
size: "1024x1024",
quality: "hd",
imageUrls: ["https://example.com/ref.png"],
},
credentials: { apiKey: "banana-pro-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(captured.url, "https://api.nanobananaapi.ai/api/v1/nanobanana/generate-pro");
assert.deepEqual(captured.body, {
prompt: "banana pro",
resolution: "2K",
aspectRatio: "1:1",
imageUrls: ["https://example.com/ref.png"],
});
assert.deepEqual(result.data.data, [
{ url: "https://cdn.example.com/pro-image.png", revised_prompt: "banana pro" },
]);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration polls NanoBanana task results and converts URLs to base64 when requested", async () => {
const originalFetch = globalThis.fetch;
const calls = [];
globalThis.fetch = async (url, options = {}) => {
const stringUrl = String(url);
calls.push(stringUrl);
if (stringUrl === "https://api.nanobananaapi.ai/api/v1/nanobanana/generate") {
return new Response(JSON.stringify({ taskId: "task-1" }), {
status: 200,
headers: { "content-type": "application/json" },
});
}
if (stringUrl === "https://api.nanobananaapi.ai/api/v1/nanobanana/record-info?taskId=task-1") {
return new Response(
JSON.stringify({
data: {
successFlag: 1,
response: { resultImageUrl: "https://cdn.example.com/result.png" },
},
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
}
if (stringUrl === "https://cdn.example.com/result.png") {
return new Response(new Uint8Array([1, 2, 3, 4]), { status: 200 });
}
throw new Error(`Unexpected URL: ${stringUrl}`);
};
try {
const result = await handleImageGeneration({
body: {
model: "nanobanana/nanobanana-flash",
prompt: "banana async",
response_format: "b64_json",
},
credentials: { apiKey: "banana-key" },
log: null,
});
assert.equal(result.success, true);
assert.deepEqual(calls, [
"https://api.nanobananaapi.ai/api/v1/nanobanana/generate",
"https://api.nanobananaapi.ai/api/v1/nanobanana/record-info?taskId=task-1",
"https://cdn.example.com/result.png",
]);
assert.deepEqual(result.data.data, [{ b64_json: "AQIDBA==", revised_prompt: "banana async" }]);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration rejects NanoBanana submissions that never return a task identifier", async () => {
const originalFetch = globalThis.fetch;
globalThis.fetch = async () =>
new Response(JSON.stringify({ ok: true }), {
status: 200,
headers: { "content-type": "application/json" },
});
try {
const result = await handleImageGeneration({
body: {
model: "nanobanana/nanobanana-flash",
prompt: "banana missing task",
},
credentials: { apiKey: "banana-key" },
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 502);
assert.match(result.error, /did not return taskId/);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration executes ComfyUI workflows and normalizes image outputs", async () => {
const originalFetch = globalThis.fetch;
const originalSetTimeout = globalThis.setTimeout;
let promptBody;
globalThis.setTimeout = immediateTimeout;
globalThis.fetch = async (url, options = {}) => {
const stringUrl = String(url);
if (stringUrl === "http://localhost:8188/prompt") {
promptBody = JSON.parse(String(options.body || "{}"));
return new Response(JSON.stringify({ prompt_id: "image-1" }), {
status: 200,
headers: { "content-type": "application/json" },
});
}
if (stringUrl === "http://localhost:8188/history/image-1") {
return new Response(
JSON.stringify({
"image-1": {
outputs: {
9: {
images: [{ filename: "frame.png", subfolder: "out", type: "output" }],
},
},
},
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
}
if (stringUrl.includes("/view?")) {
return new Response(new Uint8Array([9, 9, 9]), { status: 200 });
}
throw new Error(`Unexpected URL: ${stringUrl}`);
};
try {
const result = await handleImageGeneration({
body: {
model: "comfyui/flux-dev",
prompt: "comfy forest",
negative_prompt: "blurry",
size: "768x512",
n: 2,
},
credentials: null,
log: null,
});
assert.equal(result.success, true);
assert.equal(promptBody.prompt["5"].inputs.width, 768);
assert.equal(promptBody.prompt["5"].inputs.height, 512);
assert.equal(promptBody.prompt["5"].inputs.batch_size, 2);
assert.deepEqual(result.data.data, [{ b64_json: "CQkJ", revised_prompt: "comfy forest" }]);
} finally {
globalThis.fetch = originalFetch;
globalThis.setTimeout = originalSetTimeout;
}
});
test("handleImageGeneration returns provider errors when ComfyUI submission fails", async () => {
const originalFetch = globalThis.fetch;
globalThis.fetch = async () => new Response("boom", { status: 500 });
try {
const result = await handleImageGeneration({
body: {
model: "comfyui/flux-dev",
prompt: "broken workflow",
},
credentials: null,
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 502);
assert.match(result.error, /ComfyUI submit failed \(500\): boom/);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration supports dynamically registered Imagen3 providers", async () => {
const originalFetch = globalThis.fetch;
const originalProvider = IMAGE_PROVIDERS.imagen3;
let captured;
IMAGE_PROVIDERS.imagen3 = {
id: "imagen3",
baseUrl: "https://imagen.example.com/v1/generate",
authType: "apikey",
authHeader: "bearer",
format: "imagen3",
models: [{ id: "image-gen", name: "Image Gen" }],
supportedSizes: ["1024x1024"],
};
globalThis.fetch = async (url, options = {}) => {
captured = {
url: String(url),
headers: options.headers,
body: JSON.parse(String(options.body || "{}")),
};
return new Response(
JSON.stringify({
created: 42,
images: [{ image: "aW1hZ2VuLTM=" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "imagen3/image-gen",
prompt: "vertex skyline",
size: "1792x1024",
},
credentials: { apiKey: "imagen-key" },
log: null,
});
assert.equal(result.success, true);
assert.equal(captured.url, "https://imagen.example.com/v1/generate");
assert.equal(captured.headers.Authorization, "Bearer imagen-key");
assert.deepEqual(captured.body, {
prompt: "vertex skyline",
aspect_ratio: "16:9",
number_of_images: 1,
});
assert.deepEqual(result.data.data, [
{ b64_json: "aW1hZ2VuLTM=", revised_prompt: "vertex skyline" },
]);
} finally {
globalThis.fetch = originalFetch;
if (originalProvider) {
IMAGE_PROVIDERS.imagen3 = originalProvider;
} else {
delete IMAGE_PROVIDERS.imagen3;
}
}
});
test("handleImageGeneration preserves Imagen3 data arrays when providers already return OpenAI-like payloads", async () => {
const originalFetch = globalThis.fetch;
const originalProvider = IMAGE_PROVIDERS.imagen3;
IMAGE_PROVIDERS.imagen3 = {
id: "imagen3",
baseUrl: "https://imagen.example.com/v1/generate",
authType: "apikey",
authHeader: "bearer",
format: "imagen3",
models: [{ id: "image-gen", name: "Image Gen" }],
supportedSizes: ["1024x1024"],
};
globalThis.fetch = async () =>
new Response(
JSON.stringify({
data: [{ url: "https://cdn.example.com/already-normalized.png" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
try {
const result = await handleImageGeneration({
body: {
model: "imagen3/image-gen",
prompt: "normalized payload",
},
credentials: { apiKey: "imagen-key" },
log: null,
});
assert.equal(result.success, true);
assert.deepEqual(result.data.data, [{ url: "https://cdn.example.com/already-normalized.png" }]);
} finally {
globalThis.fetch = originalFetch;
if (originalProvider) {
IMAGE_PROVIDERS.imagen3 = originalProvider;
} else {
delete IMAGE_PROVIDERS.imagen3;
}
}
});
test("handleImageGeneration returns provider errors when Imagen3 fetch throws", async () => {
const originalFetch = globalThis.fetch;
const originalProvider = IMAGE_PROVIDERS.imagen3;
IMAGE_PROVIDERS.imagen3 = {
id: "imagen3",
baseUrl: "https://imagen.example.com/v1/generate",
authType: "apikey",
authHeader: "bearer",
format: "imagen3",
models: [{ id: "image-gen", name: "Image Gen" }],
supportedSizes: ["1024x1024"],
};
globalThis.fetch = async () => {
throw new Error("imagen upstream timeout");
};
try {
const result = await handleImageGeneration({
body: {
model: "imagen3/image-gen",
prompt: "broken imagen",
},
credentials: { apiKey: "imagen-key" },
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 502);
assert.equal(result.error, "Image provider error: imagen upstream timeout");
} finally {
globalThis.fetch = originalFetch;
if (originalProvider) {
IMAGE_PROVIDERS.imagen3 = originalProvider;
} else {
delete IMAGE_PROVIDERS.imagen3;
}
}
});
test("handleImageGeneration uses the default synthetic base URL for resolved custom providers without baseUrl", async () => {
const originalFetch = globalThis.fetch;
let capturedUrl;
globalThis.fetch = async (url) => {
capturedUrl = String(url);
return new Response(JSON.stringify({ data: [{ b64_json: "ZmFrZS1jdXN0b20=" }] }), {
status: 200,
headers: { "content-type": "application/json" },
});
};
try {
const result = await handleImageGeneration({
body: {
model: "custom-provider/super-image",
prompt: "fallback base url",
},
credentials: { apiKey: "custom-key" },
resolvedProvider: "custom-provider",
log: null,
});
assert.equal(result.success, true);
assert.equal(
capturedUrl,
"https://generativelanguage.googleapis.com/v1beta/openai/images/generations"
);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration logs OpenAI-compatible upstream failures and transport errors", async () => {
const originalFetch = globalThis.fetch;
const log = createLogRecorder();
globalThis.fetch = async () => new Response("primary unavailable", { status: 503 });
try {
const failed = await handleImageGeneration({
body: {
model: "openai/gpt-image-2",
prompt: "broken upstream",
},
credentials: { apiKey: "image-key" },
log,
});
assert.equal(failed.success, false);
assert.equal(failed.status, 503);
assert.match(log.entries.at(-1).message, /openai error 503/);
} finally {
globalThis.fetch = originalFetch;
}
globalThis.fetch = async () => {
throw new Error("socket closed");
};
try {
const errored = await handleImageGeneration({
body: {
model: "openai/gpt-image-2",
prompt: "transport issue",
},
credentials: { apiKey: "image-key" },
log,
});
assert.equal(errored.success, false);
assert.equal(errored.status, 502);
assert.equal(errored.error, "Image provider error: socket closed");
assert.match(log.entries.at(-1).message, /socket closed/);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration logs Nebius fallback attempts before succeeding", async () => {
const originalFetch = globalThis.fetch;
const log = createLogRecorder();
let callCount = 0;
globalThis.fetch = async (url) => {
callCount += 1;
if (callCount === 1) {
assert.equal(String(url), "https://api.tokenfactory.nebius.com/v1/images/generations");
return new Response("primary missing", { status: 404 });
}
return new Response(
JSON.stringify({
data: [{ url: "https://cdn.example.com/fallback-logged.png" }],
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const result = await handleImageGeneration({
body: {
model: "nebius/black-forest-labs/flux-dev",
prompt: "fallback logging",
},
credentials: { apiKey: "nebius-key" },
log,
});
assert.equal(result.success, true);
assert.equal(
log.entries.some((entry) => entry.level === "info" && /trying fallback/.test(entry.message)),
true
);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration surfaces Hyperbolic upstream failures and fetch exceptions", async () => {
const originalFetch = globalThis.fetch;
const log = createLogRecorder();
globalThis.fetch = async () => new Response("hyperbolic unavailable", { status: 429 });
try {
const failed = await handleImageGeneration({
body: {
model: "hyperbolic/FLUX.1-dev",
prompt: "too busy",
},
credentials: { apiKey: "hyper-key" },
log,
});
assert.equal(failed.success, false);
assert.equal(failed.status, 429);
assert.equal(failed.error, "hyperbolic unavailable");
} finally {
globalThis.fetch = originalFetch;
}
globalThis.fetch = async () => {
throw new Error("hyperbolic network down");
};
try {
const errored = await handleImageGeneration({
body: {
model: "hyperbolic/FLUX.1-dev",
prompt: "network issue",
},
credentials: { apiKey: "hyper-key" },
log,
});
assert.equal(errored.success, false);
assert.equal(errored.status, 502);
assert.equal(errored.error, "Image provider error: hyperbolic network down");
assert.match(log.entries.at(-1).message, /hyperbolic network down/);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration handles NanoBanana missing statusUrl, failed tasks and empty completed payloads", async () => {
const originalFetch = globalThis.fetch;
const originalProvider = structuredClone(IMAGE_PROVIDERS.nanobanana);
const log = createLogRecorder();
IMAGE_PROVIDERS.nanobanana = {
...IMAGE_PROVIDERS.nanobanana,
statusUrl: undefined,
};
globalThis.fetch = async () =>
new Response(JSON.stringify({ taskId: "task-missing-status" }), {
status: 200,
headers: { "content-type": "application/json" },
});
try {
const missingStatusUrl = await handleImageGeneration({
body: {
model: "nanobanana/nanobanana-flash",
prompt: "missing status url",
},
credentials: { apiKey: "banana-key" },
log,
});
assert.equal(missingStatusUrl.success, false);
assert.equal(missingStatusUrl.status, 500);
assert.match(missingStatusUrl.error, /statusUrl is not configured/);
} finally {
IMAGE_PROVIDERS.nanobanana = originalProvider;
globalThis.fetch = originalFetch;
}
globalThis.fetch = async (url) => {
const stringUrl = String(url);
if (stringUrl.endsWith("/generate")) {
return new Response(JSON.stringify({ taskId: "task-failed" }), {
status: 200,
headers: { "content-type": "application/json" },
});
}
return new Response(
JSON.stringify({
data: { successFlag: 2, errorMessage: "NanoBanana generation failed" },
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const failedTask = await handleImageGeneration({
body: {
model: "nanobanana/nanobanana-flash",
prompt: "failed task",
poll_interval_ms: 1,
},
credentials: { apiKey: "banana-key" },
log,
});
assert.equal(failedTask.success, false);
assert.equal(failedTask.status, 502);
assert.equal(failedTask.error, "NanoBanana generation failed");
} finally {
globalThis.fetch = originalFetch;
}
globalThis.fetch = async (url) => {
const stringUrl = String(url);
if (stringUrl.endsWith("/generate")) {
return new Response(JSON.stringify({ taskId: "task-empty" }), {
status: 200,
headers: { "content-type": "application/json" },
});
}
return new Response(
JSON.stringify({
data: { successFlag: 1, response: {} },
}),
{ status: 200, headers: { "content-type": "application/json" } }
);
};
try {
const completedWithoutPayload = await handleImageGeneration({
body: {
model: "nanobanana/nanobanana-flash",
prompt: "empty payload",
poll_interval_ms: 1,
},
credentials: { apiKey: "banana-key" },
log,
});
assert.equal(completedWithoutPayload.success, true);
assert.deepEqual(completedWithoutPayload.data.data, []);
assert.equal(
log.entries.some(
(entry) => entry.level === "warn" && /completed without image payload/.test(entry.message)
),
true
);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration surfaces SD WebUI upstream and transport failures", async () => {
const originalFetch = globalThis.fetch;
const log = createLogRecorder();
globalThis.fetch = async () => new Response("sdwebui error", { status: 500 });
try {
const failed = await handleImageGeneration({
body: {
model: "sdwebui/sdxl-base-1.0",
prompt: "broken sdwebui",
},
credentials: null,
log,
});
assert.equal(failed.success, false);
assert.equal(failed.status, 500);
assert.equal(failed.error, "sdwebui error");
} finally {
globalThis.fetch = originalFetch;
}
globalThis.fetch = async () => {
throw new Error("socket hang up");
};
try {
const errored = await handleImageGeneration({
body: {
model: "sdwebui/sdxl-base-1.0",
prompt: "sdwebui transport issue",
},
credentials: null,
log,
});
assert.equal(errored.success, false);
assert.equal(errored.status, 502);
assert.equal(errored.error, "Image provider error: socket hang up");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration normalizes Imagen3 single-image payloads and non-ok responses", async () => {
const originalFetch = globalThis.fetch;
const originalProvider = IMAGE_PROVIDERS.imagen3;
IMAGE_PROVIDERS.imagen3 = {
id: "imagen3",
baseUrl: "https://imagen.example.com/v1/generate",
authType: "apikey",
authHeader: "bearer",
format: "imagen3",
models: [{ id: "image-gen", name: "Image Gen" }],
supportedSizes: ["1024x1024"],
};
globalThis.fetch = async () =>
new Response(JSON.stringify({ image: "aW1hZ2VuLXNpbmdsZQ==" }), {
status: 200,
headers: { "content-type": "application/json" },
});
try {
const singleObject = await handleImageGeneration({
body: {
model: "imagen3/image-gen",
prompt: "single image",
},
credentials: { apiKey: "imagen-key" },
log: null,
});
assert.equal(singleObject.success, true);
assert.deepEqual(singleObject.data.data, [
{ b64_json: "aW1hZ2VuLXNpbmdsZQ==", url: undefined, revised_prompt: "single image" },
]);
} finally {
globalThis.fetch = originalFetch;
}
globalThis.fetch = async () => new Response("imagen failed", { status: 503 });
try {
const failed = await handleImageGeneration({
body: {
model: "imagen3/image-gen",
prompt: "imagen failed",
},
credentials: { apiKey: "imagen-key" },
log: createLogRecorder(),
});
assert.equal(failed.success, false);
assert.equal(failed.status, 503);
assert.equal(failed.error, "imagen failed");
} finally {
globalThis.fetch = originalFetch;
if (originalProvider) {
IMAGE_PROVIDERS.imagen3 = originalProvider;
} else {
delete IMAGE_PROVIDERS.imagen3;
}
}
});
const { extractImageGenerationCalls } = await import("../../open-sse/handlers/imageGeneration.ts");
function buildCodexSSE(items) {
const frames = items.map((item) => JSON.stringify({ type: "response.output_item.done", item }));
return frames.map((frame) => `event: response.output_item.done\ndata: ${frame}\n`).join("\n");
}
test("extractImageGenerationCalls pulls base64 PNG from image_generation_call output items", () => {
const sse = buildCodexSSE([
{
type: "image_generation_call",
id: "ig_1",
status: "completed",
revised_prompt: "a small kitten",
result: "aGVsbG8=",
},
]);
const calls = extractImageGenerationCalls(sse);
assert.equal(calls.length, 1);
assert.equal(calls[0].b64, "aGVsbG8=");
assert.equal(calls[0].revisedPrompt, "a small kitten");
});
test("extractImageGenerationCalls ignores unrelated events and malformed lines", () => {
const sse = [
"event: response.in_progress",
`data: ${JSON.stringify({ type: "response.in_progress" })}`,
"",
"data: not-json",
"",
"event: response.output_item.done",
`data: ${JSON.stringify({
type: "response.output_item.done",
item: { type: "message", role: "assistant", content: [] },
})}`,
"",
"data: [DONE]",
].join("\n");
assert.deepEqual(extractImageGenerationCalls(sse), []);
});
test("handleImageGeneration routes codex image requests through /responses with image_generation tool", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (url, options = {}) => {
captured = {
url: String(url),
headers: options.headers,
body: JSON.parse(String(options.body || "{}")),
};
const sse = buildCodexSSE([
{
type: "image_generation_call",
id: "ig_1",
status: "completed",
revised_prompt: "happy red kitten",
result: "a2l0dGVu",
},
]);
return new Response(sse, {
status: 200,
headers: { "content-type": "text/event-stream" },
});
};
try {
const result = await handleImageGeneration({
body: {
model: "codex/gpt-5.4",
prompt: "Draw a happy red kitten",
response_format: "b64_json",
},
credentials: {
accessToken: "codex-token",
providerSpecificData: { workspaceId: "acct-123" },
},
log: null,
});
assert.equal(result.success, true);
assert.equal(captured.url, "https://chatgpt.com/backend-api/codex/responses");
assert.equal(captured.headers.Authorization, "Bearer codex-token");
assert.equal(captured.headers["chatgpt-account-id"], "acct-123");
assert.equal(captured.body.model, "gpt-5.4");
assert.equal(captured.body.stream, true);
assert.equal(captured.body.store, false);
assert.deepEqual(captured.body.tools, [{ type: "image_generation", output_format: "png" }]);
assert.equal(captured.body.input[0].role, "user");
assert.equal(captured.body.input[0].content[0].text, "Draw a happy red kitten");
assert.equal(result.data.data[0].b64_json, "a2l0dGVu");
assert.equal(result.data.data[0].revised_prompt, "happy red kitten");
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration (codex) returns a data URL when response_format is not b64_json", async () => {
const originalFetch = globalThis.fetch;
globalThis.fetch = async () => {
const sse = buildCodexSSE([
{ type: "image_generation_call", id: "ig_2", status: "completed", result: "YWJjZA==" },
]);
return new Response(sse, { status: 200 });
};
try {
const result = await handleImageGeneration({
body: { model: "cx/gpt-5.4", prompt: "kitten" },
credentials: { accessToken: "codex-token" },
log: null,
});
assert.equal(result.success, true);
assert.equal(result.data.data[0].url, "data:image/png;base64,YWJjZA==");
assert.equal(result.data.data[0].b64_json, undefined);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration (codex) surfaces an error when no image_generation_call is emitted", async () => {
const originalFetch = globalThis.fetch;
globalThis.fetch = async () => {
const sse = buildCodexSSE([
{ type: "message", role: "assistant", content: [{ type: "output_text", text: "hi" }] },
]);
return new Response(sse, { status: 200 });
};
try {
const result = await handleImageGeneration({
body: { model: "codex/gpt-5.4", prompt: "kitten" },
credentials: { accessToken: "codex-token" },
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 502);
assert.match(result.error, /image_generation_call/);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration (codex) propagates upstream HTTP errors", async () => {
const originalFetch = globalThis.fetch;
globalThis.fetch = async () =>
new Response("upstream boom", { status: 403, headers: { "content-type": "text/plain" } });
try {
const result = await handleImageGeneration({
body: { model: "codex/gpt-5.4", prompt: "kitten" },
credentials: { accessToken: "codex-token" },
log: null,
});
assert.equal(result.success, false);
assert.equal(result.status, 403);
assert.match(result.error, /upstream boom/);
} finally {
globalThis.fetch = originalFetch;
}
});
test("handleImageGeneration (codex) forwards size and maps GPT-Image quality to hosted tool config", async () => {
const originalFetch = globalThis.fetch;
let captured;
globalThis.fetch = async (_url, options = {}) => {
captured = JSON.parse(String(options.body || "{}"));
const sse = buildCodexSSE([
{ type: "image_generation_call", id: "ig_1", status: "completed", result: "YWJj" },
]);
return new Response(sse, { status: 200 });
};
try {
await handleImageGeneration({
body: {
model: "codex/gpt-5.4",
prompt: "kitten",
size: "1024x1792",
quality: "hd",
},
credentials: { accessToken: "codex-token" },
log: null,
});
assert.deepEqual(captured.tools, [
{
type: "image_generation",
output_format: "png",
size: "1024x1792",
quality: "high",
},
]);
await handleImageGeneration({
body: { model: "codex/gpt-5.4", prompt: "kitten", quality: "standard" },
credentials: { accessToken: "codex-token" },
log: null,
});
assert.equal(captured.tools[0].quality, "medium");
await handleImageGeneration({
body: { model: "codex/gpt-5.4", prompt: "kitten" },
credentials: { accessToken: "codex-token" },
log: null,
});
assert.deepEqual(captured.tools, [{ type: "image_generation", output_format: "png" }]);
} finally {
globalThis.fetch = originalFetch;
}
});