@superatomai/sdk-web 0.0.18 → 0.0.19

package/dist/index.d.cts

@@ -2184,6 +2184,62 @@ declare function getKbNodeTags(client: SuperatomClient, timeout?: number): Promi
     message?: string;
 }>;
 
+/**
+ * Dashboard Component Service
+ * Handles DASH_COMP_REQ messages for picking components and generating props
+ */
+
+/**
+ * Response type for dashboard component request
+ */
+interface DashCompResponse {
+    success: boolean;
+    errors?: string[];
+    component?: Component;
+    reasoning?: string;
+    dataSource?: 'database' | 'external_tool' | 'none';
+}
+/**
+ * Options for dashboard component request
+ */
+interface DashCompRequestOptions {
+    /** User's prompt describing what component they need */
+    prompt: string;
+    /** Optional thread ID for conversation context */
+    threadId?: string;
+    /** Optional UI block ID for context */
+    uiBlockId?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Send a dashboard component request
+ *
+ * This method asks the LLM to:
+ * 1. Pick the most appropriate component from available components
+ * 2. Generate complete props for the component
+ * 3. Determine data source (database query or external tool)
+ *
+ * @param client - SuperatomClient instance
+ * @param options - Request options including prompt and optional context
+ * @returns Dashboard component response with selected component and props
+ *
+ * @example
+ * ```typescript
+ * const response = await sendDashCompRequest(client, {
+ *   prompt: "Show me a bar chart of sales by category",
+ *   threadId: "thread-123",
+ * });
+ *
+ * if (response.success && response.component) {
+ *   console.log('Selected component:', response.component.name);
+ *   console.log('Generated props:', response.component.props);
+ *   console.log('Data source:', response.dataSource);
+ * }
+ * ```
+ */
+declare function sendDashCompRequest(client: SuperatomClient, options: DashCompRequestOptions): Promise<DashCompResponse>;
+
 /**
  * Services Index
  * Re-exports all service functions for easy importing
@@ -2196,6 +2252,8 @@ type index_CreateBookmarkOptions = CreateBookmarkOptions;
 type index_CreateDashboardOptions = CreateDashboardOptions;
 type index_CreateReportOptions = CreateReportOptions;
 type index_CreateUIOptions = CreateUIOptions;
+type index_DashCompRequestOptions = DashCompRequestOptions;
+type index_DashCompResponse = DashCompResponse;
 type index_Dashboard = Dashboard;
 type index_Expression = Expression;
 declare const index_ExpressionSchema: typeof ExpressionSchema;
@@ -2264,6 +2322,7 @@ declare const index_searchKbNodes: typeof searchKbNodes;
 declare const index_sendAuthLoginRequest: typeof sendAuthLoginRequest;
 declare const index_sendAuthVerifyRequest: typeof sendAuthVerifyRequest;
 declare const index_sendComponents: typeof sendComponents;
+declare const index_sendDashCompRequest: typeof sendDashCompRequest;
 declare const index_sendUserPromptRequest: typeof sendUserPromptRequest;
 declare const index_sendUserPromptSuggestionsRequest: typeof sendUserPromptSuggestionsRequest;
 declare const index_updateBookmark: typeof updateBookmark;
@@ -2273,7 +2332,7 @@ declare const index_updateReport: typeof updateReport;
 declare const index_updateUI: typeof updateUI;
 declare const index_updateUser: typeof updateUser;
 declare namespace index {
-  export { type index_Binding as Binding, index_BindingSchema as BindingSchema, type index_Bookmark as Bookmark, type index_CreateBookmarkOptions as CreateBookmarkOptions, type index_CreateDashboardOptions as CreateDashboardOptions, type index_CreateReportOptions as CreateReportOptions, type index_CreateUIOptions as CreateUIOptions, type DSLRendererProps$2 as DSLRendererProps, DSLRendererPropsSchema$2 as DSLRendererPropsSchema, type index_Dashboard as Dashboard, type index_Expression as Expression, index_ExpressionSchema as ExpressionSchema, type index_ForDirective as ForDirective, index_ForDirectiveSchema as ForDirectiveSchema, type index_KbNode as KbNode, type index_Page as Page, index_PageSchema as PageSchema, type index_QueryBookmarksOptions as QueryBookmarksOptions, type index_QueryDashboardsOptions as QueryDashboardsOptions, type index_QueryReportsOptions as QueryReportsOptions, type index_QuerySpec as QuerySpec, index_QuerySpecSchema as QuerySpecSchema, type index_QueryUIsOptions as QueryUIsOptions, type index_QueryUsersOptions as QueryUsersOptions, type index_Report as Report, type DSLRendererProps$1 as ReportDSLRendererProps, type index_SearchKbNodesOptions as SearchKbNodesOptions, type index_UI as UI, type index_UIComponent as UIComponent, index_UIComponentSchema as UIComponentSchema, type DSLRendererProps as UIDSLRendererProps, type index_UIElement as UIElement, index_UIElementSchema as UIElementSchema, type index_UpdateBookmarkOptions as UpdateBookmarkOptions, type index_UpdateDashboardOptions as UpdateDashboardOptions, type index_UpdateReportOptions as UpdateReportOptions, type index_UpdateUIOptions as UpdateUIOptions, type index_User as User, index_createBookmark as createBookmark, index_createDashboard as createDashboard, index_createKbNode as createKbNode, index_createReport as createReport, index_createUI as createUI, index_createUser as createUser, index_deleteBookmark as deleteBookmark, index_deleteDashboard as deleteDashboard, index_deleteKbNode as deleteKbNode, index_deleteReport as deleteReport, index_deleteUI as deleteUI, index_deleteUser as deleteUser, index_getActions as getActions, index_getAllBookmarks as getAllBookmarks, index_getAllDashboards as getAllDashboards, index_getAllKbNodes as getAllKbNodes, index_getAllReports as getAllReports, index_getAllUIs as getAllUIs, index_getAllUsers as getAllUsers, index_getBookmark as getBookmark, index_getComponentSuggestions as getComponentSuggestions, index_getDashboard as getDashboard, index_getKbNode as getKbNode, index_getKbNodeCategories as getKbNodeCategories, index_getKbNodeTags as getKbNodeTags, index_getKbNodesByCategory as getKbNodesByCategory, index_getKbNodesByUser as getKbNodesByUser, index_getReport as getReport, index_getUI as getUI, index_getUser as getUser, index_queryBookmarks as queryBookmarks, index_queryDashboards as queryDashboards, index_queryReports as queryReports, index_queryUIs as queryUIs, index_queryUsers as queryUsers, index_requestBundle as requestBundle, index_requestData as requestData, index_searchKbNodes as searchKbNodes, index_sendAuthLoginRequest as sendAuthLoginRequest, index_sendAuthVerifyRequest as sendAuthVerifyRequest, index_sendComponents as sendComponents, index_sendUserPromptRequest as sendUserPromptRequest, index_sendUserPromptSuggestionsRequest as sendUserPromptSuggestionsRequest, index_updateBookmark as updateBookmark, index_updateDashboard as updateDashboard, index_updateKbNode as updateKbNode, index_updateReport as updateReport, index_updateUI as updateUI, index_updateUser as updateUser };
+  export { type index_Binding as Binding, index_BindingSchema as BindingSchema, type index_Bookmark as Bookmark, type index_CreateBookmarkOptions as CreateBookmarkOptions, type index_CreateDashboardOptions as CreateDashboardOptions, type index_CreateReportOptions as CreateReportOptions, type index_CreateUIOptions as CreateUIOptions, type DSLRendererProps$2 as DSLRendererProps, DSLRendererPropsSchema$2 as DSLRendererPropsSchema, type index_DashCompRequestOptions as DashCompRequestOptions, type index_DashCompResponse as DashCompResponse, type index_Dashboard as Dashboard, type index_Expression as Expression, index_ExpressionSchema as ExpressionSchema, type index_ForDirective as ForDirective, index_ForDirectiveSchema as ForDirectiveSchema, type index_KbNode as KbNode, type index_Page as Page, index_PageSchema as PageSchema, type index_QueryBookmarksOptions as QueryBookmarksOptions, type index_QueryDashboardsOptions as QueryDashboardsOptions, type index_QueryReportsOptions as QueryReportsOptions, type index_QuerySpec as QuerySpec, index_QuerySpecSchema as QuerySpecSchema, type index_QueryUIsOptions as QueryUIsOptions, type index_QueryUsersOptions as QueryUsersOptions, type index_Report as Report, type DSLRendererProps$1 as ReportDSLRendererProps, type index_SearchKbNodesOptions as SearchKbNodesOptions, type index_UI as UI, type index_UIComponent as UIComponent, index_UIComponentSchema as UIComponentSchema, type DSLRendererProps as UIDSLRendererProps, type index_UIElement as UIElement, index_UIElementSchema as UIElementSchema, type index_UpdateBookmarkOptions as UpdateBookmarkOptions, type index_UpdateDashboardOptions as UpdateDashboardOptions, type index_UpdateReportOptions as UpdateReportOptions, type index_UpdateUIOptions as UpdateUIOptions, type index_User as User, index_createBookmark as createBookmark, index_createDashboard as createDashboard, index_createKbNode as createKbNode, index_createReport as createReport, index_createUI as createUI, index_createUser as createUser, index_deleteBookmark as deleteBookmark, index_deleteDashboard as deleteDashboard, index_deleteKbNode as deleteKbNode, index_deleteReport as deleteReport, index_deleteUI as deleteUI, index_deleteUser as deleteUser, index_getActions as getActions, index_getAllBookmarks as getAllBookmarks, index_getAllDashboards as getAllDashboards, index_getAllKbNodes as getAllKbNodes, index_getAllReports as getAllReports, index_getAllUIs as getAllUIs, index_getAllUsers as getAllUsers, index_getBookmark as getBookmark, index_getComponentSuggestions as getComponentSuggestions, index_getDashboard as getDashboard, index_getKbNode as getKbNode, index_getKbNodeCategories as getKbNodeCategories, index_getKbNodeTags as getKbNodeTags, index_getKbNodesByCategory as getKbNodesByCategory, index_getKbNodesByUser as getKbNodesByUser, index_getReport as getReport, index_getUI as getUI, index_getUser as getUser, index_queryBookmarks as queryBookmarks, index_queryDashboards as queryDashboards, index_queryReports as queryReports, index_queryUIs as queryUIs, index_queryUsers as queryUsers, index_requestBundle as requestBundle, index_requestData as requestData, index_searchKbNodes as searchKbNodes, index_sendAuthLoginRequest as sendAuthLoginRequest, index_sendAuthVerifyRequest as sendAuthVerifyRequest, index_sendComponents as sendComponents, index_sendDashCompRequest as sendDashCompRequest, index_sendUserPromptRequest as sendUserPromptRequest, index_sendUserPromptSuggestionsRequest as sendUserPromptSuggestionsRequest, index_updateBookmark as updateBookmark, index_updateDashboard as updateDashboard, index_updateKbNode as updateKbNode, index_updateReport as updateReport, index_updateUI as updateUI, index_updateUser as updateUser };
 }
 
 type MessageHandler = (message: Message) => void;
@@ -2916,6 +2975,27 @@ declare class SuperatomClient {
         count?: number;
         message?: string;
     }>;
+    /**
+     * Request a dashboard component based on user prompt
+     * Uses LLM to pick the best component and generate props
+     * Supports both database queries and external tools as data sources
+     * Delegates to dash-comp service
+     *
+     * @example
+     * ```typescript
+     * const response = await client.sendDashCompRequest({
+     *   prompt: "Show me a bar chart of sales by category",
+     *   threadId: "thread-123",
+     * });
+     *
+     * if (response.success && response.component) {
+     *   console.log('Component:', response.component.name);
+     *   console.log('Props:', response.component.props);
+     *   console.log('Data source:', response.dataSource);
+     * }
+     * ```
+     */
+    sendDashCompRequest(options: DashCompRequestOptions): Promise<DashCompResponse>;
     /**
      * Internal logging
      */

package/dist/index.d.ts

@@ -2184,6 +2184,62 @@ declare function getKbNodeTags(client: SuperatomClient, timeout?: number): Promi
     message?: string;
 }>;
 
+/**
+ * Dashboard Component Service
+ * Handles DASH_COMP_REQ messages for picking components and generating props
+ */
+
+/**
+ * Response type for dashboard component request
+ */
+interface DashCompResponse {
+    success: boolean;
+    errors?: string[];
+    component?: Component;
+    reasoning?: string;
+    dataSource?: 'database' | 'external_tool' | 'none';
+}
+/**
+ * Options for dashboard component request
+ */
+interface DashCompRequestOptions {
+    /** User's prompt describing what component they need */
+    prompt: string;
+    /** Optional thread ID for conversation context */
+    threadId?: string;
+    /** Optional UI block ID for context */
+    uiBlockId?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Send a dashboard component request
+ *
+ * This method asks the LLM to:
+ * 1. Pick the most appropriate component from available components
+ * 2. Generate complete props for the component
+ * 3. Determine data source (database query or external tool)
+ *
+ * @param client - SuperatomClient instance
+ * @param options - Request options including prompt and optional context
+ * @returns Dashboard component response with selected component and props
+ *
+ * @example
+ * ```typescript
+ * const response = await sendDashCompRequest(client, {
+ *   prompt: "Show me a bar chart of sales by category",
+ *   threadId: "thread-123",
+ * });
+ *
+ * if (response.success && response.component) {
+ *   console.log('Selected component:', response.component.name);
+ *   console.log('Generated props:', response.component.props);
+ *   console.log('Data source:', response.dataSource);
+ * }
+ * ```
+ */
+declare function sendDashCompRequest(client: SuperatomClient, options: DashCompRequestOptions): Promise<DashCompResponse>;
+
 /**
  * Services Index
  * Re-exports all service functions for easy importing
@@ -2196,6 +2252,8 @@ type index_CreateBookmarkOptions = CreateBookmarkOptions;
 type index_CreateDashboardOptions = CreateDashboardOptions;
 type index_CreateReportOptions = CreateReportOptions;
 type index_CreateUIOptions = CreateUIOptions;
+type index_DashCompRequestOptions = DashCompRequestOptions;
+type index_DashCompResponse = DashCompResponse;
 type index_Dashboard = Dashboard;
 type index_Expression = Expression;
 declare const index_ExpressionSchema: typeof ExpressionSchema;
@@ -2264,6 +2322,7 @@ declare const index_searchKbNodes: typeof searchKbNodes;
 declare const index_sendAuthLoginRequest: typeof sendAuthLoginRequest;
 declare const index_sendAuthVerifyRequest: typeof sendAuthVerifyRequest;
 declare const index_sendComponents: typeof sendComponents;
+declare const index_sendDashCompRequest: typeof sendDashCompRequest;
 declare const index_sendUserPromptRequest: typeof sendUserPromptRequest;
 declare const index_sendUserPromptSuggestionsRequest: typeof sendUserPromptSuggestionsRequest;
 declare const index_updateBookmark: typeof updateBookmark;
@@ -2273,7 +2332,7 @@ declare const index_updateReport: typeof updateReport;
 declare const index_updateUI: typeof updateUI;
 declare const index_updateUser: typeof updateUser;
 declare namespace index {
-  export { type index_Binding as Binding, index_BindingSchema as BindingSchema, type index_Bookmark as Bookmark, type index_CreateBookmarkOptions as CreateBookmarkOptions, type index_CreateDashboardOptions as CreateDashboardOptions, type index_CreateReportOptions as CreateReportOptions, type index_CreateUIOptions as CreateUIOptions, type DSLRendererProps$2 as DSLRendererProps, DSLRendererPropsSchema$2 as DSLRendererPropsSchema, type index_Dashboard as Dashboard, type index_Expression as Expression, index_ExpressionSchema as ExpressionSchema, type index_ForDirective as ForDirective, index_ForDirectiveSchema as ForDirectiveSchema, type index_KbNode as KbNode, type index_Page as Page, index_PageSchema as PageSchema, type index_QueryBookmarksOptions as QueryBookmarksOptions, type index_QueryDashboardsOptions as QueryDashboardsOptions, type index_QueryReportsOptions as QueryReportsOptions, type index_QuerySpec as QuerySpec, index_QuerySpecSchema as QuerySpecSchema, type index_QueryUIsOptions as QueryUIsOptions, type index_QueryUsersOptions as QueryUsersOptions, type index_Report as Report, type DSLRendererProps$1 as ReportDSLRendererProps, type index_SearchKbNodesOptions as SearchKbNodesOptions, type index_UI as UI, type index_UIComponent as UIComponent, index_UIComponentSchema as UIComponentSchema, type DSLRendererProps as UIDSLRendererProps, type index_UIElement as UIElement, index_UIElementSchema as UIElementSchema, type index_UpdateBookmarkOptions as UpdateBookmarkOptions, type index_UpdateDashboardOptions as UpdateDashboardOptions, type index_UpdateReportOptions as UpdateReportOptions, type index_UpdateUIOptions as UpdateUIOptions, type index_User as User, index_createBookmark as createBookmark, index_createDashboard as createDashboard, index_createKbNode as createKbNode, index_createReport as createReport, index_createUI as createUI, index_createUser as createUser, index_deleteBookmark as deleteBookmark, index_deleteDashboard as deleteDashboard, index_deleteKbNode as deleteKbNode, index_deleteReport as deleteReport, index_deleteUI as deleteUI, index_deleteUser as deleteUser, index_getActions as getActions, index_getAllBookmarks as getAllBookmarks, index_getAllDashboards as getAllDashboards, index_getAllKbNodes as getAllKbNodes, index_getAllReports as getAllReports, index_getAllUIs as getAllUIs, index_getAllUsers as getAllUsers, index_getBookmark as getBookmark, index_getComponentSuggestions as getComponentSuggestions, index_getDashboard as getDashboard, index_getKbNode as getKbNode, index_getKbNodeCategories as getKbNodeCategories, index_getKbNodeTags as getKbNodeTags, index_getKbNodesByCategory as getKbNodesByCategory, index_getKbNodesByUser as getKbNodesByUser, index_getReport as getReport, index_getUI as getUI, index_getUser as getUser, index_queryBookmarks as queryBookmarks, index_queryDashboards as queryDashboards, index_queryReports as queryReports, index_queryUIs as queryUIs, index_queryUsers as queryUsers, index_requestBundle as requestBundle, index_requestData as requestData, index_searchKbNodes as searchKbNodes, index_sendAuthLoginRequest as sendAuthLoginRequest, index_sendAuthVerifyRequest as sendAuthVerifyRequest, index_sendComponents as sendComponents, index_sendUserPromptRequest as sendUserPromptRequest, index_sendUserPromptSuggestionsRequest as sendUserPromptSuggestionsRequest, index_updateBookmark as updateBookmark, index_updateDashboard as updateDashboard, index_updateKbNode as updateKbNode, index_updateReport as updateReport, index_updateUI as updateUI, index_updateUser as updateUser };
+  export { type index_Binding as Binding, index_BindingSchema as BindingSchema, type index_Bookmark as Bookmark, type index_CreateBookmarkOptions as CreateBookmarkOptions, type index_CreateDashboardOptions as CreateDashboardOptions, type index_CreateReportOptions as CreateReportOptions, type index_CreateUIOptions as CreateUIOptions, type DSLRendererProps$2 as DSLRendererProps, DSLRendererPropsSchema$2 as DSLRendererPropsSchema, type index_DashCompRequestOptions as DashCompRequestOptions, type index_DashCompResponse as DashCompResponse, type index_Dashboard as Dashboard, type index_Expression as Expression, index_ExpressionSchema as ExpressionSchema, type index_ForDirective as ForDirective, index_ForDirectiveSchema as ForDirectiveSchema, type index_KbNode as KbNode, type index_Page as Page, index_PageSchema as PageSchema, type index_QueryBookmarksOptions as QueryBookmarksOptions, type index_QueryDashboardsOptions as QueryDashboardsOptions, type index_QueryReportsOptions as QueryReportsOptions, type index_QuerySpec as QuerySpec, index_QuerySpecSchema as QuerySpecSchema, type index_QueryUIsOptions as QueryUIsOptions, type index_QueryUsersOptions as QueryUsersOptions, type index_Report as Report, type DSLRendererProps$1 as ReportDSLRendererProps, type index_SearchKbNodesOptions as SearchKbNodesOptions, type index_UI as UI, type index_UIComponent as UIComponent, index_UIComponentSchema as UIComponentSchema, type DSLRendererProps as UIDSLRendererProps, type index_UIElement as UIElement, index_UIElementSchema as UIElementSchema, type index_UpdateBookmarkOptions as UpdateBookmarkOptions, type index_UpdateDashboardOptions as UpdateDashboardOptions, type index_UpdateReportOptions as UpdateReportOptions, type index_UpdateUIOptions as UpdateUIOptions, type index_User as User, index_createBookmark as createBookmark, index_createDashboard as createDashboard, index_createKbNode as createKbNode, index_createReport as createReport, index_createUI as createUI, index_createUser as createUser, index_deleteBookmark as deleteBookmark, index_deleteDashboard as deleteDashboard, index_deleteKbNode as deleteKbNode, index_deleteReport as deleteReport, index_deleteUI as deleteUI, index_deleteUser as deleteUser, index_getActions as getActions, index_getAllBookmarks as getAllBookmarks, index_getAllDashboards as getAllDashboards, index_getAllKbNodes as getAllKbNodes, index_getAllReports as getAllReports, index_getAllUIs as getAllUIs, index_getAllUsers as getAllUsers, index_getBookmark as getBookmark, index_getComponentSuggestions as getComponentSuggestions, index_getDashboard as getDashboard, index_getKbNode as getKbNode, index_getKbNodeCategories as getKbNodeCategories, index_getKbNodeTags as getKbNodeTags, index_getKbNodesByCategory as getKbNodesByCategory, index_getKbNodesByUser as getKbNodesByUser, index_getReport as getReport, index_getUI as getUI, index_getUser as getUser, index_queryBookmarks as queryBookmarks, index_queryDashboards as queryDashboards, index_queryReports as queryReports, index_queryUIs as queryUIs, index_queryUsers as queryUsers, index_requestBundle as requestBundle, index_requestData as requestData, index_searchKbNodes as searchKbNodes, index_sendAuthLoginRequest as sendAuthLoginRequest, index_sendAuthVerifyRequest as sendAuthVerifyRequest, index_sendComponents as sendComponents, index_sendDashCompRequest as sendDashCompRequest, index_sendUserPromptRequest as sendUserPromptRequest, index_sendUserPromptSuggestionsRequest as sendUserPromptSuggestionsRequest, index_updateBookmark as updateBookmark, index_updateDashboard as updateDashboard, index_updateKbNode as updateKbNode, index_updateReport as updateReport, index_updateUI as updateUI, index_updateUser as updateUser };
 }
 
 type MessageHandler = (message: Message) => void;
@@ -2916,6 +2975,27 @@ declare class SuperatomClient {
         count?: number;
         message?: string;
     }>;
+    /**
+     * Request a dashboard component based on user prompt
+     * Uses LLM to pick the best component and generate props
+     * Supports both database queries and external tools as data sources
+     * Delegates to dash-comp service
+     *
+     * @example
+     * ```typescript
+     * const response = await client.sendDashCompRequest({
+     *   prompt: "Show me a bar chart of sales by category",
+     *   threadId: "thread-123",
+     * });
+     *
+     * if (response.success && response.component) {
+     *   console.log('Component:', response.component.name);
+     *   console.log('Props:', response.component.props);
+     *   console.log('Data source:', response.dataSource);
+     * }
+     * ```
+     */
+    sendDashCompRequest(options: DashCompRequestOptions): Promise<DashCompResponse>;
     /**
      * Internal logging
      */

package/dist/index.js

@@ -330,6 +330,42 @@ var UserPromptSuggestionsResponseMessageSchema = z.object({
   to: MessageParticipantSchema.optional(),
   payload: UserPromptSuggestionsResponsePayloadSchema
 });
+var DashCompRequestPayloadSchema = z.object({
+  prompt: z.string(),
+  SA_RUNTIME: z.object({
+    threadId: z.string().optional(),
+    uiBlockId: z.string().optional()
+  }).optional()
+});
+var DashCompRequestMessageSchema = z.object({
+  id: z.string(),
+  type: z.literal("DASH_COMP_REQ"),
+  from: MessageParticipantSchema,
+  to: MessageParticipantSchema.optional(),
+  payload: DashCompRequestPayloadSchema
+});
+z.object({
+  toolId: z.string(),
+  toolName: z.string(),
+  action: z.enum(["get", "create", "update", "delete"]),
+  params: z.record(z.string(), z.unknown())
+});
+var DashCompResponsePayloadSchema = z.object({
+  success: z.boolean(),
+  errors: z.array(z.string()).optional(),
+  data: z.object({
+    component: ComponentSchema.optional(),
+    reasoning: z.string().optional(),
+    dataSource: z.enum(["database", "external_tool", "none"]).optional()
+  }).optional()
+});
+z.object({
+  id: z.string(),
+  type: z.literal("DASH_COMP_RES"),
+  from: MessageParticipantSchema,
+  to: MessageParticipantSchema.optional(),
+  payload: DashCompResponsePayloadSchema
+});
 var BundleRequestPayloadSchema = z.object({
   devbundlereq: z.boolean().optional().default(false)
 });
@@ -869,6 +905,7 @@ __export(services_exports, {
   sendAuthLoginRequest: () => sendAuthLoginRequest,
   sendAuthVerifyRequest: () => sendAuthVerifyRequest,
   sendComponents: () => sendComponents,
+  sendDashCompRequest: () => sendDashCompRequest,
   sendUserPromptRequest: () => sendUserPromptRequest,
   sendUserPromptSuggestionsRequest: () => sendUserPromptSuggestionsRequest,
   updateBookmark: () => updateBookmark,
@@ -2175,6 +2212,51 @@ async function getKbNodeTags(client, timeout) {
   };
 }
 
+// src/services/dash-comp.ts
+async function sendDashCompRequest(client, options) {
+  const { prompt, threadId, uiBlockId, timeout } = options;
+  const messageId = `dash_comp_req_${Date.now()}_${Math.random().toString(36).substring(7)}`;
+  const message = DashCompRequestMessageSchema.parse({
+    id: messageId,
+    type: "DASH_COMP_REQ",
+    from: {
+      type: client.type
+    },
+    to: {
+      type: "data-agent"
+    },
+    payload: {
+      prompt,
+      SA_RUNTIME: threadId || uiBlockId ? {
+        threadId,
+        uiBlockId
+      } : void 0
+    }
+  });
+  try {
+    const response = await client.sendWithResponse(message, timeout);
+    const payload = response.payload;
+    if (!payload.success) {
+      return {
+        success: false,
+        errors: payload.errors || ["Unknown error occurred"]
+      };
+    }
+    return {
+      success: true,
+      component: payload.data?.component,
+      reasoning: payload.data?.reasoning,
+      dataSource: payload.data?.dataSource
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : "Request failed";
+    return {
+      success: false,
+      errors: [errorMessage]
+    };
+  }
+}
+
 // src/client.ts
 var SuperatomClient = class {
   constructor(config) {
@@ -2842,6 +2924,32 @@ var SuperatomClient = class {
     this.log("info", "Fetching KB node tags");
     return getKbNodeTags(this, timeout);
   }
+  // ==================== Dashboard Component Methods ====================
+  // These methods delegate to dash-comp service for component selection
+  /**
+   * Request a dashboard component based on user prompt
+   * Uses LLM to pick the best component and generate props
+   * Supports both database queries and external tools as data sources
+   * Delegates to dash-comp service
+   *
+   * @example
+   * ```typescript
+   * const response = await client.sendDashCompRequest({
+   *   prompt: "Show me a bar chart of sales by category",
+   *   threadId: "thread-123",
+   * });
+   *
+   * if (response.success && response.component) {
+   *   console.log('Component:', response.component.name);
+   *   console.log('Props:', response.component.props);
+   *   console.log('Data source:', response.dataSource);
+   * }
+   * ```
+   */
+  async sendDashCompRequest(options) {
+    this.log("info", "Sending dash comp request for prompt:", options.prompt.substring(0, 50) + "...");
+    return sendDashCompRequest(this, options);
+  }
   /**
    * Internal logging
    */