@cirthan/pi-cirthan-provider 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cirthan
+
+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,42 @@
+# pi-cirthan-provider
+
+Cirthan model provider for [pi](https://github.com/mariozechner/pi). Registers the `cirthan` provider using Cirthan's OpenAI-compatible API.
+
+This package fetches models from Cirthan's `/v1/models` endpoint at session start to filter enabled models.
+
+## Setup
+
+Provide an API key via environment variable or `~/.pi/agent/auth.json`.
+
+### Option 1: Environment variable
+
+```bash
+export CIRTHAN_API_KEY="..."
+# optional
+export CIRTHAN_BASE_URL="https://api.cirthan.com/v1"
+```
+
+### Option 2: auth.json (recommended)
+
+Add to `~/.pi/agent/auth.json`:
+
+```json
+{
+  "cirthan": {
+    "type": "api_key",
+    "key": "your_key_here"
+  }
+}
+```
+
+## Usage
+
+- List/switch models: `pi /model`
+- Use default model: `pi --model cirthan`
+- Use a specific model: `pi --model cirthan:glm-4.7-flash`
+
+## Default model
+
+The default model for this provider is:
+
+- `glm-4.7-flash`

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cirthan Provider Extension
+ *
+ * Cirthan provider for pi.
+ *
+ * - Registers a provider using Cirthan's OpenAI-compatible API
+ * - Fetches /v1/models on session start to filter which models are enabled
+ * - Provides hardcoded model configs with metadata
+ */
+import { type ExtensionAPI } from "@mariozechner/pi-coding-agent";
+export default function (pi: ExtensionAPI): void;

package/dist/index.js

@@ -0,0 +1,175 @@
+/**
+ * Cirthan Provider Extension
+ *
+ * Cirthan provider for pi.
+ *
+ * - Registers a provider using Cirthan's OpenAI-compatible API
+ * - Fetches /v1/models on session start to filter which models are enabled
+ * - Provides hardcoded model configs with metadata
+ */
+// =============================================================================
+// Configuration
+// =============================================================================
+const CIRTHAN_API_BASE_URL = (process.env.CIRTHAN_BASE_URL ?? "https://api.cirthan.com/v1").replace(/\/+$/, "");
+const CIRTHAN_MODELS_ENDPOINT = `${CIRTHAN_API_BASE_URL}/models`;
+/** Default model for this provider. */
+const CIRTHAN_DEFAULT_MODEL_ID = "glm-4.7-flash";
+// =============================================================================
+// Hardcoded model configs
+// =============================================================================
+/** Hardcoded model configurations - exactly matching /v1/models response. */
+const HARDCODED_MODELS = [
+    {
+        id: "glm-4.7-flash",
+        name: "glm-4.7-flash",
+        reasoning: true,
+        input: ["text"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 200000,
+        maxTokens: 131072,
+    },
+    {
+        id: "qwen3-vl-8b-instruct",
+        name: "qwen3-vl-8b-instruct",
+        reasoning: false,
+        input: ["text", "image"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 131072,
+        maxTokens: 32768,
+    },
+    {
+        id: "minimax-m2.5",
+        name: "minimax-m2.5",
+        reasoning: true,
+        input: ["text"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 196608,
+        maxTokens: 131072,
+    },
+];
+// =============================================================================
+// Auth helpers
+// =============================================================================
+async function getCirthanApiKey(ctx) {
+    const envKey = process.env.CIRTHAN_API_KEY;
+    try {
+        const authKey = await ctx.modelRegistry.getApiKeyForProvider("cirthan");
+        if (authKey)
+            return authKey;
+    }
+    catch {
+        // Provider may not be registered yet.
+    }
+    return envKey;
+}
+async function hasCirthanApiKey(ctx) {
+    if (process.env.CIRTHAN_API_KEY)
+        return true;
+    try {
+        const authKey = await ctx.modelRegistry.getApiKeyForProvider("cirthan");
+        return !!authKey;
+    }
+    catch {
+        return false;
+    }
+}
+// =============================================================================
+// Model fetching + filtering
+// =============================================================================
+/**
+ * Verify models are enabled by fetching /v1/models.
+ * Returns hardcoded configs filtered to only include enabled models.
+ */
+async function fetchAndFilterModels(apiKey) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    try {
+        const headers = {
+            Accept: "application/json",
+        };
+        if (apiKey)
+            headers.Authorization = `Bearer ${apiKey}`;
+        console.log(`[Cirthan Provider] Fetching enabled models from: ${CIRTHAN_MODELS_ENDPOINT}`);
+        const response = await fetch(CIRTHAN_MODELS_ENDPOINT, { headers, signal: controller.signal });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Failed to fetch models: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        const data = (await response.json());
+        // Build map of model ID to context window from API
+        const apiModelContexts = new Map();
+        for (const model of data.data ?? []) {
+            apiModelContexts.set(model.id.toLowerCase(), model.max_model_len ?? model.contextWindow ?? 0);
+        }
+        console.log(`[Cirthan Provider] API returned ${apiModelContexts.size} enabled models`);
+        // Filter: only include models that are enabled in the API
+        // Always include default model regardless of API response
+        // Use case-insensitive comparison since API may return different casing
+        const filtered = HARDCODED_MODELS.filter((model) => {
+            if (model.id === CIRTHAN_DEFAULT_MODEL_ID)
+                return true;
+            return apiModelContexts.has(model.id.toLowerCase());
+        }).map((model) => {
+            // Override contextWindow with API's max_model_len if available
+            const apiContext = apiModelContexts.get(model.id.toLowerCase());
+            if (apiContext && apiContext > 0) {
+                return { ...model, contextWindow: apiContext };
+            }
+            return model;
+        });
+        // Sort with default model first, then alphabetical
+        filtered.sort((a, b) => {
+            if (a.id === CIRTHAN_DEFAULT_MODEL_ID)
+                return -1;
+            if (b.id === CIRTHAN_DEFAULT_MODEL_ID)
+                return 1;
+            return a.id.localeCompare(b.id);
+        });
+        console.log(`[Cirthan Provider] Registered ${filtered.length} model configs for provider 'cirthan'`);
+        return filtered;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message === "AbortError" || message.includes("aborted")) {
+            console.warn("[Cirthan Provider] Model fetch timed out after 5s");
+        }
+        else {
+            console.error("[Cirthan Provider] Failed to fetch models:", error);
+        }
+        // On error, return all hardcoded models as fallback
+        console.log("[Cirthan Provider] Using all hardcoded models as fallback");
+        return [...HARDCODED_MODELS];
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+// =============================================================================
+// Extension entry point
+// =============================================================================
+export default function (pi) {
+    // Initial registration must happen synchronously (see synthetic provider).
+    pi.registerProvider("cirthan", {
+        baseUrl: CIRTHAN_API_BASE_URL,
+        apiKey: "CIRTHAN_API_KEY",
+        api: "openai-completions",
+        models: HARDCODED_MODELS,
+    });
+    pi.on("session_start", async (_event, ctx) => {
+        const hasKey = await hasCirthanApiKey(ctx);
+        const apiKey = await getCirthanApiKey(ctx);
+        if (!hasKey) {
+            console.log("[Cirthan Provider] API key not configured.");
+            console.log("[Cirthan Provider] Options:");
+            console.log("  1. Set CIRTHAN_API_KEY environment variable");
+            console.log("  2. Add to ~/.pi/agent/auth.json (provider: \"cirthan\")");
+        }
+        const models = await fetchAndFilterModels(apiKey);
+        ctx.modelRegistry.registerProvider("cirthan", {
+            baseUrl: CIRTHAN_API_BASE_URL,
+            apiKey: "CIRTHAN_API_KEY",
+            api: "openai-completions",
+            models,
+        });
+    });
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@cirthan/pi-cirthan-provider",
+  "version": "0.1.0",
+  "description": "Pi provider package for the Cirthan API.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "keywords": [
+    "pi",
+    "pi-package",
+    "extension"
+  ],
+  "pi": {
+    "extensions": ["./dist/index.js"]
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "eslint": "^9.17.0",
+    "globals": "^17.3.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.56.0"
+  },
+  "license": "MIT"
+}