@superatomai/sdk-node 0.0.47 → 0.0.48

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,25 @@ ${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 || [];
+            outputSchemaText = `${tool.outputSchema.description}
+   Fields (use these exact names for component config):
+${fields.map((f) => `     - ${f.name} (${f.type}): ${f.description}`).join("\n")}`;
+          }
           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();
@@ -6402,8 +6425,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)}`);
               }