litevision 0.2.0 → 0.3.0

package/README.md

@@ -36,7 +36,7 @@ Add `-g` to install it for your user instead of the current project, and `-a` to
 
 ## Set up
 
-Ask your Agent to generate an image. While nothing is configured, it calls `open_settings`, which opens the settings page in your browser. You can also open it yourself, from your Agent's prompt menu (in Claude Code, the `/mcp__litevision__settings` command) or from a terminal:
+Ask your Agent to generate an image. While nothing is configured, it calls `open_settings`, which opens the settings page in your browser. You can also ask your Agent to open litevision's settings, or open the page yourself from a terminal:
 
 ```bash
 npx -y litevision settings
@@ -56,6 +56,7 @@ The page listens on `127.0.0.1` only, behind a one-time token, and shuts down af
    | `together` | Together AI, images and videos. Models Together passes through to their makers (FLUX, Google, Qwen, …) work only once you turn on "Passthrough models" in Together's organization settings, which sends your prompts for them to those makers. |
 
 3. **Pick a default image Model** (and a default video Model) and, optionally, write Model Notes ("photoreal, cheap, bad at Chinese text") so the Agent knows when to choose each one.
+4. **Optionally, set Standing Options** on a Model: a JSON object of the Provider's own request fields, such as `{ "quality": "high" }`, that every Job on it sends. The Agent's `provider_options` override them for one Job.
 
 The page also shows the Job history, with the images and videos and any Ratings you gave, and lets you rate a Job or one of its results.
 
@@ -63,11 +64,11 @@ The page also shows the Job history, with the images and videos and any Ratings
 
 | Tool | What it does |
 | --- | --- |
-| `generate_image` | Generates images from a prompt, optionally with reference images, an aspect ratio and Provider-specific `provider_options`. Saves them and returns the file paths, with the size each image actually came out at. |
-| `generate_video` | Generates a video from a prompt, optionally with a first and last frame, reference images, an aspect ratio, a duration and a resolution. Saves it and returns the file path, with its actual size and length. |
-| `generate_comparison` | Starts 2 to 4 Jobs of one Modality together, differing in prompt, Model or both, so you can choose among the results. The Agent starts one only when you ask for it or agree to it. |
+| `generate_image` | Generates `n` images from a prompt, optionally with reference images. Size, quality and every other setting are the Model's own fields in `provider_options`, passed to the Provider as they are; without them the Provider's defaults apply. Saves the images and returns the file paths, with the size the request asked for and the size each image actually came out at. |
+| `generate_video` | Generates a video from a prompt, optionally with a first and last frame and reference images. Shape, resolution and length are the Model's own fields in `provider_options`. Saves it and returns the file path, with what the request asked for and the video's actual size and length. |
+| `generate_comparison` | Starts 2 to 4 Jobs of one Modality together, differing in prompt, Model or both, each with its own `provider_options`, so you can choose among the results. The Agent starts one only when you ask for it or agree to it. |
 | `get_job` | Waits for, or reports on, a Job that was still running when `generate_image`, `generate_video` or `generate_comparison` returned. |
-| `list_models` | Lists the configured Models with their Modality, capabilities, Model Notes, docs link and Known-good Options (the `provider_options` that worked); for one Model, also their values, options made suspect by a bad Rating or a result that did not match, its five most recent Ratings, the Picks of up to five Comparisons it took part in (most recently picked first), and the Provider's parameter schema. |
+| `list_models` | Lists the configured Models with their Modality, Model Notes, Standing Options, a summary of their Parameter Guide, docs link and Known-good Options (the `provider_options` that worked); for one Model, also its full Parameter Guide (each parameter's values, default and price effect, with sources and the date they were checked) or the Provider's own parameter schema where it publishes one, the options' values, options made suspect by a bad Rating or a result that did not match, its five most recent Ratings, and the Picks of up to five Comparisons it took part in (most recently picked first). |
 | `pick_result` | Records your Pick when you choose among a Comparison's results; choosing again replaces it. A Pick says which you prefer, not that it is good, so it does not change Known-good Options. You can also pick in the settings page's Job history, which shows a Comparison's Jobs together. |
 | `rate_job` | Records your verdict on a Job or on one of its results (good or bad, plus a reason) when you state one. A bad Rating of the whole Job, or of its only result, makes the options that Job used suspect until a good one uses them again. |
 | `update_model_notes` | Replaces a Model's Notes, only with text you agreed to. You can undo it in the settings page. |
@@ -78,7 +79,7 @@ The page also shows the Job history, with the images and videos and any Ratings
 | What | Where |
 | --- | --- |
 | Providers, Models (`config.json`) and Credentials (`credentials.json`, mode 600) | `~/.config/litevision/` |
-| Job history (`jobs.jsonl`) and cached Model capabilities | `~/.local/share/litevision/` |
+| Job history (`jobs.jsonl`) and the cached parameter descriptions Providers give (`capabilities.json`) | `~/.local/share/litevision/` |
 | Generated images and videos, unless the Agent passes `output_path` | `~/litevision/outputs/<date>/` |
 
 ## Develop