@aliou/pi-poolside

Pi extension package for the Poolside inference API.

Provides the poolside provider with OpenAI-compatible completions endpoint. The extension registers cached models at startup and refreshes the model list through Pi's provider refresh API when credentials are available.

Models

Model	Reasoning	Context	Max Output
poolside/laguna-m.1	yes	262144	32768
poolside/laguna-xs-2.1	yes	262144	32768

Setup

1. Install the package:

   pi install npm:@aliou/pi-poolside
   

2. Configure your API key. Either:

   • Set the POOLSIDE_API_KEY environment variable
   • Add the key to ~/.pi/agent/auth.json:

     { "poolside": { "type": "api_key", "key": "your-api-key" } }
     

   • Add the key via models.json (see Custom Models docs for full configuration reference):

     {
       "providers": {
         "poolside": {
           "apiKey": "your-api-key"
         }
       }
     }
     

3. Select a poolside model in Pi.

Auth resolution order

1. CLI --api-key flag
2. auth.json entry for poolside
3. Environment variable POOLSIDE_API_KEY

Development

pnpm install
pnpm typecheck
pnpm lint
pnpm check:lockfile

Layout

• extensions/provider/: Pi provider extension entry point and model refresh logic.