@erdoai/ui 0.1.48 → 0.1.50

package/dist/index.d.cts

@@ -22,7 +22,14 @@ interface DatasetDetails {
  * recreating on every render.
  */
 interface DataFetcher {
-    fetchDatasetContents: (slug: string, invocationId: string) => Promise<any[]>;
+    /**
+     * Fetch dataset contents for charts/tables.
+     * @param slug - Dataset slug to query
+     * @param invocationId - Thread/invocation ID for context
+     * @param sqlQuery - Optional SQL query to run against the dataset
+     * @param resourceKey - Optional resource key to look up range/sheet metadata for Excel files
+     */
+    fetchDatasetContents: (slug: string, invocationId: string, sqlQuery?: string, resourceKey?: string) => Promise<any[]>;
     /**
      * Get dataset details (id and name) by slug.
      * Used by DatasetDownload component to resolve slug to downloadable dataset.
@@ -30,9 +37,14 @@ interface DataFetcher {
     getDatasetDetails?: (slug: string, threadId: string) => Promise<DatasetDetails | null>;
     /**
      * Download a dataset file by ID.
+     * If sqlQuery is provided, the query is executed and results returned as CSV.
+     * If no query is provided, the raw dataset file is returned.
+     * @param datasetId - Dataset UUID
+     * @param sqlQuery - Optional SQL query to execute
+     * @param resourceKey - Optional resource key for sheet/range metadata
      * Returns a Blob that can be saved as a file.
      */
-    downloadDataset?: (datasetId: string) => Promise<Blob>;
+    downloadDataset?: (datasetId: string, sqlQuery?: string, resourceKey?: string) => Promise<Blob>;
 }
 /**
  * Configuration for the ErdoProvider.
@@ -295,6 +307,10 @@ interface Series$1 {
     key: string;
     color: string;
     datasetSlug: string;
+    /** Optional SQL query to run against the dataset */
+    sqlQuery?: string;
+    /** Optional resource key for Excel files with headers not on row 1 */
+    resourceKey?: string;
     axisIndex?: number;
     filters?: Filter$1[];
 }
@@ -344,6 +360,10 @@ interface DatasetTableProps {
     title?: string;
     invocationId: string;
     datasetSlug: string;
+    /** Optional SQL query to run against the dataset */
+    sqlQuery?: string;
+    /** Optional resource key for Excel files with headers not on row 1 */
+    resourceKey?: string;
     columns?: TableColumn$1[];
     maxRows?: number;
     /** Class for the outer container */
@@ -363,7 +383,7 @@ interface DatasetTableProps {
  * A table component that fetches data from a dataset and renders it.
  * Requires ErdoProvider to be set up with data fetching capabilities.
  */
-declare function DatasetTable({ title, invocationId, datasetSlug, columns, maxRows, className, tableWrapperClassName, headerClassName, loadingClassName, emptyClassName, onScrollUpdate, }: DatasetTableProps): react_jsx_runtime.JSX.Element;
+declare function DatasetTable({ title, invocationId, datasetSlug, sqlQuery, resourceKey, columns, maxRows, className, tableWrapperClassName, headerClassName, loadingClassName, emptyClassName, onScrollUpdate, }: DatasetTableProps): react_jsx_runtime.JSX.Element;
 
 /**
  * JSON streaming parser utilities.
@@ -442,7 +462,7 @@ declare function isParsingInProgress(value: any): boolean;
  * They represent the structure of entities that can be built from SSE events.
  */
 
-type ContentType = 'text' | 'json' | 'xml' | 'thinking' | 'redacted_thinking';
+type ContentType = 'text' | 'json' | 'xml' | 'thinking' | 'redacted_thinking' | 'bot_invocation' | 'bot_invocation_result' | 'tool_invocation' | 'tool_result';
 declare function isJsonLike(contentType: ContentType, uiContentType: string): boolean;
 type EntityType = 'message' | 'message_content' | 'invocation' | 'output' | 'output_content' | 'step' | 'result_handler' | 'status' | 'log';
 type MessageStreamingState = 'in_progress' | 'completed';
@@ -492,7 +512,7 @@ interface MessageContent extends BaseContentFields {
     id: string;
     message_id: string;
     content_type: ContentType;
-    content: string;
+    content: string | Record<string, unknown>;
     created_by_invocation_id?: string;
     user_visibility: string;
     bot_visibility: string;
@@ -530,7 +550,7 @@ interface OutputContent extends BaseContentFields {
     _type: 'output_content';
     id: string;
     output_id: string;
-    content: string;
+    content: string | Record<string, unknown>;
     content_type: ContentType;
     user_visibility: string;
     bot_visibility: string;
@@ -581,6 +601,7 @@ interface Step {
         Valid: boolean;
     };
     bot_id?: string;
+    bot_name?: string;
     result_handler_id: string;
     step_order: {
         Int32: number;
@@ -612,6 +633,7 @@ interface Step {
         Valid: boolean;
     };
     depends_on: string[];
+    history_content_type?: string;
     eventsByID: Record<string, InvocationEvent$1>;
     currentStatus: Status | null;
 }
@@ -925,6 +947,10 @@ interface Series {
     key: string;
     color: string;
     dataset_slug?: string;
+    /** Optional SQL query to run against the dataset */
+    sql_query?: string;
+    /** Optional resource key for Excel files with headers not on row 1 */
+    resource_key?: string;
     axis_index?: number;
     filters?: Filter[];
 }
@@ -1189,6 +1215,10 @@ interface DatasetDownloadProps {
     invocationId?: string;
     /** Optional thread ID override (falls back to provider's threadId) */
     threadId?: string;
+    /** Optional SQL query - if provided, query is executed and results returned as CSV */
+    sqlQuery?: string;
+    /** Optional resource key for sheet/range metadata (Excel files) */
+    resourceKey?: string;
     /** Optional class name for styling */
     className?: string;
 }
@@ -1203,7 +1233,31 @@ interface DatasetDownloadProps {
  * <DatasetDownload slug="my-dataset" invocationId="abc123" />
  * ```
  */
-declare function DatasetDownload({ slug, invocationId: _invocationId, threadId: threadIdProp, className, }: DatasetDownloadProps): react_jsx_runtime.JSX.Element | null;
+declare function DatasetDownload({ slug, invocationId: _invocationId, threadId: threadIdProp, sqlQuery, resourceKey, className, }: DatasetDownloadProps): react_jsx_runtime.JSX.Element | null;
+
+interface Memory {
+    id: string;
+    content: string;
+    description: string;
+    type: string;
+    tags?: string[];
+    created_at?: string;
+    extra?: Record<string, unknown>;
+}
+interface MemoryContentProps {
+    /** Array of memories or object with memories array */
+    content: Memory[] | {
+        memories: Memory[];
+    };
+    className?: string;
+}
+/**
+ * Renders memory search results with proper formatting for different memory types.
+ *
+ * Snippets are shown with truncated descriptions and expandable content.
+ * Other memory types show their content directly.
+ */
+declare function MemoryContent({ content, className }: MemoryContentProps): react_jsx_runtime.JSX.Element;
 
 /** Node structure from UI generation content */
 interface UINode {
@@ -1237,6 +1291,10 @@ interface ChartNodeContent {
 interface TableNodeContent {
     table_title: string;
     dataset_slug?: string;
+    /** Optional SQL query to run against the dataset */
+    sql_query?: string;
+    /** Optional resource key for Excel files with headers not on row 1 */
+    resource_key?: string;
     columns: TableColumn[];
 }
 /** Text markdown node content structure */
@@ -1355,6 +1413,7 @@ interface UseDatasetContentsResult {
  *
  * @param datasetSlug - The slug/identifier of the dataset
  * @param invocationId - The invocation ID context
+ * @param sqlQuery - Optional SQL query to run against the dataset
  * @returns Object with data, isLoading, error, and refetch function
  *
  * @example
@@ -1364,14 +1423,34 @@ interface UseDatasetContentsResult {
  * if (error) return <Error message={error.message} />;
  * return <Chart data={data} />;
  * ```
+ *
+ * @example With SQL query
+ * ```tsx
+ * const { data } = useDatasetContents(
+ *   'my-database',
+ *   invocationId,
+ *   'SELECT * FROM users ORDER BY created_at DESC LIMIT 10'
+ * );
+ * ```
+ *
+ * @example With resource key (for Excel files with headers not on row 1)
+ * ```tsx
+ * const { data } = useDatasetContents(
+ *   'my-excel-dataset',
+ *   invocationId,
+ *   undefined,
+ *   'abc123::Sheet1::table_1'
+ * );
+ * ```
  */
-declare function useDatasetContents(datasetSlug: string, invocationId: string): UseDatasetContentsResult;
+declare function useDatasetContents(datasetSlug: string, invocationId: string, sqlQuery?: string, resourceKey?: string): UseDatasetContentsResult;
 /**
  * Hook to fetch contents of multiple datasets in parallel.
  * Uses the DataFetcher from ErdoProvider if available, otherwise falls back to REST API.
  *
  * @param datasetSlugs - Array of dataset slugs/identifiers
  * @param invocationId - The invocation ID context
+ * @param sqlQueries - Optional map of dataset slug to SQL query
  * @returns Array of result objects, one per dataset
  *
  * @example
@@ -1380,8 +1459,27 @@ declare function useDatasetContents(datasetSlug: string, invocationId: string):
  * const isLoading = results.some(r => r.isLoading);
  * const allData = results.map(r => r.data || []);
  * ```
+ *
+ * @example With SQL queries
+ * ```tsx
+ * const results = useMultipleDatasetContents(
+ *   ['my-db', 'other-db'],
+ *   invocationId,
+ *   { 'my-db': 'SELECT * FROM users LIMIT 10' }
+ * );
+ * ```
+ *
+ * @example With resource keys
+ * ```tsx
+ * const results = useMultipleDatasetContents(
+ *   ['dataset-1', 'dataset-2'],
+ *   invocationId,
+ *   undefined,
+ *   { 'dataset-1': 'abc123::Sheet1::table_1' }
+ * );
+ * ```
  */
-declare function useMultipleDatasetContents(datasetSlugs: string[], invocationId: string): UseDatasetContentsResult[];
+declare function useMultipleDatasetContents(datasetSlugs: string[], invocationId: string, sqlQueries?: Record<string, string>, resourceKeys?: Record<string, string>): UseDatasetContentsResult[];
 
 interface UseThreadOptions {
     /** Initial thread ID to use (if resuming an existing thread) */
@@ -1626,4 +1724,4 @@ declare function handleIncrementalMixedJsonParsing(outputContent: MessageContent
  */
 declare function handleSSEEvent(eventType: string, event: SSEEventData, path: string[], threadID: string, activeMessagesByID: Record<string, MessageWithContents>, currentEntity?: Entity | null, parents?: Entity[], entityIds?: Record<string, string>): Entity | null;
 
-export { BarChart, type BaseChartProps, type BotInvocation, BotInvocationContent, type BotInvocationContentData, type BotInvocationContentProps, type BotInvocationData, type BotInvocationEventInfo, type BotInvocationStatusInfo, Chart, type ChartConfig, ChartContainer, ChartContent, type ChartContentProps, ChartLegend, ChartLegendContent, ChartNode, type ChartNodeContent, ChartStyle, ChartTooltip, ChartTooltipContent, CodeexecContent, type CodeexecContentProps, CodegenContent, type CodegenContentProps, CollapsibleCodeBlock, type CollapsibleCodeBlockProps, Content, type ContentChartConfig, type ContentChunk, type ContentComponentProps, type ContentProps, type ContentType, type DataFetcher, DatasetChart, type DatasetChartProps, type DatasetDetails, DatasetDownload, type DatasetDownloadProps, DatasetTable, type DatasetTableProps, DownloadButtonNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, HeatmapChart, InvocationEvent, type InvocationEventProps, InvocationEvents, type InvocationEventsProps, InvocationStatus, JSONStreamParser, type JSONValue, JsonContent, type JsonContentProps, LineChart, Loader, Log, LogContent, type LogContentProps, type LogProps, MarkdownContent, type MarkdownContentProps, type Message, type MessageContent, type MessageStreamingState, type MessageWithContents, type NodeRendererProps, type NullString, Output, type OutputContent, type OutputProps, type OutputWithContents, PieChart, type ResolvedBotInvocation, type ResultHandler, type SSEEventData, ScatterChart, type SpinnerStatus, SqlContent, type SqlContentProps, type Status, type StatusEvent, StatusSpinner, type StatusSpinnerProps, StderrText, StdoutText, StdwarnText, type Step, StepInvocation, type StepInvocationProps, StepInvocationStatus, type StepInvocationStatusProps, SuggestionsNode, type SuggestionsNodeContent, TableContent, type TableContentProps, TableNode, type TableNodeContent, TextContent, type TextContentProps, TextMarkdownNode, type TextMarkdownNodeContent, ThinkingContent, type ThinkingContentProps, ToolGroupContent, type ToolGroupContentProps, UIGenerationNodes, type UIGenerationNodesProps, type UINode, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, cn, extractContentItems, formatValue, handleIncrementalMixedJsonParsing, handleSSEEvent, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, nodeComponents, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, toSnakeCase, unwrapNullString, unwrapNullStringOr, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useMultipleDatasetContents, useThread };
+export { BarChart, type BaseChartProps, type BotInvocation, BotInvocationContent, type BotInvocationContentData, type BotInvocationContentProps, type BotInvocationData, type BotInvocationEventInfo, type BotInvocationStatusInfo, Chart, type ChartConfig, ChartContainer, ChartContent, type ChartContentProps, ChartLegend, ChartLegendContent, ChartNode, type ChartNodeContent, ChartStyle, ChartTooltip, ChartTooltipContent, CodeexecContent, type CodeexecContentProps, CodegenContent, type CodegenContentProps, CollapsibleCodeBlock, type CollapsibleCodeBlockProps, Content, type ContentChartConfig, type ContentChunk, type ContentComponentProps, type ContentProps, type ContentType, type DataFetcher, DatasetChart, type DatasetChartProps, type DatasetDetails, DatasetDownload, type DatasetDownloadProps, DatasetTable, type DatasetTableProps, DownloadButtonNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, HeatmapChart, InvocationEvent, type InvocationEventProps, InvocationEvents, type InvocationEventsProps, InvocationStatus, JSONStreamParser, type JSONValue, JsonContent, type JsonContentProps, LineChart, Loader, Log, LogContent, type LogContentProps, type LogProps, MarkdownContent, type MarkdownContentProps, type Memory, MemoryContent, type MemoryContentProps, type Message, type MessageContent, type MessageStreamingState, type MessageWithContents, type NodeRendererProps, type NullString, Output, type OutputContent, type OutputProps, type OutputWithContents, PieChart, type ResolvedBotInvocation, type ResultHandler, type SSEEventData, ScatterChart, type SpinnerStatus, SqlContent, type SqlContentProps, type Status, type StatusEvent, StatusSpinner, type StatusSpinnerProps, StderrText, StdoutText, StdwarnText, type Step, StepInvocation, type StepInvocationProps, StepInvocationStatus, type StepInvocationStatusProps, SuggestionsNode, type SuggestionsNodeContent, TableContent, type TableContentProps, TableNode, type TableNodeContent, TextContent, type TextContentProps, TextMarkdownNode, type TextMarkdownNodeContent, ThinkingContent, type ThinkingContentProps, ToolGroupContent, type ToolGroupContentProps, UIGenerationNodes, type UIGenerationNodesProps, type UINode, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, cn, extractContentItems, formatValue, handleIncrementalMixedJsonParsing, handleSSEEvent, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, nodeComponents, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, toSnakeCase, unwrapNullString, unwrapNullStringOr, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useMultipleDatasetContents, useThread };

package/dist/index.d.ts

@@ -22,7 +22,14 @@ interface DatasetDetails {
  * recreating on every render.
  */
 interface DataFetcher {
-    fetchDatasetContents: (slug: string, invocationId: string) => Promise<any[]>;
+    /**
+     * Fetch dataset contents for charts/tables.
+     * @param slug - Dataset slug to query
+     * @param invocationId - Thread/invocation ID for context
+     * @param sqlQuery - Optional SQL query to run against the dataset
+     * @param resourceKey - Optional resource key to look up range/sheet metadata for Excel files
+     */
+    fetchDatasetContents: (slug: string, invocationId: string, sqlQuery?: string, resourceKey?: string) => Promise<any[]>;
     /**
      * Get dataset details (id and name) by slug.
      * Used by DatasetDownload component to resolve slug to downloadable dataset.
@@ -30,9 +37,14 @@ interface DataFetcher {
     getDatasetDetails?: (slug: string, threadId: string) => Promise<DatasetDetails | null>;
     /**
      * Download a dataset file by ID.
+     * If sqlQuery is provided, the query is executed and results returned as CSV.
+     * If no query is provided, the raw dataset file is returned.
+     * @param datasetId - Dataset UUID
+     * @param sqlQuery - Optional SQL query to execute
+     * @param resourceKey - Optional resource key for sheet/range metadata
      * Returns a Blob that can be saved as a file.
      */
-    downloadDataset?: (datasetId: string) => Promise<Blob>;
+    downloadDataset?: (datasetId: string, sqlQuery?: string, resourceKey?: string) => Promise<Blob>;
 }
 /**
  * Configuration for the ErdoProvider.
@@ -295,6 +307,10 @@ interface Series$1 {
     key: string;
     color: string;
     datasetSlug: string;
+    /** Optional SQL query to run against the dataset */
+    sqlQuery?: string;
+    /** Optional resource key for Excel files with headers not on row 1 */
+    resourceKey?: string;
     axisIndex?: number;
     filters?: Filter$1[];
 }
@@ -344,6 +360,10 @@ interface DatasetTableProps {
     title?: string;
     invocationId: string;
     datasetSlug: string;
+    /** Optional SQL query to run against the dataset */
+    sqlQuery?: string;
+    /** Optional resource key for Excel files with headers not on row 1 */
+    resourceKey?: string;
     columns?: TableColumn$1[];
     maxRows?: number;
     /** Class for the outer container */
@@ -363,7 +383,7 @@ interface DatasetTableProps {
  * A table component that fetches data from a dataset and renders it.
  * Requires ErdoProvider to be set up with data fetching capabilities.
  */
-declare function DatasetTable({ title, invocationId, datasetSlug, columns, maxRows, className, tableWrapperClassName, headerClassName, loadingClassName, emptyClassName, onScrollUpdate, }: DatasetTableProps): react_jsx_runtime.JSX.Element;
+declare function DatasetTable({ title, invocationId, datasetSlug, sqlQuery, resourceKey, columns, maxRows, className, tableWrapperClassName, headerClassName, loadingClassName, emptyClassName, onScrollUpdate, }: DatasetTableProps): react_jsx_runtime.JSX.Element;
 
 /**
  * JSON streaming parser utilities.
@@ -442,7 +462,7 @@ declare function isParsingInProgress(value: any): boolean;
  * They represent the structure of entities that can be built from SSE events.
  */
 
-type ContentType = 'text' | 'json' | 'xml' | 'thinking' | 'redacted_thinking';
+type ContentType = 'text' | 'json' | 'xml' | 'thinking' | 'redacted_thinking' | 'bot_invocation' | 'bot_invocation_result' | 'tool_invocation' | 'tool_result';
 declare function isJsonLike(contentType: ContentType, uiContentType: string): boolean;
 type EntityType = 'message' | 'message_content' | 'invocation' | 'output' | 'output_content' | 'step' | 'result_handler' | 'status' | 'log';
 type MessageStreamingState = 'in_progress' | 'completed';
@@ -492,7 +512,7 @@ interface MessageContent extends BaseContentFields {
     id: string;
     message_id: string;
     content_type: ContentType;
-    content: string;
+    content: string | Record<string, unknown>;
     created_by_invocation_id?: string;
     user_visibility: string;
     bot_visibility: string;
@@ -530,7 +550,7 @@ interface OutputContent extends BaseContentFields {
     _type: 'output_content';
     id: string;
     output_id: string;
-    content: string;
+    content: string | Record<string, unknown>;
     content_type: ContentType;
     user_visibility: string;
     bot_visibility: string;
@@ -581,6 +601,7 @@ interface Step {
         Valid: boolean;
     };
     bot_id?: string;
+    bot_name?: string;
     result_handler_id: string;
     step_order: {
         Int32: number;
@@ -612,6 +633,7 @@ interface Step {
         Valid: boolean;
     };
     depends_on: string[];
+    history_content_type?: string;
     eventsByID: Record<string, InvocationEvent$1>;
     currentStatus: Status | null;
 }
@@ -925,6 +947,10 @@ interface Series {
     key: string;
     color: string;
     dataset_slug?: string;
+    /** Optional SQL query to run against the dataset */
+    sql_query?: string;
+    /** Optional resource key for Excel files with headers not on row 1 */
+    resource_key?: string;
     axis_index?: number;
     filters?: Filter[];
 }
@@ -1189,6 +1215,10 @@ interface DatasetDownloadProps {
     invocationId?: string;
     /** Optional thread ID override (falls back to provider's threadId) */
     threadId?: string;
+    /** Optional SQL query - if provided, query is executed and results returned as CSV */
+    sqlQuery?: string;
+    /** Optional resource key for sheet/range metadata (Excel files) */
+    resourceKey?: string;
     /** Optional class name for styling */
     className?: string;
 }
@@ -1203,7 +1233,31 @@ interface DatasetDownloadProps {
  * <DatasetDownload slug="my-dataset" invocationId="abc123" />
  * ```
  */
-declare function DatasetDownload({ slug, invocationId: _invocationId, threadId: threadIdProp, className, }: DatasetDownloadProps): react_jsx_runtime.JSX.Element | null;
+declare function DatasetDownload({ slug, invocationId: _invocationId, threadId: threadIdProp, sqlQuery, resourceKey, className, }: DatasetDownloadProps): react_jsx_runtime.JSX.Element | null;
+
+interface Memory {
+    id: string;
+    content: string;
+    description: string;
+    type: string;
+    tags?: string[];
+    created_at?: string;
+    extra?: Record<string, unknown>;
+}
+interface MemoryContentProps {
+    /** Array of memories or object with memories array */
+    content: Memory[] | {
+        memories: Memory[];
+    };
+    className?: string;
+}
+/**
+ * Renders memory search results with proper formatting for different memory types.
+ *
+ * Snippets are shown with truncated descriptions and expandable content.
+ * Other memory types show their content directly.
+ */
+declare function MemoryContent({ content, className }: MemoryContentProps): react_jsx_runtime.JSX.Element;
 
 /** Node structure from UI generation content */
 interface UINode {
@@ -1237,6 +1291,10 @@ interface ChartNodeContent {
 interface TableNodeContent {
     table_title: string;
     dataset_slug?: string;
+    /** Optional SQL query to run against the dataset */
+    sql_query?: string;
+    /** Optional resource key for Excel files with headers not on row 1 */
+    resource_key?: string;
     columns: TableColumn[];
 }
 /** Text markdown node content structure */
@@ -1355,6 +1413,7 @@ interface UseDatasetContentsResult {
  *
  * @param datasetSlug - The slug/identifier of the dataset
  * @param invocationId - The invocation ID context
+ * @param sqlQuery - Optional SQL query to run against the dataset
  * @returns Object with data, isLoading, error, and refetch function
  *
  * @example
@@ -1364,14 +1423,34 @@ interface UseDatasetContentsResult {
  * if (error) return <Error message={error.message} />;
  * return <Chart data={data} />;
  * ```
+ *
+ * @example With SQL query
+ * ```tsx
+ * const { data } = useDatasetContents(
+ *   'my-database',
+ *   invocationId,
+ *   'SELECT * FROM users ORDER BY created_at DESC LIMIT 10'
+ * );
+ * ```
+ *
+ * @example With resource key (for Excel files with headers not on row 1)
+ * ```tsx
+ * const { data } = useDatasetContents(
+ *   'my-excel-dataset',
+ *   invocationId,
+ *   undefined,
+ *   'abc123::Sheet1::table_1'
+ * );
+ * ```
  */
-declare function useDatasetContents(datasetSlug: string, invocationId: string): UseDatasetContentsResult;
+declare function useDatasetContents(datasetSlug: string, invocationId: string, sqlQuery?: string, resourceKey?: string): UseDatasetContentsResult;
 /**
  * Hook to fetch contents of multiple datasets in parallel.
  * Uses the DataFetcher from ErdoProvider if available, otherwise falls back to REST API.
  *
  * @param datasetSlugs - Array of dataset slugs/identifiers
  * @param invocationId - The invocation ID context
+ * @param sqlQueries - Optional map of dataset slug to SQL query
  * @returns Array of result objects, one per dataset
  *
  * @example
@@ -1380,8 +1459,27 @@ declare function useDatasetContents(datasetSlug: string, invocationId: string):
  * const isLoading = results.some(r => r.isLoading);
  * const allData = results.map(r => r.data || []);
  * ```
+ *
+ * @example With SQL queries
+ * ```tsx
+ * const results = useMultipleDatasetContents(
+ *   ['my-db', 'other-db'],
+ *   invocationId,
+ *   { 'my-db': 'SELECT * FROM users LIMIT 10' }
+ * );
+ * ```
+ *
+ * @example With resource keys
+ * ```tsx
+ * const results = useMultipleDatasetContents(
+ *   ['dataset-1', 'dataset-2'],
+ *   invocationId,
+ *   undefined,
+ *   { 'dataset-1': 'abc123::Sheet1::table_1' }
+ * );
+ * ```
  */
-declare function useMultipleDatasetContents(datasetSlugs: string[], invocationId: string): UseDatasetContentsResult[];
+declare function useMultipleDatasetContents(datasetSlugs: string[], invocationId: string, sqlQueries?: Record<string, string>, resourceKeys?: Record<string, string>): UseDatasetContentsResult[];
 
 interface UseThreadOptions {
     /** Initial thread ID to use (if resuming an existing thread) */
@@ -1626,4 +1724,4 @@ declare function handleIncrementalMixedJsonParsing(outputContent: MessageContent
  */
 declare function handleSSEEvent(eventType: string, event: SSEEventData, path: string[], threadID: string, activeMessagesByID: Record<string, MessageWithContents>, currentEntity?: Entity | null, parents?: Entity[], entityIds?: Record<string, string>): Entity | null;
 
-export { BarChart, type BaseChartProps, type BotInvocation, BotInvocationContent, type BotInvocationContentData, type BotInvocationContentProps, type BotInvocationData, type BotInvocationEventInfo, type BotInvocationStatusInfo, Chart, type ChartConfig, ChartContainer, ChartContent, type ChartContentProps, ChartLegend, ChartLegendContent, ChartNode, type ChartNodeContent, ChartStyle, ChartTooltip, ChartTooltipContent, CodeexecContent, type CodeexecContentProps, CodegenContent, type CodegenContentProps, CollapsibleCodeBlock, type CollapsibleCodeBlockProps, Content, type ContentChartConfig, type ContentChunk, type ContentComponentProps, type ContentProps, type ContentType, type DataFetcher, DatasetChart, type DatasetChartProps, type DatasetDetails, DatasetDownload, type DatasetDownloadProps, DatasetTable, type DatasetTableProps, DownloadButtonNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, HeatmapChart, InvocationEvent, type InvocationEventProps, InvocationEvents, type InvocationEventsProps, InvocationStatus, JSONStreamParser, type JSONValue, JsonContent, type JsonContentProps, LineChart, Loader, Log, LogContent, type LogContentProps, type LogProps, MarkdownContent, type MarkdownContentProps, type Message, type MessageContent, type MessageStreamingState, type MessageWithContents, type NodeRendererProps, type NullString, Output, type OutputContent, type OutputProps, type OutputWithContents, PieChart, type ResolvedBotInvocation, type ResultHandler, type SSEEventData, ScatterChart, type SpinnerStatus, SqlContent, type SqlContentProps, type Status, type StatusEvent, StatusSpinner, type StatusSpinnerProps, StderrText, StdoutText, StdwarnText, type Step, StepInvocation, type StepInvocationProps, StepInvocationStatus, type StepInvocationStatusProps, SuggestionsNode, type SuggestionsNodeContent, TableContent, type TableContentProps, TableNode, type TableNodeContent, TextContent, type TextContentProps, TextMarkdownNode, type TextMarkdownNodeContent, ThinkingContent, type ThinkingContentProps, ToolGroupContent, type ToolGroupContentProps, UIGenerationNodes, type UIGenerationNodesProps, type UINode, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, cn, extractContentItems, formatValue, handleIncrementalMixedJsonParsing, handleSSEEvent, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, nodeComponents, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, toSnakeCase, unwrapNullString, unwrapNullStringOr, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useMultipleDatasetContents, useThread };
+export { BarChart, type BaseChartProps, type BotInvocation, BotInvocationContent, type BotInvocationContentData, type BotInvocationContentProps, type BotInvocationData, type BotInvocationEventInfo, type BotInvocationStatusInfo, Chart, type ChartConfig, ChartContainer, ChartContent, type ChartContentProps, ChartLegend, ChartLegendContent, ChartNode, type ChartNodeContent, ChartStyle, ChartTooltip, ChartTooltipContent, CodeexecContent, type CodeexecContentProps, CodegenContent, type CodegenContentProps, CollapsibleCodeBlock, type CollapsibleCodeBlockProps, Content, type ContentChartConfig, type ContentChunk, type ContentComponentProps, type ContentProps, type ContentType, type DataFetcher, DatasetChart, type DatasetChartProps, type DatasetDetails, DatasetDownload, type DatasetDownloadProps, DatasetTable, type DatasetTableProps, DownloadButtonNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, HeatmapChart, InvocationEvent, type InvocationEventProps, InvocationEvents, type InvocationEventsProps, InvocationStatus, JSONStreamParser, type JSONValue, JsonContent, type JsonContentProps, LineChart, Loader, Log, LogContent, type LogContentProps, type LogProps, MarkdownContent, type MarkdownContentProps, type Memory, MemoryContent, type MemoryContentProps, type Message, type MessageContent, type MessageStreamingState, type MessageWithContents, type NodeRendererProps, type NullString, Output, type OutputContent, type OutputProps, type OutputWithContents, PieChart, type ResolvedBotInvocation, type ResultHandler, type SSEEventData, ScatterChart, type SpinnerStatus, SqlContent, type SqlContentProps, type Status, type StatusEvent, StatusSpinner, type StatusSpinnerProps, StderrText, StdoutText, StdwarnText, type Step, StepInvocation, type StepInvocationProps, StepInvocationStatus, type StepInvocationStatusProps, SuggestionsNode, type SuggestionsNodeContent, TableContent, type TableContentProps, TableNode, type TableNodeContent, TextContent, type TextContentProps, TextMarkdownNode, type TextMarkdownNodeContent, ThinkingContent, type ThinkingContentProps, ToolGroupContent, type ToolGroupContentProps, UIGenerationNodes, type UIGenerationNodesProps, type UINode, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, cn, extractContentItems, formatValue, handleIncrementalMixedJsonParsing, handleSSEEvent, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, nodeComponents, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, toSnakeCase, unwrapNullString, unwrapNullStringOr, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useMultipleDatasetContents, useThread };