@namzu/openrouter 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to `@namzu/openrouter` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] — 2026-04-15
+
+### Added
+
+- Initial release. OpenRouterProvider extracted from @namzu/sdk core per ADR-0001.
+- OpenAI-compatible Chat Completions API (chat + chatStream) via native fetch.
+- Tool-use + function calling support.
+- `registerOpenRouter()` helper for one-call provider registration.
+- Module augmentation of @namzu/sdk's ProviderConfigRegistry for type-safe config.
+
+### Changed
+
+- Observability (OTEL spans, structured logging) removed pending @namzu/telemetry package.

package/LICENSE.md

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 Cogitave
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+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,91 @@
+# @namzu/openrouter
+
+OpenRouter LLM provider for [`@namzu/sdk`](https://www.npmjs.com/package/@namzu/sdk). Thin `fetch`-based wrapper around OpenRouter's **OpenAI-compatible Chat Completions API** (chat + streaming) with full tool-use support, conformant to the `LLMProvider` contract. Gives you access to 200+ models — Claude, GPT-4, Llama, Mixtral, Gemini, and more — through a single unified API and billing account.
+
+## Install
+
+```bash
+pnpm add @namzu/sdk @namzu/openrouter
+```
+
+`@namzu/openrouter` declares `@namzu/sdk` as a peer dependency. Install both. The provider has **zero runtime dependencies** — it talks to OpenRouter with native `fetch`.
+
+## Usage
+
+```ts
+import { ProviderRegistry } from '@namzu/sdk'
+import { registerOpenRouter } from '@namzu/openrouter'
+
+// Register once at app startup.
+registerOpenRouter()
+
+// Fully typed via module augmentation: ProviderConfigRegistry['openrouter'].
+const { provider, capabilities } = ProviderRegistry.create({
+  type: 'openrouter',
+  apiKey: process.env.OPENROUTER_API_KEY!,
+  siteUrl: 'https://myapp.example',   // optional — shown on OpenRouter analytics
+  siteName: 'My App',                 // optional — shown on OpenRouter analytics
+})
+
+const response = await provider.chat({
+  model: 'anthropic/claude-sonnet-4',
+  messages: [{ role: 'user', content: 'Hello' }],
+})
+```
+
+Streaming:
+
+```ts
+for await (const chunk of provider.chatStream({
+  model: 'openai/gpt-4o',
+  messages: [{ role: 'user', content: 'Tell me a story' }],
+})) {
+  if (chunk.delta.content) process.stdout.write(chunk.delta.content)
+}
+```
+
+## Authentication
+
+Get an API key at [openrouter.ai/keys](https://openrouter.ai/keys). Pass it to the provider via the `apiKey` field, or read it from `process.env.OPENROUTER_API_KEY` in your app before constructing the config.
+
+## Models
+
+OpenRouter exposes 200+ models from every major vendor under one unified API. See the [OpenRouter model catalog](https://openrouter.ai/models) for the full list and current pricing. Identifiers follow the `vendor/model-name` pattern:
+
+- `anthropic/claude-sonnet-4`
+- `anthropic/claude-haiku-4`
+- `openai/gpt-4o`
+- `openai/gpt-4o-mini`
+- `meta-llama/llama-3.3-70b-instruct`
+- `mistralai/mixtral-8x22b-instruct`
+- `google/gemini-pro-1.5`
+
+Pricing is per-million tokens on OpenRouter's catalog — the provider's `listModels()` returns live pricing pulled from the `/models` endpoint.
+
+## Base URL override
+
+The OpenRouter endpoint defaults to `https://openrouter.ai/api/v1`. Override via the `baseUrl` config field or the `OPENROUTER_BASE_URL` environment variable — useful for OpenRouter-compatible self-hosted gateways.
+
+## Capabilities
+
+```ts
+import { OPENROUTER_CAPABILITIES } from '@namzu/openrouter'
+
+// {
+//   supportsTools: true,
+//   supportsStreaming: true,
+//   supportsFunctionCalling: true,
+// }
+```
+
+## OpenAI compatibility
+
+Because OpenRouter speaks the OpenAI Chat Completions dialect, this provider can also target any OpenAI-compatible endpoint (vLLM, LM Studio, Groq, local OpenAI-compat gateways) by passing `baseUrl` pointing at the alternate endpoint. For a zero-config generic OpenAI-compatible client, use the forthcoming `@namzu/http` package instead.
+
+## Observability
+
+This package ships without observability hooks in `0.1.x`. OpenTelemetry span emission and structured logging are roadmapped for the forthcoming `@namzu/telemetry` package — a separate opt-in dependency that wraps any `LLMProvider` to emit GenAI semantic-convention spans. Track progress in the [Namzu roadmap](https://github.com/cogitave/namzu).
+
+## License
+
+FSL-1.1-MIT. Same as `@namzu/sdk`.

package/dist/__tests__/openrouter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openrouter.test.d.ts.map

package/dist/__tests__/openrouter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/openrouter.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/openrouter.test.js

@@ -0,0 +1,58 @@
+import { DuplicateProviderError, ProviderRegistry } from '@namzu/sdk';
+import { beforeEach, describe, expect, it } from 'vitest';
+import { OPENROUTER_CAPABILITIES, OpenRouterProvider, registerOpenRouter } from '../index.js';
+// Ensure a clean slate between tests. The sdk pre-registers 'mock' on import
+// via its sideEffects whitelist; we only need to clear 'openrouter' to make
+// re-registration deterministic across tests.
+beforeEach(() => {
+    if (ProviderRegistry.isSupported('openrouter')) {
+        ProviderRegistry.unregister('openrouter');
+    }
+});
+describe('@namzu/openrouter', () => {
+    describe('registerOpenRouter()', () => {
+        it("adds 'openrouter' to the ProviderRegistry", () => {
+            expect(ProviderRegistry.isSupported('openrouter')).toBe(false);
+            registerOpenRouter();
+            expect(ProviderRegistry.isSupported('openrouter')).toBe(true);
+            expect(ProviderRegistry.listTypes()).toContain('openrouter');
+        });
+        it('throws DuplicateProviderError when called twice without options', () => {
+            registerOpenRouter();
+            expect(() => registerOpenRouter()).toThrowError(DuplicateProviderError);
+        });
+        it('allows re-registration when { replace: true } is passed', () => {
+            registerOpenRouter();
+            expect(() => registerOpenRouter({ replace: true })).not.toThrow();
+            expect(ProviderRegistry.isSupported('openrouter')).toBe(true);
+        });
+        it('exposes capabilities through the registry after registration', () => {
+            registerOpenRouter();
+            const caps = ProviderRegistry.getCapabilities('openrouter');
+            expect(caps).toEqual(OPENROUTER_CAPABILITIES);
+        });
+    });
+    describe('OPENROUTER_CAPABILITIES', () => {
+        it('declares the expected capability flags', () => {
+            expect(OPENROUTER_CAPABILITIES).toEqual({
+                supportsTools: true,
+                supportsStreaming: true,
+                supportsFunctionCalling: true,
+            });
+        });
+    });
+    describe('ProviderRegistry.create({ type: "openrouter", ... })', () => {
+        it('narrows the config type via module augmentation and instantiates OpenRouterProvider', () => {
+            registerOpenRouter();
+            const { provider, capabilities } = ProviderRegistry.create({
+                type: 'openrouter',
+                apiKey: 'test-key',
+                siteUrl: 'https://example.com',
+                siteName: 'Test',
+            });
+            expect(provider).toBeInstanceOf(OpenRouterProvider);
+            expect(capabilities).toEqual(OPENROUTER_CAPABILITIES);
+        });
+    });
+});
+//# sourceMappingURL=openrouter.test.js.map

package/dist/__tests__/openrouter.test.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+import type { ChatCompletionParams, ChatCompletionResponse, LLMProvider, ModelInfo, StreamChunk } from '@namzu/sdk';
+import type { OpenRouterConfig } from './types.js';
+export declare class OpenRouterProvider implements LLMProvider {
+    readonly id = "openrouter";
+    readonly name = "OpenRouter";
+    private config;
+    private baseUrl;
+    constructor(config: OpenRouterConfig);
+    private getHeaders;
+    private formatMessages;
+    private buildRequestBody;
+    chat(params: ChatCompletionParams): Promise<ChatCompletionResponse>;
+    chatStream(params: ChatCompletionParams): AsyncIterable<StreamChunk>;
+    listModels(): Promise<ModelInfo[]>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,SAAS,EACT,WAAW,EAGX,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAwClD,qBAAa,kBAAmB,YAAW,WAAW;IACrD,QAAQ,CAAC,EAAE,gBAAe;IAC1B,QAAQ,CAAC,IAAI,gBAAe;IAE5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAQ;gBAEX,MAAM,EAAE,gBAAgB;IAQpC,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,gBAAgB;IAqClB,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA2DlE,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,aAAa,CAAC,WAAW,CAAC;IAyFrE,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA+BlC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAWrC"}

package/dist/client.js

@@ -0,0 +1,248 @@
+const OPENROUTER_BASE_URL = process.env.OPENROUTER_BASE_URL ?? 'https://openrouter.ai/api/v1';
+function parseUsage(raw) {
+    if (!raw) {
+        return {
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+            cachedTokens: 0,
+            cacheWriteTokens: 0,
+        };
+    }
+    return {
+        promptTokens: raw.prompt_tokens,
+        completionTokens: raw.completion_tokens,
+        totalTokens: raw.total_tokens,
+        cachedTokens: raw.prompt_tokens_details?.cached_tokens ?? raw.cache_read_input_tokens ?? 0,
+        cacheWriteTokens: raw.cache_creation_input_tokens ?? 0,
+    };
+}
+function formatToolChoice(tc) {
+    if (typeof tc === 'string')
+        return tc;
+    return tc;
+}
+export class OpenRouterProvider {
+    id = 'openrouter';
+    name = 'OpenRouter';
+    config;
+    baseUrl;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('OpenRouter API key is required. Set OPENROUTER_API_KEY env variable.');
+        }
+        this.config = config;
+        this.baseUrl = config.baseUrl ?? OPENROUTER_BASE_URL;
+    }
+    getHeaders() {
+        const headers = {
+            Authorization: `Bearer ${this.config.apiKey}`,
+            'Content-Type': 'application/json',
+        };
+        if (this.config.siteUrl) {
+            headers['HTTP-Referer'] = this.config.siteUrl;
+        }
+        if (this.config.siteName) {
+            headers['X-Title'] = this.config.siteName;
+        }
+        return headers;
+    }
+    formatMessages(messages) {
+        return messages.map((msg) => {
+            if (msg.role === 'tool') {
+                return {
+                    role: 'tool',
+                    content: msg.content,
+                    tool_call_id: msg.toolCallId,
+                };
+            }
+            if (msg.role === 'assistant' && 'toolCalls' in msg && msg.toolCalls) {
+                return {
+                    role: 'assistant',
+                    content: msg.content,
+                    tool_calls: msg.toolCalls.map((tc) => ({
+                        id: tc.id,
+                        type: tc.type,
+                        function: tc.function,
+                    })),
+                };
+            }
+            return { role: msg.role, content: msg.content };
+        });
+    }
+    buildRequestBody(params, stream) {
+        const body = {
+            model: params.model,
+            messages: this.formatMessages(params.messages),
+            stream,
+        };
+        if (params.tools && params.tools.length > 0) {
+            body.tools = params.tools;
+        }
+        if (params.toolChoice !== undefined) {
+            body.tool_choice = formatToolChoice(params.toolChoice);
+        }
+        if (params.parallelToolCalls !== undefined) {
+            body.parallel_tool_calls = params.parallelToolCalls;
+        }
+        if (params.temperature !== undefined)
+            body.temperature = params.temperature;
+        if (params.maxTokens !== undefined)
+            body.max_tokens = params.maxTokens;
+        if (params.topP !== undefined)
+            body.top_p = params.topP;
+        if (params.topK !== undefined)
+            body.top_k = params.topK;
+        if (params.frequencyPenalty !== undefined)
+            body.frequency_penalty = params.frequencyPenalty;
+        if (params.presencePenalty !== undefined)
+            body.presence_penalty = params.presencePenalty;
+        if (params.repetitionPenalty !== undefined)
+            body.repetition_penalty = params.repetitionPenalty;
+        if (params.stop)
+            body.stop = params.stop;
+        if (params.cacheControl) {
+            body.cache_control = params.cacheControl;
+        }
+        if (params.responseFormat) {
+            body.response_format = params.responseFormat;
+        }
+        return body;
+    }
+    async chat(params) {
+        const body = this.buildRequestBody(params, false);
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: this.getHeaders(),
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(this.config.timeout ?? 120_000),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`OpenRouter API error (${response.status}): ${errorBody}`);
+        }
+        const data = (await response.json());
+        const choice = data.choices[0];
+        if (!choice) {
+            throw new Error('OpenRouter returned empty choices');
+        }
+        const usage = parseUsage(data.usage);
+        const result = {
+            id: data.id,
+            model: data.model,
+            message: {
+                role: 'assistant',
+                content: choice.message.content,
+                toolCalls: choice.message.tool_calls?.map((tc) => ({
+                    id: tc.id,
+                    type: 'function',
+                    function: tc.function,
+                })),
+            },
+            finishReason: choice.finish_reason,
+            usage,
+        };
+        return result;
+    }
+    async *chatStream(params) {
+        const body = this.buildRequestBody(params, true);
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: this.getHeaders(),
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(this.config.timeout ?? 120_000),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`OpenRouter API error (${response.status}): ${errorBody}`);
+        }
+        if (!response.body) {
+            throw new Error('OpenRouter returned no stream body');
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed || !trimmed.startsWith('data: '))
+                        continue;
+                    const data = trimmed.slice(6);
+                    if (data === '[DONE]')
+                        return;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const choice = parsed.choices[0];
+                        if (!choice)
+                            continue;
+                        yield {
+                            id: parsed.id,
+                            delta: {
+                                content: choice.delta.content,
+                                toolCalls: choice.delta.tool_calls?.map((tc) => ({
+                                    index: tc.index,
+                                    id: tc.id,
+                                    type: tc.type,
+                                    function: tc.function,
+                                })),
+                            },
+                            finishReason: choice.finish_reason,
+                            usage: parsed.usage ? parseUsage(parsed.usage) : undefined,
+                        };
+                    }
+                    catch (parseErr) {
+                        yield {
+                            id: '',
+                            delta: { content: undefined },
+                            finishReason: undefined,
+                            usage: undefined,
+                            error: `Stream parse error: ${parseErr instanceof Error ? parseErr.message : String(parseErr)}`,
+                        };
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async listModels() {
+        const response = await fetch(`${this.baseUrl}/models`, {
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to list models: ${response.status}`);
+        }
+        const data = (await response.json());
+        return data.data.map((m) => ({
+            id: m.id,
+            name: m.name,
+            contextWindow: m.context_length,
+            maxOutputTokens: m.top_provider?.max_completion_tokens ?? 4096,
+            inputPrice: Number.parseFloat(m.pricing?.prompt ?? '0') * 1_000_000,
+            outputPrice: Number.parseFloat(m.pricing?.completion ?? '0') * 1_000_000,
+            supportsToolUse: true,
+            supportsStreaming: true,
+        }));
+    }
+    async healthCheck() {
+        try {
+            const response = await fetch(`${this.baseUrl}/models`, {
+                headers: this.getHeaders(),
+                signal: AbortSignal.timeout(5000),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { type ProviderCapabilities, type RegisterOptions } from '@namzu/sdk';
+import type { OpenRouterProviderConfig } from './types.js';
+declare module '@namzu/sdk' {
+    interface ProviderConfigRegistry {
+        openrouter: OpenRouterProviderConfig;
+    }
+}
+export declare const OPENROUTER_CAPABILITIES: ProviderCapabilities;
+/**
+ * Register `OpenRouterProvider` under the `'openrouter'` type in `@namzu/sdk`'s
+ * `ProviderRegistry`. Call once at app startup before
+ * `ProviderRegistry.create({ type: 'openrouter', ... })`.
+ *
+ * Throws `DuplicateProviderError` if `'openrouter'` is already registered.
+ * Pass `{ replace: true }` to override.
+ */
+export declare function registerOpenRouter(options?: RegisterOptions): void;
+export { OpenRouterProvider } from './client.js';
+export type { OpenRouterConfig, OpenRouterProviderConfig } from './types.js';
+//# 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,EAAE,KAAK,oBAAoB,EAAoB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAE9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAK1D,OAAO,QAAQ,YAAY,CAAC;IAC3B,UAAU,sBAAsB;QAC/B,UAAU,EAAE,wBAAwB,CAAA;KACpC;CACD;AAED,eAAO,MAAM,uBAAuB,EAAE,oBAIrC,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAElE;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,20 @@
+import { ProviderRegistry } from '@namzu/sdk';
+import { OpenRouterProvider } from './client.js';
+export const OPENROUTER_CAPABILITIES = {
+    supportsTools: true,
+    supportsStreaming: true,
+    supportsFunctionCalling: true,
+};
+/**
+ * Register `OpenRouterProvider` under the `'openrouter'` type in `@namzu/sdk`'s
+ * `ProviderRegistry`. Call once at app startup before
+ * `ProviderRegistry.create({ type: 'openrouter', ... })`.
+ *
+ * Throws `DuplicateProviderError` if `'openrouter'` is already registered.
+ * Pass `{ replace: true }` to override.
+ */
+export function registerOpenRouter(options) {
+    ProviderRegistry.register('openrouter', OpenRouterProvider, OPENROUTER_CAPABILITIES, options);
+}
+export { OpenRouterProvider } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,gBAAgB,EAAwB,MAAM,YAAY,CAAA;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAYhD,MAAM,CAAC,MAAM,uBAAuB,GAAyB;IAC5D,aAAa,EAAE,IAAI;IACnB,iBAAiB,EAAE,IAAI;IACvB,uBAAuB,EAAE,IAAI;CAC7B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAyB;IAC3D,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,OAAO,CAAC,CAAA;AAC9F,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenRouter-specific provider config shapes.
+ *
+ * `OpenRouterConfig` is the constructor input for `OpenRouterProvider` (no
+ * discriminator). `OpenRouterProviderConfig` is the shape the consumer passes
+ * to `ProviderRegistry.create({ type: 'openrouter', ... })` — it extends
+ * `OpenRouterConfig` with the `type: 'openrouter'` discriminator for the
+ * registry's generic narrowing.
+ */
+export interface OpenRouterConfig {
+    apiKey: string;
+    baseUrl?: string;
+    siteUrl?: string;
+    siteName?: string;
+    timeout?: number;
+}
+export interface OpenRouterProviderConfig extends OpenRouterConfig {
+    type: 'openrouter';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IACjE,IAAI,EAAE,YAAY,CAAA;CAClB"}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * OpenRouter-specific provider config shapes.
+ *
+ * `OpenRouterConfig` is the constructor input for `OpenRouterProvider` (no
+ * discriminator). `OpenRouterProviderConfig` is the shape the consumer passes
+ * to `ProviderRegistry.create({ type: 'openrouter', ... })` — it extends
+ * `OpenRouterConfig` with the `type: 'openrouter'` discriminator for the
+ * registry's generic narrowing.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@namzu/openrouter",
+  "version": "0.0.1",
+  "description": "OpenRouter LLM provider for @namzu/sdk. Access to 200+ models (Claude, GPT-4, Llama, Mixtral) via OpenRouter's unified API.",
+  "license": "FSL-1.1-MIT",
+  "type": "module",
+  "homepage": "https://github.com/cogitave/namzu#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cogitave/namzu.git",
+    "directory": "packages/providers/openrouter"
+  },
+  "bugs": {
+    "url": "https://github.com/cogitave/namzu/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE.md",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@namzu/sdk": "^1 || ^0.1.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^22.19.17",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@namzu/sdk": "^0.1.8"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "dev": "tsc --build --watch",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "format": "biome format --write src/",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "verify": "bash scripts/verify.sh",
+    "release:patch": "bash scripts/release.sh patch",
+    "release:minor": "bash scripts/release.sh minor",
+    "release:major": "bash scripts/release.sh major",
+    "release:rc": "bash scripts/release.sh rc",
+    "release:beta": "bash scripts/release.sh beta",
+    "release:stable": "bash scripts/release.sh stable",
+    "release:dry": "bash scripts/release.sh patch --dry-run"
+  }
+}

package/src/__tests__/openrouter.test.ts

@@ -0,0 +1,64 @@
+import { DuplicateProviderError, ProviderRegistry } from '@namzu/sdk'
+import { beforeEach, describe, expect, it } from 'vitest'
+import { OPENROUTER_CAPABILITIES, OpenRouterProvider, registerOpenRouter } from '../index.js'
+
+// Ensure a clean slate between tests. The sdk pre-registers 'mock' on import
+// via its sideEffects whitelist; we only need to clear 'openrouter' to make
+// re-registration deterministic across tests.
+beforeEach(() => {
+	if (ProviderRegistry.isSupported('openrouter')) {
+		ProviderRegistry.unregister('openrouter')
+	}
+})
+
+describe('@namzu/openrouter', () => {
+	describe('registerOpenRouter()', () => {
+		it("adds 'openrouter' to the ProviderRegistry", () => {
+			expect(ProviderRegistry.isSupported('openrouter')).toBe(false)
+			registerOpenRouter()
+			expect(ProviderRegistry.isSupported('openrouter')).toBe(true)
+			expect(ProviderRegistry.listTypes()).toContain('openrouter')
+		})
+
+		it('throws DuplicateProviderError when called twice without options', () => {
+			registerOpenRouter()
+			expect(() => registerOpenRouter()).toThrowError(DuplicateProviderError)
+		})
+
+		it('allows re-registration when { replace: true } is passed', () => {
+			registerOpenRouter()
+			expect(() => registerOpenRouter({ replace: true })).not.toThrow()
+			expect(ProviderRegistry.isSupported('openrouter')).toBe(true)
+		})
+
+		it('exposes capabilities through the registry after registration', () => {
+			registerOpenRouter()
+			const caps = ProviderRegistry.getCapabilities('openrouter')
+			expect(caps).toEqual(OPENROUTER_CAPABILITIES)
+		})
+	})
+
+	describe('OPENROUTER_CAPABILITIES', () => {
+		it('declares the expected capability flags', () => {
+			expect(OPENROUTER_CAPABILITIES).toEqual({
+				supportsTools: true,
+				supportsStreaming: true,
+				supportsFunctionCalling: true,
+			})
+		})
+	})
+
+	describe('ProviderRegistry.create({ type: "openrouter", ... })', () => {
+		it('narrows the config type via module augmentation and instantiates OpenRouterProvider', () => {
+			registerOpenRouter()
+			const { provider, capabilities } = ProviderRegistry.create({
+				type: 'openrouter',
+				apiKey: 'test-key',
+				siteUrl: 'https://example.com',
+				siteName: 'Test',
+			})
+			expect(provider).toBeInstanceOf(OpenRouterProvider)
+			expect(capabilities).toEqual(OPENROUTER_CAPABILITIES)
+		})
+	})
+})

package/src/client.ts

@@ -0,0 +1,330 @@
+import type {
+	ChatCompletionParams,
+	ChatCompletionResponse,
+	LLMProvider,
+	ModelInfo,
+	StreamChunk,
+	TokenUsage,
+	ToolChoice,
+} from '@namzu/sdk'
+import type { OpenRouterConfig } from './types.js'
+
+const OPENROUTER_BASE_URL = process.env.OPENROUTER_BASE_URL ?? 'https://openrouter.ai/api/v1'
+
+interface RawUsage {
+	prompt_tokens: number
+	completion_tokens: number
+	total_tokens: number
+	prompt_tokens_details?: {
+		cached_tokens?: number
+	}
+	cache_discount?: number
+	cache_read_input_tokens?: number
+	cache_creation_input_tokens?: number
+}
+
+function parseUsage(raw?: RawUsage): TokenUsage {
+	if (!raw) {
+		return {
+			promptTokens: 0,
+			completionTokens: 0,
+			totalTokens: 0,
+			cachedTokens: 0,
+			cacheWriteTokens: 0,
+		}
+	}
+	return {
+		promptTokens: raw.prompt_tokens,
+		completionTokens: raw.completion_tokens,
+		totalTokens: raw.total_tokens,
+		cachedTokens: raw.prompt_tokens_details?.cached_tokens ?? raw.cache_read_input_tokens ?? 0,
+		cacheWriteTokens: raw.cache_creation_input_tokens ?? 0,
+	}
+}
+
+function formatToolChoice(tc: ToolChoice): unknown {
+	if (typeof tc === 'string') return tc
+	return tc
+}
+
+export class OpenRouterProvider implements LLMProvider {
+	readonly id = 'openrouter'
+	readonly name = 'OpenRouter'
+
+	private config: OpenRouterConfig
+	private baseUrl: string
+
+	constructor(config: OpenRouterConfig) {
+		if (!config.apiKey) {
+			throw new Error('OpenRouter API key is required. Set OPENROUTER_API_KEY env variable.')
+		}
+		this.config = config
+		this.baseUrl = config.baseUrl ?? OPENROUTER_BASE_URL
+	}
+
+	private getHeaders(): Record<string, string> {
+		const headers: Record<string, string> = {
+			Authorization: `Bearer ${this.config.apiKey}`,
+			'Content-Type': 'application/json',
+		}
+		if (this.config.siteUrl) {
+			headers['HTTP-Referer'] = this.config.siteUrl
+		}
+		if (this.config.siteName) {
+			headers['X-Title'] = this.config.siteName
+		}
+		return headers
+	}
+
+	private formatMessages(messages: ChatCompletionParams['messages']): unknown[] {
+		return messages.map((msg) => {
+			if (msg.role === 'tool') {
+				return {
+					role: 'tool',
+					content: msg.content,
+					tool_call_id: (msg as { toolCallId?: string }).toolCallId,
+				}
+			}
+			if (msg.role === 'assistant' && 'toolCalls' in msg && msg.toolCalls) {
+				return {
+					role: 'assistant',
+					content: msg.content,
+					tool_calls: msg.toolCalls.map((tc) => ({
+						id: tc.id,
+						type: tc.type,
+						function: tc.function,
+					})),
+				}
+			}
+			return { role: msg.role, content: msg.content }
+		})
+	}
+
+	private buildRequestBody(params: ChatCompletionParams, stream: boolean): Record<string, unknown> {
+		const body: Record<string, unknown> = {
+			model: params.model,
+			messages: this.formatMessages(params.messages),
+			stream,
+		}
+
+		if (params.tools && params.tools.length > 0) {
+			body.tools = params.tools
+		}
+		if (params.toolChoice !== undefined) {
+			body.tool_choice = formatToolChoice(params.toolChoice)
+		}
+		if (params.parallelToolCalls !== undefined) {
+			body.parallel_tool_calls = params.parallelToolCalls
+		}
+
+		if (params.temperature !== undefined) body.temperature = params.temperature
+		if (params.maxTokens !== undefined) body.max_tokens = params.maxTokens
+		if (params.topP !== undefined) body.top_p = params.topP
+		if (params.topK !== undefined) body.top_k = params.topK
+		if (params.frequencyPenalty !== undefined) body.frequency_penalty = params.frequencyPenalty
+		if (params.presencePenalty !== undefined) body.presence_penalty = params.presencePenalty
+		if (params.repetitionPenalty !== undefined) body.repetition_penalty = params.repetitionPenalty
+		if (params.stop) body.stop = params.stop
+
+		if (params.cacheControl) {
+			body.cache_control = params.cacheControl
+		}
+
+		if (params.responseFormat) {
+			body.response_format = params.responseFormat
+		}
+
+		return body
+	}
+
+	async chat(params: ChatCompletionParams): Promise<ChatCompletionResponse> {
+		const body = this.buildRequestBody(params, false)
+
+		const response = await fetch(`${this.baseUrl}/chat/completions`, {
+			method: 'POST',
+			headers: this.getHeaders(),
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(this.config.timeout ?? 120_000),
+		})
+
+		if (!response.ok) {
+			const errorBody = await response.text()
+			throw new Error(`OpenRouter API error (${response.status}): ${errorBody}`)
+		}
+
+		const data = (await response.json()) as {
+			id: string
+			model: string
+			choices: Array<{
+				message: {
+					role: string
+					content: string | null
+					tool_calls?: Array<{
+						id: string
+						type: string
+						function: { name: string; arguments: string }
+					}>
+				}
+				finish_reason: string
+			}>
+			usage?: RawUsage
+		}
+
+		const choice = data.choices[0]
+		if (!choice) {
+			throw new Error('OpenRouter returned empty choices')
+		}
+
+		const usage = parseUsage(data.usage)
+
+		const result: ChatCompletionResponse = {
+			id: data.id,
+			model: data.model,
+			message: {
+				role: 'assistant',
+				content: choice.message.content,
+				toolCalls: choice.message.tool_calls?.map((tc) => ({
+					id: tc.id,
+					type: 'function' as const,
+					function: tc.function,
+				})),
+			},
+			finishReason: choice.finish_reason as ChatCompletionResponse['finishReason'],
+			usage,
+		}
+
+		return result
+	}
+
+	async *chatStream(params: ChatCompletionParams): AsyncIterable<StreamChunk> {
+		const body = this.buildRequestBody(params, true)
+
+		const response = await fetch(`${this.baseUrl}/chat/completions`, {
+			method: 'POST',
+			headers: this.getHeaders(),
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(this.config.timeout ?? 120_000),
+		})
+
+		if (!response.ok) {
+			const errorBody = await response.text()
+			throw new Error(`OpenRouter API error (${response.status}): ${errorBody}`)
+		}
+
+		if (!response.body) {
+			throw new Error('OpenRouter returned no stream body')
+		}
+
+		const reader = response.body.getReader()
+		const decoder = new TextDecoder()
+		let buffer = ''
+
+		try {
+			while (true) {
+				const { done, value } = await reader.read()
+				if (done) break
+
+				buffer += decoder.decode(value, { stream: true })
+				const lines = buffer.split('\n')
+				buffer = lines.pop() ?? ''
+
+				for (const line of lines) {
+					const trimmed = line.trim()
+					if (!trimmed || !trimmed.startsWith('data: ')) continue
+					const data = trimmed.slice(6)
+					if (data === '[DONE]') return
+
+					try {
+						const parsed = JSON.parse(data) as {
+							id: string
+							choices: Array<{
+								delta: {
+									content?: string
+									tool_calls?: Array<{
+										index: number
+										id?: string
+										type?: string
+										function?: { name?: string; arguments?: string }
+									}>
+								}
+								finish_reason?: string
+							}>
+							usage?: RawUsage
+						}
+
+						const choice = parsed.choices[0]
+						if (!choice) continue
+
+						yield {
+							id: parsed.id,
+							delta: {
+								content: choice.delta.content,
+								toolCalls: choice.delta.tool_calls?.map((tc) => ({
+									index: tc.index,
+									id: tc.id,
+									type: tc.type as 'function' | undefined,
+									function: tc.function,
+								})),
+							},
+							finishReason: choice.finish_reason as StreamChunk['finishReason'],
+							usage: parsed.usage ? parseUsage(parsed.usage) : undefined,
+						}
+					} catch (parseErr) {
+						yield {
+							id: '',
+							delta: { content: undefined },
+							finishReason: undefined,
+							usage: undefined,
+							error: `Stream parse error: ${parseErr instanceof Error ? parseErr.message : String(parseErr)}`,
+						}
+					}
+				}
+			}
+		} finally {
+			reader.releaseLock()
+		}
+	}
+
+	async listModels(): Promise<ModelInfo[]> {
+		const response = await fetch(`${this.baseUrl}/models`, {
+			headers: this.getHeaders(),
+		})
+
+		if (!response.ok) {
+			throw new Error(`Failed to list models: ${response.status}`)
+		}
+
+		const data = (await response.json()) as {
+			data: Array<{
+				id: string
+				name: string
+				context_length: number
+				top_provider?: { max_completion_tokens?: number }
+				pricing?: { prompt: string; completion: string }
+			}>
+		}
+
+		return data.data.map((m) => ({
+			id: m.id,
+			name: m.name,
+			contextWindow: m.context_length,
+			maxOutputTokens: m.top_provider?.max_completion_tokens ?? 4096,
+			inputPrice: Number.parseFloat(m.pricing?.prompt ?? '0') * 1_000_000,
+			outputPrice: Number.parseFloat(m.pricing?.completion ?? '0') * 1_000_000,
+			supportsToolUse: true,
+			supportsStreaming: true,
+		}))
+	}
+
+	async healthCheck(): Promise<boolean> {
+		try {
+			const response = await fetch(`${this.baseUrl}/models`, {
+				headers: this.getHeaders(),
+				signal: AbortSignal.timeout(5000),
+			})
+			return response.ok
+		} catch {
+			return false
+		}
+	}
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+import { type ProviderCapabilities, ProviderRegistry, type RegisterOptions } from '@namzu/sdk'
+import { OpenRouterProvider } from './client.js'
+import type { OpenRouterProviderConfig } from './types.js'
+
+// Module augmentation: register openrouter's config type in the sdk's registry
+// interface. This must live inside index.ts (not a .d.ts) so it executes when
+// index.ts is imported.
+declare module '@namzu/sdk' {
+	interface ProviderConfigRegistry {
+		openrouter: OpenRouterProviderConfig
+	}
+}
+
+export const OPENROUTER_CAPABILITIES: ProviderCapabilities = {
+	supportsTools: true,
+	supportsStreaming: true,
+	supportsFunctionCalling: true,
+}
+
+/**
+ * Register `OpenRouterProvider` under the `'openrouter'` type in `@namzu/sdk`'s
+ * `ProviderRegistry`. Call once at app startup before
+ * `ProviderRegistry.create({ type: 'openrouter', ... })`.
+ *
+ * Throws `DuplicateProviderError` if `'openrouter'` is already registered.
+ * Pass `{ replace: true }` to override.
+ */
+export function registerOpenRouter(options?: RegisterOptions): void {
+	ProviderRegistry.register('openrouter', OpenRouterProvider, OPENROUTER_CAPABILITIES, options)
+}
+
+export { OpenRouterProvider } from './client.js'
+export type { OpenRouterConfig, OpenRouterProviderConfig } from './types.js'

package/src/types.ts

@@ -0,0 +1,21 @@
+/**
+ * OpenRouter-specific provider config shapes.
+ *
+ * `OpenRouterConfig` is the constructor input for `OpenRouterProvider` (no
+ * discriminator). `OpenRouterProviderConfig` is the shape the consumer passes
+ * to `ProviderRegistry.create({ type: 'openrouter', ... })` — it extends
+ * `OpenRouterConfig` with the `type: 'openrouter'` discriminator for the
+ * registry's generic narrowing.
+ */
+
+export interface OpenRouterConfig {
+	apiKey: string
+	baseUrl?: string
+	siteUrl?: string
+	siteName?: string
+	timeout?: number
+}
+
+export interface OpenRouterProviderConfig extends OpenRouterConfig {
+	type: 'openrouter'
+}