@sisense/sdk-ai-core 0.8.0 → 0.10.1

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

@@ -1,18 +1,31 @@
 import { z } from 'zod';
 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;
+    priorQueryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     dataSourceTitle: string;
     queryPrompt: string;
+    priorQueryId?: string | null | undefined;
 }, {
     dataSourceTitle: string;
     queryPrompt: string;
+    priorQueryId?: string | null | undefined;
 }>;
 /**
  * Context interface for buildQueryEngine
@@ -22,19 +35,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,KAAK,CAAC;AACxB,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;;;;;;;;;;;;EAgB3B,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.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,KAAK,CAAC;AAExB,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,6 +1,11 @@
 import { z } from 'zod';
 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
  */

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,KAAK,CAAC;AACxB,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,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"}

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,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;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,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"}

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

@@ -2,6 +2,11 @@ import { z } from 'zod';
 import { DataSourceField, JSONArray } from '@sisense/sdk-data';
 import { HttpClient } from '@sisense/sdk-rest-client';
 import { DataSourceFieldWithDescription } from '../../services/data-sources/data-sources-service';
+/**
+ * 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
  */

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,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;;;GAGG;AACH,eAAO,MAAM,kCAAkC,mdAEiP,CAAC;AAEjS;;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"}

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

@@ -1 +1 @@
-{"version":3,"file":"get-data-sources-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/get-data-sources/get-data-sources-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACN,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EAC5C,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}
+{"version":3,"file":"get-data-sources-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/get-data-sources/get-data-sources-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACN,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,MAAM,SAAS,CAAC;AAIjB;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EAC5C,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAe5B"}

package/dist/engines/get-data-sources/types.d.ts

@@ -1,6 +1,11 @@
 import { z } from 'zod';
-import { JaqlDataSourceForDto } from '@sisense/sdk-data';
 import { HttpClient } from '@sisense/sdk-rest-client';
+import { DataSourceWithStatus } from '../../services/data-sources/data-sources-service';
+/**
+ * Canonical tool description for getDataSources — 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 getDataSourcesToolDescription = "Get the available data sources / data models. \"Data sources\" and \"data models\" are the SAME entity \u2014 this is the only discovery tool for both.\n\nBefore promising the user that queries, charts, dashboards, or query recommendations will work on a source, use this tool (or rely on a fresh result from the current conversation) to see what exists and whether each item is ready to query or still a draft.\n\nReturns:\n- dataSourceTitles: every source the user has access to (ready + draft)\n- draftDataSourceTitles: subset that are DRAFT (existing data models that have never been built \u2014 present in metadata but no successful build yet)\n- dataSources: array of { title, oid, status, live }, where:\n    * oid is the ELASTICUBE DATAMODEL UUID \u2014 pass this as datamodelOid to getModelSchema, addRelation, createPerspective, updatePerspective, listPerspectives, triggerBuild. NEVER pass the title as datamodelOid.\n    * status is 'ready' (built/queryable) or 'draft' (not built yet)\n    * live is true for live/external connections (Snowflake, BigQuery, etc.) \u2014 these are NOT elasticubes and have no oid; they cannot be used with schema/perspective tools.\n\nWorkflow rules for drafts:\n- DRAFTS CANNOT BE QUERIED. Do NOT call buildQuery, buildChart, buildDashboard, or recommendQueries on a draft \u2014 the query endpoints will reject it.\n- Drafts CAN be inspected (getModelSchema), have relations edited (addRelation), and have perspectives listed/created (listPerspectives, createPerspective) \u2014 these are metadata operations.\n- \"Show me / view / explore [draft model name]\" \u2192 call getModelSchema with that entry's oid IMMEDIATELY. Do not ask the user \"schema or build?\" \u2014 just render the diagram. Only block on QUERY actions.\n- If the user asks to query/chart/analyze a draft, tell them it must be built first and offer to call triggerBuild.\n\nWhen listing sources to the user, mark drafts explicitly (e.g. \"Sales DB (draft \u2014 not built yet)\").";
 /**
  * Schema for getDataSources engine parameters
  */
@@ -20,12 +25,16 @@ export interface GetDataSourcesContext {
  */
 export interface DataSourcesResult {
     /**
-     * List of data source titles
+     * List of data source titles (includes both ready and draft)
      */
     dataSourceTitles: string[];
     /**
-     * Full data source objects
+     * Subset of titles that are draft (existing models that have never been built — not queryable yet)
+     */
+    draftDataSourceTitles: string[];
+    /**
+     * Full data source objects with `status: 'ready' | 'draft'` marker
      */
-    dataSources: JaqlDataSourceForDto[];
+    dataSources: DataSourceWithStatus[];
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/get-data-sources/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,oBAAoB,gDAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B;;OAEG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/get-data-sources/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,o9DAkB0D,CAAC;AAErG;;GAEG;AACH,eAAO,MAAM,oBAAoB,gDAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B;;OAEG;IACH,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC;;OAEG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACpC"}

package/dist/engines/index.d.ts

@@ -10,4 +10,6 @@ export * from './get-dashboards';
 export * from './build-dashboard';
 export * from './recommend-queries';
 export * from './build-data-model';
+export * from './manage-perspectives';
+export * from './build-csv-model';
 //# sourceMappingURL=index.d.ts.map

package/dist/engines/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,cAAc,qBAAqB,CAAC;AAGpC,cAAc,eAAe,CAAC;AAG9B,cAAc,mCAAmC,CAAC;AAGlD,OAAO,EACN,yBAAyB,EACzB,uBAAuB,GACvB,MAAM,kDAAkD,CAAC;AAG1D,cAAc,oBAAoB,CAAC;AAGnC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,cAAc,qBAAqB,CAAC;AAGpC,cAAc,eAAe,CAAC;AAG9B,cAAc,mCAAmC,CAAC;AAGlD,OAAO,EACN,yBAAyB,EACzB,uBAAuB,GACvB,MAAM,kDAAkD,CAAC;AAG1D,cAAc,oBAAoB,CAAC;AAGnC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,mBAAmB,CAAC"}

package/dist/engines/manage-perspectives/index.d.ts

@@ -0,0 +1,3 @@
+export { listDataModelsEngine, getModelSchemaEngine, addRelationEngine, removeRelationEngine, createPerspectiveEngine, updatePerspectiveEngine, getPerspectiveEngine, triggerBuildEngine, listPerspectivesEngine, } from './manage-perspectives-engine';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/engines/manage-perspectives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/manage-perspectives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,8BAA8B,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/dist/engines/manage-perspectives/manage-perspectives-engine.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { listDataModelsParamsSchema, getModelSchemaParamsSchema, addRelationParamsSchema, removeRelationParamsSchema, createPerspectiveParamsSchema, updatePerspectiveParamsSchema, getPerspectiveParamsSchema, triggerBuildParamsSchema, listPerspectivesParamsSchema, ListDataModelsResult, ModelSchemaResult, AddRelationResult, RemoveRelationResult, CreatePerspectiveResult, UpdatePerspectiveResult, GetPerspectiveResult, TriggerBuildResult, ListPerspectivesResult, PerspectiveEngineContext } from './types';
+export declare function listDataModelsEngine(_params: z.infer<typeof listDataModelsParamsSchema>, context: PerspectiveEngineContext): Promise<ListDataModelsResult>;
+export declare function getModelSchemaEngine(params: z.infer<typeof getModelSchemaParamsSchema>, context: PerspectiveEngineContext): Promise<ModelSchemaResult>;
+export declare function addRelationEngine(params: z.infer<typeof addRelationParamsSchema>, context: PerspectiveEngineContext): Promise<AddRelationResult>;
+export declare function removeRelationEngine(params: z.infer<typeof removeRelationParamsSchema>, context: PerspectiveEngineContext): Promise<RemoveRelationResult>;
+export declare function createPerspectiveEngine(params: z.infer<typeof createPerspectiveParamsSchema>, context: PerspectiveEngineContext): Promise<CreatePerspectiveResult>;
+export declare function updatePerspectiveEngine(params: z.infer<typeof updatePerspectiveParamsSchema>, context: PerspectiveEngineContext): Promise<UpdatePerspectiveResult>;
+export declare function getPerspectiveEngine(params: z.infer<typeof getPerspectiveParamsSchema>, context: PerspectiveEngineContext): Promise<GetPerspectiveResult>;
+export declare function listPerspectivesEngine(params: z.infer<typeof listPerspectivesParamsSchema>, context: PerspectiveEngineContext): Promise<ListPerspectivesResult>;
+export declare function triggerBuildEngine(params: z.infer<typeof triggerBuildParamsSchema>, context: PerspectiveEngineContext): Promise<TriggerBuildResult>;
+//# sourceMappingURL=manage-perspectives-engine.d.ts.map

package/dist/engines/manage-perspectives/manage-perspectives-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-perspectives-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/manage-perspectives/manage-perspectives-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,OAAO,EACN,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,MAAM,SAAS,CAAC;AAgGjB,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EACnD,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CA+B/B;AAED,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EAClD,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAyC5B;AAED,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,EAC/C,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAwF5B;AA8ED,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EAClD,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CA4G/B;AAED,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,EACrD,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAgDlC;AAiFD,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,EACrD,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAalC;AAED,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EAClD,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAyC/B;AAED,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,EACpD,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA0CjC;AAED,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EAChD,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAuB7B"}

package/dist/engines/manage-perspectives/types.d.ts

@@ -0,0 +1,367 @@
+import { z } from 'zod';
+import { HttpClient } from '@sisense/sdk-rest-client';
+export declare const listDataModelsParamsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export interface DataModelSummary {
+    oid: string;
+    title: string;
+    type: string;
+    lastBuildTime: string | null;
+}
+export interface ListDataModelsResult {
+    models: DataModelSummary[];
+}
+export declare const getModelSchemaParamsSchema: z.ZodObject<{
+    datamodelOid: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    datamodelOid: string;
+}, {
+    datamodelOid: string;
+}>;
+export interface ModelColumn {
+    oid: string;
+    name: string;
+    type: number;
+}
+export interface ModelTable {
+    oid: string;
+    name: string;
+    datasetOid: string;
+    columns: ModelColumn[];
+}
+export interface ModelRelation {
+    oid: string;
+    tables: string[];
+}
+export interface ModelSchemaResult {
+    datamodelOid: string;
+    title: string;
+    tables: ModelTable[];
+    relations: ModelRelation[];
+}
+export declare const createPerspectiveParamsSchema: z.ZodObject<{
+    datamodelOid: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tables: z.ZodArray<z.ZodObject<{
+        oid: z.ZodString;
+        diffType: z.ZodEnum<["include", "exclude"]>;
+        columnsDiff: z.ZodArray<z.ZodObject<{
+            oid: z.ZodString;
+            enabled: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            oid: string;
+        }, {
+            enabled: boolean;
+            oid: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        oid: string;
+        diffType: "include" | "exclude";
+        columnsDiff: {
+            enabled: boolean;
+            oid: string;
+        }[];
+    }, {
+        oid: string;
+        diffType: "include" | "exclude";
+        columnsDiff: {
+            enabled: boolean;
+            oid: string;
+        }[];
+    }>, "many">;
+    relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        oid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        oid: string;
+    }, {
+        oid: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    tables: {
+        oid: string;
+        diffType: "include" | "exclude";
+        columnsDiff: {
+            enabled: boolean;
+            oid: string;
+        }[];
+    }[];
+    datamodelOid: string;
+    description?: string | undefined;
+    relations?: {
+        oid: string;
+    }[] | undefined;
+}, {
+    name: string;
+    tables: {
+        oid: string;
+        diffType: "include" | "exclude";
+        columnsDiff: {
+            enabled: boolean;
+            oid: string;
+        }[];
+    }[];
+    datamodelOid: string;
+    description?: string | undefined;
+    relations?: {
+        oid: string;
+    }[] | undefined;
+}>;
+export interface CreatePerspectiveResult {
+    perspectiveOid: string;
+    name: string;
+    datamodelOid: string;
+    tableCount: number;
+    columnCount: number;
+}
+export declare const addRelationParamsSchema: z.ZodObject<{
+    datamodelOid: z.ZodString;
+    source: z.ZodObject<{
+        dataset: z.ZodString;
+        table: z.ZodString;
+        column: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        table: string;
+        column: string;
+        dataset: string;
+    }, {
+        table: string;
+        column: string;
+        dataset: string;
+    }>;
+    target: z.ZodObject<{
+        dataset: z.ZodString;
+        table: z.ZodString;
+        column: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        table: string;
+        column: string;
+        dataset: string;
+    }, {
+        table: string;
+        column: string;
+        dataset: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    source: {
+        table: string;
+        column: string;
+        dataset: string;
+    };
+    datamodelOid: string;
+    target: {
+        table: string;
+        column: string;
+        dataset: string;
+    };
+}, {
+    source: {
+        table: string;
+        column: string;
+        dataset: string;
+    };
+    datamodelOid: string;
+    target: {
+        table: string;
+        column: string;
+        dataset: string;
+    };
+}>;
+export interface AddRelationResult {
+    relationOid: string;
+    datamodelOid: string;
+}
+export declare const removeRelationParamsSchema: z.ZodObject<{
+    datamodelOid: z.ZodString;
+    relationOid: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    datamodelOid: string;
+    relationOid: string;
+}, {
+    datamodelOid: string;
+    relationOid: string;
+}>;
+export interface RemoveRelationResult {
+    relationOid: string;
+    datamodelOid: string;
+}
+export declare const updatePerspectiveParamsSchema: z.ZodObject<{
+    perspectiveOid: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        oid: z.ZodString;
+        diffType: z.ZodEnum<["include", "exclude"]>;
+        columnsDiff: z.ZodArray<z.ZodObject<{
+            oid: z.ZodString;
+            enabled: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            oid: string;
+        }, {
+            enabled: boolean;
+            oid: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        oid: string;
+        diffType: "include" | "exclude";
+        columnsDiff: {
+            enabled: boolean;
+            oid: string;
+        }[];
+    }, {
+        oid: string;
+        diffType: "include" | "exclude";
+        columnsDiff: {
+            enabled: boolean;
+            oid: string;
+        }[];
+    }>, "many">>;
+    relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        oid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        oid: string;
+    }, {
+        oid: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    perspectiveOid: string;
+    description?: string | undefined;
+    name?: string | undefined;
+    tables?: {
+        oid: string;
+        diffType: "include" | "exclude";
+        columnsDiff: {
+            enabled: boolean;
+            oid: string;
+        }[];
+    }[] | undefined;
+    relations?: {
+        oid: string;
+    }[] | undefined;
+}, {
+    perspectiveOid: string;
+    description?: string | undefined;
+    name?: string | undefined;
+    tables?: {
+        oid: string;
+        diffType: "include" | "exclude";
+        columnsDiff: {
+            enabled: boolean;
+            oid: string;
+        }[];
+    }[] | undefined;
+    relations?: {
+        oid: string;
+    }[] | undefined;
+}>;
+export interface UpdatePerspectiveResult {
+    perspectiveOid: string;
+    updated: boolean;
+}
+export declare const getPerspectiveParamsSchema: z.ZodObject<{
+    perspectiveOid: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    perspectiveOid: string;
+}, {
+    perspectiveOid: string;
+}>;
+export interface GetPerspectiveResult {
+    perspectiveOid: string;
+    name: string;
+    description: string;
+    datamodelOid: string;
+    tables: Array<{
+        oid: string;
+        diffType: 'include' | 'exclude';
+        columnsDiff: Array<{
+            oid: string;
+            enabled: boolean;
+        }>;
+    }>;
+    relations: Array<{
+        oid: string;
+    }>;
+    isDefault?: boolean;
+}
+export declare const triggerBuildParamsSchema: z.ZodObject<{
+    datamodelOid: z.ZodString;
+    wait: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    datamodelOid: string;
+    wait?: boolean | undefined;
+}, {
+    datamodelOid: string;
+    wait?: boolean | undefined;
+}>;
+export interface TriggerBuildResult {
+    datamodelOid: string;
+    buildOid: string;
+    status: 'queued' | 'done' | 'failed' | 'timeout';
+    durationMs?: number;
+}
+export declare const listPerspectivesParamsSchema: z.ZodObject<{
+    datamodelOid: z.ZodOptional<z.ZodString>;
+    includeDefault: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    datamodelOid?: string | undefined;
+    includeDefault?: boolean | undefined;
+}, {
+    datamodelOid?: string | undefined;
+    includeDefault?: boolean | undefined;
+}>;
+export interface PerspectiveSummary {
+    perspectiveOid: string;
+    name: string;
+    description: string;
+    datamodelOid: string;
+    tableCount: number;
+    isDefault: boolean;
+    lastUpdated?: string;
+}
+export interface ListPerspectivesResult {
+    perspectives: PerspectiveSummary[];
+}
+export interface PerspectiveEngineContext {
+    toolCallId: string;
+    httpClient?: HttpClient;
+}
+/**
+ * Canonical tool description for listDataModels — reusable by any host.
+ * When getDataSources is also registered, prefer getDataSources for discovery (it includes drafts and live sources); use this tool for Elasticube-only model lists if needed.
+ */
+export declare const listDataModelsToolDescription = "Lists all Sisense data models (Elasticubes) available in the instance. Data models and data sources overlap in Sisense \u2014 when getDataSources is available, prefer it for unified discovery.\n\nReturns each model's OID (UUID), title, and type. At the start of a perspective workflow, call this as the ONLY tool in the turn if you use it \u2014 never use an OID from memory, prior context, or examples. After it returns, present the model list and stop; wait for the user to pick a model before calling getModelSchema. Do NOT chain into getModelSchema in the same turn.";
+/**
+ * Canonical tool description for getModelSchema — reusable by any host.
+ */
+export declare const getModelSchemaToolDescription = "Fetches the full schema of a Sisense data model: all tables with their OIDs and columns (with OIDs and types), plus all relation OIDs.\n\nIMPORTANT: The datamodelOid parameter MUST be a UUID \u2014 use the `oid` field from a `getDataSources` or `listDataModels` result in the current conversation. Never use an OID from memory, context, or examples. Perspective OIDs and legacy datasource string IDs (e.g. \"localhost_aSampleECommerce\") are NOT valid here.\n\nThis is the canonical \"show / explore / view / open the data model\" action (including drafts for inspection). When the user picks a model or uses those verbs about a specific model by name, use the model's oid from the latest getDataSources result. Do not ask \"schema or build?\" for a simple show-model request. Do not use getDataSourceFields as the default exploration action \u2014 that returns a flat field list, not the model diagram.\n\nThis is step 2 of the perspective workflow. After this returns, propose 2-4 concrete perspective ideas (each with: name, tables included, columns hidden, intended audience) and ASK the user which one to create. STOP and wait \u2014 do NOT call createPerspective in the same turn.\n\nPerspective workflow pacing: prefer one major conversational step per assistant reply where possible \u2014 list what exists, inspect and discuss the schema with the user, agree on a design, then call createPerspective in a later focused turn once choices are clear (rather than jumping from first discovery straight to creation in one reply when the user has not confirmed direction).";
+/**
+ * Canonical tool description for addRelation — reusable by any host.
+ */
+export declare const addRelationToolDescription = "Creates a join relationship between two tables in a Sisense data model.\n\nCall getModelSchema first \u2014 all three IDs (dataset, table, column) must be UUIDs from that response.\nSource = the \"many\" side (fact/transaction table with the FK column).\nTarget = the \"one\" side (dimension/lookup table with the PK column).\n\nCall once per join. The host may refresh the model diagram as each addRelation succeeds.\n\nAfter all addRelation calls succeed in a turn, briefly summarize the joins you created and ASK the user whether to trigger a build now (so the new joins become queryable). Do NOT call triggerBuild automatically \u2014 it requires explicit user agreement.";
+/**
+ * Canonical tool description for removeRelation — reusable by any host.
+ */
+export declare const removeRelationToolDescription = "Removes a join relationship from a Sisense data model.\n\nCall getModelSchema first to obtain the relations[].oid you want to remove. Pass that as relationOid; the engine validates it exists on the given datamodelOid before sending the mutation.\n\nCall once per relation. The host may refresh the model diagram as each removeRelation succeeds.\n\nAfter all removeRelation calls succeed in a turn, briefly summarize what you removed and ASK the user whether to trigger a build now. Do NOT call triggerBuild automatically \u2014 it requires explicit user agreement.";
+/**
+ * Canonical tool description for createPerspective — reusable by any host.
+ */
+export declare const createPerspectiveToolDescription = "Creates a new perspective (filtered sub-model) on a Sisense data model. This is step 3 \u2014 the final step \u2014 of the perspective workflow.\n\nFor a new perspective, work in stages: first discover models and wait for the user to pick one, then fetch schema and wait for design agreement, then call this tool in its own turn with OIDs from that schema \u2014 never skip discovery or schema in the same turn as create.\n\nCall getModelSchema first (step 2) to get exact table OIDs, column OIDs, and relation OIDs. Use ONLY OIDs from that schema response \u2014 never invent or guess OIDs.\n\nAfter the user picks a perspective option (or describes a custom one), call this tool IMMEDIATELY in the same turn. Do not ask further confirmation. The host typically opens an interactive diagram of the perspective \u2014 reply with a one-line confirmation; do not narrate the diagram in detail.\n\ndiffType rules:\n- \"include\": allowlist \u2014 only columns listed with enabled:true are visible. Use when exposing a small subset.\n- \"exclude\": denylist \u2014 all columns visible except those listed with enabled:false. Use when hiding a few sensitive columns.\n\ncolumnsDiff must never be empty \u2014 for \"include\" list every visible column with enabled:true; for \"exclude\" list at least one hidden column with enabled:false.\n\nInclude a relation OID only when both connected tables are in the perspective's tables list.";
+/**
+ * Canonical tool description for updatePerspective — reusable by any host.
+ */
+export declare const updatePerspectiveToolDescription = "Updates an existing Sisense PERSPECTIVE (a saved filtered sub-model / view). This tool does NOT modify the underlying data model \u2014 it only changes which tables/columns/relations a specific perspective exposes.\n\nDO NOT call this tool when the user asks to add, remove, or modify RELATIONS on the data model itself \u2014 that operates on the model, not on a perspective. (To add a relation, use addRelation. To remove a relation, use removeRelation.)\n\nSend only the fields you want to change:\n- To rename a perspective: pass only name.\n- To update column visibility within the perspective: pass the full tables array (it replaces the existing one).\n- To expose another existing table in the perspective: include all existing tables plus the new one in the tables array.\n\nAfter a successful update, call getPerspective with the same perspectiveOid in the next turn so the user sees the refreshed diagram.";
+/**
+ * Canonical tool description for getPerspective — reusable by any host.
+ */
+export declare const getPerspectiveToolDescription = "Fetches the current state of a Sisense perspective. The host typically renders an interactive diagram when supported.\n\nCall ONLY when the user references a specific perspective by name, asks to view/open/show that perspective, after listPerspectives when they pick one, or directly after a successful updatePerspective.\n\nDo NOT call as a follow-up to getModelSchema for a generic \"show me the model diagram\" \u2014 that is model-level (getModelSchema). Do NOT also call when the user only named the parent data model unless they named a perspective.\n\nThis always fetches fresh state from the server \u2014 never rely on cached args from prior tool calls.\n\nReply with a one-line confirmation; do not narrate the diagram in detail.";
+/**
+ * Canonical tool description for triggerBuild — reusable by any host.
+ */
+export declare const triggerBuildToolDescription = "Triggers a full build of a Sisense Elasticube and (by default) waits for it to finish.\n\nFull cube rebuilds are disruptive \u2014 long-running and they can block or delay query and chart use on that model until they finish. NEVER call without explicit user agreement in the current conversation.\n\nDESTRUCTIVE / EXPENSIVE: a build recomputes the entire cube and can take 20-90s for small CSV cubes (longer for big ones).\n\nWorkflow rule: after addRelation, table edits, or any other schema change, briefly summarize the change and ASK the user whether to build now. Do not call this tool until the user has explicitly said yes (\"yes, build\", \"go ahead\", \"rebuild now\", etc.). If the user said \"I'll build it myself\" or hasn't responded, do nothing.\n\nPass wait:false only if the user explicitly says \"kick off the build, don't wait\", otherwise leave wait undefined (defaults to true).\n\nConfirm completion in one short line (\"Build done in 32s.\") \u2014 do not narrate progress steps.";
+/**
+ * Canonical tool description for listPerspectives — reusable by any host.
+ */
+export declare const listPerspectivesToolDescription = "Lists Sisense perspectives. Use whenever the user asks to:\n- \"see / list / show me the perspectives\" (with or without a specific model)\n- \"what perspectives exist on this model\"\n- review existing perspectives before deciding to create / update / delete one\n\nPass datamodelOid to scope to a single model; omit it for a global list across every model the user has access to. Set includeDefault:false to hide the auto-generated Default perspectives.\n\nAfter the result, present the user with a short numbered/bulleted summary (name, table count, default vs custom) and ask which one they want to inspect \u2014 then call getPerspective to render its diagram.";
+//# sourceMappingURL=types.d.ts.map

package/dist/engines/manage-perspectives/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/manage-perspectives/types.ts"],"names":[],"mappings":"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"}

package/dist/engines/recommend-queries/recommend-queries-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommend-queries-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/recommend-queries/recommend-queries-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C,OAAO,EACN,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EAEtB,6BAA6B,EAG7B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,GAChB,SAAS,GAAG,SAAS,CAQvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,EAAE,GACxB,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAC9C,OAAO,EAAE,uBAAuB,EAChC,qBAAqB,CAAC,EAAE,6BAA6B,GACnD,OAAO,CAAC,sBAAsB,CAAC,CAoGjC"}
+{"version":3,"file":"recommend-queries-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/recommend-queries/recommend-queries-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EACN,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EAEtB,6BAA6B,EAG7B,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,GAChB,SAAS,GAAG,SAAS,CAQvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,EAAE,GACxB,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAC9C,OAAO,EAAE,uBAAuB,EAChC,qBAAqB,CAAC,EAAE,6BAA6B,GACnD,OAAO,CAAC,sBAAsB,CAAC,CAsGjC"}

package/dist/engines/recommend-queries/types.d.ts

@@ -2,6 +2,11 @@ import { z } from 'zod';
 import { WidgetProps, ChartType } from '@sisense/sdk-ui';
 import { HttpClient } from '@sisense/sdk-rest-client';
 import { OpenAI } from 'openai';
+/**
+ * Canonical tool description for recommendQueries — 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 recommendQueriesToolDescription = "Recommend natural language queries to ask on a data source based on explicit user prompt and context.\n\nIMPORTANT:\n- NEVER assume a data source title is valid. If no fresh getDataSources result exists in this conversation, call getDataSources first to validate the data source exists and is queryable (not draft), or ask the user to specify one.\n- Use userPrompt to filter and prioritize relevant recommendations (e.g. \"revenue dashboard\", \"sales analysis\").\n- Use existingWidgets to avoid duplicate recommendations when adding to existing dashboards.\n- Extract chart types from user prompts (e.g. \"bar chart\", \"line chart\") and pass through to chart generation when the host supports it.\n\nDo not call recommendQueries on a draft data model \u2014 drafts are not queryable until built.";
 /**
  * Default number of query recommendations to return
  */

package/dist/engines/recommend-queries/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/recommend-queries/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAkBjC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACzC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CAClB,GAAG,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,eAAe,EAAE,2BAA2B,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC3C,eAAe,EAAE,2BAA2B,EAAE,KAC1C,IAAI,CAAC;AAEV;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAYzD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/recommend-queries/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,+BAA+B,qyBAQ+C,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAkBjC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACzC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CAClB,GAAG,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,eAAe,EAAE,2BAA2B,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC3C,eAAe,EAAE,2BAA2B,EAAE,KAC1C,IAAI,CAAC;AAEV;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAYzD,CAAC"}