@fungi.computer/prints 0.3.0 → 0.5.0

package/README.md

@@ -24,9 +24,9 @@ Container.
 - **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.
-- Retry a failed attempt from its tile or from **Activity**. A retry resumes the
-  same attempt instead of generating again, and **Resume** picks up an
-  unfinished image after a reload.
+- 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.
 
 <img alt="Prints on a phone in the light theme: a two-column gallery above the prompt bar" src="docs/media/gallery-phone.png" width="300">
 
@@ -77,20 +77,43 @@ Agents call Prints through Oyster's MCP endpoint, or at
 `POST $OYSTER_URL/apps/prints/methods/<name>` with a key; see
 [Git, keys and MCP](https://github.com/fungi-computer/oyster#git-keys-and-mcp).
 
-| Method          | What it does                                                                                                                                 |
-| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| `listModels`    | Lists the image and video models, with their sizes, settings and how many references each takes.                                             |
-| `generateImage` | Generates one image from a prompt and saves it to the gallery folder. Optional `characters` names saved characters to keep consistent.       |
-| `generateVideo` | Generates one video. While it works, the method returns `{kind: "pending", retryAfterMs}`; call again with the same inputs after that delay. |
-| `listOutputs`   | Lists the prints this App made, newest first.                                                                                                |
-| `getOutput`     | Reads one print by file path: its prompt, model, characters and the reference images it used.                                                |
-| `openOutput`    | Reads up to 128 KiB of one print per call.                                                                                                   |
+| Method           | What it does                                                                                                                                 |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `listModels`     | Lists the image and video models, with their sizes, settings and how many references each takes.                                             |
+| `generateImage`  | Generates one image from a prompt and saves it to the gallery folder. Optional `characters` names saved characters to keep consistent.       |
+| `generateVideo`  | Generates one video. While it works, the method returns `{kind: "pending", retryAfterMs}`; call again with the same inputs after that delay. |
+| `listCharacters` | Lists the saved characters: name, description and reference image paths. Use the names as `characters` or `@name`.                           |
+| `listStyles`     | Lists the saved and built-in styles: name and text. Use a name as `style`.                                                                   |
+| `listOutputs`    | Lists the prints this App made, newest first.                                                                                                |
+| `getOutput`      | Reads one print by file path: its prompt, model, characters, style and the reference images it used.                                         |
+| `openOutput`     | Reads up to 128 KiB of one print per call.                                                                                                   |
 
 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
 
@@ -106,12 +129,13 @@ pnpm typecheck
 pnpm test
 ```
 
-[src/MediaPane.tsx](src/MediaPane.tsx) puts the composer, gallery and Activity
-together. [src/media-generation.ts](src/media-generation.ts) owns attempts and
-retries, [src/media-gallery.ts](src/media-gallery.ts) the gallery and uploads,
-and [backend/prints-index.ts](backend/prints-index.ts) records each finished
-print. The agent tools are in [backend/methods.ts](backend/methods.ts), and
-[package.json](package.json) declares the permissions the App asks for.
+[src/MediaPane.tsx](src/MediaPane.tsx) puts the composer, gallery and the
+Activity status key together. [src/media-generation.ts](src/media-generation.ts)
+owns attempts and retries, [src/media-gallery.ts](src/media-gallery.ts) the
+gallery and uploads, and [backend/prints-index.ts](backend/prints-index.ts)
+records each finished print. The agent tools are in
+[backend/methods.ts](backend/methods.ts), and [package.json](package.json)
+declares the permissions the App asks for.
 
 ## License