pi-session-manager-plugin

pi-session-manager-plugin is an npm-distributed PSM plugin suite. One package can expose multiple independent PSM child plugins through package.json#psm.extensions.

Included child plugins

psm-pi-context

psm-pi-context makes Pi's pi-context history easier to inspect in Pi Session Manager.

• Adds specialized renderers for context_checkpoint, context_timeline, and context_compact tool calls.
• Adds a session Context panel listing checkpoints, compactions, and branch summaries.
• Reveals the original session entry or tool call through the public PSM Viewer Controller.
• Reads session JSONL through the public sessions:read capability only.

The plugin is read-only. It cannot trigger /acm, compact a live Pi session, or modify source files.

Local development

npm install
npm run test
npm run typecheck
npm run build

Add this directory through Settings -> PSM Plugins -> Dev Preview. PSM runs npm run build and loads every entry declared in package.json#psm.extensions.

The published bundle has no runtime npm dependency on the SDK: SDK imports are type-only and are removed during the browser build. The local development dependency points at the sibling pi-session-manager/packages/runtime-sdk package for type checking.

npm installation

After publishing:

npm install --prefix ~/.pi/pi-session-manager/extensions/npm pi-session-manager-plugin

PSM Marketplace discovers packages that declare psm.extensions.

Adding a child plugin

1. Add a browser-compatible entry under plugins/<plugin-name>/.
2. Give its manifest and contribution IDs a unique dwsy.psm-* namespace.
3. Emit a separate dist/<plugin-name>/index.mjs bundle.
4. Add that bundle path to package.json#psm.extensions.
5. Add parsing and activation tests before publishing.

A package update installs all child plugins together. PSM enables, configures, and authorizes each child plugin by its individual manifest ID.