pi-openrouter-realtime 0.2.0 → 0.2.2

package/README.md

@@ -4,6 +4,8 @@
 
 Pi extension for OpenRouter that loads the latest models from OpenRouter in real time, keeps the default model list simple, and lets you enrich a specific model with provider and quantization variants.
 
+Once the extension is installed and your OpenRouter credential is configured in pi, each new pi session automatically fetches the latest OpenRouter model list.
+
 Npm package:
 
 - `pi-openrouter-realtime`
@@ -19,19 +21,74 @@ Npm package:
 
 ## Install
 
-### From npm
+### 1) Install the extension
+
+From npm:
 
 ```bash
 pi install npm:pi-openrouter-realtime
 ```
 
-### From GitHub
+From GitHub:
 
 ```bash
 pi install git:github.com/olixis/pi-openrouter-plus
 ```
 
-### Try without installing
+### 2) Connect pi to OpenRouter
+
+#### Recommended: use `pi-connect` to set up OpenRouter
+
+The `git:github.com/hk-vk/pi-connect` package makes provider setup much easier and gives you a simple `/connect` flow inside pi.
+
+Install it:
+
+```bash
+pi install git:github.com/hk-vk/pi-connect
+```
+
+Then open pi and connect OpenRouter:
+
+```bash
+pi
+/connect openrouter
+```
+
+When prompted:
+
+1. Paste your OpenRouter API key
+2. Confirm/save it
+3. Start a new pi session, or restart the current one
+
+`pi-connect` stores the credential in `~/.pi/agent/auth.json`, and this extension will then automatically fetch the latest models from OpenRouter when pi starts.
+
+#### Official pi ways to connect OpenRouter
+
+Pi supports OpenRouter via either an environment variable or `~/.pi/agent/auth.json`.
+
+Using an environment variable:
+
+```bash
+export OPENROUTER_API_KEY=sk-or-...
+pi
+```
+
+Using `~/.pi/agent/auth.json`:
+
+```json
+{
+  "openrouter": { "type": "api_key", "key": "sk-or-..." }
+}
+```
+
+Pi's official provider docs use:
+
+- Environment variable: `OPENROUTER_API_KEY`
+- `auth.json` key: `openrouter`
+
+After the key is available, this extension automatically syncs the latest plain OpenRouter model list at session start.
+
+### 3) Try without installing
 
 ```bash
 pi -e npm:pi-openrouter-realtime
@@ -56,16 +113,16 @@ pi -e git:github.com/olixis/pi-openrouter-plus
 
 This keeps the normal OpenRouter catalog and adds variants like:
 
-- `Kwaipilot: KAT-Coder-Pro V2 (StreamLake)`
-- `Kwaipilot: KAT-Coder-Pro V2 (AtlasCloud · fp8)`
+- `StreamLake — Kwaipilot: KAT-Coder-Pro V2`
+- `AtlasCloud · fp8 — Kwaipilot: KAT-Coder-Pro V2`
 
 ## Behavior
 
-- On startup, the extension syncs the latest plain OpenRouter model list from OpenRouter
+- After the extension is installed and OpenRouter auth is configured, each new pi session syncs the latest plain OpenRouter model list from OpenRouter automatically
 - Enrichment is manual and targeted to one model at a time
 - Quantization variants are exposed as separate model choices when available
 - Enriched variants are translated into OpenRouter provider routing fields at request time
-- If you want to go back to the default list, run `/openrouter-sync`
+- If you want to refresh manually or go back to the default list, run `/openrouter-sync`
 
 ## Development
 

package/extensions/openrouter-routing/index.ts

@@ -11,7 +11,7 @@ const OPENROUTER_MODELS_URL = "https://openrouter.ai/api/v1/models";
 const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
 const PROVIDER_NAME = "openrouter";
 const CACHE_TTL_MS = 30 * 60 * 1000; // 30 minutes
-const ENRICHED_MODEL_PREFIX = "openrouter-route:";
+const ENRICHED_MODEL_PREFIX = "@or:";
 
 type InputType = "text" | "image";
 type SyncMode = "plain" | "enriched";
@@ -163,14 +163,16 @@ function toProviderModel(m: OpenRouterModel): ProviderModelConfig {
 }
 
 function createVariantId(baseModelId: string, providerSlug: string, quantization?: string): string {
-  const q = quantization || "default";
-  return `${ENRICHED_MODEL_PREFIX}${baseModelId}::${providerSlug}::${q}`;
+  const routeLabel = quantization ? `${providerSlug}:${quantization}` : providerSlug;
+  // Keep provider/quantization first so truncated picker/footer labels still show
+  // the routing info that makes enriched variants useful.
+  return `${ENRICHED_MODEL_PREFIX}${routeLabel}:${baseModelId}`;
 }
 
 function createVariantName(baseName: string, providerName: string, quantization?: string): string {
   return quantization
-    ? `${baseName} (${providerName} · ${quantization})`
-    : `${baseName} (${providerName})`;
+    ? `${providerName} · ${quantization} — ${baseName}`
+    : `${providerName} — ${baseName}`;
 }
 
 function resetCaches() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-openrouter-realtime",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "OpenRouter extension for pi that loads the latest models from OpenRouter in real time and adds optional provider and quantization enrichment per model",
   "license": "MIT",
   "type": "module",