@databrainhq/mcp-server 0.3.0-rc.11 → 0.3.0-rc.12

package/dist/{chunk-ES2LUP4U.js → chunk-OLOC2MTA.js}

@@ -13,7 +13,7 @@ import {
   toolContext,
   toolError,
   toolSuccess
-} from "./chunk-RHK62ZJ6.js";
+} from "./chunk-347U6GXR.js";
 import {
   MAX_BUNDLE_CSS_BYTES,
   MAX_BUNDLE_JS_BYTES,
@@ -42,7 +42,10 @@ var CUSTOM_BUNDLE_CHUNK_CHARS = 32e3;
 var id = z.string().trim().min(1).max(256);
 var cell = z.union([z.string().max(2e3), z.number().finite(), z.boolean(), z.null()]);
 var rowsSchema = z.array(z.record(cell)).max(PAGE_SIZE);
-var referenceSchema = z.object({ embedId: id, clientId: id, widgetId: id }).strict();
+var referenceSchema = z.union([
+  z.object({ embedId: id, clientId: id, widgetId: id, dataAppName: id.optional() }).strict(),
+  z.object({ dashboardId: id, widgetId: id, clientId: id.optional(), display: z.enum(["chart", "kpi"]).optional() }).strict()
+]);
 var point = z.object({
   key: id,
   label: z.string().max(2e3),
@@ -63,8 +66,10 @@ var viewSchema = z.object({
   drillId: id.optional()
 }).strict();
 var pageSchema = z.object({
-  kind: z.enum(["chart", "kpi"]),
+  kind: z.enum(["chart", "kpi", "table"]),
   title: z.string().max(500),
+  description: z.string().max(2e3).optional(),
+  rowsTotal: z.number().int().nonnegative().optional(),
   chartSpec: z.object({ type: z.string().max(80) }).strict(),
   rows: rowsSchema,
   columns: z.array(z.string().max(128)).max(20),
@@ -85,6 +90,9 @@ var pageSchema = z.object({
   if (page.kind === "kpi" && (page.svg || page.points.length || page.value === void 0)) {
     ctx.addIssue({ code: "custom", message: "KPI requires a value and no SVG/points" });
   }
+  if (page.kind === "table" && (page.svg || page.points.length || page.value !== void 0)) {
+    ctx.addIssue({ code: "custom", message: "Table requires rows without SVG/points/value" });
+  }
   if (new Set(page.points.map((p) => p.key)).size !== page.points.length || page.points.some((p) => p.x + p.width > page.width || p.y + p.height > page.height)) {
     ctx.addIssue({ code: "custom", message: "Invalid point geometry" });
   }
@@ -105,8 +113,8 @@ function firstRows(value) {
 }
 
 // src/apps/feature.ts
-function appMeta(visibility) {
-  return { ui: { resourceUri: CHART_URI, visibility }, [RESOURCE_URI_META_KEY]: CHART_URI };
+function appMeta(visibility, uri = CHART_URI) {
+  return { ui: { resourceUri: uri, visibility }, [RESOURCE_URI_META_KEY]: uri };
 }
 var enabled = /* @__PURE__ */ new WeakSet();
 function enableChartApps(server) {
@@ -122,9 +130,14 @@ function chartResult(summary, payload) {
   return bounded({
     content: [{ type: "text", text: summary }],
     structuredContent: payload,
-    _meta: appMeta(["model", "app"])
+    _meta: appMeta(["model", "app"], payload.kind === "kpi" ? KPI_URI : CHART_URI)
   });
 }
+function chartIndex(dashboardId, charts) {
+  return `To draw one, call render_metric_tile with dashboardId ${JSON.stringify(dashboardId)} and metricId set to a widgetId below.
+` + JSON.stringify(charts.slice(0, 50).map((c) => ({ widgetId: c.widgetId, name: (c.name || "Untitled widget").slice(0, 200), chartType: c.chartType || null }))) + (charts.length > 50 ? `
+Showing the first 50 of ${charts.length}.` : "");
+}
 
 // src/tools/custom-chart/author.ts
 import { z as z3 } from "zod";
@@ -381,6 +394,7 @@ var TOOL_METADATA = {
   preview_chart: { category: "internal_analytics", workflowIntent: "query_data", effect: "view" },
   save_chart_as_dashboard: { category: "internal_analytics", workflowIntent: "author_dashboard", effect: "commit" },
   // Read-only to the user, but each interaction mints an embed-scoped guest credential.
+  render_metric_tile: { category: "internal_analytics", workflowIntent: "chart_app", effect: "read" },
   render_chart: { category: "embedding", workflowIntent: "chart_app", effect: "commit" },
   refresh_widget: { category: "embedding", workflowIntent: "chart_app", effect: "commit" },
   drill_down: { category: "embedding", workflowIntent: "chart_app", effect: "commit" },
@@ -602,10 +616,12 @@ var EmbedsApi = class {
     this.client = client;
   }
   async createEmbed(body) {
+    const { dataAppName, ...payload } = body;
     return this.client.request({
       method: "POST",
       path: "/api/v2/data-app/embeds",
-      body,
+      query: typeof dataAppName === "string" ? { dataAppName } : void 0,
+      body: payload,
       auth: "api",
       invalidateCache: ["list_embeds"]
     });
@@ -627,12 +643,12 @@ var EmbedsApi = class {
       cacheTtlMs: 5 * 60 * 1e3
     });
   }
-  async getByEmbedId(embedId) {
+  async getByEmbedId(embedId, dataAppName) {
     return this.client.request({
       method: "GET",
       path: "/api/v2/data-app/embeds",
       auth: "api",
-      query: { embedId }
+      query: { embedId, ...dataAppName ? { dataAppName } : {} }
     });
   }
   async updateEmbed(body) {
@@ -712,7 +728,7 @@ var QueryApi = class {
   async startSemanticLayerGeneration(datamartId2) {
     return this.client.request({
       method: "POST",
-      path: `/api/v2/data-app/datamarts/${encodeURIComponent(datamartId2)}/semantic-layer/generate`,
+      path: `/schema/datamart/${encodeURIComponent(datamartId2)}/semantic-layer/auto-generate`,
       auth: "service",
       invalidateCache: ["semantic_layer_"]
     });
@@ -720,7 +736,7 @@ var QueryApi = class {
   async getSemanticLayerGenerationStatus(datamartId2) {
     return this.client.request({
       method: "GET",
-      path: `/api/v2/data-app/datamarts/${encodeURIComponent(datamartId2)}/semantic-layer/generation-status`,
+      path: `/schema/datamart/${encodeURIComponent(datamartId2)}/semantic-layer/generation-status`,
       auth: "service"
     });
   }
@@ -759,6 +775,7 @@ var ScheduledReportsApi = class {
       embedId: params.embedId,
       clientId: params.clientId
     };
+    if (params.dataAppName) query.dataAppName = params.dataAppName;
     if (params.userIdentifier) query.userIdentifier = params.userIdentifier;
     if (params.pageNumber !== void 0) query.pageNumber = String(params.pageNumber);
     if (params.isPagination !== void 0) {
@@ -782,15 +799,15 @@ var SemanticModelApi = class {
   path(id2, verb) {
     return `/api/v2/semantic/${encodeURIComponent(id2)}/${verb}`;
   }
-  pull(id2) {
-    return this.client.request({ method: "GET", path: this.path(id2, "pull"), auth: "service" });
+  pull(id2, mode) {
+    return this.client.request({ method: "GET", path: this.path(id2, "pull"), auth: "service", ...mode ? { query: { mode } } : {} });
   }
   retrieve(id2, q, k) {
     return this.client.request({
-      method: "GET",
+      method: "POST",
       path: this.path(id2, "retrieve"),
       auth: "service",
-      query: { q, k: String(k) }
+      body: { q, k }
     });
   }
   validate(id2, source2) {
@@ -866,12 +883,12 @@ var WidgetsApi = class {
   constructor(client) {
     this.client = client;
   }
-  async listWidgets(embedId, clientId) {
+  async listWidgets(embedId, clientId, dataAppName) {
     return this.client.request({
       method: "GET",
       path: "/api/v2/data-app/metrics",
       auth: "api",
-      query: { embedId, clientId }
+      query: { embedId, clientId, ...dataAppName ? { dataAppName } : {} }
     });
   }
   async createMetric(guestToken, body) {
@@ -880,7 +897,7 @@ var WidgetsApi = class {
       path: "/api/v2/dashboard/createMetric",
       auth: "none",
       token: guestToken,
-      body
+      body: { ...body, isLive: body.isLive ?? false }
     });
   }
   async updateMetric(guestToken, body) {
@@ -895,7 +912,7 @@ var WidgetsApi = class {
   async markArchived(guestToken, body) {
     return this.client.request({
       method: "POST",
-      path: "/api/v2/dashboard/markArchived",
+      path: "/api/v3/metric/markArchived",
       auth: "none",
       token: guestToken,
       body
@@ -961,7 +978,7 @@ var DiscoveryService = class {
   normalizeDashboard(dashboard) {
     return {
       name: isNonEmptyString(dashboard.name) && dashboard.name || isNonEmptyString(dashboard.dashboardName) && dashboard.dashboardName || "Unnamed Dashboard",
-      dashboardId: isNonEmptyString(dashboard.dashboardId) && dashboard.dashboardId || isNonEmptyString(dashboard.externalDashboardId) && dashboard.externalDashboardId || isNonEmptyString(dashboard._id) && dashboard._id || isNonEmptyString(dashboard.id) && dashboard.id || isNonEmptyString(dashboard.uid) && dashboard.uid || null,
+      dashboardId: isNonEmptyString(dashboard.dashboardId) && dashboard.dashboardId || isNonEmptyString(dashboard._id) && dashboard._id || isNonEmptyString(dashboard.id) && dashboard.id || isNonEmptyString(dashboard.uid) && dashboard.uid || isNonEmptyString(dashboard.externalDashboardId) && dashboard.externalDashboardId || null,
       externalDashboardId: isNonEmptyString(dashboard.externalDashboardId) && dashboard.externalDashboardId || null,
       workspaceName: isNonEmptyString(dashboard.workspaceName) && dashboard.workspaceName || isNonEmptyString(dashboard.workspace) && dashboard.workspace || isNonEmptyString(dashboard.workspaceId) && dashboard.workspaceId || null,
       metricCount: typeof dashboard.metricCount === "number" ? dashboard.metricCount : null
@@ -1077,8 +1094,8 @@ var EmbedService = class {
     };
     return this.embedsApi.createEmbed(body);
   }
-  async resolveEmbedStrict(embedId) {
-    const response = await this.embedsApi.getByEmbedId(embedId);
+  async resolveEmbedStrict(embedId, dataAppName) {
+    const response = await this.embedsApi.getByEmbedId(embedId, dataAppName);
     const records = Array.isArray(response) ? response.filter((r) => !!r && typeof r === "object") : [response];
     const exact = records.filter((r) => r.embedId === embedId);
     if (exact.length === 1) return exact[0];
@@ -1093,8 +1110,8 @@ var EmbedService = class {
 Received records (sample): ${sample || "none"}`
     );
   }
-  async buildUpdateBase(embedId) {
-    const embed = await this.resolveEmbedStrict(embedId);
+  async buildUpdateBase(embedId, dataAppName) {
+    const embed = await this.resolveEmbedStrict(embedId, dataAppName);
     const existingAccess = extractAccessSettings(embed);
     if (existingAccess) {
       return { embedId, accessSettings: existingAccess };
@@ -1142,8 +1159,8 @@ Run \`update_embed\` with explicit \`accessSettings.datamartName\`, or recreate
       }
     };
   }
-  async updateEmbed(embedId, updatePatch) {
-    const body = await this.buildUpdateBase(embedId);
+  async updateEmbed(embedId, updatePatch, dataAppName) {
+    const body = await this.buildUpdateBase(embedId, dataAppName);
     const baseAccessSettings = asRecord2(body.accessSettings);
     const patchAccessSettings = asRecord2(updatePatch.accessSettings);
     for (const [key, value] of Object.entries(updatePatch)) {
@@ -1158,7 +1175,7 @@ Run \`update_embed\` with explicit \`accessSettings.datamartName\`, or recreate
     } else if (patchAccessSettings) {
       body.accessSettings = patchAccessSettings;
     }
-    return this.embedsApi.updateEmbed(body);
+    return this.embedsApi.updateEmbed({ ...body, ...dataAppName ? { dataAppName } : {} });
   }
 };
 
@@ -1226,7 +1243,7 @@ var WidgetService = class {
    * where the user only knows the dashboard + workspace, not the embedId or
    * data app name. Returns a business-user-friendly error on ambiguity.
    */
-  async resolveEmbedFromDashboard(dashboardName, workspaceName) {
+  async resolveEmbedFromDashboard(dashboardName, workspaceName, dataAppName) {
     const wsProvided = workspaceName && workspaceName.trim().length > 0 ? workspaceName.trim() : void 0;
     let dashboards;
     try {
@@ -1268,8 +1285,23 @@ var WidgetService = class {
       };
     }
     let embeds;
+    let dataAppSelectionAvailable = false;
     try {
-      embeds = await this.embedsApi.listEmbeds();
+      try {
+        embeds = await this.embedsApi.listEmbeds(dataAppName);
+      } catch (error) {
+        if (!(error instanceof DatabrainApiError) || error.code !== "DATA_APP_REQUIRED") throw error;
+        dataAppSelectionAvailable = true;
+        const apps = await this.dataAppsApi.listDataApps(dashboard.workspaceName || wsProvided);
+        embeds = [];
+        for (const app of apps) {
+          const name = app.name || app.dataAppName;
+          if (typeof name === "string" && name.trim()) {
+            const scoped = await this.embedsApi.listEmbeds(name);
+            embeds.push(...scoped.map((e) => ({ ...e, embedMetadata: { ...e.embedMetadata, dataAppName: name } })));
+          }
+        }
+      }
     } catch (err) {
       return {
         ok: false,
@@ -1295,10 +1327,11 @@ var WidgetService = class {
       };
     }
     if (embedMatches.length > 1) {
-      const names = embedMatches.map((x) => `"${x.n.name}"`).join(", ");
+      const names = embedMatches.map((x) => `"${x.n.name}" (embedId: ${x.n.embedId})`).join(", ");
+      const apps = [...new Set(embedMatches.map((x) => x.n.dataAppName).filter(Boolean))];
       return {
         ok: false,
-        error: `Dashboard "${dashboard.name}" has multiple embeds (${names}). Ask the user which embed name they want to customize.`
+        error: `Dashboard "${dashboard.name}" has multiple embeds (${names}). ` + (dataAppSelectionAvailable && apps.length > 1 ? `Pass dataAppName to choose one of: ${apps.join(", ")}, or select an embedId. (DATA_APP_REQUIRED)` : "Select an embedId and retry.")
       };
     }
     return {
@@ -1324,7 +1357,8 @@ var WidgetService = class {
     if (params.dashboardName && params.dashboardName.trim().length > 0) {
       const res = await this.resolveEmbedFromDashboard(
         params.dashboardName,
-        params.workspaceName
+        params.workspaceName,
+        params.dataAppName
       );
       if (!res.ok) return res;
       return {
@@ -1374,7 +1408,7 @@ var WidgetService = class {
         error: "`clientId` cannot be empty. Pick a tenant/client first."
       };
     }
-    const ctx = await this.resolveEmbedContext(params.embedId);
+    const ctx = await this.resolveEmbedContext(params.embedId, params.dataAppName);
     if (ctx.externalDashboardCreatedBy === clientId) {
       return {
         ok: true,
@@ -1449,7 +1483,7 @@ var WidgetService = class {
     }
     let ctx;
     try {
-      ctx = await this.resolveEmbedContext(params.embedId);
+      ctx = await this.resolveEmbedContext(params.embedId, params.dataAppName);
     } catch (err) {
       return { ok: false, error: err.message };
     }
@@ -1557,7 +1591,17 @@ Do not guess between the two \u2014 wait for the user to choose.`
       }
       return false;
     };
-    const target = datasources.find(matchPredicate);
+    let target = datasources.find(matchPredicate);
+    if (!target && provided.integrationId) {
+      for (const datasource of datasources) {
+        if (datasource._id || datasource.id || typeof datasource.name !== "string") continue;
+        const id3 = await this.datasourcesApi.resolveIdByName(datasource.name);
+        if (id3 === provided.integrationId) {
+          target = { ...datasource, id: id3 };
+          break;
+        }
+      }
+    }
     if (!target) {
       const available = datasources.filter((ds) => typeof ds.name === "string" && ds.name.trim().length > 0).map((ds) => `"${ds.name}"`).join(", ");
       const inactiveMatch = allDatasources.find(
@@ -1627,8 +1671,8 @@ Do not guess between the two \u2014 wait for the user to choose.`
     }
     return { kind: "no_metric_fields", widgetsTried: toProbe.length, fetchErrors };
   }
-  async resolveEmbedContext(embedId) {
-    const response = await this.embedsApi.getByEmbedId(embedId);
+  async resolveEmbedContext(embedId, dataAppNameHint) {
+    const response = await this.embedsApi.getByEmbedId(embedId, dataAppNameHint);
     const records = Array.isArray(response) ? response : response ? [response] : [];
     const exact = records.find((r) => r && r.embedId === embedId) || records[0];
     if (!exact) {
@@ -2171,12 +2215,13 @@ Save this in backend secrets immediately. This value may not be returned again.`
 }
 
 // src/tools/data-app/rotate-api-token.ts
+import { randomUUID } from "crypto";
 import { z as z9 } from "zod";
 function registerRotateApiToken(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "rotate_api_token",
-    "Rotate (invalidate and replace) an API token. Previous token becomes stale.",
+    "Rotate through the raw token-authenticated endpoint, or issue a replacement token for a data app. The replacement fallback does not revoke existing tokens.",
     {
       dataAppName: z9.string().optional().describe("Data app name. Omit to list available data apps."),
       tokenId: z9.string().optional().describe("Optional token ID to rotate"),
@@ -2216,13 +2261,14 @@ function registerRotateApiToken(server, client) {
 ` : "") + "Update backend secrets immediately."
           );
         }
+        if (params.tokenId) return toolError("Rotating a named token requires the token-authenticated raw body endpoint. No replacement was issued. Use the API token settings to retire a specific token.");
         const createRes = await client.request({
           method: "POST",
           path: "/api/v2/data-app/api-tokens",
           auth: "service",
           body: {
             dataAppName,
-            name: `${dataAppName}-api-token-rotated`
+            name: `${dataAppName}-rotated-${randomUUID()}`
           }
         });
         if (createRes.error) {
@@ -2235,7 +2281,7 @@ function registerRotateApiToken(server, client) {
 
 ` + (key ? `**New Token:** \`${key}\`
 
-` : "") + "Treat previous tokens as stale and update backend secrets."
+` : "") + "Existing tokens remain active. Update backend secrets, then retire the old token in API token settings."
         );
       } catch (err) {
         if (err instanceof DatabrainApiError) return err.toToolResponse();
@@ -2745,7 +2791,8 @@ function registerCreateEmbed(server, client) {
       body: z14.record(z14.unknown()).optional().describe(
         "Raw API body passthrough. If provided, all other fields are ignored."
       ),
-      dashboardId: z14.string().optional().describe("Dashboard identifier for embed creation"),
+      dataAppName: z14.string().optional().describe("Data app name; required when the workspace has more than one"),
+      dashboardId: z14.string().optional().describe("Existing dashboard UUID or externalDashboardId slug for a standard embed; a new unique slug for a client dashboard copy"),
       workspaceName: z14.string().optional().describe("Workspace name. Omit to auto-resolve if only one exists."),
       embedType: z14.enum(["dashboard", "metric"]).optional().describe("Embed type"),
       metricId: z14.string().optional().describe("Required for metric embed type"),
@@ -2755,15 +2802,23 @@ function registerCreateEmbed(server, client) {
       clientId: z14.string().optional().describe(
         "Client identifier for multi-tenant isolation. When provided, creates a dashboard embed (each client gets their own dashboard copy)."
       ),
-      templateDashboardId: z14.string().optional().describe("Template dashboard ID to clone metrics from"),
+      templateDashboardId: z14.string().optional().describe("Template dashboard UUID or externalDashboardId slug to clone metrics from"),
       isImportMetrics: z14.boolean().optional().describe("Import metrics from template dashboard"),
-      metricImportMode: z14.enum(["COPY", "LINK"]).optional().describe("COPY duplicates metrics, LINK shares them"),
+      metricImportMode: z14.enum(["GALLERY", "METRIC"]).optional().describe("GALLERY imports dashboard gallery metrics; METRIC imports selected metrics"),
       isRenameDashboard: z14.boolean().optional().describe("Rename the dashboard for this client")
     },
     WRITE_CREATE,
     async (params) => {
       try {
         const isMultiTenant = !!params.clientId;
+        const dashboardSlug = async (value, workspace) => {
+          if (typeof value !== "string" || !z14.string().uuid().safeParse(value).success) return value;
+          if (typeof workspace !== "string" || !workspace) throw new Error("workspaceName is required to resolve a dashboard UUID.");
+          const boards = await services.dashboardsApi.listDashboardsForWorkspace(workspace);
+          const board = boards.find((item) => item.id === value || item.dashboardId === value);
+          if (!board?.externalDashboardId) throw new Error("Dashboard not found in this workspace. Use list_dashboards to choose one.");
+          return board.externalDashboardId;
+        };
         let resolvedWorkspaceName = params.workspaceName;
         if (!params.body && isMultiTenant && !resolvedWorkspaceName) {
           const workspaces = await services.workspacesApi.listWorkspaces();
@@ -2781,6 +2836,7 @@ function registerCreateEmbed(server, client) {
         if (isMultiTenant) {
           const body2 = params.body ? { ...params.body } : {
             dashboardId: params.dashboardId,
+            dataAppName: params.dataAppName,
             workspaceName: resolvedWorkspaceName,
             clientId: params.clientId,
             name: params.name,
@@ -2792,10 +2848,13 @@ function registerCreateEmbed(server, client) {
           };
           const callerAccess = body2.accessSettings && typeof body2.accessSettings === "object" ? body2.accessSettings : {};
           body2.accessSettings = { ...DEFAULT_ACCESS_SETTINGS2, ...callerAccess };
+          if (body2.templateDashboardId) body2.templateDashboardId = await dashboardSlug(body2.templateDashboardId, body2.workspaceName);
+          const { dataAppName, ...payload } = body2;
           const result2 = await client.request({
             method: "POST",
             path: "/api/v2/data-app/dashboard-embeds",
-            body: body2,
+            query: typeof dataAppName === "string" ? { dataAppName } : void 0,
+            body: payload,
             auth: "api",
             invalidateCache: ["list_embeds"]
           });
@@ -2816,6 +2875,7 @@ Next: use \`generate_guest_token\` with the clientId and \`generate_embed_code\`
         }
         const body = params.body ? { ...params.body } : {
           dashboardId: params.dashboardId,
+          dataAppName: params.dataAppName,
           workspaceName: params.workspaceName,
           embedType: params.embedType || "dashboard",
           metricId: params.metricId,
@@ -2836,6 +2896,7 @@ Next: use \`generate_guest_token\` with the clientId and \`generate_embed_code\`
         if (!datamartName || typeof datamartName !== "string") {
           return toolError("create_embed requires `accessSettings.datamartName`.");
         }
+        body.dashboardId = await dashboardSlug(body.dashboardId, body.workspaceName);
         const result = await services.embedService.createEmbedStrict(body);
         if (result.error) {
           return toolError(`Embed creation failed: ${stringify(result.error)}`);
@@ -2925,12 +2986,13 @@ function registerGetEmbedDetails(server, client) {
     "get_embed_details",
     "Get full embed configuration including access settings and theme.",
     {
-      embedId: z16.string().describe("ID of the embed")
+      embedId: z16.string().describe("ID of the embed"),
+      dataAppName: z16.string().trim().min(1).optional().describe("Data app when this embed ID belongs to several apps")
     },
     READ_ONLY,
     async (params) => {
       try {
-        const embed = await services.embedService.resolveEmbedStrict(params.embedId);
+        const embed = await services.embedService.resolveEmbedStrict(params.embedId, params.dataAppName);
         return toolSuccess(JSON.stringify({ embedId: params.embedId, ...embed }));
       } catch (err) {
         if (err instanceof DatabrainApiError) return err.toToolResponse();
@@ -2980,6 +3042,7 @@ function registerUpdateEmbed(server, client) {
     "Update embed access settings, permissions, theme, or name.",
     {
       embedId: z17.string().describe("ID of the embed to update"),
+      dataAppName: z17.string().trim().min(1).optional().describe("Data app when this embed ID belongs to several apps"),
       body: z17.record(z17.unknown()).optional().describe(
         "Raw API body for PUT /api/v2/data-app/embeds. If provided, it is sent directly (passthrough mode)."
       ),
@@ -2997,6 +3060,7 @@ function registerUpdateEmbed(server, client) {
         if (params.body) {
           const rawBody = { ...params.body };
           if (!rawBody.embedId) rawBody.embedId = params.embedId;
+          if (params.dataAppName) rawBody.dataAppName = params.dataAppName;
           const result2 = await services.embedsApi.updateEmbed(rawBody);
           if (result2.error) {
             return toolError(`Embed update failed: ${stringify(result2.error)}`);
@@ -3011,7 +3075,8 @@ function registerUpdateEmbed(server, client) {
         if (params.theme) patch.theme = params.theme;
         const result = await services.embedService.updateEmbed(
           params.embedId,
-          patch
+          patch,
+          params.dataAppName
         );
         if (result.error) {
           return toolError(`Embed update failed: ${stringify(result.error)}`);
@@ -3373,6 +3438,7 @@ function registerCustomizeTheme(server, client) {
     `Theme an embed: presets (${Object.keys(THEME_PRESETS).join("/")}), colors, fonts, cards, chart appearance, responsive layout, or access presets (${Object.keys(ACCESS_PRESETS).join("/")}).`,
     {
       embedId: z18.string().describe("ID of the embed to theme"),
+      dataAppName: z18.string().trim().min(1).optional().describe("Data app when this embed ID belongs to several apps"),
       body: z18.record(z18.unknown()).optional().describe(
         "Raw API body for PUT /api/v2/data-app/embeds. If provided, sent directly and all convenience fields are ignored."
       ),
@@ -3485,11 +3551,12 @@ function registerCustomizeTheme(server, client) {
     },
     WRITE_IDEMPOTENT,
     async (params) => {
-      const { embedId, body, themePreset, accessPreset, ...themeParams } = params;
+      const { embedId, dataAppName, body, themePreset, accessPreset, ...themeParams } = params;
       if (body) {
         try {
           const rawBody = { ...body };
           if (!rawBody.embedId) rawBody.embedId = embedId;
+          if (dataAppName) rawBody.dataAppName = dataAppName;
           const result = await services.embedsApi.updateEmbed(rawBody);
           if (result.error) {
             return toolError(`Theme update failed: ${stringify(result.error)}`);
@@ -3522,7 +3589,7 @@ function registerCustomizeTheme(server, client) {
         return toolError("No theme properties provided. Specify at least one property, or use a themePreset.");
       }
       try {
-        const result = await services.embedService.updateEmbed(embedId, patch);
+        const result = await services.embedService.updateEmbed(embedId, patch, dataAppName);
         if (result.error) {
           return toolError(`Theme update failed: ${stringify(result.error)}`);
         }
@@ -3567,6 +3634,7 @@ function registerGetDemoLink(server, client) {
       clientId: z19.string().describe("End-customer identifier to scope the preview to."),
       dashboardName: z19.string().optional().describe("Dashboard name (non-technical). Preferred \u2014 pass with optional `workspaceName`."),
       workspaceName: z19.string().optional().describe("Workspace name. Only needed if `dashboardName` is ambiguous."),
+      dataAppName: z19.string().trim().min(1).optional().describe("Data app name when dashboard embeds span several apps"),
       embedId: z19.string().optional().describe("Technical alternative to `dashboardName`."),
       expiryHours: z19.number().min(1).max(MAX_EXPIRY_HOURS).optional().describe(`Token TTL in hours. Defaults to ${DEFAULT_EXPIRY_HOURS}. Max ${MAX_EXPIRY_HOURS} (30 days).`)
     },
@@ -3577,12 +3645,13 @@ function registerGetDemoLink(server, client) {
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
         const embedId = embed.value.embedId;
         const dashboardName = embed.value.resolvedFrom?.dashboardName || null;
-        const ctx = await services.widgetService.resolveEmbedContext(embedId);
+        const ctx = await services.widgetService.resolveEmbedContext(embedId, params.dataAppName);
         if (!ctx.dataAppName) {
           return toolError(
             `Could not resolve the data app for embed "${embedId}". The demo link needs a data app to mint a guest token against. Run \`list_data_apps\` to confirm one exists, or pass \`embedId\` for an embed with metadata.dataAppName populated.`
@@ -4818,9 +4887,11 @@ function registerListDashboards(server, client) {
           count: result.length,
           scope: useDataAppScope ? "data_app" : "global",
           dashboards: result.map((d) => {
-            const { name, dashboardId, workspaceName, metricCount } = services.discoveryService.normalizeDashboard(d);
+            const { name, dashboardId, externalDashboardId, workspaceName, metricCount } = services.discoveryService.normalizeDashboard(d);
             return {
               id: dashboardId || null,
+              dashboardId,
+              externalDashboardId,
               name,
               workspace: workspaceName || null,
               metricCount: metricCount ?? null
@@ -4926,6 +4997,7 @@ function registerGenerateDashboardTiles(server, client) {
     "Generate multiple workspace dashboard tile drafts without persisting them.",
     {
       workspaceName: workspaceNameSchema,
+      clientId: z24.string().trim().min(1).describe("Tenant client identifier in this data app; use list_tenants to choose it"),
       dataAppName: z24.string().optional().describe("Data app in the workspace; auto-resolved when unique"),
       integrationId: z24.string().optional().describe("Datasource UUID override"),
       integrationName: z24.string().optional().describe("Datasource name override"),
@@ -4955,10 +5027,10 @@ function registerGenerateDashboardTiles(server, client) {
           method: "POST",
           path: "/api/v2/guest-token/create",
           auth: "service",
-          body: { clientId: "None", dataAppName: resolution.name }
+          body: { clientId: params.clientId, dataAppName: resolution.name }
         });
         const datasource = await services.widgetService.resolveDatasource(guest.token, {
-          clientId: "None",
+          clientId: params.clientId,
           integrationId: params.integrationId,
           integrationName: params.integrationName
         });
@@ -4979,11 +5051,6 @@ function registerGenerateDashboardTiles(server, client) {
               `Tile "${item.input.id}" generation failed: ${stringify(item.result.error)}`
             );
           }
-          if (typeof item.result.chartType !== "string" || !item.result.chartType) {
-            return toolError(
-              `Tile "${item.input.id}" returned no chartType. Refine its userInputs and retry.`
-            );
-          }
         }
         return toolSuccess(
           stringify({
@@ -4995,7 +5062,7 @@ function registerGenerateDashboardTiles(server, client) {
               position: input.position,
               title: input.title,
               chart: {
-                type: result.chartType,
+                type: result.chartType || "table",
                 query: result.query,
                 companyIntegrationId: datasource.value.integrationId
               }
@@ -5020,12 +5087,13 @@ function registerGenerateDashboardTiles(server, client) {
 // src/tools/dashboard/get-dashboard.ts
 import { z as z25 } from "zod";
 function registerGetDashboard(server, client) {
-  server.tool(
+  const tool = server.tool(
     "get_dashboard",
     "Retrieve a workspace dashboard projected back into the versioned tile-list contract.",
     {
-      workspaceName: workspaceNameSchema,
-      dashboardId: z25.string().min(1).describe("Dashboard identifier returned by create_dashboard")
+      workspaceName: workspaceNameSchema.optional(),
+      workspaceId: z25.string().min(1).optional().describe("Workspace UUID from a dashboard link wid parameter"),
+      dashboardId: z25.string().min(1).describe("Dashboard UUID or externalDashboardId slug returned by list_dashboards or create_dashboard")
     },
     READ_ONLY,
     async (params) => {
@@ -5035,10 +5103,33 @@ function registerGetDashboard(server, client) {
           path: "/api/v2/workspace/dashboard",
           auth: "service",
           query: {
-            workspaceName: params.workspaceName,
+            ...params.workspaceName ? { workspaceName: params.workspaceName } : {},
+            ...params.workspaceId ? { workspaceId: params.workspaceId } : {},
             dashboardId: params.dashboardId
           }
         });
+        if (hasChartApps(server) && client.isHosted()) {
+          const tiles = Array.isArray(result.tiles) ? result.tiles : [];
+          const charts = tiles.filter((t) => !t.unavailable && t.chart?.metricRef);
+          const dashboardId = String(result.dashboardId || params.dashboardId);
+          const picker = {
+            kind: "dashboard",
+            title: result.title || "Dashboard",
+            rows: [],
+            widgets: charts.map((t) => ({
+              name: t.title || "Widget",
+              chartType: t.chart.type || null,
+              reference: { dashboardId, widgetId: t.chart.metricRef }
+            })),
+            dashboardId: result.dashboardId
+          };
+          try {
+            return chartResult(stringify(result), picker);
+          } catch (error) {
+            if (!(error instanceof Error) || error.message !== "Chart page exceeds payload budget") throw error;
+            return chartResult(`Dashboard ready. ${picker.widgets.length} saved charts. The tile shows a compact picker because the full dashboard document exceeds the App payload budget. ` + chartIndex(dashboardId, picker.widgets.map((w) => ({ widgetId: w.reference.widgetId, name: w.name, chartType: w.chartType }))), picker);
+          }
+        }
         return toolSuccess(stringify(result));
       } catch (err) {
         if (err instanceof DatabrainApiError) return err.toToolResponse();
@@ -5046,6 +5137,7 @@ function registerGetDashboard(server, client) {
       }
     }
   );
+  tagChartTool(server, tool);
 }
 
 // src/tools/dashboard/dashboard-snapshot.ts
@@ -5315,14 +5407,14 @@ function registerAskQuestion(server, client) {
     async (params) => {
       try {
         let datamartName = params.datamartName;
-        if (!datamartName) {
+        {
           const datamarts = await services.datamartsApi.listDatamarts();
           if (!Array.isArray(datamarts) || datamarts.length === 0) {
             return toolError(
-              "No datamarts found. A datamart is **required** before you can query data.\n\nTell the user they need to create a datamart in the **Databrain UI** first:\n1. Go to the Databrain platform and connect a datasource\n2. Create a datamart by selecting tables from the datasource\n3. Come back here and use `ask_question` with the `datamartName`\n\nYou can use `list_datasources` and `discover_datasource_schema` to explore what's available."
+              "No datamarts are available in this workspace. A datamart is **required** before you can query data.\n\nTell the user they need to create a datamart in the **Databrain UI** first:\n1. Go to the Databrain platform and connect a datasource\n2. Create a datamart by selecting tables from the datasource\n3. Come back here and use `ask_question` with the `datamartName`\n\nYou can use `list_datasources` and `discover_datasource_schema` to explore what's available."
             );
           }
-          if (datamarts.length === 1) {
+          if (!datamartName && datamarts.length === 1) {
             const resolvedName = datamarts[0].name || datamarts[0].datamartName;
             if (!resolvedName) {
               return toolError(
@@ -5330,7 +5422,7 @@ function registerAskQuestion(server, client) {
               );
             }
             datamartName = resolvedName;
-          } else {
+          } else if (!datamartName) {
             const list = datamarts.map(formatDatamart).join("\n");
             return toolSuccess(
               `Found ${datamarts.length} datamarts. Please specify which one to query:
@@ -5985,19 +6077,17 @@ function registerEvalSemanticModel(server, client) {
   const api = createServiceBundle(client).semanticModelApi;
   server.tool(
     "eval_semantic_model",
-    "Evaluate saved queries and optional questions against a proposed or stored semantic model. Returns the pass rate and each verdict with its reason. Runs warehouse queries without changing the model.",
-    { datamartId, source: source.optional(), questions: z30.array(z30.union([z30.string().trim().min(1), z30.object({
-      name: z30.string().optional(),
-      question: z30.string().min(1),
-      sql: z30.string().optional(),
-      expected_columns: z30.array(z30.string()).optional(),
-      expected_empty: z30.boolean().optional()
-    }).strict()])).max(100).optional() },
+    "Evaluate closed world semantic assertions against proposed or stored YAML. Each question must name an id and the model entities it exercises. Does not execute warehouse SQL or write the model.",
+    { datamartId, source: source.optional(), questions: z30.array(z30.object({
+      id: z30.string().trim().min(1),
+      question: z30.string().trim().min(1),
+      exercises: z30.array(z30.string().trim().min(1)).describe("Exact model entity names asserted by this question; an empty list is reported as unscoreable.")
+    }).strict()).max(100).default([]) },
     READ_ONLY,
     async ({ datamartId: datamartId2, source: source2, questions }) => {
-      const shaped = questions?.map((entry) => typeof entry === "string" ? { question: entry } : entry);
       try {
-        return toolSuccess(stringify(await api.evaluate(datamartId2, { source: source2, questions: shaped })));
+        const yaml = source2 ?? (await api.pull(datamartId2, "combined")).source;
+        return toolSuccess(stringify(await api.evaluate(datamartId2, { source: yaml, questions })));
       } catch (error) {
         return failure(error);
       }
@@ -6292,7 +6382,7 @@ function registerStartSemanticLayerGeneration(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "start_semantic_layer_generation",
-    "Start backend semantic-layer auto-generation for a datamart. Returns an async job id to poll.",
+    "Start backend semantic-layer auto-generation for a datamart through a hosted OAuth sign-in. Static service-token authentication is not supported by this backend route. Returns an async job id to poll.",
     {
       datamartName: z32.string().optional().describe("Datamart name. Omit to list available datamarts"),
       workspaceName: z32.string().optional().describe("Workspace linked to the datamart. Use when datamartName resolution needs a dataMartId bridge."),
@@ -6336,7 +6426,7 @@ function registerGetSemanticLayerGenerationStatus(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "get_semantic_layer_generation_status",
-    "Get semantic-layer auto-generation job status for a datamart.",
+    "Get semantic-layer auto-generation job status for a datamart through a hosted OAuth sign-in. Static service-token authentication is not supported by this backend route.",
     {
       datamartName: z32.string().optional().describe("Datamart name. Omit to list available datamarts"),
       workspaceName: z32.string().optional().describe("Workspace linked to the datamart. Use when datamartName resolution needs a dataMartId bridge."),
@@ -6388,9 +6478,12 @@ function registerListWidgets(server, client) {
   const services = createServiceBundle(client);
   const tool = server.tool(
     "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.",
+    "List saved widgets. Hosted sign-ins read an authorized workspace dashboard without an embed; guest/API flows use clientId and an embed.  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: z33.string().describe("Client/tenant identifier for this dashboard"),
+      clientId: z33.string().optional().describe("Client/tenant identifier for this dashboard"),
+      dataAppName: z33.string().trim().min(1).optional().describe("Data app for a tenant/embed read. Omit to resolve it from the embed; hosted workspace reads need none."),
+      workspaceId: z33.string().min(1).optional().describe("Workspace UUID from the wid query parameter in a dashboard link."),
+      dashboardId: z33.string().min(1).optional().describe("Dashboard UUID or slug returned by list_dashboards. Hosted sign-ins 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.")
@@ -6398,17 +6491,62 @@ function registerListWidgets(server, client) {
     READ_ONLY,
     async (params) => {
       try {
+        if (params.dashboardId && (params.clientId !== void 0 || params.embedId)) {
+          return toolError("dashboardId is for hosted workspace reads. For a tenant, use clientId with dashboardName or embedId.");
+        }
+        if (client.isHosted() && params.clientId === void 0 && !params.embedId) {
+          const result = await client.request({
+            method: "POST",
+            path: "/api/v2/workspace/dashboard/widgets",
+            auth: "service",
+            body: {
+              ...params.dashboardId ? { dashboardId: params.dashboardId } : {},
+              ...params.dashboardName ? { dashboardName: params.dashboardName } : {},
+              workspaceName: params.workspaceName,
+              workspaceId: params.workspaceId
+            }
+          });
+          const widgets2 = result.widgets;
+          if (hasChartApps(server)) {
+            const references = widgets2.slice(0, 50).flatMap((widget) => {
+              const widgetId = widgetReferenceId(widget);
+              return widgetId ? [{
+                name: widget.name || "Untitled widget",
+                chartType: typeof widget.chartType === "string" ? widget.chartType : null,
+                reference: { dashboardId: result.dashboardId, widgetId }
+              }] : [];
+            });
+            return chartResult(`${widgets2.length} saved widgets available. ` + chartIndex(
+              result.dashboardId,
+              references.map((r) => ({ widgetId: r.reference.widgetId, name: r.name, chartType: r.chartType }))
+            ), {
+              kind: "dashboard",
+              title: params.dashboardName || "Dashboard",
+              rows: [],
+              widgets: references,
+              dashboardId: result.dashboardId,
+              externalDashboardId: result.externalDashboardId,
+              description: widgets2.length > 50 ? "Showing the first 50 widgets." : ""
+            });
+          }
+          return toolSuccess(JSON.stringify(result));
+        }
+        if (!params.clientId) return toolError("clientId is required for an embed/tenant dashboard. Hosted sign-ins may omit it for a workspace dashboard.");
         const embed = await services.widgetService.resolveEmbedId({
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
         const embedId = embed.value.embedId;
+        const app = client.isHosted() ? await services.widgetService.resolveDataAppName(params.dataAppName, embedId) : { ok: true, value: params.dataAppName };
+        if (!app.ok) return toolError(app.error);
         const widgets = await services.widgetsApi.listWidgets(
           embedId,
-          params.clientId
+          params.clientId,
+          app.value
         );
         if (hasChartApps(server)) {
           const visible = (Array.isArray(widgets) ? widgets : []).slice(0, 50);
@@ -6416,7 +6554,12 @@ function registerListWidgets(server, client) {
             const widgetId = widgetReferenceId(w);
             return widgetId ? [{
               name: typeof w.name === "string" ? w.name.slice(0, 500) : "Untitled widget",
-              reference: { widgetId, embedId, clientId: params.clientId }
+              reference: {
+                widgetId,
+                embedId,
+                clientId: params.clientId,
+                ...app.value ? { dataAppName: app.value } : {}
+              }
             }] : [];
           });
           return chartResult(`${references.length} widgets available in the first dashboard page.`, {
@@ -6488,11 +6631,12 @@ function registerAddWidget(server, client) {
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
         const embedId = embed.value.embedId;
-        const ctx = await services.widgetService.resolveEmbedContext(embedId);
+        const ctx = await services.widgetService.resolveEmbedContext(embedId, params.dataAppName);
         if (!ctx.externalDashboardId) {
           return toolError(
             `Dashboard "${params.dashboardName || embedId}" has no externalDashboardId \u2014 cannot attach a widget. Verify via \`get_embed_details\`.`
@@ -6652,6 +6796,7 @@ function registerUpdateWidget(server, client) {
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
@@ -6724,6 +6869,7 @@ function registerRemoveWidget(server, client) {
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
@@ -6794,6 +6940,7 @@ function registerGenerateWidget(server, client) {
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
@@ -6918,11 +7065,12 @@ function registerCreateOrUpdateMetricFromQuery(server, client) {
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
         const embedId = embed.value.embedId;
-        const ctx = await services.widgetService.resolveEmbedContext(embedId);
+        const ctx = await services.widgetService.resolveEmbedContext(embedId, params.dataAppName);
         if (!ctx.externalDashboardId) {
           return toolError(
             `Dashboard "${params.dashboardName || embedId}" has no externalDashboardId. Verify with get_embed_details before creating metrics.`
@@ -7171,11 +7319,12 @@ function registerValidateMetricSpec(server, client) {
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
         const embedId = embed.value.embedId;
-        const ctx = await services.widgetService.resolveEmbedContext(embedId);
+        const ctx = await services.widgetService.resolveEmbedContext(embedId, params.dataAppName);
         if (!ctx.externalDashboardId) {
           return toolError(
             `Dashboard "${params.dashboardName || embedId}" has no externalDashboardId. Verify with get_embed_details before creating metrics.`
@@ -7260,6 +7409,7 @@ function registerListScheduledReports(server, client) {
       clientId: z41.string().describe("Client/tenant identifier. Required by the current backend API for non-empty results"),
       dashboardName: z41.string().optional().describe("Dashboard name to inspect"),
       workspaceName: z41.string().optional().describe("Workspace name if dashboardName is ambiguous"),
+      dataAppName: z41.string().trim().min(1).optional().describe("Data app name when dashboard embeds span several apps"),
       embedId: z41.string().optional().describe("Technical embed id alternative to dashboardName"),
       userIdentifier: z41.string().optional().describe("Optional creator/user filter"),
       pageNumber: z41.number().int().positive().optional().describe("Page number when pagination is enabled"),
@@ -7272,12 +7422,16 @@ function registerListScheduledReports(server, client) {
           embedId: params.embedId,
           dashboardName: params.dashboardName,
           workspaceName: params.workspaceName,
+          dataAppName: params.dataAppName,
           required: true
         });
         if (!embed.ok) return toolError(embed.error);
         const embedId = embed.value.embedId;
+        const app = client.isHosted() ? await services.widgetService.resolveDataAppName(params.dataAppName, embedId) : { ok: true, value: params.dataAppName };
+        if (!app.ok) return toolError(app.error);
         const reports = await services.scheduledReportsApi.listByEmbed({
           embedId,
+          dataAppName: app.value,
           clientId: params.clientId,
           userIdentifier: params.userIdentifier,
           pageNumber: params.pageNumber,
@@ -7746,6 +7900,7 @@ var TOOL_TITLES = {
   apply_semantic_change: "Apply semantic model change",
   eval_semantic_model: "Evaluate semantic model",
   list_widgets: "List widgets",
+  render_metric_tile: "Render a saved metric tile",
   validate_metric_spec: "Validate metric spec",
   create_or_update_metric_from_query: "Create or update metric from SQL",
   create_workspace_metric: "Create workspace metric",
@@ -9737,7 +9892,7 @@ The v2 source is one YAML document. Use the configured service credential and a
 
 1. \`search_semantic_model\` finds entities by question. \`get_semantic_entity\` reads one entity by kind and name. Column names use table.column.
 2. \`propose_semantic_change\` takes complete source YAML, a YAML patch or one structured change. It returns candidate source, validation errors, a plan and the stored expected hash without writing.
-3. \`eval_semantic_model\` evaluates the proposed source.
+3. \`eval_semantic_model\` checks closed-world assertions against the proposed source; optional questions use id, question and exercises (exact entity names). It does not execute SQL.
 4. \`apply_semantic_change\` defaults to a dry run. Live apply requires the exact reviewed source, \`expected_content_hash\`, \`dry_run: false\` and user supplied \`confirm: "APPLY_TO_PRODUCTION"\`. Never supply confirmation yourself. Apply changes the live model for all consumers. On a conflict, prepare a fresh proposal and review it again.
 
 YAML patches merge mappings and named lists by name. Other lists replace. Empty lists clear; null removes a field. Structured changes use operation upsert or remove, kind, name, and value for upsert. Column changes also require table. Patch output normalizes formatting and comments, so review the returned source before apply.
@@ -10818,7 +10973,7 @@ var populateSemanticLayerPrompt = `You are helping the user populate the semanti
 If \`list_datamarts\` reports \`semanticLayerVersion: "v2"\`, or the selected datamart is already known to use v2, use this workflow instead of the legacy steps below:
 1. Inspect relevant entities with \`search_semantic_model\` and \`get_semantic_entity\`, using the datamart ID.
 2. Call \`propose_semantic_change\` with a YAML patch or structured change. Show its errors and plan. Correct errors before continuing.
-3. Call \`eval_semantic_model\` with the returned source. Show the verdicts and let the user review the candidate.
+3. Call \`eval_semantic_model\` with the returned source. For scored assertions, supply questions with id, question and exercises (exact model entity names); this does not run SQL. Show the verdicts and let the user review the candidate.
 4. Stop for the user's explicit \`APPLY_TO_PRODUCTION\` confirmation. Never supply it yourself.
 5. Call \`apply_semantic_change\` with the exact reviewed source, its \`expected_content_hash\`, \`dry_run: false\` and the user's confirmation. A conflict requires a new proposal and review.
 6. Call \`get_semantic_entity\` and inspect the changed entity. Do not call \`update_semantic_layer\` for a v2 model.
@@ -11193,6 +11348,7 @@ export {
   CUSTOM_BUNDLE_CHUNK_CHARS,
   rowsSchema,
   referenceSchema,
+  dateRangeSchema,
   viewSchema,
   pageSchema,
   bounded,
@@ -11211,4 +11367,4 @@ export {
   registerAllResources,
   registerAllPrompts
 };
-//# sourceMappingURL=chunk-ES2LUP4U.js.map
+//# sourceMappingURL=chunk-OLOC2MTA.js.map