@antseed/provider-openrouter 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# @antseed/provider-openrouter
+
+Sell OpenRouter API capacity on the Antseed P2P network. Supports multiple LLM providers through a single API key.
+
+## Installation
+
+```bash
+antseed plugin add @antseed/provider-openrouter
+```
+
+## Usage
+
+```bash
+export OPENROUTER_API_KEY=sk-or-...
+antseed seed --provider openrouter
+```
+
+## Configuration
+
+| Key | Type | Required | Default | Description |
+|-----|------|----------|---------|-------------|
+| `OPENROUTER_API_KEY` | secret | Yes | -- | OpenRouter API key |
+| `ANTSEED_INPUT_USD_PER_MILLION` | number | No | 10 | Input token price (USD per 1M) |
+| `ANTSEED_OUTPUT_USD_PER_MILLION` | number | No | 10 | Output token price (USD per 1M) |
+| `ANTSEED_MODEL_PRICING_JSON` | string | No | -- | Per-model pricing as JSON |
+| `ANTSEED_MAX_CONCURRENCY` | number | No | 10 | Max concurrent requests |
+| `ANTSEED_ALLOWED_MODELS` | string[] | No | -- | Comma-separated model allowlist |
+
+## How It Works
+
+Uses `BaseProvider` and `StaticTokenProvider` from `@antseed/provider-core` to relay requests to the OpenRouter API with `Authorization: Bearer` authentication.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { AntseedProviderPlugin } from '@antseed/node';
+declare const plugin: AntseedProviderPlugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAY,MAAM,eAAe,CAAC;AA4CrE,QAAA,MAAM,MAAM,EAAE,qBAuDb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,90 @@
+import { BaseProvider, StaticTokenProvider } from '@antseed/provider-core';
+function parseNonNegativeNumber(raw, key, fallback) {
+    const parsed = raw === undefined ? fallback : Number.parseFloat(raw);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new Error(`${key} must be a non-negative number`);
+    }
+    return parsed;
+}
+function parseModelPricingJson(raw) {
+    if (!raw)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('ANTSEED_MODEL_PRICING_JSON must be valid JSON');
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('ANTSEED_MODEL_PRICING_JSON must be an object map of model -> pricing');
+    }
+    const out = {};
+    for (const [model, pricing] of Object.entries(parsed)) {
+        if (!pricing || typeof pricing !== 'object' || Array.isArray(pricing)) {
+            throw new Error(`Model pricing for "${model}" must be an object`);
+        }
+        const input = pricing['inputUsdPerMillion'];
+        const output = pricing['outputUsdPerMillion'];
+        if (typeof input !== 'number' || !Number.isFinite(input) || input < 0) {
+            throw new Error(`Model pricing for "${model}" requires non-negative inputUsdPerMillion`);
+        }
+        if (typeof output !== 'number' || !Number.isFinite(output) || output < 0) {
+            throw new Error(`Model pricing for "${model}" requires non-negative outputUsdPerMillion`);
+        }
+        out[model] = { inputUsdPerMillion: input, outputUsdPerMillion: output };
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+const plugin = {
+    name: 'openrouter',
+    displayName: 'OpenRouter',
+    version: '0.1.0',
+    type: 'provider',
+    description: 'Sell OpenRouter API capacity to P2P peers',
+    configSchema: [
+        { key: 'OPENROUTER_API_KEY', label: 'API Key', type: 'secret', required: true, description: 'OpenRouter API key' },
+        { key: 'ANTSEED_INPUT_USD_PER_MILLION', label: 'Input Price', type: 'number', required: false, default: 10, description: 'Input price in USD per 1M tokens' },
+        { key: 'ANTSEED_OUTPUT_USD_PER_MILLION', label: 'Output Price', type: 'number', required: false, default: 10, description: 'Output price in USD per 1M tokens' },
+        { key: 'ANTSEED_MODEL_PRICING_JSON', label: 'Model Pricing JSON', type: 'string', required: false, description: 'Per-model pricing JSON' },
+        { key: 'ANTSEED_MAX_CONCURRENCY', label: 'Max Concurrency', type: 'number', required: false, default: 10, description: 'Max concurrent requests' },
+        { key: 'ANTSEED_ALLOWED_MODELS', label: 'Allowed Models', type: 'string[]', required: false, description: 'Model allow-list' },
+    ],
+    createProvider(config) {
+        const apiKey = config['OPENROUTER_API_KEY'] ?? '';
+        if (!apiKey) {
+            throw new Error('OPENROUTER_API_KEY is required');
+        }
+        const modelPricing = parseModelPricingJson(config['ANTSEED_MODEL_PRICING_JSON']);
+        const pricing = {
+            defaults: {
+                inputUsdPerMillion: parseNonNegativeNumber(config['ANTSEED_INPUT_USD_PER_MILLION'], 'ANTSEED_INPUT_USD_PER_MILLION', 10),
+                outputUsdPerMillion: parseNonNegativeNumber(config['ANTSEED_OUTPUT_USD_PER_MILLION'], 'ANTSEED_OUTPUT_USD_PER_MILLION', 10),
+            },
+            ...(modelPricing ? { models: modelPricing } : {}),
+        };
+        const maxConcurrency = parseInt(config['ANTSEED_MAX_CONCURRENCY'] ?? '10', 10);
+        if (Number.isNaN(maxConcurrency)) {
+            throw new Error('ANTSEED_MAX_CONCURRENCY must be a valid number');
+        }
+        const allowedModels = config['ANTSEED_ALLOWED_MODELS']
+            ? config['ANTSEED_ALLOWED_MODELS'].split(',').map((s) => s.trim())
+            : [];
+        const tokenProvider = new StaticTokenProvider(apiKey);
+        return new BaseProvider({
+            name: 'openrouter',
+            models: allowedModels,
+            pricing,
+            relay: {
+                baseUrl: 'https://openrouter.ai/api',
+                authHeaderName: 'authorization',
+                authHeaderValue: `Bearer ${apiKey}`,
+                tokenProvider,
+                maxConcurrency,
+                allowedModels,
+            },
+        });
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@antseed/provider-openrouter",
+  "version": "0.1.0",
+  "description": "OpenRouter provider plugin for Antseed",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@antseed/provider-core": "workspace:*"
+  },
+  "peerDependencies": {
+    "@antseed/node": ">=0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@antseed/node": "workspace:*"
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import plugin from './index.js';
+
+describe('provider-openrouter plugin', () => {
+  it('has correct name and metadata', () => {
+    expect(plugin.name).toBe('openrouter');
+    expect(plugin.displayName).toBe('OpenRouter');
+    expect(plugin.type).toBe('provider');
+    expect(plugin.version).toBe('0.1.0');
+  });
+
+  it('has configSchema with expected fields', () => {
+    const keys = plugin.configSchema!.map((f) => f.key);
+    expect(keys).toContain('OPENROUTER_API_KEY');
+    expect(keys).toContain('ANTSEED_INPUT_USD_PER_MILLION');
+    expect(keys).toContain('ANTSEED_OUTPUT_USD_PER_MILLION');
+    expect(keys).toContain('ANTSEED_MAX_CONCURRENCY');
+    expect(keys).toContain('ANTSEED_ALLOWED_MODELS');
+  });
+
+  it('creates provider with valid config', () => {
+    const provider = plugin.createProvider({
+      OPENROUTER_API_KEY: 'sk-or-test-key',
+    });
+    expect(provider.name).toBe('openrouter');
+    expect(provider.pricing.defaults.inputUsdPerMillion).toBe(10);
+    expect(provider.pricing.defaults.outputUsdPerMillion).toBe(10);
+    expect(provider.maxConcurrency).toBe(10);
+  });
+
+  it('requires API key', () => {
+    expect(() => plugin.createProvider({})).toThrow('OPENROUTER_API_KEY is required');
+  });
+
+  it('applies custom pricing and concurrency', () => {
+    const provider = plugin.createProvider({
+      OPENROUTER_API_KEY: 'sk-or-test-key',
+      ANTSEED_INPUT_USD_PER_MILLION: '3',
+      ANTSEED_OUTPUT_USD_PER_MILLION: '7',
+      ANTSEED_MAX_CONCURRENCY: '5',
+    });
+    expect(provider.pricing.defaults.inputUsdPerMillion).toBe(3);
+    expect(provider.pricing.defaults.outputUsdPerMillion).toBe(7);
+    expect(provider.maxConcurrency).toBe(5);
+  });
+});

package/src/index.ts

@@ -0,0 +1,102 @@
+import type { AntseedProviderPlugin, Provider } from '@antseed/node';
+import { BaseProvider, StaticTokenProvider } from '@antseed/provider-core';
+
+function parseNonNegativeNumber(raw: string | undefined, key: string, fallback: number): number {
+  const parsed = raw === undefined ? fallback : Number.parseFloat(raw);
+  if (!Number.isFinite(parsed) || parsed < 0) {
+    throw new Error(`${key} must be a non-negative number`);
+  }
+  return parsed;
+}
+
+function parseModelPricingJson(raw: string | undefined): Provider['pricing']['models'] {
+  if (!raw) return undefined;
+
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(raw) as unknown;
+  } catch {
+    throw new Error('ANTSEED_MODEL_PRICING_JSON must be valid JSON');
+  }
+
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    throw new Error('ANTSEED_MODEL_PRICING_JSON must be an object map of model -> pricing');
+  }
+
+  const out: NonNullable<Provider['pricing']['models']> = {};
+  for (const [model, pricing] of Object.entries(parsed as Record<string, unknown>)) {
+    if (!pricing || typeof pricing !== 'object' || Array.isArray(pricing)) {
+      throw new Error(`Model pricing for "${model}" must be an object`);
+    }
+    const input = (pricing as Record<string, unknown>)['inputUsdPerMillion'];
+    const output = (pricing as Record<string, unknown>)['outputUsdPerMillion'];
+    if (typeof input !== 'number' || !Number.isFinite(input) || input < 0) {
+      throw new Error(`Model pricing for "${model}" requires non-negative inputUsdPerMillion`);
+    }
+    if (typeof output !== 'number' || !Number.isFinite(output) || output < 0) {
+      throw new Error(`Model pricing for "${model}" requires non-negative outputUsdPerMillion`);
+    }
+    out[model] = { inputUsdPerMillion: input, outputUsdPerMillion: output };
+  }
+
+  return Object.keys(out).length > 0 ? out : undefined;
+}
+
+const plugin: AntseedProviderPlugin = {
+  name: 'openrouter',
+  displayName: 'OpenRouter',
+  version: '0.1.0',
+  type: 'provider',
+  description: 'Sell OpenRouter API capacity to P2P peers',
+  configSchema: [
+    { key: 'OPENROUTER_API_KEY', label: 'API Key', type: 'secret', required: true, description: 'OpenRouter API key' },
+    { key: 'ANTSEED_INPUT_USD_PER_MILLION', label: 'Input Price', type: 'number', required: false, default: 10, description: 'Input price in USD per 1M tokens' },
+    { key: 'ANTSEED_OUTPUT_USD_PER_MILLION', label: 'Output Price', type: 'number', required: false, default: 10, description: 'Output price in USD per 1M tokens' },
+    { key: 'ANTSEED_MODEL_PRICING_JSON', label: 'Model Pricing JSON', type: 'string', required: false, description: 'Per-model pricing JSON' },
+    { key: 'ANTSEED_MAX_CONCURRENCY', label: 'Max Concurrency', type: 'number', required: false, default: 10, description: 'Max concurrent requests' },
+    { key: 'ANTSEED_ALLOWED_MODELS', label: 'Allowed Models', type: 'string[]', required: false, description: 'Model allow-list' },
+  ],
+
+  createProvider(config: Record<string, string>): Provider {
+    const apiKey = config['OPENROUTER_API_KEY'] ?? '';
+    if (!apiKey) {
+      throw new Error('OPENROUTER_API_KEY is required');
+    }
+
+    const modelPricing = parseModelPricingJson(config['ANTSEED_MODEL_PRICING_JSON']);
+    const pricing: Provider['pricing'] = {
+      defaults: {
+        inputUsdPerMillion: parseNonNegativeNumber(config['ANTSEED_INPUT_USD_PER_MILLION'], 'ANTSEED_INPUT_USD_PER_MILLION', 10),
+        outputUsdPerMillion: parseNonNegativeNumber(config['ANTSEED_OUTPUT_USD_PER_MILLION'], 'ANTSEED_OUTPUT_USD_PER_MILLION', 10),
+      },
+      ...(modelPricing ? { models: modelPricing } : {}),
+    };
+
+    const maxConcurrency = parseInt(config['ANTSEED_MAX_CONCURRENCY'] ?? '10', 10);
+    if (Number.isNaN(maxConcurrency)) {
+      throw new Error('ANTSEED_MAX_CONCURRENCY must be a valid number');
+    }
+
+    const allowedModels = config['ANTSEED_ALLOWED_MODELS']
+      ? config['ANTSEED_ALLOWED_MODELS'].split(',').map((s: string) => s.trim())
+      : [];
+
+    const tokenProvider = new StaticTokenProvider(apiKey);
+
+    return new BaseProvider({
+      name: 'openrouter',
+      models: allowedModels,
+      pricing,
+      relay: {
+        baseUrl: 'https://openrouter.ai/api',
+        authHeaderName: 'authorization',
+        authHeaderValue: `Bearer ${apiKey}`,
+        tokenProvider,
+        maxConcurrency,
+        allowedModels,
+      },
+    });
+  },
+};
+
+export default plugin;

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["src/**/*.test.ts"]
+}