avtc-pi-prune-images

Payload-level rolling image eviction for pi.

Providers may cap images per prompt (for example vLLM's --limit-mm-per-prompt '{"audio": 0, "image": 8, "video": 0}'). pi keeps every image in session history — pasted images and images returned by read — and re-sends the full history on every LLM call, so one image over the cap bricks the session with 400: At most X image(s) may be provided in one prompt.

This extension listens to the context event (fires before each LLM call) and replaces every image part older than the N most recent with a text placeholder. Only the outgoing payload is pruned: the session file keeps every image for /tree, /export, and compaction.

Settings

~/.pi/agent/settings.json (project .pi/settings.json overrides):

{
	"avtc-pi-prune-images": {
		"keep-last-images": 8
	}
}

• keep-last-images: non-negative integer, or null for unlimited. Default null — the extension is inert until you opt into eviction. 0 strips all images from the payload (payload-only equivalent of pi's images.blockImages).

Invalid values warn once and leave messages unmodified.

Notes

• The setting is re-read before every LLM call, so edits apply live.
• /tree to a point before an image-heavy read remains the surgical fix when you want the images gone from history entirely.