@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.