@anyr/ai-sdk-provider 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Duyet Le
+
+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,227 @@
+# @anyr/ai-sdk-provider
+
+The [AnyRouter](https://anyrouter.dev) provider for the [Vercel AI SDK](https://ai-sdk.dev).
+
+Call every model on the AnyRouter gateway through the standard AI SDK
+interface — `generateText`, `streamText`, `generateObject`, `embedMany`,
+`generateImage` — with one key and one provider.
+
+## Install
+
+```bash
+npm install @anyr/ai-sdk-provider ai zod
+# or
+pnpm add @anyr/ai-sdk-provider ai zod
+```
+
+## Quickstart
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+import { generateText } from "ai"
+
+// Reads ANYROUTER_API_KEY from the environment when omitted.
+const anyrouter = createAnyRouter()
+
+const { text } = await generateText({
+  model: anyrouter("openai/gpt-4o-mini"),
+  prompt: "What is AnyRouter?",
+})
+console.log(text)
+```
+
+## Usage
+
+### generateText
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+import { generateText } from "ai"
+
+const anyrouter = createAnyRouter({ apiKey: process.env.ANYROUTER_API_KEY })
+
+const { text } = await generateText({
+  model: anyrouter("anthropic/claude-opus-4-5"),
+  system: "You are a helpful assistant.",
+  prompt: "Explain the butterfly effect in one paragraph.",
+})
+```
+
+### streamText
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+import { streamText } from "ai"
+
+const anyrouter = createAnyRouter()
+
+const { textStream } = await streamText({
+  model: anyrouter("openai/gpt-4o"),
+  prompt: "Write a haiku about the ocean.",
+})
+
+for await (const chunk of textStream) {
+  process.stdout.write(chunk)
+}
+```
+
+### generateObject (structured output)
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+import { generateObject } from "ai"
+import { z } from "zod"
+
+const anyrouter = createAnyRouter()
+
+const { object } = await generateObject({
+  model: anyrouter("openai/gpt-4o-mini"),
+  schema: z.object({
+    title: z.string(),
+    summary: z.string(),
+    tags: z.array(z.string()),
+  }),
+  prompt: "Summarise the latest AI news in a structured format.",
+})
+
+console.log(object.title, object.tags)
+```
+
+### Tool calling
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+import { generateText, tool } from "ai"
+import { z } from "zod"
+
+const anyrouter = createAnyRouter()
+
+const { text, toolCalls } = await generateText({
+  model: anyrouter("openai/gpt-4o"),
+  tools: {
+    get_weather: tool({
+      description: "Get the current weather in a city.",
+      parameters: z.object({ city: z.string() }),
+      execute: async ({ city }) => ({ temperature: 22, unit: "C", city }),
+    }),
+  },
+  prompt: "What is the weather in Tokyo?",
+})
+```
+
+### Embeddings
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+import { embedMany } from "ai"
+
+const anyrouter = createAnyRouter()
+
+const { embeddings } = await embedMany({
+  model: anyrouter.embeddingModel("openai/text-embedding-3-small"),
+  values: ["Hello world", "How are you?"],
+})
+
+console.log(embeddings[0]) // [0.123, -0.456, ...]
+```
+
+### Image generation
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+import { generateImage } from "ai"
+
+const anyrouter = createAnyRouter()
+
+const { image } = await generateImage({
+  model: anyrouter.imageModel("openai/dall-e-3"),
+  prompt: "A serene mountain lake at dawn, oil painting.",
+  size: "1024x1024",
+})
+
+// image.base64 — base64-encoded PNG or URL depending on the model
+```
+
+### Provider options (routing, session, extra body)
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+import { generateText } from "ai"
+
+// Set routing preferences at the provider level
+const anyrouter = createAnyRouter({
+  provider: { only: ["openai"], quantizations: ["bf16"] },
+  sessionId: "user-session-abc",
+})
+
+// Or override them per-call
+const { text } = await generateText({
+  model: anyrouter("openai/gpt-4o"),
+  prompt: "Hello!",
+  experimental_providerMetadata: {
+    anyrouter: {
+      provider: { order: ["openai", "azure"] },
+      sessionId: "per-request-session",
+      extraBody: { logprobs: true },
+    },
+  },
+})
+```
+
+## Configuration
+
+```ts
+import { createAnyRouter } from "@anyr/ai-sdk-provider"
+
+const anyrouter = createAnyRouter({
+  // API key — falls back to ANYROUTER_API_KEY env var (resolved lazily at request time)
+  apiKey: "<your-anyrouter-key>",
+
+  // API base URL — defaults to https://anyrouter.dev/api/v1
+  baseURL: "https://anyrouter.dev/api/v1",
+
+  // Extra headers merged into every request
+  headers: { "X-Custom-Header": "value" },
+
+  // Custom fetch implementation (e.g. for logging or proxying)
+  fetch: myCustomFetch,
+
+  // Default routing preference forwarded as `provider` in the request body
+  provider: { only: ["openai"] },
+
+  // Session ID forwarded as `session_id` — useful for grouping in analytics
+  sessionId: "my-session",
+
+  // Extra fields merged into every request body (per-call overrides these)
+  extraBody: { safe_mode: true },
+})
+```
+
+## Provider methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `anyrouter(modelId)` | `LanguageModelV3` | Shorthand for `anyrouter.chat(modelId)` |
+| `anyrouter.chat(modelId)` | `LanguageModelV3` | Chat / instruction language model |
+| `anyrouter.languageModel(modelId)` | `LanguageModelV3` | Alias for `.chat()` (ProviderV3 interface) |
+| `anyrouter.embeddingModel(modelId)` | `EmbeddingModelV3` | Text embedding model |
+| `anyrouter.imageModel(modelId)` | `ImageModelV3` | Image generation model |
+| `anyrouter.client` | `AnyRouter` | Raw `@anyr/sdk` client (escape hatch) |
+
+## Default export
+
+```ts
+import { anyrouter } from "@anyr/ai-sdk-provider"
+
+// Uses ANYROUTER_API_KEY from the environment
+const { text } = await generateText({
+  model: anyrouter("openai/gpt-4o-mini"),
+  prompt: "Hello!",
+})
+```
+
+Built on [`@anyr/sdk`](https://www.npmjs.com/package/@anyr/sdk).
+
+## License
+
+MIT © Duyet Le

package/dist/index.d.cts

@@ -0,0 +1,149 @@
+import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, EmbeddingModelV3, EmbeddingModelV3CallOptions, EmbeddingModelV3Result, ImageModelV3, ImageModelV3CallOptions, ProviderV3 } from '@ai-sdk/provider';
+import { AnyRouter } from '@anyr/sdk';
+
+/**
+ * Settings for `createAnyRouter(...)`.
+ */
+interface AnyRouterProviderSettings {
+    /**
+     * AnyRouter API key (`sk-ar-v1-…`).
+     * Falls back to the `ANYROUTER_API_KEY` environment variable when omitted.
+     * Resolved lazily at request time.
+     */
+    apiKey?: string;
+    /**
+     * API base URL.
+     * Defaults to `https://anyrouter.dev/api/v1`.
+     */
+    baseURL?: string;
+    /**
+     * Extra headers merged into every request.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation.
+     * Defaults to the global `fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * AnyRouter routing preference forwarded as the `provider` field.
+     *
+     * @example { only: ["openai"], quantizations: ["bf16"] }
+     */
+    provider?: Record<string, unknown>;
+    /**
+     * Session identifier forwarded as `session_id` on every request.
+     * Useful for grouping related requests in usage analytics.
+     */
+    sessionId?: string;
+    /**
+     * Extra fields merged into every request body.
+     * Per-call `providerOptions.anyrouter.extraBody` takes precedence.
+     */
+    extraBody?: Record<string, unknown>;
+}
+
+interface AnyRouterChatConfig {
+    provider: string;
+    baseURL: string;
+    headers: () => Record<string, string | undefined>;
+    fetch?: typeof globalThis.fetch;
+    settings: AnyRouterProviderSettings;
+}
+declare class AnyRouterChatLanguageModel implements LanguageModelV3 {
+    readonly specificationVersion: "v3";
+    readonly provider: string;
+    readonly modelId: string;
+    readonly supportedUrls: Record<string, RegExp[]>;
+    private readonly config;
+    constructor(modelId: string, config: AnyRouterChatConfig);
+    doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
+    doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
+}
+
+interface AnyRouterEmbeddingConfig {
+    provider: string;
+    baseURL: string;
+    headers: () => Record<string, string | undefined>;
+    fetch?: typeof globalThis.fetch;
+}
+declare class AnyRouterEmbeddingModel implements EmbeddingModelV3 {
+    readonly specificationVersion: "v3";
+    readonly provider: string;
+    readonly modelId: string;
+    /** No hard per-call limit imposed by the provider layer. */
+    readonly maxEmbeddingsPerCall: number | undefined;
+    readonly supportsParallelCalls = true;
+    private readonly config;
+    constructor(modelId: string, config: AnyRouterEmbeddingConfig);
+    doEmbed(options: EmbeddingModelV3CallOptions): Promise<EmbeddingModelV3Result>;
+}
+
+interface AnyRouterImageConfig {
+    provider: string;
+    baseURL: string;
+    headers: () => Record<string, string | undefined>;
+    fetch?: typeof globalThis.fetch;
+}
+declare class AnyRouterImageModel implements ImageModelV3 {
+    readonly specificationVersion: "v3";
+    readonly provider: string;
+    readonly modelId: string;
+    /**
+     * Most image generation APIs support only 1 image per call via the
+     * standard `/images/generations` endpoint.
+     */
+    readonly maxImagesPerCall = 1;
+    private readonly config;
+    constructor(modelId: string, config: AnyRouterImageConfig);
+    doGenerate(options: ImageModelV3CallOptions): Promise<Awaited<ReturnType<ImageModelV3["doGenerate"]>>>;
+}
+
+interface AnyRouterProvider extends ProviderV3 {
+    /** Create a chat language model by calling the provider directly. */
+    (modelId: string): LanguageModelV3;
+    /** Create a chat language model (explicit method). */
+    chat(modelId: string): LanguageModelV3;
+    /**
+     * Low-level `@anyr/sdk` client instance.
+     * Use this as an escape hatch when you need direct API access.
+     */
+    readonly client: AnyRouter;
+}
+/**
+ * Create an AnyRouter provider for the Vercel AI SDK.
+ *
+ * ```ts
+ * import { createAnyRouter } from "@anyr/ai-sdk-provider"
+ * import { generateText } from "ai"
+ *
+ * const anyrouter = createAnyRouter() // reads ANYROUTER_API_KEY
+ * const { text } = await generateText({
+ *   model: anyrouter("openai/gpt-4o-mini"),
+ *   prompt: "Hello!",
+ * })
+ * ```
+ *
+ * The `apiKey` is resolved **lazily** at request time (not at
+ * `createAnyRouter()` call time), so the factory can be constructed
+ * before environment variables are populated.
+ */
+declare function createAnyRouter(options?: AnyRouterProviderSettings): AnyRouterProvider;
+/**
+ * Default AnyRouter provider instance.
+ *
+ * Uses `ANYROUTER_API_KEY` from the environment (resolved lazily at request time).
+ *
+ * ```ts
+ * import { anyrouter } from "@anyr/ai-sdk-provider"
+ * import { generateText } from "ai"
+ *
+ * const { text } = await generateText({
+ *   model: anyrouter("openai/gpt-4o-mini"),
+ *   prompt: "Hello!",
+ * })
+ * ```
+ */
+declare const anyrouter: AnyRouterProvider;
+
+export { type AnyRouterChatConfig, AnyRouterChatLanguageModel, type AnyRouterEmbeddingConfig, AnyRouterEmbeddingModel, type AnyRouterImageConfig, AnyRouterImageModel, type AnyRouterProvider, type AnyRouterProviderSettings, anyrouter, createAnyRouter };

package/dist/index.d.ts

@@ -0,0 +1,149 @@
+import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, EmbeddingModelV3, EmbeddingModelV3CallOptions, EmbeddingModelV3Result, ImageModelV3, ImageModelV3CallOptions, ProviderV3 } from '@ai-sdk/provider';
+import { AnyRouter } from '@anyr/sdk';
+
+/**
+ * Settings for `createAnyRouter(...)`.
+ */
+interface AnyRouterProviderSettings {
+    /**
+     * AnyRouter API key (`sk-ar-v1-…`).
+     * Falls back to the `ANYROUTER_API_KEY` environment variable when omitted.
+     * Resolved lazily at request time.
+     */
+    apiKey?: string;
+    /**
+     * API base URL.
+     * Defaults to `https://anyrouter.dev/api/v1`.
+     */
+    baseURL?: string;
+    /**
+     * Extra headers merged into every request.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation.
+     * Defaults to the global `fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * AnyRouter routing preference forwarded as the `provider` field.
+     *
+     * @example { only: ["openai"], quantizations: ["bf16"] }
+     */
+    provider?: Record<string, unknown>;
+    /**
+     * Session identifier forwarded as `session_id` on every request.
+     * Useful for grouping related requests in usage analytics.
+     */
+    sessionId?: string;
+    /**
+     * Extra fields merged into every request body.
+     * Per-call `providerOptions.anyrouter.extraBody` takes precedence.
+     */
+    extraBody?: Record<string, unknown>;
+}
+
+interface AnyRouterChatConfig {
+    provider: string;
+    baseURL: string;
+    headers: () => Record<string, string | undefined>;
+    fetch?: typeof globalThis.fetch;
+    settings: AnyRouterProviderSettings;
+}
+declare class AnyRouterChatLanguageModel implements LanguageModelV3 {
+    readonly specificationVersion: "v3";
+    readonly provider: string;
+    readonly modelId: string;
+    readonly supportedUrls: Record<string, RegExp[]>;
+    private readonly config;
+    constructor(modelId: string, config: AnyRouterChatConfig);
+    doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
+    doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
+}
+
+interface AnyRouterEmbeddingConfig {
+    provider: string;
+    baseURL: string;
+    headers: () => Record<string, string | undefined>;
+    fetch?: typeof globalThis.fetch;
+}
+declare class AnyRouterEmbeddingModel implements EmbeddingModelV3 {
+    readonly specificationVersion: "v3";
+    readonly provider: string;
+    readonly modelId: string;
+    /** No hard per-call limit imposed by the provider layer. */
+    readonly maxEmbeddingsPerCall: number | undefined;
+    readonly supportsParallelCalls = true;
+    private readonly config;
+    constructor(modelId: string, config: AnyRouterEmbeddingConfig);
+    doEmbed(options: EmbeddingModelV3CallOptions): Promise<EmbeddingModelV3Result>;
+}
+
+interface AnyRouterImageConfig {
+    provider: string;
+    baseURL: string;
+    headers: () => Record<string, string | undefined>;
+    fetch?: typeof globalThis.fetch;
+}
+declare class AnyRouterImageModel implements ImageModelV3 {
+    readonly specificationVersion: "v3";
+    readonly provider: string;
+    readonly modelId: string;
+    /**
+     * Most image generation APIs support only 1 image per call via the
+     * standard `/images/generations` endpoint.
+     */
+    readonly maxImagesPerCall = 1;
+    private readonly config;
+    constructor(modelId: string, config: AnyRouterImageConfig);
+    doGenerate(options: ImageModelV3CallOptions): Promise<Awaited<ReturnType<ImageModelV3["doGenerate"]>>>;
+}
+
+interface AnyRouterProvider extends ProviderV3 {
+    /** Create a chat language model by calling the provider directly. */
+    (modelId: string): LanguageModelV3;
+    /** Create a chat language model (explicit method). */
+    chat(modelId: string): LanguageModelV3;
+    /**
+     * Low-level `@anyr/sdk` client instance.
+     * Use this as an escape hatch when you need direct API access.
+     */
+    readonly client: AnyRouter;
+}
+/**
+ * Create an AnyRouter provider for the Vercel AI SDK.
+ *
+ * ```ts
+ * import { createAnyRouter } from "@anyr/ai-sdk-provider"
+ * import { generateText } from "ai"
+ *
+ * const anyrouter = createAnyRouter() // reads ANYROUTER_API_KEY
+ * const { text } = await generateText({
+ *   model: anyrouter("openai/gpt-4o-mini"),
+ *   prompt: "Hello!",
+ * })
+ * ```
+ *
+ * The `apiKey` is resolved **lazily** at request time (not at
+ * `createAnyRouter()` call time), so the factory can be constructed
+ * before environment variables are populated.
+ */
+declare function createAnyRouter(options?: AnyRouterProviderSettings): AnyRouterProvider;
+/**
+ * Default AnyRouter provider instance.
+ *
+ * Uses `ANYROUTER_API_KEY` from the environment (resolved lazily at request time).
+ *
+ * ```ts
+ * import { anyrouter } from "@anyr/ai-sdk-provider"
+ * import { generateText } from "ai"
+ *
+ * const { text } = await generateText({
+ *   model: anyrouter("openai/gpt-4o-mini"),
+ *   prompt: "Hello!",
+ * })
+ * ```
+ */
+declare const anyrouter: AnyRouterProvider;
+
+export { type AnyRouterChatConfig, AnyRouterChatLanguageModel, type AnyRouterEmbeddingConfig, AnyRouterEmbeddingModel, type AnyRouterImageConfig, AnyRouterImageModel, type AnyRouterProvider, type AnyRouterProviderSettings, anyrouter, createAnyRouter };