ryu-image 0.1.7

Image-generation modality primitive for Ryu: `generate(prompt) -> image` with a swappable engine seam (local stable-diffusion.cpp by default; OpenRouter/Replicate/fal cloud providers routed through the Gateway). An extracted Core capability crate — in-process by default and consumed as a NON-optional path dependency (the `POST /api/images/generate` data path reaches it unconditionally). Owns the image-gen abstraction + routing: prompt validation, default-count, the local-vs-cloud dispatch, and the media proxy/gateway-forward mechanics. Host couplings the crate cannot own (the local sd-server base-url, the Gateway url/token, and lazy-starting the sd.cpp sidecar) are injected via the narrow `ImageHost` trait, so the crate has ZERO dependency on apps/core.

ryu-image

Image-generation modality primitive for Ryu: generate(prompt) -> image behind a swappable engine seam.

Role in the decomposition

An extracted Core capability crate — in-process by default and consumed as a non-optional path dependency: the POST /api/images/generate data path reaches it unconditionally. It owns the image-gen abstraction + routing — prompt validation, default-count, local-vs-cloud dispatch, and the media proxy / gateway-forward mechanics. It carries zero dependency on apps/core. Host couplings it cannot own (the local sd-server base-url, the Gateway url/token, and lazy-starting the sd.cpp sidecar) inject via the narrow ImageHost trait.

Key API (`src/lib.rs`)

ImageHost — supplies local sd-server base-url, Gateway url/token, sidecar start.
generate(host, body) -> MediaResponse — the entry point (validate → dispatch).
cloud_provider(body) — reads the "provider" field to pick a cloud provider, else local.
forward_to_gateway / proxy — cloud-via-Gateway and local-proxy mechanics.
MediaResponse = (u16, Value) — status + JSON body; Core maps it back to axum.

Swap seam

stable-diffusion.cpp — local default (lazy-started sidecar).
OpenRouter / Replicate / fal — cloud providers, routed through the Gateway's /v1/images/generations, selected by the request "provider" field.

Consumed as