@howaboua/pi-howaboua-extensions-primitives-sdk

⚠️ WIP / personal-use package

This SDK is currently for use by howaboua to standardize personal Pi extensions. You can use it, but you do so at your own peril 😄

Pi Extensions Design SDK

A reusable SDK for building consistent, high-signal TUI views in Pi extensions.

What this gives you

• fixed-height panels with consistent headers/footers
• list/action/detail flows with shared interaction patterns
• attached detail previews above the main panel
• turnkey picker runtime for one-off selections (runPicker)
• turnkey multiline composer runtime for prompt/text editing (runComposer)
• wraparound navigation and predictable key behavior

Repo layout

• ./sdk → framework-style SDK source
• ./sdk/example → frozen reference implementation

Quick start

• Import SDK primitives from @howaboua/pi-howaboua-extensions-primitives-sdk in your Pi extension code.
• Build your screens with the exported primitives.
• Register your command and call the shared runtime loop.

For API contracts and usage details, read:

• ./AGENT_REFERENCE.md (agent-first integration contract)
• ./API_REFERENCE.md (fast export/signature map)
• ./sdk/README.md (SDK internals and roles)

Migration helper

From this SDK repository checkout, rewrite local ./sdk style imports to the npm package automatically:

npm run migrate:sdk-imports -- /path/to/extension

Notes

• ./sdk/example is reference code and intended to stay stable.
• SDK changes should be intentional and minimal.
• Optional live preview: point Pi directly to ./sdk/example/index.ts.