pi-extensions-tool-display

Pi tool display host and shared result-rendering protocol for extensions

Packages

Package details

extensionskill

Install pi-extensions-tool-display from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-extensions-tool-display
Package
pi-extensions-tool-display
Version
1.3.1
Published
Sep 19, 2026
Downloads
1,142/mo · 615/wk
Author
maplezzk
License
MIT
Types
extension, skill
Size
326.4 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "skills": [
    "./SKILL.md"
  ],
  "extensions": [
    "./index.ts",
    "../pi-extensions-i18n/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-extensions-tool-display

pi-extensions-tool-display provides the Pi tool-display host plus the shared tool-result rendering protocol and component helpers used by Pi extensions.

It provides:

  • registration, disposal, and activity checks for result-render middleware;
  • a pending registration queue for when the Pi display host loads later;
  • safe component detection and a helper for appending an audit panel to the original tool result.

A result-render middleware registered for "*" really does run for every extension-registered tool: the host wires the middleware chain into any tool it does not already own, keeping the tool's own renderResult (or Pi's plain text preview when it has none) as the base. isResultRenderPipelineActive therefore reports true for those tools as well, so a consumer never needs to fall back to a separate transcript entry. Pi's own built-in tools stay behind the registerToolOverrides switches.

It is also a standalone Pi extension. Install or include this package in Pi's package list to load the actual tool-display host. Feature package manifests include this dependency's extension entry, so installing either feature package loads one shared host without requiring a second host package.

Boundary

This package owns the display protocol and generic component composition only. Each feature extension continues to own its domain-specific audit extraction, copy, status, and layout.

Built-in overrides only replace tools that Pi has already activated; registerToolOverrides does not enable inactive built-in tools.

Upstream attribution

The display integration is designed to work with the MIT-licensed MasuRii/pi-tool-display, the original full-featured Pi tool-display project. We thank MasuRii for that work.

The host implementation is based on the MIT-licensed upstream project and is now maintained in this package so consumers do not need a second separately installed host package.

Install

Install this package directly when you want only the tool-display host:

pi install npm:pi-extensions-tool-display

pi-distill and pi-tool-supervisor declare this host entry in their package manifests when they are installed.

Development

npm test
npm run typecheck

License

MIT