Generate a proposal diagram image using the Paper Banana pipeline.

Provide either source_file (recommended) or source_context — not both. To resume a previous run, set resume_from to the path of the run-state directory (e.g. output_run/) created during the original run.

Args: caption: The caption or communicative intent for the image (required). source_file: Path to the proposal document (markdown or text). The Extractor agent will read this file and pull the relevant section automatically. Recommended over source_context for full documents. section: Section hint for the Extractor — number, name, or both (e.g. '1.1', 'Development Services', '1.1 Development Services'). Only used when source_file is provided. source_context: Raw proposal section text. Use this only when passing a pre-extracted section directly (not a full document). image_type: Diagram type — 'process', 'conops', or 'auto' (auto-detected). iterations: Number of Visualizer ↔ Critic refinement rounds (1-5). Default 3. output_path: File path where the generated PNG will be saved. Default 'output.png'. save_artifacts: If True, save per-iteration PNG and critique JSON to {output_stem}_artifacts/ alongside the final image. Default True. export_schema: If True (and save_artifacts is also True), extract a structured diagram schema (elements, connectors, layout) from each iteration's image and merge it into the critique JSON as 'diagram_schema'. Default True. brand: Named brand profile to apply — 'mlst' (purple/blue) or 'default' (government/defense palette). Default 'mlst'. resume_from: Path to a run-state directory ({output_stem}_run/) created by a previous run. When set, the extractor/optimizer/classifier/ retriever/planner/stylist stages are skipped and the pipeline jumps directly to the Visualizer ↔ Critic refinement loop using the saved description, caption, and image type. Leave empty for a fresh run. user_feedback: Free-text feedback about the previous run's output. Injected as a prefix into the critic's system prompt so all refinement iterations take the feedback into account. Only meaningful when resume_from is also set (but can be used on fresh runs too). aspect_ratio: Desired output aspect ratio — '16:9', '4:3', '1:1', or '3:4'. Leave empty (default) to let the Planner recommend a ratio based on the diagram content. When provided, this hard-overrides the Planner's recommendation.

Returns: Absolute path to the saved PNG image.

Add a reference image to the example library.

Args: description: Written description of what the image shows. image_path: Absolute or relative path to the image file. caption: The caption associated with this image. image_type: Diagram type — 'process' or 'conops'. source_context: Optional full methodology text to enrich retrieval scoring.

Returns: The unique ID assigned to the new example.

Return the current installed version of Paper Banana, with an update notice if behind.

Returns: Version string, e.g. '0.1.0' or '0.1.0 (3 commit(s) behind origin/main — run git pull)'.