@superatomai/sdk-node 0.0.61 → 0.0.62

package/dist/index.d.mts

@@ -857,6 +857,13 @@ interface SuperatomSDKConfig {
      * If not provided, falls back to provider-based model selection
      */
     dashCompModels?: DashCompModelConfig;
+    /**
+     * Similarity threshold for conversation search (semantic matching)
+     * Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     * Higher values require closer matches, lower values allow more distant matches
+     * Default: 0.8
+     */
+    conversationSimilarityThreshold?: number;
 }
 
 declare const KbNodesQueryFiltersSchema: z.ZodObject<{
@@ -2030,6 +2037,12 @@ interface BaseLLMConfig {
      * - 'balanced': Use best model for complex tasks, fast model for simple tasks (default)
      */
     modelStrategy?: ModelStrategy;
+    /**
+     * Similarity threshold for conversation search (semantic matching)
+     * Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     * Default: 0.8
+     */
+    conversationSimilarityThreshold?: number;
 }
 /**
  * BaseLLM abstract class for AI-powered component generation and matching
@@ -2041,6 +2054,7 @@ declare abstract class BaseLLM {
     protected defaultLimit: number;
     protected apiKey?: string;
     protected modelStrategy: ModelStrategy;
+    protected conversationSimilarityThreshold: number;
     constructor(config?: BaseLLMConfig);
     /**
      * Get the appropriate model based on task type and model strategy
@@ -2058,6 +2072,16 @@ declare abstract class BaseLLM {
      * @returns The current model strategy
      */
     getModelStrategy(): ModelStrategy;
+    /**
+     * Set the conversation similarity threshold at runtime
+     * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     */
+    setConversationSimilarityThreshold(threshold: number): void;
+    /**
+     * Get the current conversation similarity threshold
+     * @returns The current threshold value
+     */
+    getConversationSimilarityThreshold(): number;
     /**
      * Get the default model for this provider (used for complex tasks like text generation)
      */
@@ -2249,6 +2273,7 @@ declare class SuperatomSDK {
     private llmProviders;
     private databaseType;
     private modelStrategy;
+    private conversationSimilarityThreshold;
     private userManager;
     private dashboardManager;
     private reportManager;
@@ -2359,6 +2384,20 @@ declare class SuperatomSDK {
      * Get current model strategy
      */
     getModelStrategy(): ModelStrategy;
+    /**
+     * Apply conversation similarity threshold to all LLM provider singletons
+     * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     */
+    private applyConversationSimilarityThreshold;
+    /**
+     * Set conversation similarity threshold at runtime
+     * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     */
+    setConversationSimilarityThreshold(threshold: number): void;
+    /**
+     * Get current conversation similarity threshold
+     */
+    getConversationSimilarityThreshold(): number;
 }
 
 export { type Action, BM25L, type BM25LOptions, type BaseLLMConfig, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CollectionHandler, type CollectionOperation, type DBUIBlock, type DatabaseType, type HybridSearchOptions, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, type Message, type ModelStrategy, type OutputField, type RerankedResult, SDK_VERSION, STORAGE_CONFIG, SuperatomSDK, type SuperatomSDKConfig, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, UIBlock, UILogCollector, type User, UserManager, type UsersData, anthropicLLM, geminiLLM, groqLLM, hybridRerank, llmUsageLogger, logger, openaiLLM, rerankChromaResults, rerankConversationResults, userPromptErrorLogger };

package/dist/index.d.ts

@@ -857,6 +857,13 @@ interface SuperatomSDKConfig {
      * If not provided, falls back to provider-based model selection
      */
     dashCompModels?: DashCompModelConfig;
+    /**
+     * Similarity threshold for conversation search (semantic matching)
+     * Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     * Higher values require closer matches, lower values allow more distant matches
+     * Default: 0.8
+     */
+    conversationSimilarityThreshold?: number;
 }
 
 declare const KbNodesQueryFiltersSchema: z.ZodObject<{
@@ -2030,6 +2037,12 @@ interface BaseLLMConfig {
      * - 'balanced': Use best model for complex tasks, fast model for simple tasks (default)
      */
     modelStrategy?: ModelStrategy;
+    /**
+     * Similarity threshold for conversation search (semantic matching)
+     * Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     * Default: 0.8
+     */
+    conversationSimilarityThreshold?: number;
 }
 /**
  * BaseLLM abstract class for AI-powered component generation and matching
@@ -2041,6 +2054,7 @@ declare abstract class BaseLLM {
     protected defaultLimit: number;
     protected apiKey?: string;
     protected modelStrategy: ModelStrategy;
+    protected conversationSimilarityThreshold: number;
     constructor(config?: BaseLLMConfig);
     /**
      * Get the appropriate model based on task type and model strategy
@@ -2058,6 +2072,16 @@ declare abstract class BaseLLM {
      * @returns The current model strategy
      */
     getModelStrategy(): ModelStrategy;
+    /**
+     * Set the conversation similarity threshold at runtime
+     * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     */
+    setConversationSimilarityThreshold(threshold: number): void;
+    /**
+     * Get the current conversation similarity threshold
+     * @returns The current threshold value
+     */
+    getConversationSimilarityThreshold(): number;
     /**
      * Get the default model for this provider (used for complex tasks like text generation)
      */
@@ -2249,6 +2273,7 @@ declare class SuperatomSDK {
     private llmProviders;
     private databaseType;
     private modelStrategy;
+    private conversationSimilarityThreshold;
     private userManager;
     private dashboardManager;
     private reportManager;
@@ -2359,6 +2384,20 @@ declare class SuperatomSDK {
      * Get current model strategy
      */
     getModelStrategy(): ModelStrategy;
+    /**
+     * Apply conversation similarity threshold to all LLM provider singletons
+     * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     */
+    private applyConversationSimilarityThreshold;
+    /**
+     * Set conversation similarity threshold at runtime
+     * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+     */
+    setConversationSimilarityThreshold(threshold: number): void;
+    /**
+     * Get current conversation similarity threshold
+     */
+    getConversationSimilarityThreshold(): number;
 }
 
 export { type Action, BM25L, type BM25LOptions, type BaseLLMConfig, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CollectionHandler, type CollectionOperation, type DBUIBlock, type DatabaseType, type HybridSearchOptions, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, type Message, type ModelStrategy, type OutputField, type RerankedResult, SDK_VERSION, STORAGE_CONFIG, SuperatomSDK, type SuperatomSDKConfig, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, UIBlock, UILogCollector, type User, UserManager, type UsersData, anthropicLLM, geminiLLM, groqLLM, hybridRerank, llmUsageLogger, logger, openaiLLM, rerankChromaResults, rerankConversationResults, userPromptErrorLogger };

package/dist/index.js

@@ -6010,6 +6010,7 @@ var BaseLLM = class {
     this.defaultLimit = config?.defaultLimit || 50;
     this.apiKey = config?.apiKey;
     this.modelStrategy = config?.modelStrategy || "fast";
+    this.conversationSimilarityThreshold = config?.conversationSimilarityThreshold || 0.8;
   }
   /**
    * Get the appropriate model based on task type and model strategy
@@ -6042,6 +6043,26 @@ var BaseLLM = class {
   getModelStrategy() {
     return this.modelStrategy;
   }
+  /**
+   * Set the conversation similarity threshold at runtime
+   * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+   */
+  setConversationSimilarityThreshold(threshold) {
+    if (threshold < 0 || threshold > 1) {
+      logger.warn(`[${this.getProviderName()}] Invalid threshold ${threshold}, must be between 0 and 1. Using default 0.8`);
+      this.conversationSimilarityThreshold = 0.8;
+      return;
+    }
+    this.conversationSimilarityThreshold = threshold;
+    logger.info(`[${this.getProviderName()}] Conversation similarity threshold set to: ${threshold}`);
+  }
+  /**
+   * Get the current conversation similarity threshold
+   * @returns The current threshold value
+   */
+  getConversationSimilarityThreshold() {
+    return this.conversationSimilarityThreshold;
+  }
   /**
    * Get the API key (from instance, parameter, or environment)
    */
@@ -7343,8 +7364,7 @@ ${errorMsg}
         userPrompt,
         collections,
         userId,
-        similarityThreshold: 0.8
-        // 80% threshold
+        similarityThreshold: this.conversationSimilarityThreshold
       });
       if (conversationMatch) {
         logger.info(`[${this.getProviderName()}] \u2713 Found matching conversation with ${(conversationMatch.similarity * 100).toFixed(2)}% similarity`);
@@ -12924,8 +12944,10 @@ var SuperatomSDK = class {
     this.llmProviders = config.LLM_PROVIDERS || getLLMProviders();
     this.databaseType = config.databaseType || "postgresql";
     this.modelStrategy = config.modelStrategy || "fast";
+    this.conversationSimilarityThreshold = config.conversationSimilarityThreshold ?? 0.8;
     this.applyModelStrategy(this.modelStrategy);
-    logger.info(`Initializing Superatom SDK v${SDK_VERSION} for project ${this.projectId}, llm providers: ${this.llmProviders.join(", ")}, database type: ${this.databaseType}, model strategy: ${this.modelStrategy}`);
+    this.applyConversationSimilarityThreshold(this.conversationSimilarityThreshold);
+    logger.info(`Initializing Superatom SDK v${SDK_VERSION} for project ${this.projectId}, llm providers: ${this.llmProviders.join(", ")}, database type: ${this.databaseType}, model strategy: ${this.modelStrategy}, conversation similarity threshold: ${this.conversationSimilarityThreshold}`);
     this.userManager = new UserManager(this.projectId, 5e3);
     this.dashboardManager = new DashboardManager(this.projectId);
     this.reportManager = new ReportManager(this.projectId);
@@ -13338,6 +13360,31 @@ var SuperatomSDK = class {
   getModelStrategy() {
     return this.modelStrategy;
   }
+  /**
+   * Apply conversation similarity threshold to all LLM provider singletons
+   * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+   */
+  applyConversationSimilarityThreshold(threshold) {
+    anthropicLLM.setConversationSimilarityThreshold(threshold);
+    groqLLM.setConversationSimilarityThreshold(threshold);
+    geminiLLM.setConversationSimilarityThreshold(threshold);
+    openaiLLM.setConversationSimilarityThreshold(threshold);
+    logger.info(`Conversation similarity threshold '${threshold}' applied to all LLM providers`);
+  }
+  /**
+   * Set conversation similarity threshold at runtime
+   * @param threshold - Value between 0 and 1 (e.g., 0.8 = 80% similarity required)
+   */
+  setConversationSimilarityThreshold(threshold) {
+    this.conversationSimilarityThreshold = threshold;
+    this.applyConversationSimilarityThreshold(threshold);
+  }
+  /**
+   * Get current conversation similarity threshold
+   */
+  getConversationSimilarityThreshold() {
+    return this.conversationSimilarityThreshold;
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {