pi-fireworks-provider 1.0.2

package/.github/FUNDING.yml

@@ -0,0 +1,4 @@
+github: monotykamary
+ko_fi: monotykamary
+buy_me_a_coffee: monotykamary
+polar: monotykamary

package/.pi/messenger/channels/memory.jsonl

@@ -0,0 +1 @@
+{"_meta":true,"v":1,"id":"memory","type":"named","createdAt":"2026-05-25T08:03:16.155Z","description":"Cross-session knowledge and insights"}

package/.pi/messenger/session-id

@@ -0,0 +1 @@
+019e98a1-b474-7d6d-b80e-b1dedf22aa71

package/AGENTS.md

@@ -0,0 +1,56 @@
+# AGENTS.md
+
+## DO NOT EDIT — Auto-generated Files
+
+The following files are **idempotent** and regenerated by `scripts/update-models.js`. Never edit them directly — your changes will be overwritten on the next model sync.
+
+| File | Why it's auto-generated |
+|------|------------------------|
+| `models.json` | Built from the provider API. `update-models.js` fetches models, preserves curated data for known IDs, and writes this file. |
+| `README.md` (model table) | The table under `## Available Models` is replaced in-place by `update-models.js` after merging base models → patch → custom models. |
+
+## Correct Files to Edit
+
+When a model needs overrides, new properties, or corrections, edit the appropriate source file below. These are the **source of truth** that the update script reads but never writes.
+
+| File | Purpose |
+|------|---------|
+| `patch.json` | Per-model overrides keyed by model ID. Add reasoning flags, compat settings, pricing corrections, thinking level maps, etc. Applied on top of `models.json` at runtime and for README generation. |
+| `custom-models.json` | Models that don't exist in the provider API (hidden models, router endpoints, cross-provider aliases). Merged after patch. Format: array of full model objects (same schema as `models.json` entries). |
+| `index.ts` | Provider extension code. |
+| `scripts/update-models.js` | The sync script itself (edit only if changing how models are fetched/transformed). |
+
+## Data Flow
+
+```
+Provider API  ──fetch──►  models.json  ──apply──►  patch.json  ──merge──►  custom-models.json
+                                    │                            │                      │
+                                    └────────────────────────────┴──────────────────────┘
+                                                      │
+                                              README model table
+```
+
+1. `models.json` — base data from the provider API (auto-generated, DO NOT EDIT)
+2. `patch.json` — overrides applied on top (EDIT THIS for corrections/enrichments)
+3. `custom-models.json` — additional models not in the API (EDIT THIS for new models)
+4. README table — rendered from the merged result of all three (auto-generated, DO NOT EDIT)
+
+## Common Tasks
+
+### Add a compat setting or override pricing for an existing model
+→ Edit `patch.json`. Add an entry keyed by the model's `id`.
+
+### Add a model not available in the provider API
+→ Edit `custom-models.json`. Add a full model object to the array.
+
+### Update models from the provider API
+→ Run `node scripts/update-models.js` (may require an API key env var).
+
+### Regenerate the README model table
+→ Run `node scripts/update-models.js` — it updates both `models.json` and the README table.
+
+## TL;DR
+
+- **Never edit `models.json`** — edit `patch.json` instead.
+- **Never edit the README model table** — run the update script instead.
+- `patch.json` and `custom-models.json` are the source files you should modify.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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,150 @@
+<div align="center">
+
+# 🎆 pi-fireworks-provider
+
+**31+ models through [Fireworks AI](https://fireworks.ai/)**
+
+_Kimi, MiniMax, GLM, DeepSeek, GPT-OSS — unified OpenAI-compatible API for [pi](https://github.com/earendil-works/pi-coding-agent)._
+
+[![pi extension](https://img.shields.io/badge/pi-extension-blueviolet)](https://github.com/earendil-works/pi-coding-agent)
+[![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
+
+</div>
+
+---
+
+## Features
+
+- **35+ AI Models** including Kimi K2.5, MiniMax M2.5, GLM 4.5/4.7/5, DeepSeek V3.1/V3.2, DeepSeek V4 Flash, and GPT-OSS
+- **Unified API** via Fireworks AI's OpenAI-compatible completions endpoint
+- **Cost Tracking** with per-model pricing for budget management
+- **Reasoning Models** support for advanced reasoning capabilities
+- **Vision Support** for image-capable models
+
+## Installation
+
+### Option 1: Using `pi install` (Recommended)
+
+Install directly from GitHub:
+
+```bash
+pi install https://github.com/monotykamary/pi-fireworks-provider
+```
+
+Then set your API key and run pi:
+```bash
+# Recommended: add to auth.json
+# See Authentication section below
+
+# Or set as environment variable
+export FIREWORKS_API_KEY=your-api-key-here
+
+pi
+```
+
+### Option 2: Manual Clone
+
+1. Clone this repository:
+   ```bash
+   git clone https://github.com/monotykamary/pi-fireworks-provider.git
+   cd pi-fireworks-provider
+   ```
+
+2. Set your Fireworks API key:
+   ```bash
+   # Recommended: add to auth.json
+   # See Authentication section below
+
+   # Or set as environment variable
+   export FIREWORKS_API_KEY=your-api-key-here
+   ```
+
+3. Run pi with the extension:
+   ```bash
+   pi -e /path/to/pi-fireworks-provider
+   ```
+
+## Available Models
+
+| Model | Type | Context | Max Tokens | Input Cost | Output Cost |
+|-------|------|---------|------------|------------|-------------|
+| DeepSeek V3.1 | Text | 164K | 164K | $0.56 | $1.68 |
+| DeepSeek V3.2 | Text | 164K | 160K | $0.56 | $1.68 |
+| DeepSeek V4 Flash | Text | 1.0M | 1.0M | $0.14 | $0.28 |
+| DeepSeek V4 Pro | Text | 1.0M | 1.0M | Free | Free |
+| DeepSeek V4 Pro (router) | Text | 1.0M | 1.0M | $1.74 | $3.48 |
+| Gemma 4 26B A4B IT | Text + Image | 262K | 0 | Free | Free |
+| Gemma 4 31B IT | Text + Image | 262K | 0 | Free | Free |
+| GLM 4.5 | Text | 131K | 131K | $0.55 | $2.19 |
+| GLM 4.5 Air | Text | 131K | 131K | $0.22 | $0.88 |
+| GLM 4.7 | Text | 203K | 198K | $0.60 | $2.20 |
+| GLM 5 | Text | 203K | 131K | $1.00 | $3.20 |
+| GLM 5 Fast (router) | Text | 203K | 131K | $1.00 | $3.20 |
+| GLM 5.1 | Text | 203K | 131K | $1.40 | $4.40 |
+| GLM 5.1 Fast (router) | Text | 203K | 131K | $1.40 | $4.40 |
+| GLM 5.2 | Text | 1.0M | 0 | Free | Free |
+| GPT OSS 120B | Text | 131K | 33K | $0.15 | $0.60 |
+| GPT OSS 20B | Text | 131K | 33K | $0.05 | $0.20 |
+| Kimi K2 Instruct | Text | 131K | 16K | $1.00 | $3.00 |
+| Kimi K2 Thinking | Text | 262K | 256K | $0.60 | $2.50 |
+| Kimi K2.5 | Text + Image | 262K | 256K | $0.60 | $3.00 |
+| Kimi K2.5 Fast (router) | Text + Image | 262K | 256K | $0.60 | $3.00 |
+| Kimi K2.6 | Text + Image | 262K | 262K | $0.95 | $4.00 |
+| Kimi K2.6 (router) | Text + Image | 262K | 262K | $0.95 | $4.00 |
+| Kimi K2.6 Turbo (router) | Text + Image | 262K | 262K | $0.95 | $4.00 |
+| Kimi K2.7 Code | Text + Image | 262K | 0 | Free | Free |
+| Llama 3.3 70B Instruct | Text | 131K | 0 | Free | Free |
+| MiniMax M2.7 (router) | Text | 204K | 0 | $0.30 | $1.20 |
+| Minimax M3 | Text + Image | 512K | 0 | Free | Free |
+| MiniMax-M2.1 | Text | 197K | 200K | $0.30 | $1.20 |
+| MiniMax-M2.5 | Text | 197K | 197K | $0.30 | $1.20 |
+| MiniMax-M2.7 | Text | 197K | 197K | $0.30 | $1.20 |
+| NVIDIA Nemotron 3 Ultra NVFP4 | Text | 262K | 0 | Free | Free |
+| Qwen3 8B | Text | 41K | 0 | Free | Free |
+| Qwen3 VL 30B A3B Instruct | Text + Image | 262K | 0 | Free | Free |
+| Qwen3 VL 30B A3B Thinking | Text + Image | 262K | 0 | Free | Free |
+*Costs are per million tokens. Prices subject to change - check [fireworks.ai](https://fireworks.ai) for current pricing.*
+
+## Usage
+
+After loading the extension, use the `/model` command in pi to select your preferred model:
+
+```
+/model
+```
+
+Then select "fireworks" as the provider and choose from the available models.
+
+## Authentication
+
+The Fireworks API key can be configured in multiple ways (resolved in this order):
+
+1. **`auth.json`** (recommended) — Add to `~/.pi/agent/auth.json`:
+   ```json
+   { "fireworks": { "type": "api_key", "key": "your-api-key" } }
+   ```
+   The `key` field supports literal values, env var names, and shell commands (prefix with `!`). See [pi's auth file docs](https://github.com/badlogic/pi-mono) for details.
+2. **Runtime override** — Use the `--api-key` CLI flag
+3. **Environment variable** — Set `FIREWORKS_API_KEY`
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `FIREWORKS_API_KEY` | No | Your Fireworks AI API key (fallback if not in auth.json) |
+
+## Configuration
+
+Add to your pi configuration for automatic loading:
+
+```json
+{
+  "extensions": [
+    "/path/to/pi-fireworks-provider"
+  ]
+}
+```
+
+## License
+
+MIT

package/custom-models.json

@@ -0,0 +1,151 @@
+[
+  {
+    "id": "accounts/fireworks/routers/deepseek-v4-pro",
+    "name": "DeepSeek V4 Pro (router)",
+    "reasoning": true,
+    "cost": {
+      "input": 0,
+      "output": 0,
+      "cacheRead": 0,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text"
+    ],
+    "contextWindow": 1048576,
+    "maxTokens": 0
+  },
+  {
+    "id": "accounts/fireworks/routers/kimi-k2p5-fast",
+    "name": "Kimi K2.5 Fast (router)",
+    "reasoning": true,
+    "cost": {
+      "input": 0,
+      "output": 0,
+      "cacheRead": 0,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text",
+      "image"
+    ],
+    "contextWindow": 262144,
+    "maxTokens": 0
+  },
+  {
+    "id": "accounts/fireworks/routers/kimi-k2p6-turbo",
+    "name": "Kimi K2.6 Turbo (router)",
+    "reasoning": true,
+    "cost": {
+      "input": 0,
+      "output": 0,
+      "cacheRead": 0,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text",
+      "image"
+    ],
+    "contextWindow": 262144,
+    "maxTokens": 0
+  },
+  {
+    "id": "accounts/fireworks/routers/kimi-k2p6",
+    "name": "Kimi K2.6 (router)",
+    "reasoning": true,
+    "cost": {
+      "input": 0,
+      "output": 0,
+      "cacheRead": 0,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text",
+      "image"
+    ],
+    "contextWindow": 262144,
+    "maxTokens": 262144
+  },
+  {
+    "id": "accounts/fireworks/routers/glm-5p1-fast",
+    "name": "GLM 5.1 Fast (router)",
+    "reasoning": true,
+    "cost": {
+      "input": 1.4,
+      "output": 4.4,
+      "cacheRead": 0.26,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text"
+    ],
+    "contextWindow": 202800,
+    "maxTokens": 131072
+  },
+  {
+    "id": "accounts/fireworks/routers/minimax-m2p7",
+    "name": "MiniMax M2.7 (router)",
+    "reasoning": true,
+    "cost": {
+      "input": 0.3,
+      "output": 1.2,
+      "cacheRead": 0.06,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text"
+    ],
+    "contextWindow": 204000,
+    "maxTokens": 0
+  },
+  {
+    "id": "accounts/fireworks/routers/glm-5-fast",
+    "name": "GLM 5 Fast",
+    "reasoning": true,
+    "cost": {
+      "input": 1,
+      "output": 3.2,
+      "cacheRead": 0.5,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text"
+    ],
+    "contextWindow": 202752,
+    "maxTokens": 131072
+  },
+  {
+    "id": "accounts/fireworks/models/gemma-4-31b-it",
+    "name": "Gemma 4 31B IT",
+    "reasoning": true,
+    "cost": {
+      "input": 0,
+      "output": 0,
+      "cacheRead": 0,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text",
+      "image"
+    ],
+    "contextWindow": 262000,
+    "maxTokens": 0
+  },
+  {
+    "id": "accounts/fireworks/models/gemma-4-26b-a4b-it",
+    "name": "Gemma 4 26B A4B IT",
+    "reasoning": true,
+    "cost": {
+      "input": 0,
+      "output": 0,
+      "cacheRead": 0,
+      "cacheWrite": 0
+    },
+    "input": [
+      "text",
+      "image"
+    ],
+    "contextWindow": 262000,
+    "maxTokens": 0
+  }
+]