@fungi.computer/prints 0.4.0 → 0.6.0

package/README.md

@@ -18,12 +18,28 @@ Container.
   otherwise, MP4 for video.
 - Add your own images as style references, on models that accept them.
 - Upload files into the same folder, or choose another folder for the gallery.
-- Browse the gallery newest first, open a picture in
-  [Inkcap](https://github.com/fungi-computer/inkcap), or open its **Image info**
-  panel (press **I**).
-- **Download** an image from Image info. The download drops the prompt and
-  lineage and keeps the AI marker and the print's id; the file on the Computer
-  stays as it is.
+- Browse the gallery newest first. Click a picture to see it fitted inside
+  Prints; **Left** and **Right** step through the loaded wall, and **Esc**
+  returns to the last-viewed tile. **Open in Inkcap** is an explicit editing
+  action for files on a Computer.
+- Open a video to play with sound and native playback controls; stepping away
+  stops it. If the browser refuses autoplay, press Play. Video-focused arrow
+  keys seek rather than changing prints. Hub and Oyster permit App-window
+  fullscreen.
+- Step into a loading file or a pending generation without leaving the viewer.
+  Video jobs show their live elapsed time; a video that finishes while you are
+  watching its placeholder stays paused. A fresh visit to the ready video plays
+  it. Retry a failed file read/preview or retry and dismiss a failed job in
+  place. Changing the folder, Computer or connection closes the viewer.
+- Open **Image info** in the viewer or from a focused gallery tile (press
+  **I**).
+- Toggle **Actual size** to see an image at its natural pixel dimensions. Scroll
+  the image with the browser's native scrolling; focused scroll-viewport arrows
+  pan instead of stepping prints. Toggle it off to fit again. Stepping to
+  another print or reopening the viewer starts fitted.
+- **Download** an image from the viewer or Image info. The download drops the
+  prompt and lineage and keeps the AI marker and the print's id; the file on the
+  Computer stays as it is.
 - Retry a failed attempt from its tile or from **Activity**, the key in the
   window's status bar. A retry resumes the same attempt instead of generating
   again, and **Resume** picks up an unfinished image after a reload.
@@ -90,9 +106,30 @@ Agents call Prints through Oyster's MCP endpoint, or at
 
 Each generation carries a request id (`media_request_` and 21 lowercase letters
 or digits). Retrying with the same id and inputs recovers the same generation
-instead of paying for another. References are paths on the Computer, such as
-`[{ path: "/canon/style.png" }]`; callers never pass image bytes, URLs or a
-Computer id.
+instead of paying for another. References are file paths, such as
+`[{ path: "/canon/style.png" }]`. In a host with Agent Computer attachments,
+`{ computerId: "computer-b", path: "/canon/style.png" }` reads from any attached
+Computer using that Computer's own read authorization. Omit `computerId` for the
+selected Computer; the output still saves there. Revoked or denied reads stop
+generation before provider dispatch. Callers never pass image bytes or URLs.
+Reference reads are not confined to the App's library folder: the Computer grant
+is the boundary.
+
+`listModels` includes a labelled `priceEstimate` for its stated default settings
+(including the example prompt and no references). `basis: "team-price"` includes
+the host's current Team markup; `"provider-cost"` is an unmarked provider
+estimate. The image result's `costMilliunits` and human-readable `receipt` use
+Media's admitted charge, not the catalogue hint. The receipt states that charge
+plainly; only `priceEstimate` is an estimate. Changing dimensions, steps, prompt
+or references can change the charge.
+
+Set optional `settings.steps` only for models whose `input.steps` is not
+`"fixed"`; obey `input.maxSteps` where present. Omission uses the model default.
+Refusals retain Media's bounded provider diagnostic. The typed
+`provider.reason === "credits_exhausted"` means Cloudflare AI Gateway couldn't
+fund the request, not a Team credit refusal. Check the account's credits and
+billing in the Cloudflare dashboard under AI Gateway or choose a Workers AI
+model; do not retry a `retryable: false` result.
 
 ## Build and check