Open a local folder as the photo library and scan it for images.

List images in the library with optional filters.

rating_gte: only images rated >= this (0-5). flag: 'pick', 'reject', or
'none' for unflagged. Returns metadata including each image's id, which
all other tools take.

The image the user currently has selected/open in the Viberoom web UI (or image_id: null if nothing is selected). Use this when the user says 'this image' / 'my current image'.

Full metadata for one image: path, EXIF, rating, flag, edit status.

Set the star rating, 0 (unrated) to 5.

Flag an image as 'pick' or 'reject', or None to unflag.

Get the image's current non-destructive edit recipe (JSON).

Merge a partial recipe into the image's edit recipe (the usual way to edit). Only supply the fields you want to change; everything else keeps its value. Ranges (Lightroom-style):

- whiteBalance: {temp: 2000-50000 Kelvin (null=as-shot), tint: -150..150 (+magenta)}
- tone: {exposure: -5..5 EV, contrast/highlights/shadows/whites/blacks: -100..100,
         toneCurve: {points: [[in,out],...] 0-255 increasing}}
- color: {saturation/vibrance: -100..100,
          hsl: {red|orange|yellow|green|aqua|blue|purple|magenta:
                {hue/saturation/luminance: -100..100}}}
- detail: {sharpening: {amount: 0-150, radius: 0.5-3, detail: 0-100},
           noiseReduction: {luminance: 0-100, color: 0-100}}
- geometry: {rotate: -45..45 deg, orientation: 0|90|180|270, flipH/flipV: bool,
             crop: {left,top,right,bottom: 0-1 normalized}}

Example: {"tone": {"exposure": 0.5}, "whiteBalance": {"temp": 6500}}
Use get_recipe_schema for the full JSON Schema.

Replace the entire edit recipe. Omitted fields reset to defaults.

Computational auto-adjust: analyzes the image (exposure targeting, percentile tone recovery, gray-world WB) and sets whiteBalance/tone/ vibrance. Keeps existing detail and geometry settings. Returns the new recipe — render_preview afterwards to judge the result.

Remove all edits, restoring the image to its unedited state.

Render the image WITH its current edits applied and return the JPEG so you can visually inspect the result. size = longest edge in px (256-4096).

Export the edited image as an sRGB JPEG. quality 1-100; max_dimension resizes the longest edge; path overrides the default /exports/ destination. Returns the written file path.

The full JSON Schema for edit recipes (all parameters and ranges).