Report whether Google Flow is reachable and safe to spend credits in: browser attached, signed in, credit balance, active project, and — critically — whether Flow's 'Confirm before generating' gate is on. Call this first in any Flow session. Never charges.

Record which tRPC endpoints Flow's own frontend calls while the app is exercised, and write a reusable API map. Observation only — it submits nothing and charges nothing. Run this after any Flow redeploy, or when another tool reports a 404 on a procedure. Only endpoint shapes are stored; no prompts, media, or tokens.

Test whether discovered read-only GET endpoints work from Node with the browser's cookies alone, so later calls can skip the page entirely (faster, parallelisable). Mutations are never tested, because replaying one could generate and charge.

Return the tRPC endpoints previously learned by flow_discover_api, with their input/output key shapes and transport tier.

Generate still images in Flow. Stills cost ZERO credits, so this is the sandbox where composition should be iterated until right — always compose in stills before spending anything on video. Downloads the results and returns local file paths.

Submit a request to Flow, read the quoted credit cost from its proposal, then REJECT it. Costs exactly zero — a rejected proposal is never charged. Use this to confirm the project's model tier before committing to a batch.

Generate a video clip in Flow. THIS SPENDS REAL CREDITS. The cost quoted by Flow is read and checked against expected_max_cost and the run budget BEFORE approval; if it exceeds either, the proposal is rejected and nothing is charged. The generation MODE is set by what you attach: start_frame_media_id gives Frames-to-Video (preserves the approved composition — the normal path), reference_media_ids gives Ingredients-to-Video (recomposes from up to 3 references), and attaching nothing gives Text-to-Video (least control). Compose in free stills first and animate an approved still rather than generating blind. Never call this twice for the same clip while one is in flight — a resubmit is a second charge. Model tier and aspect ratio are per-project settings; set them with flow_settings, not here.

Wait for media that is not in the supplied known_media_ids list to appear in the project library, then download it. Use after submitting a parallel batch with flow_generate_video(no_wait=true). Charges nothing — the credits were already committed at approval.

List media in the currently open Flow project, with ids usable by flow_download and flow_delete_media. Never charges.

Resolve a Flow media id to its signed CDN url and write the bytes to disk, verifying the file is genuinely image or video data. Use this rather than Flow's Download button, which frequently writes nothing in an automated profile. Never charges.

Permanently remove media from the Flow project library. Deletion cannot be undone and a deleted clip cannot be reliably re-added to a scene, so only delete what has been explicitly ruled out.

Export the currently open Scenebuilder scene to an MP4 on disk. Stitching clips is FREE — only Scenebuilder's 'Extend' costs credits, and this tool never uses it. Captures the export job's video payload directly, since Flow's export never writes a file itself.

Read the run's credit ceiling and spend, or change them. The ceiling is enforced before every approval: a generation that would exceed it is rejected and never charged. Raise it only on explicit instruction from whoever owns the account.

Return the append-only log of every generation this server attempted: prompt, quoted cost, actual charge, verdict, and files. The audit trail for credit spend.

Read or change Flow's per-PROJECT generation settings: model tier, aspect ratio, and outputs per prompt. These are project globals, not per-generation arguments — set once, they persist across chat turns. Changing the tier is free and is the highest-leverage cost control there is: moving a project from Veo Quality to Fast turns every subsequent clip from 100 credits into 20. Re-read this after switching projects.

Upload a local image file into the Flow project so it can be used as a start frame or reference. Free. After upload, confirm the resulting media id with flow_list_media before animating it.

Upscale a generated clip. 1080p is FREE on paid plans and should always be taken at download. 4K costs 50 credits, is Ultra-plan only, and is rarely worth it for social content. NOTE: Flow does not show an approval card for upscales, so a 4K upscale bypasses the quote gate — it is charged directly and verified against the balance afterwards.

List Flow projects visible on the current page, with their ids. Free. Settings and media libraries are per-project, so knowing the id matters.

Switch the browser to a Flow project by id. Free. Settings are per-project, so re-read flow_settings after switching rather than assuming the model tier carried over.

Create a new Flow project. Free. Worth doing per batch: Flow's chat anchors hard on people and settings from earlier images in the same project chat, and a fresh project is the cleanest way to break that carry-over.

Create a new Scenebuilder scene for stitching clips. FREE. Flow's chat agent cannot do this — it is a UI-only surface.

Add library clips, in order, to the currently open Scenebuilder scene. FREE — stitching costs nothing. This never touches Scenebuilder's 'Extend', which does cost 40 credits.

List the mini-apps in the current project's Tools gallery (Type Overlays, Transition Machine, Stringout Creator, Video Resizer, Shader Effects, Image Editor, Mask Magic, Storyboard Studio, and any custom tools). Listing is free. WARNING: the gallery quotes no prices and some apps call Veo internally, so running one can charge an unquoted amount.

Open one of Flow's Tools-gallery apps and hand control back to a human. Requires acknowledge_unknown_cost=true because the gallery quotes no prices and some apps call Veo internally. This deliberately does NOT drive the app's own form — each app has a bespoke UI, and blind-clicking through an unknown form that may call Veo is how an unbounded charge happens. Credit balance is measured before and after.