@sparkleideas/embeddings 3.0.0-alpha.15 → 3.0.0-alpha.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkleideas/embeddings",
-  "version": "3.0.0-alpha.15",
+  "version": "3.0.0-alpha.16",
   "description": "V3 Embedding Service - OpenAI, Transformers.js, Agentic-Flow (ONNX), Mock providers with hyperbolic embeddings, normalization, and chunking",
   "type": "module",
   "main": "./dist/index.js",

package/src/embedding-service.ts

@@ -1,7 +1,7 @@
 /**
  * V3 Embedding Service Implementation
  *
- * Production embedding service aligned with @sparkleideas/agentic-flow@alpha:
+ * Production embedding service aligned with agentic-flow@alpha:
  * - OpenAI provider (text-embedding-3-small/large)
  * - Transformers.js provider (local ONNX models)
  * - Mock provider (development/testing)
@@ -598,7 +598,7 @@ export class MockEmbeddingService extends BaseEmbeddingService {
  * - 3-4x faster batch processing
  */
 export class AgenticFlowEmbeddingService extends BaseEmbeddingService {
-  readonly provider: EmbeddingProvider = '@sparkleideas/agentic-flow';
+  readonly provider: EmbeddingProvider = 'agentic-flow';
   private embedder: any = null;
   private initialized = false;
   private readonly modelId: string;
@@ -656,7 +656,7 @@ export class AgenticFlowEmbeddingService extends BaseEmbeddingService {
     const possiblePaths: string[] = [];
 
     // Try proper package exports first (preferred)
-    possiblePaths.push('@sparkleideas/agentic-flow/embeddings');
+    possiblePaths.push('agentic-flow/embeddings');
 
     // Try node_modules resolution from different locations (for file:// imports)
     try {
@@ -689,9 +689,9 @@ export class AgenticFlowEmbeddingService extends BaseEmbeddingService {
 
     const errorDetail = lastError?.message ? ` Last error: ${lastError.message}` : '';
     throw new Error(
-      `Failed to initialize @sparkleideas/agentic-flow embeddings.${errorDetail} ` +
-      `Ensure @sparkleideas/agentic-flow is installed and ONNX model is downloaded: ` +
-      `npx @sparkleideas/agentic-flow@alpha embeddings init`
+      `Failed to initialize agentic-flow embeddings.${errorDetail} ` +
+      `Ensure agentic-flow is installed and ONNX model is downloaded: ` +
+      `npx agentic-flow@alpha embeddings init`
     );
   }
 
@@ -713,7 +713,7 @@ export class AgenticFlowEmbeddingService extends BaseEmbeddingService {
     const startTime = performance.now();
 
     try {
-      // Use @sparkleideas/agentic-flow's optimized embedder (has its own internal cache)
+      // Use agentic-flow's optimized embedder (has its own internal cache)
       const embedding = await this.embedder.embed(text);
 
       // Store in our cache as well
@@ -820,11 +820,11 @@ export class AgenticFlowEmbeddingService extends BaseEmbeddingService {
 // ============================================================================
 
 /**
- * Check if @sparkleideas/agentic-flow is available
+ * Check if agentic-flow is available
  */
 async function isAgenticFlowAvailable(): Promise<boolean> {
   try {
-    await import('@sparkleideas/agentic-flow/embeddings');
+    await import('agentic-flow/embeddings');
     return true;
   } catch {
     return false;
@@ -832,7 +832,7 @@ async function isAgenticFlowAvailable(): Promise<boolean> {
 }
 
 /**
- * Auto-install @sparkleideas/agentic-flow and initialize model
+ * Auto-install agentic-flow and initialize model
  */
 async function autoInstallAgenticFlow(): Promise<boolean> {
   const { exec } = await import('child_process');
@@ -845,12 +845,12 @@ async function autoInstallAgenticFlow(): Promise<boolean> {
       return true;
     }
 
-    console.log('[embeddings] Installing @sparkleideas/agentic-flow@alpha...');
-    await execAsync('npm install @sparkleideas/agentic-flow@alpha --save', { timeout: 120000 });
+    console.log('[embeddings] Installing agentic-flow@alpha...');
+    await execAsync('npm install agentic-flow@alpha --save', { timeout: 120000 });
 
     // Initialize the model
     console.log('[embeddings] Downloading embedding model...');
-    await execAsync('npx @sparkleideas/agentic-flow@alpha embeddings init', { timeout: 300000 });
+    await execAsync('npx agentic-flow@alpha embeddings init', { timeout: 300000 });
 
     // Verify installation
     return await isAgenticFlowAvailable();
@@ -872,7 +872,7 @@ export function createEmbeddingService(config: EmbeddingConfig): IEmbeddingServi
       return new TransformersEmbeddingService(config as TransformersEmbeddingConfig);
     case 'mock':
       return new MockEmbeddingService(config as MockEmbeddingConfig);
-    case '@sparkleideas/agentic-flow':
+    case 'agentic-flow':
       return new AgenticFlowEmbeddingService(config as AgenticFlowEmbeddingConfig);
     default:
       console.warn(`Unknown provider, using mock`);
@@ -884,13 +884,13 @@ export function createEmbeddingService(config: EmbeddingConfig): IEmbeddingServi
  * Extended config with auto provider option
  */
 export interface AutoEmbeddingConfig {
-  /** Provider: 'auto' will pick best available (@sparkleideas/agentic-flow > transformers > mock) */
+  /** Provider: 'auto' will pick best available (agentic-flow > transformers > mock) */
   provider: EmbeddingProvider | 'auto';
   /** Fallback provider if primary fails */
   fallback?: EmbeddingProvider;
-  /** Auto-install @sparkleideas/agentic-flow if not available (default: true for 'auto' provider) */
+  /** Auto-install agentic-flow if not available (default: true for 'auto' provider) */
   autoInstall?: boolean;
-  /** Model ID for @sparkleideas/agentic-flow */
+  /** Model ID for agentic-flow */
   modelId?: string;
   /** Model name for transformers */
   model?: string;
@@ -906,7 +906,7 @@ export interface AutoEmbeddingConfig {
  * Create embedding service with automatic provider detection and fallback
  *
  * Features:
- * - 'auto' provider picks best available: @sparkleideas/agentic-flow > transformers > mock
+ * - 'auto' provider picks best available: agentic-flow > transformers > mock
  * - Automatic fallback if primary provider fails to initialize
  * - Pre-validates provider availability before returning
  *
@@ -914,9 +914,9 @@ export interface AutoEmbeddingConfig {
  * // Auto-select best provider
  * const service = await createEmbeddingServiceAsync({ provider: 'auto' });
  *
- * // Try @sparkleideas/agentic-flow, fallback to transformers
+ * // Try agentic-flow, fallback to transformers
  * const service = await createEmbeddingServiceAsync({
- *   provider: '@sparkleideas/agentic-flow',
+ *   provider: 'agentic-flow',
  *   fallback: 'transformers'
  * });
  */
@@ -927,7 +927,7 @@ export async function createEmbeddingServiceAsync(
 
   // Auto provider selection
   if (provider === 'auto') {
-    // Try @sparkleideas/agentic-flow first (fastest, ONNX-based)
+    // Try agentic-flow first (fastest, ONNX-based)
     let agenticFlowAvailable = await isAgenticFlowAvailable();
 
     // Auto-install if not available and autoInstall is enabled
@@ -938,7 +938,7 @@ export async function createEmbeddingServiceAsync(
     if (agenticFlowAvailable) {
       try {
         const service = new AgenticFlowEmbeddingService({
-          provider: '@sparkleideas/agentic-flow',
+          provider: 'agentic-flow',
           modelId: rest.modelId ?? 'all-MiniLM-L6-v2',
           dimensions: rest.dimensions ?? 384,
           cacheSize: rest.cacheSize,
@@ -966,7 +966,7 @@ export async function createEmbeddingServiceAsync(
     }
 
     // Fallback to mock (always works)
-    console.warn('[embeddings] Using mock provider - install @sparkleideas/agentic-flow or @xenova/transformers for real embeddings');
+    console.warn('[embeddings] Using mock provider - install agentic-flow or @xenova/transformers for real embeddings');
     return new MockEmbeddingService({
       dimensions: rest.dimensions ?? 384,
       cacheSize: rest.cacheSize,
@@ -976,9 +976,9 @@ export async function createEmbeddingServiceAsync(
   // Specific provider with optional fallback
   const createPrimary = (): IEmbeddingService => {
     switch (provider) {
-      case '@sparkleideas/agentic-flow':
+      case 'agentic-flow':
         return new AgenticFlowEmbeddingService({
-          provider: '@sparkleideas/agentic-flow',
+          provider: 'agentic-flow',
           modelId: rest.modelId ?? 'all-MiniLM-L6-v2',
           dimensions: rest.dimensions ?? 384,
           cacheSize: rest.cacheSize,

package/src/index.ts

@@ -1,7 +1,7 @@
 /**
  * V3 Embedding Service Module
  *
- * Production embedding service aligned with @sparkleideas/agentic-flow@alpha:
+ * Production embedding service aligned with agentic-flow@alpha:
  * - OpenAI provider (text-embedding-3-small/large)
  * - Transformers.js provider (local ONNX models)
  * - Agentic-flow provider (optimized ONNX with SIMD)

package/src/neural-integration.ts

@@ -1,7 +1,7 @@
 /**
  * Neural Substrate Integration
  *
- * Integrates @sparkleideas/agentic-flow's neural embedding features:
+ * Integrates agentic-flow's neural embedding features:
  * - Semantic drift detection
  * - Memory physics (hippocampal dynamics)
  * - Embedding state machine
@@ -11,7 +11,7 @@
  * These features treat embeddings as a synthetic nervous system.
  */
 
-// Types from @sparkleideas/agentic-flow/embeddings
+// Types from agentic-flow/embeddings
 export interface DriftResult {
   distance: number;
   velocity: number;
@@ -66,7 +66,7 @@ export interface NeuralSubstrateConfig {
 /**
  * Lazy-loaded Neural Substrate wrapper
  *
- * Wraps @sparkleideas/agentic-flow's NeuralSubstrate with graceful fallback
+ * Wraps agentic-flow's NeuralSubstrate with graceful fallback
  */
 export class NeuralEmbeddingService {
   private substrate: any = null;
@@ -82,7 +82,7 @@ export class NeuralEmbeddingService {
     if (this.initialized) return this.available;
 
     try {
-      const { getNeuralSubstrate } = await import('@sparkleideas/agentic-flow/embeddings');
+      const { getNeuralSubstrate } = await import('agentic-flow/embeddings');
       this.substrate = await getNeuralSubstrate(this.config);
       await this.substrate.init();
       this.available = true;
@@ -253,7 +253,7 @@ export function createNeuralService(config: NeuralSubstrateConfig = {}): NeuralE
  */
 export async function isNeuralAvailable(): Promise<boolean> {
   try {
-    await import('@sparkleideas/agentic-flow/embeddings');
+    await import('agentic-flow/embeddings');
     return true;
   } catch {
     return false;
@@ -271,10 +271,10 @@ export async function listEmbeddingModels(): Promise<Array<{
   downloaded: boolean;
 }>> {
   try {
-    const { listAvailableModels } = await import('@sparkleideas/agentic-flow/embeddings');
+    const { listAvailableModels } = await import('agentic-flow/embeddings');
     return listAvailableModels();
   } catch {
-    // Return default models if @sparkleideas/agentic-flow not available
+    // Return default models if agentic-flow not available
     return [
       { id: 'all-MiniLM-L6-v2', dimension: 384, size: '23MB', quantized: false, downloaded: false },
       { id: 'all-mpnet-base-v2', dimension: 768, size: '110MB', quantized: false, downloaded: false },
@@ -290,6 +290,6 @@ export async function downloadEmbeddingModel(
   targetDir?: string,
   onProgress?: (progress: { percent: number; bytesDownloaded: number; totalBytes: number }) => void
 ): Promise<string> {
-  const { downloadModel } = await import('@sparkleideas/agentic-flow/embeddings');
+  const { downloadModel } = await import('agentic-flow/embeddings');
   return downloadModel(modelId, targetDir ?? '.models', onProgress);
 }

package/src/types.ts

@@ -1,7 +1,7 @@
 /**
  * V3 Embedding Service Types
  *
- * Type definitions for embedding service aligned with @sparkleideas/agentic-flow@alpha:
+ * Type definitions for embedding service aligned with agentic-flow@alpha:
  * - OpenAI provider
  * - Transformers.js provider
  * - Mock provider
@@ -19,7 +19,7 @@
 /**
  * Supported embedding providers
  */
-export type EmbeddingProvider = 'openai' | 'transformers' | 'mock' | '@sparkleideas/agentic-flow';
+export type EmbeddingProvider = 'openai' | 'transformers' | 'mock' | 'agentic-flow';
 
 /**
  * Normalization type for embeddings
@@ -126,7 +126,7 @@ export interface MockEmbeddingConfig extends EmbeddingBaseConfig {
  * - Pre-allocated buffers (no GC pressure)
  */
 export interface AgenticFlowEmbeddingConfig extends EmbeddingBaseConfig {
-  provider: '@sparkleideas/agentic-flow';
+  provider: 'agentic-flow';
 
   /** Model ID (default: all-MiniLM-L6-v2) */
   modelId?: string;