NCBM b2d6acae26 docs: record the Files API shapes ...

Uploading a picture and referencing it by id is the one image path the API
offers that we do not use, and the vendor shapes do not line up: the upload is
the same multipart `POST …/files` with a `file` part everywhere, but the object
that comes back is `object`/`bytes`/unix time on OpenAI, `type`/`size_bytes`/
RFC 3339 on Anthropic, and DeepSeek serves both dialects under two base URLs;
the reference block differs a third time per surface, and OpenAI's chat
completions cannot name an image by id at all.

Recorded next to the inline-path limits, with the three constraints that decide
any future wiring: an id belongs to the provider that minted it (like
`provider_blocks`), the OpenAI path implies the Responses convention, and the
token bill is unchanged — uploading only buys the inline size cap, a smaller
request body, and not re-sending the same bytes every round. The Anthropic
per-file limit is marked unverified: its API reference is unreachable from this
host's region.

2026-10-21 21:44:03 +08:00

..

architecture.md

docs: describe deletes that go to the trash

2026-10-21 20:25:27 +08:00

development-principles.md

docs+ci: document ruff format --check; format app.py

2026-07-17 17:57:00 +08:00

images.md

docs: record the Files API shapes

2026-10-21 21:44:03 +08:00

notifications.md

docs: describe prompt notifications

2026-10-21 20:03:36 +08:00

plugins.md

docs: describe YOLO skipping YOLO-tagged confirms

2026-10-21 19:10:56 +08:00

plyngent.example.toml

docs: describe deletes that go to the trash

2026-10-21 20:25:27 +08:00

skills.md

core/skills: announce the skill tools in a notice, not a catalog

2026-10-09 21:40:45 +08:00

trash.md

docs: describe deletes that go to the trash

2026-10-21 20:25:27 +08:00

turns-and-rounds.md

docs: spell out the turn and round model

2026-10-17 17:37:22 +08:00