@databrainhq/mcp-server 0.2.2 → 0.2.4

package/dist/index.js

@@ -218,7 +218,7 @@ var DatabrainClient = class {
       throw new DatabrainApiError(
         401,
         "MISSING_API_TOKEN",
-        "A per-data-app API token is required for this embedding operation but none is configured. Use `setup_embed_interactive` with step `ensure_api_token` to create or set one, or call `create_api_token` / `set_api_token` directly. Do not ask the user for this token \u2014 create it via the MCP tools."
+        "A per-data-app API token is required for this embedding operation but none is configured. Call `create_api_token` to generate one, or `set_api_token` if you already have the value. Do not ask the user for this token \u2014 create it via the MCP tools."
       );
     }
     let url = `${this.config.apiUrl}${options.path}`;
@@ -1690,7 +1690,7 @@ Next: use \`generate_guest_token\` with the clientId and \`generate_embed_code\`
 - workspaceName: \`${body.workspaceName}\`
 - accessSettings.datamartName: \`${datamartName}\`
 
-Next: run \`get_embed_details\` and \`diagnose_embed_health\` to verify update compatibility.`
+Next: run \`get_embed_details\` to verify the embed configuration.`
         );
       } catch (err) {
         if (err instanceof DatabrainApiError) return err.toToolResponse();
@@ -2377,612 +2377,71 @@ Use \`get_embed_details\` to view the full current theme configuration.` + GUEST
   );
 }
 
-// src/tools/embed/configure-embed.ts
-import { z as z15 } from "zod";
-var stringFilterSchema = z15.object({
-  filterName: z15.string().describe("Name of the filter as it appears in the dashboard"),
-  options: z15.array(z15.object({
-    value: z15.string(),
-    label: z15.string()
-  })).describe("Dropdown options"),
-  defaultOption: z15.union([z15.string(), z15.array(z15.string())]).optional().describe("Default selected value (string or array for multi-select)")
-});
-var numberFilterSchema = z15.object({
-  filterName: z15.string().describe("Name of the filter"),
-  min: z15.number().describe("Minimum value"),
-  max: z15.number().describe("Maximum value")
-});
-var datePresetSchema = z15.object({
-  type: z15.string().optional().describe('Preset type (e.g. "Last", "This")'),
-  interval: z15.string().optional().describe('Interval (e.g. "Days", "Months", "Years")'),
-  timeGrain: z15.string().optional().describe("Time grain"),
-  label: z15.string().describe('Display label (e.g. "Last 30 Days")'),
-  startDate: z15.string().optional().describe("Start date (YYYY-MM-DD)"),
-  endDate: z15.string().optional().describe("End date (YYYY-MM-DD)")
-});
-var dateFilterSchema = z15.object({
-  filterName: z15.string().describe("Name of the filter"),
-  startDate: z15.string().optional().describe("Default start date (YYYY-MM-DD)"),
-  endDate: z15.string().optional().describe("Default end date (YYYY-MM-DD)"),
-  datePresetOptions: z15.array(datePresetSchema).optional().describe("Custom date presets to show in the date picker")
-});
-var sqlFilterSchema = z15.object({
-  filterName: z15.string().describe("Name of the filter"),
-  sql: z15.string().describe("SQL query to fetch filter options"),
-  columnName: z15.string().describe("Column from the SQL result to use as option values")
-});
-var SUPPORTED_LANGUAGES = [
-  "en",
-  "fr",
-  "es",
-  "de",
-  "it",
-  "pt",
-  "zh",
-  "ja",
-  "ko",
-  "hi",
-  "ar",
-  "ru"
-];
-function registerConfigureEmbed(server, client) {
-  const services = createServiceBundle(client);
-  server.tool(
-    "configure_embed",
-    "Configure embed options (UI toggles, downloads, layout), filters (string/date/number/SQL), and i18n (language, translations).",
-    {
-      embedId: z15.string().describe("ID of the embed to configure"),
-      body: z15.record(z15.unknown()).optional().describe(
-        "Raw API body for PUT /api/v2/data-app/embeds. If provided, sent directly and convenience fields are ignored."
-      ),
-      // ===== OPTIONS (from configure_embed_options) =====
-      // Metric Operations
-      disableMetricCreation: z15.boolean().optional().describe("Disable creating new metrics"),
-      disableMetricUpdation: z15.boolean().optional().describe("Disable updating existing metrics"),
-      disableMetricDeletion: z15.boolean().optional().describe("Disable deleting metrics"),
-      disableManageMetrics: z15.boolean().optional().describe("Hide the manage metrics interface"),
-      // Layout
-      disableLayoutCustomization: z15.boolean().optional().describe("Prevent layout changes"),
-      disableSaveLayout: z15.boolean().optional().describe("Prevent saving layout changes"),
-      // Downloads & Export
-      enableDownloadCsv: z15.boolean().optional().describe("Enable CSV download for individual metrics"),
-      enableEmailCsv: z15.boolean().optional().describe("Enable emailing metric data as CSV"),
-      disableDownloadPng: z15.boolean().optional().describe("Disable PNG download in fullscreen"),
-      enableDownloadAllMetrics: z15.boolean().optional().describe("Enable bulk download of all metrics as CSV"),
-      enableDownloadAllPdf: z15.boolean().optional().describe("Enable downloading entire dashboard as PDF"),
-      disableDownloadDataNoFilters: z15.boolean().optional().describe("Prevent data download when no filters"),
-      disableDownloadUnderlyingDataNoFilters: z15.boolean().optional().describe("Prevent underlying data download without filters"),
-      // UI Visibility
-      hideDashboardName: z15.boolean().optional().describe("Hide the dashboard title"),
-      hideMetricCardShadow: z15.boolean().optional().describe("Remove card shadow effects"),
-      disableMetricCardBorder: z15.boolean().optional().describe("Remove metric card borders"),
-      showDashboardActions: z15.boolean().optional().describe("Show/hide dashboard action buttons"),
-      disableFullscreen: z15.boolean().optional().describe("Disable fullscreen mode"),
-      isHideTablePreview: z15.boolean().optional().describe("Hide table preview in fullscreen"),
-      isHideChartSettings: z15.boolean().optional().describe("Hide chart settings in fullscreen"),
-      shouldFitFullScreen: z15.boolean().optional().describe("Make fullscreen modal fit the component space"),
-      // Loaders
-      disableMainLoader: z15.boolean().optional().describe("Hide the main loading indicator"),
-      disableMetricLoader: z15.boolean().optional().describe("Hide metric-level loading indicators"),
-      // Data Access
-      disableUnderlyingData: z15.boolean().optional().describe("Disable access to underlying data"),
-      isShowNoDataFoundScreen: z15.boolean().optional().describe('Show a "no data" screen when data unavailable'),
-      // Scheduling
-      disableScheduleEmailReports: z15.boolean().optional().describe("Disable email report scheduling"),
-      // Interactions
-      isStickyDashboardFilters: z15.boolean().optional().describe("Make filters sticky when scrolling"),
-      enableMultiMetricFilters: z15.boolean().optional().describe("Enable cross-metric filter interactions"),
-      optionsIcon: z15.enum(["kebab-menu-vertical", "download"]).optional().describe("Menu icon style"),
-      enableTitleClickFullscreen: z15.boolean().optional().describe("Click metric title to enter fullscreen"),
-      // Export
-      exportMsgPosition: z15.enum([
-        "bottom",
-        "bottom-left",
-        "bottom-right",
-        "center",
-        "top",
-        "top-left",
-        "top-right"
-      ]).optional().describe('Position of "exporting" notification message'),
-      isModifyUrl: z15.boolean().optional().describe("Whether navigating metrics modifies the browser URL"),
-      // No-data visuals
-      noDataImg: z15.string().optional().describe("URL to custom image when no data found"),
-      noDataFoundSvg: z15.string().optional().describe("Inline SVG when no data found"),
-      // Metric description
-      longDescriptionWidth: z15.string().optional().describe('Width of long-description tooltip (e.g. "300px")'),
-      longDescriptionFontColor: z15.string().optional().describe("Font color for long-description tooltip (hex)"),
-      // Settings icon
-      settingsIconName: z15.string().optional().describe("Custom name/label for the settings icon"),
-      settingsIconSvg: z15.string().optional().describe("Inline SVG for a custom settings icon"),
-      // Advanced: per-chart settings
-      customChartSettings: z15.record(z15.unknown()).optional().describe("Per-chart override settings (JSON)"),
-      // Custom Messages
-      tokenExpiryMessage: z15.string().optional().describe("Custom message when token expires"),
-      tokenAbsentMessage: z15.string().optional().describe("Custom message when token is missing"),
-      // ===== FILTERS (from configure_filters) =====
-      stringFilters: z15.array(stringFilterSchema).optional().describe("String filter configurations with dropdown options and defaults"),
-      numberFilters: z15.array(numberFilterSchema).optional().describe("Number filter configurations with min/max defaults"),
-      dateFilters: z15.array(dateFilterSchema).optional().describe("Date filter configurations with default ranges and presets"),
-      sqlFilters: z15.array(sqlFilterSchema).optional().describe("SQL-based filter options for large option sets"),
-      hideDashboardFilters: z15.array(z15.string()).optional().describe("Filter names to hide from the dashboard UI"),
-      hideDatePickerOptions: z15.array(z15.string()).optional().describe('Date picker options to hide (e.g. ["this month", "yesterday"])'),
-      metricFilterPosition: z15.enum(["inside", "outside"]).optional().describe("Where to display metric-level filters"),
-      // ===== INTERNATIONALIZATION (from configure_internationalization) =====
-      language: z15.enum(SUPPORTED_LANGUAGES).optional().describe('Primary language code (e.g. "fr", "es", "ja")'),
-      calendarType: z15.enum(["default", "ind"]).optional().describe('Calendar system: "default" or "ind" (Indian)'),
-      translations: z15.array(z15.object({
-        key: z15.string().describe("Original text to translate (must match exactly)"),
-        translations: z15.record(z15.string()).describe("Language code \u2192 translation mapping")
-      })).optional().describe("Translation dictionary entries")
-    },
-    WRITE_IDEMPOTENT,
-    async (params) => {
-      const { embedId, body, ...opts } = params;
-      if (body) {
-        try {
-          const rawBody = { ...body };
-          if (!rawBody.embedId) rawBody.embedId = embedId;
-          const result = await services.embedsApi.updateEmbed(rawBody);
-          if (result.error) {
-            return toolError(`Embed configuration failed: ${stringify(result.error)}`);
-          }
-          return toolSuccess(
-            `Embed configured for "${embedId}" (raw passthrough mode).` + GUEST_TOKEN_REMINDER
-          );
-        } catch (err) {
-          const guardrail = await maybeBuildCorruptedEmbedGuardrail(client, embedId, "configure embed", err);
-          if (guardrail) return guardrail;
-          if (err instanceof DatabrainApiError) return err.toToolResponse();
-          return toolError(`Unexpected error: ${err.message}`);
-        }
-      }
-      const options = {};
-      const attrs = {};
-      const configured = [];
-      if (opts.disableMetricCreation !== void 0) options.disableMetricCreation = opts.disableMetricCreation;
-      if (opts.disableMetricUpdation !== void 0) options.disableMetricUpdation = opts.disableMetricUpdation;
-      if (opts.disableMetricDeletion !== void 0) options.disableMetricDeletion = opts.disableMetricDeletion;
-      if (opts.disableManageMetrics !== void 0) options.disableManageMetrics = opts.disableManageMetrics;
-      if (opts.disableLayoutCustomization !== void 0) options.disableLayoutCustomization = opts.disableLayoutCustomization;
-      if (opts.disableSaveLayout !== void 0) options.disableSaveLayout = opts.disableSaveLayout;
-      if (opts.disableDownloadDataNoFilters !== void 0) options.disableDownloadDataNoFilters = opts.disableDownloadDataNoFilters;
-      if (opts.disableDownloadUnderlyingDataNoFilters !== void 0) options.disableDownloadUnderlyingDataNoFilters = opts.disableDownloadUnderlyingDataNoFilters;
-      if (opts.hideDashboardName !== void 0) options.hideDashboardName = opts.hideDashboardName;
-      if (opts.hideMetricCardShadow !== void 0) options.hideMetricCardShadow = opts.hideMetricCardShadow;
-      if (opts.disableMetricCardBorder !== void 0) options.disableMetricCardBorder = opts.disableMetricCardBorder;
-      if (opts.showDashboardActions !== void 0) options.showDashboardActions = opts.showDashboardActions;
-      if (opts.shouldFitFullScreen !== void 0) options.shouldFitFullScreen = opts.shouldFitFullScreen;
-      if (opts.isShowNoDataFoundScreen !== void 0) options.isShowNoDataFoundScreen = opts.isShowNoDataFoundScreen;
-      if (opts.disableMainLoader !== void 0) options.disableMainLoader = opts.disableMainLoader;
-      if (opts.disableMetricLoader !== void 0) options.disableMetricLoader = opts.disableMetricLoader;
-      if (opts.disableUnderlyingData !== void 0) options.disableUnderlyingData = opts.disableUnderlyingData;
-      if (opts.disableScheduleEmailReports !== void 0) options.disableScheduleEmailReports = opts.disableScheduleEmailReports;
-      if (opts.exportMsgPosition) options.exportMsgPosition = opts.exportMsgPosition;
-      if (opts.isModifyUrl !== void 0) options.isModifyUrl = opts.isModifyUrl;
-      if (opts.enableDownloadCsv !== void 0) attrs.enableDownloadCsv = opts.enableDownloadCsv;
-      if (opts.enableEmailCsv !== void 0) attrs.enableEmailCsv = opts.enableEmailCsv;
-      if (opts.disableDownloadPng !== void 0) attrs.disableDownloadPng = opts.disableDownloadPng;
-      if (opts.enableDownloadAllMetrics !== void 0) attrs.enableDownloadAllMetrics = opts.enableDownloadAllMetrics;
-      if (opts.enableDownloadAllPdf !== void 0) attrs.enableDownloadAllPdf = opts.enableDownloadAllPdf;
-      if (opts.disableFullscreen !== void 0) attrs.disableFullscreen = opts.disableFullscreen;
-      if (opts.isHideTablePreview !== void 0) attrs.isHideTablePreview = opts.isHideTablePreview;
-      if (opts.isHideChartSettings !== void 0) attrs.isHideChartSettings = opts.isHideChartSettings;
-      if (opts.isStickyDashboardFilters !== void 0) attrs.isStickyDashboardFilters = opts.isStickyDashboardFilters;
-      if (opts.enableMultiMetricFilters !== void 0) attrs.enableMultiMetricFilters = opts.enableMultiMetricFilters;
-      if (opts.optionsIcon) attrs.optionsIcon = opts.optionsIcon;
-      if (opts.enableTitleClickFullscreen !== void 0) attrs.enableTitleClickFullscreen = opts.enableTitleClickFullscreen;
-      if (opts.noDataImg) attrs.noDataImg = opts.noDataImg;
-      if (opts.noDataFoundSvg) attrs.noDataFoundSvg = opts.noDataFoundSvg;
-      if (opts.customChartSettings) attrs.customChartSettings = opts.customChartSettings;
-      if (opts.longDescriptionWidth || opts.longDescriptionFontColor) {
-        attrs.longDescriptionConfig = {
-          ...opts.longDescriptionWidth && { width: opts.longDescriptionWidth },
-          ...opts.longDescriptionFontColor && { fontColor: opts.longDescriptionFontColor }
-        };
-      }
-      if (opts.settingsIconName || opts.settingsIconSvg) {
-        attrs.settingsIcon = {
-          ...opts.settingsIconName && { name: opts.settingsIconName },
-          ...opts.settingsIconSvg && { iconSvg: opts.settingsIconSvg }
-        };
-      }
-      const customMessages = {};
-      if (opts.tokenExpiryMessage) customMessages.tokenExpiry = opts.tokenExpiryMessage;
-      if (opts.tokenAbsentMessage) customMessages.tokenAbsent = opts.tokenAbsentMessage;
-      if (Object.keys(customMessages).length) options.customMessages = customMessages;
-      const globalFilterOptions = {};
-      if (opts.stringFilters) {
-        for (const f of opts.stringFilters) {
-          globalFilterOptions[f.filterName] = {
-            options: f.options,
-            ...f.defaultOption !== void 0 && { defaultOption: f.defaultOption }
-          };
-        }
-        configured.push(`${opts.stringFilters.length} string filter(s)`);
-      }
-      if (opts.numberFilters) {
-        for (const f of opts.numberFilters) {
-          globalFilterOptions[f.filterName] = {
-            defaultOption: { min: f.min, max: f.max }
-          };
-        }
-        configured.push(`${opts.numberFilters.length} number filter(s)`);
-      }
-      if (opts.dateFilters) {
-        for (const f of opts.dateFilters) {
-          const config = {};
-          if (f.startDate || f.endDate) {
-            config.defaultOption = {
-              ...f.startDate && { startDate: f.startDate },
-              ...f.endDate && { endDate: f.endDate }
-            };
-          }
-          if (f.datePresetOptions) config.datePresetOptions = f.datePresetOptions;
-          globalFilterOptions[f.filterName] = config;
-        }
-        configured.push(`${opts.dateFilters.length} date filter(s)`);
-      }
-      if (opts.sqlFilters) {
-        for (const f of opts.sqlFilters) {
-          globalFilterOptions[f.filterName] = {
-            sql: f.sql,
-            columnName: f.columnName
-          };
-        }
-        configured.push(`${opts.sqlFilters.length} SQL filter(s)`);
-      }
-      if (Object.keys(globalFilterOptions).length) options.globalFilterOptions = globalFilterOptions;
-      if (opts.hideDashboardFilters) {
-        attrs.hideDashboardFilters = opts.hideDashboardFilters;
-        configured.push(`hiding ${opts.hideDashboardFilters.length} filter(s)`);
-      }
-      if (opts.hideDatePickerOptions) {
-        options.hideDatePickerOptions = opts.hideDatePickerOptions;
-        configured.push(`hiding ${opts.hideDatePickerOptions.length} date picker option(s)`);
-      }
-      if (opts.metricFilterPosition) {
-        attrs.metricFilterPosition = opts.metricFilterPosition;
-        configured.push(`metric filter position: ${opts.metricFilterPosition}`);
-      }
-      if (opts.language) {
-        attrs.language = opts.language;
-        configured.push(`language: ${opts.language}`);
-      }
-      if (opts.calendarType) {
-        attrs.calendarType = opts.calendarType;
-        configured.push(`calendar: ${opts.calendarType}`);
-      }
-      if (opts.translations?.length) {
-        const dict = {};
-        for (const entry of opts.translations) {
-          dict[entry.key] = entry.translations;
-        }
-        attrs.translationDictionary = dict;
-        configured.push(`${opts.translations.length} translation(s)`);
-      }
-      const optionKeys = Object.keys(options).filter((k) => k !== "globalFilterOptions" && k !== "customMessages" && k !== "hideDatePickerOptions");
-      const attrKeys = Object.keys(attrs).filter(
-        (k) => k !== "hideDashboardFilters" && k !== "metricFilterPosition" && k !== "language" && k !== "calendarType" && k !== "translationDictionary"
-      );
-      if (optionKeys.length || attrKeys.length) {
-        configured.push(`${optionKeys.length + attrKeys.length} display option(s)`);
-      }
-      if (Object.keys(options).length === 0 && Object.keys(attrs).length === 0) {
-        return toolError("No configuration provided. Specify at least one option, filter, or i18n setting.");
-      }
-      try {
-        const patch = {};
-        if (Object.keys(options).length) patch.options = options;
-        if (Object.keys(attrs).length) patch.componentAttributes = attrs;
-        const result = await services.embedService.updateEmbed(embedId, patch);
-        if (result.error) {
-          return toolError(`Embed configuration failed: ${stringify(result.error)}`);
-        }
-        return toolSuccess(
-          `Embed configured for "${embedId}".
-
-**Configured:** ${configured.join(", ")}
-
-Use \`get_embed_details\` to view the full configuration.` + GUEST_TOKEN_REMINDER
-        );
-      } catch (err) {
-        const guardrail = await maybeBuildCorruptedEmbedGuardrail(client, embedId, "configure embed", err);
-        if (guardrail) return guardrail;
-        if (err instanceof DatabrainApiError) return err.toToolResponse();
-        return toolError(`Unexpected error: ${err.message}`);
-      }
-    }
-  );
-}
-
-// src/tools/embed/diagnose-embed-health.ts
-import { z as z16 } from "zod";
-function asRecord2(value) {
-  return value && typeof value === "object" ? value : null;
-}
-function firstString(...values) {
-  for (const v of values) {
-    if (typeof v === "string" && v.trim().length > 0) return v;
-  }
-  return null;
-}
-function runRuntimeReadinessChecks(params) {
-  const payload = params.guestTokenBody ?? {
-    clientId: params.clientId,
-    dataAppName: params.dataAppName,
-    permissions: params.permissions
-  };
-  const checks = [];
-  const topLevelPermissions = payload.permissions;
-  const paramsObj = payload.params;
-  const nestedPermissions = paramsObj?.permissions;
-  checks.push({
-    check: "Top-level dataAppName",
-    status: typeof payload.dataAppName === "string" && payload.dataAppName.length > 0 ? "pass" : "fail",
-    details: typeof payload.dataAppName === "string" && payload.dataAppName.length > 0 ? "dataAppName is present at top level." : "Missing top-level dataAppName in guest token body."
-  });
-  checks.push({
-    check: "Top-level permissions object",
-    status: typeof topLevelPermissions === "object" && topLevelPermissions !== null ? "pass" : "fail",
-    details: typeof topLevelPermissions === "object" && topLevelPermissions !== null ? "permissions is present at top level." : "Missing top-level permissions object."
-  });
-  checks.push({
-    check: "No nested permissions in params",
-    status: nestedPermissions ? "fail" : "pass",
-    details: nestedPermissions ? "Found params.permissions. Move permissions to top level." : "No nested permissions found."
-  });
-  const disableMetricCreationFromToken = typeof topLevelPermissions === "object" && topLevelPermissions !== null ? topLevelPermissions.isDisableMetricCreation : void 0;
-  checks.push({
-    check: "Guest token metric creation gate",
-    status: disableMetricCreationFromToken === true ? "fail" : "pass",
-    details: disableMetricCreationFromToken === true ? "permissions.isDisableMetricCreation=true blocks + Create Metric." : "permissions.isDisableMetricCreation is not forcing metric creation off."
-  });
-  if (params.embedOptions) {
-    checks.push({
-      check: "Embed option metric creation gate",
-      status: params.embedOptions.disableMetricCreation === true ? "fail" : "pass",
-      details: params.embedOptions.disableMetricCreation === true ? "embed option disableMetricCreation=true blocks + Create Metric." : "Embed options are not forcing metric creation off."
-    });
-  }
-  if (params.dashboardRuntime) {
-    checks.push({
-      check: "Dashboard runtime: isAllowedToCreateMetrics",
-      status: params.dashboardRuntime.isAllowedToCreateMetrics === true ? "pass" : "fail",
-      details: params.dashboardRuntime.isAllowedToCreateMetrics === true ? "Dashboard runtime allows metric creation." : "Dashboard runtime says metric creation is not allowed."
-    });
-    checks.push({
-      check: "Dashboard runtime: metricCreationMode",
-      status: params.dashboardRuntime.metricCreationMode === "DRAG_DROP" ? "pass" : "warn",
-      details: `metricCreationMode is "${params.dashboardRuntime.metricCreationMode ?? "unknown"}".`
-    });
-  }
-  return checks;
-}
-function registerDiagnoseEmbedHealth(server, client) {
-  server.tool(
-    "diagnose_embed_health",
-    "Diagnose embed shape and required fields. Optionally validates runtime readiness if guestTokenBody or permissions are provided.",
-    {
-      embedId: z16.string().describe("Embed ID to diagnose"),
-      dataAppName: z16.string().optional().describe("Optional data app name to scope dashboard checks"),
-      // Runtime readiness params (absorbed from check_runtime_readiness)
-      guestTokenBody: z16.record(z16.unknown()).optional().describe(
-        "Exact request body sent to POST /api/v2/guest-token/create (for runtime validation)."
-      ),
-      permissions: z16.record(z16.unknown()).optional().describe(
-        "Guest token permissions (used when guestTokenBody is not provided)."
-      ),
-      embedOptions: z16.object({
-        disableMetricCreation: z16.boolean().optional()
-      }).optional().describe("Embed web component options (if known)."),
-      dashboardRuntime: z16.object({
-        isAllowedToCreateMetrics: z16.boolean().optional(),
-        metricCreationMode: z16.string().optional()
-      }).optional().describe("Runtime flags from dashboard response payload.")
-    },
-    READ_ONLY,
-    async (params) => {
-      try {
-        const raw = await client.request({
-          method: "GET",
-          path: "/api/v2/data-app/embeds",
-          auth: "api",
-          query: { embedId: params.embedId }
-        });
-        const embedList = Array.isArray(raw) ? raw : [raw];
-        const embed = embedList.find((e) => (e?.embedId || e?._id || e?.id) === params.embedId) || embedList[0];
-        const embedObj = asRecord2(embed);
-        if (!embedObj) {
-          return toolError(
-            `Embed "${params.embedId}" is not returned as an object by GET /embeds. This indicates malformed API data for this record.`
-          );
-        }
-        const embedMetadata = asRecord2(embedObj.embedMetadata);
-        const accessSettings = asRecord2(embedObj.accessSettings) || (embedMetadata ? asRecord2(embedMetadata.accessSettings) : null);
-        const dashboardIdCandidates = [
-          firstString(embedObj.dashboardId),
-          firstString(embedObj.externalDashboardId),
-          embedMetadata ? firstString(embedMetadata.dashboardId) : null
-        ].filter(Boolean);
-        const workspaceCandidates = [
-          firstString(embedObj.workspaceName),
-          firstString(embedObj.workspace),
-          firstString(embedObj.workspaceId),
-          embedMetadata ? firstString(embedMetadata.workspaceName) : null,
-          embedMetadata ? firstString(embedMetadata.workspaceId) : null
-        ].filter(Boolean);
-        const datamartName = firstString(
-          accessSettings?.datamartName,
-          embedObj.datamartName,
-          embedMetadata?.datamartName
-        );
-        let datamartsCount = 0;
-        let datamartNames = [];
-        try {
-          const datamarts = await client.request({
-            method: "GET",
-            path: "/api/v2/data-app/datamarts",
-            auth: "service",
-            cacheKey: "list_datamarts",
-            cacheTtlMs: 5 * 60 * 1e3
-          });
-          if (Array.isArray(datamarts)) {
-            datamartsCount = datamarts.length;
-            datamartNames = datamarts.map((d) => firstString(d?.name, d?.datamartName)).filter(Boolean).slice(0, 10);
-          }
-        } catch {
-        }
-        let dashboardsCount = 0;
-        let dashboardIdSample = [];
-        try {
-          const dashboardQuery = params.dataAppName && params.dataAppName.trim().length > 0 ? { dataAppName: params.dataAppName } : void 0;
-          const dashboards = await client.request({
-            method: "GET",
-            path: "/api/v2/data-app/dashboards",
-            auth: "api",
-            query: dashboardQuery,
-            cacheKey: "list_dashboards",
-            cacheTtlMs: 5 * 60 * 1e3
-          });
-          if (Array.isArray(dashboards)) {
-            dashboardsCount = dashboards.length;
-            dashboardIdSample = dashboards.map(
-              (d) => firstString(
-                d?.dashboardId,
-                d?.externalDashboardId,
-                d?._id,
-                d?.id,
-                d?.uid
-              )
-            ).filter(Boolean).slice(0, 10);
-          }
-        } catch {
-        }
-        const issues = [];
-        if (!firstString(embedObj.embedId, embedObj.id, embedObj._id)) {
-          issues.push("No stable embed identifier found in record");
-        }
-        if (!accessSettings) {
-          issues.push("Missing accessSettings");
-        }
-        if (!datamartName) {
-          issues.push("Missing datamartName (in accessSettings or embed metadata)");
-        }
-        if (dashboardIdCandidates.length === 0) {
-          issues.push("No dashboard identifier found on embed");
-        }
-        if (workspaceCandidates.length === 0) {
-          issues.push("No workspace identifier/name found on embed");
-        }
-        const health = issues.length === 0 ? "healthy-shape" : "inconsistent-shape";
-        let report = `Embed Health Report: \`${params.embedId}\`
-
-- **Status:** ${health}
-- **Issues:** ${issues.length ? issues.join("; ") : "none detected in shape checks"}
-- **Dashboard ID candidates:** ${dashboardIdCandidates.length ? dashboardIdCandidates.map((id) => `\`${id}\``).join(", ") : "none"}
-- **Workspace candidates:** ${workspaceCandidates.length ? workspaceCandidates.map((id) => `\`${id}\``).join(", ") : "none"}
-- **Resolved datamartName:** ${datamartName ? `\`${datamartName}\`` : "none"}
-- **Datamarts visible:** ${datamartsCount}${datamartNames.length ? ` (sample: ${datamartNames.join(", ")})` : ""}
-- **Dashboards visible:** ${dashboardsCount}${dashboardIdSample.length ? ` (ID sample: ${dashboardIdSample.map((id) => `\`${id}\``).join(", ")})` : ""}
-`;
-        if (params.guestTokenBody || params.permissions || params.embedOptions || params.dashboardRuntime) {
-          const runtimeChecks = runRuntimeReadinessChecks({
-            guestTokenBody: params.guestTokenBody,
-            clientId: void 0,
-            dataAppName: params.dataAppName,
-            permissions: params.permissions,
-            embedOptions: params.embedOptions,
-            dashboardRuntime: params.dashboardRuntime
-          });
-          const hasFail = runtimeChecks.some((c) => c.status === "fail");
-          report += `
-### Runtime Readiness: ${hasFail ? "NOT_READY" : "READY"}
-
-`;
-          for (const c of runtimeChecks) {
-            const icon = c.status === "pass" ? "PASS" : c.status === "fail" ? "FAIL" : "WARN";
-            report += `- **[${icon}]** ${c.check}: ${c.details}
-`;
-          }
-        }
-        report += `
-Raw embed payload:
-\`\`\`json
-` + JSON.stringify(embedObj, null, 2) + "\n```";
-        return toolSuccess(report);
-      } catch (err) {
-        if (err instanceof DatabrainApiError) return err.toToolResponse();
-        return toolError(`Unexpected error: ${err.message}`);
-      }
-    }
-  );
-}
-
 // src/tools/frontend/generate-guest-token.ts
-import { z as z17 } from "zod";
+import { z as z15 } from "zod";
 function registerGenerateGuestToken(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "generate_guest_token",
     "Generate a guest token for frontend embedding. Requires clientId. Omit dataAppName to auto-resolve.",
     {
-      clientId: z17.string().describe('Unique end-user identifier for multi-tenant filtering. Use "None" if no tenancy.'),
-      dataAppName: z17.string().optional().describe("Name of the data app. Omit to list available data apps."),
-      body: z17.record(z17.unknown()).optional().describe(
+      clientId: z15.string().describe('Unique end-user identifier for multi-tenant filtering. Use "None" if no tenancy.'),
+      dataAppName: z15.string().optional().describe("Name of the data app. Omit to list available data apps."),
+      body: z15.record(z15.unknown()).optional().describe(
         "Raw API body for POST /api/v2/guest-token/create. If provided, sent directly and convenience fields are ignored."
       ),
-      params: z17.object({
-        allowedEmbeds: z17.array(z17.string()).optional().describe("Restrict token to specific embed IDs"),
-        rlsSettings: z17.array(z17.object({
-          metricId: z17.string().describe("Metric ID"),
-          values: z17.record(z17.unknown()).describe("RLS values by column name")
+      params: z15.object({
+        allowedEmbeds: z15.array(z15.string()).optional().describe("Restrict token to specific embed IDs"),
+        rlsSettings: z15.array(z15.object({
+          metricId: z15.string().describe("Metric ID"),
+          values: z15.record(z15.unknown()).describe("RLS values by column name")
         })).optional().describe("Legacy alias used in docs/examples; forwarded as params.rlsSettings"),
-        appFilters: z17.array(z17.object({
-          metricId: z17.string().describe("Metric ID"),
-          values: z17.record(z17.unknown()).describe("Filter values by column name")
+        appFilters: z15.array(z15.object({
+          metricId: z15.string().describe("Metric ID"),
+          values: z15.record(z15.unknown()).describe("Filter values by column name")
         })).optional().describe("Metric-level app filters"),
-        dashboardAppFilters: z17.array(z17.object({
-          dashboardId: z17.string().describe("Dashboard ID"),
-          values: z17.record(z17.unknown()).describe("Filter values by dashboard filter name"),
-          isShowOnUrl: z17.boolean().optional().describe("Whether filters are shown in URL params")
+        dashboardAppFilters: z15.array(z15.object({
+          dashboardId: z15.string().describe("Dashboard ID"),
+          values: z15.record(z15.unknown()).describe("Filter values by dashboard filter name"),
+          isShowOnUrl: z15.boolean().optional().describe("Whether filters are shown in URL params")
         })).optional().describe("Dashboard-level app filters"),
-        hideDashboardFilters: z17.array(z17.string()).optional().describe("Dashboard filter names to hide"),
-        userIdentifier: z17.string().optional().describe("End-user identifier for private metrics support"),
-        timezone: z17.string().optional().describe('IANA timezone, e.g. "America/New_York"')
+        hideDashboardFilters: z15.array(z15.string()).optional().describe("Dashboard filter names to hide"),
+        userIdentifier: z15.string().optional().describe("End-user identifier for private metrics support"),
+        timezone: z15.string().optional().describe('IANA timezone, e.g. "America/New_York"')
       }).optional().describe("Advanced token params"),
       // Legacy convenience fields (auto-mapped into params for backward compatibility)
-      timezone: z17.string().optional().describe("Legacy: moved under params.timezone"),
-      allowedEmbeds: z17.array(z17.string()).optional().describe("Legacy: moved under params.allowedEmbeds"),
-      rlsSettings: z17.array(z17.object({
-        metricId: z17.string().describe("Metric ID"),
-        values: z17.record(z17.unknown()).describe("RLS values by column name")
+      timezone: z15.string().optional().describe("Legacy: moved under params.timezone"),
+      allowedEmbeds: z15.array(z15.string()).optional().describe("Legacy: moved under params.allowedEmbeds"),
+      rlsSettings: z15.array(z15.object({
+        metricId: z15.string().describe("Metric ID"),
+        values: z15.record(z15.unknown()).describe("RLS values by column name")
       })).optional().describe("Legacy: moved under params.rlsSettings"),
-      appFilters: z17.array(z17.object({
-        metricId: z17.string().describe("Metric ID"),
-        values: z17.record(z17.unknown()).describe("Filter values by column name")
+      appFilters: z15.array(z15.object({
+        metricId: z15.string().describe("Metric ID"),
+        values: z15.record(z15.unknown()).describe("Filter values by column name")
       })).optional().describe("Legacy: moved under params.appFilters"),
-      dashboardAppFilters: z17.array(z17.object({
-        dashboardId: z17.string().describe("Dashboard ID to apply filters to"),
-        values: z17.record(z17.unknown()).describe("Filter values for this dashboard"),
-        isShowOnUrl: z17.boolean().optional().describe("Whether filters are shown in URL params")
+      dashboardAppFilters: z15.array(z15.object({
+        dashboardId: z15.string().describe("Dashboard ID to apply filters to"),
+        values: z15.record(z15.unknown()).describe("Filter values for this dashboard"),
+        isShowOnUrl: z15.boolean().optional().describe("Whether filters are shown in URL params")
       })).optional().describe("Legacy: moved under params.dashboardAppFilters"),
-      permissions: z17.object({
-        isEnableArchiveMetrics: z17.boolean().optional(),
-        isEnableManageMetrics: z17.boolean().optional(),
-        isEnableCreateDashboardView: z17.boolean().optional(),
-        isEnableMetricUpdation: z17.boolean().optional(),
-        isEnableCustomizeLayout: z17.boolean().optional(),
-        isEnableUnderlyingData: z17.boolean().optional(),
-        isEnableDownloadMetrics: z17.boolean().optional(),
-        isShowSideBar: z17.boolean().optional(),
-        isShowDashboardName: z17.boolean().optional(),
-        isDisableMetricCreation: z17.boolean().optional()
+      permissions: z15.object({
+        isEnableArchiveMetrics: z15.boolean().optional(),
+        isEnableManageMetrics: z15.boolean().optional(),
+        isEnableCreateDashboardView: z15.boolean().optional(),
+        isEnableMetricUpdation: z15.boolean().optional(),
+        isEnableCustomizeLayout: z15.boolean().optional(),
+        isEnableUnderlyingData: z15.boolean().optional(),
+        isEnableDownloadMetrics: z15.boolean().optional(),
+        isShowSideBar: z15.boolean().optional(),
+        isShowDashboardName: z15.boolean().optional(),
+        isDisableMetricCreation: z15.boolean().optional()
       }).optional().describe("Runtime permission overrides (merge with and override embed-level settings)"),
-      theme: z17.record(z17.unknown()).optional().describe("Runtime theme overrides (overrides embed-level theme)"),
-      hideDashboardFilters: z17.array(z17.string()).optional().describe("Legacy: moved under params.hideDashboardFilters"),
-      userIdentifier: z17.string().optional().describe("Legacy: moved under params.userIdentifier"),
-      expiryTime: z17.number().optional().describe("Token TTL in milliseconds"),
-      datasourceName: z17.string().optional().describe("Datasource name for multi-datasource routing")
+      theme: z15.record(z15.unknown()).optional().describe("Runtime theme overrides (overrides embed-level theme)"),
+      hideDashboardFilters: z15.array(z15.string()).optional().describe("Legacy: moved under params.hideDashboardFilters"),
+      userIdentifier: z15.string().optional().describe("Legacy: moved under params.userIdentifier"),
+      expiryTime: z15.number().optional().describe("Token TTL in milliseconds"),
+      datasourceName: z15.string().optional().describe("Datasource name for multi-datasource routing")
     },
     WRITE_CREATE,
     async (params) => {
@@ -3035,7 +2494,7 @@ Next step: Use \`generate_embed_code\` to get copy-paste-ready frontend code.`
 }
 
 // src/tools/frontend/generate-embed-code.ts
-import { z as z18 } from "zod";
+import { z as z16 } from "zod";
 
 // src/templates/react.ts
 function kebabCase(str) {
@@ -4031,22 +3490,22 @@ function registerGenerateEmbedCode(server, _client) {
     "generate_embed_code",
     "Generate framework-specific embed code (React, Next.js, Vue, Angular, Svelte, SolidJS, vanilla HTML).",
     {
-      embedId: z18.string().describe("The embed ID to generate code for"),
-      framework: z18.enum(FRAMEWORKS).describe("Frontend framework"),
-      embedType: z18.enum(["dashboard", "metric"]).optional().default("dashboard"),
-      options: z18.object({
-        enableDownloadCsv: z18.boolean().optional(),
-        enableEmailCsv: z18.boolean().optional(),
-        enableDownloadAllMetrics: z18.boolean().optional(),
-        enableDownloadAllPdf: z18.boolean().optional(),
-        disableFullscreen: z18.boolean().optional(),
-        isHideTablePreview: z18.boolean().optional(),
-        isHideChartSettings: z18.boolean().optional(),
-        isStickyDashboardFilters: z18.boolean().optional(),
-        enableMultiMetricFilters: z18.boolean().optional(),
-        themeName: z18.string().optional(),
-        customTheme: z18.record(z18.unknown()).optional(),
-        optionsIcon: z18.enum(["kebab-menu-vertical", "download"]).optional()
+      embedId: z16.string().describe("The embed ID to generate code for"),
+      framework: z16.enum(FRAMEWORKS).describe("Frontend framework"),
+      embedType: z16.enum(["dashboard", "metric"]).optional().default("dashboard"),
+      options: z16.object({
+        enableDownloadCsv: z16.boolean().optional(),
+        enableEmailCsv: z16.boolean().optional(),
+        enableDownloadAllMetrics: z16.boolean().optional(),
+        enableDownloadAllPdf: z16.boolean().optional(),
+        disableFullscreen: z16.boolean().optional(),
+        isHideTablePreview: z16.boolean().optional(),
+        isHideChartSettings: z16.boolean().optional(),
+        isStickyDashboardFilters: z16.boolean().optional(),
+        enableMultiMetricFilters: z16.boolean().optional(),
+        themeName: z16.string().optional(),
+        customTheme: z16.record(z16.unknown()).optional(),
+        optionsIcon: z16.enum(["kebab-menu-vertical", "download"]).optional()
       }).optional()
     },
     READ_ONLY,
@@ -4086,17 +3545,17 @@ ${generated.instructions}`;
 }
 
 // src/tools/analytics/list-dashboards.ts
-import { z as z19 } from "zod";
+import { z as z17 } from "zod";
 function registerListDashboards(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "list_dashboards",
     "List dashboards globally or for a specific data app.",
     {
-      scope: z19.enum(["auto", "global", "data_app"]).optional().describe(
+      scope: z17.enum(["auto", "global", "data_app"]).optional().describe(
         "Dashboard listing scope. auto: use data_app when dataAppName + API token are available, otherwise global."
       ),
-      dataAppName: z19.string().optional().describe("Data app name for data_app scope. Ignored for global scope.")
+      dataAppName: z17.string().optional().describe("Data app name for data_app scope. Ignored for global scope.")
     },
     READ_ONLY,
     async (params) => {
@@ -4130,617 +3589,8 @@ function registerListDashboards(server, client) {
   );
 }
 
-// src/tools/orchestration/setup-embed-interactive.ts
-import { z as z20 } from "zod";
-var STEPS = [
-  "discover_data_apps",
-  "choose_data_app",
-  "create_data_app",
-  "ensure_api_token",
-  "discover_workspaces",
-  "choose_workspace",
-  "list_dashboards",
-  "choose_dashboard",
-  "create_embed",
-  "runtime_readiness",
-  "complete"
-];
-var stateSchema = z20.object({
-  dataAppName: z20.string().optional(),
-  dataAppId: z20.string().optional(),
-  workspaceName: z20.string().optional(),
-  embedType: z20.enum(["dashboard", "metric"]).optional(),
-  dashboardId: z20.string().optional(),
-  metricId: z20.string().optional(),
-  datamartName: z20.string().optional(),
-  embedId: z20.string().optional(),
-  embedName: z20.string().optional(),
-  clientId: z20.string().optional(),
-  runtimeValidated: z20.boolean().optional()
-});
-function emit(status, step, state, message, options, nextStep) {
-  const payload = {
-    status,
-    step,
-    message,
-    state
-  };
-  if (options) payload.options = options;
-  if (nextStep) payload.nextStep = nextStep;
-  return toolSuccess(JSON.stringify(payload, null, 2));
-}
-function parseUserChoiceObject(userChoice) {
-  if (!userChoice) return null;
-  try {
-    const parsed = JSON.parse(userChoice);
-    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-      return parsed;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function parseNameFromUserChoice(userChoice) {
-  if (!userChoice) return null;
-  const choiceObj = parseUserChoiceObject(userChoice);
-  if (choiceObj) {
-    const rawName = choiceObj.name;
-    if (typeof rawName === "string" && rawName.trim().length > 0) return rawName.trim();
-    return null;
-  }
-  const trimmed = userChoice.trim();
-  return trimmed.length > 0 ? trimmed : null;
-}
-function registerSetupEmbedInteractive(server, client) {
-  const services = createServiceBundle(client);
-  const listDashboardsForContext = async (currentState) => {
-    const dataAppName = currentState.dataAppName;
-    const workspaceName = currentState.workspaceName;
-    if (dataAppName && dataAppName.trim().length > 0 && client.hasApiToken()) {
-      const dashboards2 = await services.dashboardsApi.listDashboards(dataAppName);
-      if (Array.isArray(dashboards2) && dashboards2.length > 0) {
-        return { dashboards: dashboards2, scope: "data_app" };
-      }
-    }
-    if (workspaceName && workspaceName.trim().length > 0) {
-      const dashboards2 = await services.dashboardsApi.listDashboardsForWorkspace(workspaceName);
-      return { dashboards: dashboards2, scope: "workspace" };
-    }
-    const dashboards = await services.dashboardsApi.listDashboardsAcrossWorkspaces();
-    return { dashboards, scope: "global" };
-  };
-  server.tool(
-    "setup_embed_interactive",
-    "Step-by-step embed setup wizard. Pass step and state from previous call.",
-    {
-      step: z20.enum(STEPS).describe("Current orchestration step"),
-      state: stateSchema.optional().describe("State from previous step \u2014 pass forward unchanged"),
-      userChoice: z20.string().optional().describe("User response for CHOICE_REQUIRED or CONFIRM_REQUIRED")
-    },
-    WRITE_CREATE,
-    async (params) => {
-      const state = params.state ?? {};
-      const step = params.step;
-      try {
-        if (step === "discover_data_apps") {
-          const apps = await services.dataAppsApi.listDataApps();
-          if (!Array.isArray(apps) || apps.length === 0) {
-            return emit(
-              "CHOICE_REQUIRED",
-              step,
-              state,
-              "No data apps found. Ask user for a data app name to create one.",
-              [
-                { id: "create", label: "Create a new data app" },
-                { id: "stop", label: "Stop setup" }
-              ],
-              "create_data_app"
-            );
-          }
-          if (apps.length === 1) {
-            const app = services.discoveryService.normalizeDataApp(apps[0]);
-            return emit(
-              "CONFIRM_REQUIRED",
-              step,
-              {
-                ...state,
-                dataAppName: app.name,
-                dataAppId: app.dataAppId || void 0
-              },
-              `Found one data app: "${app.name}". Confirm to continue.`,
-              [{ id: app.name, label: `${app.name} (${app.dataAppId || "no-id"})` }],
-              "ensure_api_token"
-            );
-          }
-          const options = apps.map((a) => {
-            const n = services.discoveryService.normalizeDataApp(a);
-            return {
-              id: n.dataAppId || n.name,
-              label: `${n.name} (${n.dataAppId || "no-id"})`,
-              dataAppName: n.name,
-              dataAppId: n.dataAppId
-            };
-          });
-          return emit(
-            "CHOICE_REQUIRED",
-            step,
-            state,
-            `Found ${apps.length} data app(s). Ask the user which one to embed from.`,
-            options,
-            "choose_data_app"
-          );
-        }
-        if (step === "choose_data_app") {
-          if (!params.userChoice) {
-            return toolError("userChoice is required for choose_data_app.");
-          }
-          const apps = await services.dataAppsApi.listDataApps();
-          const q = params.userChoice.toLowerCase();
-          const match = apps.find((a) => {
-            const n2 = services.discoveryService.normalizeDataApp(a);
-            return n2.name.toLowerCase() === q || (n2.dataAppId || "").toLowerCase() === q || n2.name.toLowerCase().includes(q);
-          });
-          if (!match) {
-            return toolError(
-              `No data app matched "${params.userChoice}". Re-run discover_data_apps.`
-            );
-          }
-          const n = services.discoveryService.normalizeDataApp(match);
-          return emit(
-            "READY",
-            step,
-            {
-              ...state,
-              dataAppName: n.name,
-              dataAppId: n.dataAppId || void 0
-            },
-            `Selected data app: "${n.name}".`,
-            void 0,
-            "ensure_api_token"
-          );
-        }
-        if (step === "create_data_app") {
-          const name = parseNameFromUserChoice(params.userChoice);
-          if (!name) {
-            return toolError(
-              'Provide data app name in userChoice. Accepts plain string or JSON: {"name":"my-data-app"}.'
-            );
-          }
-          const created = await client.request({
-            method: "POST",
-            path: "/api/v2/data-app/",
-            auth: "service",
-            body: { name },
-            invalidateCache: ["list_data_apps"]
-          });
-          return emit(
-            "READY",
-            step,
-            {
-              ...state,
-              dataAppName: name,
-              dataAppId: created.id || void 0
-            },
-            `Created data app "${name}".`,
-            void 0,
-            "ensure_api_token"
-          );
-        }
-        if (step === "ensure_api_token") {
-          const appName = state.dataAppName;
-          if (!appName) {
-            return toolError("state.dataAppName is required. Run discover_data_apps first.");
-          }
-          const tokens = await client.request({
-            method: "GET",
-            path: "/api/v2/data-app/api-tokens",
-            auth: "service",
-            query: { dataAppName: appName }
-          });
-          if (Array.isArray(tokens) && tokens.length > 0) {
-            const tokenValue = tokens[0].token || tokens[0].apiToken || tokens[0].key;
-            if (tokenValue) {
-              client.setRuntimeApiToken(tokenValue);
-              return emit(
-                "READY",
-                step,
-                { ...state, dataAppName: appName },
-                `API token found and activated for "${appName}".`,
-                void 0,
-                "discover_workspaces"
-              );
-            }
-            return emit(
-              "CHOICE_REQUIRED",
-              step,
-              { ...state, dataAppName: appName },
-              `"${appName}" has API token(s) but the value was not returned. Call \`create_api_token\` to generate a new one, or \`set_api_token\` if you have the value. Then re-run discover_workspaces.`,
-              [
-                { id: "create", label: "Create new API token (call create_api_token)" },
-                { id: "set", label: "Set existing token (call set_api_token)" }
-              ],
-              "discover_workspaces"
-            );
-          }
-          return emit(
-            "CHOICE_REQUIRED",
-            step,
-            { ...state, dataAppName: appName },
-            `No API token for "${appName}". Call \`create_api_token\` to generate one. Then proceed to discover_workspaces.`,
-            [
-              { id: "create", label: "Create API token now (call create_api_token)" }
-            ],
-            "discover_workspaces"
-          );
-        }
-        if (step === "discover_workspaces") {
-          const workspaces = await services.workspacesApi.listWorkspaces();
-          if (!Array.isArray(workspaces) || workspaces.length === 0) {
-            return emit(
-              "READY",
-              step,
-              state,
-              "No workspaces found. Create a workspace in Databrain UI first, then re-run this step."
-            );
-          }
-          if (workspaces.length === 1) {
-            const ws = workspaces[0];
-            const wsName = (typeof ws.name === "string" ? ws.name.trim() : "") || "Unnamed";
-            return emit(
-              "READY",
-              step,
-              { ...state, workspaceName: wsName },
-              `Found one workspace: "${wsName}". Auto-selected.`,
-              void 0,
-              "list_dashboards"
-            );
-          }
-          const options = workspaces.filter((ws) => typeof ws.name === "string" && ws.name.trim().length > 0).map((ws) => ({
-            id: ws.name,
-            label: `${ws.name} (${ws._id || ws.id || "no-id"})`,
-            workspaceName: ws.name
-          }));
-          return emit(
-            "CHOICE_REQUIRED",
-            step,
-            state,
-            `Found ${workspaces.length} workspace(s). Ask the user which workspace to use.`,
-            options,
-            "choose_workspace"
-          );
-        }
-        if (step === "choose_workspace") {
-          if (!params.userChoice) {
-            return toolError("userChoice is required for choose_workspace.");
-          }
-          const workspaces = await services.workspacesApi.listWorkspaces();
-          const q = params.userChoice.toLowerCase();
-          const match = workspaces.find((ws) => {
-            const name = (typeof ws.name === "string" ? ws.name.trim() : "").toLowerCase();
-            const wsId = (ws._id || ws.id || "").toLowerCase();
-            return name === q || wsId === q || name.includes(q);
-          });
-          if (!match) {
-            return toolError(
-              `No workspace matched "${params.userChoice}". Re-run discover_workspaces.`
-            );
-          }
-          const wsName = (typeof match.name === "string" ? match.name.trim() : "") || "Unnamed";
-          return emit(
-            "READY",
-            step,
-            { ...state, workspaceName: wsName },
-            `Selected workspace: "${wsName}".`,
-            void 0,
-            "list_dashboards"
-          );
-        }
-        if (step === "list_dashboards") {
-          const { dashboards, scope } = await listDashboardsForContext(state);
-          if (!Array.isArray(dashboards) || dashboards.length === 0) {
-            const scopeMsg = scope === "data_app" ? `No dashboards found for data app "${state.dataAppName || "unknown"}".` : scope === "workspace" ? `No dashboards found in workspace "${state.workspaceName || "unknown"}". Create a dashboard in Databrain UI first, then re-run this step.` : "No dashboards found in available workspaces. Create a dashboard in Databrain UI first, then re-run this step.";
-            return emit("READY", step, state, scopeMsg);
-          }
-          const options = dashboards.map((d) => {
-            const n = services.discoveryService.normalizeDashboard(d);
-            return {
-              id: n.dashboardId || n.name,
-              label: `${n.name} (${n.dashboardId || "no-id"})${n.workspaceName ? ` \u2014 workspace: ${n.workspaceName}` : ""}`,
-              dashboardId: n.dashboardId,
-              workspaceName: n.workspaceName
-            };
-          });
-          const foundMsg = scope === "data_app" ? `Found ${dashboards.length} dashboard(s) for data app "${state.dataAppName || "unknown"}". Ask the user which dashboard to embed.` : scope === "workspace" ? `Found ${dashboards.length} dashboard(s) in workspace "${state.workspaceName || "unknown"}". Ask the user which dashboard to embed.` : `Found ${dashboards.length} dashboard(s) across workspaces. Ask the user which dashboard to embed.`;
-          return emit(
-            "CHOICE_REQUIRED",
-            step,
-            state,
-            foundMsg,
-            options,
-            "choose_dashboard"
-          );
-        }
-        if (step === "choose_dashboard") {
-          if (!params.userChoice) {
-            return toolError("userChoice is required for choose_dashboard. Pass dashboardId or name.");
-          }
-          const { dashboards } = await listDashboardsForContext(state);
-          const q = params.userChoice.toLowerCase();
-          const match = dashboards.find((d) => {
-            const n2 = services.discoveryService.normalizeDashboard(d);
-            return (n2.dashboardId || "").toLowerCase() === q || (n2.name || "").toLowerCase() === q || (n2.name || "").toLowerCase().includes(q);
-          });
-          if (!match) {
-            return toolError(
-              `No dashboard matched "${params.userChoice}". Re-run list_dashboards.`
-            );
-          }
-          const n = services.discoveryService.normalizeDashboard(match);
-          let resolvedDatamartName = state.datamartName;
-          const resolveAppId = state.dataAppId || n.workspaceName;
-          if (!resolvedDatamartName && resolveAppId) {
-            try {
-              const datamarts = await services.datamartsApi.listDatamartsByDataAppId(resolveAppId);
-              const names = Array.from(
-                new Set(
-                  datamarts.map((dm) => dm.name || dm.datamartName).filter((v) => typeof v === "string" && v.trim().length > 0)
-                )
-              );
-              if (names.length === 1) resolvedDatamartName = names[0];
-            } catch {
-            }
-          }
-          return emit(
-            "READY",
-            step,
-            {
-              ...state,
-              dashboardId: n.dashboardId,
-              embedType: "dashboard",
-              ...n.workspaceName ? { workspaceName: n.workspaceName } : {},
-              ...resolvedDatamartName ? { datamartName: resolvedDatamartName } : {}
-            },
-            `Selected dashboard: "${n.name}" (${n.dashboardId}).${n.workspaceName ? ` workspaceName=${n.workspaceName}.` : ""}${resolvedDatamartName ? ` datamartName=${resolvedDatamartName}.` : ""} Proceeding to create embed.`,
-            void 0,
-            "create_embed"
-          );
-        }
-        if (step === "create_embed") {
-          const choiceObj = parseUserChoiceObject(params.userChoice);
-          const merged = {
-            ...state,
-            ...choiceObj || {}
-          };
-          const dashboardId = merged.dashboardId;
-          const metricId = merged.metricId;
-          let resolvedWorkspaceName = merged.workspaceName;
-          const embedType = merged.embedType?.toLowerCase() === "metric" ? "metric" : "dashboard";
-          const datamartName = merged.datamartName;
-          const embedName = merged.embedName || (embedType === "dashboard" && dashboardId ? `embed-${dashboardId}` : embedType === "metric" && metricId ? `embed-metric-${metricId}` : void 0);
-          let resolvedDatamartName = datamartName;
-          let resolveAppId = merged.dataAppId;
-          let availableDatamartNames = [];
-          if (!resolveAppId) {
-            const appName = merged.dataAppName;
-            if (appName) {
-              try {
-                const apps = await services.dataAppsApi.listDataApps();
-                const app = apps.find((a) => {
-                  const n = services.discoveryService.normalizeDataApp(a);
-                  return n.name.toLowerCase() === appName.toLowerCase() || (n.dataAppId || "").toLowerCase() === appName.toLowerCase();
-                });
-                if (app) {
-                  resolveAppId = services.discoveryService.normalizeDataApp(app).dataAppId || void 0;
-                }
-              } catch {
-              }
-            }
-          }
-          if (embedType === "dashboard" && dashboardId && merged.dataAppName && client.hasApiToken()) {
-            try {
-              const scopedDashboards = await services.dashboardsApi.listDashboards(
-                merged.dataAppName
-              );
-              const dashboardMatch = scopedDashboards.find((d) => {
-                const n = services.discoveryService.normalizeDashboard(d);
-                return (n.dashboardId || "").toLowerCase() === dashboardId.toLowerCase();
-              });
-              if (!dashboardMatch) {
-                return emit(
-                  "CHOICE_REQUIRED",
-                  step,
-                  merged,
-                  `dashboardId "${dashboardId}" is not available under data app "${merged.dataAppName || "unknown"}". Re-run list_dashboards and choose from the current data app scope.`,
-                  [],
-                  "list_dashboards"
-                );
-              }
-              const dashboardNormalized = services.discoveryService.normalizeDashboard(dashboardMatch);
-              if (dashboardNormalized.workspaceName) {
-                if (resolvedWorkspaceName && resolvedWorkspaceName !== dashboardNormalized.workspaceName) {
-                  return emit(
-                    "CHOICE_REQUIRED",
-                    step,
-                    merged,
-                    `workspaceName "${resolvedWorkspaceName}" does not match dashboard workspace "${dashboardNormalized.workspaceName}". Use the dashboard workspace.`,
-                    [
-                      {
-                        id: "use_dashboard_workspace",
-                        label: dashboardNormalized.workspaceName,
-                        workspaceName: dashboardNormalized.workspaceName
-                      }
-                    ],
-                    "create_embed"
-                  );
-                }
-                resolvedWorkspaceName = dashboardNormalized.workspaceName;
-              }
-            } catch {
-            }
-          }
-          if (embedType === "dashboard" && !resolvedDatamartName) {
-            if (resolveAppId) {
-              try {
-                const datamarts = await services.datamartsApi.listDatamartsByDataAppId(
-                  resolveAppId
-                );
-                const names = Array.from(
-                  new Set(
-                    datamarts.map((dm) => dm.name || dm.datamartName).filter(
-                      (v) => typeof v === "string" && v.trim().length > 0
-                    )
-                  )
-                );
-                availableDatamartNames = names;
-                if (names.length === 1) {
-                  resolvedDatamartName = names[0];
-                } else if (names.length > 1) {
-                  return emit(
-                    "CHOICE_REQUIRED",
-                    step,
-                    merged,
-                    "Multiple datamarts are available for this data app. Ask the user to select one for accessSettings.datamartName.",
-                    names.map((name) => ({
-                      id: name,
-                      label: name,
-                      datamartName: name
-                    })),
-                    "create_embed"
-                  );
-                }
-              } catch {
-              }
-            }
-          }
-          if (embedType === "dashboard" && resolvedDatamartName && resolveAppId && availableDatamartNames.length === 0) {
-            try {
-              const datamarts = await services.datamartsApi.listDatamartsByDataAppId(resolveAppId);
-              availableDatamartNames = Array.from(
-                new Set(
-                  datamarts.map((dm) => dm.name || dm.datamartName).filter((v) => typeof v === "string" && v.trim().length > 0)
-                )
-              );
-            } catch {
-            }
-          }
-          if (embedType === "dashboard" && resolvedDatamartName && availableDatamartNames.length > 0 && !availableDatamartNames.includes(resolvedDatamartName)) {
-            return emit(
-              "CHOICE_REQUIRED",
-              step,
-              merged,
-              `datamartName "${resolvedDatamartName}" is invalid for this data app. Choose one of the available datamarts.`,
-              availableDatamartNames.map((name) => ({
-                id: name,
-                label: name,
-                datamartName: name
-              })),
-              "create_embed"
-            );
-          }
-          const missing = [];
-          if (!resolvedWorkspaceName) missing.push("workspaceName");
-          if (!dashboardId) missing.push("dashboardId");
-          if (embedType === "metric" && !metricId) missing.push("metricId");
-          if (embedType === "dashboard" && !resolvedDatamartName) missing.push("datamartName");
-          if (missing.length > 0) {
-            return emit(
-              "CHOICE_REQUIRED",
-              step,
-              {
-                ...merged,
-                ...resolvedDatamartName ? { datamartName: resolvedDatamartName } : {}
-              },
-              `Missing required fields for embed creation: ${missing.join(", ")}. Provide via userChoice JSON.`,
-              [
-                {
-                  id: "provide_fields",
-                  label: 'Provide JSON: {"dashboardId":"...","workspaceName":"...","datamartName":"..."}'
-                }
-              ],
-              "create_embed"
-            );
-          }
-          const created = await services.embedService.createEmbedStrict({
-            dashboardId,
-            metricId,
-            workspaceName: resolvedWorkspaceName,
-            embedType,
-            name: embedName,
-            accessSettings: {
-              datamartName: resolvedDatamartName,
-              isAllowMetricCreation: false,
-              isAllowMetricDeletion: false,
-              isAllowMetricUpdate: false,
-              isAllowMetricLayoutChange: false,
-              isAllowManageMetrics: false,
-              isAllowUnderlyingData: false,
-              isAllowAiPilot: false,
-              isAllowEmailReports: false,
-              isAllowCreateDashboardView: false,
-              metricCreationMode: "DRAG_DROP"
-            }
-          });
-          const embedId = created.embedId || created.id || created._id || void 0;
-          return emit(
-            "READY",
-            step,
-            { ...merged, embedType, embedId },
-            `Embed created successfully${embedId ? ` (embedId: ${embedId})` : ""}. Next: run runtime readiness validation before finishing setup.`,
-            void 0,
-            "runtime_readiness"
-          );
-        }
-        if (step === "runtime_readiness") {
-          const appName = state.dataAppName;
-          if (!appName) {
-            return toolError("state.dataAppName is required. Run discover_data_apps first.");
-          }
-          const choiceObj = parseUserChoiceObject(params.userChoice);
-          const clientId = choiceObj?.clientId || state.clientId || "None";
-          const permissions = {
-            isEnableManageMetrics: true,
-            isEnableMetricUpdation: true,
-            isEnableCustomizeLayout: true,
-            isEnableCreateDashboardView: true,
-            isDisableMetricCreation: false,
-            ...choiceObj?.permissions || {}
-          };
-          await services.guestTokenService.generateToken({
-            clientId,
-            dataAppName: appName,
-            permissions
-          });
-          return emit(
-            "DONE",
-            step,
-            {
-              ...state,
-              clientId,
-              runtimeValidated: true
-            },
-            "Runtime contract validated by generating a guest token with top-level clientId/dataAppName/permissions. Next: run generate_embed_code and then continue with brand-my-embed or secure-my-embed as needed."
-          );
-        }
-        if (step === "complete") {
-          return emit(
-            "DONE",
-            step,
-            state,
-            "Setup complete. Recommended before handoff: run runtime_readiness. Then use brand-my-embed, secure-my-embed, setup-filters, or localize-embed prompts for further customization."
-          );
-        }
-        return toolError(`Unknown step: ${step}`);
-      } catch (err) {
-        if (err instanceof DatabrainApiError) return err.toToolResponse();
-        return toolError(`Unexpected error: ${err.message}`);
-      }
-    }
-  );
-}
-
 // src/tools/query/ask-question.ts
-import { z as z21 } from "zod";
+import { z as z18 } from "zod";
 var MAX_DISPLAY_ROWS = 50;
 function formatDataTable(data, columns) {
   if (!Array.isArray(data) || data.length === 0) return "_No data returned._";
@@ -4770,16 +3620,16 @@ function registerAskQuestion(server, client) {
     "ask_question",
     "Ask a natural language question \u2014 converts to SQL, returns data + chart suggestion. Requires datamartName with a populated semantic layer.",
     {
-      question: z21.string().describe(
+      question: z18.string().describe(
         'The natural language question to ask (e.g. "What was total revenue last month?")'
       ),
-      datamartName: z21.string().optional().describe(
+      datamartName: z18.string().optional().describe(
         "Name of the datamart to query. Use `list_datamarts` to find available names. REQUIRED unless exactly one datamart exists (auto-resolved). Do NOT pass a workspace name here."
       ),
-      sessionId: z21.string().optional().describe(
+      sessionId: z18.string().optional().describe(
         "Session ID from a previous ask_question response, for follow-up questions."
       ),
-      timezone: z21.string().optional().describe('IANA timezone (e.g. "America/New_York"). Defaults to UTC.')
+      timezone: z18.string().optional().describe('IANA timezone (e.g. "America/New_York"). Defaults to UTC.')
     },
     WRITE_CREATE,
     async (params) => {
@@ -4944,14 +3794,14 @@ To fix this:
 }
 
 // src/tools/query/get-semantic-layer.ts
-import { z as z22 } from "zod";
+import { z as z19 } from "zod";
 function registerGetSemanticLayer(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "get_semantic_layer",
     "Get semantic layer metadata for a datamart: table/column descriptions, synonyms, completion score. Omit datamartName to auto-resolve.",
     {
-      datamartName: z22.string().optional().describe(
+      datamartName: z19.string().optional().describe(
         "Name of the datamart to inspect. Omit to list available datamarts."
       )
     },
@@ -5061,15 +3911,15 @@ ${result.feedback}`);
 }
 
 // src/tools/query/update-semantic-layer.ts
-import { z as z23 } from "zod";
-var columnSchema = z23.object({
-  name: z23.string().describe("Column name (must exist in the datamart)"),
-  description: z23.string().optional().describe("Business-friendly description of what this column represents"),
-  synonyms: z23.array(z23.string()).optional().describe(
+import { z as z20 } from "zod";
+var columnSchema = z20.object({
+  name: z20.string().describe("Column name (must exist in the datamart)"),
+  description: z20.string().optional().describe("Business-friendly description of what this column represents"),
+  synonyms: z20.array(z20.string()).optional().describe(
     'Alternative names users might use for this column (e.g. ["revenue", "sales amount"])'
   ),
-  miscellaneousInfo: z23.string().optional().describe("Additional context such as valid values, units, or caveats"),
-  columnType: z23.enum([
+  miscellaneousInfo: z20.string().optional().describe("Additional context such as valid values, units, or caveats"),
+  columnType: z20.enum([
     "String",
     "Long String",
     "String (Custom)",
@@ -5082,16 +3932,16 @@ var columnSchema = z23.object({
     "JSON"
   ]).nullable().optional().describe('Semantic column type. Use "Identifier" for IDs/foreign keys, "Number" for numeric values, "String" for text. Omit for date columns.')
 });
-var tableSchema = z23.object({
-  name: z23.string().describe("Table name (must exist in the datamart)"),
-  description: z23.string().optional().describe(
+var tableSchema = z20.object({
+  name: z20.string().describe("Table name (must exist in the datamart)"),
+  description: z20.string().optional().describe(
     "Business-friendly description of what this table represents"
   ),
-  synonyms: z23.array(z23.string()).optional().describe("Alternative names for this table"),
-  miscellaneousInfo: z23.string().optional().describe(
+  synonyms: z20.array(z20.string()).optional().describe("Alternative names for this table"),
+  miscellaneousInfo: z20.string().optional().describe(
     "Additional context such as how the table relates to other tables"
   ),
-  columns: z23.array(columnSchema).optional().describe("Column-level semantic definitions to update")
+  columns: z20.array(columnSchema).optional().describe("Column-level semantic definitions to update")
 });
 function registerUpdateSemanticLayer(server, client) {
   const services = createServiceBundle(client);
@@ -5099,13 +3949,13 @@ function registerUpdateSemanticLayer(server, client) {
     "update_semantic_layer",
     "Populate or update the semantic layer for a datamart. Add table/column descriptions, synonyms, context. Required before ask_question works. Auto-generate descriptions from column names when empty.",
     {
-      datamartName: z23.string().optional().describe(
+      datamartName: z20.string().optional().describe(
         "Name of the datamart to update. Omit to list available datamarts."
       ),
-      tables: z23.array(tableSchema).optional().describe(
+      tables: z20.array(tableSchema).optional().describe(
         "Table and column definitions to update. Only include tables/columns you want to change."
       ),
-      feedback: z23.string().optional().describe(
+      feedback: z20.string().optional().describe(
         'General feedback or context about the datamart (e.g. "This datamart contains e-commerce data for the US market").'
       )
     },
@@ -5179,12 +4029,9 @@ function registerAllTools(server, client) {
   registerGetEmbedDetails(server, client);
   registerUpdateEmbed(server, client);
   registerCustomizeTheme(server, client);
-  registerConfigureEmbed(server, client);
-  registerDiagnoseEmbedHealth(server, client);
   registerGenerateGuestToken(server, client);
   registerGenerateEmbedCode(server, client);
   registerListDashboards(server, client);
-  registerSetupEmbedInteractive(server, client);
   registerAskQuestion(server, client);
   registerGetSemanticLayer(server, client);
   registerUpdateSemanticLayer(server, client);
@@ -7637,7 +6484,7 @@ tenant. For example, filter by department or user role within an organization.
 // src/resources/content/use-case-guides.ts
 var useCaseGuidesContent = `# Databrain Use Case Guides
 
-Databrain supports 4 core use cases for embedding analytics. Each maps to a specific MCP prompt and tool sequence.
+Databrain supports 3 core use cases for embedding analytics. Each maps to a specific MCP prompt and tool sequence.
 
 ---
 
@@ -7654,15 +6501,7 @@ Databrain supports 4 core use cases for embedding analytics. Each maps to a spec
 **Tool sequence:** \`list_data_apps\` \u2192 \`list_datamarts\` \u2192 \`create_embed\` with \`clientId\` (per client) \u2192 \`generate_guest_token\` \u2192 \`generate_embed_code\`
 **Key concepts:** \`clientId\` for tenant isolation, \`templateDashboardId\` for cloning, \`tableTenancySettings\` for row-level security.
 
-## Use Case 3: Enable Metric Creation
-**When to use:** You want end-users to build their own metrics/charts on embedded dashboards.
-**Prompt:** \`enable-metric-creation\`
-**Two modes:**
-- **DRAG_DROP:** Visual metric builder \u2014 users drag columns, pick chart types. No AI needed.
-- **CHAT:** AI-powered natural language \u2014 users type questions. Requires LLM connector in Databrain admin.
-**Tool sequence:** \`list_embeds\` \u2192 \`update_embed\` (set accessSettings) \u2192 \`configure_embed\` \u2192 \`generate_guest_token\` (with permissions)
-
-## Use Case 4: Explore and Query Data
+## Use Case 3: Explore and Query Data
 **When to use:** You want to explore available data and ask questions using natural language.
 **Prompt:** \`query-data\` (or \`populate-semantic-layer\` if starting from an empty semantic layer)
 **Path:** Exploration + querying (datasources, datamarts, and workspaces are created in the Databrain UI). The semantic layer is populated via MCP tools.
@@ -7673,17 +6512,17 @@ Databrain supports 4 core use cases for embedding analytics. Each maps to a spec
 
 ## Customization (After Any Setup)
 
-Once an embed exists, use these prompts to customize:
+Once an embed exists, use the \`brand-my-embed\` prompt for theming. For everything else, describe what you need and the assistant uses tools directly:
 
-| Prompt | Purpose |
-|--------|---------|
-| \`brand-my-embed\` | Colors, fonts, chart styles, theme presets |
-| \`setup-filters\` | String, date, number, SQL, and server-side filters |
-| \`localize-embed\` | Multi-language support and locale settings |
-| \`secure-my-embed\` | Permissions, access controls, role-based tokens |
-| \`manage-embeds\` | List, compare, and manage existing embeds |
-| \`query-data\` | Natural language querying and semantic layer management |
-| \`populate-semantic-layer\` | Auto-generate table/column descriptions for AI features |
+| Task | How |
+|------|-----|
+| Colors, fonts, chart styles | Prompt: \`brand-my-embed\` |
+| Filters (string, date, SQL) | \`update_embed\` with \`options.globalFilterOptions\` via body passthrough |
+| Localization / translations | \`update_embed\` with \`componentAttributes\` via body passthrough |
+| Permissions / access controls | \`update_embed\` + \`generate_guest_token\` with permissions |
+| Metric creation modes | \`update_embed\` accessSettings + \`generate_guest_token\` |
+| Manage / audit embeds | \`list_embeds\` \u2192 \`get_embed_details\` |
+| Semantic layer | Prompt: \`populate-semantic-layer\` or \`get_semantic_layer\` / \`update_semantic_layer\` |
 
 ---
 
@@ -7693,9 +6532,8 @@ Once an embed exists, use these prompts to customize:
 |----------|-------------------|
 | Do you have dashboards in Databrain UI? | Yes \u2192 Use Case 1 |
 | Does each client need their own dashboard? | Yes \u2192 Use Case 2 |
-| Do you want end-users to create metrics? | Yes \u2192 Use Case 3 |
-| Want to explore or query your data? | Yes \u2192 Use Case 4 |
-| Just need to brand/filter/secure? | Use customization prompts |
+| Want to explore or query your data? | Yes \u2192 Use Case 3 |
+| Just need to brand/customize? | Use \`brand-my-embed\` prompt or describe what you need |
 `;
 
 // src/resources/content/permission-schema.ts
@@ -7818,7 +6656,7 @@ var resources = [
   {
     uri: "databrain://use-case-guides",
     name: "Use Case Guides",
-    description: "Summary of 4 core use cases with tool sequences, prompt names, and decision guide",
+    description: "Summary of 3 core use cases with tool sequences, prompt names, and decision guide",
     content: useCaseGuidesContent
   },
   {
@@ -7883,7 +6721,7 @@ If creating new: resolve datamartName by calling \`list_datamarts\`, then call \
 - \`accessSettings: { datamartName: "<resolved>" }\` \u2014 only datamartName is needed, the tool fills in all other required defaults automatically. Do NOT add isAllow* fields yourself.
 
 **Step 6 \u2014 Verify Embed**
-Call \`get_embed_details\` and \`diagnose_embed_health\` to verify the embed is properly configured.
+Call \`get_embed_details\` to verify the embed is properly configured.
 Show the user the embed ID and status.
 
 **Step 7 \u2014 Generate Guest Token**
@@ -7900,7 +6738,7 @@ Only after they answer, call \`generate_embed_code\` with the \`embedId\`.
 - Prefer existing embeds when the user already has one for their target dashboard.
 - NEVER ask for service or API tokens \u2014 both are handled automatically.
 - \`workspaceName\` comes from dashboard data, not from the data app name.
-- After setup, suggest: \`brand-my-embed\`, \`setup-filters\`, \`localize-embed\`, \`secure-my-embed\`.`;
+- After setup, suggest: \`brand-my-embed\` for theming. For filters, localization, or permissions, just describe what you need and use \`update_embed\` / \`generate_guest_token\` directly.`;
 
 // src/prompts/embed-blank-dashboard.ts
 var embedBlankDashboardPrompt = `You are guiding a multi-tenant setup where each client gets their own blank (or template-based) dashboard. This is ideal for SaaS platforms where each customer sees their own analytics.
@@ -7964,83 +6802,7 @@ The frontend code is the same for all clients \u2014 the \`clientId\` in the gue
 - STOP after each step. Present results and wait for user input before proceeding.
 - When calling \`create_embed\` with \`clientId\`, only pass \`accessSettings: { datamartName }\` \u2014 the tool fills in all required defaults automatically. Do NOT enumerate isAllow* fields.
 - \`clientId\` must be consistent between embed creation and guest token generation.
-- After setup, suggest: \`brand-my-embed\`, \`setup-filters\`, \`enable-metric-creation\`, \`secure-my-embed\`.`;
-
-// src/prompts/enable-metric-creation.ts
-var enableMetricCreationPrompt = `You are helping the user enable end-user metric creation on their embedded dashboards. Databrain supports two modes: DRAG_DROP (visual builder) and CHAT (AI-powered natural language).
-
-**CRITICAL: This is an interactive guide. You MUST stop and ask the user at each decision point before proceeding. Never assume answers.**
-
-**Two Metric Creation Modes:**
-- **DRAG_DROP**: Visual metric builder where users drag columns, choose chart types, and configure metrics. No AI needed.
-- **CHAT**: AI-powered natural language metric creation. Users type questions like "Show me revenue by month" and Databrain generates the metric. Requires an LLM connector configured in the Databrain admin panel.
-
-**Step 1 \u2014 Identify the Embed**
-Call \`list_embeds\` to show available embeds.
-STOP and ASK the user: "Which embed do you want to enable metric creation on?"
-Only after they answer, call \`get_embed_details\` to see current access settings.
-
-**Step 2 \u2014 Choose the Mode**
-STOP and ASK the user:
-- "Which metric creation mode do you want?"
-  - **DRAG_DROP**: Visual builder, no AI dependency
-  - **CHAT**: AI-powered, requires LLM connector setup in Databrain admin
-Do NOT proceed until the user picks a mode.
-
-If they choose CHAT, tell them: "CHAT mode requires an LLM connector configured in the Databrain admin panel (Settings > AI Configuration). Have you set this up?"
-
-**Step 3 \u2014 Update Embed Access Settings**
-Call \`update_embed\` with the embed ID and updated \`accessSettings\`:
-
-For DRAG_DROP mode:
-\`\`\`json
-{
-  "accessSettings": {
-    "isAllowMetricCreation": true,
-    "metricCreationMode": "DRAG_DROP"
-  }
-}
-\`\`\`
-
-For CHAT mode:
-\`\`\`json
-{
-  "accessSettings": {
-    "isAllowMetricCreation": true,
-    "metricCreationMode": "CHAT"
-  }
-}
-\`\`\`
-
-**Step 4 \u2014 Configure Embed Options**
-Call \`configure_embed\` to ensure the UI supports metric creation:
-- \`disableMetricCreation\`: false
-- \`hideCreateMetricButton\`: false
-- \`hideChartSettings\`: false (so users can customize their created metrics)
-
-**Step 5 \u2014 Set Guest Token Permissions**
-Remind the user: guest token \`permissions\` override embed \`accessSettings\` at runtime. When generating guest tokens via \`generate_guest_token\`, include:
-\`\`\`json
-{
-  "permissions": {
-    "isDisableMetricCreation": false
-  }
-}
-\`\`\`
-
-**Step 6 \u2014 Verify and Test**
-Call \`get_embed_details\` to verify the settings were applied correctly.
-Tell the user to refresh their embed and look for the "+ Create Metric" button.
-
-If using CHAT mode, remind the user:
-- An LLM connector must be configured in Databrain admin (Settings > AI Configuration)
-- The datamart should have a populated semantic layer for best AI results (use \`get_semantic_layer\` to check, and \`update_semantic_layer\` or the \`populate-semantic-layer\` prompt to populate it)
-
-**Important rules:**
-- STOP and ASK at each decision point. Never skip ahead.
-- Guest token \`permissions\` take precedence over embed \`accessSettings\` \u2014 both must allow metric creation.
-- CHAT mode requires external LLM connector setup (not available via MCP).
-- After enabling, suggest: \`secure-my-embed\` to fine-tune which users get metric creation access.`;
+- After setup, suggest: \`brand-my-embed\` for theming. For filters, metric creation, or permissions, just describe what you need and use \`update_embed\` / \`generate_guest_token\` directly.`;
 
 // src/prompts/brand-my-embed.ts
 var brandMyEmbedPrompt = `You are helping the user brand and visually customize their embedded Databrain dashboard. Follow these steps.
@@ -8084,7 +6846,7 @@ Use \`customize_embed_theme\` with the chart appearance params to fine-tune char
 Ask if they want to customize tooltip fonts, axis styling, or label positions.
 
 **Step 5 \u2014 Configure Display Options**
-Use \`configure_embed\` to clean up the UI:
+Use \`update_embed\` (body passthrough) to clean up the UI:
 - Ask if they want to hide the dashboard name (\`hideDashboardName\`)
 - Ask about card shadows and borders
 - Ask about download/export options they want to show
@@ -8117,327 +6879,6 @@ Iterate by calling the relevant tools again with adjusted values. Remember: all
 
 **Reference**: Use \`databrain://theme-reference\` for the full theme schema and \`databrain://web-component-reference\` for all component attributes.`;
 
-// src/prompts/localize-embed.ts
-var localizeEmbedPrompt = `You are helping the user set up multi-language support for their embedded Databrain dashboard. Follow these steps.
-
-**Step 1 \u2014 Identify the Embed and Target Languages**
-Call \`list_embeds\` and ask the user which embed to localize. Then ask:
-- Which languages do they need? (Supported: English, French, Spanish, German, Italian, Portuguese, Chinese, Japanese, Korean, Hindi, Arabic, Russian)
-- What is the default/primary language?
-
-**Step 2 \u2014 Set the Primary Language**
-Use \`configure_embed\` with the \`language\` parameter set to their primary language code (e.g. "fr" for French).
-
-**Step 3 \u2014 Gather Translations**
-Call \`get_embed_details\` to understand what text is in the dashboard. Then help the user build translations:
-
-Ask the user to list the key text elements in their dashboard:
-- Dashboard title
-- Metric titles and descriptions
-- Filter labels
-- Any footnotes or annotations
-
-For each text element, ask for translations in their target languages. Build translation entries like:
-\`\`\`
-{ key: "Revenue", translations: { fr: "Revenus", es: "Ingresos", de: "Einnahmen" } }
-\`\`\`
-
-**Important rules for translation keys:**
-- Keys must match the dashboard text EXACTLY (case-sensitive)
-- Define longer keys before shorter ones to avoid partial matches
-- If a translation is missing for a language, the original key text is shown as fallback
-
-**Step 4 \u2014 Apply Translations**
-Use \`configure_embed\` with the \`translations\` array containing all entries.
-
-**Step 5 \u2014 Configure Calendar (if needed)**
-Ask if they need a different calendar system:
-- \`"default"\` \u2014 standard Gregorian calendar
-- \`"ind"\` \u2014 Indian calendar format
-
-Set via \`calendarType\` in \`configure_embed\` (\`language\` and \`calendarType\` params).
-
-**Step 6 \u2014 Set Custom Messages**
-Ask if they want to translate system messages:
-- Token expiry message (shown when session expires)
-- Token absent message (shown when no auth token)
-
-Use \`configure_embed\` with \`tokenExpiryMessage\` and \`tokenAbsentMessage\` in their primary language.
-
-**Step 7 \u2014 Test**
-Tell the user to refresh the embed and verify translations appear correctly. If any text isn't translating, double-check that the key matches exactly.
-
-Remind the user: translations can also be applied per-user at the web component level using the \`translation-dictionary\` attribute, which is useful for dynamically switching languages based on user preferences.
-
-**Tip:** The \`language\`, \`calendarType\`, \`hideDashboardFilters\`, and filter settings are all available in the same \`configure_embed\` tool.
-
-**Important:** After changing language or translation settings, existing guest tokens still carry the old configuration. Remind the user to **regenerate guest tokens** (or reload their app) for changes to take effect.`;
-
-// src/prompts/secure-my-embed.ts
-var secureMyEmbedPrompt = `You are helping the user secure and configure permissions for their embedded Databrain dashboard. Follow these steps.
-
-**Step 1 \u2014 Understand User Roles**
-Ask the user about their end-user roles. Common patterns:
-- **Viewer** \u2014 can see data, maybe filter, but can't modify anything
-- **Analyst** \u2014 can export data, drill down, use filters
-- **Builder/Power User** \u2014 can create/edit metrics, change layouts
-- **Admin** \u2014 full access including AI features
-
-Ask: "What roles do your end-users have? What should each role be allowed to do?"
-
-**Step 2 \u2014 Lock Down the Embed Defaults**
-Use \`configure_embed\` to set restrictive defaults (principle of least privilege):
-
-\`\`\`
-configure_embed(embedId,
-  disableMetricCreation: true,
-  disableMetricUpdation: true,
-  disableMetricDeletion: true,
-  disableManageMetrics: true,
-  disableLayoutCustomization: true,
-  disableSaveLayout: true,
-  disableUnderlyingData: true,
-  disableScheduleEmailReports: true,
-  enableDownloadCsv: false,
-  enableDownloadAllPdf: false)
-\`\`\`
-
-Explain: "We start with everything locked down, then use guest token permissions to grant access per role."
-
-**Step 3 \u2014 Create Role-Based Guest Token Examples**
-Show the user how to generate tokens for each role:
-
-**Viewer (default \u2014 no overrides needed):**
-\`\`\`
-generate_guest_token(clientId, dataAppName)
-\`\`\`
-
-**Analyst (can export and drill down):**
-\`\`\`
-generate_guest_token(clientId, dataAppName, {
-  permissions: {
-    isEnableDownloadMetrics: true,
-    isEnableUnderlyingData: true
-  }
-})
-\`\`\`
-
-**Builder (can create and edit):**
-\`\`\`
-generate_guest_token(clientId, dataAppName, {
-  permissions: {
-    isEnableManageMetrics: true,
-    isEnableMetricUpdation: true,
-    isEnableCustomizeLayout: true
-  }
-})
-\`\`\`
-
-**Admin (full access with AI):**
-\`\`\`
-generate_guest_token(clientId, dataAppName, {
-  permissions: {
-    isEnableManageMetrics: true,
-    isEnableMetricUpdation: true,
-    isEnableCustomizeLayout: true,
-    isEnableDownloadMetrics: true,
-    isEnableUnderlyingData: true
-  }
-})
-\`\`\`
-
-**Step 4 \u2014 Multi-Tenancy Check**
-Ask: "Do different customers/organizations see different data?"
-
-If yes:
-- Explain that \`clientId\` in the guest token controls row-level security
-- The \`clientId\` must match values in the datamart's client column
-- Suggest using \`params.appFilters\` / \`params.dashboardAppFilters\` in \`generate_guest_token\` for server-side row-level filtering
-
-**Step 5 \u2014 Security Checklist**
-Walk through this checklist with the user:
-
-1. \u2705 API token is stored server-side only (never in frontend code)
-2. \u2705 Guest tokens are generated server-side per request
-3. \u2705 Guest tokens have appropriate expiry time
-4. \u2705 Embed defaults are restrictive (locked down in Step 2)
-5. \u2705 Role-based permissions are granted via guest token overrides
-6. \u2705 Multi-tenancy is configured if serving multiple customers
-7. \u2705 Download restrictions are set (\`disableDownloadDataNoFilters\` if needed)
-
-**Step 6 \u2014 Generate Secure Frontend Code**
-Call \`generate_embed_code\` for their framework. Emphasize that the generated code includes a backend route for token generation \u2014 this is the secure pattern.
-
-When reviewing runtime behavior (for example missing \`+ Create Metric\`), verify contract shape explicitly:
-- Guest token request body must send \`permissions\` at top level (not nested inside \`params\`)
-- Include \`dataAppName\` at top level
-- For metric creation flows, ensure \`permissions.isDisableMetricCreation=false\` and \`permissions.isEnableManageMetrics=true\`
-- Confirm embed options do not set \`disableMetricCreation=true\`
-- In browser network response for \`/api/v2/dashboard\`, confirm \`isAllowedToCreateMetrics=true\` and \`metricCreationMode=DRAG_DROP\`
-
-**Important:** After changing embed permissions or access settings, existing guest tokens still carry the old configuration. Remind the user to **regenerate guest tokens** (or reload their app) for changes to take effect.
-
-**Reference**: Use \`databrain://self-serve-reference\` for all permission flags and \`databrain://multi-tenancy-guide\` for row-level security details.`;
-
-// src/prompts/setup-filters.ts
-var setupFiltersPrompt = `You are helping the user configure dashboard filters for their embedded Databrain dashboard. Follow these steps.
-
-**Step 1 \u2014 Understand the Data**
-Call \`list_embeds\` and ask which embed to configure. Then call \`get_embed_details\` to see the current filter configuration.
-
-**Step 2 \u2014 Identify Filter Needs**
-Ask the user:
-- "What filters do your end-users need?" (e.g. date range, region, product category, status)
-- "Should any filters have default values?"
-- "Are there filters you want to hide from end-users?" (e.g. internal IDs)
-- "Do any filters have very large option lists?" (100+ options \u2014 these benefit from SQL-based filters)
-
-**Step 3 \u2014 Configure String Filters**
-For text/category filters, use \`configure_embed\` with \`stringFilters\`:
-
-\`\`\`
-stringFilters: [{
-  filterName: "Region",
-  options: [
-    { value: "US", label: "United States" },
-    { value: "EU", label: "Europe" },
-    { value: "APAC", label: "Asia Pacific" }
-  ],
-  defaultOption: "US"
-}]
-\`\`\`
-
-For multi-select defaults, use an array: \`defaultOption: ["US", "EU"]\`
-
-**Step 4 \u2014 Configure Date Filters**
-For date range filters, use \`dateFilters\`:
-
-\`\`\`
-dateFilters: [{
-  filterName: "Date Range",
-  startDate: "2024-01-01",
-  endDate: "2024-12-31",
-  datePresetOptions: [
-    { label: "Last 30 Days", type: "Last", interval: "Days" },
-    { label: "This Quarter", type: "This", interval: "Quarter" },
-    { label: "This Year", type: "This", interval: "Year" }
-  ]
-}]
-\`\`\`
-
-**Step 5 \u2014 Configure Number Filters**
-For numeric range filters, use \`numberFilters\`:
-
-\`\`\`
-numberFilters: [{
-  filterName: "Revenue",
-  min: 0,
-  max: 1000000
-}]
-\`\`\`
-
-**Step 6 \u2014 SQL-Based Filters (for large datasets)**
-If a filter has 100+ options (e.g. company names, product SKUs), use \`sqlFilters\`:
-
-\`\`\`
-sqlFilters: [{
-  filterName: "Company",
-  sql: "SELECT DISTINCT \\"company_name\\" FROM \\"companies\\" ORDER BY \\"company_name\\"",
-  columnName: "company_name"
-}]
-\`\`\`
-
-Explain: "SQL filters dynamically fetch options from the database, so they're always up-to-date and don't bloat the embed configuration."
-
-**Step 7 \u2014 Hide Unnecessary Filters**
-If the user has filters that should be hidden (e.g. internal IDs, tenant columns already handled by clientId):
-
-\`\`\`
-hideDashboardFilters: ["internal_id", "tenant_id"]
-\`\`\`
-
-**Step 8 \u2014 Configure Date Picker Options**
-Ask if they want to hide certain date picker presets:
-
-\`\`\`
-hideDatePickerOptions: ["yesterday", "last week"]
-\`\`\`
-
-**Step 9 \u2014 Metric Filter Position**
-Ask: "Do you want metric-level filters inside the card or outside?"
-- \`"inside"\` \u2014 compact, within each metric card (default)
-- \`"outside"\` \u2014 above the card, more prominent
-
-Also ask if they want cross-metric filtering (\`enableMultiMetricFilters\`).
-
-**Step 10 \u2014 Server-Side Filters (via Guest Token)**
-If the user needs filters that end-users cannot remove (e.g. for security):
-- Explain that \`appFilters\` in \`generate_guest_token\` are server-side enforced
-- These are invisible to the end-user and cannot be overridden
-- Perfect for tenant filtering, role-based data access, or compliance requirements
-
-Show an example:
-\`\`\`
-generate_guest_token(clientId, dataAppName, {
-  params: {
-    appFilters: [{
-      metricId: "metric_123",
-      values: {
-        region: ["US", "CA"]
-      }
-    }]
-  }
-})
-\`\`\`
-
-**Important:** After changing filter settings, existing guest tokens still carry the old configuration. Remind the user to **regenerate guest tokens** (or reload their app) for changes to take effect.
-
-**Reference**: Use \`databrain://filter-reference\` for all filter types, operators, and combination rules.`;
-
-// src/prompts/manage-embeds.ts
-var manageEmbedsPrompt = `You are helping the user manage Databrain embed configurations \u2014 list, compare, and review settings. Follow these steps based on what the user needs.
-
-**Step 1 \u2014 Understand the Task**
-Ask the user what they want to do:
-1. **List and compare embeds** \u2014 see all embeds and their configurations
-2. **Review embed settings** \u2014 audit theme, permissions, and options
-
-**For Listing and Comparing Embeds:**
-1. Call \`list_embeds\` to show all embed configurations
-2. For detailed comparison, call \`get_embed_details\` on each embed the user wants to compare
-3. Present a comparison table showing:
-   - Embed name and ID
-   - Linked dashboard
-   - Theme (preset or custom)
-   - Key permissions (metric creation, downloads, AI pilot)
-   - Multi-tenancy settings
-
-**For Reviewing Embed Settings:**
-1. Call \`get_embed_details\` for the embed
-2. Present a clear summary organized by category:
-
-   **Theme:**
-   - Current preset or custom theme values
-   - Suggest \`customize_embed_theme\` if they want changes
-
-   **Permissions / Access Settings:**
-   - What's enabled vs disabled
-   - Suggest \`configure_embed\` for changes
-
-   **Filters:**
-   - Current filter configuration
-   - Suggest \`configure_embed\` with filter params for changes
-
-   **Internationalization:**
-   - Current language and translations
-   - Suggest \`configure_embed\` with \`language\` and \`translations\` params for changes
-
-3. Ask: "Would you like to modify any of these settings?"
-
-**Tips:**
-- Embed IDs are permanent \u2014 even if you rename an embed, the ID stays the same
-- After any embed setting changes, existing guest tokens still carry the old configuration \u2014 **regenerate guest tokens** for changes to take effect`;
-
 // src/prompts/query-data.ts
 var queryDataPrompt = `You are helping the user query their data using natural language. Databrain's AI converts questions into SQL, runs them against the database, and returns results with chart type suggestions.
 
@@ -8606,36 +7047,11 @@ var prompts = [
     description: "Multi-tenant blank dashboard setup: each client gets their own dashboard copy via create_embed with clientId",
     content: embedBlankDashboardPrompt
   },
-  {
-    name: "enable-metric-creation",
-    description: "Enable end-user metric creation on embeds: DRAG_DROP (visual) or CHAT (AI-powered) modes",
-    content: enableMetricCreationPrompt
-  },
   {
     name: "brand-my-embed",
     description: "Customize colors, fonts, chart styles, and component theme to match your brand",
     content: brandMyEmbedPrompt
   },
-  {
-    name: "localize-embed",
-    description: "Set up multi-language support with translations and locale settings",
-    content: localizeEmbedPrompt
-  },
-  {
-    name: "secure-my-embed",
-    description: "Configure permissions, access controls, and role-based guest tokens",
-    content: secureMyEmbedPrompt
-  },
-  {
-    name: "setup-filters",
-    description: "Configure dashboard filters: string, date, number, SQL-based, and server-side filters",
-    content: setupFiltersPrompt
-  },
-  {
-    name: "manage-embeds",
-    description: "List, compare, rename, delete embeds and rotate API tokens",
-    content: manageEmbedsPrompt
-  },
   {
     name: "query-data",
     description: "Query your data with natural language: ask questions, get results with chart suggestions, manage the semantic layer",
@@ -8676,17 +7092,18 @@ function createServer(config) {
 \u2022 SERVICE TOKEN (DATABRAIN_SERVICE_TOKEN): org-level, pre-configured in MCP server config. Used for: list_datasources, discover_datasource_schema, list_datamarts, list_workspaces, link_datamart_to_workspace, list_data_apps, create_data_app, list_api_tokens, create_api_token, rotate_api_token, list_dashboards (workspace scope), ask_question, get_semantic_layer, update_semantic_layer. You already have this \u2014 never ask the user for it.
 \u2022 API TOKEN (per data app): scoped to one data app, used for embedding operations (list_embeds, get_embed_details, create_embed, update_embed, generate_guest_token) and data-app scoped dashboard listing. Created/rotated via create_api_token or rotate_api_token during setup.
 
-4 core use cases \u2014 match the user's scenario to the right prompt:
+3 core use cases \u2014 match the user's scenario to the right prompt:
 1. Embed existing dashboard \u2192 prompt: embed-existing-dashboard (list_data_apps \u2192 create_api_token \u2192 list_dashboards \u2192 create_embed \u2192 generate_guest_token \u2192 generate_embed_code)
 2. Blank dashboard per client \u2192 prompt: embed-blank-dashboard (list_data_apps \u2192 list_datamarts \u2192 create_embed with clientId per client \u2192 generate_guest_token \u2192 generate_embed_code)
-3. Enable metric creation \u2192 prompt: enable-metric-creation (list_embeds \u2192 update_embed accessSettings \u2192 configure_embed \u2192 generate_guest_token with permissions)
-4. Explore & query data \u2192 prompt: query-data (list_datamarts \u2192 get_semantic_layer \u2192 if empty, auto-generate descriptions with update_semantic_layer or use populate-semantic-layer prompt \u2192 ask_question)
+3. Explore & query data \u2192 prompt: query-data (list_datamarts \u2192 get_semantic_layer \u2192 if empty, auto-generate descriptions with update_semantic_layer or use populate-semantic-layer prompt \u2192 ask_question)
 
 Infrastructure CREATION (datasources, datamarts, workspaces) is done in the Databrain UI.
 However, the **semantic layer** is populated and maintained entirely via MCP tools (get_semantic_layer, update_semantic_layer). When the semantic layer is empty, YOU (the assistant) should auto-generate descriptions from table/column names and push them with update_semantic_layer \u2014 do NOT send the user to the UI for this.
 
-After embed setup, customize with: brand-my-embed, setup-filters, localize-embed, secure-my-embed.
+After embed setup, customize with: brand-my-embed prompt for theming. Use update_embed (body passthrough) for filters, localization, and permissions.
 Use generate_guest_token for frontend auth and generate_embed_code for framework snippets.
+For advanced embed configuration (UI toggles, filters, i18n), use update_embed with a body passthrough.
+To diagnose embed issues, use get_embed_details and reason about the response.
 Do NOT ask the user for any tokens \u2014 manage them via MCP tools.
 
 IMPORTANT \u2014 accessSettings defaults:
@@ -8717,7 +7134,7 @@ async function main() {
     const server = createServer(config);
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    banner(`v${VERSION} ready (24 tools, 11 resources, 10 prompts)`);
+    banner(`v${VERSION} ready (21 tools, 11 resources, 5 prompts)`);
   } catch (error) {
     logger.error("Failed to start server", error);
     process.exit(1);