pi-sakana-provider 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jabbslad
+
+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,64 @@
+# pi-sakana-provider
+
+Sakana AI custom provider for Pi.
+
+This package registers provider id `sakana` via `pi.registerProvider()` and uses Pi's built-in `openai-responses` API implementation against `https://api.sakana.ai/v1`.
+
+## Models
+
+| Model | Reasoning | Input | Context window | Max output |
+| --- | --- | --- | --- | --- |
+| `fugu` | yes | text, image | 1,000,000 | 65,536 |
+| `fugu-ultra` | yes | text, image | 1,000,000 | 131,072 |
+| `fugu-ultra-20260615` | yes | text, image | 1,000,000 | 131,072 |
+
+All Fugu models are reasoning models. Sakana only accepts reasoning efforts
+`high` and `xhigh` (`max` is an alias of `xhigh`); any other value is rejected.
+Pi thinking levels are mapped accordingly: `minimal`, `low`, `medium`, and
+`high` all send `high`; `xhigh` sends `xhigh`; `off` sends no effort (the API
+then uses its default).
+
+Context windows match Sakana's published model catalog. Max-output values are
+not published in the catalog; the values above are conservative defaults.
+
+## Usage
+
+Set your Sakana API key:
+
+```bash
+export SAKANA_API_KEY=...
+```
+
+Load once for testing (run from the repo root):
+
+```bash
+pi -e . --provider sakana --model fugu-ultra
+```
+
+Install from npm:
+
+```bash
+pi install npm:pi-sakana-provider
+```
+
+Or install from a local checkout (run from the repo root):
+
+```bash
+pi install .
+```
+
+Or add the package to `~/.pi/agent/settings.json` (the npm name, or a path
+relative to that file / an absolute path):
+
+```json
+{
+  "packages": ["pi-sakana-provider"],
+  "defaultProvider": "sakana",
+  "defaultModel": "fugu-ultra",
+  "defaultThinkingLevel": "xhigh"
+}
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/index.ts

@@ -0,0 +1,58 @@
+import type { ExtensionAPI, ProviderModelConfig } from "@earendil-works/pi-coding-agent";
+
+const SAKANA_BASE_URL = "https://api.sakana.ai/v1";
+const FUGU_COST = { input: 5, output: 30, cacheRead: 0.5, cacheWrite: 0 };
+
+// Sakana accepts reasoning.effort values "high", "xhigh" (and "max", an alias of
+// "xhigh"); any other value is rejected. Map pi's thinking levels onto those.
+const FUGU_THINKING = {
+	off: null,
+	minimal: "high",
+	low: "high",
+	medium: "high",
+	high: "high",
+	xhigh: "xhigh",
+};
+
+export const SAKANA_MODELS: ProviderModelConfig[] = [
+	{
+		id: "fugu",
+		name: "Fugu",
+		reasoning: true,
+		thinkingLevelMap: FUGU_THINKING,
+		input: ["text", "image"],
+		cost: FUGU_COST,
+		contextWindow: 1_000_000,
+		maxTokens: 65_536,
+	},
+	{
+		id: "fugu-ultra",
+		name: "Fugu Ultra",
+		reasoning: true,
+		thinkingLevelMap: FUGU_THINKING,
+		input: ["text", "image"],
+		cost: FUGU_COST,
+		contextWindow: 1_000_000,
+		maxTokens: 131_072,
+	},
+	{
+		id: "fugu-ultra-20260615",
+		name: "Fugu Ultra (2026-06-15)",
+		reasoning: true,
+		thinkingLevelMap: FUGU_THINKING,
+		input: ["text", "image"],
+		cost: FUGU_COST,
+		contextWindow: 1_000_000,
+		maxTokens: 131_072,
+	},
+];
+
+export default function (pi: ExtensionAPI) {
+	pi.registerProvider("sakana", {
+		name: "Sakana AI",
+		baseUrl: SAKANA_BASE_URL,
+		apiKey: "$SAKANA_API_KEY",
+		api: "openai-responses",
+		models: SAKANA_MODELS,
+	});
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "pi-sakana-provider",
+  "version": "0.1.0",
+  "description": "Sakana AI custom provider for Pi.",
+  "license": "MIT",
+  "author": "Jabbslad",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jabbslad/pi-sakana-provider.git"
+  },
+  "homepage": "https://github.com/Jabbslad/pi-sakana-provider#readme",
+  "bugs": {
+    "url": "https://github.com/Jabbslad/pi-sakana-provider/issues"
+  },
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "sakana",
+    "sakana-ai"
+  ],
+  "files": [
+    "index.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "echo 'nothing to clean'",
+    "build": "echo 'nothing to build'",
+    "check": "echo 'nothing to check'"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}