@windagency/valora-plugin-openrouter 1.0.0

package/README.md

@@ -0,0 +1,33 @@
+# @windagency/valora-plugin-openrouter
+
+OpenRouter LLM provider — connects to openrouter.ai for unified access to hundreds of models via an OpenAI-compatible API.
+
+## Install
+
+```bash
+valora plugin add openrouter
+```
+
+Then set `OPENROUTER_API_KEY` in your environment.
+
+## What it contributes
+
+- `api.providers.register('openrouter', ...)` — an LLM provider with a real `validateModel` that calls `/v1/models` and caches the catalogue per session.
+
+## Permissions
+
+- `code-exec` — required by the loader.
+- `network` — justified by HTTPS calls to `openrouter.ai` via the OpenAI client.
+
+## Configuration
+
+| Env var                    | Effect                                       |
+| -------------------------- | -------------------------------------------- |
+| `OPENROUTER_API_KEY`       | Required. Auth token for the OpenRouter API. |
+| `OPENROUTER_DEFAULT_MODEL` | Default model when none is specified.        |
+
+The plugin uses a model prefix of `openrouter:`, e.g. `openrouter:anthropic/claude-sonnet-4.5`. `peerDependencies` includes `openai@^4.67.0` — Valora's host already provides this.
+
+## See also
+
+- [Plugins user guide](../../documentation/user-guide/plugins.md)

package/dist/index.js

@@ -0,0 +1,176 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+
+// src/models.ts
+var OPENROUTER_MODELS = {
+  CLAUDE_SONNET_4_5: "anthropic/claude-sonnet-4.5",
+  GEMMA_4_31B_FREE: "google/gemma-4-31b-it:free",
+  GPT_4O: "openai/gpt-4o",
+  LLAMA_3_3_70B: "meta-llama/llama-3.3-70b-instruct",
+  MISTRAL_LARGE: "mistralai/mistral-large"
+};
+
+// src/openrouter-provider.ts
+import OpenAI from "openai";
+var DEFAULT_BASE_URL = "https://openrouter.ai/api/v1";
+var DEFAULT_MODEL = OPENROUTER_MODELS.GEMMA_4_31B_FREE;
+var DEFAULT_REFERER = "https://github.com/windagency/valora.ai";
+var DEFAULT_TITLE = "Valora";
+var OpenRouterProvider = class {
+  name = "openrouter";
+  cachedModels = null;
+  client = null;
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  async complete(options) {
+    const model = options.model ?? DEFAULT_MODEL;
+    const response = await this.getClient().chat.completions.create({
+      max_tokens: options.max_tokens,
+      messages: this.mapMessages(options),
+      model,
+      stop: options.stop,
+      stream: false,
+      temperature: options.temperature,
+      tools: options.tools?.map((tool) => ({
+        function: { description: tool.description, name: tool.name, parameters: tool.parameters },
+        type: "function"
+      })),
+      top_p: options.top_p
+    });
+    const choice = response.choices[0];
+    if (!choice) throw new Error("OpenRouter returned no choices");
+    return {
+      content: choice.message.content ?? "",
+      finish_reason: choice.finish_reason,
+      model: response.model,
+      role: "assistant",
+      tool_calls: choice.message.tool_calls?.map((tc) => ({
+        arguments: this.parseArgs(tc.function.arguments),
+        id: tc.id,
+        name: tc.function.name
+      })),
+      usage: response.usage ? {
+        completion_tokens: response.usage.completion_tokens,
+        prompt_tokens: response.usage.prompt_tokens,
+        total_tokens: response.usage.total_tokens
+      } : void 0
+    };
+  }
+  getAlternativeModels(_currentModel) {
+    return [
+      OPENROUTER_MODELS.GEMMA_4_31B_FREE,
+      OPENROUTER_MODELS.CLAUDE_SONNET_4_5,
+      OPENROUTER_MODELS.GPT_4O,
+      OPENROUTER_MODELS.LLAMA_3_3_70B,
+      OPENROUTER_MODELS.MISTRAL_LARGE
+    ];
+  }
+  isConfigured() {
+    return this.resolveApiKey() !== void 0;
+  }
+  async streamComplete(options, onChunk) {
+    const model = options.model ?? DEFAULT_MODEL;
+    const stream = await this.getClient().chat.completions.create({
+      max_tokens: options.max_tokens,
+      messages: this.mapMessages(options),
+      model,
+      stop: options.stop,
+      stream: true,
+      temperature: options.temperature,
+      top_p: options.top_p
+    });
+    let fullContent = "";
+    let finishReason;
+    for await (const chunk of stream) {
+      const choice = chunk.choices[0];
+      if (choice?.delta?.content) {
+        fullContent += choice.delta.content;
+        onChunk(choice.delta.content);
+      }
+      if (choice?.finish_reason) finishReason = choice.finish_reason;
+    }
+    return { content: fullContent, finish_reason: finishReason, role: "assistant" };
+  }
+  async validateModel(model) {
+    if (!this.isConfigured()) return false;
+    try {
+      const catalogue = await this.loadCatalogue();
+      return catalogue.has(model);
+    } catch {
+      return false;
+    }
+  }
+  configString(key, fallback) {
+    const value = this.config[key];
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+  }
+  getClient() {
+    const apiKey = this.resolveApiKey();
+    if (apiKey === void 0) {
+      throw new Error("OpenRouter API key missing \u2014 set OPENROUTER_API_KEY or config.apiKey");
+    }
+    this.client ??= new OpenAI({
+      apiKey,
+      baseURL: this.configString("baseUrl", DEFAULT_BASE_URL),
+      defaultHeaders: {
+        "HTTP-Referer": this.configString("httpReferer", DEFAULT_REFERER),
+        "X-Title": this.configString("xTitle", DEFAULT_TITLE)
+      },
+      maxRetries: 2
+    });
+    return this.client;
+  }
+  async loadCatalogue() {
+    if (this.cachedModels !== null) return this.cachedModels;
+    const response = await this.getClient().models.list();
+    const ids = /* @__PURE__ */ new Set();
+    for (const entry of response.data) {
+      if (typeof entry.id === "string") ids.add(entry.id);
+    }
+    this.cachedModels = ids;
+    return ids;
+  }
+  mapMessages(options) {
+    return options.messages.map((m) => ({ content: m.content, role: m.role }));
+  }
+  parseArgs(raw) {
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return {};
+    }
+  }
+  resolveApiKey() {
+    const configKey = this.config["apiKey"];
+    if (typeof configKey === "string" && configKey.length > 0) {
+      return configKey;
+    }
+    const envKey = process.env["OPENROUTER_API_KEY"];
+    return typeof envKey === "string" && envKey.length > 0 ? envKey : void 0;
+  }
+};
+
+// src/index.ts
+var descriptor = {
+  defaultModel: OPENROUTER_MODELS.GEMMA_4_31B_FREE,
+  description: "OpenRouter \u2014 unified gateway to hundreds of models via an OpenAI-compatible API",
+  envVars: { apiKey: "OPENROUTER_API_KEY", model: "OPENROUTER_DEFAULT_MODEL" },
+  helpText: "Set OPENROUTER_API_KEY. Use any model slug from openrouter.ai/models, e.g. openrouter:anthropic/claude-sonnet-4.5.",
+  label: "OpenRouter",
+  modelModes: [
+    { mode: "default", model: OPENROUTER_MODELS.GEMMA_4_31B_FREE },
+    { mode: "default", model: OPENROUTER_MODELS.CLAUDE_SONNET_4_5 },
+    { mode: "default", model: OPENROUTER_MODELS.GPT_4O },
+    { mode: "default", model: OPENROUTER_MODELS.LLAMA_3_3_70B },
+    { mode: "default", model: OPENROUTER_MODELS.MISTRAL_LARGE }
+  ],
+  modelPrefix: "openrouter:",
+  requiresApiKey: true
+};
+function register(api) {
+  api.providers.register("openrouter", OpenRouterProvider, descriptor);
+}
+export {
+  register
+};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@windagency/valora-plugin-openrouter",
+  "version": "1.0.0",
+  "description": "OpenRouter provider plugin for Valora — connects to openrouter.ai for unified access to hundreds of LLM models via an OpenAI-compatible API. Requires OPENROUTER_API_KEY.",
+  "keywords": [
+    "valora",
+    "valora-plugin",
+    "ai",
+    "llm",
+    "openrouter",
+    "api-gateway",
+    "cloud-llm",
+    "provider",
+    "open-source",
+    "typescript"
+  ],
+  "author": "Damien TIVELET <damien@wind-agency.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/windagency/valora.ai"
+  },
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "volta": {
+    "node": "22.21.0",
+    "pnpm": "10.19.0"
+  },
+  "files": [
+    "valora-plugin.json",
+    "dist"
+  ],
+  "peerDependencies": {
+    "@windagency/valora": ">=0.1.0",
+    "openai": "^4.67.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.0",
+    "openai": "^4.67.0",
+    "@windagency/valora-plugin-api": "1.0.0"
+  },
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --external:openai --banner:js=\"import { createRequire } from 'module'; const require = createRequire(import.meta.url);\"",
+    "clean": "rm -rf ./dist",
+    "lint": "eslint --color",
+    "lint:fix": "eslint --color --fix",
+    "beautify": "prettier --check \"**/*.+(js|jsx|ts|tsx|json|md|yml|yaml)\"",
+    "beautify:fix": "prettier --write \"**/*.+(js|jsx|ts|tsx|json|md|yml|yaml)\"",
+    "format": "pnpm beautify:fix && pnpm lint:fix",
+    "test": "vitest run"
+  }
+}

package/valora-plugin.json

@@ -0,0 +1,9 @@
+{
+	"name": "valora-plugin-openrouter",
+	"version": "1.0.0",
+	"description": "OpenRouter provider — connects to openrouter.ai for unified access to models via an OpenAI-compatible API. Requires OPENROUTER_API_KEY.",
+	"engines": { "valora": ">=0.1.0" },
+	"contributes": ["code"],
+	"permissions": ["code-exec", "network"],
+	"codeEntrypoint": "dist/index.js"
+}