@sisense/sdk-ai-core 0.13.0 → 0.15.1

package/dist/constants.d.ts

@@ -29,4 +29,3 @@ export declare const HEADER_INTERFACE_NAME = "x-interface-name";
 export declare const HEADER_FEATURE_NAME = "x-feature-name";
 export declare const HEADER_QUOTA_ID = "x-quota-id";
 export declare const ALLOWED_HEADERS: string[];
-//# sourceMappingURL=constants.d.ts.map

package/dist/engines/build-chart/build-chart-engine.d.ts

@@ -1,14 +1,3 @@
-import { ChartSummary, BuildChartContext, buildChartSchema, ChartContextPromptEntry } from './types';
+import { ChartSummary, BuildChartContext, buildChartSchema } from './types';
 import { default as z } from 'zod/v4';
-/**
- * Build contextual system prompt for build chart
- */
-export declare function buildContextualSystemPrompt(chartsForContext: ChartContextPromptEntry[], priorChartId?: string, outerQueryId?: string): string;
-/**
- * Standalone build chart engine - completely decoupled from any UI or store
- * @param params - The parameters for the build chart
- * @param context - All external dependencies injected
- * @returns The chart summary
- */
 export declare function buildChartEngine(params: z.infer<typeof buildChartSchema>, context: BuildChartContext): Promise<ChartSummary>;
-//# sourceMappingURL=build-chart-engine.d.ts.map

package/dist/engines/build-chart/build-chart-service.d.ts

@@ -4,4 +4,3 @@ import { ExtendedChartWidgetProps, BaseChartSummary } from './types';
  * Returns `undefined` when `chartState` has not yet been computed (e.g. unsupported chart type).
  */
 export declare const getBaseChartSummary: (widgetProps: ExtendedChartWidgetProps) => BaseChartSummary | undefined;
-//# sourceMappingURL=build-chart-service.d.ts.map

package/dist/engines/build-chart/create-chart/assemble-chart-widget.d.ts

@@ -10,17 +10,21 @@ export type AssembleChartWidgetParams = {
     columnsJSON: ColumnJSON[];
     title?: string;
     chartTitle: string;
+    /** When rebinding, preserve the prior widget entity id. */
+    widgetId?: string;
+    artifactId?: string;
 };
-export declare const assembleChartWidget: ({ nlqResult, chartType, axesMapping, columnsJSON, title, chartTitle, }: AssembleChartWidgetParams) => ExtendedChartWidgetProps;
+export declare const assembleChartWidget: ({ nlqResult, chartType, axesMapping, columnsJSON, title, chartTitle, widgetId, artifactId, }: AssembleChartWidgetParams) => ExtendedChartWidgetProps;
 /**
  * Assemble a chart widget reusing already-resolved DataOptionsJSON (skips generateChartRecommendations).
  * Returns null when translateChartFromJSON fails, allowing the caller to fall back gracefully.
  */
-export declare const assembleChartWidgetFromDataOptions: ({ nlqResult, chartType, dataOptions, title, chartTitle, }: {
+export declare const assembleChartWidgetFromDataOptions: ({ nlqResult, chartType, dataOptions, title, chartTitle, widgetId, artifactId, }: {
     nlqResult: QueryExecutionResult;
     chartType: string;
     dataOptions: DataOptionsJSON;
     title?: string;
     chartTitle: string;
+    widgetId?: string;
+    artifactId?: string;
 }) => ExtendedChartWidgetProps | null;
-//# sourceMappingURL=assemble-chart-widget.d.ts.map

package/dist/engines/build-chart/create-chart/chart-json-axes-mapping.d.ts

@@ -24,4 +24,3 @@ export declare function mapAxesToDataOptions<T extends {
  * and the already-mapped data options.
  */
 export declare function assembleChartJSON(queryState: QueryState, chartType: string, dataOptions: DataOptionsJSON): ChartJSON;
-//# sourceMappingURL=chart-json-axes-mapping.d.ts.map

package/dist/engines/build-chart/create-chart/create-chart.d.ts

@@ -5,4 +5,3 @@ export declare const createChart: ({ queryPrompt, chartPrompt, chartType, chartT
     chartState: import('../../..').ChartState;
     dataset: import('../../..').Dataset | undefined;
 }>;
-//# sourceMappingURL=create-chart.d.ts.map

package/dist/engines/build-chart/create-chart/generate-chart-recommendations.d.ts

@@ -7,4 +7,3 @@ import { LanguageModel } from 'ai';
  * Column array order defines axis indices; `id` is assigned from position.
  */
 export declare const generateChartRecommendations: (userPrompt: string, columns: ColumnSummary[] | undefined, chartType: ChartType | undefined, llmClient?: LanguageModel) => Promise<z.infer<typeof chartRecommendationsSchema>>;
-//# sourceMappingURL=generate-chart-recommendations.d.ts.map

package/dist/engines/build-chart/create-chart/generate-chart.d.ts

@@ -15,4 +15,3 @@ export type GenerateChartOutput = {
     widgetProps: ExtendedChartWidgetProps;
 };
 export declare const generateChart: ({ dataSourceTitle, queryPrompt, chartPrompt, chartType, chartTitle, queryId, priorQueryState, }: GenerateChartParams, context: BuildChartContext) => Promise<GenerateChartOutput>;
-//# sourceMappingURL=generate-chart.d.ts.map

package/dist/engines/build-chart/create-chart/get-columns-json.d.ts

@@ -12,4 +12,3 @@ export declare function normalizeToStyledColumn(item: unknown): ColumnJSON | nul
 export declare function getColumnsJSON(queryState: QueryState): ColumnJSON[];
 export declare function toColumnSummaries(columnsJSON: ColumnJSON[]): ColumnSummary[];
 export declare function columnSummariesFromQueryState(queryState: QueryState): ColumnSummary[];
-//# sourceMappingURL=get-columns-json.d.ts.map

package/dist/engines/build-chart/create-chart/rebind-chart-to-query.d.ts

@@ -0,0 +1,10 @@
+import { BuildChartContext } from '../types';
+export type RebindChartToQueryParams = {
+    priorChartId: string;
+    queryId: string;
+};
+export declare const rebindChartToQuery: ({ priorChartId, queryId }: RebindChartToQueryParams, context: BuildChartContext) => Promise<{
+    message: string;
+    chartState: import('../../..').ChartState | undefined;
+    dataset: import('../../..').Dataset | undefined;
+}>;

package/dist/engines/build-chart/create-chart/resolve-chart-query.d.ts

@@ -8,4 +8,3 @@ export type ResolveChartQueryParams = {
     priorQueryState?: QueryState;
 };
 export declare const resolveChartQuery: ({ dataSourceTitle, queryPrompt, queryId, priorQueryState, }: ResolveChartQueryParams, context: BuildChartContext) => Promise<QueryResult>;
-//# sourceMappingURL=resolve-chart-query.d.ts.map

package/dist/engines/build-chart/dataset-from-saved-chart-widget.d.ts

@@ -8,4 +8,3 @@ import { ExtendedChartWidgetProps } from './types';
  */
 export declare function datasetFromSavedChartWidget(naturalResponseEnabled: boolean | undefined, props: ExtendedChartWidgetProps | null): Dataset | undefined;
 export declare function queryStateFromSavedChartWidget(props: ExtendedChartWidgetProps | null): QueryState | undefined;
-//# sourceMappingURL=dataset-from-saved-chart-widget.d.ts.map

package/dist/engines/build-chart/shared/chart-column-utils.d.ts

@@ -0,0 +1,6 @@
+import { ColumnJSON } from '../types';
+/**
+ * Returns true when the column set (dimensions + measures) is identical between
+ * new and prior queryState — the only change is in filters/highlights.
+ */
+export declare function isFilterOnlyChange(newCols: ColumnJSON[], priorCols: ColumnJSON[]): boolean;

package/dist/engines/build-chart/shared/csdk-data-options-for-llm.d.ts

@@ -11,4 +11,3 @@ export declare function flattenDataOptions(dataOptions: ChartWidgetProps['dataOp
     pool: ColumnJSON[];
     summaries: ColumnSummary[];
 };
-//# sourceMappingURL=csdk-data-options-for-llm.d.ts.map

package/dist/engines/build-chart/shared/finalize-chart-widget-save.d.ts

@@ -0,0 +1,7 @@
+import { ExtendedChartWidgetProps } from '../types';
+/**
+ * Serializes chartState for tool output while preserving live widget props.
+ * translateChartToJSON can mutate dataOptions in place and drop presentation
+ * flags such as showOnRightAxis — especially after y2Axis is enabled.
+ */
+export declare function finalizeChartWidgetSave(chartWidgetProps: ExtendedChartWidgetProps): void;

package/dist/engines/build-chart/shared/normalize-cartesian-axes-mapping.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod/v4';
+import { axesMappingSchema, ColumnJSON } from '../types';
+/**
+ * For cartesian charts, moves measure column indices mistakenly placed in breakBy
+ * into value so translateChartFromJSON accepts the mapping.
+ */
+export declare function normalizeCartesianAxesMapping(axesMapping: z.infer<typeof axesMappingSchema>, columnsJSON: ColumnJSON[]): z.infer<typeof axesMappingSchema>;

package/dist/engines/build-chart/shared/sync-chart-state-measure-flags.d.ts

@@ -0,0 +1,21 @@
+import { ChartDataOptions, StyledMeasureColumn } from '@sisense/sdk-ui';
+import { BaseChartSummary } from '../types';
+export type MeasurePresentationFlags = {
+    showOnRightAxis?: boolean;
+    color?: StyledMeasureColumn['color'];
+};
+/**
+ * Snapshots per-measure presentation flags before translateChartToJSON, which
+ * can mutate dataOptions in place and strip showOnRightAxis.
+ */
+export declare function snapshotCartesianMeasureFlags(dataOptions: ChartDataOptions | undefined): Map<string, MeasurePresentationFlags>;
+/**
+ * Re-applies presentation flags onto live dataOptions after translateChartToJSON
+ * without replacing CSDK class instances (required for CustomSuperJSON).
+ */
+export declare function restoreCartesianMeasureFlags(dataOptions: ChartDataOptions | undefined, flags: Map<string, MeasurePresentationFlags>): void;
+/**
+ * Copies per-measure presentation flags from live dataOptions onto chartState
+ * after translateChartToJSON, which can drop showOnRightAxis from the summary.
+ */
+export declare function syncChartStateMeasureFlagsFromDataOptions(chartState: BaseChartSummary, dataOptions: ChartDataOptions | undefined): BaseChartSummary;

package/dist/engines/build-chart/types.d.ts

@@ -261,12 +261,155 @@ export declare const chartRecommendationsSchema: z.ZodObject<{
  * Canonical tool description for buildChart — reusable by any host (sdk-assistant, MCP server, custom integrations).
  * Hosts may append host-specific notes but should not duplicate or contradict this text.
  */
-export declare const buildChartToolDescription = "Creates or revises a chart from a natural language prompt.\n\nRevising a chart includes updating the chart's data structure (data options), sorting, trend and forecast, style options, and filters. \n\nThree ways to scope the run:\n\n1. **New chart from scratch:** omit both `priorChartId` and `queryId` and describe the desired chart in `userPrompt`.\n2. **Revise an existing chart:** pass `priorChartId` (the chartId from a prior buildChart result, or the widget id when inside a dashboard). The chart's existing data context and style are preserved across revisions.\n3. **Verbatim prior query:** pass `queryId` (an id from a prior data query result) to chart to reuse that query result if needed to not waste the prior query work.\n\nWhen revising an existing chart, do not run other tools (e.g. query tool) and do not pass `queryId`.\n\nPass the user prompt exactly as received \u2014 do not transform or modify it.";
+export declare const buildChartToolDescription = "Creates or revises a chart via a required structured `action` param. For new data, call buildQuery first. Load the buildChart skill via loadSkill before calling this tool \u2014 the skill documents all action types and when to use each. Hosts may append UI notes (e.g. showCanvas).";
+/** JSON-Schema-safe union; run {@link parseActionWithGuards} at execution time. */
+export declare const buildChartActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"create">;
+    queryId: z.ZodString;
+    chartType: z.ZodEnum<{
+        area: "area";
+        table: "table";
+        indicator: "indicator";
+        column: "column";
+        line: "line";
+        pie: "pie";
+        bar: "bar";
+        polar: "polar";
+        funnel: "funnel";
+        treemap: "treemap";
+        sunburst: "sunburst";
+        scatter: "scatter";
+        areamap: "areamap";
+        boxplot: "boxplot";
+        scattermap: "scattermap";
+        arearange: "arearange";
+    }>;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"update-title">;
+    priorChartId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"update-type">;
+    priorChartId: z.ZodString;
+    chartType: z.ZodEnum<{
+        area: "area";
+        table: "table";
+        indicator: "indicator";
+        column: "column";
+        line: "line";
+        pie: "pie";
+        bar: "bar";
+        polar: "polar";
+        funnel: "funnel";
+        treemap: "treemap";
+        sunburst: "sunburst";
+        scatter: "scatter";
+        areamap: "areamap";
+        boxplot: "boxplot";
+        scattermap: "scattermap";
+        arearange: "arearange";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"rebind-query">;
+    priorChartId: z.ZodString;
+    queryId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"update-sorting">;
+    priorChartId: z.ZodString;
+    userPrompt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"update-trend-forecast">;
+    priorChartId: z.ZodString;
+    userPrompt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"update-style">;
+    priorChartId: z.ZodString;
+    userPrompt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"update-data-options">;
+    priorChartId: z.ZodString;
+    userPrompt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"update-measure-chart-types">;
+    priorChartId: z.ZodString;
+    userPrompt: z.ZodString;
+}, z.core.$strip>]>;
+export type BuildChartAction = z.infer<typeof buildChartActionSchema>;
 export declare const buildChartSchema: z.ZodObject<{
     dataSourceTitle: z.ZodString;
-    userPrompt: z.ZodString;
-    priorChartId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    queryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"create">;
+        queryId: z.ZodString;
+        chartType: z.ZodEnum<{
+            area: "area";
+            table: "table";
+            indicator: "indicator";
+            column: "column";
+            line: "line";
+            pie: "pie";
+            bar: "bar";
+            polar: "polar";
+            funnel: "funnel";
+            treemap: "treemap";
+            sunburst: "sunburst";
+            scatter: "scatter";
+            areamap: "areamap";
+            boxplot: "boxplot";
+            scattermap: "scattermap";
+            arearange: "arearange";
+        }>;
+        title: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"update-title">;
+        priorChartId: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"update-type">;
+        priorChartId: z.ZodString;
+        chartType: z.ZodEnum<{
+            area: "area";
+            table: "table";
+            indicator: "indicator";
+            column: "column";
+            line: "line";
+            pie: "pie";
+            bar: "bar";
+            polar: "polar";
+            funnel: "funnel";
+            treemap: "treemap";
+            sunburst: "sunburst";
+            scatter: "scatter";
+            areamap: "areamap";
+            boxplot: "boxplot";
+            scattermap: "scattermap";
+            arearange: "arearange";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"rebind-query">;
+        priorChartId: z.ZodString;
+        queryId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"update-sorting">;
+        priorChartId: z.ZodString;
+        userPrompt: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"update-trend-forecast">;
+        priorChartId: z.ZodString;
+        userPrompt: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"update-style">;
+        priorChartId: z.ZodString;
+        userPrompt: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"update-data-options">;
+        priorChartId: z.ZodString;
+        userPrompt: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"update-measure-chart-types">;
+        priorChartId: z.ZodString;
+        userPrompt: z.ZodString;
+    }, z.core.$strip>]>;
 }, z.core.$strip>;
 export declare const createChartSchema: z.ZodObject<{
     queryPrompt: z.ZodString;
@@ -397,4 +540,3 @@ export interface BuildChartContext {
     /** ID of a prior query result when this chart uses that query; otherwise null/undefined */
     queryId?: string | null;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/engines/build-chart/update-chart/apply-prior-chart-style.d.ts

@@ -7,4 +7,3 @@ import { ExtendedChartWidgetProps } from '../types';
  * names that may no longer exist after structural changes (add/remove/swap dimensions).
  */
 export declare function applyPriorChartStyle(widgetProps: ExtendedChartWidgetProps, priorChart: ExtendedChartWidgetProps): void;
-//# sourceMappingURL=apply-prior-chart-style.d.ts.map

package/dist/engines/build-chart/update-chart/chart-options-schemas.d.ts

@@ -2891,4 +2891,3 @@ export declare const tableDataOptionsEditingSchemas: z.ZodObject<{
 export declare const getChartDataOptionsEditingSchemas: (chartType: ChartType) => z.ZodObject<{}, z.core.$strip>;
 export declare const chartDataOptionsSchemas: Partial<Record<ChartType, z.ZodObject<any>>>;
 export {};
-//# sourceMappingURL=chart-options-schemas.d.ts.map

package/dist/engines/build-chart/update-chart/schemas.d.ts

@@ -224,4 +224,3 @@ export declare const LineStyleOptionsSchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type LineStyleOptions = z.infer<typeof LineStyleOptionsSchema>;
-//# sourceMappingURL=schemas.d.ts.map

package/dist/engines/build-chart/update-chart/update-chart-data-options.d.ts

@@ -37,4 +37,3 @@ export declare const updateOtherChartDataOptions: ({ chartId, userPrompt }: z.in
     message: string;
 }>;
 export {};
-//# sourceMappingURL=update-chart-data-options.d.ts.map

package/dist/engines/build-chart/update-chart/update-chart-query.d.ts

@@ -5,4 +5,3 @@ export declare const updateChartQuery: ({ revisionPrompt, chartId }: z.infer<typ
     chartState: import('../../..').ChartState | undefined;
     dataset: import('../../..').Dataset | undefined;
 }>;
-//# sourceMappingURL=update-chart-query.d.ts.map

package/dist/engines/build-chart/update-chart/update-chart-style-options.d.ts

@@ -15,4 +15,3 @@ export declare const updateChartStyleOptions: ({ chartId, userPrompt }: z.infer<
     message: string;
 }>;
 export {};
-//# sourceMappingURL=update-chart-style-options.d.ts.map

package/dist/engines/build-chart/update-chart/update-chart-title.d.ts

@@ -9,4 +9,3 @@ export declare const updateChartTitle: ({ chartId, chartTitle }: z.infer<typeof
     message: string;
 }>;
 export {};
-//# sourceMappingURL=update-chart-title.d.ts.map

package/dist/engines/build-chart/update-chart/update-chart-type.d.ts

@@ -11,4 +11,3 @@ export declare const updateChartType: ({ chartId, userPrompt, chartType }: z.inf
     message: string;
 }>;
 export {};
-//# sourceMappingURL=update-chart-type.d.ts.map

package/dist/engines/build-csv-model/build-csv-model-engine.d.ts

@@ -10,4 +10,3 @@ export interface BuildCsvModelProgressSnapshot {
     relations?: BuiltRelation[];
 }
 export declare function buildCsvModelEngine(params: z.infer<typeof buildCsvModelParamsSchema>, context: CsvModelEngineContext, onProgress?: (phase: string, detail?: string, snapshot?: BuildCsvModelProgressSnapshot) => void): Promise<BuildCsvModelResult>;
-//# sourceMappingURL=build-csv-model-engine.d.ts.map

package/dist/engines/build-csv-model/index.d.ts

@@ -4,4 +4,3 @@ export { buildCsvModelEngine } from './build-csv-model-engine';
 export type { BuildCsvModelProgressSnapshot } from './build-csv-model-engine';
 export { inferRelations } from './infer-relations';
 export { triggerFullBuild, pollBuild } from './rest-build';
-//# sourceMappingURL=index.d.ts.map

package/dist/engines/build-csv-model/infer-relations.d.ts

@@ -11,4 +11,3 @@ export interface InferredRelation {
     targetColumn: string;
 }
 export declare function inferRelations(tables: InferTableInput[]): InferredRelation[];
-//# sourceMappingURL=infer-relations.d.ts.map

package/dist/engines/build-csv-model/rest-build.d.ts

@@ -2,6 +2,25 @@ import { HttpClient } from '@sisense/sdk-rest-client';
 export declare function triggerFullBuild(datamodelOid: string, httpClient?: HttpClient): Promise<{
     buildOid: string;
 }>;
+export interface WaitForSchemaResult {
+    ready: boolean;
+    tablesFound: number;
+    relationsFound: number;
+}
+/**
+ * Block until the model's schema reflects all expected tables and relations (or
+ * the timeout elapses). Returns `ready: false` on timeout so the caller can
+ * still attempt the build rather than hang forever.
+ */
+export declare function waitForSchemaPersisted(datamodelOid: string, expected: {
+    tableOids: string[];
+    relationOids: string[];
+}, options?: {
+    intervalMs?: number;
+    timeoutMs?: number;
+    httpClient?: HttpClient;
+    onUpdate?: (detail: string) => void;
+}): Promise<WaitForSchemaResult>;
 export interface PollBuildResult {
     status: 'done' | 'failed' | 'timeout';
     durationMs: number;
@@ -9,7 +28,13 @@ export interface PollBuildResult {
 export declare function pollBuild(buildOid: string, options?: {
     intervalMs?: number;
     timeoutMs?: number;
+    /**
+     * Delay before the FIRST status check. POST /builds returns an oid before
+     * the build row is queryable — GET /builds/{oid} 400s with "BE#983754 Data
+     * source not found for build id" for the first few seconds. Wait this long
+     * before polling so the first request lands after the row exists.
+     */
+    initialDelayMs?: number;
     onUpdate?: (status: string) => void;
     httpClient?: HttpClient;
 }): Promise<PollBuildResult>;
-//# sourceMappingURL=rest-build.d.ts.map

package/dist/engines/build-csv-model/types.d.ts

@@ -4,7 +4,7 @@ import { HttpClient } from '@sisense/sdk-rest-client';
  * Canonical tool description for uploadFiles — reusable by any host (sdk-assistant, MCP server, custom integrations).
  * Hosts may append host-specific notes but should not duplicate or contradict this text.
  */
-export declare const uploadFilesToolDescription = "Opens the host's file-upload flow so the user can provide one or more CSV files. When the host uses a blocking UI, this should be the ONLY tool call in that turn until the user completes the upload \u2014 do not chain other tools in parallel.\n\nUse when the user wants to upload, ingest, import, or onboard raw files into a new Elasticube model.\n\nOnboarding pace: start this step alone; after files are uploaded, agree on a model title with the user in chat before calling buildDataModelFromUploads \u2014 do not rush multiple structural steps in one assistant turn when the workflow expects the user to confirm between steps.\n\nAfter this tool returns successfully, propose a model title derived from the file names and ask the user to confirm or change it before calling buildDataModelFromUploads.\n\nReply format (REQUIRED \u2014 output exactly these four lines, verbatim aside from substituting the proposed name; no extra preamble, no closing sentence, no paraphrasing, no translation, no icons, no headings, no blockquotes, no code fences, no bullets, no extra blank lines):\n\nYour files uploaded successfully\n**Let's set up your data model**\nSuggested name: **<Proposed Model Name>**\nThis name is permanent. If it's already taken, a number will be added at the end automatically.\n\nRules:\n- Each of the first three lines MUST end with exactly two trailing space characters before the newline (CommonMark hard line break). The four lines must therefore render stacked tightly, one per line, with no paragraph gaps. The last line has no trailing spaces.\n- Bold (**\u2026**) appears in exactly two places: the entire second line, and the model-name token on the third line. Nowhere else.\n- All four lines render at the SAME size \u2014 never promote any line to a heading.\n- Substitute <Proposed Model Name> with the title derived from the file names; keep the surrounding ** so it renders bold.\nWait for the user to confirm or change the name before calling buildDataModelFromUploads.";
+export declare const uploadFilesToolDescription = "Opens the host's file-upload flow so the user can provide one or more CSV files. When the host uses a blocking UI, this should be the ONLY tool call in that turn until the user completes the upload \u2014 do not chain other tools in parallel.\n\nUse when the user wants to upload, ingest, import, or onboard raw files into a new Elasticube model.\n\nCALL THIS TOOL IMMEDIATELY, as the FIRST action, the moment the user expresses intent to upload / import / onboard data files or build a model from files (e.g. \"I want to upload data files and build a model\") \u2014 even though no file is attached yet. THIS TOOL IS the upload surface: invoking it opens the file picker. Do NOT reply with text asking the user to attach or upload files via the chat input or paperclip \u2014 that is the wrong response and leaves the user with no upload UI. Open the tool; don't describe it.\n\nOnboarding pace: start this step alone; after files are uploaded, agree on a model title with the user in chat before calling buildDataModelFromUploads \u2014 do not rush multiple structural steps in one assistant turn when the workflow expects the user to confirm between steps.\n\nAfter this tool returns successfully, propose a model title derived from the file names and ask the user to confirm or change it before calling buildDataModelFromUploads.\n\nReply format (REQUIRED \u2014 output exactly these four lines, verbatim aside from substituting the proposed name; no extra preamble, no closing sentence, no paraphrasing, no translation, no icons, no headings, no blockquotes, no code fences, no bullets, no extra blank lines):\n\nYour files uploaded successfully\n**Let's set up your data model**\nSuggested name: **<Proposed Model Name>**\nThis name is permanent. If it's already taken, a number will be added at the end automatically.\n\nRules:\n- Each of the first three lines MUST end with exactly two trailing space characters before the newline (CommonMark hard line break). The four lines must therefore render stacked tightly, one per line, with no paragraph gaps. The last line has no trailing spaces.\n- Bold (**\u2026**) appears in exactly two places: the entire second line, and the model-name token on the third line. Nowhere else.\n- All four lines render at the SAME size \u2014 never promote any line to a heading.\n- Substitute <Proposed Model Name> with the title derived from the file names; keep the surrounding ** so it renders bold.\nWait for the user to confirm or change the name before calling buildDataModelFromUploads.";
 /**
  * Canonical tool description for buildDataModelFromUploads — reusable by any host (sdk-assistant, MCP server, custom integrations).
  * Hosts may append host-specific notes but should not duplicate or contradict this text.
@@ -71,4 +71,3 @@ export interface CsvModelEngineContext {
     toolCallId: string;
     httpClient?: HttpClient;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/engines/build-dashboard/add-dashboard-filters.d.ts

@@ -2,4 +2,3 @@ import { AddDashboardFiltersParams, BuildDashboardContext } from './types';
 export declare const addDashboardFilters: ({ dashboardId, userPrompt }: AddDashboardFiltersParams, context: BuildDashboardContext) => Promise<{
     message: string;
 }>;
-//# sourceMappingURL=add-dashboard-filters.d.ts.map

package/dist/engines/build-dashboard/add-dashboard-widgets.d.ts

@@ -2,4 +2,3 @@ import { AddDashboardWidgetsParams, BuildDashboardContext } from './types';
 export declare const addDashboardWidgets: ({ dashboardId, widgetIdsToAdd }: AddDashboardWidgetsParams, context: BuildDashboardContext) => Promise<{
     message: string;
 }>;
-//# sourceMappingURL=add-dashboard-widgets.d.ts.map

package/dist/engines/build-dashboard/build-dashboard-engine.d.ts

@@ -1,12 +1,3 @@
-import { BuildDashboardContext, ChartListSummary, DashboardContextPromptEntry, DashboardSummary, buildDashboardSchema } from './types';
-import { ChartSummary } from '../build-chart/types';
+import { BuildDashboardContext, DashboardSummary, buildDashboardSchema } from './types';
 import { default as z } from 'zod/v4';
-export declare function buildContextualSystemPrompt(chartSummaries: ChartSummary[], chartListSummaries: ChartListSummary[], dashboardsForContext: DashboardContextPromptEntry[], priorDashboardId?: string): string;
-/**
- * Standalone build dashboard engine - completely decoupled from any UI or store
- * @param params - The parameters for the build dashboard
- * @param context - All external dependencies injected
- * @returns The dashboard summary
- */
 export declare function buildDashboardEngine(params: z.infer<typeof buildDashboardSchema>, context: BuildDashboardContext): Promise<DashboardSummary>;
-//# sourceMappingURL=build-dashboard-engine.d.ts.map

package/dist/engines/build-dashboard/build-dashboard-service.d.ts

@@ -4,4 +4,3 @@ import { BaseDashboardSummary, ExtendedDashboardProps } from './types';
  * Returns `undefined` when `dashboardState` has not yet been computed.
  */
 export declare const getBaseDashboardSummary: (dashboardProps: ExtendedDashboardProps) => BaseDashboardSummary | undefined;
-//# sourceMappingURL=build-dashboard-service.d.ts.map

package/dist/engines/build-dashboard/create-dashboard.d.ts

@@ -2,4 +2,3 @@ import { CreateDashboardParams, BuildDashboardContext } from './types';
 export declare const createDashboard: ({ dashboardTitle, widgetIdsToAdd }: CreateDashboardParams, context: BuildDashboardContext) => Promise<{
     message: string;
 }>;
-//# sourceMappingURL=create-dashboard.d.ts.map

package/dist/engines/build-dashboard/dashboard-filters/dashboard-filters-system-prompt.d.ts

@@ -1,2 +1 @@
 export declare function generateFilterSystemPrompt(): string;
-//# sourceMappingURL=dashboard-filters-system-prompt.d.ts.map

package/dist/engines/build-dashboard/dashboard-filters/filter-factory-types.d.ts

@@ -1,2 +1 @@
 export declare const FILTER_FACTORY_TYPES: "import {\n\tDateDimension,\n\tLevelAttribute,\n\tAttribute,\n\tMeasure,\n\tFilter,\n\tBaseMeasure,\n\tFilterRelationsNode,\n\tFilterRelations,\n\tMembersFilterConfig,\n\tBaseFilterConfig,\n} from '../interfaces.js';\n/**\n * Creates a filter representing the union of multiple filters on the same attribute. The resulting\n * union filter filters on items that match any of the given filters.\n *\n * To create 'or' filters using different attributes, use the {@link logic.and | `or()`} function.\n *\n * @example\n * Filter for countries that start with the letter 'A' **or** end with the letter 'A'\n * in the Sample ECommerce data model.\n * ```ts\n * filterFactory.union([\n *   filterFactory.startsWith(DM.Country.Country, 'A'),\n *   filterFactory.endsWith(DM.Country.Country, 'A'),\n * ])\n * ```\n * @param filters - Filters to union. The filters must all be on the same attribute.\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function union(filters: Filter[], config?: BaseFilterConfig): Filter;\n/**\n * Creates a filter representing the intersection of multiple filters on the same attribute. The resulting\n * intersection filter filters on items that match all of the given filters.\n *\n * To create 'and' filters using different attributes, use the {@link logic.and | `and()`} function.\n *\n * @example\n * Filter for countries that start with the letter 'A' **and** end with the letter 'A'\n * in the Sample ECommerce data model.\n * ```ts\n * filterFactory.intersection([\n *   filterFactory.startsWith(DM.Country.Country, 'A'),\n *   filterFactory.endsWith(DM.Country.Country, 'A'),\n * ])\n * ```\n * @param filters - Filters to intersect. The filters must all be on the same attribute.\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function intersection(filters: Filter[], config?: BaseFilterConfig): Filter;\n/**\n * Creates a filter that excludes items matching the given filter\n * from all items or from items matching the optional input filter.\n *\n * @example\n * Filter for items where the country name does not contain the letter 'A'\n * from the Sample ECommerce data model.\n * ```ts\n * filterFactory.exclude(filterFactory.contains(DM.Country.Country, 'A'))\n * ```\n *\n * Filter for items where the country name starts with the letter 'B' but does not contain the letter 'A'\n * from the Sample ECommerce data model. This filter will match countries like 'Belgium', but will not\n * match countries like 'Bermuda'.\n * ```ts\n * filterFactory.exclude(\n *   filterFactory.contains(DM.Country.Country, 'A'),\n *   filterFactory.startsWith(DM.Country.Country, 'B')\n * )\n * ```\n * @param filter - Filter to exclude\n * @param input - Input filter to exclude from, on the same attribute. If not provided, the filter excludes from all items.\n * @param config - Optional configuration for the filter\n * @returns A filter representing an exclusion of the given filter\n * from all attribute members or from the optional input filter\n */\nexport declare function exclude(filter: Filter, input?: Filter, config?: BaseFilterConfig): Filter;\n/**\n * Creates a filter to isolate attribute values that do not contain a specified string.\n *\n * Matching is case insensitive.\n *\n * You can optionally use wildcard characters for pattern matching, as described in the\n * {@link like | `like()`} function.\n *\n * @example\n * Filter for categories in the Sample ECommerce data model where the category name doesn't contain\n * 'digital'. This filter matches categories not like 'Digital Cameras' and 'MP3 & Digital Media Players'.\n * ```ts\n * filterFactory.contains(DM.Category.Category, 'digital')\n * ```\n * @param attribute - Text attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function doesntContain(\n\tattribute: Attribute,\n\tvalue: string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that do not end with a specified string.\n *\n * Matching is case insensitive.\n *\n * You can optionally use wildcard characters for pattern matching, as described in the\n * {@link like | `like()`} function.\n *\n * @example\n * Filter for countries in the Sample ECommerce data model where the country name doesn't end with\n * 'land'. This filter matches countries not like 'Iceland' and 'Ireland'.\n * ```ts\n * filterFactory.doesntEndWith(DM.Country.Country, 'land')\n * ```\n * @param attribute - Text attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function doesntEndWith(\n\tattribute: Attribute,\n\tvalue: string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that do not start with a specified string.\n *\n * Matching is case insensitive.\n *\n * You can optionally use wildcard characters for pattern matching, as described in the\n * {@link like | `like()`} function.\n *\n * @example\n * Filter for countries in the Sample ECommerce data model where the country name doesn't start with\n * 'United'. This filter matches countries not like 'United States' and 'United Kingdom'.\n * ```ts\n * filterFactory.doesntStartWith(DM.Country.Country, 'United')\n * ```\n * @param attribute - Text attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function doesntStartWith(\n\tattribute: Attribute,\n\tvalue: string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that contain a specified string.\n *\n * Matching is case insensitive.\n *\n * You can optionally use wildcard characters for pattern matching, as described in the\n * {@link like | `like()`} function.\n *\n * @example\n * Filter for categories in the Sample ECommerce data model where the category name contains\n * 'digital'. This filter matches categories like 'Digital Cameras' and 'MP3 & Digital Media Players'.\n * ```ts\n * filterFactory.contains(DM.Category.Category, 'digital')\n * ```\n * @param attribute - Text attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function contains(\n\tattribute: Attribute,\n\tvalue: string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that end with a specified string.\n *\n * Matching is case insensitive.\n *\n * You can optionally use wildcard characters for pattern matching, as described in the\n * {@link like | `like()`} function.\n *\n * @example\n * Filter for countries in the Sample ECommerce data model where the country name ends with\n * 'land'. This filter matches countries like 'Ireland' and 'Iceland'.\n * ```ts\n * filterFactory.endsWith(DM.Country.Country, 'land')\n * ```\n * @param attribute - Text attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function endsWith(\n\tattribute: Attribute,\n\tvalue: string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that start with a specified string.\n *\n * Matching is case insensitive.\n *\n * You can optionally use wildcard characters for pattern matching, as described in the\n * {@link like | `like()`} function.\n *\n * @example\n * Filter for countries in the Sample ECommerce data model where the country name starts with\n * 'United'. This filter matches countries like 'United States' and 'United Kingdom'.\n * ```ts\n * filterFactory.startsWith(DM.Country.Country, 'United')\n * ```\n * @param attribute - Text attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function startsWith(\n\tattribute: Attribute,\n\tvalue: string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that match a specified string pattern.\n *\n * The pattern can include the following wildcard characters:\n *\n * + `_`: Matches a single character\n * + `%`: Matches multiple characters\n *\n * To search for a literal underscore (`_`) or percent symbol (`%`), use the backslash (`\\`) escape\n * character.\n *\n * Matching is case insensitive.\n *\n * @example\n * Filter for countries from the Sample ECommerce data model where the country name starts with an\n * 'A' and ends with an 'a'. This filter matches countries like 'Argentina' and 'Australia'.\n * ```ts\n * filterFactory.like(DM.Country.Country, 'A%a')\n * ```\n * @param attribute - Text attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function like(\n\tattribute: Attribute,\n\tvalue: string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that do not equal a specified string or number.\n *\n * When filtering against a string:\n *\n *  + Matching is case insensitive.\n *  + You can optionally use wildcard characters for pattern matching, as described in the\n * {@link like | `like()`} function.\n *\n * @example\n * Filter for items not in new condition from the Sample ECommerce data model.\n * ```ts\n * filterFactory.doesntEqual(DM.Commerce.Condition, 'New')\n * ```\n * @param attribute - Text or numeric attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function doesntEqual(\n\tattribute: Attribute,\n\tvalue: string | number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that equal a specified string or number.\n *\n * When filtering against a string:\n *\n *  + Matching is case insensitive.\n *  + You can optionally use wildcard characters for pattern matching, as described in the\n * {@link like | `like()`} function.\n *\n * @example\n * Filter for items in new condition from the Sample ECommerce data model.\n * ```ts\n * filterFactory.equals(DM.Commerce.Condition, 'New')\n * ```\n * @param attribute - Text or numeric attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function equals(\n\tattribute: Attribute,\n\tvalue: string | number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values strictly greater than a specified number.\n *\n * @example\n * Filter for items where the cost is greater than 100 from the Sample ECommerce data model.\n * ```ts\n * filterFactory.greaterThan(DM.Commerce.Cost, 100)\n * ```\n * @param attribute - Numeric attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function greaterThan(\n\tattribute: Attribute,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values greater than or equal to a specified number.\n *\n * @example\n * Filter for items where the cost is greater than or equal to 100 from the Sample ECommerce data model.\n * ```ts\n * filterFactory.greaterThanOrEqual(DM.Commerce.Cost, 100)\n * ```\n * @param attribute - Numeric attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function greaterThanOrEqual(\n\tattribute: Attribute,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values strictly less than a specified number.\n *\n * @example\n * Filter for items where the cost is less than 100 from the Sample ECommerce data model.\n * ```ts\n * filterFactory.lessThan(DM.Commerce.Cost, 100)\n * ```\n * @param attribute - Numeric attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function lessThan(\n\tattribute: Attribute,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values less than or equal to a specified number.\n *\n * @example\n * Filter for items where the cost is less than or equal to 100 from the Sample ECommerce data model.\n * ```ts\n * filterFactory.lessThanOrEqual(DM.Commerce.Cost, 100)\n * ```\n * @param attribute - Numeric attribute to filter on\n * @param value - Value to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function lessThanOrEqual(\n\tattribute: Attribute,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values within or exactly matching two specified numerical boundaries.\n *\n * @example\n * Filter for items from the Sample ECommerce data model where the cost is greater than or equal to 100 and less than or equal to 200.\n * ```ts\n * filterFactory.between(DM.Commerce.Cost, 100, 200)\n * ```\n * @param attribute - Numeric attribute to filter on\n * @param valueA - Value to filter from\n * @param valueB - Value to filter to\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function between(\n\tattribute: Attribute,\n\tvalueA: number,\n\tvalueB: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter that isolates attribute values strictly within two specified numerical boundaries.\n *\n * @example\n * Filter for items from the Sample ECommerce data model where the cost is greater than 100 and less than 200.\n * ```ts\n * filterFactory.betweenNotEqual(DM.Commerce.Cost, 100, 200)\n * ```\n * @param attribute - Numeric attribute to filter on\n * @param valueA - Value to filter from\n * @param valueB - Value to filter to\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function betweenNotEqual(\n\tattribute: Attribute,\n\tvalueA: number,\n\tvalueB: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a custom numeric filter that filters for given attribute values.\n *\n * @example\n * Filter for items where the cost is greater than 100 and less than 200\n * from the Sample ECommerce data model.\n * ```ts\n * filterFactory.numeric(\n *   DM.Commerce.Cost,\n *   NumericOperators.From,\n *   100,\n *   NumericOperators.To,\n *   200\n * )\n * ```\n * @param attribute - Numeric attribute to filter\n * @param operatorA - First operator\n * @param valueA - First value\n * @param operatorB - Second operator\n * @param valueB - Second value\n * @param config - Optional configuration for the filter\n * @returns A custom numeric filter of the given attribute\n */\nexport declare function numeric(\n\tattribute: Attribute,\n\toperatorA?: string,\n\tvalueA?: number,\n\toperatorB?: string,\n\tvalueB?: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate attribute values that match any of the specified strings.\n *\n * Matching is case sensitive.\n *\n * @example\n * Filter for items where the condition is 'Used' or 'Refurbished'\n * from the Sample ECommerce data model.\n * ```ts\n * filterFactory.members(DM.Commerce.Condition, ['Used', 'Refurbished'])\n * ```\n * @param attribute - Attribute to filter on\n * @param members - Array of member values to filter by\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n * @shortDescription Creates filter on attribute to match certain string values\n */\nexport declare function members(\n\tattribute: Attribute,\n\tmembers: string[],\n\tconfig?: MembersFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate date values starting from and including the given date and level.\n *\n * @example\n * Filter for items in the Sample ECommerce data model where the date is not before the year 2010.\n * ```ts\n * filterFactory.dateFrom(DM.Commerce.Date.Years, '2010-01')\n * ```\n * @param level - Date {@link LevelAttribute} to filter on\n * @param from - Date or string representing the value to filter from\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function dateFrom(\n\tlevel: LevelAttribute,\n\tfrom: Date | string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate items up until and including the given date and level.\n *\n * @example\n * Filter for items where the date is from the year 2010 or earlier in the Sample ECommerce data model.\n * ```ts\n * filterFactory.dateTo(DM.Commerce.Date.Years, '2010-01')\n * ```\n * @param level - Date {@link LevelAttribute} to filter on\n * @param to - Date or string representing the last member to filter to\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function dateTo(\n\tlevel: LevelAttribute,\n\tto: Date | string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate items between and including the given dates and level.\n *\n * @example\n * Filter for items in the Sample ECommerce data model where the date is from the years 2009, 2010, or 2011.\n * ```ts\n * filterFactory.dateRange(DM.Commerce.Date.Years, '2009-01', '2011-01')\n * ```\n * @param level - Date {@link LevelAttribute} to filter on\n * @param from - Date or string representing the start member to filter from\n * @param to - Date or string representing the end member to filter to\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function dateRange(\n\tlevel: LevelAttribute,\n\tfrom?: Date | string,\n\tto?: Date | string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate items with a date dimension value within a specified range after a\n * given date and level.\n *\n * Although the `offset` can be used to set a beginning date prior to the `anchor`, the filter range always\n * continues forward after the offset beginning date. So, using an `offset` of `-6` and a `count` of `18` when `level`\n * is a month level creates a range that begins 6 month before the `anchor` date and extends to 12 months after\n * the `anchor` date.\n *\n * @example\n * Filter for items in the Sample ECommerce data model where the date is in 2011 or the first half of 2012.\n * ```ts\n * filterFactory.dateRelative(DM.Commerce.Date.Months, 0, 18, '2011-01'),\n * ```\n *\n * Filter for items in the Sample ECommerce data model where the date is in the second half of 2010 or in 2011.\n * ```ts\n * filterFactory.dateRelative(DM.Commerce.Date.Months, -6, 18, '2011-01'),\n * ```\n *\n * Filter for items in the Sample ECommerce data model where the date is in the past 6 months.\n * ```ts\n * filterFactory.dateRelative(DM.Commerce.Date.Months, -6, 6),\n * ```\n * @param level - Date {@link LevelAttribute} to filter on\n * @param offset - Number of levels to skip from the given `anchor` or the default of the current day.\n * Positive numbers skip forwards and negative numbers skip backwards (e.g. `-6` is 6 months backwards when `level` is a months level attribute)\n * @param count - Number of levels to include in the filter (e.g. `6` is 6 months when `level` is a months level attribute)\n * @param anchor - Date to filter from, defaults to the current day\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function dateRelative(\n\tlevel: LevelAttribute,\n\toffset: number,\n\tcount: number,\n\tanchor?: Date | string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate items with a date dimension value within a specified range after a\n * given date and level.\n *\n * @example\n * Filter for items in the Sample ECommerce data model where the date is in 2011 or the first half of 2012.\n * ```ts\n * filterFactory.dateRelativeFrom(DM.Commerce.Date.Months, 0, 18, '2011-01'),\n * ```\n * @param level - Date {@link LevelAttribute} to filter on\n * @param offset - Number of levels to skip from the given `anchor` or the default of the current day (e.g. `6` is 6 months when `level` is a months level attribute)\n * @param count - Number of levels to include in the filter (e.g. `6` is 6 months when `level` is a months level attribute)\n * @param anchor - Date to filter from, defaults to the current day\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function dateRelativeFrom(\n\tlevel: LevelAttribute,\n\toffset: number,\n\tcount: number,\n\tanchor?: Date | string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate items with a date dimension value within a specified range before a\n * given date and level.\n *\n * @example\n * Filter for items in the Sample ECommerce data model where the date is in the first half of 2010 or in 2011.\n * ```ts\n * filterFactory.dateRelativeTo(DM.Commerce.Date.Months, 0, 18, '2011-12'),\n * ```\n * @param level - Date {@link LevelAttribute} to filter on\n * @param offset - Number of levels to skip from the given `anchor` or the default of the current day (e.g. `6` is 6 months when `level` is a months level attribute)\n * @param count - Number of levels to include in the filter (e.g. `6` is 6 months when `level` is a months level attribute)\n * @param anchor - Date to filter to, defaults to the current day\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function dateRelativeTo(\n\tlevel: LevelAttribute,\n\toffset: number,\n\tcount: number,\n\tanchor?: Date | string,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate items with a date dimension value in the current calendar year.\n *\n * @example\n * Filter for items where the date is in the current calendar year in the Sample ECommerce data model.\n * ```ts\n * filterFactory.thisYear(DM.Commerce.Date)\n * ```\n * @param dimension - Date dimension to filter\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function thisYear(dimension: DateDimension, config?: BaseFilterConfig): Filter;\n/**\n * Creates a filter to isolate items with a date dimension value in the current calendar month.\n *\n * @example\n * Filter for items where the date is in the current calendar month in the Sample ECommerce data model.\n * ```ts\n * filterFactory.thisMonth(DM.Commerce.Date)\n * ```\n * @param dimension - Date dimension to filter\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function thisMonth(dimension: DateDimension, config?: BaseFilterConfig): Filter;\n/**\n * Creates a filter to isolate items with a date dimension value in the current quarter.\n *\n * @example\n * Filter for items where the date is in the current quarter in the Sample ECommerce data model.\n * ```ts\n * filterFactory.thisQuarter(DM.Commerce.Date)\n * ```\n * @param dimension - Date dimension to filter\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function thisQuarter(dimension: DateDimension, config?: BaseFilterConfig): Filter;\n/**\n * Creates a filter to isolate items with a date dimension value of the current date.\n *\n * @example\n * Filter for items where the date is today in the Sample ECommerce data model.\n * ```ts\n * filterFactory.today(DM.Commerce.Date)\n * ```\n * @param dimension - date dimension to filter\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function today(dimension: DateDimension, config?: BaseFilterConfig): Filter;\n/**\n * Creates a filter on all measure values matching the provided criteria.\n *\n * @param attribute - Attribute to filter\n * @param measure - Measure to filter by\n * @param operatorA - Operator to apply on `valueA` ({@link NumericOperators})\n * @param valueA - First value\n * @param operatorB - Operator to apply on `valueB` ({@link NumericOperators})\n * @param valueB - Second value\n * @param config - Optional configuration for the filter\n * @returns A filter representing the provided logic\n * @internal\n */\nexport declare function measureBase(\n\tattribute: Attribute,\n\tmeasure: Measure,\n\toperatorA?: string,\n\tvalueA?: number,\n\toperatorB?: string,\n\tvalueB?: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate a measure value equal to a given number.\n *\n * @example\n * Filter for categories that have an average revenue equal 50 in the Sample ECommerce data model.\n * ```ts\n * filterFactory.measureEquals(\n *   measureFactory.average(DM.Commerce.Revenue),\n *   50\n * )\n * ```\n * @param measure - Measure to filter by\n * @param value - Value\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function measureEquals(\n\tmeasure: BaseMeasure,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate a measure value greater than to a given number.\n *\n * @example\n * Filter for categories that have an average revenue greater than\n * to 50 in the Sample ECommerce data model.\n * ```ts\n * filterFactory.measureGreaterThan(\n *   measureFactory.average(DM.Commerce.Revenue),\n *   50\n * )\n * ```\n * @param measure - Measure to filter by\n * @param value - Min value\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function measureGreaterThan(\n\tmeasure: BaseMeasure,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate a measure value greater than or equal to a given number.\n *\n * @example\n * Filter for categories that have an average revenue greater than\n * or equal to 50 in the Sample ECommerce data model.\n * ```ts\n * filterFactory.measureGreaterThanOrEqual(\n *   measureFactory.average(DM.Commerce.Revenue),\n *   50\n * )\n * ```\n * @param measure - Measure to filter by\n * @param value - Min value\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function measureGreaterThanOrEqual(\n\tmeasure: BaseMeasure,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate a measure value less than or equal to a given number.\n *\n * @example\n * Filter for categories that have an average revenue less than\n * or equal to 100 in the Sample ECommerce data model.\n * ```ts\n * filterFactory.measureLessThanOrEqual(\n *   measureFactory.average(DM.Commerce.Revenue),\n *   100\n * )\n * ```\n * @param measure - Measure to filter by\n * @param value - Max value\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function measureLessThanOrEqual(\n\tmeasure: BaseMeasure,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate a measure value less than a given number.\n *\n * @example\n * Filter for categories that have an average revenue less than 100 in the Sample ECommerce data model.\n * ```ts\n * filterFactory.measureLessThan(\n *   measureFactory.average(DM.Commerce.Revenue),\n *   100\n * )\n * ```\n * @param measure - Measure to filter by\n * @param value - Value\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function measureLessThan(\n\tmeasure: BaseMeasure,\n\tvalue: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate a measure value between or equal to two given numbers.\n *\n * @example\n * Filter for categories that have an average revenue greater than or equal to 50 and less than\n * or equal to 100 in the Sample ECommerce data model.\n * ```ts\n * filterFactory.measureBetween(\n *   measureFactory.average(DM.Commerce.Revenue),\n *   50,\n *   100\n * )\n * ```\n * @param measure - Measure to filter by\n * @param valueA - Min value\n * @param valueB - Max value\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function measureBetween(\n\tmeasure: BaseMeasure,\n\tvalueA: number,\n\tvalueB: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate a measure value between but not equal to two given numbers.\n *\n * @example\n * Filter for categories that have an average revenue greater than 50 and less than\n * 100 in the Sample ECommerce data model.\n * ```ts\n * filterFactory.measureBetweenNotEqual(\n *   measureFactory.average(DM.Commerce.Revenue),\n *   50,\n *   100\n * )\n * ```\n * @param measure - Measure to filter by\n * @param valueA - Min value\n * @param valueB - Max value\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function measureBetweenNotEqual(\n\tmeasure: BaseMeasure,\n\tvalueA: number,\n\tvalueB: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate items that rank towards the top for a given measure.\n *\n * @example\n * Filter for age ranges with the top 3 highest total revenue in the Sample ECommerce data model.\n * ```ts\n * filterFactory.topRanking(\n *   DM.Commerce.AgeRange,\n *   measureFactory.sum(DM.Commerce.Revenue),\n *   3\n * )\n * ```\n * @param attribute - Attribute to filter\n * @param measure - Measure to filter by\n * @param count - Number of members to return\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function topRanking(\n\tattribute: Attribute,\n\tmeasure: Measure,\n\tcount: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter to isolate items that rank towards the bottom for a given measure.\n *\n * @example\n * Filter for age ranges with the bottom 3 lowest total revenue in the Sample ECommerce data model.\n * ```ts\n * filterFactory.bottomRanking(\n *   DM.Commerce.AgeRange,\n *   measureFactory.sum(DM.Commerce.Revenue),\n *   3\n * )\n * ```\n * @param attribute - Attribute to filter\n * @param measure - Measure to filter by\n * @param count - Number of members to return\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function bottomRanking(\n\tattribute: Attribute,\n\tmeasure: Measure,\n\tcount: number,\n\tconfig?: BaseFilterConfig,\n): Filter;\n/**\n * Creates a filter that contains a list of dependent/cascading filters,\n * where each filter depends on the results or state of the previous ones in the array.\n *\n * Each filter in the array operates in the context of its predecessors, and the\n * cascading behavior ensures that all filters are applied sequentially.\n *\n * @example\n * ```ts\n * // Create a cascading filter for gender and age range\n * const cascadingFilter = filterFactory.cascading(\n *   [\n *     filterFactory.members(DM.Commerce.Gender, ['Male', 'Female']),\n *     filterFactory.members(DM.Commerce.AgeRange, ['0-18']),\n *   ],\n *   { disabled: true }, // Optional configuration to disable the cascading filter\n * );\n * ```\n * @param filters - Array of dependent filters\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n */\nexport declare function cascading(filters: Filter[], config?: BaseFilterConfig): Filter;\n/**\n * Set of logic operators for filter relations construction\n *\n * These operators are still in beta.\n *\n * @example\n * ```ts\n * import { filters } from '@sisense/sdk-data';\n *\n * // define filters\n * const revenueFilter = filterFactory.greaterThan(DM.Commerce.Revenue, 1000);\n * const countryFilter = filterFactory.members(DM.Commerce.Country, ['USA', 'Canada']);\n * const genderFilter = filterFactory.doesntContain(DM.Commerce.Gender, 'Unspecified');\n * const costFilter = filterFactory.between(DM.Commerce.Cost, 1000, 2000);\n *\n * // create filter relations of two filters\n * const orFilerRelations = filterFactory.logic.or(revenueFilter, countryFilter);\n * // revenueFilter OR countryFilter\n *\n * // filter relations can have nested filter relations\n * const mixedFilterRelations = filterFactory.logic.and(genderFilter, orFilerRelations);\n * // genderFilter AND (revenueFilter OR countryFilter)\n *\n * // array, specified in filter relations, will be converted to an intersection of filters automatically\n * const arrayFilterRelations = filterFactory.logic.or([genderFilter, costFilter], mixedFilterRelations);\n * // (genderFilter AND costFilter) OR (genderFilter AND (revenueFilter OR countryFilter))\n * ```\n * @beta\n */\nexport declare namespace logic {\n\t/**\n\t * Creates an 'AND' filter relations\n\t *\n\t * @example\n\t * Create filter relations for items that have a revenue greater than 100 and are in new condition\n\t * in the Sample ECommerce data model.\n\t * ```ts\n\t * const revenueFilter = filterFactory.greaterThan(DM.Commerce.Revenue, 100);\n\t * const conditionFilter = filterFactory.equals(DM.Commerce.Condition, 'New');\n\t *\n\t * const andFilerRelation = filterFactory.logic.and(revenueFilter, conditionFilter);\n\t * ```\n\t * @param left First filter or filter relations\n\t * @param right Second filter or filter relations\n\t * @returns Filter relations\n\t * @beta\n\t */\n\tconst and: (left: FilterRelationsNode, right: FilterRelationsNode) => FilterRelations;\n\t/**\n\t * Creates an 'OR' filter relations\n\t *\n\t * @example\n\t * Create filter relations for items that have a revenue greater than 100 or are in new condition\n\t * in the Sample ECommerce data model.\n\t * ```ts\n\t * const revenueFilter = filterFactory.greaterThan(DM.Commerce.Revenue, 100);\n\t * const conditionFilter = filterFactory.equals(DM.Commerce.Condition, 'New');\n\t *\n\t * const orFilerRelation = filterFactory.logic.or(revenueFilter, conditionFilter);\n\t * ```\n\t * @param left First filter or filter relations\n\t * @param right Second filter or filter relations\n\t * @returns Filter relations\n\t * @beta\n\t */\n\tconst or: (left: FilterRelationsNode, right: FilterRelationsNode) => FilterRelations;\n}\n/**\n * Creates a filter from JAQL\n *\n * @param attribute - Attribute to filter\n * @param jaql - Filter Jaql\n * @param config - Optional configuration for the filter\n * @returns A filter instance\n * @internal\n */\nexport declare function customFilter(\n\tattribute: Attribute,\n\tjaql: any,\n\tconfig?: BaseFilterConfig,\n): Filter;";
-//# sourceMappingURL=filter-factory-types.d.ts.map

package/dist/engines/build-dashboard/dashboard-filters/manipulate-dashboard-filters.d.ts

@@ -4,4 +4,3 @@ export declare const manipulateDashboardFilters: (userPrompt: string, dataSource
     dashboardProps: DashboardProps;
     explanation: string;
 }>;
-//# sourceMappingURL=manipulate-dashboard-filters.d.ts.map