pi-poolside 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Park Kiyong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# pi-poolside
+
+Poolside AI provider extension for [Pi](https://github.com/earendil-works/pi-coding-agent).
+
+Registers [Poolside](https://poolside.ai) as an OpenAI-compatible provider so you can pick its models from Pi's `/model` selector.
+
+## Install
+
+```bash
+npm install -g @parkiyong/pi-poolside
+```
+
+Pi auto-loads installed packages that declare a `pi.extensions` entry, so no extra wiring is needed.
+
+## Auth
+
+Export your Poolside API key before launching Pi:
+
+```bash
+export POOLSIDE_API_KEY=...
+```
+
+## Usage
+
+Inside Pi, run:
+
+```text
+/model
+```
+
+and pick one of:
+
+- `poolside/laguna-m.1` — Laguna M.1
+- `poolside/laguna-xs.2` — Laguna XS.2
+
+Both are registered with `reasoning: true` and a 131K context window placeholder.
+
+## Configuration notes
+
+The extension targets:
+
+- Base URL: `https://inference.poolside.ai/v1`
+- API style: `openai-completions`
+- Auth: bearer header via `POOLSIDE_API_KEY`
+- `max_tokens` field name forced via `compat.maxTokensField`
+
+`contextWindow`, `maxTokens` and `cost` are **conservative placeholders**. Update them in `index.ts` to match the limits and pricing Poolside publishes for your account.
+
+## Adding or updating models
+
+Edit the `models` array in [`index.ts`](./index.ts). Each entry follows Pi's provider model schema (`id`, `name`, `reasoning`, `input`, `cost`, `contextWindow`, `maxTokens`, `compat`).
+
+## License
+
+[MIT](./LICENSE)

package/index.ts

@@ -0,0 +1,51 @@
+/**
+ * Poolside Provider Extension
+ *
+ * Registers Poolside (https://poolside.ai) as an OpenAI-compatible provider.
+ *
+ * Auth:
+ *   export POOLSIDE_API_KEY=...
+ *
+ * Then `/model` and pick poolside/laguna-m.1 or poolside/laguna-xs.2.
+ *
+ * NOTE: contextWindow, maxTokens and cost are conservative placeholders.
+ * Update them with the values Poolside publishes for your account.
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	pi.registerProvider("poolside", {
+		name: "Poolside",
+		baseUrl: "https://inference.poolside.ai/v1",
+		apiKey: "POOLSIDE_API_KEY",
+		api: "openai-completions",
+		authHeader: true,
+		models: [
+			{
+				id: "laguna-m.1",
+				name: "Laguna M.1",
+				reasoning: true,
+				input: ["text"],
+				cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+				contextWindow: 131100,
+				maxTokens: 8192,
+				compat: {
+					maxTokensField: "max_tokens",
+				},
+			},
+			{
+				id: "laguna-xs.2",
+				name: "Laguna XS.2",
+				reasoning: true,
+				input: ["text"],
+				cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+				contextWindow: 131100,
+				maxTokens: 8192,
+				compat: {
+					maxTokensField: "max_tokens",
+				},
+			},
+		],
+	});
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "pi-poolside",
+  "version": "1.0.0",
+  "description": "Poolside AI provider extension for Pi - registers Poolside models as OpenAI-compatible provider",
+  "keywords": ["pi-package", "pi", "pi-extension", "poolside", "ai-provider", "free"],
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/parkiyong/pi-poolside.git"
+  },
+  "homepage": "https://github.com/parkiyong/pi-poolside",
+  "bugs": {
+    "url": "https://github.com/parkiyong/pi-poolside/issues"
+  },
+  "pi": {
+    "extensions": ["./index.ts"]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}