@thalam/ai-sdk-provider 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+Apache License 2.0
+
+Copyright 2026 thalam.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,161 @@
+# @thalam/ai-sdk-provider
+
+[Vercel AI SDK](https://ai-sdk.dev) provider for **thalam.** — one OpenAI-compatible endpoint for every leading AI model.
+
+Built in the UAE. Text, image, and video models from a single endpoint, with per-key spend caps and audit logs as a built-in governance layer.
+
+- **One endpoint** — DeepSeek, Qwen, Kimi, GLM, MiniMax, Claude, GPT, Llama, Grok, Mistral and more
+- **Drop-in OpenAI compatibility** — every Vercel AI SDK feature works unchanged
+- **Pay per token** — no subscription, no minimums
+- **AED or USD invoicing** on Enterprise contracts
+
+## Install
+
+```bash
+npm install @thalam/ai-sdk-provider ai
+# or: pnpm add @thalam/ai-sdk-provider ai
+# or: yarn add @thalam/ai-sdk-provider ai
+```
+
+Sign up at [thalam.ai](https://www.thalam.ai) — new accounts get **$1 in starter credit** to test, then pay as you go.
+
+## Quickstart
+
+```ts
+import { thalam } from '@thalam/ai-sdk-provider';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: thalam('deepseek/deepseek-v3.2'),
+  prompt: 'Explain quantum entanglement in 2 sentences.',
+});
+
+console.log(text);
+```
+
+Set `THALAM_API_KEY` in your environment, or pass `apiKey` explicitly:
+
+```ts
+import { createThalam } from '@thalam/ai-sdk-provider';
+
+const thalam = createThalam({
+  apiKey: process.env.THALAM_API_KEY,
+});
+```
+
+## Streaming
+
+```ts
+import { thalam } from '@thalam/ai-sdk-provider';
+import { streamText } from 'ai';
+
+const result = streamText({
+  model: thalam('qwen/qwen3-max'),
+  prompt: 'Write a haiku about Dubai.',
+});
+
+for await (const chunk of result.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+## Tool calling
+
+```ts
+import { thalam } from '@thalam/ai-sdk-provider';
+import { generateText, tool } from 'ai';
+import { z } from 'zod';
+
+const { text } = await generateText({
+  model: thalam('deepseek/deepseek-v4-pro'),
+  tools: {
+    weather: tool({
+      description: 'Get the weather in a city',
+      parameters: z.object({ city: z.string() }),
+      execute: async ({ city }) => ({ temp: 32, unit: 'C', city }),
+    }),
+  },
+  prompt: 'What is the weather in Dubai?',
+});
+```
+
+## Structured outputs (with Zod)
+
+```ts
+import { thalam } from '@thalam/ai-sdk-provider';
+import { generateObject } from 'ai';
+import { z } from 'zod';
+
+const { object } = await generateObject({
+  model: thalam('deepseek/deepseek-v3.2'),
+  schema: z.object({
+    title: z.string(),
+    tags: z.array(z.string()),
+  }),
+  prompt: 'Generate metadata for a blog post about MENA fintech.',
+});
+```
+
+## Available models
+
+The full live catalog is at [thalam.ai/models](https://www.thalam.ai/models) or via:
+
+```ts
+const res = await fetch('https://api.thalam.ai/v1/models', {
+  headers: { Authorization: `Bearer ${process.env.THALAM_API_KEY}` },
+});
+const { data } = await res.json();
+```
+
+Common text-model IDs (exported as constants for editor auto-complete):
+
+| Constant                  | ID                                            |
+|---------------------------|-----------------------------------------------|
+| `deepseekV4Pro`           | `deepseek/deepseek-v4-pro`                    |
+| `deepseekV4Flash`         | `deepseek/deepseek-v4-flash`                  |
+| `deepseekV3_2`            | `deepseek/deepseek-v3.2`                      |
+| `deepseekR1_0528`         | `deepseek/deepseek-r1-0528`                   |
+| `qwen3Max`                | `qwen/qwen3-max`                              |
+| `qwen3_5_397B`            | `qwen/qwen3.5-397b-a17b`                      |
+| `qwen3Coder480B`          | `qwen/qwen3-coder-480b-a35b-instruct`         |
+| `glm5_1`                  | `zhipu/glm-5.1`                               |
+| `kimiK2Thinking`          | `moonshotai/kimi-k2-thinking`                 |
+| `kimiK2_5`                | `moonshotai/kimi-k2.5`                        |
+| `claudeOpus4_8`           | `anthropic/claude-opus-4.8`                   |
+| `claudeOpus4_7`           | `anthropic/claude-opus-4.7`                   |
+| `claudeSonnet4_6`         | `anthropic/claude-sonnet-4.6`                 |
+| `gpt5_4`                  | `openai/gpt-5.4`                              |
+| `grok4`                   | `xai/grok-4`                                  |
+| `llama3_3_70B`            | `meta-llama/llama-3.3-70b-instruct`           |
+
+```ts
+import { thalam, ThalamChatModelIds } from '@thalam/ai-sdk-provider';
+
+const model = thalam(ThalamChatModelIds.deepseekV4Pro);
+```
+
+## Configuration
+
+```ts
+import { createThalam } from '@thalam/ai-sdk-provider';
+
+const thalam = createThalam({
+  apiKey: process.env.THALAM_API_KEY,        // default: env THALAM_API_KEY
+  baseURL: 'https://api.thalam.ai/v1',        // default
+  name: 'thalam',                             // shown in error messages
+  headers: { 'X-Custom': '...' },             // optional extra headers
+  fetch: globalThis.fetch,                    // override (for testing)
+});
+```
+
+## Links
+
+- [thalam.ai](https://www.thalam.ai)
+- [Documentation](https://www.thalam.ai/docs)
+- [Model catalog](https://www.thalam.ai/models)
+- [Pricing](https://www.thalam.ai/pricing)
+- [Vercel AI SDK](https://ai-sdk.dev)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+import { OpenAICompatibleProviderSettings, OpenAICompatibleProvider } from '@ai-sdk/openai-compatible';
+
+/**
+ * @thalam/ai-sdk-provider
+ *
+ * Vercel AI SDK provider for thalam. — one OpenAI-compatible endpoint
+ * for every leading AI model (text, image, video).
+ *
+ * Wraps `@ai-sdk/openai-compatible` and points it at `https://api.thalam.ai/v1`.
+ *
+ * Usage:
+ *   import { thalam } from '@thalam/ai-sdk-provider';
+ *   import { generateText } from 'ai';
+ *
+ *   const { text } = await generateText({
+ *     model: thalam('deepseek/deepseek-v3.2'),
+ *     prompt: 'Hello',
+ *   });
+ *
+ * Configuration:
+ *   THALAM_API_KEY — env var read by default
+ *   apiKey         — pass to createThalam() to override
+ *   baseURL        — pass to createThalam() if you're using a self-hosted gateway
+ */
+
+/**
+ * Options accepted by `createThalam`. All optional — defaults pick up
+ * the API key from `process.env.THALAM_API_KEY`.
+ */
+interface ThalamProviderSettings extends Omit<OpenAICompatibleProviderSettings, 'baseURL' | 'apiKey' | 'name'> {
+    /** API key. Defaults to `process.env.THALAM_API_KEY`. */
+    apiKey?: string;
+    /** Override base URL (use for self-hosted / staging only). */
+    baseURL?: string;
+    /** Provider name shown in error messages. Default: 'thalam'. */
+    name?: string;
+}
+/**
+ * Common thalam. model IDs surfaced as constants for editor auto-complete.
+ * You can still pass any string ID — this is just a hint list. Visit
+ * https://www.thalam.ai/models for the live catalog or call `GET /v1/models`.
+ */
+declare const ThalamChatModelIds: {
+    readonly deepseekV4Pro: "deepseek/deepseek-v4-pro";
+    readonly deepseekV4Flash: "deepseek/deepseek-v4-flash";
+    readonly deepseekV3_2: "deepseek/deepseek-v3.2";
+    readonly deepseekV3_1Terminus: "deepseek/deepseek-v3.1-terminus";
+    readonly deepseekR1_0528: "deepseek/deepseek-r1-0528";
+    readonly qwen3Max: "qwen/qwen3-max";
+    readonly qwen3_5_397B: "qwen/qwen3.5-397b-a17b";
+    readonly qwen3_5_122B: "qwen/qwen3.5-122b-a10b";
+    readonly qwen3Coder480B: "qwen/qwen3-coder-480b-a35b-instruct";
+    readonly qwen3Coder30B: "qwen/qwen3-coder-30b-a3b-instruct";
+    readonly qwen3CoderNext: "qwen/qwen3-coder-next";
+    readonly glm5: "zhipu/glm-5";
+    readonly glm5_1: "zhipu/glm-5.1";
+    readonly glm4_6V: "zhipu/glm-4.6v";
+    readonly kimiK2Thinking: "moonshotai/kimi-k2-thinking";
+    readonly kimiK2_5: "moonshotai/kimi-k2.5";
+    readonly miniMaxM2_7: "minimax/minimax-m2.7";
+    readonly miniMaxM2_5: "minimax/minimax-m2.5";
+    readonly gpt5_4: "openai/gpt-5.4";
+    readonly gpt5Mini: "openai/gpt-5-mini";
+    readonly gptOss120B: "openai/gpt-oss-120b";
+    readonly claudeOpus4_8: "anthropic/claude-opus-4.8";
+    readonly claudeOpus4_7: "anthropic/claude-opus-4.7";
+    readonly claudeSonnet4_6: "anthropic/claude-sonnet-4.6";
+    readonly grok4: "xai/grok-4";
+    readonly llama3_3_70B: "meta-llama/llama-3.3-70b-instruct";
+    readonly llama4Maverick: "meta-llama/llama-4-maverick-17b-128e-instruct-fp8";
+    readonly llama4Scout: "meta-llama/llama-4-scout-17b-16e-instruct";
+    readonly mistralNemo: "mistralai/mistral-nemo";
+    readonly gemma4_31B: "google/gemma-4-31b-it";
+};
+type ThalamChatModelId = (typeof ThalamChatModelIds)[keyof typeof ThalamChatModelIds] | (string & {});
+/**
+ * Create a thalam. provider instance.
+ *
+ * @example
+ *   import { createThalam } from '@thalam/ai-sdk-provider';
+ *   const thalam = createThalam({ apiKey: 'tl-...' });
+ *   const model = thalam('deepseek/deepseek-v3.2');
+ *
+ * @example
+ *   // Using the default export (reads THALAM_API_KEY from env)
+ *   import { thalam } from '@thalam/ai-sdk-provider';
+ *   const model = thalam('qwen/qwen3-max');
+ */
+declare function createThalam(options?: ThalamProviderSettings): OpenAICompatibleProvider<ThalamChatModelId, string, string, string>;
+/**
+ * Default provider instance. Reads `THALAM_API_KEY` from the environment.
+ *
+ * @example
+ *   import { thalam } from '@thalam/ai-sdk-provider';
+ *   import { generateText } from 'ai';
+ *
+ *   const { text } = await generateText({
+ *     model: thalam('deepseek/deepseek-v3.2'),
+ *     prompt: 'Explain quantum entanglement in 2 sentences.',
+ *   });
+ */
+declare const thalam: OpenAICompatibleProvider<ThalamChatModelId, string, string, string>;
+
+export { type ThalamChatModelId, ThalamChatModelIds, type ThalamProviderSettings, createThalam, thalam };

package/dist/index.js

@@ -0,0 +1,69 @@
+// src/index.ts
+import {
+  createOpenAICompatible
+} from "@ai-sdk/openai-compatible";
+var DEFAULT_BASE_URL = "https://api.thalam.ai/v1";
+var DEFAULT_NAME = "thalam";
+var ThalamChatModelIds = {
+  // DeepSeek
+  deepseekV4Pro: "deepseek/deepseek-v4-pro",
+  deepseekV4Flash: "deepseek/deepseek-v4-flash",
+  deepseekV3_2: "deepseek/deepseek-v3.2",
+  deepseekV3_1Terminus: "deepseek/deepseek-v3.1-terminus",
+  deepseekR1_0528: "deepseek/deepseek-r1-0528",
+  // Qwen
+  qwen3Max: "qwen/qwen3-max",
+  qwen3_5_397B: "qwen/qwen3.5-397b-a17b",
+  qwen3_5_122B: "qwen/qwen3.5-122b-a10b",
+  qwen3Coder480B: "qwen/qwen3-coder-480b-a35b-instruct",
+  qwen3Coder30B: "qwen/qwen3-coder-30b-a3b-instruct",
+  qwen3CoderNext: "qwen/qwen3-coder-next",
+  // GLM
+  glm5: "zhipu/glm-5",
+  glm5_1: "zhipu/glm-5.1",
+  glm4_6V: "zhipu/glm-4.6v",
+  // Kimi
+  kimiK2Thinking: "moonshotai/kimi-k2-thinking",
+  kimiK2_5: "moonshotai/kimi-k2.5",
+  // MiniMax
+  miniMaxM2_7: "minimax/minimax-m2.7",
+  miniMaxM2_5: "minimax/minimax-m2.5",
+  // OpenAI
+  gpt5_4: "openai/gpt-5.4",
+  gpt5Mini: "openai/gpt-5-mini",
+  gptOss120B: "openai/gpt-oss-120b",
+  // Anthropic
+  claudeOpus4_8: "anthropic/claude-opus-4.8",
+  claudeOpus4_7: "anthropic/claude-opus-4.7",
+  claudeSonnet4_6: "anthropic/claude-sonnet-4.6",
+  // xAI
+  grok4: "xai/grok-4",
+  // Llama
+  llama3_3_70B: "meta-llama/llama-3.3-70b-instruct",
+  llama4Maverick: "meta-llama/llama-4-maverick-17b-128e-instruct-fp8",
+  llama4Scout: "meta-llama/llama-4-scout-17b-16e-instruct",
+  // Mistral
+  mistralNemo: "mistralai/mistral-nemo",
+  // Google
+  gemma4_31B: "google/gemma-4-31b-it"
+};
+function createThalam(options = {}) {
+  const apiKey = options.apiKey ?? (typeof process !== "undefined" ? process.env?.THALAM_API_KEY : void 0);
+  return createOpenAICompatible({
+    name: options.name ?? DEFAULT_NAME,
+    baseURL: options.baseURL ?? DEFAULT_BASE_URL,
+    apiKey,
+    headers: {
+      ...options.headers ?? {},
+      "X-Thalam-Provider-SDK": "@thalam/ai-sdk-provider"
+    },
+    queryParams: options.queryParams,
+    fetch: options.fetch
+  });
+}
+var thalam = createThalam();
+export {
+  ThalamChatModelIds,
+  createThalam,
+  thalam
+};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@thalam/ai-sdk-provider",
+  "version": "0.1.0",
+  "description": "Vercel AI SDK provider for thalam. — one OpenAI-compatible endpoint for every leading AI model (text, image, video).",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "test": "node --experimental-vm-modules tests/smoke.test.mjs"
+  },
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "vercel",
+    "thalam",
+    "openai-compatible",
+    "llm",
+    "gateway"
+  ],
+  "homepage": "https://www.thalam.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thalam-ai/ai-sdk-provider.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thalam-ai/ai-sdk-provider/issues"
+  },
+  "author": "thalam. <press@thalam.ai>",
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "ai": "^5.0.0 || ^6.0.0",
+    "zod": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ai": { "optional": false }
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.0",
+    "@ai-sdk/provider": "^3.0.0",
+    "@ai-sdk/provider-utils": "^4.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "zod": "^3.23.0"
+  }
+}