feat(providers/{image,video}): real Topview adapter via MCP (UGC / talking-head / URL-to-video)

[wesleysimplicio]

Context

TopviewProvider at lib/providers/image.ts:48-50 and TopviewVideoProvider at lib/providers/video.ts:40-42 are mocks. Per ROUTING-MATRIX.md, Topview owns UGC ads, avatar holding product, talking-head, product demos from URL, face-swap/try-on.

Goal

Real adapter against the Topview MCP server (@topview/mcp-server per SETUP.md).

Acceptance criteria

• Adapter reads TOPVIEW_API_KEY; if missing, throw clearly
• Three modes: avatar+script (topview_avatar_generate), URL-to-video (topview_url_to_video), face-swap (topview_face_swap)
• Mode picked from task + presence of from_url field
• Validates avatar/voice catalog before submitting (per topview-prompt-builder SKILL § Failure modes)
• Polls for completion + downloads result to outputs dir
• Real cost_usd
• Retry + timeout via shared policy
• Skipped when DRY_RUN=true
• E2E spec with mocked MCP transport

Files

• lib/providers/image.ts:48-50
• lib/providers/video.ts:40-42
• .skills/topview-prompt-builder/SKILL.md (reference)

[wesleysimplicio]

Closed after PR #40 follow-up stabilization in commit f40b58d. Current main passes npm run typecheck and npm run test:e2e (119 Playwright specs green), and this tracker item is being retired per repository cleanup.