@bolt-ai/providers-openai 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bolt 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/dist/index.cjs

@@ -0,0 +1,200 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  buildOpenAIMessages: () => buildOpenAIMessages,
+  createOpenAIProvider: () => createOpenAIProvider,
+  fromOpenAIToolCalls: () => fromOpenAIToolCalls,
+  toOpenAITools: () => toOpenAITools
+});
+module.exports = __toCommonJS(index_exports);
+var import_openai = __toESM(require("openai"), 1);
+function createOpenAIProvider(opts = {}) {
+  const options = typeof opts === "string" ? { model: opts } : opts;
+  const apiKey = options.apiKey ?? process.env.OPENAI_API_KEY ?? "";
+  if (!apiKey && !options.client) throw new Error("OPENAI_API_KEY is required");
+  const model = options.model ?? process.env.OPENAI_MODEL ?? "gpt-4o-mini";
+  const temperature = options.temperature ?? 0.2;
+  const client = options.client ?? new import_openai.default({ apiKey });
+  return {
+    id: `openai:${model}`,
+    supports: ["text", "json"],
+    async call(args) {
+      const prompt = args.prompt ?? (typeof args.input === "string" ? args.input : JSON.stringify(args.input ?? ""));
+      const messages = buildOpenAIMessages(prompt, args.toolResults);
+      const tools = toOpenAITools(args.tools);
+      const request = buildOpenAIRequest({
+        model,
+        temperature,
+        messages,
+        tools,
+        kind: args.kind
+      });
+      if (args.onToken && args.kind === "text") {
+        const stream = await client.chat.completions.create({ ...request, stream: true });
+        return collectOpenAIStream(stream, args.onToken);
+      }
+      const resp = await client.chat.completions.create(request);
+      const raw = resp;
+      const message = raw.choices?.[0]?.message;
+      const toolCalls = fromOpenAIToolCalls(message?.tool_calls);
+      if (toolCalls.length) {
+        return { toolCalls, tokens: raw.usage?.total_tokens };
+      }
+      const content = message?.content ?? "";
+      const output = args.kind === "json" ? safeParseJSON(content) : content;
+      return { output, tokens: raw.usage?.total_tokens };
+    }
+  };
+}
+function toOpenAITools(tools) {
+  if (!tools?.length) return void 0;
+  return tools.map((tool) => ({
+    type: "function",
+    function: {
+      name: tool.id,
+      description: tool.description ?? tool.id,
+      parameters: tool.schema ?? { type: "object", properties: {} }
+    }
+  }));
+}
+function fromOpenAIToolCalls(toolCalls) {
+  if (!Array.isArray(toolCalls)) return [];
+  return toolCalls.map((toolCall) => {
+    const raw = toolCall;
+    const fn = raw?.function ?? {};
+    const toolId = String(fn.name ?? raw.toolId ?? "").trim();
+    if (!toolId) return null;
+    return {
+      id: raw.id ? String(raw.id) : void 0,
+      toolId,
+      args: parseToolArguments(fn.arguments)
+    };
+  }).filter((toolCall) => Boolean(toolCall));
+}
+function buildOpenAIMessages(prompt, toolResults) {
+  const messages = [{ role: "user", content: prompt }];
+  if (!toolResults?.length) return messages;
+  messages.push({
+    role: "assistant",
+    content: null,
+    tool_calls: toolResults.map((result) => ({
+      id: result.id,
+      type: "function",
+      function: {
+        name: result.toolId,
+        arguments: "{}"
+      }
+    }))
+  });
+  for (const result of toolResults) {
+    messages.push({
+      role: "tool",
+      tool_call_id: result.id,
+      content: stringifyToolOutput(result.output)
+    });
+  }
+  return messages;
+}
+function buildOpenAIRequest(args) {
+  return {
+    model: args.model,
+    temperature: args.temperature,
+    messages: args.messages,
+    ...args.tools?.length ? { tools: args.tools, tool_choice: "auto" } : {},
+    ...args.kind === "json" ? { response_format: { type: "json_object" } } : {}
+  };
+}
+async function collectOpenAIStream(stream, onToken) {
+  let full = "";
+  const toolCallByIndex = /* @__PURE__ */ new Map();
+  for await (const chunk of stream) {
+    const delta = chunk?.choices?.[0]?.delta ?? {};
+    const content = typeof delta.content === "string" ? delta.content : "";
+    if (content) {
+      full += content;
+      onToken(content);
+    }
+    for (const toolCall of delta.tool_calls ?? []) {
+      const index = Number.isInteger(toolCall.index) ? toolCall.index : toolCallByIndex.size;
+      const current = toolCallByIndex.get(index) ?? {
+        id: void 0,
+        type: "function",
+        function: { name: "", arguments: "" }
+      };
+      if (toolCall.id) current.id = toolCall.id;
+      if (toolCall.function?.name) current.function.name += toolCall.function.name;
+      if (toolCall.function?.arguments) current.function.arguments += toolCall.function.arguments;
+      toolCallByIndex.set(index, current);
+    }
+  }
+  const toolCalls = fromOpenAIToolCalls([...toolCallByIndex.values()]);
+  if (toolCalls.length) return { toolCalls };
+  return { output: full };
+}
+function safeParseJSON(s) {
+  try {
+    return JSON.parse(s);
+  } catch {
+    const m = s.match(/\{[\s\S]*\}|\[[\s\S]*\]/);
+    if (m) {
+      try {
+        return JSON.parse(m[0]);
+      } catch {
+      }
+    }
+    return { raw: s };
+  }
+}
+function stringifyToolOutput(output) {
+  if (typeof output === "string") return output;
+  try {
+    return JSON.stringify(output);
+  } catch {
+    return String(output);
+  }
+}
+function parseToolArguments(raw) {
+  if (typeof raw !== "string") return raw ?? {};
+  if (!raw.trim()) return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return { raw };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildOpenAIMessages,
+  createOpenAIProvider,
+  fromOpenAIToolCalls,
+  toOpenAITools
+});

package/dist/index.d.cts

@@ -0,0 +1,29 @@
+import { ModelProvider, ProviderToolDefinition, ProviderToolCall, ProviderToolResult } from '@bolt-ai/core';
+
+type OpenAIClient = {
+    chat: {
+        completions: {
+            create(args: Record<string, unknown>): Promise<unknown>;
+        };
+    };
+};
+interface OpenAIProviderOptions {
+    apiKey?: string;
+    model?: string;
+    temperature?: number;
+    client?: OpenAIClient;
+}
+declare function createOpenAIProvider(model?: string): ModelProvider;
+declare function createOpenAIProvider(opts?: OpenAIProviderOptions): ModelProvider;
+declare function toOpenAITools(tools?: ProviderToolDefinition[]): {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: any;
+    };
+}[] | undefined;
+declare function fromOpenAIToolCalls(toolCalls: unknown): ProviderToolCall[];
+declare function buildOpenAIMessages(prompt: string, toolResults?: ProviderToolResult[]): any[];
+
+export { type OpenAIProviderOptions, buildOpenAIMessages, createOpenAIProvider, fromOpenAIToolCalls, toOpenAITools };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { ModelProvider, ProviderToolDefinition, ProviderToolCall, ProviderToolResult } from '@bolt-ai/core';
+
+type OpenAIClient = {
+    chat: {
+        completions: {
+            create(args: Record<string, unknown>): Promise<unknown>;
+        };
+    };
+};
+interface OpenAIProviderOptions {
+    apiKey?: string;
+    model?: string;
+    temperature?: number;
+    client?: OpenAIClient;
+}
+declare function createOpenAIProvider(model?: string): ModelProvider;
+declare function createOpenAIProvider(opts?: OpenAIProviderOptions): ModelProvider;
+declare function toOpenAITools(tools?: ProviderToolDefinition[]): {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: any;
+    };
+}[] | undefined;
+declare function fromOpenAIToolCalls(toolCalls: unknown): ProviderToolCall[];
+declare function buildOpenAIMessages(prompt: string, toolResults?: ProviderToolResult[]): any[];
+
+export { type OpenAIProviderOptions, buildOpenAIMessages, createOpenAIProvider, fromOpenAIToolCalls, toOpenAITools };

package/dist/index.js

@@ -0,0 +1,162 @@
+// src/index.ts
+import OpenAI from "openai";
+function createOpenAIProvider(opts = {}) {
+  const options = typeof opts === "string" ? { model: opts } : opts;
+  const apiKey = options.apiKey ?? process.env.OPENAI_API_KEY ?? "";
+  if (!apiKey && !options.client) throw new Error("OPENAI_API_KEY is required");
+  const model = options.model ?? process.env.OPENAI_MODEL ?? "gpt-4o-mini";
+  const temperature = options.temperature ?? 0.2;
+  const client = options.client ?? new OpenAI({ apiKey });
+  return {
+    id: `openai:${model}`,
+    supports: ["text", "json"],
+    async call(args) {
+      const prompt = args.prompt ?? (typeof args.input === "string" ? args.input : JSON.stringify(args.input ?? ""));
+      const messages = buildOpenAIMessages(prompt, args.toolResults);
+      const tools = toOpenAITools(args.tools);
+      const request = buildOpenAIRequest({
+        model,
+        temperature,
+        messages,
+        tools,
+        kind: args.kind
+      });
+      if (args.onToken && args.kind === "text") {
+        const stream = await client.chat.completions.create({ ...request, stream: true });
+        return collectOpenAIStream(stream, args.onToken);
+      }
+      const resp = await client.chat.completions.create(request);
+      const raw = resp;
+      const message = raw.choices?.[0]?.message;
+      const toolCalls = fromOpenAIToolCalls(message?.tool_calls);
+      if (toolCalls.length) {
+        return { toolCalls, tokens: raw.usage?.total_tokens };
+      }
+      const content = message?.content ?? "";
+      const output = args.kind === "json" ? safeParseJSON(content) : content;
+      return { output, tokens: raw.usage?.total_tokens };
+    }
+  };
+}
+function toOpenAITools(tools) {
+  if (!tools?.length) return void 0;
+  return tools.map((tool) => ({
+    type: "function",
+    function: {
+      name: tool.id,
+      description: tool.description ?? tool.id,
+      parameters: tool.schema ?? { type: "object", properties: {} }
+    }
+  }));
+}
+function fromOpenAIToolCalls(toolCalls) {
+  if (!Array.isArray(toolCalls)) return [];
+  return toolCalls.map((toolCall) => {
+    const raw = toolCall;
+    const fn = raw?.function ?? {};
+    const toolId = String(fn.name ?? raw.toolId ?? "").trim();
+    if (!toolId) return null;
+    return {
+      id: raw.id ? String(raw.id) : void 0,
+      toolId,
+      args: parseToolArguments(fn.arguments)
+    };
+  }).filter((toolCall) => Boolean(toolCall));
+}
+function buildOpenAIMessages(prompt, toolResults) {
+  const messages = [{ role: "user", content: prompt }];
+  if (!toolResults?.length) return messages;
+  messages.push({
+    role: "assistant",
+    content: null,
+    tool_calls: toolResults.map((result) => ({
+      id: result.id,
+      type: "function",
+      function: {
+        name: result.toolId,
+        arguments: "{}"
+      }
+    }))
+  });
+  for (const result of toolResults) {
+    messages.push({
+      role: "tool",
+      tool_call_id: result.id,
+      content: stringifyToolOutput(result.output)
+    });
+  }
+  return messages;
+}
+function buildOpenAIRequest(args) {
+  return {
+    model: args.model,
+    temperature: args.temperature,
+    messages: args.messages,
+    ...args.tools?.length ? { tools: args.tools, tool_choice: "auto" } : {},
+    ...args.kind === "json" ? { response_format: { type: "json_object" } } : {}
+  };
+}
+async function collectOpenAIStream(stream, onToken) {
+  let full = "";
+  const toolCallByIndex = /* @__PURE__ */ new Map();
+  for await (const chunk of stream) {
+    const delta = chunk?.choices?.[0]?.delta ?? {};
+    const content = typeof delta.content === "string" ? delta.content : "";
+    if (content) {
+      full += content;
+      onToken(content);
+    }
+    for (const toolCall of delta.tool_calls ?? []) {
+      const index = Number.isInteger(toolCall.index) ? toolCall.index : toolCallByIndex.size;
+      const current = toolCallByIndex.get(index) ?? {
+        id: void 0,
+        type: "function",
+        function: { name: "", arguments: "" }
+      };
+      if (toolCall.id) current.id = toolCall.id;
+      if (toolCall.function?.name) current.function.name += toolCall.function.name;
+      if (toolCall.function?.arguments) current.function.arguments += toolCall.function.arguments;
+      toolCallByIndex.set(index, current);
+    }
+  }
+  const toolCalls = fromOpenAIToolCalls([...toolCallByIndex.values()]);
+  if (toolCalls.length) return { toolCalls };
+  return { output: full };
+}
+function safeParseJSON(s) {
+  try {
+    return JSON.parse(s);
+  } catch {
+    const m = s.match(/\{[\s\S]*\}|\[[\s\S]*\]/);
+    if (m) {
+      try {
+        return JSON.parse(m[0]);
+      } catch {
+      }
+    }
+    return { raw: s };
+  }
+}
+function stringifyToolOutput(output) {
+  if (typeof output === "string") return output;
+  try {
+    return JSON.stringify(output);
+  } catch {
+    return String(output);
+  }
+}
+function parseToolArguments(raw) {
+  if (typeof raw !== "string") return raw ?? {};
+  if (!raw.trim()) return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return { raw };
+  }
+}
+export {
+  buildOpenAIMessages,
+  createOpenAIProvider,
+  fromOpenAIToolCalls,
+  toOpenAITools
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@bolt-ai/providers-openai",
+  "version": "1.0.0",
+  "description": "OpenAI model provider adapter for Bolt AI agents.",
+  "license": "MIT",
+  "author": "Bolt AI",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TheCypher/Bolt-Agentic.git"
+  },
+  "homepage": "https://github.com/TheCypher/Bolt-Agentic#readme",
+  "bugs": {
+    "url": "https://github.com/TheCypher/Bolt-Agentic/issues"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "openai",
+    "providers",
+    "bolt"
+  ],
+  "type": "module",
+  "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"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@bolt-ai/core": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@bolt-ai/core": {
+      "optional": false
+    }
+  },
+  "dependencies": {
+    "openai": "^6.42.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.5.0",
+    "rimraf": "^6.0.1",
+    "@bolt-ai/core": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --dts --format esm,cjs --tsconfig tsconfig.json",
+    "clean": "rimraf dist"
+  }
+}