@superatomai/sdk-node 0.0.47 → 0.0.49

package/dist/index.mjs

@@ -2043,12 +2043,27 @@ var ComponentListResponseMessageSchema = z3.object({
   type: z3.literal("COMPONENT_LIST_RES"),
   payload: ComponentListResponsePayloadSchema
 });
+var OutputFieldSchema = z3.object({
+  name: z3.string(),
+  // Field name (column name in the result)
+  type: z3.enum(["string", "number", "boolean", "date"]),
+  description: z3.string()
+  // What this field contains
+});
+var OutputSchema = z3.object({
+  description: z3.string(),
+  // Brief description of what the output represents
+  fields: z3.array(OutputFieldSchema)
+  // List of fields in each record (like columns in a table)
+});
 var ToolSchema = z3.object({
   id: z3.string(),
   name: z3.string(),
   description: z3.string(),
   params: z3.record(z3.string()),
-  fn: z3.function().args(z3.any()).returns(z3.any())
+  fn: z3.function().args(z3.any()).returns(z3.any()),
+  outputSchema: OutputSchema.optional()
+  // Optional: describes the data structure returned by this tool
 });
 var UserQueryFiltersSchema = z3.object({
   username: z3.string().optional(),
@@ -5654,17 +5669,27 @@ ${JSON.stringify(tool.requiredFields || [], null, 2)}`;
       let executedToolsText = "No external tools were executed for data fetching.";
       if (executedTools && executedTools.length > 0) {
         logger.info(`[${this.getProviderName()}] Passing ${executedTools.length} executed tools to component matching`);
-        executedToolsText = "The following external tools were executed to fetch data.\n**IMPORTANT: For components displaying this data, use externalTool prop instead of query.**\n**IMPORTANT: Use the result data to populate deferred tool parameters when applicable.**\n\n" + executedTools.map((tool, idx) => {
+        executedToolsText = "The following external tools were executed to fetch data.\n**IMPORTANT: For components displaying this data, use externalTool prop instead of query.**\n**IMPORTANT: Use the outputSchema fields to set correct config keys (xAxisKey, yAxisKey, valueKey, nameKey, etc.)**\n**IMPORTANT: Use the result data to populate deferred tool parameters when applicable.**\n\n" + executedTools.map((tool, idx) => {
           let resultPreview = "No result data";
           if (tool.result) {
             const resultStr = typeof tool.result === "string" ? tool.result : JSON.stringify(tool.result, null, 2);
             resultPreview = resultStr.length > 2e3 ? resultStr.substring(0, 2e3) + "\n... (truncated)" : resultStr;
           }
+          let outputSchemaText = "Not available";
+          if (tool.outputSchema) {
+            const fields = tool.outputSchema.fields || [];
+            const recordCount = tool.result?._recordCount || (Array.isArray(tool.result) ? tool.result.length : "unknown");
+            outputSchemaText = `Returns ARRAY of ${recordCount} records. ${tool.outputSchema.description}
+   Fields in EACH ROW (these are per-row values, NOT aggregates):
+${fields.map((f) => `     - ${f.name} (${f.type}): ${f.description}`).join("\n")}
+   NOTE: For aggregate values (SUM, COUNT, AVG across all rows), write SQL query instead.`;
+          }
           return `${idx + 1}. **${tool.name}**
    toolId: "${tool.id}" (USE THIS EXACT VALUE for externalTool.toolId)
    toolName: "${tool.name}" (USE THIS EXACT VALUE for externalTool.toolName)
    parameters: ${JSON.stringify(tool.params || {})} (USE THESE for externalTool.parameters)
-   result: ${resultPreview}`;
+   outputSchema: ${outputSchemaText}
+   result preview: ${resultPreview}`;
         }).join("\n\n");
       }
       const schemaDoc = schema.generateSchemaDocumentation();
@@ -5777,23 +5802,9 @@ ${JSON.stringify(tool.requiredFields || [], null, 2)}`;
         true
         // Parse as JSON
       );
-      logger.debug(`[${this.getProviderName()}] Component matching response parsed successfully`);
-      const componentSuggestionPattern = /c\d+:(\w+)\s*:\s*(.+)/g;
-      const suggestedComponents = [];
-      let match;
-      while ((match = componentSuggestionPattern.exec(analysisContent)) !== null) {
-        suggestedComponents.push({
-          type: match[1],
-          reasoning: match[2].trim()
-        });
-      }
       const matchedComponents = result.matchedComponents || [];
       const layoutTitle = result.layoutTitle || "Dashboard";
       const layoutDescription = result.layoutDescription || "Multi-component dashboard";
-      logger.info(`[${this.getProviderName()}] \u{1F4CA} Component Suggestions from Text Analysis: ${suggestedComponents.length}`);
-      suggestedComponents.forEach((comp, idx) => {
-        logger.info(`[${this.getProviderName()}]   c${idx + 1}: ${comp.type} - ${comp.reasoning}`);
-      });
       logger.info(`[${this.getProviderName()}] \u{1F4E6} Matched Components from LLM: ${matchedComponents.length}`);
       matchedComponents.forEach((comp, idx) => {
         logger.info(`[${this.getProviderName()}]   ${idx + 1}. ${comp.componentType} (${comp.componentName}) - ${comp.originalSuggestion || "N/A"}`);
@@ -5801,22 +5812,7 @@ ${JSON.stringify(tool.requiredFields || [], null, 2)}`;
       logger.file("\n=============================\nFull LLM response:", JSON.stringify(result, null, 2));
       const rawActions = result.actions || [];
       const actions = convertQuestionsToActions(rawActions);
-      logger.info(`[${this.getProviderName()}] Matched ${matchedComponents.length} components from text response`);
-      logger.info(`[${this.getProviderName()}] Layout title: "${layoutTitle}"`);
-      logger.info(`[${this.getProviderName()}] Layout description: "${layoutDescription}"`);
-      logger.info(`[${this.getProviderName()}] Generated ${actions.length} follow-up actions`);
-      if (suggestedComponents.length > 0) {
-        logCollector?.info(`\u{1F4DD} Text Analysis suggested ${suggestedComponents.length} dashboard components:`);
-        suggestedComponents.forEach((comp, idx) => {
-          logCollector?.info(`  c${idx + 1}: ${comp.type} - ${comp.reasoning}`);
-        });
-      }
       if (matchedComponents.length > 0) {
-        logCollector?.info(`\u{1F4E6} Matched ${matchedComponents.length} components for dashboard`);
-        if (suggestedComponents.length !== matchedComponents.length) {
-          logCollector?.warn(`\u26A0\uFE0F Component count mismatch: Suggested ${suggestedComponents.length}, but matched ${matchedComponents.length}`);
-        }
-        logCollector?.info(`Dashboard: "${layoutTitle}"`);
         matchedComponents.forEach((comp, idx) => {
           logCollector?.info(`  ${idx + 1}. ${comp.componentName} (${comp.componentType}): ${comp.reasoning}`);
           if (comp.props?.query) {
@@ -5828,12 +5824,6 @@ ${JSON.stringify(tool.requiredFields || [], null, 2)}`;
           }
         });
       }
-      if (actions.length > 0) {
-        logCollector?.info(`Generated ${actions.length} follow-up questions`);
-        actions.forEach((action, idx) => {
-          logCollector?.info(`  ${idx + 1}. ${action.name}`);
-        });
-      }
       const finalComponents = matchedComponents.map((mc) => {
         const originalComponent = components.find((c) => c.id === mc.componentId);
         if (!originalComponent) {
@@ -6402,8 +6392,10 @@ Please try rephrasing your request or contact support.
                   name: externalTool.name,
                   params: toolInput,
                   // The actual parameters used in this execution
-                  result: resultSummary
+                  result: resultSummary,
                   // Store summary instead of full result to save memory
+                  outputSchema: externalTool.outputSchema
+                  // Include output schema for component config generation
                 });
                 logger.info(`[${this.getProviderName()}] Tracked executed tool: ${externalTool.name} with params: ${JSON.stringify(toolInput)}`);
               }