@muzi3/herdr-agent-state

Pi extension: report agent state (working/blocked/idle) and session reference to Herdr via its pane socket integration.

Packages

Package details

extension

Install @muzi3/herdr-agent-state from npm and Pi will load the resources declared by the package manifest.

npm repo report
$ pi install npm:@muzi3/herdr-agent-state
Package
@muzi3/herdr-agent-state
Version
0.1.1
Published
Aug 25, 2026
Downloads
236/mo · 236/wk
Author
muzi3
License
MIT
Types
extension
Size
8.9 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

@muzi3/herdr-agent-state

Pi 扩展：通过 Herdr 的 pane socket 上报 agent 状态（working / blocked / idle）及会话引用，供 Herdr 面板展示。

此文件由 Herdr 集成管理，重装或更新集成时会覆盖；请在旁边添加自定义 hooks 而非编辑它。

安装

pi install npm:@muzi3/herdr-agent-state

环境变量

需在 Herdr 集成环境中运行，依赖以下环境变量：

变量 说明
HERDR_ENV 为 1 时启用
HERDR_SOCKET_PATH Herdr pane socket 路径
HERDR_PANE_ID 当前 pane id

未设置这些变量时扩展静默跳过。

行为

  • agent_start / agent_settled 时上报 working / idle
  • herdr:blocked 事件上报 blocked
  • session_start 时上报会话引用（session path 或 id）

许可

MIT