@commoncompute/vercel-ai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Common Compute, Inc.
+
+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,24 @@
+# @commoncompute/vercel-ai
+
+Vercel AI SDK provider for [Common Compute](https://commoncompute.ai).
+
+```bash
+npm install @commoncompute/vercel-ai @ai-sdk/openai-compatible ai
+```
+
+```ts
+import { createCommonCompute } from "@commoncompute/vercel-ai";
+import { streamText } from "ai";
+
+const cc = createCommonCompute({ apiKey: process.env.CC_API_KEY });
+
+const result = await streamText({
+  model: cc("qwen-2.5-7b"),
+  messages: [{ role: "user", content: "hi" }],
+});
+for await (const delta of result.textStream) process.stdout.write(delta);
+```
+
+Under the hood this delegates to `@ai-sdk/openai-compatible` (or `@ai-sdk/openai` as a fallback) pointed at `https://api.commoncompute.ai/v1`, so every AI SDK feature — streaming, tool calls, structured output, UI hooks — works out of the box.
+
+Set `CC_API_KEY` in your environment or pass `apiKey` at construction.

package/dist/index.cjs

@@ -0,0 +1,66 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createCommonCompute: () => createCommonCompute,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_node_module = require("module");
+var import_meta = {};
+function createCommonCompute(opts = {}) {
+  const apiKey = opts.apiKey ?? (typeof process !== "undefined" ? process.env.CC_API_KEY : void 0);
+  if (!apiKey) {
+    throw new Error("createCommonCompute: apiKey is required (or set CC_API_KEY).");
+  }
+  const baseURL = (opts.baseURL ?? (typeof process !== "undefined" ? process.env.CC_BASE_URL : void 0) ?? "https://api.commoncompute.ai") + "/v1";
+  const headers = opts.org || opts.headers ? { ...opts.headers ?? {}, ...opts.org ? { "X-CC-Org": opts.org } : {} } : void 0;
+  return (modelId) => {
+    const req = (0, import_node_module.createRequire)(typeof __filename === "string" ? __filename : import_meta.url);
+    let createOpenAICompatible;
+    try {
+      createOpenAICompatible = req("@ai-sdk/openai-compatible").createOpenAICompatible;
+    } catch {
+      try {
+        const { createOpenAI } = req("@ai-sdk/openai");
+        const openai = createOpenAI({ apiKey, baseURL, headers, fetch: opts.fetch });
+        return typeof openai.chat === "function" ? openai.chat(modelId) : openai(modelId);
+      } catch {
+        throw new Error(
+          "Vercel AI provider missing. Install one of: `@ai-sdk/openai-compatible` or `@ai-sdk/openai`."
+        );
+      }
+    }
+    const provider = createOpenAICompatible({
+      name: "commoncompute",
+      apiKey,
+      baseURL,
+      headers,
+      fetch: opts.fetch
+    });
+    return provider.chatModel(modelId);
+  };
+}
+var index_default = createCommonCompute;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCommonCompute
+});

package/dist/index.d.cts

@@ -0,0 +1,37 @@
+/**
+ * Vercel AI SDK provider for Common Compute.
+ *
+ * Minimal wrapper: delegates to Common Compute's OpenAI-compatible
+ * `/v1/chat/completions`. For the full AI SDK experience use the AI
+ * SDK's OpenAI provider pointed at our base URL — this package is a
+ * convenience wrapper so consumers don't have to remember the URL.
+ *
+ *   import { createCommonCompute } from "@commoncompute/vercel-ai";
+ *   import { streamText } from "ai";
+ *
+ *   const cc = createCommonCompute({ apiKey: process.env.CC_API_KEY });
+ *   const result = await streamText({
+ *     model: cc("qwen-2.5-7b"),
+ *     messages: [{ role: "user", content: "hi" }],
+ *   });
+ *   for await (const delta of result.textStream) process.stdout.write(delta);
+ */
+interface CreateCommonComputeOptions {
+    apiKey?: string;
+    baseURL?: string;
+    org?: string;
+    /** Extra headers sent with every request. */
+    headers?: Record<string, string>;
+    /** Custom fetch implementation (testing / proxies). */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Returns a function that, given a model id, yields a LanguageModelV1
+ * compatible instance by deferring to the AI SDK's `openai` provider
+ * configured with Common Compute's base URL. This keeps us feature-
+ * parity with any upstream improvements to OpenAI's provider without
+ * having to maintain our own streaming + tool-calling implementation.
+ */
+declare function createCommonCompute(opts?: CreateCommonComputeOptions): (modelId: string) => any;
+
+export { type CreateCommonComputeOptions, createCommonCompute, createCommonCompute as default };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Vercel AI SDK provider for Common Compute.
+ *
+ * Minimal wrapper: delegates to Common Compute's OpenAI-compatible
+ * `/v1/chat/completions`. For the full AI SDK experience use the AI
+ * SDK's OpenAI provider pointed at our base URL — this package is a
+ * convenience wrapper so consumers don't have to remember the URL.
+ *
+ *   import { createCommonCompute } from "@commoncompute/vercel-ai";
+ *   import { streamText } from "ai";
+ *
+ *   const cc = createCommonCompute({ apiKey: process.env.CC_API_KEY });
+ *   const result = await streamText({
+ *     model: cc("qwen-2.5-7b"),
+ *     messages: [{ role: "user", content: "hi" }],
+ *   });
+ *   for await (const delta of result.textStream) process.stdout.write(delta);
+ */
+interface CreateCommonComputeOptions {
+    apiKey?: string;
+    baseURL?: string;
+    org?: string;
+    /** Extra headers sent with every request. */
+    headers?: Record<string, string>;
+    /** Custom fetch implementation (testing / proxies). */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Returns a function that, given a model id, yields a LanguageModelV1
+ * compatible instance by deferring to the AI SDK's `openai` provider
+ * configured with Common Compute's base URL. This keeps us feature-
+ * parity with any upstream improvements to OpenAI's provider without
+ * having to maintain our own streaming + tool-calling implementation.
+ */
+declare function createCommonCompute(opts?: CreateCommonComputeOptions): (modelId: string) => any;
+
+export { type CreateCommonComputeOptions, createCommonCompute, createCommonCompute as default };

package/dist/index.js

@@ -0,0 +1,40 @@
+// src/index.ts
+import { createRequire } from "module";
+function createCommonCompute(opts = {}) {
+  const apiKey = opts.apiKey ?? (typeof process !== "undefined" ? process.env.CC_API_KEY : void 0);
+  if (!apiKey) {
+    throw new Error("createCommonCompute: apiKey is required (or set CC_API_KEY).");
+  }
+  const baseURL = (opts.baseURL ?? (typeof process !== "undefined" ? process.env.CC_BASE_URL : void 0) ?? "https://api.commoncompute.ai") + "/v1";
+  const headers = opts.org || opts.headers ? { ...opts.headers ?? {}, ...opts.org ? { "X-CC-Org": opts.org } : {} } : void 0;
+  return (modelId) => {
+    const req = createRequire(typeof __filename === "string" ? __filename : import.meta.url);
+    let createOpenAICompatible;
+    try {
+      createOpenAICompatible = req("@ai-sdk/openai-compatible").createOpenAICompatible;
+    } catch {
+      try {
+        const { createOpenAI } = req("@ai-sdk/openai");
+        const openai = createOpenAI({ apiKey, baseURL, headers, fetch: opts.fetch });
+        return typeof openai.chat === "function" ? openai.chat(modelId) : openai(modelId);
+      } catch {
+        throw new Error(
+          "Vercel AI provider missing. Install one of: `@ai-sdk/openai-compatible` or `@ai-sdk/openai`."
+        );
+      }
+    }
+    const provider = createOpenAICompatible({
+      name: "commoncompute",
+      apiKey,
+      baseURL,
+      headers,
+      fetch: opts.fetch
+    });
+    return provider.chatModel(modelId);
+  };
+}
+var index_default = createCommonCompute;
+export {
+  createCommonCompute,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@commoncompute/vercel-ai",
+  "version": "0.1.0",
+  "description": "Vercel AI SDK provider for Common Compute.",
+  "license": "MIT",
+  "author": "Common Compute <support@commoncompute.ai>",
+  "homepage": "https://commoncompute.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ikaikaalika/commoncomputeai.git",
+    "directory": "packages/integrations-vercel-ai"
+  },
+  "keywords": [
+    "ai",
+    "vercel",
+    "ai-sdk",
+    "provider",
+    "llm",
+    "openai-compatible",
+    "apple-silicon"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@ai-sdk/openai-compatible": ">=0.0.1",
+    "@ai-sdk/openai": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/openai-compatible": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@commoncompute/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@ai-sdk/openai-compatible": "^3",
+    "@types/node": "^22",
+    "tsup": "^8",
+    "typescript": "^5.7",
+    "vitest": "^2"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --target node18",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,86 @@
+/**
+ * Vercel AI SDK provider for Common Compute.
+ *
+ * Minimal wrapper: delegates to Common Compute's OpenAI-compatible
+ * `/v1/chat/completions`. For the full AI SDK experience use the AI
+ * SDK's OpenAI provider pointed at our base URL — this package is a
+ * convenience wrapper so consumers don't have to remember the URL.
+ *
+ *   import { createCommonCompute } from "@commoncompute/vercel-ai";
+ *   import { streamText } from "ai";
+ *
+ *   const cc = createCommonCompute({ apiKey: process.env.CC_API_KEY });
+ *   const result = await streamText({
+ *     model: cc("qwen-2.5-7b"),
+ *     messages: [{ role: "user", content: "hi" }],
+ *   });
+ *   for await (const delta of result.textStream) process.stdout.write(delta);
+ */
+
+import { createRequire } from "node:module";
+
+export interface CreateCommonComputeOptions {
+  apiKey?: string;
+  baseURL?: string;
+  org?: string;
+  /** Extra headers sent with every request. */
+  headers?: Record<string, string>;
+  /** Custom fetch implementation (testing / proxies). */
+  fetch?: typeof globalThis.fetch;
+}
+
+/**
+ * Returns a function that, given a model id, yields a LanguageModelV1
+ * compatible instance by deferring to the AI SDK's `openai` provider
+ * configured with Common Compute's base URL. This keeps us feature-
+ * parity with any upstream improvements to OpenAI's provider without
+ * having to maintain our own streaming + tool-calling implementation.
+ */
+export function createCommonCompute(opts: CreateCommonComputeOptions = {}) {
+  const apiKey = opts.apiKey ?? (typeof process !== "undefined" ? process.env.CC_API_KEY : undefined);
+  if (!apiKey) {
+    throw new Error("createCommonCompute: apiKey is required (or set CC_API_KEY).");
+  }
+  const baseURL = (opts.baseURL ?? (typeof process !== "undefined" ? process.env.CC_BASE_URL : undefined) ?? "https://api.commoncompute.ai") + "/v1";
+  const headers: Record<string, string> | undefined =
+    opts.org || opts.headers ? { ...(opts.headers ?? {}), ...(opts.org ? { "X-CC-Org": opts.org } : {}) } : undefined;
+
+  return (modelId: string) => {
+    // Late-load so apps that don't install @ai-sdk/openai-compatible still
+    // get a clean error at the call site. This package ships "type":
+    // "module", so a bare `require` is undefined in the ESM build — it threw
+    // ReferenceError, both catches swallowed it, and the "provider missing"
+    // error fired even when the provider WAS installed (2026-07-17 audit).
+    // createRequire works in both builds — but the base must be __filename in
+    // the CJS build (esbuild shims import.meta to {} there, and
+    // createRequire(undefined) throws for every require() consumer).
+    const req = createRequire(typeof __filename === "string" ? __filename : import.meta.url);
+    let createOpenAICompatible: any;
+    try {
+      createOpenAICompatible = req("@ai-sdk/openai-compatible").createOpenAICompatible;
+    } catch {
+      try {
+        const { createOpenAI } = req("@ai-sdk/openai");
+        // `.chat()` forces the /chat/completions API — newer @ai-sdk/openai
+        // versions default `provider(modelId)` to OpenAI's Responses API,
+        // which Common Compute does not implement.
+        const openai = createOpenAI({ apiKey, baseURL, headers, fetch: opts.fetch });
+        return typeof openai.chat === "function" ? openai.chat(modelId) : openai(modelId);
+      } catch {
+        throw new Error(
+          "Vercel AI provider missing. Install one of: `@ai-sdk/openai-compatible` or `@ai-sdk/openai`.",
+        );
+      }
+    }
+    const provider = createOpenAICompatible({
+      name: "commoncompute",
+      apiKey,
+      baseURL,
+      headers,
+      fetch: opts.fetch,
+    });
+    return provider.chatModel(modelId);
+  };
+}
+
+export default createCommonCompute;