@aliou/pi-poolside

Pi extension package for the [Poolside](https://poolside.ai) inference API.

Packages

Package details

extension

Install @aliou/pi-poolside from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@aliou/pi-poolside

Package: @aliou/pi-poolside
Version: 0.2.1
Published: Sep 27, 2026
Downloads: 322/mo · 13/wk
Author: aliou
License: MIT
Types: extension
Size: 11.8 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./extensions/provider/index.ts"
  ]
}

Security note

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

README

@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

Install the package:
```
pi install npm:@aliou/pi-poolside
```
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"
    }
  }
}
```
Select a poolside model in Pi.

Auth resolution order

CLI --api-key flag
auth.json entry for poolside
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.