docs(05-02): complete provider image integration plan

Tasks completed: 3/3
- Update generateWithReplicate to pass image input
- Update generateWithFal to pass image_url parameter
- Upload images to URL server with cleanup

Phase 5 complete. Ready for Phase 6: Video & Polish.

SUMMARY: .planning/phases/05-image-url-server/05-02-SUMMARY.md

.planning/ROADMAP.md

@@ -18,7 +18,7 @@ None
 - [x] **Phase 2: Model Discovery** - Dynamic model fetching from Replicate/fal.ai APIs ✓
 - [x] **Phase 3: Generate Node Refactor** - Rename NanoBanana to generic Generate with multi-model support ✓
 - [x] **Phase 4: Model Search Dialog** - Floating action bar icons and searchable model browser ✓
-- [ ] **Phase 5: Image URL Server** - Local endpoint serving images as URLs for providers
+- [x] **Phase 5: Image URL Server** - Local endpoint serving images as URLs for providers ✓
 - [ ] **Phase 6: Video & Polish** - Video playback, parameter customization, edge cases
 
 ## Phase Details
@@ -74,7 +74,7 @@ Plans:
 
 Plans:
 - [x] 05-01: Image serving endpoint and URL generation
-- [ ] 05-02: Integration with generate node for URL-based providers
+- [x] 05-02: Integration with generate node for URL-based providers
 
 ### Phase 6: Video & Polish
 **Goal**: GenerateVideo node for video generation, video playback, custom parameters, edge cases
@@ -100,5 +100,5 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6
 | 2. Model Discovery | 3/3 | Complete | 2026-01-09 |
 | 3. Generate Node Refactor | 3/3 | Complete | 2026-01-09 |
 | 4. Model Search Dialog | 2/2 | Complete | 2026-01-09 |
-| 5. Image URL Server | 1/2 | In progress | - |
+| 5. Image URL Server | 2/2 | Complete | 2026-01-09 |
 | 6. Video & Polish | 0/4 | Not started | - |

.planning/STATE.md

@@ -10,18 +10,18 @@ See: .planning/PROJECT.md (updated 2026-01-09)
 ## Current Position
 
 Phase: 5 of 6 (Image URL Server)
-Plan: 1 of 2 in current phase
+Plan: 2 of 2 in current phase
-Status: In progress
+Status: Phase complete
-Last activity: 2026-01-09 - Completed 05-01-PLAN.md (Image serving endpoint)
+Last activity: 2026-01-09 - Completed 05-02-PLAN.md (Provider image integration)
 
-Progress: [=====================================================================] 73% (11/15 plans)
+Progress: [========================================================================] 80% (12/15 plans)
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 11
+- Total plans completed: 12
-- Average duration: 5.4 min
+- Average duration: 5.1 min
-- Total execution time: 0.98 hours
+- Total execution time: 1.01 hours
 
 **By Phase:**
 
@@ -31,11 +31,11 @@ Progress: [=====================================================================
 | 2. Model Discovery | 3/3 | 14 min | 4.7 min |
 | 3. Generate Node Refactor | 3/3 | 13 min | 4.3 min |
 | 4. Model Search Dialog | 2/2 | 17 min | 8.5 min |
-| 5. Image URL Server | 1/2 | 3 min | 3 min |
+| 5. Image URL Server | 2/2 | 5 min | 2.5 min |
 
 **Recent Trend:**
-- Last 5 plans: 3 min, 2 min, 15 min, 3 min
+- Last 5 plans: 3 min, 2 min, 15 min, 3 min, 2 min
-- Trend: fast (05-01 was infrastructure only)
+- Trend: fast (05-02 was integration only)
 
 ## Accumulated Context
 
@@ -82,6 +82,6 @@ Recent decisions affecting current work:
 ## Session Continuity
 
 Last session: 2026-01-09
-Stopped at: Completed 05-01-PLAN.md (Image serving endpoint)
+Stopped at: Completed 05-02-PLAN.md (Provider image integration)
 Resume file: None
-Next action: Execute 05-02-PLAN.md (Integration with generate node)
+Next action: Plan Phase 6 (Video & Polish)

.planning/phases/05-image-url-server/05-02-SUMMARY.md

@@ -0,0 +1,102 @@
+---
+phase: 05-image-url-server
+plan: 02
+subsystem: api
+tags: [replicate, fal.ai, img2img, image-url, cleanup]
+
+# Dependency graph
+requires:
+  - phase: 05-01
+    provides: Image store, uploadImageForUrl, shouldUseImageUrl, deleteImages utilities
+  - phase: 03-02
+    provides: generateWithReplicate, generateWithFal provider dispatch
+provides:
+  - img2img workflow support for Replicate and fal.ai
+  - Automatic large image → URL conversion
+  - Cleanup of temporary images after provider calls
+affects: [phase-06]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - try/finally cleanup pattern for uploaded images
+
+key-files:
+  created: []
+  modified:
+    - src/app/api/generate/route.ts
+
+key-decisions:
+  - "Use 'image' param for Replicate (most common for img2img models)"
+  - "Use 'image_url' param for fal.ai (consistent across models)"
+  - "Small images (<256KB) pass as data URIs directly"
+  - "Gemini path unchanged (handles base64 natively)"
+
+patterns-established:
+  - "Provider image upload: process → call → cleanup in finally block"
+
+issues-created: []
+
+# Metrics
+duration: 2min
+completed: 2026-01-09
+---
+
+# Phase 5 Plan 2: Provider Image Integration Summary
+
+**img2img support for Replicate and fal.ai via automatic image URL conversion with cleanup**
+
+## Performance
+
+- **Duration:** 2 min
+- **Started:** 2026-01-09T09:51:03Z
+- **Completed:** 2026-01-09T09:53:44Z
+- **Tasks:** 3
+- **Files modified:** 1
+
+## Accomplishments
+
+- Replicate predictions receive image input via `image` parameter
+- fal.ai requests receive image input via `image_url` parameter
+- Large images (>256KB) automatically converted to temporary URLs
+- Uploaded images cleaned up immediately after provider call completes
+- Small images pass efficiently as data URIs
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Update generateWithReplicate to pass image input** - `4477f6f` (feat)
+2. **Task 2: Update generateWithFal to pass image_url parameter** - `6324af3` (feat)
+3. **Task 3: Upload images to URL server with cleanup** - `2195a6e` (feat)
+
+**Plan metadata:** (pending)
+
+## Files Created/Modified
+
+- `src/app/api/generate/route.ts` - Added image parameter passing and URL conversion logic
+
+## Decisions Made
+
+- Use `image` parameter for Replicate (most common for img2img models, future enhancement could detect from model schema)
+- Use `image_url` parameter for fal.ai (consistent across all fal.ai models)
+- Small images use data URIs directly for efficiency
+- Gemini path unchanged (it handles base64 directly without URL conversion)
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None
+
+## Next Phase Readiness
+
+- Phase 5 complete: Image URL server infrastructure fully integrated
+- Ready for Phase 6: Video & Polish
+
+---
+*Phase: 05-image-url-server*
+*Completed: 2026-01-09*