@sisense/mcp-server 0.2.9 → 0.3.0

package/dist/{sse-server-qhqncg7f.js → sse-server-yrjhgg0x.js}

@@ -12007,6 +12007,9 @@ function validateUrl(url, options = {}) {
   }
   return trimmed;
 }
+function generateArtifactId(type) {
+  return `${type}-${crypto.randomUUID().split("-")[0]}`;
+}
 function validateToken(token, options = {}) {
   const { maxLength = 2048, minLength = 1 } = options;
   if (typeof token !== "string") {
@@ -12022,4 +12025,4 @@ function validateToken(token, options = {}) {
   return trimmed;
 }
 
-export { require_dist_cjs54 as require_dist_cjs, toKebabCase, sanitizeForText, sanitizeForDescription, sanitizeError, validateUrl, validateToken };
+export { require_dist_cjs54 as require_dist_cjs, toKebabCase, sanitizeForText, sanitizeForDescription, sanitizeError, validateUrl, generateArtifactId, validateToken };

package/dist/sse-server.js

@@ -5,13 +5,14 @@ import {
   objectType
 } from "./sse-server-ss0mydv4.js";
 import {
+  generateArtifactId,
   require_dist_cjs as require_dist_cjs2,
   sanitizeError,
   sanitizeForDescription,
   sanitizeForText,
   validateToken,
   validateUrl
-} from "./sse-server-qhqncg7f.js";
+} from "./sse-server-yrjhgg0x.js";
 import {
   require_dist_cjs
 } from "./index-bgbnagw5.js";
@@ -29459,13 +29460,44 @@ function getSessionBaseUrl(sessionState) {
   return baseUrl;
 }
 
-// src/tools/build-chart.ts
-function isMcpAppEnabled() {
-  return process.env.TOOL_CHART_BUILDER_MCP_APP_ENABLED !== "false" && process.env.TOOL_CHART_BUILDER_MCP_APP_ENABLED !== "0";
+// src/utils/feature-flags.ts
+function parseBooleanParam(value) {
+  if (value === null)
+    return null;
+  const trimmed = value.trim().toLowerCase();
+  if (trimmed === "true" || trimmed === "1")
+    return true;
+  if (trimmed === "false" || trimmed === "0")
+    return false;
+  return null;
+}
+function resolveFeatureFlagsFromEnv() {
+  return {
+    mcpAppEnabled: process.env.MCP_APP_ENABLED !== "false" && process.env.MCP_APP_ENABLED !== "0",
+    toolBuildQueryEnabled: process.env.TOOL_BUILD_QUERY_ENABLED === "true" || process.env.TOOL_BUILD_QUERY_ENABLED === "1",
+    toolBuildChartNarrativeEnabled: process.env.TOOL_BUILD_CHART_NARRATIVE_ENABLED !== "false" && process.env.TOOL_BUILD_CHART_NARRATIVE_ENABLED !== "0"
+  };
+}
+function resolveFeatureFlagsFromUrl(url2) {
+  const env = resolveFeatureFlagsFromEnv();
+  return {
+    mcpAppEnabled: parseBooleanParam(url2.searchParams.get("mcpAppEnabled")) ?? env.mcpAppEnabled,
+    toolBuildQueryEnabled: parseBooleanParam(url2.searchParams.get("toolBuildQueryEnabled")) ?? env.toolBuildQueryEnabled,
+    toolBuildChartNarrativeEnabled: parseBooleanParam(url2.searchParams.get("toolBuildChartNarrativeEnabled")) ?? env.toolBuildChartNarrativeEnabled
+  };
+}
+function applyFeatureFlagsToSession(url2, state) {
+  state.set("featureFlags", resolveFeatureFlagsFromUrl(url2));
 }
-function isNarrativeEnabled() {
-  return process.env.TOOL_CHART_BUILDER_NARRATIVE_ENABLED !== "false" && process.env.TOOL_CHART_BUILDER_NARRATIVE_ENABLED !== "0";
+function getFeatureFlags(sessionState) {
+  const stored = sessionState?.get("featureFlags");
+  if (stored != null) {
+    return stored;
+  }
+  return resolveFeatureFlagsFromEnv();
 }
+
+// src/tools/build-chart.ts
 var baseOutputSchema = exports_external.object({
   success: exports_external.boolean(),
   chartId: exports_external.string().optional(),
@@ -29476,8 +29508,8 @@ var buildChartOutputSchemaAppMode = baseOutputSchema;
 var buildChartOutputSchemaToolMode = baseOutputSchema.extend({
   imageUrl: exports_external.string().optional()
 });
-function getBuildChartOutputSchema() {
-  return isMcpAppEnabled() ? buildChartOutputSchemaAppMode : buildChartOutputSchemaToolMode;
+function getBuildChartOutputSchema(flags) {
+  return flags.mcpAppEnabled ? buildChartOutputSchemaAppMode : buildChartOutputSchemaToolMode;
 }
 function getChartSummaries(sessionState) {
   return sessionState?.get("chart:summaries") ?? [];
@@ -29487,36 +29519,39 @@ function addChartSummary(sessionState, summary) {
   summaries.push(summary);
   sessionState?.set("chart:summaries", summaries);
 }
-async function buildChart(args, sessionState, requestId) {
+async function buildChart(args, sessionState) {
+  const { mcpAppEnabled, toolBuildChartNarrativeEnabled } = getFeatureFlags(sessionState);
   try {
-    const { dataSourceTitle, userPrompt } = args;
+    const { dataSourceTitle, userPrompt, queryId } = args;
     const httpClient = getSessionHttpClient(sessionState);
     const openAIClient = getSessionOpenAIClient(sessionState);
-    const toolCallId = String(requestId ? `chart-${requestId}` : `chart-${Date.now()}`);
+    const toolCallId = generateArtifactId("chart");
     const result = await csdkBrowserMock.withBrowserEnvironment(async () => {
-      const { buildChartEngine, runWithUserAction } = await import("./index-8027b2t7.js");
-      const { renderChartWidget } = await import("./widget-renderer-9rr9sfh8.js");
+      const { buildChartEngine, runWithUserAction } = await import("./index-xxces5vh.js");
+      const { renderChartWidget } = await import("./widget-renderer-hynpvfm9.js");
       const buildChartContext = {
         toolCallId,
         dataSourceTitle,
         chartSummaries: getChartSummaries(sessionState),
         retrieveChart: (id) => sessionState?.get(id) ?? null,
         saveChart: (id, props) => sessionState?.set(id, props),
+        retrieveQuery: (id) => sessionState?.get(`query-${id}`) ?? null,
+        onInternalQueryResult: (result2) => sessionState?.set(`query-${result2.queryId}`, result2),
         isNlqV3Enabled: true,
         httpClient,
-        openAIClient
+        openAIClient,
+        ...queryId != null && { queryId }
       };
-      const chartSummary2 = await runWithUserAction("MCP", "ASSISTANT", () => buildChartEngine({ dataSourceTitle, userPrompt }, buildChartContext));
+      const chartSummary2 = await runWithUserAction("MCP", "ASSISTANT", () => buildChartEngine({ dataSourceTitle, userPrompt, queryId: queryId ?? undefined }, buildChartContext));
       console.info(">>> CHART SUMMARY", chartSummary2);
       addChartSummary(sessionState, chartSummary2);
       const savedProps = sessionState?.get(chartSummary2.chartId);
       if (savedProps) {
         const sisenseUrl = getSessionSisenseUrl(sessionState);
         const sisenseToken = getSessionSisenseToken(sessionState);
-        const narrativeEnabled = isNarrativeEnabled();
         const { getNlgInsightsFromWidget } = await import("./ai-w2gkxdn7.js");
-        const insightsPromise = narrativeEnabled && httpClient ? getNlgInsightsFromWidget(savedProps, httpClient, { verbosity: "High" }) : Promise.resolve(undefined);
-        const renderPromise = isMcpAppEnabled() ? Promise.resolve(null) : renderChartWidget({
+        const insightsPromise = toolBuildChartNarrativeEnabled && httpClient ? getNlgInsightsFromWidget(savedProps, httpClient, { verbosity: "High" }) : Promise.resolve(undefined);
+        const renderPromise = mcpAppEnabled ? Promise.resolve(null) : renderChartWidget({
           widgetProps: savedProps,
           sisenseUrl,
           sisenseToken,
@@ -29534,14 +29569,14 @@ async function buildChart(args, sessionState, requestId) {
           console.warn("Failed to generate NLG insights:", sanitized.message);
         }
         let imageUrl2;
-        if (!isMcpAppEnabled() && renderResult.status === "fulfilled" && renderResult.value) {
+        if (!mcpAppEnabled && renderResult.status === "fulfilled" && renderResult.value) {
           imageUrl2 = renderResult.value.content[0]?.text;
-        } else if (!isMcpAppEnabled() && renderResult.status === "rejected") {
+        } else if (!mcpAppEnabled && renderResult.status === "rejected") {
           const sanitized = sanitizeError(renderResult.reason);
           console.warn("Failed to render chart widget:", sanitized.message);
         }
         const serializedWidgetProps = ni.serialize(savedProps);
-        if (isMcpAppEnabled() && sisenseUrl && sisenseToken) {
+        if (mcpAppEnabled && sisenseUrl && sisenseToken) {
           sessionState?.set(`chart:payload:${chartSummary2.chartId}`, {
             sisenseUrl,
             sisenseToken,
@@ -29571,8 +29606,8 @@ async function buildChart(args, sessionState, requestId) {
       success: true,
       chartId: chartSummary.chartId,
       message: chartSummary.message || `Chart created successfully for query: "${userPrompt}"`,
-      ...isNarrativeEnabled() && insights != null ? { insights } : {},
-      ...isMcpAppEnabled() ? {} : { imageUrl }
+      ...toolBuildChartNarrativeEnabled && insights != null ? { insights } : {},
+      ...mcpAppEnabled ? {} : { imageUrl }
     };
     const finalOutput = {
       content: [
@@ -29590,8 +29625,8 @@ async function buildChart(args, sessionState, requestId) {
       success: false,
       chartId: undefined,
       message: `Failed to create chart: ${errorMessage}`,
-      ...isNarrativeEnabled() ? { insights: undefined } : {},
-      ...isMcpAppEnabled() ? {} : { imageUrl: undefined }
+      ...toolBuildChartNarrativeEnabled ? { insights: undefined } : {},
+      ...mcpAppEnabled ? {} : { imageUrl: undefined }
     };
     return {
       content: [
@@ -29606,6 +29641,55 @@ async function buildChart(args, sessionState, requestId) {
   }
 }
 
+// src/tools/build-query.ts
+var buildQueryOutputSchema = exports_external.object({
+  success: exports_external.boolean(),
+  queryId: exports_external.string().optional(),
+  title: exports_external.string().optional(),
+  message: exports_external.string(),
+  dataset: exports_external.unknown().optional()
+});
+async function buildQuery(args, sessionState) {
+  try {
+    const { dataSourceTitle, queryPrompt } = args;
+    const httpClient = getSessionHttpClient(sessionState);
+    const toolCallId = generateArtifactId("query");
+    const { queryId, title, dataset } = await csdkBrowserMock.withBrowserEnvironment(async () => {
+      const { buildQueryEngine, toQuerySummary, runWithUserAction } = await import("./index-xxces5vh.js");
+      const queryResult = await runWithUserAction("MCP", "ASSISTANT", () => buildQueryEngine({ dataSourceTitle, queryPrompt }, { toolCallId, httpClient }));
+      sessionState?.set(`query-${queryResult.queryId}`, queryResult);
+      const summary = toQuerySummary(queryResult, true);
+      return { queryId: summary.queryId, title: summary.title, dataset: summary.dataset };
+    });
+    const output = {
+      success: true,
+      queryId,
+      title,
+      message: `Query executed successfully for: "${queryPrompt}"`,
+      dataset
+    };
+    return {
+      content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+      structuredContent: output
+    };
+  } catch (error40) {
+    const sanitized = sanitizeError(error40, true);
+    console.error("buildQuery failed:", sanitized.message);
+    if (sanitized.stack) {
+      console.error(sanitized.stack);
+    }
+    const output = {
+      success: false,
+      message: `Failed to execute query: ${sanitized.message}`
+    };
+    return {
+      content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+      structuredContent: output,
+      isError: true
+    };
+  }
+}
+
 // src/tools/get-data-sources.ts
 var getDataSourcesOutputSchema = {
   dataSources: exports_external.array(exports_external.any())
@@ -29613,7 +29697,7 @@ var getDataSourcesOutputSchema = {
 async function getDataSources(_args, sessionState) {
   try {
     const httpClient = getSessionHttpClient(sessionState);
-    const { getDataSourcesEngine } = await import("./index-8027b2t7.js");
+    const { getDataSourcesEngine } = await import("./index-xxces5vh.js");
     const getDataSourcesContext = {
       toolCallId: "get-data-sources",
       httpClient
@@ -29657,7 +29741,7 @@ async function getDataSourceFields(args, sessionState) {
   const { dataSourceTitle } = args;
   try {
     const httpClient = getSessionHttpClient(sessionState);
-    const { getDataSourceFieldsEngine } = await import("./index-8027b2t7.js");
+    const { getDataSourceFieldsEngine } = await import("./index-xxces5vh.js");
     const getDataSourceFieldsContext = {
       toolCallId: "get-data-source-fields",
       httpClient
@@ -29926,9 +30010,6 @@ var __dirname2 = path.dirname(fileURLToPath(import.meta.url));
 var isSource = import.meta.url.endsWith(".ts");
 var DIST_DIR = isSource ? path.join(__dirname2, "..", "dist") : __dirname2;
 var ANALYTICS_RESOURCE_URI = "ui://sisense-analytics/view.html";
-function isMcpAppEnabled2() {
-  return process.env.TOOL_CHART_BUILDER_MCP_APP_ENABLED !== "false" && process.env.TOOL_CHART_BUILDER_MCP_APP_ENABLED !== "0";
-}
 function getCspMeta(sessionState) {
   const sisenseUrl = sessionState?.get("sisenseUrl")?.trim() ?? process.env.SISENSE_URL?.trim();
   const connectDomains = sisenseUrl ? [sisenseUrl] : [];
@@ -29947,14 +30028,18 @@ var noOpValidator = {
 };
 async function setupMcpServer(sessionState) {
   try {
+    const { mcpAppEnabled, toolBuildQueryEnabled } = getFeatureFlags(sessionState);
     const {
       TOOL_NAME_CHART_BUILDER,
+      TOOL_NAME_BUILD_QUERY,
       TOOL_NAME_GET_DATA_SOURCE_FIELDS,
       TOOL_NAME_GET_DATA_SOURCES,
       getDataSourcesSchema,
       getDataSourceFieldsSchema,
-      buildChartSchema
-    } = await import("./index-8027b2t7.js");
+      buildChartSchema,
+      buildChartSchemaNaturalConversation,
+      buildQuerySchema
+    } = await import("./index-xxces5vh.js");
     const server = new McpServer({
       name: "sisense-mcp-server",
       version: "1.0.0"
@@ -29977,22 +30062,33 @@ async function setupMcpServer(sessionState) {
     }, async (args) => {
       return await getDataSourceFields(args, sessionState);
     });
-    const buildChartOutputSchema = getBuildChartOutputSchema();
-    if (isMcpAppEnabled2()) {
+    if (toolBuildQueryEnabled) {
+      server.registerTool(TOOL_NAME_BUILD_QUERY, {
+        title: "Execute Sisense Analytics Query",
+        description: "Converts a natural language question into an analytics query for a Sisense data source, executes it, and returns the resulting dataset and a queryId. Use the queryId when calling buildChart to visualize the results without re-running the query.",
+        inputSchema: buildQuerySchema.shape,
+        outputSchema: buildQueryOutputSchema.shape
+      }, async (args) => {
+        return await buildQuery(args, sessionState);
+      });
+    }
+    const buildChartOutputSchema = getBuildChartOutputSchema(getFeatureFlags(sessionState));
+    const chartInputSchema = toolBuildQueryEnabled ? buildChartSchemaNaturalConversation : buildChartSchema;
+    if (mcpAppEnabled) {
       hZ(server, TOOL_NAME_CHART_BUILDER, {
         title: "Build Sisense Chart from User Prompt",
         description: "Build a chart from a Sisense data source using natural language user prompt. Chart type will be automatically determined by Sisense AI based on the user prompt.",
-        inputSchema: buildChartSchema.shape,
+        inputSchema: chartInputSchema.shape,
         outputSchema: buildChartOutputSchema.shape,
         _meta: { ui: { resourceUri: ANALYTICS_RESOURCE_URI } }
-      }, async (args, extra) => {
-        return await buildChart(args, sessionState, extra.requestId);
+      }, async (args) => {
+        return await buildChart(args, sessionState);
       });
     } else {
       server.registerTool(TOOL_NAME_CHART_BUILDER, {
         title: "Build Sisense Chart from User Prompt",
         description: "Build a chart from a Sisense data source using natural language user prompt. Chart type will be automatically determined by Sisense AI based on the user prompt.",
-        inputSchema: buildChartSchema.shape,
+        inputSchema: chartInputSchema.shape,
         outputSchema: buildChartOutputSchema.shape
       }, async (args) => {
         return await buildChart(args, sessionState);
@@ -30055,6 +30151,18 @@ var persistentStates = new Map;
 function getCredentialKey(sisenseUrl, sisenseToken) {
   return createHash("sha256").update(`${sisenseUrl}:${sisenseToken}`).digest("hex").slice(0, 16);
 }
+function resetConversationState(existingState, req) {
+  const freshState = new Map(existingState);
+  for (const key of freshState.keys()) {
+    if (key === "chart:summaries" || typeof key === "string" && (key.startsWith("chart-") || key.startsWith("query-"))) {
+      freshState.delete(key);
+    }
+  }
+  const protocol = req.headers["x-forwarded-proto"] || "http";
+  const host = req.headers["x-forwarded-host"] || req.headers.host;
+  freshState.set("baseUrl", `${protocol}://${host}`);
+  return freshState;
+}
 var server = createServer(async (req, res) => {
   const url2 = new URL(req.url || "/", `http://${req.headers.host}`);
   if (url2.pathname === "/health" && req.method === "GET") {
@@ -30147,7 +30255,8 @@ var server = createServer(async (req, res) => {
           const credKey = getCredentialKey(sisenseUrl, sisenseToken);
           const existingState = persistentStates.get(credKey);
           if (existingState) {
-            state = existingState;
+            state = resetConversationState(existingState, req);
+            persistentStates.set(credKey, state);
           } else {
             try {
               const validatedUrl = validateUrl(sisenseUrl, {
@@ -30170,7 +30279,7 @@ var server = createServer(async (req, res) => {
                 createOpenAIClient,
                 initializeHttpClient,
                 initializeOpenAIClient
-              } = await import("./index-8027b2t7.js");
+              } = await import("./index-xxces5vh.js");
               const httpClient = createHttpClientFromConfig({
                 url: validatedUrl,
                 token: validatedToken
@@ -30215,6 +30324,7 @@ var server = createServer(async (req, res) => {
             sessions.delete(transport.sessionId);
           }
         };
+        applyFeatureFlagsToSession(url2, state);
         const mcpServer = await setupMcpServer(state);
         await mcpServer.connect(transport);
       } else {
@@ -30265,6 +30375,9 @@ initializeSisenseClients().then(() => {
     console.log(`  http://localhost:${PORT}/mcp?sisenseUrl=<SISENSE_URL>&sisenseToken=<SISENSE_TOKEN>`);
     console.log("  Or set SISENSE_URL and SISENSE_TOKEN in the environment and use http://localhost:" + `${PORT}/mcp`);
     console.log("");
+    console.log("Optional feature-flag query params (override env vars per connection):");
+    console.log("  mcpAppEnabled=true|false, toolBuildQueryEnabled=true|false, toolBuildChartNarrativeEnabled=true|false");
+    console.log("");
     console.log("Endpoints:");
     console.log(`  Health: http://localhost:${PORT}/health`);
     console.log(`  Screenshots: http://localhost:${PORT}/screenshots/`);

package/dist/{widget-renderer-9rr9sfh8.js → widget-renderer-hynpvfm9.js}

@@ -2,7 +2,7 @@ import {
   require_dist_cjs as require_dist_cjs2,
   sanitizeError,
   toKebabCase
-} from "./sse-server-qhqncg7f.js";
+} from "./sse-server-yrjhgg0x.js";
 import {
   require_dist_cjs
 } from "./index-bgbnagw5.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sisense/mcp-server",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "mcpName": "io.github.sisense/sisense-mcp-server",
   "homepage": "https://github.com/sisense/sisense-mcp-server#readme",
   "description": "MCP server leveraging Sisense Intelligence for actionable insights and analytics.",
@@ -51,7 +51,7 @@
     "@modelcontextprotocol/sdk": "1.29.0",
     "@playwright/experimental-ct-react": "^1.56.1",
     "@playwright/test": "^1.56.1",
-    "@sisense/sdk-ai-core": "0.6.2",
+    "@sisense/sdk-ai-core": "0.6.3",
     "@sisense/sdk-data": "2.24.0",
     "@sisense/sdk-ui": "2.24.0",
     "playwright": "^1.56.1",