fix(daemon): route image requests into media generation

[mrcfps]

Closes #2953

Why

Users reported that plain image/poster requests could stay on the normal chat/code path instead of producing a real image file. I picked this up to close the repro where Image projects backed by BYOK OpenAI chat would print an od media generate command, and short freeform prompts like image could miss the media router entirely.

What users will see

When they ask Open Design to generate an image or poster, the request now stays on the image-generation path more reliably:

• concise prompts like image route into media generation instead of code output;
• BYOK OpenAI Image projects dispatch the built-in image tool and return an actual rendered image instead of shell instructions.

Surface area

• UI — new page / dialog / panel / menu item / setting / empty state in apps/web or apps/desktop (including Electron menu bar)
• Keyboard shortcut — new or changed
• CLI / env var — new od subcommand or flag, new tools-dev / tools-pack / tools-pr flag, or new OD_* env var
• API / contract — new /api/* endpoint, new SSE event, or changed shape in packages/contracts
• Extension point — new entry under skills/, design-systems/, design-templates/, or craft/, or change to the skills protocol
• i18n keys — added new translation keys (see TRANSLATIONS.md for the locale workflow)
• New top-level dependency — adding any new entry to the root package.json (dependencies or devDependencies); workspace-package package.json files are out of scope. Include a paragraph on what we get vs. what bytes we ship (see CONTRIBUTING.md → Code style)
• Default behavior change — changes what existing users experience without opting in (default model, default setting, file/SQLite schema, auto-network on startup, auto-install)
• None — internal refactor, docs, tests, or translation update only

Screenshots

None.

Bug fix verification

• Test paths that reproduce the bug: apps/daemon/tests/chat-route.test.ts, apps/daemon/tests/proxy-routes.test.ts
• Did the test go red on main and green on this branch? no — I verified the targeted regressions green on this branch, but did not re-run them on main in this worktree.

Validation

• pnpm exec vitest run -c vitest.config.ts tests/proxy-routes.test.ts
• pnpm exec vitest run -c vitest.config.ts tests/chat-route.test.ts -t "routes concise image-only prompts away from od-default and into image generation"
• pnpm --filter @open-design/daemon typecheck
• pnpm guard
• pnpm typecheck

_{🔁 Powered by Looper · runner=worker · agent=opencode · An autonomous AI dev team for your GitHub repos.}

[Siri-Ray]

@mrcfps I'm holding off on generating review comments for #3988 because this pull request has merge conflicts right now.

Please resolve the conflicts with main and push the updated branch. Once that's done, request or wait for the review to run again and I'll take another look.

_{🔁 Powered by Looper · runner=reviewer · agent=codex · An autonomous AI dev team for your GitHub repos.}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 370f7da246

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9bc3b3126b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[Siri-Ray]

@mrcfps Thanks for pushing this image-routing fix forward. I reviewed the daemon run-routing changes and the BYOK OpenAI image tool path; the main paths are covered, but I found one credential-precedence case worth tightening before users with an existing custom image provider hit it.

_{🔁 Powered by Looper · runner=reviewer · agent=codex · An autonomous AI dev team for your GitHub repos.}

[mrcfps]

Looper fixer round complete — e14819a

• ✅ Review comment on apps/daemon/src/media.ts:495 (@chatgpt-codex-connector) — thread
  • I changed apps/daemon/src/media.ts to skip the custom-image credential override whenever providerConfigOverride is present, and added a regression test in apps/daemon/tests/media-openai-compatible-providers.test.ts covering the BYOK OpenAI image path.
• • Review comment on apps/daemon/src/chat-routes.ts:1034 (@chatgpt-codex-connector) — thread
  • Agent did not provide a decision for this thread
• • Review comment on apps/daemon/src/media.ts:492 (@Siri-Ray) — thread
  • Agent did not provide a decision for this thread

_{🔁 Powered by Looper · runner=fixer · agent=opencode · An autonomous AI dev team for your GitHub repos.}

[chatgpt-codex-connector]

To use Codex here, create an environment for this repo.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e14819a2a4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[Siri-Ray]

@mrcfps Thanks for continuing to tighten the image-routing flow. I reviewed the daemon routing changes, the OpenAI image tool loop, and the added regression coverage. One main-path gap is still present: the new OpenAI proxy gate depends on projectId, but the current web OpenAI-compatible caller does not forward the proxy context, so the BYOK OpenAI Image project path described in the PR will still miss the tool loop from the UI.

_{🔁 Powered by Looper · runner=reviewer · agent=codex · An autonomous AI dev team for your GitHub repos.}

[mrcfps]

Looper fixer round complete — 0a17735

• ✅ Review comment on apps/daemon/src/chat-routes.ts:1034 (@chatgpt-codex-connector) — thread
  • I forwarded the optional proxy context through apps/web/src/providers/anthropic.ts and apps/web/src/providers/openai-compatible.ts so OpenAI proxy requests now carry projectId, and added a web regression in apps/web/tests/providers/sse.test.ts for the actual chat path.
• ✅ Review comment on apps/daemon/src/media.ts:492 (@Siri-Ray) — thread
  • This branch already skips custom-image overrides when providerConfigOverride is present in apps/daemon/src/media.ts, and apps/daemon/tests/media-openai-compatible-providers.test.ts covers the BYOK gpt-image-2 precedence case so per-request OpenAI credentials stay authoritative.
• • Review comment on apps/daemon/src/chat-routes.ts:1059 (@chatgpt-codex-connector) — thread
  • Agent did not provide a decision for this thread
• • Review comment on apps/daemon/src/chat-routes.ts:1031 (@Siri-Ray) — thread
  • Agent did not provide a decision for this thread

_{🔁 Powered by Looper · runner=fixer · agent=opencode · An autonomous AI dev team for your GitHub repos.}

[chatgpt-codex-connector]

To use Codex here, create an environment for this repo.

[mrcfps]

Looper fixer round complete — 3531c30

• ✅ Review comment on apps/daemon/src/chat-routes.ts:1059 (@chatgpt-codex-connector) — thread
  • I updated apps/daemon/src/chat-routes.ts so the OpenAI image tool now passes appendVersionedApiPath(baseUrl, '') as upstreamBaseUrl, and tightened apps/daemon/tests/proxy-routes.test.ts to cover the bare https://api.openai.com case.
• • Review comment on apps/daemon/src/chat-routes.ts:1031 (@Siri-Ray) — thread
  • The current branch already threads ProxyContext through apps/web/src/providers/anthropic.ts and apps/web/src/providers/openai-compatible.ts, and apps/web/tests/providers/sse.test.ts exercises the UI caller shape by asserting projectId reaches /api/proxy/openai/stream.

_{🔁 Powered by Looper · runner=fixer · agent=opencode · An autonomous AI dev team for your GitHub repos.}

[chatgpt-codex-connector]

To use Codex here, create an environment for this repo.

[Siri-Ray]

@mrcfps I reviewed the current head's daemon image-routing changes, the BYOK OpenAI image tool loop, the credential/base-url fixes from the follow-up commits, and the web OpenAI proxy context forwarding. The previous concerns are addressed in the changed ranges, and I did not find any additional actionable correctness or safety issues. Thanks for sticking with this and tightening the regression coverage around the real user paths. 🙂

_{🔁 Powered by Looper · runner=reviewer · agent=codex · An autonomous AI dev team for your GitHub repos.}

[github-actions]

Visual regression review

Head: c8f214f · Base: de5b189

18 case(s) have no baseline; PR screenshots are shown without a diff.

5 changed · 12 unchanged · 18 missing baseline · 0 failed

Changed cases

Case	Main	PR	Diff
visual-avatar-menu
visual-home-catalog
visual-new-project-modal
visual-settings-byok
visual-settings-execution

PR screenshots without baselines

Case	PR
visual-avatar-local-agent-list
visual-design-system-detail
visual-home-plugin-use-staged
visual-home-plugin-use-with-query
visual-home-staged-attachment
visual-integrations-mcp
visual-onboarding-runtime
visual-plugin-share-menu
visual-project-avatar-model-dropdown
visual-project-workspace
visual-settings-byok-model-dropdown
visual-settings-byok-openai
visual-settings-local-cli
visual-settings-local-cli-model-dropdown
visual-topbar-byok-model-dropdown
visual-topbar-byok-switcher
visual-topbar-local-cli-model-dropdown
visual-workspace-staged-contexts

Unchanged cases

Case	Main	PR	Diff
visual-design-systems
visual-home
visual-home-context-picker
visual-home-plugin-filter
visual-integrations
visual-integrations-use-everywhere
visual-plugin-details
visual-plugins
visual-projects
visual-projects-kanban
visual-tasks
visual-topbar-execution-switcher

Visual diff is advisory only and does not block merging.

[Siri-Ray]

@mrcfps I reviewed the current head's changed ranges across the daemon image-routing fallback, the OpenAI BYOK image tool loop, media credential precedence, web proxy context forwarding, and the added daemon/web regression coverage. The previous review concerns are addressed on this head, and I did not find any new actionable correctness, safety, or maintainability issues. I was not able to rerun the targeted Vitest commands in this prepared worktree because vitest is not installed in the package context, but the changed test coverage matches the user paths this PR is protecting. Thanks for continuing to tighten this flow and for carrying the follow-up fixes through. 🙂

_{🔁 Powered by Looper · runner=reviewer · agent=codex · An autonomous AI dev team for your GitHub repos.}