@pi-harness/plugin-annotation

Annotations — Capture bounded selections and notes from the conversation for later agent context.

annotation_manage supports add/list/remove/clear/prompt. List returns model-visible JSON with complete quotes and notes, IDs, count, returned and nextOffset. It defaults to 10 entries and never exceeds 64 KiB of UTF-8 JSON; follow nextOffset using offset to read the rest. Optional limit is 1–50. Existing details retain the full collection for rendering; quotes/notes are not silently shortened to fit a page.

The collection is in-memory and scoped to the active runtime session object and session ID (up to 50 annotations). Switching or closing sessions clears the collection and its recently generated context; delayed operations from the previous session are rejected. prompt generates a snapshot without changing original conversation messages. Cancelled and disposed tool invocations cannot mutate the collection.

Install

npm install --save-exact @pi-harness/plugin-annotation

Enable

Add the entry to the Cordis profile the harness starts from:

- id: annotation
  name: "@pi-harness/plugin-annotation"
  config: {}

The Pi Harness plugin marketplace installs and enables this package for you; the steps above are the manual equivalent.