@kb-labs/adapters 0.5.0

package/packages/adapters-mongodb/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@kb-labs/devkit/tsconfig/node.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/packages/adapters-mongodb/tsup.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'tsup';
+import nodePreset from '@kb-labs/devkit/tsup/node';
+
+export default defineConfig({
+  ...nodePreset,
+  tsconfig: 'tsconfig.build.json',
+  dts: true,
+});

package/packages/adapters-openai/README.md

@@ -0,0 +1,151 @@
+# @kb-labs/adapters-openai
+
+> Part of [KB Labs](https://github.com/KirillBaranov/kb-labs) ecosystem. Works exclusively within KB Labs platform.
+
+OpenAI language model adapter supporting GPT-4, GPT-3.5, and other OpenAI models with streaming and function calling.
+
+## Overview
+
+| Property | Value |
+|----------|-------|
+| **Implements** | `ILLM` |
+| **Type** | `core` |
+| **Requires** | None |
+| **Category** | AI |
+
+## Features
+
+- **Multiple Models** - GPT-4, GPT-4 Turbo, GPT-3.5 Turbo
+- **Streaming Support** - Real-time token streaming
+- **Function Calling** - Native tool/function support
+- **Configurable** - Temperature, max tokens, and more
+
+## Installation
+
+```bash
+pnpm add @kb-labs/adapters-openai
+```
+
+## Configuration
+
+Add to your `kb.config.json`:
+
+```json
+{
+  "platform": {
+    "adapters": {
+      "llm": "@kb-labs/adapters-openai"
+    },
+    "adapterOptions": {
+      "llm": {
+        "apiKey": "${OPENAI_API_KEY}",
+        "model": "gpt-4-turbo",
+        "temperature": 0.7
+      }
+    }
+  }
+}
+```
+
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | - | OpenAI API key |
+| `model` | `string` | `"gpt-4-turbo"` | Model to use |
+| `temperature` | `number` | `0.7` | Sampling temperature (0.0 to 2.0) |
+| `maxTokens` | `number` | - | Maximum tokens to generate |
+
+## Usage
+
+### Via Platform (Recommended)
+
+```typescript
+import { usePlatform } from '@kb-labs/sdk';
+
+const platform = usePlatform();
+
+// Simple chat
+const response = await platform.llm.chat([
+  { role: 'user', content: 'Hello!' }
+]);
+
+// Streaming
+for await (const chunk of platform.llm.stream([
+  { role: 'user', content: 'Tell me a story' }
+])) {
+  process.stdout.write(chunk.content);
+}
+
+// With function calling
+const result = await platform.llm.chatWithTools(
+  [{ role: 'user', content: 'What is the weather?' }],
+  [{ name: 'getWeather', parameters: { ... } }]
+);
+```
+
+### Standalone (Testing/Development)
+
+```typescript
+import { createAdapter } from '@kb-labs/adapters-openai';
+
+const llm = createAdapter({
+  apiKey: process.env.OPENAI_API_KEY,
+  model: 'gpt-4-turbo'
+});
+
+const response = await llm.chat([
+  { role: 'user', content: 'Hello!' }
+]);
+```
+
+## Adapter Manifest
+
+```typescript
+{
+  id: 'openai-llm',
+  name: 'OpenAI LLM',
+  version: '1.0.0',
+  implements: 'ILLM',
+  capabilities: {
+    streaming: true,
+    custom: {
+      functionCalling: true,
+    },
+  },
+}
+```
+
+## FAQ
+
+<details>
+<summary><strong>Q: How do I switch models?</strong></summary>
+
+Change the `model` option:
+
+```json
+{
+  "adapterOptions": {
+    "llm": {
+      "model": "gpt-3.5-turbo"
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Q: How do I handle rate limits?</strong></summary>
+
+The adapter includes automatic retry with exponential backoff. For high-volume usage, consider using OpenAI's usage tiers or implement request queuing.
+</details>
+
+## Related Adapters
+
+| Adapter | Use Case |
+|---------|----------|
+| `@kb-labs/adapters-vibeproxy` | Local multi-provider proxy (Claude, GPT, etc.) |
+
+## License
+
+[KB Public License v1.1](../../LICENSE) - KB Labs Team

package/packages/adapters-openai/embeddings.ts

@@ -0,0 +1,37 @@
+/**
+ * @module @kb-labs/adapters-openai/embeddings
+ * OpenAI embeddings adapter entry point.
+ *
+ * This file provides a separate entry point for the embeddings adapter,
+ * allowing it to be loaded independently from the LLM adapter.
+ *
+ * @example
+ * ```json
+ * // In kb.config.json
+ * {
+ *   "platform": {
+ *     "adapters": {
+ *       "embeddings": "@kb-labs/adapters-openai/embeddings"
+ *     }
+ *   }
+ * }
+ * ```
+ */
+
+import { OpenAIEmbeddings, type OpenAIEmbeddingsConfig } from './src/embeddings.js';
+
+// Re-export manifest
+export { manifest } from './src/embeddings-manifest.js';
+
+// Re-export types and class
+export { OpenAIEmbeddings, type OpenAIEmbeddingsConfig, EMBEDDING_MODELS, type EmbeddingModel } from './src/embeddings.js';
+
+/**
+ * Create OpenAI embeddings adapter.
+ */
+export function createAdapter(config?: OpenAIEmbeddingsConfig): OpenAIEmbeddings {
+  return new OpenAIEmbeddings(config);
+}
+
+// Default export
+export default createAdapter;

package/packages/adapters-openai/eslint.config.js

@@ -0,0 +1,26 @@
+/**
+ * Standard ESLint configuration template
+ *
+ * This is the canonical template for all @kb-labs packages.
+ * DO NOT modify this file locally - it is synced from @kb-labs/devkit
+ *
+ * Customization guidelines:
+ * - DevKit preset already includes all standard ignores
+ * - Only add project-specific ignores if absolutely necessary
+ * - Document why custom ignores are needed
+ *
+ * @see https://github.com/kb-labs/devkit#eslint-configuration
+ */
+import nodePreset from '@kb-labs/devkit/eslint/node.js';
+
+export default [
+  ...nodePreset,
+
+  // Project-specific ignores
+  {
+    ignores: [
+      // Ignore tsup bundled config files
+      '**/*.bundled_*.mjs',
+    ]
+  }
+];

package/packages/adapters-openai/index.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenAI LLM adapter entry point.
+ * Re-exports from src/ for clean dist structure.
+ */
+
+import { OpenAILLM, type OpenAILLMConfig } from './src/index.js';
+
+// Re-export manifest
+export { manifest } from './src/manifest.js';
+
+// Re-export types and class
+export { OpenAILLM, type OpenAILLMConfig } from './src/index.js';
+
+/**
+ * Create OpenAI LLM adapter.
+ */
+export function createAdapter(config?: OpenAILLMConfig): OpenAILLM {
+  return new OpenAILLM(config);
+}
+
+// Default export
+export default createAdapter;

package/packages/adapters-openai/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@kb-labs/adapters-openai",
+  "version": "0.5.0",
+  "description": "OpenAI adapter implementing ILLM and IEmbeddings interfaces",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./llm": {
+      "import": "./dist/llm.js",
+      "types": "./dist/llm.d.ts"
+    },
+    "./embeddings": {
+      "import": "./dist/embeddings.js",
+      "types": "./dist/embeddings.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix"
+  },
+  "dependencies": {
+    "openai": "^4.104.0"
+  },
+  "peerDependencies": {
+    "@kb-labs/core-platform": "*"
+  },
+  "devDependencies": {
+    "@kb-labs/core-platform": "link:../../../../platform/kb-labs-core/packages/core-platform",
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4",
+    "@kb-labs/devkit": "link:../../../kb-labs-devkit",
+    "rimraf": "^6.0.1"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}

package/packages/adapters-openai/src/embeddings-manifest.ts

@@ -0,0 +1,45 @@
+/**
+ * @module @kb-labs/adapters-openai/embeddings-manifest
+ * Adapter manifest for OpenAI embeddings.
+ */
+
+import type { AdapterManifest } from "@kb-labs/core-platform";
+
+/**
+ * Adapter manifest for OpenAI embeddings.
+ */
+export const manifest: AdapterManifest = {
+  manifestVersion: "1.0.0",
+  id: "openai-embeddings",
+  name: "OpenAI Embeddings",
+  version: "1.0.0",
+  description:
+    "OpenAI text embeddings adapter (text-embedding-3-small, text-embedding-3-large, etc.)",
+  author: "KB Labs",
+  license: "MIT",
+  type: "core",
+  implements: "IEmbeddings",
+  capabilities: {
+    batch: true,
+  },
+  configSchema: {
+    apiKey: {
+      type: "string",
+      description: "OpenAI API key (defaults to OPENAI_API_KEY env var)",
+    },
+    model: {
+      type: "string",
+      default: "text-embedding-3-small",
+      description: "Embedding model to use",
+      enum: [
+        "text-embedding-3-small",
+        "text-embedding-3-large",
+        "text-embedding-ada-002",
+      ],
+    },
+    dimensions: {
+      type: "number",
+      description: "Number of dimensions (for v3 models)",
+    },
+  },
+};

package/packages/adapters-openai/src/embeddings.ts

@@ -0,0 +1,104 @@
+/**
+ * @module @kb-labs/adapters-openai/embeddings
+ * OpenAI implementation of IEmbeddings interface.
+ */
+
+import OpenAI from "openai";
+import type { IEmbeddings } from "@kb-labs/core-platform";
+
+/**
+ * Supported OpenAI embedding models and their dimensions.
+ */
+export const EMBEDDING_MODELS = {
+  "text-embedding-3-small": 1536,
+  "text-embedding-3-large": 3072,
+  "text-embedding-ada-002": 1536,
+} as const;
+
+export type EmbeddingModel = keyof typeof EMBEDDING_MODELS;
+
+/**
+ * Configuration for OpenAI embeddings adapter.
+ */
+export interface OpenAIEmbeddingsConfig {
+  /** OpenAI API key (defaults to OPENAI_API_KEY env var) */
+  apiKey?: string;
+  /** Base URL for API (optional, for proxies or Azure) */
+  baseURL?: string;
+  /** Embedding model to use */
+  model?: EmbeddingModel;
+  /** Organization ID (optional) */
+  organization?: string;
+}
+
+/**
+ * OpenAI implementation of IEmbeddings interface.
+ */
+export class OpenAIEmbeddings implements IEmbeddings {
+  private client: OpenAI;
+  private model: EmbeddingModel;
+  readonly dimensions: number;
+
+  constructor(config: OpenAIEmbeddingsConfig = {}) {
+    this.client = new OpenAI({
+      apiKey: config.apiKey ?? process.env.OPENAI_API_KEY,
+      baseURL: config.baseURL,
+      organization: config.organization,
+    });
+    this.model = config.model ?? "text-embedding-3-small";
+    this.dimensions = EMBEDDING_MODELS[this.model];
+  }
+
+  async embed(text: string): Promise<number[]> {
+    const response = await this.client.embeddings.create({
+      model: this.model,
+      input: text,
+    });
+
+    const first = response.data[0];
+    if (!first) {
+      throw new Error("OpenAI embeddings API returned empty response");
+    }
+    return first.embedding;
+  }
+
+  async embedBatch(texts: string[]): Promise<number[][]> {
+    if (texts.length === 0) {
+      return [];
+    }
+
+    // OpenAI supports batching natively
+    const response = await this.client.embeddings.create({
+      model: this.model,
+      input: texts,
+    });
+
+    // Sort by index to maintain order
+    const sorted = response.data.sort((a, b) => a.index - b.index);
+    return sorted.map((item) => item.embedding);
+  }
+
+  /**
+   * Get the dimensions of the embeddings.
+   * This method is needed for IPC/Unix Socket transport to access the dimensions property.
+   */
+  async getDimensions(): Promise<number> {
+    return this.dimensions;
+  }
+}
+
+/**
+ * Create OpenAI embeddings adapter.
+ * This is the factory function called by initPlatform() when loading adapters.
+ */
+export function createAdapter(
+  config?: OpenAIEmbeddingsConfig,
+): OpenAIEmbeddings {
+  return new OpenAIEmbeddings(config);
+}
+
+// Re-export manifest for adapter loading
+export { manifest } from "./embeddings-manifest.js";
+
+// Default export for direct import
+export default createAdapter;

package/packages/adapters-openai/src/index.ts

@@ -0,0 +1,13 @@
+/**
+ * @module @kb-labs/adapters-openai
+ * OpenAI LLM adapter entry point.
+ */
+
+// Re-export LLM adapter as default
+export { OpenAILLM, type OpenAILLMConfig, createAdapter } from "./llm.js";
+
+// Re-export manifest
+export { manifest } from "./manifest.js";
+
+// Default export
+export { createAdapter as default } from "./llm.js";