@prjct.app/pi-prompt-state

Report blocked tool prompts to Herdr through Pi events; inactive outside Herdr.

Packages

Package details

extension

Install @prjct.app/pi-prompt-state from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@prjct.app/pi-prompt-state
Package
@prjct.app/pi-prompt-state
Version
0.1.2
Published
Oct 13, 2026
Downloads
143/mo · 6/wk
Author
jlopezlira
License
MIT
Types
extension
Size
1.6 MB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/prjct-app/pi-prompt-state/main/docs/cover-v2.png",
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-prompt-state

pi-prompt-state — for PI Agent

Tell Herdr when a running Pi tool is waiting for a person to answer a terminal prompt.

Install

Requires Pi with ui_prompt_start / ui_prompt_end events, Herdr Pi Tree, and Node.js 22.19+:

pi install npm:@prjct.app/pi-prompt-state

Reload Pi after installation. If Herdr already installed its managed prompt-state bridge, use that copy instead; loading both emits duplicate events.

Behavior

  • Registers nothing unless HERDR_ENV=1.
  • Emits herdr:blocked with active: true when a prompt opens during tool execution, and active: false when the waiting span ends.
  • Prompts from commands or independent widgets do not mark the agent blocked.
  • Herdr's companion integration consumes these events. This package adds no commands, tools, or notifications of its own.

Removing the bridge leaves Herdr with its normal working/idle states.

Development

From the repository root: node scripts/build-pi.mjs pi-prompt-state.

License: MIT.