@core-ai/openai-compat 0.14.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Omnifact (https://omnifact.ai)
+
+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,63 @@
+# @core-ai/openai-compat
+
+OpenAI-compatible Chat Completions provider for `@core-ai/core-ai`.
+
+## Installation
+
+```bash
+npm install @core-ai/core-ai @core-ai/openai-compat zod
+```
+
+## Usage
+
+```ts
+import { generate } from '@core-ai/core-ai';
+import { createOpenAICompat } from '@core-ai/openai-compat';
+
+const provider = createOpenAICompat({
+    apiKey: process.env.API_KEY,
+    baseURL: 'https://gateway.example.com/v1',
+});
+
+const result = await generate({
+    model: provider.chatModel('qwen3-235b'),
+    messages: [{ role: 'user', content: 'Hello!' }],
+});
+
+console.log(result.content);
+```
+
+Known OpenAI models map `maxTokens` to the parameter required by Chat
+Completions. Unknown model IDs default to `max_tokens`. Set a provider-wide
+compatibility default when an endpoint requires `max_completion_tokens`:
+
+```ts
+const provider = createOpenAICompat({
+    apiKey: process.env.API_KEY,
+    baseURL: 'https://gateway.example.com/v1',
+    maxTokensParameter: 'max_completion_tokens',
+});
+
+await generate({
+    model: provider.chatModel('custom-reasoning-model'),
+    messages: [{ role: 'user', content: 'Hello!' }],
+    maxTokens: 1024,
+});
+```
+
+This provider only exposes Chat Completions models. It accepts known
+nonstandard response fields used by OpenAI-compatible gateways, including
+`reasoning_content` and `reasoning`. Set `reasoning: false` when those fields
+should not be interpreted as reasoning output.
+
+Structured output uses a forced function tool by default for broad endpoint
+compatibility. If the endpoint supports strict JSON Schema response formats,
+opt in with `structuredOutputMode: 'native'`:
+
+```ts
+const provider = createOpenAICompat({
+    apiKey: process.env.API_KEY,
+    baseURL: 'https://gateway.example.com/v1',
+    structuredOutputMode: 'native',
+});
+```

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { ChatModel } from '@core-ai/core-ai';
+import { OpenAIProviderBaseOptions, OpenAIStructuredOutputMode, OpenAICompatibilityOptions } from '@core-ai/openai';
+
+type OpenAICompatProviderOptions = OpenAIProviderBaseOptions & {
+    /** Whether to extract nonstandard reasoning response fields. Defaults to `true`. */
+    reasoning?: boolean;
+    /**
+     * Structured output transport. Defaults to `tool` for broad compatibility.
+     * Use `native` when the endpoint supports strict JSON Schema response formats.
+     */
+    structuredOutputMode?: OpenAIStructuredOutputMode;
+    /**
+     * Request parameter used for `maxTokens`. When unset, known OpenAI models
+     * use their registered capability and unknown models use `max_tokens`.
+     */
+    maxTokensParameter?: OpenAICompatibilityOptions['maxTokensParameter'];
+};
+type OpenAICompatProvider = {
+    chatModel(modelId: string): ChatModel;
+};
+declare function createOpenAICompat(options?: OpenAICompatProviderOptions): OpenAICompatProvider;
+
+export { type OpenAICompatProvider, type OpenAICompatProviderOptions, createOpenAICompat };

package/dist/index.js

@@ -0,0 +1,21 @@
+// src/provider.ts
+import {
+  createOpenAIProvider
+} from "@core-ai/openai";
+function createOpenAICompat(options = {}) {
+  const provider = createOpenAIProvider(options, {
+    providerId: "openai-compat",
+    defaultApi: "chat-completions",
+    compatibility: {
+      reasoning: options.reasoning,
+      structuredOutputMode: options.structuredOutputMode,
+      maxTokensParameter: options.maxTokensParameter
+    }
+  });
+  return {
+    chatModel: provider.chatModel
+  };
+}
+export {
+  createOpenAICompat
+};

package/package.json

@@ -0,0 +1,61 @@
+{
+    "name": "@core-ai/openai-compat",
+    "version": "0.14.0",
+    "description": "OpenAI-compatible Chat Completions provider for @core-ai/core-ai",
+    "license": "MIT",
+    "author": "Omnifact (https://omnifact.ai)",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/agdevhq/core-ai.git",
+        "directory": "packages/openai-compat"
+    },
+    "keywords": [
+        "llm",
+        "ai",
+        "openai",
+        "openai-compatible",
+        "provider",
+        "sdk"
+    ],
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "scripts": {
+        "build": "tsup",
+        "lint": "eslint src/ --max-warnings 0",
+        "check-types": "tsc --noEmit",
+        "test": "vitest run",
+        "test:watch": "vitest"
+    },
+    "dependencies": {
+        "@core-ai/core-ai": "^0.14.0",
+        "@core-ai/openai": "^0.14.0"
+    },
+    "peerDependencies": {
+        "zod": "^4.0.0"
+    },
+    "devDependencies": {
+        "@core-ai/eslint-config": "*",
+        "@core-ai/testing": "*",
+        "@core-ai/typescript-config": "*",
+        "typescript": "^5.7.3",
+        "vitest": "^3.2.4"
+    }
+}