@koda-sl/baker-cli 0.68.0 → 0.70.0

package/README.md

@@ -1587,6 +1587,8 @@ Each external source is its own subcommand. Pick the verb that matches the sourc
 | `baker images find <q>` | Fanout: library + opted-in providers | off |
 | `baker images stock <q> [--type photo\|vector\|psd]` | Magnific (Freepik's dev API) — photos, vectors, illustrations, PSDs (~250M assets) | off |
 | `baker images google <q>` | Google Images via the official Custom Search JSON API | off |
+| `baker images pinterest <q>` | Pinterest reference imagery via ScrapeCreators (photo-real mood boards) | off |
+| `baker images generate <prompt>` | AI image generation via OpenRouter image models (cost-tracked) | **always on** (the bytes are the artifact) |
 | `baker images logo <domain>` | Brand logo via Brandfetch CDN | **on** (top 1) |
 | `baker images icon <name>` | Iconify (200+ icon sets, no API key) | off (CDN URL is stable) |
 | `baker images gif <q>` | Reaction GIFs / memes via Giphy (paid-social creative) | off |
@@ -1726,6 +1728,69 @@ Requires both `GOOGLE_CUSTOM_SEARCH_API_KEY` and `GOOGLE_CUSTOM_SEARCH_ENGINE_ID
 | `--auto-ingest`  | Ingest top N (0–20, default 0) and return Baker-owned URLs on ingested hits                                      |
 | `--context`      | Free-text hint passed to Gemini describe to bias the generated description and tags (overrides provider-derived context on auto-ingest paths) |
 
+### `baker images pinterest <query>`
+
+Pinterest image search via ScrapeCreators. The best source for **photo-real reference and mood imagery** — interiors, fashion, food, product styling, lifestyle. ⚠ Unverified, trademark-bearing web content — use for *reference*, not republishing. Strongest paired with `generate --reference` (find the look on Pinterest, then generate an owned, on-brand image from it). Auto-ingest is opt-in.
+
+```bash
+baker images pinterest "scandinavian living room"
+baker images pinterest "minimalist skincare product photography" --limit 20
+baker images pinterest "cozy coffee shop interior" --auto-ingest 2 --context "Mood reference for hero photography"
+```
+
+**Flags:**
+
+| Flag            | Description                                                                 |
+|-----------------|----------------------------------------------------------------------------|
+| `--limit`       | Max results (1–20, default 5)                                              |
+| `--auto-ingest` | Ingest top N (0–20, default 0) and return Baker-owned URLs on ingested hits |
+| `--context`     | Free-text hint passed to Gemini describe on auto-ingest (overrides the pin title) |
+
+Endpoint `api.scrapecreators.com/v1/pinterest/search` (`SCRAPE_CREATORS_API_KEY`), $0.00188/request, 1-day cache.
+
+### `baker images generate <prompt>`
+
+Generate an image with AI (OpenRouter image models) and ingest it into the library. The generated bytes **are** the artifact, so the result is always auto-ingested (described + embedded) — the next `baker images library` query finds it. Cost is tracked per request via OpenRouter's reported usage. Models and defaults mirror the Baker canvas.
+
+```bash
+baker images generate "a friendly golden retriever in a bright modern living room" --aspect-ratio 16:9
+baker images generate "hero shot of a matte black water bottle on wet marble, studio light" \
+  --model google/gemini-3-pro-image-preview --image-size 2K --aspect-ratio 4:5
+baker images generate "home office hero, warm minimalist, natural light, 35mm photo" \
+  --reference "https://i.pinimg.com/…/pin1.jpg,https://…/brand-product.png"
+baker images generate "put this product on a marble countertop in soft daylight" \
+  --reference "./src/brand/logos/product.png,./refs/kitchen-mood.jpg"   # local sandbox files
+baker images generate "flat geometric mascot, brand palette" \
+  --model recraft/recraft-v4.1-pro-vector --rgb-colors "[[10,10,10],[255,80,0]]" --bg-rgb "[255,255,255]"
+```
+
+**Models** (`--model`, default `openai/gpt-5.4-image-2`):
+
+| Model | Best for | Aspect ratios | Sizes |
+|---|---|---|---|
+| `openai/gpt-5.4-image-2` **(default)** | Photoreal + cleanest in-image text — ad/landing reproduction | standard set | `1K` `2K` `4K` |
+| `google/gemini-3-pro-image-preview` | Highest fidelity (Nano Banana Pro) | standard set | `1K` `2K` `4K` |
+| `google/gemini-3.5-flash` | Fast; extreme aspect ratios | standard **+** `1:4` `4:1` `1:8` `8:1` | `0.5K`–`4K` |
+| `google/gemini-3.1-flash-image-preview` | Same as 3.5 flash (preview) | extreme set | `0.5K`–`4K` |
+| `recraft/recraft-v4.1-pro-vector` | Vector/flat/SVG-style with palette control | standard set | `1K` `2K` `4K` |
+
+Standard aspect ratios: `1:1` `2:3` `3:2` `3:4` `4:3` `4:5` `5:4` `9:16` `16:9` `21:9`.
+
+**Flags:**
+
+| Flag | Description |
+|---|---|
+| `--model` | Model id (default `openai/gpt-5.4-image-2`) |
+| `--aspect-ratio` | Output aspect ratio (default `1:1`) |
+| `--image-size` | Resolution: `1K` (default) `2K` `4K` (Gemini flash also `0.5K`) |
+| `--reference` | Comma-separated visual references, each either a **public image URL** (Pinterest / stock / library `imageUrl`) **or a local file path** (a sandbox image — brand logo, product shot, cropped photo, screenshot). Local files are downscaled (≤1536px) and inlined automatically — no manual upload. Applied in order; the biggest quality lever for photographed, on-brand output. Split is on `,`, so a URL containing a literal comma in its query string would be torn in two (rare for image CDNs — pass it alone if it occurs); a single `data:` URL is taken whole. |
+| `--strength` | Recraft only: vectorization strength 0–1 |
+| `--rgb-colors` | Recraft only: JSON palette `[[r,g,b],…]` |
+| `--bg-rgb` | Recraft only: JSON background `[r,g,b]` |
+| `--context` | Describe-hint override for the ingested row (defaults to the prompt) |
+
+Returns `{ images: [{ imageId, imageUrl, deduped, width, height }], model, costUsd }`. `imageUrl` is library-owned and ready to place. Requires `OPENROUTER_API_KEY` on the Convex deployment. No `seed` (OpenRouter image_config has no seed slot). Identical re-generations dedup by content hash.
+
 ### `baker images logo <domain>`
 
 Brand logo via Brandfetch CDN (`fallback/404`). Probes all 5 logo variants in parallel and returns whichever ones the domain actually publishes. Auto-ingests the first by default.

package/dist/{chunk-K6LHXCKD.js → chunk-XFDZVKLF.js}

@@ -917,6 +917,13 @@ var FAL_IMAGE_MIMES = ["image/png", "image/jpeg", "image/webp"];
 var FAL_VIDEO_MIMES = ["video/mp4", "video/webm", "video/quicktime"];
 var DECONSTRUCT_VIDEO_MIMES = ["video/mp4", "video/webm", "video/quicktime"];
 var FAL_AUDIO_MIMES = ["audio/wav", "audio/mpeg", "audio/mp3"];
+var IMAGE_GENERATE_MODELS = [
+  "openai/gpt-5.4-image-2",
+  "google/gemini-3.5-flash",
+  "google/gemini-3.1-flash-image-preview",
+  "google/gemini-3-pro-image-preview",
+  "recraft/recraft-v4.1-pro-vector"
+];
 var MODEL_REGISTRY = {
   text_generate: {
     "~google/gemini-flash-latest": {
@@ -4813,7 +4820,7 @@ var dialogueNode = delegated({
 
 // src/engine/nodes/remote/image.ts
 import { z as z15 } from "zod";
-var IMAGE_GENERATE_MODELS = [
+var IMAGE_GENERATE_MODELS2 = [
   "openai/gpt-5.4-image-2",
   "google/gemini-3.5-flash",
   "google/gemini-3.1-flash-image-preview",
@@ -4821,7 +4828,7 @@ var IMAGE_GENERATE_MODELS = [
   "recraft/recraft-v4.1-pro-vector"
 ];
 var ImageGenerateParams = z15.object({
-  model: z15.enum(IMAGE_GENERATE_MODELS),
+  model: z15.enum(IMAGE_GENERATE_MODELS2),
   prompt: z15.string().min(1),
   aspect_ratio: z15.enum(["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9", "1:4", "4:1", "1:8", "8:1"]).optional(),
   image_size: z15.enum(["0.5K", "1K", "2K", "4K"]).optional(),
@@ -5648,6 +5655,7 @@ function createEngineFromEnv(opts = {}) {
 export {
   SEEDANCE_DURATIONS,
   ELEVENLABS_MAX_MUSIC_LENGTH_MS,
+  IMAGE_GENERATE_MODELS,
   MODEL_REGISTRY,
   BackendClient2 as BackendClient,
   Engine2 as Engine,
@@ -5659,4 +5667,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-K6LHXCKD.js.map
+//# sourceMappingURL=chunk-XFDZVKLF.js.map