{"_id":"@baggiiiie/pi-headroom","name":"@baggiiiie/pi-headroom","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@baggiiiie/pi-headroom","version":"0.0.1","type":"module","keywords":["pi-package","headroom","context-compression"],"pi":{"extensions":["./src/headroom.ts"]},"peerDependencies":{"@earendil-works/pi-coding-agent":"*"},"gitHead":"d619ff044f86a122da67121a1b18779228a3049b","_id":"@baggiiiie/pi-headroom@0.0.1","description":"Tiny Pi extension for local [Headroom](https://github.com/headroomlabs-ai/headroom) compression.","_nodeVersion":"25.5.0","_npmVersion":"11.14.1","dist":{"integrity":"sha512-cNTtkRdvLRaFvD0otCQFzcx7D4luipOUJUzvzb859XaKFc85mBjb9Cd9Pv+pBBAWaaQVptb60Y/FsrP52To5pA==","shasum":"9af61c43ef7b9f31f1ecbcc52049a56d267b7b68","tarball":"https://registry.npmjs.org/@baggiiiie/pi-headroom/-/pi-headroom-0.0.1.tgz","fileCount":3,"unpackedSize":16136,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBRt9MQOkrQWeWqivaZuDAHFFs6eYckOd8H9Wz+0BECqAiEA2hYaiT6MiEJ0ka0NlPawvZUa/Csm2iEuw88M315qjgM="}]},"_npmUser":{"name":"baggiiiie","email":"yc@yingchao.dev"},"directories":{},"maintainers":[{"name":"baggiiiie","email":"yc@yingchao.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-headroom_0.0.1_1782444763842_0.10405706388806868"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-26T03:32:43.668Z","0.0.1":"2026-06-26T03:32:43.986Z","modified":"2026-06-26T03:32:44.201Z"},"maintainers":[{"name":"baggiiiie","email":"yc@yingchao.dev"}],"description":"Tiny Pi extension for local [Headroom](https://github.com/headroomlabs-ai/headroom) compression.","keywords":["pi-package","headroom","context-compression"],"readme":"# @baggiiiie/pi-headroom\n\nTiny Pi extension for local [Headroom](https://github.com/headroomlabs-ai/headroom) compression.\n\nIt is intentionally conservative:\n\n- calls only `http://127.0.0.1:8788` by default\n- sends converted context to that local proxy, but only applies changes to large Pi `toolResult` text\n- never applies changes to user prompts, assistant text, tool ids, or tool names\n- fails open if Headroom is offline or returns an unexpected shape\n- caches compressed tool results in memory so the same output is not recompressed every turn\n\n## Install\n\n```bash\npi install ./packages/headroom\n```\n\nInstall and run Headroom separately:\n\n```bash\npipx install --python python3.13 \"headroom-ai[proxy]\"\nHEADROOM_TELEMETRY=off headroom proxy --host 127.0.0.1 --port 8788 --mode token --no-cache --no-ccr-marker\n```\n\n## Commands\n\n- `/headroom` or `/headroom status` — show status\n- `/headroom health` — check the local proxy\n- `/headroom off` — disable for this Pi session\n- `/headroom on` — enable and check the local proxy\n\n## Environment\n\n| Variable | Default |\n| --- | --- |\n| `PI_HEADROOM_URL` | `http://127.0.0.1:8788` |\n| `PI_HEADROOM_ALLOW_REMOTE` | `false` |\n| `PI_HEADROOM_MIN_CONTEXT_TOKENS` | `20000` |\n| `PI_HEADROOM_MIN_TOOL_CHARS` | `2000` |\n| `PI_HEADROOM_TIMEOUT_MS` | `30000` |\n| `PI_HEADROOM_HEALTH_TIMEOUT_MS` | `1000` |\n| `PI_HEADROOM_OFFLINE_BACKOFF_MS` | `30000` |\n| `PI_HEADROOM_MAX_CACHE_ENTRIES` | `200` |\n","readmeFilename":"README.md","_rev":"1-61a48724f83513b9d7ae9fce752ee744"}