@erdoai/ui 0.1.105 → 0.1.107

package/dist/index.d.cts

@@ -182,6 +182,48 @@ declare function useErdoConfig(): ErdoProviderConfig;
  */
 declare function useErdoConfigOptional(): ErdoProviderConfig | null;
 
+interface DatasetMetricProps {
+    /** Metric label (e.g. "Total Revenue") */
+    label: string;
+    /** Dataset slug to query */
+    datasetSlug: string;
+    /** Invocation/thread ID for data fetching context */
+    invocationId: string;
+    /** SQL query that returns a single row with the metric value.
+     * e.g. "SELECT SUM(revenue) as total FROM data" */
+    sqlQuery: string;
+    /** Column key to read the value from (must match a column in the query result) */
+    valueKey: string;
+    /** Optional resource key for Excel files */
+    resourceKey?: string;
+    /** d3-format string for value display (e.g. ",.0f" for thousands, ".1%" for percent) */
+    format?: string;
+    /** Optional prefix (e.g. "$") */
+    prefix?: string;
+    /** Optional suffix (e.g. "%", " users") */
+    suffix?: string;
+    /** Optional subtitle/description shown below the value */
+    description?: string;
+    /** Class for the outer container */
+    className?: string;
+}
+/**
+ * A single KPI/metric card that fetches one value from a dataset.
+ * Handles loading, error, and empty states automatically.
+ *
+ * @example
+ * <DatasetMetric
+ *   label="Total Revenue"
+ *   datasetSlug="org.sales-data"
+ *   invocationId="iframe"
+ *   sqlQuery="SELECT SUM(CAST(revenue AS DOUBLE)) as total FROM data"
+ *   valueKey="total"
+ *   prefix="$"
+ *   format=",.0f"
+ * />
+ */
+declare function DatasetMetric({ label, datasetSlug, invocationId, sqlQuery, valueKey, resourceKey, format, prefix, suffix, description, className, }: DatasetMetricProps): react_jsx_runtime.JSX.Element;
+
 declare const THEMES: {
     readonly light: "";
     readonly dark: ".dark";
@@ -1606,15 +1648,13 @@ interface AgentStreamStore {
     pendingInvocationQueue: string[];
     /**
      * Push a raw SSE event into the store.
-     * Calls handleAgentEvent internally and re-slices affected invocations.
+     * Handles invocation registration (from agent_invocation content) and root
+     * mapping (from agent step_started) automatically, so callers don't need
+     * separate registerInvocation/mapInvocationRoot calls.
      * @param event The raw SSE event
      * @param reconcile Optional post-processing (e.g., reconcileThinkingContentState)
      */
     pushEvent: (event: SSEEvent, reconcile?: (state: AgentStreamState) => AgentStreamState) => void;
-    /** Register an invocation_id (from agent_invocation event). Queues it for root mapping. */
-    registerInvocation: (invocationId: string) => void;
-    /** Map an invocation_id to its root step_id (from step_started with type: 'agent'). */
-    mapInvocationRoot: (invocationId: string, rootStepId: string) => void;
     /** Reset the store (new session). */
     reset: () => void;
 }
@@ -2057,4 +2097,4 @@ declare function useInvocationState(invocationId: string | undefined): AgentStre
  */
 declare function useAgentStreamGlobalState(): AgentStreamState;
 
-export { type AgentStreamStore, AgentStreamStoreProvider, type AgentStreamStoreProviderProps, 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, type DatasetFetchRequest, type DatasetFilter, DatasetTable, type DatasetTableProps, DownloadButtonNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, type ErdoToolRenderType, ErdoToolResult, type ErdoToolResultProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, FileDownloadsNode, type FileDownloadsNodeContent, type GeneratedFile, 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 RawApiContent, 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, StepTreeContent, type StepTreeContentProps, 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 UseDatasetContentsResult, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, agentStateToContents, cn, completeStreamingContent, createAgentStreamStore, createInitialAgentState, extractContentItems, formatValue, getErdoToolName, getErdoToolRenderType, handleAgentEvent, handleIncrementalMixedJsonParsing, handleSSEEvent, hasRenderableAssistantOutput, isErdoTool, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, nodeComponents, normalizeContent, normalizeContents, normalizeUIGenerationChunks, normalizeUINodes, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, sliceAgentStateToRoot, toSnakeCase, unwrapNullString, unwrapNullStringOr, useAgentStreamGlobalState, useAgentStreamStoreOptional, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useInvocationState, useMultipleDatasetContents, useMultipleDatasetRequests, useThread };
+export { type AgentStreamStore, AgentStreamStoreProvider, type AgentStreamStoreProviderProps, 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, type DatasetFetchRequest, type DatasetFilter, DatasetMetric, type DatasetMetricProps, DatasetTable, type DatasetTableProps, DownloadButtonNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, type ErdoToolRenderType, ErdoToolResult, type ErdoToolResultProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, FileDownloadsNode, type FileDownloadsNodeContent, type GeneratedFile, 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 RawApiContent, 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, StepTreeContent, type StepTreeContentProps, 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 UseDatasetContentsResult, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, agentStateToContents, cn, completeStreamingContent, createAgentStreamStore, createInitialAgentState, extractContentItems, formatValue, getErdoToolName, getErdoToolRenderType, handleAgentEvent, handleIncrementalMixedJsonParsing, handleSSEEvent, hasRenderableAssistantOutput, isErdoTool, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, nodeComponents, normalizeContent, normalizeContents, normalizeUIGenerationChunks, normalizeUINodes, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, sliceAgentStateToRoot, toSnakeCase, unwrapNullString, unwrapNullStringOr, useAgentStreamGlobalState, useAgentStreamStoreOptional, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useInvocationState, useMultipleDatasetContents, useMultipleDatasetRequests, useThread };

package/dist/index.d.ts

@@ -182,6 +182,48 @@ declare function useErdoConfig(): ErdoProviderConfig;
  */
 declare function useErdoConfigOptional(): ErdoProviderConfig | null;
 
+interface DatasetMetricProps {
+    /** Metric label (e.g. "Total Revenue") */
+    label: string;
+    /** Dataset slug to query */
+    datasetSlug: string;
+    /** Invocation/thread ID for data fetching context */
+    invocationId: string;
+    /** SQL query that returns a single row with the metric value.
+     * e.g. "SELECT SUM(revenue) as total FROM data" */
+    sqlQuery: string;
+    /** Column key to read the value from (must match a column in the query result) */
+    valueKey: string;
+    /** Optional resource key for Excel files */
+    resourceKey?: string;
+    /** d3-format string for value display (e.g. ",.0f" for thousands, ".1%" for percent) */
+    format?: string;
+    /** Optional prefix (e.g. "$") */
+    prefix?: string;
+    /** Optional suffix (e.g. "%", " users") */
+    suffix?: string;
+    /** Optional subtitle/description shown below the value */
+    description?: string;
+    /** Class for the outer container */
+    className?: string;
+}
+/**
+ * A single KPI/metric card that fetches one value from a dataset.
+ * Handles loading, error, and empty states automatically.
+ *
+ * @example
+ * <DatasetMetric
+ *   label="Total Revenue"
+ *   datasetSlug="org.sales-data"
+ *   invocationId="iframe"
+ *   sqlQuery="SELECT SUM(CAST(revenue AS DOUBLE)) as total FROM data"
+ *   valueKey="total"
+ *   prefix="$"
+ *   format=",.0f"
+ * />
+ */
+declare function DatasetMetric({ label, datasetSlug, invocationId, sqlQuery, valueKey, resourceKey, format, prefix, suffix, description, className, }: DatasetMetricProps): react_jsx_runtime.JSX.Element;
+
 declare const THEMES: {
     readonly light: "";
     readonly dark: ".dark";
@@ -1606,15 +1648,13 @@ interface AgentStreamStore {
     pendingInvocationQueue: string[];
     /**
      * Push a raw SSE event into the store.
-     * Calls handleAgentEvent internally and re-slices affected invocations.
+     * Handles invocation registration (from agent_invocation content) and root
+     * mapping (from agent step_started) automatically, so callers don't need
+     * separate registerInvocation/mapInvocationRoot calls.
      * @param event The raw SSE event
      * @param reconcile Optional post-processing (e.g., reconcileThinkingContentState)
      */
     pushEvent: (event: SSEEvent, reconcile?: (state: AgentStreamState) => AgentStreamState) => void;
-    /** Register an invocation_id (from agent_invocation event). Queues it for root mapping. */
-    registerInvocation: (invocationId: string) => void;
-    /** Map an invocation_id to its root step_id (from step_started with type: 'agent'). */
-    mapInvocationRoot: (invocationId: string, rootStepId: string) => void;
     /** Reset the store (new session). */
     reset: () => void;
 }
@@ -2057,4 +2097,4 @@ declare function useInvocationState(invocationId: string | undefined): AgentStre
  */
 declare function useAgentStreamGlobalState(): AgentStreamState;
 
-export { type AgentStreamStore, AgentStreamStoreProvider, type AgentStreamStoreProviderProps, 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, type DatasetFetchRequest, type DatasetFilter, DatasetTable, type DatasetTableProps, DownloadButtonNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, type ErdoToolRenderType, ErdoToolResult, type ErdoToolResultProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, FileDownloadsNode, type FileDownloadsNodeContent, type GeneratedFile, 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 RawApiContent, 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, StepTreeContent, type StepTreeContentProps, 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 UseDatasetContentsResult, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, agentStateToContents, cn, completeStreamingContent, createAgentStreamStore, createInitialAgentState, extractContentItems, formatValue, getErdoToolName, getErdoToolRenderType, handleAgentEvent, handleIncrementalMixedJsonParsing, handleSSEEvent, hasRenderableAssistantOutput, isErdoTool, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, nodeComponents, normalizeContent, normalizeContents, normalizeUIGenerationChunks, normalizeUINodes, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, sliceAgentStateToRoot, toSnakeCase, unwrapNullString, unwrapNullStringOr, useAgentStreamGlobalState, useAgentStreamStoreOptional, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useInvocationState, useMultipleDatasetContents, useMultipleDatasetRequests, useThread };
+export { type AgentStreamStore, AgentStreamStoreProvider, type AgentStreamStoreProviderProps, 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, type DatasetFetchRequest, type DatasetFilter, DatasetMetric, type DatasetMetricProps, DatasetTable, type DatasetTableProps, DownloadButtonNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, type ErdoToolRenderType, ErdoToolResult, type ErdoToolResultProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, FileDownloadsNode, type FileDownloadsNodeContent, type GeneratedFile, 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 RawApiContent, 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, StepTreeContent, type StepTreeContentProps, 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 UseDatasetContentsResult, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, agentStateToContents, cn, completeStreamingContent, createAgentStreamStore, createInitialAgentState, extractContentItems, formatValue, getErdoToolName, getErdoToolRenderType, handleAgentEvent, handleIncrementalMixedJsonParsing, handleSSEEvent, hasRenderableAssistantOutput, isErdoTool, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, nodeComponents, normalizeContent, normalizeContents, normalizeUIGenerationChunks, normalizeUINodes, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, sliceAgentStateToRoot, toSnakeCase, unwrapNullString, unwrapNullStringOr, useAgentStreamGlobalState, useAgentStreamStoreOptional, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useInvocationState, useMultipleDatasetContents, useMultipleDatasetRequests, useThread };