@superatomai/sdk-node 0.0.57 → 0.0.59

package/dist/index.d.mts

@@ -2097,7 +2097,7 @@ declare abstract class BaseLLM {
      * @param componentStreamCallback - Optional callback to stream primary KPI component as soon as it's identified
      * @returns Object containing matched components, layout title/description, and follow-up actions
      */
-    matchComponentsFromAnalysis(analysisContent: string, components: Component[], apiKey?: string, logCollector?: any, componentStreamCallback?: (component: Component) => void, deferredTools?: any[], executedTools?: any[]): Promise<{
+    matchComponentsFromAnalysis(analysisContent: string, components: Component[], apiKey?: string, logCollector?: any, componentStreamCallback?: (component: Component) => void, deferredTools?: any[], executedTools?: any[], collections?: any, userId?: string, userPrompt?: string): Promise<{
         components: Component[];
         layoutTitle: string;
         layoutDescription: string;

package/dist/index.d.ts

@@ -2097,7 +2097,7 @@ declare abstract class BaseLLM {
      * @param componentStreamCallback - Optional callback to stream primary KPI component as soon as it's identified
      * @returns Object containing matched components, layout title/description, and follow-up actions
      */
-    matchComponentsFromAnalysis(analysisContent: string, components: Component[], apiKey?: string, logCollector?: any, componentStreamCallback?: (component: Component) => void, deferredTools?: any[], executedTools?: any[]): Promise<{
+    matchComponentsFromAnalysis(analysisContent: string, components: Component[], apiKey?: string, logCollector?: any, componentStreamCallback?: (component: Component) => void, deferredTools?: any[], executedTools?: any[], collections?: any, userId?: string, userPrompt?: string): Promise<{
         components: Component[];
         layoutTitle: string;
         layoutDescription: string;

package/dist/index.js

@@ -1642,6 +1642,7 @@ __export(utils_exports, {
   fixScalarSubqueries: () => fixScalarSubqueries,
   getDatabaseType: () => getDatabaseType,
   getJsonSizeInBytes: () => getJsonSizeInBytes,
+  validateAndFixSqlQuery: () => validateAndFixSqlQuery,
   validateMessageSize: () => validateMessageSize
 });
 function getDatabaseType() {
@@ -1817,6 +1818,105 @@ function validateMessageSize(message, maxSize = 1048576) {
     maxSize
   };
 }
+function validateAndFixSqlQuery(query, dbType) {
+  if (!query || query.trim().length === 0) {
+    return { query, fixed: false, fixes: [] };
+  }
+  const databaseType = dbType || getDatabaseType();
+  const _isMssql = databaseType === "mssql";
+  let fixedQuery = query;
+  const fixes = [];
+  const aggregateFunctions = ["SUM", "COUNT", "AVG", "MIN", "MAX"];
+  const aggregateInWherePattern = new RegExp(
+    `\\bWHERE\\b[^]*?\\b(${aggregateFunctions.join("|")})\\s*\\([^)]*\\)\\s*(?:=|>|<|>=|<=|<>|!=)`,
+    "i"
+  );
+  if (aggregateInWherePattern.test(fixedQuery)) {
+    const aggregateConditionPattern = new RegExp(
+      `\\s+(AND|OR)\\s+((?:COALESCE\\s*\\(\\s*)?(?:${aggregateFunctions.join("|")})\\s*\\([^)]+\\)[^)]*(?:\\))?\\s*(?:=|>|<|>=|<=|<>|!=)\\s*[^\\s,)]+)`,
+      "gi"
+    );
+    const aggregateConditions = [];
+    let match;
+    while ((match = aggregateConditionPattern.exec(fixedQuery)) !== null) {
+      aggregateConditions.push(match[2].trim());
+    }
+    if (aggregateConditions.length > 0) {
+      fixedQuery = fixedQuery.replace(aggregateConditionPattern, "");
+      fixedQuery = fixedQuery.replace(/\bWHERE\s+(AND|OR)\s+/gi, "WHERE ");
+      fixedQuery = fixedQuery.replace(/\bWHERE\s+(GROUP\s+BY|ORDER\s+BY|HAVING|$)/gi, "$1");
+      const hasGroupBy = /\bGROUP\s+BY\b/i.test(fixedQuery);
+      if (hasGroupBy) {
+        const hasHaving = /\bHAVING\b/i.test(fixedQuery);
+        const havingClause = aggregateConditions.join(" AND ");
+        if (hasHaving) {
+          fixedQuery = fixedQuery.replace(
+            /\bHAVING\b/i,
+            `HAVING ${havingClause} AND`
+          );
+        } else {
+          const orderByMatch = fixedQuery.match(/(\s+ORDER\s+BY\s+)/i);
+          if (orderByMatch) {
+            fixedQuery = fixedQuery.replace(
+              orderByMatch[1],
+              ` HAVING ${havingClause}${orderByMatch[1]}`
+            );
+          } else {
+            fixedQuery = fixedQuery.trimEnd() + ` HAVING ${havingClause}`;
+          }
+        }
+        fixes.push(`Moved aggregate condition(s) from WHERE to HAVING: ${havingClause}`);
+      }
+    }
+  }
+  let openCount = 0;
+  let closeCount = 0;
+  let inString = false;
+  let stringChar = "";
+  for (let i = 0; i < fixedQuery.length; i++) {
+    const char = fixedQuery[i];
+    const prevChar = i > 0 ? fixedQuery[i - 1] : "";
+    if ((char === "'" || char === '"') && prevChar !== "\\") {
+      if (!inString) {
+        inString = true;
+        stringChar = char;
+      } else if (char === stringChar) {
+        if (i + 1 < fixedQuery.length && fixedQuery[i + 1] === char) {
+          i++;
+        } else {
+          inString = false;
+        }
+      }
+      continue;
+    }
+    if (!inString) {
+      if (char === "(") openCount++;
+      else if (char === ")") closeCount++;
+    }
+  }
+  if (openCount > closeCount) {
+    const missingClose = openCount - closeCount;
+    fixedQuery = fixedQuery.trimEnd();
+    const hasSemicolon = fixedQuery.endsWith(";");
+    if (hasSemicolon) {
+      fixedQuery = fixedQuery.slice(0, -1);
+    }
+    fixedQuery = fixedQuery + ")".repeat(missingClose);
+    if (hasSemicolon) {
+      fixedQuery = fixedQuery + ";";
+    }
+    fixes.push(`Added ${missingClose} missing closing parenthesis(es)`);
+  }
+  const originalLength = fixedQuery.length;
+  fixedQuery = fixedQuery.replace(/\s+/g, " ").trim();
+  if (fixedQuery.length !== originalLength) {
+  }
+  return {
+    query: fixedQuery,
+    fixed: fixes.length > 0,
+    fixes
+  };
+}
 var init_utils = __esm({
   "src/userResponse/utils.ts"() {
     "use strict";
@@ -2409,8 +2509,14 @@ var BookmarksRequestMessageSchema = import_zod3.z.object({
   type: import_zod3.z.literal("BOOKMARKS"),
   payload: BookmarksRequestPayloadSchema
 });
+var ArtifactsQueryFiltersSchema = import_zod3.z.object({
+  createdBy: import_zod3.z.number().optional(),
+  status: import_zod3.z.string().optional(),
+  name: import_zod3.z.string().optional(),
+  deleted: import_zod3.z.boolean().optional()
+});
 var ArtifactsRequestPayloadSchema = import_zod3.z.object({
-  operation: import_zod3.z.enum(["create", "update", "delete", "getAll", "getOne"]),
+  operation: import_zod3.z.enum(["create", "update", "delete", "getAll", "getOne", "query"]),
   data: import_zod3.z.object({
     id: import_zod3.z.number().optional(),
     name: import_zod3.z.string().optional(),
@@ -2418,7 +2524,10 @@ var ArtifactsRequestPayloadSchema = import_zod3.z.object({
     dsl: import_zod3.z.record(import_zod3.z.any()).optional(),
     status: import_zod3.z.string().optional(),
     deleted: import_zod3.z.boolean().optional(),
-    limit: import_zod3.z.number().optional()
+    limit: import_zod3.z.number().optional(),
+    // Query operation fields
+    filters: ArtifactsQueryFiltersSchema.optional(),
+    sort: import_zod3.z.enum(["ASC", "DESC"]).optional()
   }).optional()
 });
 var ArtifactsRequestMessageSchema = import_zod3.z.object({
@@ -5946,7 +6055,10 @@ var BaseLLM = class {
    * @param componentStreamCallback - Optional callback to stream primary KPI component as soon as it's identified
    * @returns Object containing matched components, layout title/description, and follow-up actions
    */
-  async matchComponentsFromAnalysis(analysisContent, components, apiKey, logCollector, componentStreamCallback, deferredTools, executedTools) {
+  async matchComponentsFromAnalysis(analysisContent, components, apiKey, logCollector, componentStreamCallback, deferredTools, executedTools, collections, userId, userPrompt) {
+    const methodStartTime = Date.now();
+    const methodName = "matchComponentsFromAnalysis";
+    logger.info(`[${this.getProviderName()}] [TIMING] START ${methodName} | model: ${this.getModelForTask("complex")}`);
     try {
       logger.debug(`[${this.getProviderName()}] Starting component matching from text response`);
       let availableComponentsText = "No components available";
@@ -6006,6 +6118,16 @@ ${fieldsText}`;
       }
       const schemaDoc = schema.generateSchemaDocumentation();
       const databaseRules = await promptLoader.loadDatabaseRules();
+      let knowledgeBaseContext = "No additional knowledge base context available.";
+      if (collections) {
+        const kbResult = await knowledge_base_default.getAllKnowledgeBase({
+          prompt: userPrompt || analysisContent,
+          collections,
+          userId,
+          topK: 3
+        });
+        knowledgeBaseContext = kbResult.combinedContext || knowledgeBaseContext;
+      }
       const prompts = await promptLoader.loadPrompts("match-text-components", {
         ANALYSIS_CONTENT: analysisContent,
         AVAILABLE_COMPONENTS: availableComponentsText,
@@ -6013,11 +6135,27 @@ ${fieldsText}`;
         DATABASE_RULES: databaseRules,
         DEFERRED_TOOLS: deferredToolsText,
         EXECUTED_TOOLS: executedToolsText,
+        KNOWLEDGE_BASE_CONTEXT: knowledgeBaseContext,
         CURRENT_DATETIME: getCurrentDateTimeForPrompt()
       });
       logger.debug(`[${this.getProviderName()}] Loaded match-text-components prompts`);
-      const systemPromptStr = Array.isArray(prompts.system) ? prompts.system.join("\n") : prompts.system;
-      logger.logLLMPrompt("matchComponentsFromAnalysis", "system", systemPromptStr);
+      const extractPromptText = (content) => {
+        if (typeof content === "string") return content;
+        if (Array.isArray(content)) {
+          return content.map((item) => {
+            if (typeof item === "string") return item;
+            if (item && typeof item.text === "string") return item.text;
+            if (item && item.content && typeof item.content === "string") return item.content;
+            return JSON.stringify(item, null, 2);
+          }).join("\n\n---\n\n");
+        }
+        if (content && typeof content === "object") {
+          if (typeof content.text === "string") return content.text;
+          return JSON.stringify(content, null, 2);
+        }
+        return String(content);
+      };
+      logger.logLLMPrompt("matchComponentsFromAnalysis", "system", extractPromptText(prompts.system));
       logger.logLLMPrompt("matchComponentsFromAnalysis", "user", `Text Analysis:
 ${analysisContent}
 
@@ -6242,6 +6380,18 @@ ${executedToolsText}`);
             cleanedProps.query = null;
           }
         }
+        if (cleanedProps.query) {
+          const queryStr = typeof cleanedProps.query === "string" ? cleanedProps.query : cleanedProps.query?.sql || "";
+          const { query: fixedQuery, fixed, fixes } = validateAndFixSqlQuery(queryStr);
+          if (fixed) {
+            logger.warn(`[${this.getProviderName()}] SQL fixes applied to component query: ${fixes.join("; ")}`);
+            if (typeof cleanedProps.query === "string") {
+              cleanedProps.query = fixedQuery;
+            } else if (cleanedProps.query?.sql) {
+              cleanedProps.query.sql = fixedQuery;
+            }
+          }
+        }
         if (cleanedProps.query && cleanedProps.externalTool) {
           logger.info(`[${this.getProviderName()}] Both query and externalTool exist, keeping both - frontend will decide`);
         }
@@ -6253,6 +6403,8 @@ ${executedToolsText}`);
           }
         };
       }).filter(Boolean);
+      const methodDuration = Date.now() - methodStartTime;
+      logger.info(`[${this.getProviderName()}] [TIMING] DONE ${methodName} in ${methodDuration}ms | components: ${finalComponents.length} | actions: ${actions.length}`);
       return {
         components: finalComponents,
         layoutTitle,
@@ -6260,8 +6412,9 @@ ${executedToolsText}`);
         actions
       };
     } catch (error) {
+      const methodDuration = Date.now() - methodStartTime;
       const errorMsg = error instanceof Error ? error.message : String(error);
-      logger.error(`[${this.getProviderName()}] Error matching components: ${errorMsg}`);
+      logger.error(`[${this.getProviderName()}] [TIMING] FAILED ${methodName} in ${methodDuration}ms | error: ${errorMsg}`);
       logCollector?.error(`Failed to match components: ${errorMsg}`);
       return {
         components: [],
@@ -6276,6 +6429,10 @@ ${executedToolsText}`);
    * Determines if question is for data analysis, requires external tools, or needs text response
    */
   async classifyQuestionCategory(userPrompt, apiKey, logCollector, conversationHistory, externalTools) {
+    const methodStartTime = Date.now();
+    const methodName = "classifyQuestionCategory";
+    const promptPreview = userPrompt.substring(0, 50) + (userPrompt.length > 50 ? "..." : "");
+    logger.info(`[${this.getProviderName()}] [TIMING] START ${methodName} | model: ${this.getModelForTask("simple")} | prompt: "${promptPreview}"`);
     try {
       const schemaDoc = schema.generateSchemaDocumentation();
       const availableToolsDoc = externalTools && externalTools.length > 0 ? externalTools.map((tool) => {
@@ -6291,10 +6448,24 @@ ${executedToolsText}`);
         SCHEMA_DOC: schemaDoc || "No database schema available",
         CURRENT_DATETIME: getCurrentDateTimeForPrompt()
       });
-      const systemPrompt = Array.isArray(prompts.system) ? prompts.system.join("\n") : prompts.system;
-      const userPromptText = Array.isArray(prompts.user) ? prompts.user.join("\n") : prompts.user;
-      logger.logLLMPrompt("classifyQuestionCategory", "system", systemPrompt);
-      logger.logLLMPrompt("classifyQuestionCategory", "user", userPromptText);
+      const extractTextContent = (content) => {
+        if (typeof content === "string") return content;
+        if (Array.isArray(content)) {
+          return content.map((item) => {
+            if (typeof item === "string") return item;
+            if (item && typeof item.text === "string") return item.text;
+            if (item && item.content && typeof item.content === "string") return item.content;
+            return JSON.stringify(item, null, 2);
+          }).join("\n\n---\n\n");
+        }
+        if (content && typeof content === "object") {
+          if (typeof content.text === "string") return content.text;
+          return JSON.stringify(content, null, 2);
+        }
+        return String(content);
+      };
+      logger.logLLMPrompt("classifyQuestionCategory", "system", extractTextContent(prompts.system));
+      logger.logLLMPrompt("classifyQuestionCategory", "user", extractTextContent(prompts.user));
       const result = await LLM.stream(
         {
           sys: prompts.system,
@@ -6319,6 +6490,8 @@ ${executedToolsText}`);
           confidence: result.confidence
         }
       );
+      const methodDuration = Date.now() - methodStartTime;
+      logger.info(`[${this.getProviderName()}] [TIMING] DONE ${methodName} in ${methodDuration}ms | category: ${result.category} | confidence: ${result.confidence}% | tools: ${(result.externalTools || []).length}`);
       return {
         category: result.category || "data_analysis",
         externalTools: result.externalTools || [],
@@ -6327,8 +6500,9 @@ ${executedToolsText}`);
         confidence: result.confidence || 0
       };
     } catch (error) {
+      const methodDuration = Date.now() - methodStartTime;
       const errorMsg = error instanceof Error ? error.message : String(error);
-      logger.error(`[${this.getProviderName()}] Error classifying question category: ${errorMsg}`);
+      logger.error(`[${this.getProviderName()}] [TIMING] FAILED ${methodName} in ${methodDuration}ms | error: ${errorMsg}`);
       logger.debug(`[${this.getProviderName()}] Category classification error details:`, error);
       throw error;
     }
@@ -6339,9 +6513,15 @@ ${executedToolsText}`);
    * Also adapts the cached text response to match the new question
    */
   async adaptUIBlockParameters(currentUserPrompt, originalUserPrompt, matchedUIBlock, apiKey, logCollector, cachedTextResponse) {
+    const methodStartTime = Date.now();
+    const methodName = "adaptUIBlockParameters";
+    const promptPreview = currentUserPrompt.substring(0, 50) + (currentUserPrompt.length > 50 ? "..." : "");
+    logger.info(`[${this.getProviderName()}] [TIMING] START ${methodName} | model: ${this.getModelForTask("complex")} | prompt: "${promptPreview}"`);
     try {
       const component = matchedUIBlock?.generatedComponentMetadata || matchedUIBlock?.component;
       if (!matchedUIBlock || !component) {
+        const methodDuration2 = Date.now() - methodStartTime;
+        logger.info(`[${this.getProviderName()}] [TIMING] DONE ${methodName} in ${methodDuration2}ms | result: no component found`);
         return {
           success: false,
           explanation: "No component found in matched UI block"
@@ -6374,9 +6554,8 @@ ${executedToolsText}`);
         // Parse as JSON
       );
       if (!result.success) {
-        logger.info(
-          `[${this.getProviderName()}] Could not adapt UI block: ${result.reason}`
-        );
+        const methodDuration2 = Date.now() - methodStartTime;
+        logger.info(`[${this.getProviderName()}] [TIMING] DONE ${methodName} in ${methodDuration2}ms | result: adaptation failed - ${result.reason}`);
         logCollector?.warn(
           "Could not adapt matched UI block",
           "explanation",
@@ -6401,6 +6580,8 @@ ${executedToolsText}`);
           componentType: result.adaptedComponent?.type
         }
       );
+      const methodDuration = Date.now() - methodStartTime;
+      logger.info(`[${this.getProviderName()}] [TIMING] DONE ${methodName} in ${methodDuration}ms | result: success | changes: ${(result.parametersChanged || []).length}`);
       return {
         success: true,
         adaptedComponent: result.adaptedComponent,
@@ -6409,8 +6590,9 @@ ${executedToolsText}`);
         explanation: result.explanation || "Parameters adapted successfully"
       };
     } catch (error) {
+      const methodDuration = Date.now() - methodStartTime;
       const errorMsg = error instanceof Error ? error.message : String(error);
-      logger.error(`[${this.getProviderName()}] Error adapting UI block parameters: ${errorMsg}`);
+      logger.error(`[${this.getProviderName()}] [TIMING] FAILED ${methodName} in ${methodDuration}ms | error: ${errorMsg}`);
       logger.debug(`[${this.getProviderName()}] Adaptation error details:`, error);
       return {
         success: false,
@@ -6431,6 +6613,10 @@ ${executedToolsText}`);
    * @param userId - Optional user ID for fetching user-specific knowledge base nodes
    */
   async generateTextResponse(userPrompt, apiKey, logCollector, conversationHistory, streamCallback, collections, components, externalTools, category, userId) {
+    const methodStartTime = Date.now();
+    const methodName = "generateTextResponse";
+    const promptPreview = userPrompt.substring(0, 50) + (userPrompt.length > 50 ? "..." : "");
+    logger.info(`[${this.getProviderName()}] [TIMING] START ${methodName} | model: ${this.getModelForTask("complex")} | category: ${category} | prompt: "${promptPreview}"`);
     const errors = [];
     logger.debug(`[${this.getProviderName()}] Starting text response generation`);
     logger.debug(`[${this.getProviderName()}] User prompt: "${userPrompt.substring(0, 50)}..."`);
@@ -6495,10 +6681,24 @@ ${executedToolsText}`);
         AVAILABLE_EXTERNAL_TOOLS: availableToolsDoc,
         CURRENT_DATETIME: getCurrentDateTimeForPrompt()
       });
-      const sysPrompt = Array.isArray(prompts.system) ? prompts.system.join("\n") : prompts.system;
-      const usrPrompt = Array.isArray(prompts.user) ? prompts.user.join("\n") : prompts.user;
-      logger.logLLMPrompt("generateTextResponse", "system", sysPrompt);
-      logger.logLLMPrompt("generateTextResponse", "user", usrPrompt);
+      const extractText = (content) => {
+        if (typeof content === "string") return content;
+        if (Array.isArray(content)) {
+          return content.map((item) => {
+            if (typeof item === "string") return item;
+            if (item && typeof item.text === "string") return item.text;
+            if (item && item.content && typeof item.content === "string") return item.content;
+            return JSON.stringify(item, null, 2);
+          }).join("\n\n---\n\n");
+        }
+        if (content && typeof content === "object") {
+          if (typeof content.text === "string") return content.text;
+          return JSON.stringify(content, null, 2);
+        }
+        return String(content);
+      };
+      logger.logLLMPrompt("generateTextResponse", "system", extractText(prompts.system));
+      logger.logLLMPrompt("generateTextResponse", "user", extractText(prompts.user));
       logger.debug(`[${this.getProviderName()}] Loaded text-response prompts with schema`);
       logger.debug(`[${this.getProviderName()}] System prompt length: ${prompts.system.length}, User prompt length: ${prompts.user.length}`);
       logCollector?.info("Generating text response with query execution capability...");
@@ -6944,7 +7144,8 @@ ${errorMsg}
       logger.info(`[${this.getProviderName()}] Text response stream completed`);
       const textResponse = fullStreamedText || result || "I apologize, but I was unable to generate a response.";
       if (maxAttemptsReached) {
-        logger.warn(`[${this.getProviderName()}] Max query attempts reached, returning failure response`);
+        const methodDuration2 = Date.now() - methodStartTime;
+        logger.warn(`[${this.getProviderName()}] [TIMING] DONE ${methodName} in ${methodDuration2}ms | result: max attempts reached`);
         logCollector?.error("Failed to generate valid query after maximum attempts");
         return {
           success: false,
@@ -7021,7 +7222,10 @@ ${errorMsg}
           logCollector,
           componentStreamCallback,
           deferredTools,
-          executedToolsList
+          executedToolsList,
+          collections,
+          userId,
+          userPrompt
         );
         matchedComponents = matchResult.components;
         layoutTitle = matchResult.layoutTitle;
@@ -7047,6 +7251,8 @@ ${errorMsg}
           }
         };
       }
+      const methodDuration = Date.now() - methodStartTime;
+      logger.info(`[${this.getProviderName()}] [TIMING] DONE ${methodName} in ${methodDuration}ms | result: success | components: ${matchedComponents.length} | actions: ${actions.length}`);
       return {
         success: true,
         data: {
@@ -7058,8 +7264,9 @@ ${errorMsg}
         errors: []
       };
     } catch (error) {
+      const methodDuration = Date.now() - methodStartTime;
       const errorMsg = error instanceof Error ? error.message : String(error);
-      logger.error(`[${this.getProviderName()}] Error generating text response: ${errorMsg}`);
+      logger.error(`[${this.getProviderName()}] [TIMING] FAILED ${methodName} in ${methodDuration}ms | error: ${errorMsg}`);
       logCollector?.error(`Error generating text response: ${errorMsg}`);
       userPromptErrorLogger.logLlmError(
         this.getProviderName(),
@@ -7101,7 +7308,6 @@ ${errorMsg}
     logger.logLLMPrompt("handleUserRequest", "user", `User Prompt: ${userPrompt}`);
     try {
       logger.info(`[${this.getProviderName()}] Step 1: Searching previous conversations...`);
-      logCollector?.info("Step 1: Searching for similar previous conversations...");
       const conversationMatch = await conversation_search_default.searchConversationsWithReranking({
         userPrompt,
         collections,
@@ -7313,6 +7519,10 @@ ${errorMsg}
    * For general/conversational questions without components, pass textResponse instead
    */
   async generateNextQuestions(originalUserPrompt, component, componentData, apiKey, logCollector, conversationHistory, textResponse) {
+    const methodStartTime = Date.now();
+    const methodName = "generateNextQuestions";
+    const promptPreview = originalUserPrompt.substring(0, 50) + (originalUserPrompt.length > 50 ? "..." : "");
+    logger.info(`[${this.getProviderName()}] [TIMING] START ${methodName} | model: ${this.getModelForTask("simple")} | prompt: "${promptPreview}"`);
     try {
       let component_info;
       if (component) {
@@ -7361,10 +7571,13 @@ ${errorMsg}
           questions: nextQuestions
         }
       );
+      const methodDuration = Date.now() - methodStartTime;
+      logger.info(`[${this.getProviderName()}] [TIMING] DONE ${methodName} in ${methodDuration}ms | questions: ${nextQuestions.length}`);
       return nextQuestions;
     } catch (error) {
+      const methodDuration = Date.now() - methodStartTime;
       const errorMsg = error instanceof Error ? error.message : String(error);
-      logger.error(`[${this.getProviderName()}] Error generating next questions: ${errorMsg}`);
+      logger.error(`[${this.getProviderName()}] [TIMING] FAILED ${methodName} in ${methodDuration}ms | error: ${errorMsg}`);
       logger.debug(`[${this.getProviderName()}] Next questions generation error details:`, error);
       logCollector?.error(`Error generating next questions: ${errorMsg}`);
       return [];
@@ -10372,6 +10585,8 @@ async function handleArtifactsRequest(data, collections, sendMessage) {
     const status = requestData?.status;
     const deleted = requestData?.deleted;
     const limit = requestData?.limit;
+    const filters = requestData?.filters;
+    const sort = requestData?.sort;
     switch (operation) {
       case "create":
         await handleCreate6(id, name, createdBy, dsl, status, executeCollection, sendMessage, from.id);
@@ -10388,6 +10603,9 @@ async function handleArtifactsRequest(data, collections, sendMessage) {
       case "getOne":
         await handleGetOne6(id, artifactId, executeCollection, sendMessage, from.id);
         break;
+      case "query":
+        await handleQuery6(id, { filters, limit, sort }, executeCollection, sendMessage, from.id);
+        break;
       default:
         sendResponse8(id, {
           success: false,
@@ -10511,6 +10729,27 @@ async function handleGetOne6(id, artifactId, executeCollection, sendMessage, cli
     }, sendMessage, clientId);
   }
 }
+async function handleQuery6(id, queryParams, executeCollection, sendMessage, clientId) {
+  try {
+    const result = await executeCollection("artifacts", "query", {
+      filters: queryParams.filters,
+      limit: queryParams.limit || 50,
+      sort: queryParams.sort || "DESC"
+    });
+    sendResponse8(id, {
+      success: true,
+      data: result.data,
+      count: result.count,
+      message: `Query returned ${result.count} artifacts`
+    }, sendMessage, clientId);
+    logger.info(`Query artifacts (count: ${result.count})`);
+  } catch (error) {
+    sendResponse8(id, {
+      success: false,
+      error: error instanceof Error ? error.message : "Failed to query artifacts"
+    }, sendMessage, clientId);
+  }
+}
 function sendResponse8(id, res, sendMessage, clientId) {
   const response = {
     id: id || "unknown",
@@ -11037,7 +11276,7 @@ async function handleMenusRequest(data, collections, sendMessage) {
         await handleGetHierarchy(id, executeCollection, sendMessage, from.id);
         break;
       case "query":
-        await handleQuery6(id, filters, limit, sort, executeCollection, sendMessage, from.id);
+        await handleQuery7(id, filters, limit, sort, executeCollection, sendMessage, from.id);
         break;
       case "reorder":
         await handleReorder(id, items, executeCollection, sendMessage, from.id);
@@ -11249,7 +11488,7 @@ async function handleGetHierarchy(id, executeCollection, sendMessage, clientId)
     }, sendMessage, clientId);
   }
 }
-async function handleQuery6(id, filters, limit, sort, executeCollection, sendMessage, clientId) {
+async function handleQuery7(id, filters, limit, sort, executeCollection, sendMessage, clientId) {
   try {
     const result = await executeCollection("menus", "query", {
       filters: filters || {},