rust-kgdb 0.5.9 → 0.5.11

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to the rust-kgdb TypeScript SDK will be documented in this file.
 
+## [0.5.11] - 2025-12-15
+
+### Documentation Clarification
+
+- Clarified that embedding providers (OpenAI, Voyage AI) are third-party libraries, not built into rust-kgdb
+- Updated examples to show `fetch` API for Voyage AI instead of non-existent SDK
+- Added "bring your own embeddings" messaging to make provider abstraction clear
+- rust-kgdb's EmbeddingService stores/searches vectors; users provide embeddings from their preferred provider
+
+## [0.5.10] - 2025-12-15
+
+### Documentation Cleanup
+
+- Removed naming disclaimer note from README header
+
 ## [0.5.9] - 2025-12-15
 
 ### Expert-Level Documentation - Complete Neuro-Symbolic AI Framework

package/README.md

@@ -6,8 +6,6 @@
 
 > **Two-Layer Architecture**: High-performance Rust knowledge graph database + HyperMind neuro-symbolic agent framework with mathematical foundations.
 
-**Naming Note**: The `GraphDB` class in this SDK is not affiliated with [Ontotext GraphDB](https://www.ontotext.com/products/graphdb/). The `GraphFrame` API is inspired by [Apache Spark GraphFrames](https://graphframes.github.io/graphframes/docs/_site/index.html).
-
 ---
 
 ## Architecture: What Powers rust-kgdb
@@ -311,11 +309,13 @@ const voteResults = service.findSimilarComposite('CLM001', 10, 0.7, 'voting') //
 
 ### Provider Configuration
 
-Configure your embedding providers with API keys:
+rust-kgdb's `EmbeddingService` stores and searches vectors - you bring your own embeddings from any provider. Here are examples using popular third-party libraries:
 
 ```javascript
-// Example: Using OpenAI embeddings
-const { OpenAI } = require('openai')
+// ============================================================
+// EXAMPLE: Using OpenAI embeddings (requires: npm install openai)
+// ============================================================
+const { OpenAI } = require('openai')  // Third-party library
 const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY })
 
 async function getOpenAIEmbedding(text) {
@@ -327,17 +327,31 @@ async function getOpenAIEmbedding(text) {
   return response.data[0].embedding
 }
 
-// Example: Using Anthropic (via their embedding partner)
-// Note: Anthropic doesn't provide embeddings directly; use Voyage AI
-const { VoyageAIClient } = require('voyageai')
-const voyage = new VoyageAIClient({ apiKey: process.env.VOYAGE_API_KEY })
-
+// ============================================================
+// EXAMPLE: Using Voyage AI (requires: npm install voyageai)
+// Note: Anthropic recommends Voyage AI for embeddings
+// ============================================================
 async function getVoyageEmbedding(text) {
-  const response = await voyage.embed({
-    input: text,
-    model: 'voyage-2'
+  // Using fetch directly (no SDK required)
+  const response = await fetch('https://api.voyageai.com/v1/embeddings', {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${process.env.VOYAGE_API_KEY}`,
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify({ input: text, model: 'voyage-2' })
   })
-  return response.embeddings[0].slice(0, 384)  // Truncate to 384-dim
+  const data = await response.json()
+  return data.data[0].embedding.slice(0, 384)  // Truncate to 384-dim
+}
+
+// ============================================================
+// EXAMPLE: Mock embeddings for testing (no external deps)
+// ============================================================
+function getMockEmbedding(text) {
+  return new Array(384).fill(0).map((_, i) =>
+    Math.sin(text.charCodeAt(i % text.length) * 0.1) * 0.5 + 0.5
+  )
 }
 ```
 
@@ -1226,11 +1240,12 @@ const db = new GraphDB('http://insurance.org/fraud-kb')
 const embeddings = new EmbeddingService()
 
 // ============================================================
-// STEP 3: Configure Embedding Provider
+// STEP 3: Configure Embedding Provider (bring your own)
 // ============================================================
 async function getEmbedding(text) {
   switch (EMBEDDING_PROVIDER) {
     case 'openai':
+      // Requires: npm install openai
       const { OpenAI } = require('openai')
       const openai = new OpenAI({ apiKey: OPENAI_API_KEY })
       const resp = await openai.embeddings.create({
@@ -1241,12 +1256,19 @@ async function getEmbedding(text) {
       return resp.data[0].embedding
 
     case 'voyage':
-      const { VoyageAIClient } = require('voyageai')
-      const voyage = new VoyageAIClient({ apiKey: VOYAGE_API_KEY })
-      const vResp = await voyage.embed({ input: text, model: 'voyage-2' })
-      return vResp.embeddings[0].slice(0, EMBEDDING_DIM)
+      // Using fetch directly (no SDK required)
+      const vResp = await fetch('https://api.voyageai.com/v1/embeddings', {
+        method: 'POST',
+        headers: {
+          'Authorization': `Bearer ${VOYAGE_API_KEY}`,
+          'Content-Type': 'application/json'
+        },
+        body: JSON.stringify({ input: text, model: 'voyage-2' })
+      })
+      const vData = await vResp.json()
+      return vData.data[0].embedding.slice(0, EMBEDDING_DIM)
 
-    default: // Mock embeddings for testing
+    default: // Mock embeddings for testing (no external deps)
       return new Array(EMBEDDING_DIM).fill(0).map((_, i) =>
         Math.sin(text.charCodeAt(i % text.length) * 0.1) * 0.5 + 0.5
       )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rust-kgdb",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "description": "Production-grade Neuro-Symbolic AI Framework: +86.4% accuracy improvement over vanilla LLMs. High-performance knowledge graph (2.78µs lookups, 35x faster than RDFox). Features fraud detection, underwriting agents, WASM sandbox, type/category/proof theory, and W3C SPARQL 1.1 compliance.",
   "main": "index.js",
   "types": "index.d.ts",