@sisense/sdk-ai-core 0.9.0 → 0.13.0

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

@@ -1,364 +1,98 @@
-import { z } from 'zod';
-import { default as OpenAI } from 'openai';
-import { ChatCompletionCreateParamsStreaming, ChatCompletionMessageParam } from 'openai/resources/chat/completions';
+import { z } from 'zod/v4';
+import { LanguageModel, ModelMessage } from 'ai';
 export declare const toolSchema: z.ZodObject<{
     modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     prompt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    prompt: string;
-    modelId?: string | null | undefined;
-}, {
-    prompt: string;
-    modelId?: string | null | undefined;
-}>;
+}, z.core.$strip>;
 /** Persisted logical data model document (tool results / canvas). */
 export declare const dataModelDocumentSchema: z.ZodObject<{
     dbName: z.ZodString;
     tables: z.ZodArray<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         tableName: z.ZodString;
-        tableType: z.ZodEnum<["fact", "dimension"]>;
+        tableType: z.ZodEnum<{
+            dimension: "dimension";
+            fact: "fact";
+        }>;
         rowCount: z.ZodNumber;
         columns: z.ZodArray<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             columnName: z.ZodString;
             isPrimaryKey: z.ZodBoolean;
             isForeignKey: z.ZodBoolean;
-            type: z.ZodEnum<["numeric", "text", "datetime"]>;
+            type: z.ZodEnum<{
+                text: "text";
+                datetime: "datetime";
+                numeric: "numeric";
+            }>;
             fakerType: z.ZodString;
             fakerOptions: z.ZodOptional<z.ZodString>;
             referenceTo: z.ZodOptional<z.ZodObject<{
                 table: z.ZodString;
                 column: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                table: string;
-                column: string;
-            }, {
-                table: string;
-                column: string;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }, {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        columns: {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }[];
-        tableName: string;
-        tableType: "fact" | "dimension";
-        rowCount: number;
-        id?: string | undefined;
-    }, {
-        columns: {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }[];
-        tableName: string;
-        tableType: "fact" | "dimension";
-        rowCount: number;
-        id?: string | undefined;
-    }>, "many">;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     summary: z.ZodString;
     error: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    summary: string;
-    tables: {
-        columns: {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }[];
-        tableName: string;
-        tableType: "fact" | "dimension";
-        rowCount: number;
-        id?: string | undefined;
-    }[];
-    dbName: string;
-    error?: string | undefined;
-}, {
-    summary: string;
-    tables: {
-        columns: {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }[];
-        tableName: string;
-        tableType: "fact" | "dimension";
-        rowCount: number;
-        id?: string | undefined;
-    }[];
-    dbName: string;
-    error?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type DataModelDocument = z.infer<typeof dataModelDocumentSchema>;
 export type DataModelTable = DataModelDocument['tables'][number];
 export type DataModelColumn = DataModelTable['columns'][number];
-export declare const dataModelJsonPatchSchema: z.ZodUnion<[z.ZodObject<{
-    op: z.ZodEnum<["add", "replace"]>;
+export declare const dataModelJsonPatchSchema: z.ZodUnion<readonly [z.ZodObject<{
+    op: z.ZodEnum<{
+        replace: "replace";
+        add: "add";
+    }>;
     path: z.ZodString;
-    value: z.ZodUnion<[z.ZodObject<{
+    value: z.ZodUnion<readonly [z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         columnName: z.ZodString;
         isPrimaryKey: z.ZodBoolean;
         isForeignKey: z.ZodBoolean;
-        type: z.ZodEnum<["numeric", "text", "datetime"]>;
+        type: z.ZodEnum<{
+            text: "text";
+            datetime: "datetime";
+            numeric: "numeric";
+        }>;
         fakerType: z.ZodString;
         fakerOptions: z.ZodOptional<z.ZodString>;
         referenceTo: z.ZodOptional<z.ZodObject<{
             table: z.ZodString;
             column: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            table: string;
-            column: string;
-        }, {
-            table: string;
-            column: string;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        type: "text" | "datetime" | "numeric";
-        columnName: string;
-        isPrimaryKey: boolean;
-        isForeignKey: boolean;
-        fakerType: string;
-        id?: string | undefined;
-        fakerOptions?: string | undefined;
-        referenceTo?: {
-            table: string;
-            column: string;
-        } | undefined;
-    }, {
-        type: "text" | "datetime" | "numeric";
-        columnName: string;
-        isPrimaryKey: boolean;
-        isForeignKey: boolean;
-        fakerType: string;
-        id?: string | undefined;
-        fakerOptions?: string | undefined;
-        referenceTo?: {
-            table: string;
-            column: string;
-        } | undefined;
-    }>, z.ZodObject<{
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         tableName: z.ZodString;
-        tableType: z.ZodEnum<["fact", "dimension"]>;
+        tableType: z.ZodEnum<{
+            dimension: "dimension";
+            fact: "fact";
+        }>;
         rowCount: z.ZodNumber;
         columns: z.ZodArray<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             columnName: z.ZodString;
             isPrimaryKey: z.ZodBoolean;
             isForeignKey: z.ZodBoolean;
-            type: z.ZodEnum<["numeric", "text", "datetime"]>;
+            type: z.ZodEnum<{
+                text: "text";
+                datetime: "datetime";
+                numeric: "numeric";
+            }>;
             fakerType: z.ZodString;
             fakerOptions: z.ZodOptional<z.ZodString>;
             referenceTo: z.ZodOptional<z.ZodObject<{
                 table: z.ZodString;
                 column: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                table: string;
-                column: string;
-            }, {
-                table: string;
-                column: string;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }, {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        columns: {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }[];
-        tableName: string;
-        tableType: "fact" | "dimension";
-        rowCount: number;
-        id?: string | undefined;
-    }, {
-        columns: {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }[];
-        tableName: string;
-        tableType: "fact" | "dimension";
-        rowCount: number;
-        id?: string | undefined;
-    }>, z.ZodString, z.ZodNumber, z.ZodBoolean]>;
-}, "strip", z.ZodTypeAny, {
-    value: string | number | boolean | {
-        type: "text" | "datetime" | "numeric";
-        columnName: string;
-        isPrimaryKey: boolean;
-        isForeignKey: boolean;
-        fakerType: string;
-        id?: string | undefined;
-        fakerOptions?: string | undefined;
-        referenceTo?: {
-            table: string;
-            column: string;
-        } | undefined;
-    } | {
-        columns: {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }[];
-        tableName: string;
-        tableType: "fact" | "dimension";
-        rowCount: number;
-        id?: string | undefined;
-    };
-    path: string;
-    op: "replace" | "add";
-}, {
-    value: string | number | boolean | {
-        type: "text" | "datetime" | "numeric";
-        columnName: string;
-        isPrimaryKey: boolean;
-        isForeignKey: boolean;
-        fakerType: string;
-        id?: string | undefined;
-        fakerOptions?: string | undefined;
-        referenceTo?: {
-            table: string;
-            column: string;
-        } | undefined;
-    } | {
-        columns: {
-            type: "text" | "datetime" | "numeric";
-            columnName: string;
-            isPrimaryKey: boolean;
-            isForeignKey: boolean;
-            fakerType: string;
-            id?: string | undefined;
-            fakerOptions?: string | undefined;
-            referenceTo?: {
-                table: string;
-                column: string;
-            } | undefined;
-        }[];
-        tableName: string;
-        tableType: "fact" | "dimension";
-        rowCount: number;
-        id?: string | undefined;
-    };
-    path: string;
-    op: "replace" | "add";
-}>, z.ZodObject<{
-    op: z.ZodEnum<["remove"]>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodEnum<{
+        remove: "remove";
+    }>;
     path: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    op: "remove";
-}, {
-    path: string;
-    op: "remove";
-}>]>;
+}, z.core.$strip>]>;
 export type DataModelJsonPatch = z.infer<typeof dataModelJsonPatchSchema>;
 export interface BuildDataModelEngineResult {
     dataSourceTitle: string;
@@ -366,13 +100,20 @@ export interface BuildDataModelEngineResult {
     modelId: string;
     usageInstructions: string;
 }
+export type DataModelStreamOpts = {
+    temperature: number;
+    responseFormat: {
+        type: 'json_object';
+    };
+};
 export type DataModelStreamHistoryPayload = {
     kind: 'request';
-    opts: ChatCompletionCreateParamsStreaming;
+    opts: DataModelStreamOpts;
+    messages?: ModelMessage[];
 } | {
     kind: 'complete';
-    opts: ChatCompletionCreateParamsStreaming;
-    messages: ChatCompletionMessageParam[];
+    opts: DataModelStreamOpts;
+    messages: ModelMessage[];
     /** Snapshot stored with tool history (last incremental document before final patch pass). */
     result: DataModelDocument;
 };
@@ -380,9 +121,11 @@ export interface BuildDataModelContext {
     toolCallId: string;
     /** Starting document; tool loads from session when updating an existing model. */
     initialDocument: DataModelDocument;
-    openAIClient?: OpenAI;
+    /** Optional model override (e.g. tests). Defaults to getLlmClient(). */
+    llm?: LanguageModel;
     activeSessionId?: string;
     onDocumentUpdate?: (document: DataModelDocument) => void;
     onStreamHistory?: (payload: DataModelStreamHistoryPayload) => void;
+    abortSignal?: AbortSignal;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/engines/build-data-model/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/build-data-model/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EACX,mCAAmC,EACnC,0BAA0B,EAC1B,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,UAAU;;;;;;;;;EA2BrB,CAAC;AA0DH,qEAAqE;AACrE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,0BAA0B;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,6BAA6B,GACtC;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,mCAAmC,CAAC;CACzC,GACD;IACA,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,mCAAmC,CAAC;IAC1C,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,6FAA6F;IAC7F,MAAM,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEL,MAAM,WAAW,qBAAqB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,eAAe,EAAE,iBAAiB,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACzD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,IAAI,CAAC;CACnE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/build-data-model/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEtD,eAAO,MAAM,UAAU;;;iBA2BrB,CAAC;AA0DH,qEAAqE;AACrE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAgBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,0BAA0B;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GACtC;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB,GACD;IACA,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,6FAA6F;IAC7F,MAAM,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEL,MAAM,WAAW,qBAAqB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,eAAe,EAAE,iBAAiB,CAAC;IACnC,wEAAwE;IACxE,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACzD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,IAAI,CAAC;IACnE,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B"}

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

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { buildQuerySchema, BuildQueryContext, QueryResult } from './types';
 /**
  * Standalone build query engine - completely decoupled from any UI or store

package/dist/engines/build-query/build-query-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-query-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/build-query/build-query-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3E;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,EACxC,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,WAAW,CAAC,CAsCtB"}
+{"version":3,"file":"build-query-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/build-query/build-query-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3E;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,EACxC,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,WAAW,CAAC,CA4DtB"}

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

@@ -1,19 +1,24 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { HttpClient } from '@sisense/sdk-rest-client';
-import { ChartState, Dataset, NlqV3Result } from '../../services/nlq/nlq-service';
+import { Dataset, QueryExecutionResult, QueryState } from '../../services/nlq/nlq-service';
+export interface QueryResult {
+    queryId: string;
+    title: string;
+    nlqResult: QueryExecutionResult;
+}
+/**
+ * Canonical tool description for buildQuery — 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 buildQueryToolDescription = "Runs an analytics query from a natural language prompt and returns the results as structured data (tabular exploration, no chart).\n\n**New query** \u2014 Only for the first query in a chain, or when the user clearly abandons the prior result and starts unrelated analysis. Omit `priorQueryId` (or null). Put the full natural-language intent in `queryPrompt`.\n\n**Revise an existing query** \u2014 Use for same-thread follow-ups that adjust the *same* analysis: different breakdown (e.g. by year, by category), added or removed filters, sort order, measure swaps, limits (Top N), trend/forecast, etc. Treat these as revisions, not separate unrelated queries.\n\nFor revisions: \n- Set `priorQueryId` to the exact string in the `queryId` field from the **latest successful** tool result of this tool in the conversation (that value is the same id you pass as `queryId` when wiring a prior tabular result into the chart tool). \n- In `queryPrompt`, pass only the delta vs. that prior query \u2014 do not repeat the full prior specification.\n\nReturn value includes queryId, queryState, and dataset rows. If the dataset includes a \"sample\" key, the full result was size-limited \u2014 call the chart tool with that queryId so the user can explore the complete result in the chart widget.";
 /**
  * Schema for buildQuery engine parameters
  */
 export declare const buildQuerySchema: z.ZodObject<{
     dataSourceTitle: z.ZodString;
     queryPrompt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    dataSourceTitle: string;
-    queryPrompt: string;
-}, {
-    dataSourceTitle: string;
-    queryPrompt: string;
-}>;
+    priorQueryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
 /**
  * Context interface for buildQueryEngine
  */
@@ -22,19 +27,25 @@ export interface BuildQueryContext {
     toolCallId: string;
     /** HTTP client for API calls (optional, uses singleton if not provided) */
     httpClient?: HttpClient;
-    /** Translated dashboard filters for NLQ smart-query `commonFilters` (omit when not applying) */
-    filters?: unknown;
-}
-export interface QueryResult {
-    queryId: string;
-    title: string;
-    nlqResult: NlqV3Result;
+    /** Common filters (e.g., from dashboard filters) to be applied to the query. */
+    commonFilters?: unknown;
+    /**
+     * Resolve a stored query by id when `params.priorQueryId` is set.
+     * Required whenever `priorQueryId` is present; prior NLQ state is read from
+     * `nlqResult.queryState` only.
+     */
+    retrieveQuery?: (queryId: string) => QueryResult | null;
+    /**
+     * When true (default), prior NLQ state is sent as REST `chartState`.
+     * When false, prior state is inlined into `text` instead (instances without wire delta support).
+     */
+    isNlqDeltaEnabled?: boolean;
 }
 /** Summary of a query for LLM consumption (tool response and prompt context). */
 export interface QuerySummary {
     queryId: string;
     title: string;
-    chartState: ChartState;
+    queryState: QueryState;
     dataset: Dataset;
 }
 /**

package/dist/engines/build-query/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/build-query/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EACN,UAAU,EACV,OAAO,EACP,WAAW,EACX,MAAM,gCAAgC,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAS3B,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gGAAgG;IAChG,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,WAAW,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,WAAW,EACnB,cAAc,UAAO,GACnB,YAAY,CASd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/build-query/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EACN,OAAO,EACP,oBAAoB,EACpB,UAAU,EACV,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,oBAAoB,CAAC;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,6wCAUyM,CAAC;AAEhP;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAgB3B,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IACxD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,WAAW,EACnB,cAAc,UAAO,GACnB,YAAY,CASd"}

package/dist/engines/get-dashboards/get-dashboards-engine.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { getDashboardsSchema, GetDashboardsContext, DashboardsResult } from './types';
 /**
  * Standalone dashboards engine - completely decoupled from any UI or store

package/dist/engines/get-dashboards/get-dashboards-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-dashboards-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/get-dashboards/get-dashboards-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACN,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,EAC3C,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}
+{"version":3,"file":"get-dashboards-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/get-dashboards/get-dashboards-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACN,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,MAAM,SAAS,CAAC;AAIjB;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,EAC3C,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/engines/get-dashboards/types.d.ts

@@ -1,10 +1,15 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { Dashboard } from '../../services/dashboards/fusion-dashboards-service';
 import { HttpClient } from '@sisense/sdk-rest-client';
+/**
+ * Canonical tool description for getDashboards — 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 getDashboardsToolDescription = "Get a list of available Fusion dashboards created by the assistant (or exposed by the host).\n\nDo not read the raw tool result as a list to the user. Use it internally, then suggest one or two concrete follow-ups (e.g. which dashboard to open or extend) instead of dumping every title.";
 /**
  * Schema for getDashboards engine parameters
  */
-export declare const getDashboardsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const getDashboardsSchema: z.ZodObject<{}, z.core.$strip>;
 /**
  * Context interface for getDashboardsEngine
  */

package/dist/engines/get-dashboards/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/get-dashboards/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iDAAiD,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,mBAAmB,gDAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,UAAU,EAAE,SAAS,EAAE,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/get-dashboards/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,iDAAiD,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,mSAEsJ,CAAC;AAEhM;;GAEG;AACH,eAAO,MAAM,mBAAmB,gCAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,UAAU,EAAE,SAAS,EAAE,CAAC;CACxB"}

package/dist/engines/get-data-source-fields/get-data-source-fields-engine.d.ts

@@ -1,6 +1,7 @@
-import { z } from 'zod';
-import { JSONArray, DataSourceField } from '@sisense/sdk-data';
+import { z } from 'zod/v4';
+import { MeasureItemJSON } from '@sisense/sdk-ui/analytics-composer';
 import { DataSourceFieldWithDescription } from '../../services/data-sources/data-sources-service';
+import { DataSourceField } from '@sisense/sdk-data';
 import { getDataSourceFieldsSchema, GetDataSourceFieldsContext, DataSourceFieldsResult } from './types';
 /**
  * Fetches fields for a data source (decoupled from UI/store).
@@ -15,7 +16,7 @@ export declare function getDataSourceFieldsEngine(params: z.infer<typeof getData
  * @param formulas - Shared formulas in JSON format (array of { function, args })
  * @returns YAML block with heading and list of { name, description }, or empty string if none
  */
-export declare function buildCompactSharedFormulas(formulas: JSONArray): string;
+export declare function buildCompactSharedFormulas(formulas: MeasureItemJSON[]): string;
 /**
  * Builds the compact schema string returned to the LLM (intro + tables/columns + optional shared formulas).
  * Reduces token use by returning a single string instead of a JSON object.
@@ -24,5 +25,5 @@ export declare function buildCompactSharedFormulas(formulas: JSONArray): string;
  * @param formulas - Optional shared formulas in NLQ JSON format (for the chat agent)
  * @returns A compact schema string with table and column names, and shared formulas when provided
  */
-export declare function getDataSourceFieldsSummary(dataSourceTitle: string, fields: DataSourceFieldWithDescription[] | DataSourceField[], formulas?: JSONArray): string;
+export declare function getDataSourceFieldsSummary(dataSourceTitle: string, fields: DataSourceFieldWithDescription[] | DataSourceField[], formulas?: MeasureItemJSON[]): string;
 //# sourceMappingURL=get-data-source-fields-engine.d.ts.map

package/dist/engines/get-data-source-fields/get-data-source-fields-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-data-source-fields-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/get-data-source-fields/get-data-source-fields-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAEN,8BAA8B,EAC9B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,OAAO,EACN,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC9C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,EACjD,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAiDjC;AAsBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,SAAS,GAAG,MAAM,CAuCtE;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACzC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,8BAA8B,EAAE,GAAG,eAAe,EAAE,EAC5D,QAAQ,CAAC,EAAE,SAAS,GAClB,MAAM,CA2BR"}
+{"version":3,"file":"get-data-source-fields-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/get-data-source-fields/get-data-source-fields-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACN,eAAe,EAEf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEN,8BAA8B,EAC9B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQpD,OAAO,EACN,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC9C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,EACjD,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAiDjC;AAsBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,eAAe,EAAE,GACzB,MAAM,CAuCR;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACzC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,8BAA8B,EAAE,GAAG,eAAe,EAAE,EAC5D,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC1B,MAAM,CA2BR"}

package/dist/engines/get-data-source-fields/types.d.ts

@@ -1,17 +1,19 @@
-import { z } from 'zod';
-import { DataSourceField, JSONArray } from '@sisense/sdk-data';
+import { z } from 'zod/v4';
+import { DataSourceField } from '@sisense/sdk-data';
 import { HttpClient } from '@sisense/sdk-rest-client';
 import { DataSourceFieldWithDescription } from '../../services/data-sources/data-sources-service';
+import { MeasureItemJSON } from '@sisense/sdk-ui/analytics-composer';
+/**
+ * Canonical tool description for getDataSourceFields — 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 getDataSourceFieldsToolDescription = "Get details of a data source's fields \u2014 tables, columns, and user-created formulas \u2014 as a flat list. Use this metadata to build queries, charts, or dashboards.\n\nNOT the right tool for \"explore / show me / view the model\" as a visual diagram. That is getModelSchema (interactive model diagram when the host supports it). Only call this tool when you need the column list for a downstream query-building step, never as the default exploration action.";
 /**
  * Schema for getDataSourceFields engine parameters
  */
 export declare const getDataSourceFieldsSchema: z.ZodObject<{
     dataSourceTitle: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    dataSourceTitle: string;
-}, {
-    dataSourceTitle: string;
-}>;
+}, z.core.$strip>;
 /**
  * Context interface for getDataSourceFieldsEngine
  */
@@ -29,6 +31,6 @@ export interface DataSourceFieldsResult {
     dataSourceTitle: string;
     fields: DataSourceFieldWithDescription[] | DataSourceField[];
     /** Shared formulas as JSON */
-    formulas?: JSONArray;
+    formulas?: MeasureItemJSON[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/engines/get-data-source-fields/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/get-data-source-fields/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,8BAA8B,EAAE,GAAG,eAAe,EAAE,CAAC;IAC7D,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/get-data-source-fields/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,kCAAkC,mdAEiP,CAAC;AAEjS;;GAEG;AACH,eAAO,MAAM,yBAAyB;;iBAEpC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,8BAA8B,EAAE,GAAG,eAAe,EAAE,CAAC;IAC7D,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B"}