@databrainhq/mcp-server 0.3.0-rc.2 → 0.3.0-rc.4

package/dist/{chunk-3AFT7S6E.js → chunk-I35U2LBX.js}

@@ -24,7 +24,7 @@ var logger = {
 // package.json
 var package_default = {
   name: "@databrainhq/mcp-server",
-  version: "0.3.0-rc.2",
+  version: "0.3.0-rc.4",
   description: "MCP server for Databrain embedded analytics - connect databases, create datamarts, configure embeds, and generate frontend code",
   type: "module",
   bin: {
@@ -577,6 +577,7 @@ import { z as z2 } from "zod";
 var CHART_URI = "ui://databrain/chart-tile";
 var KPI_URI = "ui://databrain/kpi-tile";
 var APP_MIME = "text/html;profile=mcp-app";
+var RESOURCE_URI_META_KEY = "ui/resourceUri";
 var PAGE_SIZE = 50;
 var MAX_RESULT_CHARS = 125e3;
 var id = z2.string().trim().min(1).max(256);
@@ -639,6 +640,9 @@ function firstRows(value) {
 }
 
 // src/apps/feature.ts
+function appMeta(visibility) {
+  return { ui: { resourceUri: CHART_URI, visibility }, [RESOURCE_URI_META_KEY]: CHART_URI };
+}
 var enabled = /* @__PURE__ */ new WeakSet();
 function enableChartApps(server) {
   enabled.add(server);
@@ -647,75 +651,95 @@ function hasChartApps(server) {
   return enabled.has(server);
 }
 function tagChartTool(server, tool) {
-  if (hasChartApps(server)) tool.update({ _meta: { ui: { resourceUri: CHART_URI, visibility: ["model", "app"] } } });
+  if (hasChartApps(server)) tool.update({ _meta: appMeta(["model", "app"]) });
 }
 function chartResult(summary, payload) {
-  return bounded({ content: [{ type: "text", text: summary }], structuredContent: payload });
+  return bounded({
+    content: [{ type: "text", text: summary }],
+    structuredContent: payload,
+    _meta: appMeta(["model", "app"])
+  });
 }
 
 // src/tools/tool-metadata.ts
 var DEFAULT_TOOL_META = {
   category: "discovery",
-  workflowIntent: "other"
+  workflowIntent: "other",
+  // Fail closed: an unregistered/unclassified tool is treated as a commit
+  // until someone deliberately marks it read or view.
+  effect: "commit"
 };
 var TOOL_METADATA = {
   // Identity / discovery
-  whoami: { category: "discovery", workflowIntent: "discovery" },
+  whoami: { category: "discovery", workflowIntent: "discovery", effect: "read" },
   // Infrastructure / data setup
-  list_datasources: { category: "infrastructure", workflowIntent: "setup_data" },
-  discover_datasource_schema: { category: "infrastructure", workflowIntent: "setup_data" },
-  list_datamarts: { category: "infrastructure", workflowIntent: "setup_data" },
-  list_workspaces: { category: "infrastructure", workflowIntent: "setup_data" },
-  sync_datasource: { category: "infrastructure", workflowIntent: "setup_data" },
-  create_datamart: { category: "infrastructure", workflowIntent: "setup_data" },
+  list_datasources: { category: "infrastructure", workflowIntent: "setup_data", effect: "read" },
+  discover_datasource_schema: { category: "infrastructure", workflowIntent: "setup_data", effect: "read" },
+  list_datamarts: { category: "infrastructure", workflowIntent: "setup_data", effect: "read" },
+  list_workspaces: { category: "infrastructure", workflowIntent: "setup_data", effect: "read" },
+  // Triggers a backend sync job that refreshes stored schema metadata — a real mutation, not a read.
+  sync_datasource: { category: "infrastructure", workflowIntent: "setup_data", effect: "commit" },
+  // dry_run is the default, but mode:"apply" performs a real POST that creates the datamart.
+  create_datamart: { category: "infrastructure", workflowIntent: "setup_data", effect: "commit" },
   // Embedding — data apps & tokens
-  list_data_apps: { category: "embedding", workflowIntent: "embed_dashboard" },
-  list_tenants: { category: "embedding", workflowIntent: "embed_dashboard" },
-  create_data_app: { category: "embedding", workflowIntent: "embed_dashboard" },
-  list_api_tokens: { category: "embedding", workflowIntent: "embed_dashboard" },
-  create_api_token: { category: "embedding", workflowIntent: "embed_dashboard" },
-  rotate_api_token: { category: "embedding", workflowIntent: "embed_dashboard" },
+  list_data_apps: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  list_tenants: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  create_data_app: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  list_api_tokens: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  create_api_token: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  rotate_api_token: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
   // Embedding — embed management
-  create_embed: { category: "embedding", workflowIntent: "embed_dashboard" },
-  list_embeds: { category: "embedding", workflowIntent: "embed_dashboard" },
-  get_embed_details: { category: "embedding", workflowIntent: "embed_dashboard" },
-  update_embed: { category: "embedding", workflowIntent: "embed_dashboard" },
-  customize_embed_theme: { category: "embedding", workflowIntent: "embed_dashboard" },
-  get_demo_link: { category: "embedding", workflowIntent: "embed_dashboard" },
+  create_embed: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  list_embeds: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  get_embed_details: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  update_embed: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  // Persists theme/access config on the embed record — a real write, not a display-only tweak.
+  customize_embed_theme: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  // Mints and returns a live guest token embedded in the demo URL.
+  get_demo_link: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
   // Embedding — frontend
-  generate_guest_token: { category: "embedding", workflowIntent: "embed_dashboard" },
-  generate_embed_code: { category: "embedding", workflowIntent: "embed_dashboard" },
+  generate_guest_token: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  generate_embed_code: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
   // Embedding — customer dashboards & widgets
-  list_dashboards: { category: "embedding", workflowIntent: "embedded_widget" },
-  create_dashboard: { category: "embedding", workflowIntent: "author_dashboard" },
-  get_dashboard: { category: "embedding", workflowIntent: "author_dashboard" },
-  generate_dashboard_tiles: { category: "embedding", workflowIntent: "author_dashboard" },
-  list_widgets: { category: "embedding", workflowIntent: "embedded_widget" },
-  add_widget: { category: "embedding", workflowIntent: "embedded_widget" },
-  update_widget: { category: "embedding", workflowIntent: "embedded_widget" },
-  remove_widget: { category: "embedding", workflowIntent: "embedded_widget" },
-  generate_widget: { category: "embedding", workflowIntent: "embedded_widget" },
-  validate_metric_spec: { category: "embedding", workflowIntent: "sql_to_embedded_metric" },
+  list_dashboards: { category: "embedding", workflowIntent: "embedded_widget", effect: "read" },
+  create_dashboard: { category: "embedding", workflowIntent: "author_dashboard", effect: "commit" },
+  get_dashboard: { category: "embedding", workflowIntent: "author_dashboard", effect: "read" },
+  // Does not persist a dashboard, but mints an internal guest token to render tile previews.
+  generate_dashboard_tiles: { category: "embedding", workflowIntent: "author_dashboard", effect: "commit" },
+  list_widgets: { category: "embedding", workflowIntent: "embedded_widget", effect: "read" },
+  add_widget: { category: "embedding", workflowIntent: "embedded_widget", effect: "commit" },
+  update_widget: { category: "embedding", workflowIntent: "embedded_widget", effect: "commit" },
+  remove_widget: { category: "embedding", workflowIntent: "embedded_widget", effect: "commit" },
+  // Returns an unsaved draft, but mints an internal write-capable guest token to generate it.
+  generate_widget: { category: "embedding", workflowIntent: "embedded_widget", effect: "commit" },
+  // Dry-run validation only, but mints an internal write-capable guest token to check conflicts.
+  validate_metric_spec: { category: "embedding", workflowIntent: "sql_to_embedded_metric", effect: "commit" },
   create_or_update_metric_from_query: {
     category: "embedding",
-    workflowIntent: "sql_to_embedded_metric"
+    workflowIntent: "sql_to_embedded_metric",
+    effect: "commit"
   },
   // Internal analytics
   create_workspace_metric: {
     category: "internal_analytics",
-    workflowIntent: "sql_to_workspace_metric"
+    workflowIntent: "sql_to_workspace_metric",
+    effect: "commit"
   },
-  ask_question: { category: "internal_analytics", workflowIntent: "query_data" },
+  // Runs a query and returns rows; no dashboard/widget/row is persisted.
+  ask_question: { category: "internal_analytics", workflowIntent: "query_data", effect: "read" },
+  preview_chart: { category: "internal_analytics", workflowIntent: "query_data", effect: "view" },
+  save_chart_as_dashboard: { category: "internal_analytics", workflowIntent: "author_dashboard", effect: "commit" },
   // Semantic layer
-  get_semantic_layer: { category: "semantic_layer", workflowIntent: "query_data" },
-  update_semantic_layer: { category: "semantic_layer", workflowIntent: "query_data" },
-  start_semantic_layer_generation: { category: "semantic_layer", workflowIntent: "query_data" },
+  get_semantic_layer: { category: "semantic_layer", workflowIntent: "query_data", effect: "read" },
+  update_semantic_layer: { category: "semantic_layer", workflowIntent: "query_data", effect: "commit" },
+  start_semantic_layer_generation: { category: "semantic_layer", workflowIntent: "query_data", effect: "commit" },
   get_semantic_layer_generation_status: {
     category: "semantic_layer",
-    workflowIntent: "query_data"
+    workflowIntent: "query_data",
+    effect: "read"
   },
   // Reports
-  list_scheduled_reports: { category: "reports", workflowIntent: "reports" }
+  list_scheduled_reports: { category: "reports", workflowIntent: "reports", effect: "read" }
 };
 
 // src/tools/data-app/list-data-apps.ts
@@ -5315,8 +5339,157 @@ function registerGetDashboard(server, client) {
   );
 }
 
-// src/tools/query/ask-question.ts
+// src/apps/preview.ts
+import { createHash } from "crypto";
 import { z as z25 } from "zod";
+var draftSchema = z25.object({
+  question: z25.string().min(1).max(2e3),
+  sql: z25.string().min(1).max(2e4),
+  datamartName: z25.string().min(1).max(256),
+  dimensions: z25.array(z25.string().max(128)).max(20).default([]),
+  measures: z25.array(z25.string().max(128)).max(20).default([]),
+  chartType: z25.string().min(1).max(80),
+  title: z25.string().min(1).max(200),
+  sessionId: z25.string().max(256).optional(),
+  /** Workspaces built on this datamart. One means Save needs no choice. */
+  workspaces: z25.array(z25.string().max(256)).max(50).default([])
+}).strict();
+var PREVIEW_PATH = "/api/v2/data-app/chart-preview";
+var METRIC_PATH = "/api/mcp/metrics/create";
+var DASHBOARD_PATH = "/api/v2/workspace/dashboard";
+var PREVIEW_TYPES = ["bar", "row", "line", "area", "pie", "doughnut", "table"];
+var RENDER_TYPES = [...PREVIEW_TYPES, "single value"];
+async function previewPage(client, draft, rows, chartType) {
+  const page = await client.request({
+    method: "POST",
+    path: PREVIEW_PATH,
+    auth: "service",
+    skipDataUnwrap: true,
+    body: {
+      rows: firstRows(rows),
+      chartType,
+      title: draft.title,
+      dimensions: draft.dimensions,
+      measures: draft.measures,
+      width: 600,
+      height: 320
+    }
+  });
+  return pageSchema.parse(page);
+}
+function tablePage(draft, rows) {
+  const page = firstRows(rows);
+  return {
+    kind: "table",
+    title: draft.title,
+    chartSpec: { type: "table" },
+    rows: page,
+    columns: Object.keys(page[0] ?? {})
+  };
+}
+async function draftPage(client, draft, rows, chartType) {
+  const data = rowsSchema.parse(firstRows(rows));
+  const carry = { draft: { ...draft, chartType }, previewTypes: PREVIEW_TYPES };
+  if (chartType === "table" || !data.length) return { ...tablePage(draft, data), ...carry };
+  try {
+    return { ...await previewPage(client, draft, data, chartType), ...carry };
+  } catch (error) {
+    const previewError = error instanceof DatabrainApiError ? error.code : "PREVIEW_UNAVAILABLE";
+    return { ...tablePage(draft, data), ...carry, draft: { ...draft, chartType: "table" }, previewError };
+  }
+}
+var sameName = (a, b) => typeof a === "string" && a.trim().toLowerCase() === b.trim().toLowerCase();
+async function workspacesForDatamart(client, datamartName, mode = "hint") {
+  const cached = (key) => mode === "hint" ? { cacheKey: key, cacheTtlMs: 5 * 60 * 1e3 } : {};
+  try {
+    const [workspaces, datamarts] = await Promise.all([
+      client.request({ method: "GET", path: "/api/v2/workspace", auth: "service", ...cached("list_workspaces") }),
+      client.request({ method: "GET", path: "/api/v2/data-app/datamarts", auth: "service", ...cached("list_datamarts") })
+    ]);
+    const datasource = (Array.isArray(datamarts) ? datamarts : []).find((d) => sameName(d?.name ?? d?.datamartName, datamartName))?.companyIntegration?.id;
+    const all = (Array.isArray(workspaces) ? workspaces : []).filter((w) => typeof w?.name === "string");
+    const onDatamart = all.filter((w) => sameName(w.datamart?.name ?? w.datamartName, datamartName));
+    const onDatasource = datasource ? all.filter((w) => !w.datamart && w.companyIntegration?.id === datasource) : [];
+    return [...new Set([...onDatamart, ...onDatasource].map((w) => w.name))];
+  } catch {
+    return [];
+  }
+}
+function saveKey(draft, input) {
+  const h = createHash("sha256").update(JSON.stringify({
+    sql: draft.sql,
+    datamartName: draft.datamartName,
+    workspaceName: input.workspaceName,
+    dashboardTitle: input.dashboardTitle,
+    chartType: input.chartType,
+    // One attempt, many retries: the tile mints an id when the form opens and re-sends it on
+    // retry, so a retry replays and a fresh Save is a fresh key. Without one, content is the key.
+    attemptId: input.attemptId ?? null
+  })).digest();
+  h[6] = h[6] & 15 | 64;
+  h[8] = h[8] & 63 | 128;
+  const x = h.subarray(0, 16).toString("hex");
+  return `${x.slice(0, 8)}-${x.slice(8, 12)}-${x.slice(12, 16)}-${x.slice(16, 20)}-${x.slice(20, 32)}`;
+}
+async function saveDraftAsDashboard(client, draft, input) {
+  const metric = await client.request({
+    method: "POST",
+    path: METRIC_PATH,
+    auth: "service",
+    body: {
+      workspaceName: input.workspaceName,
+      name: input.dashboardTitle,
+      query: draft.sql,
+      description: draft.question,
+      isPublished: false,
+      validateOnly: false
+    }
+  });
+  const metricId = metric?.metricId || metric?.id;
+  if (!metricId) throw new DatabrainApiError(502, "METRIC_ID_MISSING", "The metric was created but returned no id.");
+  const slug = input.dashboardTitle.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 63) || "chart";
+  const body = {
+    schemaVersion: 1,
+    title: input.dashboardTitle,
+    description: draft.question,
+    layout: { columns: 24 },
+    tiles: [{
+      id: slug,
+      kind: "databrain-chart",
+      title: input.dashboardTitle,
+      position: { x: 0, y: 0, w: 12, h: 8 },
+      chart: { type: input.chartType, metricRef: metricId }
+    }]
+  };
+  const dashboard = await client.request({
+    method: "POST",
+    path: DASHBOARD_PATH,
+    auth: "service",
+    query: { workspaceName: input.workspaceName },
+    headers: { "Idempotency-Key": saveKey(draft, input) },
+    body,
+    invalidateCache: ["list_dashboards"],
+    // A metadata insert: 15s keeps the attempt and its retries inside the host's 60s window.
+    timeoutMs: 15e3
+  });
+  if (!dashboard?.dashboardId) {
+    throw new DatabrainApiError(502, "DASHBOARD_ID_MISSING", `Metric ${metricId} was saved but the dashboard returned no id.`);
+  }
+  return { dashboardId: dashboard.dashboardId, metricId, workspaceName: input.workspaceName, title: input.dashboardTitle };
+}
+
+// src/tools/query/ask-question.ts
+import { z as z26 } from "zod";
+function normalizePreviewType(type) {
+  const t = (type || "").toLowerCase().trim();
+  if (RENDER_TYPES.includes(t)) return t;
+  if (t === "single value" || t === "kpi" || t === "number") return "single value";
+  if (t === "time series" || t === "stepped") return "line";
+  if (t === "stack" || t === "column") return "bar";
+  if (t === "horizontal stack" || t === "horizontal bar") return "row";
+  if (t === "stacked area") return "area";
+  return "table";
+}
 var MAX_DISPLAY_ROWS = 50;
 function formatDataTable(data, columns) {
   if (!Array.isArray(data) || data.length === 0) return "_No data returned._";
@@ -5346,16 +5519,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: z25.string().describe(
+      question: z26.string().describe(
         'The natural language question to ask (e.g. "What was total revenue last month?")'
       ),
-      datamartName: z25.string().optional().describe(
+      datamartName: z26.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: z25.string().optional().describe(
+      sessionId: z26.string().optional().describe(
         "Session ID from a previous ask_question response, for follow-up questions."
       ),
-      timezone: z25.string().optional().describe('IANA timezone (e.g. "America/New_York"). Defaults to UTC.')
+      timezone: z26.string().optional().describe('IANA timezone (e.g. "America/New_York"). Defaults to UTC.')
     },
     WRITE_CREATE,
     async (params) => {
@@ -5460,15 +5633,22 @@ You can verify with \`get_semantic_layer\` using datamartName "${datamartName}".
         });
         const data = Array.isArray(result.data) ? result.data : [];
         if (hasChartApps(server)) {
+          const chartType = normalizePreviewType(result.suggestedChartType);
+          const draft = {
+            question: params.question,
+            sql: result.query || "",
+            datamartName,
+            dimensions: result.columns?.dimensions || [],
+            measures: result.columns?.measures || [],
+            chartType,
+            title: params.question.slice(0, 200),
+            sessionId: result.sessionId || void 0,
+            workspaces: await workspacesForDatamart(client, datamartName)
+          };
           const rows = firstRows(data);
-          return chartResult(`Query Results: ${data.length} rows returned; showing the first ${rows.length}.`, {
-            kind: "table",
-            title: "Query results",
-            chartSpec: { type: result.suggestedChartType || "table" },
-            rows,
-            columns: Object.keys(rows[0] ?? {}),
-            description: "Showing the first page. Interactive chart preview is not available for this query yet."
-          });
+          const page = draft.sql ? await draftPage(client, draft, rows, chartType) : { ...tablePage(draft, rows), previewTypes: [] };
+          const shown = rows.length === data.length ? `${data.length} rows` : `first ${rows.length} of ${data.length} rows`;
+          return chartResult(`${page.kind === "table" ? "Table" : "Chart"} ready (${page.chartSpec && page.chartSpec.type}): ${shown}.` + (result.summary ? ` ${result.summary}` : ""), { ...page, rowsTotal: data.length });
         }
         const table = formatDataTable(data, result.columns);
         const parts = [];
@@ -5543,14 +5723,14 @@ To fix this:
 }
 
 // src/tools/query/get-semantic-layer.ts
-import { z as z26 } from "zod";
+import { z as z27 } 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: z26.string().optional().describe(
+      datamartName: z27.string().optional().describe(
         "Name of the datamart to inspect. Omit to list available datamarts."
       )
     },
@@ -5660,15 +5840,15 @@ ${result.feedback}`);
 }
 
 // src/tools/query/update-semantic-layer.ts
-import { z as z27 } from "zod";
-var columnSchema2 = z27.object({
-  name: z27.string().describe("Column name (must exist in the datamart)"),
-  description: z27.string().optional().describe("Business-friendly description of what this column represents"),
-  synonyms: z27.array(z27.string()).optional().describe(
+import { z as z28 } from "zod";
+var columnSchema2 = z28.object({
+  name: z28.string().describe("Column name (must exist in the datamart)"),
+  description: z28.string().optional().describe("Business-friendly description of what this column represents"),
+  synonyms: z28.array(z28.string()).optional().describe(
     'Alternative names users might use for this column (e.g. ["revenue", "sales amount"])'
   ),
-  miscellaneousInfo: z27.string().optional().describe("Additional context such as valid values, units, or caveats"),
-  columnType: z27.enum([
+  miscellaneousInfo: z28.string().optional().describe("Additional context such as valid values, units, or caveats"),
+  columnType: z28.enum([
     "String",
     "Long String",
     "String (Custom)",
@@ -5681,16 +5861,16 @@ var columnSchema2 = z27.object({
     "JSON"
   ]).nullable().optional().describe('Semantic column type. Use "Identifier" for IDs/foreign keys, "Number" for numeric values, "String" for text. Omit for date and boolean columns.')
 });
-var tableSchema2 = z27.object({
-  name: z27.string().describe("Table name (must exist in the datamart)"),
-  description: z27.string().optional().describe(
+var tableSchema2 = z28.object({
+  name: z28.string().describe("Table name (must exist in the datamart)"),
+  description: z28.string().optional().describe(
     "Business-friendly description of what this table represents"
   ),
-  synonyms: z27.array(z27.string()).optional().describe("Alternative names for this table"),
-  miscellaneousInfo: z27.string().optional().describe(
+  synonyms: z28.array(z28.string()).optional().describe("Alternative names for this table"),
+  miscellaneousInfo: z28.string().optional().describe(
     "Additional context such as how the table relates to other tables"
   ),
-  columns: z27.array(columnSchema2).optional().describe("Column-level semantic definitions to update")
+  columns: z28.array(columnSchema2).optional().describe("Column-level semantic definitions to update")
 });
 function columnKey(tableName, columnName) {
   return `${tableName.toLowerCase()}\0${columnName.toLowerCase()}`;
@@ -5757,13 +5937,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: z27.string().optional().describe(
+      datamartName: z28.string().optional().describe(
         "Name of the datamart to update. Omit to list available datamarts."
       ),
-      tables: z27.array(tableSchema2).optional().describe(
+      tables: z28.array(tableSchema2).optional().describe(
         "Table and column definitions to update. Only include tables/columns you want to change."
       ),
-      feedback: z27.string().optional().describe(
+      feedback: z28.string().optional().describe(
         'General feedback or context about the datamart (e.g. "This datamart contains e-commerce data for the US market").'
       )
     },
@@ -5825,7 +6005,7 @@ You can now:
 }
 
 // src/tools/query/semantic-generation.ts
-import { z as z28 } from "zod";
+import { z as z29 } from "zod";
 function nonEmptyString(value) {
   return typeof value === "string" && value.trim().length > 0 ? value : null;
 }
@@ -5980,9 +6160,9 @@ function registerStartSemanticLayerGeneration(server, client) {
     "start_semantic_layer_generation",
     "Start backend semantic-layer auto-generation for a datamart. Returns an async job id to poll.",
     {
-      datamartName: z28.string().optional().describe("Datamart name. Omit to list available datamarts"),
-      workspaceName: z28.string().optional().describe("Workspace linked to the datamart. Use when datamartName resolution needs a dataMartId bridge."),
-      datamartId: z28.string().optional().describe("Datamart UUID. Use only when already known.")
+      datamartName: z29.string().optional().describe("Datamart name. Omit to list available datamarts"),
+      workspaceName: z29.string().optional().describe("Workspace linked to the datamart. Use when datamartName resolution needs a dataMartId bridge."),
+      datamartId: z29.string().optional().describe("Datamart UUID. Use only when already known.")
     },
     WRITE_CREATE,
     async (params) => {
@@ -6024,9 +6204,9 @@ function registerGetSemanticLayerGenerationStatus(server, client) {
     "get_semantic_layer_generation_status",
     "Get semantic-layer auto-generation job status for a datamart.",
     {
-      datamartName: z28.string().optional().describe("Datamart name. Omit to list available datamarts"),
-      workspaceName: z28.string().optional().describe("Workspace linked to the datamart. Use when datamartName resolution needs a dataMartId bridge."),
-      datamartId: z28.string().optional().describe("Datamart UUID. Use only when already known.")
+      datamartName: z29.string().optional().describe("Datamart name. Omit to list available datamarts"),
+      workspaceName: z29.string().optional().describe("Workspace linked to the datamart. Use when datamartName resolution needs a dataMartId bridge."),
+      datamartId: z29.string().optional().describe("Datamart UUID. Use only when already known.")
     },
     READ_ONLY,
     async (params) => {
@@ -6063,7 +6243,7 @@ function registerGetSemanticLayerGenerationStatus(server, client) {
 }
 
 // src/tools/widgets/list-widgets.ts
-import { z as z29 } from "zod";
+import { z as z30 } from "zod";
 function widgetReferenceId(widget) {
   for (const candidate of [widget.externalMetricId, widget.id, widget._id, widget.metricId]) {
     if (typeof candidate === "string" && candidate.trim().length > 0) return candidate.trim();
@@ -6076,10 +6256,10 @@ function registerListWidgets(server, client) {
     "list_widgets",
     "List widgets on a customer dashboard. Non-technical flow: pass `clientId` + `dashboardName` (+ optional `workspaceName` if ambiguous). Returns each widget's externalMetricId (uuid, used for update/remove), metricId (slug), name, published state, and creator identifier.",
     {
-      clientId: z29.string().describe("Client/tenant identifier for this dashboard"),
-      dashboardName: z29.string().optional().describe("Dashboard name (non-technical). Preferred input \u2014 pass this with optional `workspaceName` instead of `embedId`."),
-      workspaceName: z29.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
-      embedId: z29.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier.")
+      clientId: z30.string().describe("Client/tenant identifier for this dashboard"),
+      dashboardName: z30.string().optional().describe("Dashboard name (non-technical). Preferred input \u2014 pass this with optional `workspaceName` instead of `embedId`."),
+      workspaceName: z30.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
+      embedId: z30.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier.")
     },
     READ_ONLY,
     async (params) => {
@@ -6143,29 +6323,29 @@ function registerListWidgets(server, client) {
 }
 
 // src/tools/widgets/add-widget.ts
-import { z as z30 } from "zod";
+import { z as z31 } from "zod";
 function registerAddWidget(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "add_widget",
     "Add a widget to a customer dashboard. Non-technical flow: pass `clientId` + `dashboardName` (+ optional `workspaceName` if ambiguous). Cloning via `templateMetricId` is the recommended path \u2014 query, chart config, and datasource are all inherited. Data app and datasource auto-resolve; never ask the user for them.",
     {
-      clientId: z30.string().describe("Client/tenant identifier (widget is created in their scope)"),
-      dashboardName: z30.string().optional().describe("Dashboard name (non-technical). Preferred input \u2014 pass this with optional `workspaceName` instead of `embedId`."),
-      workspaceName: z30.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
-      embedId: z30.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
-      dataAppName: z30.string().optional().describe("Technical override. Auto-resolved from the embed; non-technical callers should leave this blank."),
-      templateMetricId: z30.string().optional().describe("Source widget metricId to clone from. Copies query, chartOptions, and datasource fields; caller can override via other params."),
-      name: z30.string().optional().describe("Widget name (overrides template)"),
-      metricId: z30.string().optional().describe("Unique slug for the new widget (auto-generated if omitted)"),
-      query: z30.string().optional().describe("SQL query body (overrides template)"),
-      chartOptions: z30.record(z30.unknown()).optional().describe("Chart config JSON (chart type, colors, legend, axes). Overrides template."),
-      description: z30.string().optional(),
-      companyIntegrationId: z30.string().optional().describe("Datasource UUID override. Auto-resolved from `embedId` or sole active datasource; leave blank unless the user explicitly picked one by ID."),
-      integrationName: z30.string().optional().describe('Datasource display name (e.g. "Snowflake"). Use this when the user picks a datasource by name \u2014 the id is looked up automatically.'),
-      isPublished: z30.boolean().optional().describe("Publish immediately (default true)"),
-      body: z30.record(z30.unknown()).optional().describe("Raw createMetric body passthrough. If provided, used as-is (after defaults). Overrides all other params."),
-      widgets: z30.array(z30.record(z30.unknown())).min(1).max(50).optional().describe("Batch of raw createMetric bodies. Dashboard attachment is added to each body.")
+      clientId: z31.string().describe("Client/tenant identifier (widget is created in their scope)"),
+      dashboardName: z31.string().optional().describe("Dashboard name (non-technical). Preferred input \u2014 pass this with optional `workspaceName` instead of `embedId`."),
+      workspaceName: z31.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
+      embedId: z31.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
+      dataAppName: z31.string().optional().describe("Technical override. Auto-resolved from the embed; non-technical callers should leave this blank."),
+      templateMetricId: z31.string().optional().describe("Source widget metricId to clone from. Copies query, chartOptions, and datasource fields; caller can override via other params."),
+      name: z31.string().optional().describe("Widget name (overrides template)"),
+      metricId: z31.string().optional().describe("Unique slug for the new widget (auto-generated if omitted)"),
+      query: z31.string().optional().describe("SQL query body (overrides template)"),
+      chartOptions: z31.record(z31.unknown()).optional().describe("Chart config JSON (chart type, colors, legend, axes). Overrides template."),
+      description: z31.string().optional(),
+      companyIntegrationId: z31.string().optional().describe("Datasource UUID override. Auto-resolved from `embedId` or sole active datasource; leave blank unless the user explicitly picked one by ID."),
+      integrationName: z31.string().optional().describe('Datasource display name (e.g. "Snowflake"). Use this when the user picks a datasource by name \u2014 the id is looked up automatically.'),
+      isPublished: z31.boolean().optional().describe("Publish immediately (default true)"),
+      body: z31.record(z31.unknown()).optional().describe("Raw createMetric body passthrough. If provided, used as-is (after defaults). Overrides all other params."),
+      widgets: z31.array(z31.record(z31.unknown())).min(1).max(50).optional().describe("Batch of raw createMetric bodies. Dashboard attachment is added to each body.")
     },
     WRITE_CREATE,
     async (params) => {
@@ -6313,20 +6493,20 @@ Use \`list_widgets\` to verify, or \`update_widget\`/\`remove_widget\` to adjust
 }
 
 // src/tools/widgets/update-widget.ts
-import { z as z31 } from "zod";
+import { z as z32 } from "zod";
 function registerUpdateWidget(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "update_widget",
     "Update a widget on a customer dashboard. Non-technical flow: pass `clientId` + `dashboardName` (+ optional `workspaceName` if ambiguous) + `externalMetricId` + `set`. Data app auto-resolves from the dashboard.",
     {
-      externalMetricId: z31.string().describe("Internal uuid of the widget (externalMetrics.id). Not the user-facing metricId slug."),
-      clientId: z31.string().describe("Client/tenant identifier"),
-      dashboardName: z31.string().optional().describe("Dashboard name (non-technical). Preferred input \u2014 pass this with optional `workspaceName` instead of `embedId`."),
-      workspaceName: z31.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
-      embedId: z31.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
-      dataAppName: z31.string().optional().describe("Technical override. Auto-resolved from the dashboard; non-technical callers should leave this blank."),
-      set: z31.record(z31.unknown()).describe("Partial patch. Keys can include: name, query, chartOptions, description, isPublished, isLive, selectedGroupBy, drillDownSettings, limit, etc.")
+      externalMetricId: z32.string().describe("Internal uuid of the widget (externalMetrics.id). Not the user-facing metricId slug."),
+      clientId: z32.string().describe("Client/tenant identifier"),
+      dashboardName: z32.string().optional().describe("Dashboard name (non-technical). Preferred input \u2014 pass this with optional `workspaceName` instead of `embedId`."),
+      workspaceName: z32.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
+      embedId: z32.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
+      dataAppName: z32.string().optional().describe("Technical override. Auto-resolved from the dashboard; non-technical callers should leave this blank."),
+      set: z32.record(z32.unknown()).describe("Partial patch. Keys can include: name, query, chartOptions, description, isPublished, isLive, selectedGroupBy, drillDownSettings, limit, etc.")
     },
     WRITE_IDEMPOTENT,
     async (params) => {
@@ -6389,19 +6569,19 @@ Use \`list_widgets\` to verify.`
 }
 
 // src/tools/widgets/remove-widget.ts
-import { z as z32 } from "zod";
+import { z as z33 } from "zod";
 function registerRemoveWidget(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "remove_widget",
     "Remove a widget from a customer dashboard. Non-technical flow: pass `clientId` + `dashboardName` (+ optional `workspaceName` if ambiguous) + `externalMetricId`. Per-client soft delete \u2014 the widget stays on the template dashboard and on other customers' dashboards.",
     {
-      externalMetricId: z32.string().describe("Internal uuid of the widget (externalMetrics.id)"),
-      clientId: z32.string().describe("Client/tenant identifier \u2014 the widget will be hidden for this client only"),
-      dashboardName: z32.string().optional().describe("Dashboard name (non-technical). Preferred input \u2014 pass this with optional `workspaceName` instead of `embedId`."),
-      workspaceName: z32.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
-      embedId: z32.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
-      dataAppName: z32.string().optional().describe("Technical override. Auto-resolved from the dashboard; non-technical callers should leave this blank.")
+      externalMetricId: z33.string().describe("Internal uuid of the widget (externalMetrics.id)"),
+      clientId: z33.string().describe("Client/tenant identifier \u2014 the widget will be hidden for this client only"),
+      dashboardName: z33.string().optional().describe("Dashboard name (non-technical). Preferred input \u2014 pass this with optional `workspaceName` instead of `embedId`."),
+      workspaceName: z33.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
+      embedId: z33.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
+      dataAppName: z33.string().optional().describe("Technical override. Auto-resolved from the dashboard; non-technical callers should leave this blank.")
     },
     DESTRUCTIVE,
     async (params) => {
@@ -6457,21 +6637,21 @@ Note: this is a per-client soft delete. The widget remains available for other c
 }
 
 // src/tools/widgets/generate-widget.ts
-import { z as z33 } from "zod";
+import { z as z34 } from "zod";
 function registerGenerateWidget(server, client) {
   const services = createServiceBundle(client);
   const tool = server.tool(
     "generate_widget",
     "AI-generate a widget draft from a natural-language prompt. Does NOT persist \u2014 returns a draft to pass to `add_widget`. Non-technical flow: `clientId` + `dashboardName` (+ `workspaceName` if ambiguous); data app and datasource auto-resolve. Never ask the user for data app, datasource, or integration.",
     {
-      clientId: z33.string().describe("Client/tenant identifier"),
-      userInputs: z33.record(z33.unknown()).describe('Prompt + context object. Typical shape: { prompt: "calls per day over last 30 days", schema: {...}, examples: [...] }. Backend decides which keys it honors.'),
-      dashboardName: z33.string().optional().describe("Dashboard name (non-technical). Preferred input for CS/CX flows \u2014 pass this with optional `workspaceName` instead of `embedId`."),
-      workspaceName: z33.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
-      embedId: z33.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
-      dataAppName: z33.string().optional().describe("Technical override. Auto-resolved from the embed; non-technical callers should leave this blank."),
-      integrationId: z33.string().optional().describe("Technical override \u2014 the datasource UUID. Non-technical callers must leave this blank; the datasource is inherited from the dashboard's existing widgets."),
-      integrationName: z33.string().optional().describe("Technical override \u2014 datasource display name. Non-technical callers must leave this blank; the datasource is inherited from the dashboard's existing widgets.")
+      clientId: z34.string().describe("Client/tenant identifier"),
+      userInputs: z34.record(z34.unknown()).describe('Prompt + context object. Typical shape: { prompt: "calls per day over last 30 days", schema: {...}, examples: [...] }. Backend decides which keys it honors.'),
+      dashboardName: z34.string().optional().describe("Dashboard name (non-technical). Preferred input for CS/CX flows \u2014 pass this with optional `workspaceName` instead of `embedId`."),
+      workspaceName: z34.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
+      embedId: z34.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
+      dataAppName: z34.string().optional().describe("Technical override. Auto-resolved from the embed; non-technical callers should leave this blank."),
+      integrationId: z34.string().optional().describe("Technical override \u2014 the datasource UUID. Non-technical callers must leave this blank; the datasource is inherited from the dashboard's existing widgets."),
+      integrationName: z34.string().optional().describe("Technical override \u2014 datasource display name. Non-technical callers must leave this blank; the datasource is inherited from the dashboard's existing widgets.")
     },
     READ_ONLY,
     async (params) => {
@@ -6556,9 +6736,9 @@ function registerGenerateWidget(server, client) {
 }
 
 // src/tools/widgets/create-or-update-metric-from-query.ts
-import { z as z34 } from "zod";
-var modeSchema = z34.enum(["dry_run", "apply"]).default("dry_run");
-var conflictStrategySchema = z34.enum(["fail", "update", "create_new"]).default("fail");
+import { z as z35 } from "zod";
+var modeSchema = z35.enum(["dry_run", "apply"]).default("dry_run");
+var conflictStrategySchema = z35.enum(["fail", "update", "create_new"]).default("fail");
 function makePlanText(plan) {
   return JSON.stringify(plan, null, 2);
 }
@@ -6575,22 +6755,22 @@ function registerCreateOrUpdateMetricFromQuery(server, client) {
     "[EMBEDDING] Create or update a production metric/widget on a customer dashboard from validated SQL. Requires clientId (multi-tenant embed). Defaults to dry-run; apply requires explicit confirmation.",
     {
       mode: modeSchema.describe("dry_run returns the plan only; apply executes after confirmation"),
-      confirm: z34.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
+      confirm: z35.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
       conflictStrategy: conflictStrategySchema.describe("What to do if metricId already exists on the target dashboard"),
-      clientId: z34.string().describe("Client/tenant identifier for the dashboard widget scope"),
-      workspaceName: z34.string().describe("Target workspace name"),
-      dashboardName: z34.string().optional().describe("Dashboard name to attach to"),
-      embedId: z34.string().optional().describe("Technical embed id alternative to dashboardName"),
-      dataAppName: z34.string().optional().describe("Optional data app override"),
-      name: z34.string().describe("Metric/widget display name"),
-      metricId: z34.string().describe("Stable metric slug to create or update"),
-      query: z34.string().describe("SQL query already validated against the warehouse"),
-      description: z34.string().optional().describe("Metric description"),
-      chartOptions: z34.record(z34.unknown()).optional().describe("Chart configuration JSON"),
-      companyIntegrationId: z34.string().optional().describe("Datasource UUID override"),
-      integrationName: z34.string().optional().describe("Datasource display name override"),
-      isPublished: z34.boolean().optional().describe("Publish after apply. Defaults to false for production safety"),
-      requestedBy: z34.string().optional().describe("Human operator/request context to store on the metric when supported")
+      clientId: z35.string().describe("Client/tenant identifier for the dashboard widget scope"),
+      workspaceName: z35.string().describe("Target workspace name"),
+      dashboardName: z35.string().optional().describe("Dashboard name to attach to"),
+      embedId: z35.string().optional().describe("Technical embed id alternative to dashboardName"),
+      dataAppName: z35.string().optional().describe("Optional data app override"),
+      name: z35.string().describe("Metric/widget display name"),
+      metricId: z35.string().describe("Stable metric slug to create or update"),
+      query: z35.string().describe("SQL query already validated against the warehouse"),
+      description: z35.string().optional().describe("Metric description"),
+      chartOptions: z35.record(z35.unknown()).optional().describe("Chart configuration JSON"),
+      companyIntegrationId: z35.string().optional().describe("Datasource UUID override"),
+      integrationName: z35.string().optional().describe("Datasource display name override"),
+      isPublished: z35.boolean().optional().describe("Publish after apply. Defaults to false for production safety"),
+      requestedBy: z35.string().optional().describe("Human operator/request context to store on the metric when supported")
     },
     WRITE_IDEMPOTENT,
     async (params) => {
@@ -6750,8 +6930,8 @@ function registerCreateOrUpdateMetricFromQuery(server, client) {
 }
 
 // src/tools/widgets/create-workspace-metric.ts
-import { z as z35 } from "zod";
-var modeSchema2 = z35.enum(["dry_run", "apply"]).default("dry_run");
+import { z as z36 } from "zod";
+var modeSchema2 = z36.enum(["dry_run", "apply"]).default("dry_run");
 function registerCreateWorkspaceMetric(server, client) {
   server.tool(
     "create_workspace_metric",
@@ -6760,16 +6940,16 @@ function registerCreateWorkspaceMetric(server, client) {
       mode: modeSchema2.describe(
         "dry_run validates the SQL only (no write); apply creates or updates the metric after confirmation"
       ),
-      confirm: z35.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
-      workspaceName: z35.string().describe("Target workspace name"),
-      name: z35.string().describe("Metric display name"),
-      query: z35.string().describe("SQL query to validate and store"),
-      metricId: z35.string().optional().describe(
+      confirm: z36.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
+      workspaceName: z36.string().describe("Target workspace name"),
+      name: z36.string().describe("Metric display name"),
+      query: z36.string().describe("SQL query to validate and store"),
+      metricId: z36.string().optional().describe(
         "Stable metric slug. Pass an existing slug to UPDATE that metric in place. Omit to create \u2014 the slug is derived deterministically from the name (no random/uniqueness suffix), so re-running with the same name upserts the same metric rather than creating a duplicate."
       ),
-      description: z35.string().optional().describe("Metric description"),
-      datasourceId: z35.string().optional().describe("Datasource UUID override; defaults to the workspace datasource"),
-      isPublished: z35.boolean().optional().describe(
+      description: z36.string().optional().describe("Metric description"),
+      datasourceId: z36.string().optional().describe("Datasource UUID override; defaults to the workspace datasource"),
+      isPublished: z36.boolean().optional().describe(
         "Publish after apply. Defaults to false. Applies to creates; on updates the existing publish state is preserved."
       )
     },
@@ -6825,25 +7005,25 @@ function registerCreateWorkspaceMetric(server, client) {
 }
 
 // src/tools/widgets/validate-metric-spec.ts
-import { z as z36 } from "zod";
+import { z as z37 } from "zod";
 function registerValidateMetricSpec(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "validate_metric_spec",
     "Validate a production metric spec from SQL without saving it. Resolves dashboard, data app, datasource, conflicts, and required fields.",
     {
-      clientId: z36.string().describe("Client/tenant identifier used to validate dashboard widget scope"),
-      workspaceName: z36.string().describe("Target production-backed workspace name"),
-      dashboardName: z36.string().optional().describe("Dashboard name to attach to"),
-      embedId: z36.string().optional().describe("Technical embed id alternative to dashboardName"),
-      dataAppName: z36.string().optional().describe("Optional data app override"),
-      name: z36.string().describe("Metric/widget display name"),
-      metricId: z36.string().describe("Stable metric slug to create or update"),
-      query: z36.string().describe("SQL query already validated against the warehouse"),
-      description: z36.string().optional().describe("Metric description"),
-      chartOptions: z36.record(z36.unknown()).optional().describe("Chart configuration JSON"),
-      companyIntegrationId: z36.string().optional().describe("Datasource UUID override"),
-      integrationName: z36.string().optional().describe("Datasource display name override")
+      clientId: z37.string().describe("Client/tenant identifier used to validate dashboard widget scope"),
+      workspaceName: z37.string().describe("Target production-backed workspace name"),
+      dashboardName: z37.string().optional().describe("Dashboard name to attach to"),
+      embedId: z37.string().optional().describe("Technical embed id alternative to dashboardName"),
+      dataAppName: z37.string().optional().describe("Optional data app override"),
+      name: z37.string().describe("Metric/widget display name"),
+      metricId: z37.string().describe("Stable metric slug to create or update"),
+      query: z37.string().describe("SQL query already validated against the warehouse"),
+      description: z37.string().optional().describe("Metric description"),
+      chartOptions: z37.record(z37.unknown()).optional().describe("Chart configuration JSON"),
+      companyIntegrationId: z37.string().optional().describe("Datasource UUID override"),
+      integrationName: z37.string().optional().describe("Datasource display name override")
     },
     READ_ONLY,
     async (params) => {
@@ -6934,20 +7114,20 @@ function registerValidateMetricSpec(server, client) {
 }
 
 // src/tools/reports/list-scheduled-reports.ts
-import { z as z37 } from "zod";
+import { z as z38 } from "zod";
 function registerListScheduledReports(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "list_scheduled_reports",
     "List configured scheduled reports for a specific client/dashboard embed. Shows schedule metadata, not delivery success history.",
     {
-      clientId: z37.string().describe("Client/tenant identifier. Required by the current backend API for non-empty results"),
-      dashboardName: z37.string().optional().describe("Dashboard name to inspect"),
-      workspaceName: z37.string().optional().describe("Workspace name if dashboardName is ambiguous"),
-      embedId: z37.string().optional().describe("Technical embed id alternative to dashboardName"),
-      userIdentifier: z37.string().optional().describe("Optional creator/user filter"),
-      pageNumber: z37.number().int().positive().optional().describe("Page number when pagination is enabled"),
-      isPagination: z37.boolean().optional().describe("Enable backend pagination")
+      clientId: z38.string().describe("Client/tenant identifier. Required by the current backend API for non-empty results"),
+      dashboardName: z38.string().optional().describe("Dashboard name to inspect"),
+      workspaceName: z38.string().optional().describe("Workspace name if dashboardName is ambiguous"),
+      embedId: z38.string().optional().describe("Technical embed id alternative to dashboardName"),
+      userIdentifier: z38.string().optional().describe("Optional creator/user filter"),
+      pageNumber: z38.number().int().positive().optional().describe("Page number when pagination is enabled"),
+      isPagination: z38.boolean().optional().describe("Enable backend pagination")
     },
     READ_ONLY,
     async (params) => {
@@ -10439,16 +10619,25 @@ export {
   DatabrainClient,
   createServiceBundle,
   READ_ONLY,
+  WRITE_CREATE,
+  APPLY_TO_PRODUCTION_CONFIRMATION,
   CHART_URI,
   KPI_URI,
   APP_MIME,
+  rowsSchema,
   referenceSchema,
   viewSchema,
   pageSchema,
+  appMeta,
   enableChartApps,
   chartResult,
+  draftSchema,
+  RENDER_TYPES,
+  draftPage,
+  workspacesForDatamart,
+  saveDraftAsDashboard,
   registerAllTools,
   registerAllResources,
   registerAllPrompts
 };
-//# sourceMappingURL=chunk-3AFT7S6E.js.map
+//# sourceMappingURL=chunk-I35U2LBX.js.map