@superatomai/sdk-node 0.0.60 → 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

@@ -2544,7 +2544,13 @@ var ArtifactsRequestPayloadSchema = import_zod3.z.object({
     limit: import_zod3.z.number().optional(),
     // Query operation fields
     filters: ArtifactsQueryFiltersSchema.optional(),
-    sort: import_zod3.z.enum(["ASC", "DESC"]).optional()
+    sort: import_zod3.z.enum(["ASC", "DESC"]).optional(),
+    // Menu grouping fields
+    type: import_zod3.z.string().optional(),
+    menuId: import_zod3.z.number().optional(),
+    artifactGroupName: import_zod3.z.string().optional(),
+    artifactGroupId: import_zod3.z.string().optional(),
+    artifactGroupIcon: import_zod3.z.string().optional()
   }).optional()
 });
 var ArtifactsRequestMessageSchema = import_zod3.z.object({
@@ -2621,7 +2627,9 @@ var MenusRequestPayloadSchema = import_zod3.z.object({
     items: import_zod3.z.array(import_zod3.z.object({
       id: import_zod3.z.number(),
       sortOrder: import_zod3.z.number()
-    })).optional()
+    })).optional(),
+    menuJson: import_zod3.z.record(import_zod3.z.unknown()).optional(),
+    version: import_zod3.z.number().optional()
   }).optional()
 });
 var MenusRequestMessageSchema = import_zod3.z.object({
@@ -6002,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
@@ -6034,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)
    */
@@ -7335,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`);
@@ -10601,6 +10629,7 @@ async function handleArtifactsRequest(data, collections, sendMessage) {
     const request = ArtifactsRequestMessageSchema.parse(data);
     const { id, payload, from } = request;
     const { operation, data: requestData } = payload;
+    logger.info("[SDK-NODEJS] Received artifacts request:", JSON.stringify({ operation, requestData }, null, 2));
     const artifactId = requestData?.id;
     const name = requestData?.name;
     const createdBy = requestData?.createdBy;
@@ -10610,9 +10639,22 @@ async function handleArtifactsRequest(data, collections, sendMessage) {
     const limit = requestData?.limit;
     const filters = requestData?.filters;
     const sort = requestData?.sort;
+    const type = requestData?.type;
+    const menuId = requestData?.menuId;
+    const artifactGroupName = requestData?.artifactGroupName;
+    const artifactGroupId = requestData?.artifactGroupId;
+    const artifactGroupIcon = requestData?.artifactGroupIcon;
+    logger.info("[SDK-NODEJS] Extracted params for create:", JSON.stringify({
+      name,
+      type,
+      menuId,
+      artifactGroupName,
+      artifactGroupId,
+      artifactGroupIcon
+    }, null, 2));
     switch (operation) {
       case "create":
-        await handleCreate6(id, name, createdBy, dsl, status, executeCollection, sendMessage, from.id);
+        await handleCreate6(id, name, createdBy, dsl, status, type, menuId, artifactGroupName, artifactGroupId, artifactGroupIcon, executeCollection, sendMessage, from.id);
         break;
       case "update":
         await handleUpdate6(id, artifactId, name, dsl, status, deleted, executeCollection, sendMessage, from.id);
@@ -10643,7 +10685,7 @@ async function handleArtifactsRequest(data, collections, sendMessage) {
     }, sendMessage);
   }
 }
-async function handleCreate6(id, name, createdBy, dsl, status, executeCollection, sendMessage, clientId) {
+async function handleCreate6(id, name, createdBy, dsl, status, type, menuId, artifactGroupName, artifactGroupId, artifactGroupIcon, executeCollection, sendMessage, clientId) {
   if (!name) {
     sendResponse8(id, {
       success: false,
@@ -10652,7 +10694,17 @@ async function handleCreate6(id, name, createdBy, dsl, status, executeCollection
     return;
   }
   try {
-    const result = await executeCollection("artifacts", "create", { name, createdBy, dsl, status });
+    const result = await executeCollection("artifacts", "create", {
+      name,
+      createdBy,
+      dsl,
+      status,
+      type,
+      menuId,
+      artifactGroupName,
+      artifactGroupId,
+      artifactGroupIcon
+    });
     sendResponse8(id, {
       success: true,
       data: result.data,
@@ -12892,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);
@@ -13306,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 = {