pi-mono/packages/durable/docs
Mario Zechner 42a3497d03 feat(durable): read returns images, optional Photon image processor
read returns an image file as one image block (programs get an ImageContent) plus an info diagnostic,
instead of an unsupported_image error. Limits are the conversation model's inputLimits.images.resize,
by default 2000x2000 pixels and 4.5 MB of base64.

- Without a processor: PNG, JPEG, GIF, and WebP within the limits pass through undecoded; the byte limit
  is checked before reading the file, dimensions from the header. Larger images and BMP are error results.
- With createCodingTools({ images }): the processor orients by EXIF, converts BMP to PNG, and shrinks to
  fit. ImageProcessor.prepare is async.
- @earendil-works/pi-durable/images: createPhotonImages(wasm) on @silvia-odwyer/photon 0.3.3 (web build);
  /images/node and /images/cloudflare load the wasm. The root and ./tools entries never reach it (enforced
  in check-entry-graphs).
- An image must be read whole: one that changes while read is read again, unlike a growing text file.
- A model without image input gets a diagnostic that it sees a placeholder.
2026-10-09 19:38:02 +00:00
..
chord-delta-findings.md feat(chord): make immutable delta tracker canonical 2026-09-24 15:07:12 +02:00
pico-v5-chord-usage.md fix(durable): publish README and changelog, link the spec, add default export condition 2026-10-01 20:23:30 +02:00
pico-v5-handoff.md fix(durable): publish README and changelog, link the spec, add default export condition 2026-10-01 20:23:30 +02:00
spec.md feat(durable): read returns images, optional Photon image processor 2026-10-09 19:38:02 +00:00