@databrainhq/mcp-server 0.3.0-rc.7 → 0.3.0-rc.9

package/dist/{chunk-JSYG7ULR.js → chunk-VK6XPPBT.js}

@@ -18,7 +18,7 @@ import {
   toolError,
   toolSuccess,
   validateBundle
-} from "./chunk-ETXH5HTT.js";
+} from "./chunk-H3SI2MAU.js";
 
 // src/apps/contract.ts
 import { z } from "zod";
@@ -129,6 +129,8 @@ var TOOL_METADATA = {
   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" },
+  // Hosted only (an "All workspaces" sign-in); stdio does not register it.
+  create_workspace: { category: "infrastructure", workflowIntent: "setup_data", effect: "commit" },
   // Embedding — data apps & tokens
   list_data_apps: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
   list_tenants: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
@@ -152,6 +154,8 @@ var TOOL_METADATA = {
   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" },
+  // Persists nothing the user sees, but the backend mints (and then deletes) an internal guest token to render it.
+  dashboard_snapshot: { category: "internal_analytics", workflowIntent: "query_data", effect: "commit" },
   // 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" },
@@ -183,7 +187,6 @@ var TOOL_METADATA = {
   propose_semantic_change: { category: "semantic_layer", workflowIntent: "model_data", effect: "read" },
   apply_semantic_change: { category: "semantic_layer", workflowIntent: "model_data", effect: "commit" },
   eval_semantic_model: { category: "semantic_layer", workflowIntent: "query_data", effect: "read" },
-  semantic_readiness: { category: "semantic_layer", workflowIntent: "model_data", effect: "read" },
   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" },
@@ -617,9 +620,6 @@ var SemanticModelApi = class {
       noRetryOnTimeout: true
     });
   }
-  readiness(id2) {
-    return this.client.request({ method: "GET", path: this.path(id2, "readiness"), auth: "service" });
-  }
 };
 
 // src/api/tenants-api.ts
@@ -1972,8 +1972,9 @@ function registerCreateApiToken(server, client) {
           );
         }
         client.setRuntimeApiToken(key);
+        const used = client.hasApiToken() ? "API token created and set for this MCP session." : "API token created. This session keeps acting as the signed-in user; the token is for your backend.";
         return toolSuccess(
-          `API token created and set for this MCP session.
+          `${used}
 
 **Token:** \`${key}\`
 
@@ -4865,20 +4866,75 @@ function registerGetDashboard(server, client) {
   );
 }
 
+// src/tools/dashboard/dashboard-snapshot.ts
+import { z as z24 } from "zod";
+var SNAPSHOT_REQUEST_MS = 45e3;
+function registerDashboardSnapshot(server, client) {
+  server.tool(
+    "dashboard_snapshot",
+    "Get a PNG picture of a dashboard, or of one chart on it (metricId), as the signed-in user sees it in Databrain. Light or dark, 480 to 1600 px wide. Needs a Databrain sign-in (OAuth), not a service token.",
+    {
+      workspaceName: workspaceNameSchema.optional(),
+      dashboardId: z24.string().min(1).max(200).optional().describe("Dashboard id from list_dashboards. Needed unless metricId is given."),
+      metricId: z24.string().min(1).max(200).optional().describe("One chart (metric) id: draw only that chart, from a dashboard it is on."),
+      theme: z24.enum(["light", "dark"]).default("light").describe("Picture colours"),
+      width: z24.number().int().min(480).max(1600).default(1200).describe("Picture width in pixels")
+    },
+    READ_ONLY,
+    async (params) => {
+      if (!params.dashboardId && !params.metricId) {
+        return toolError("Name a dashboardId (from list_dashboards), or a metricId for one chart.");
+      }
+      try {
+        const result = await client.request({
+          method: "POST",
+          path: "/api/v2/workspace/dashboard/snapshot",
+          auth: "service",
+          timeoutMs: SNAPSHOT_REQUEST_MS,
+          body: {
+            ...params.workspaceName ? { workspaceName: params.workspaceName } : {},
+            ...params.dashboardId ? { dashboardId: params.dashboardId } : {},
+            ...params.metricId ? { metricId: params.metricId } : {},
+            theme: params.theme,
+            width: params.width
+          }
+        });
+        if (result?.mimeType !== "image/png" || typeof result.image !== "string" || !result.image) {
+          return toolError("The snapshot answer had no picture. Try again.");
+        }
+        const what = result.metric?.name ? `Chart "${result.metric.name}" on dashboard "${result.dashboard?.name ?? ""}"` : `Dashboard "${result.dashboard?.name ?? ""}"`;
+        const text2 = [
+          `${what} in workspace "${result.workspace?.name ?? ""}", ${result.theme ?? params.theme}, ${result.width}x${result.height} px.`,
+          result.summary ?? ""
+        ].filter(Boolean).join("\n");
+        return {
+          content: [
+            { type: "text", text: text2 },
+            { type: "image", data: result.image, mimeType: "image/png" }
+          ]
+        };
+      } catch (err) {
+        if (err instanceof DatabrainApiError) return err.toToolResponse();
+        return toolError(`Unexpected error: ${err.message}`);
+      }
+    }
+  );
+}
+
 // src/apps/preview.ts
 import { createHash } from "crypto";
-import { z as z24 } from "zod";
-var draftSchema = z24.object({
-  question: z24.string().min(1).max(2e3),
-  sql: z24.string().min(1).max(2e4),
-  datamartName: z24.string().min(1).max(256),
-  dimensions: z24.array(z24.string().max(128)).max(20).default([]),
-  measures: z24.array(z24.string().max(128)).max(20).default([]),
-  chartType: z24.string().min(1).max(80),
-  title: z24.string().min(1).max(200),
-  sessionId: z24.string().max(256).optional(),
+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: z24.array(z24.string().max(256)).max(50).default([])
+  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";
@@ -5005,7 +5061,7 @@ async function saveDraftAsDashboard(client, draft, input) {
 }
 
 // src/tools/query/ask-question.ts
-import { z as z25 } from "zod";
+import { z as z26 } from "zod";
 
 // src/tools/query/answer-format.ts
 function formatConfidence(value) {
@@ -5062,16 +5118,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) => {
@@ -5267,14 +5323,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."
       )
     },
@@ -5384,7 +5440,7 @@ ${result.feedback}`);
 }
 
 // src/tools/query/semantic-model.ts
-import { z as z27 } from "zod";
+import { z as z28 } from "zod";
 
 // src/services/semantic-source.ts
 import { parseDocument, stringify as stringify2 } from "yaml";
@@ -5584,21 +5640,21 @@ function retrieveSemanticSource(source2, question, k) {
 }
 
 // src/tools/query/semantic-model.ts
-var datamartId = z27.string().trim().min(1).max(256).describe("Datamart ID from list_datamarts.");
-var source = z27.string().min(1).max(2e6).describe("Complete proposed semantic model as YAML.");
-var entityKind = z27.enum(["table", "column", "measure", "metric", "join", "entity", "glossary", "saved_query", "instruction", "access_rule"]);
+var datamartId = z28.string().trim().min(1).max(256).describe("Datamart ID from list_datamarts.");
+var source = z28.string().min(1).max(2e6).describe("Complete proposed semantic model as YAML.");
+var entityKind = z28.enum(["table", "column", "measure", "metric", "join", "entity", "glossary", "saved_query", "instruction", "access_rule"]);
 var changeInputs = {
   source: source.optional(),
-  yaml_patch: z27.string().min(1).max(2e6).optional().describe("YAML mapping merged into the pulled model. Named lists merge by name. Other lists replace. Null removes a field. An empty list clears it."),
-  change: z27.object({
-    operation: z27.enum(["upsert", "remove"]),
+  yaml_patch: z28.string().min(1).max(2e6).optional().describe("YAML mapping merged into the pulled model. Named lists merge by name. Other lists replace. Null removes a field. An empty list clears it."),
+  change: z28.object({
+    operation: z28.enum(["upsert", "remove"]),
     kind: entityKind,
-    name: z27.string().trim().min(1),
-    table: z27.string().trim().min(1).optional().describe("Required for columns. Use the table name and an unqualified column name."),
-    value: z27.record(z27.unknown()).optional().describe("Fields to merge for upsert. Omit for remove.")
+    name: z28.string().trim().min(1),
+    table: z28.string().trim().min(1).optional().describe("Required for columns. Use the table name and an unqualified column name."),
+    value: z28.record(z28.unknown()).optional().describe("Fields to merge for upsert. Omit for remove.")
   }).strict().optional().describe("One named entity change. Supply exactly one of source, yaml_patch or change.")
 };
-var expectedHash = z27.string().trim().min(1).nullable().optional().describe("Stored content_hash from the reviewed proposal. Null explicitly means the first apply. Required when dry_run is false.");
+var expectedHash = z28.string().trim().min(1).nullable().optional().describe("Stored content_hash from the reviewed proposal. Null explicitly means the first apply. Required when dry_run is false.");
 function errorCode(error) {
   const nested = isObject(error.details) && isObject(error.details.error) ? error.details.error : void 0;
   return typeof nested?.code === "string" ? nested.code : error.code;
@@ -5640,15 +5696,24 @@ async function candidate(api, id2, input) {
 async function proposal(api, id2, input) {
   const next = await candidate(api, id2, input);
   const validation = await api.validate(id2, next.source);
-  const plan = validation.ok ? await api.plan(id2, next.source, next.expected_content_hash) : null;
-  return { ...next, validation, errors: validation.errors, plan, dry_run: true };
+  let plan = null;
+  let plan_note;
+  if (validation.ok) {
+    try {
+      plan = await api.plan(id2, next.source, next.expected_content_hash);
+    } catch (error) {
+      if (!(error instanceof DatabrainApiError && [404, 405, 501].includes(error.status))) throw error;
+      plan_note = "This Databrain API has no plan step. The validation above is the server check; apply runs it again.";
+    }
+  }
+  return { ...next, validation, errors: validation.errors, plan, ...plan_note ? { plan_note } : {}, dry_run: true };
 }
 function registerSearchSemanticModel(server, client) {
   const api = createServiceBundle(client).semanticModelApi;
   server.tool(
     "search_semantic_model",
     "Find semantic model entities relevant to a question. Ranks names, aliases, synonyms and descriptions, then includes related entities. Uses the stored model and never writes.",
-    { datamartId, question: z27.string().trim().min(1).max(1e4), k: z27.number().int().min(1).max(100).default(10) },
+    { datamartId, question: z28.string().trim().min(1).max(1e4), k: z28.number().int().min(1).max(100).default(10) },
     READ_ONLY,
     async ({ datamartId: datamartId2, question, k }) => {
       try {
@@ -5671,7 +5736,7 @@ function registerGetSemanticEntity(server, client) {
   server.tool(
     "get_semantic_entity",
     "Read one entity by kind and exact name from the stored semantic model. For a column, use table.column. Returns the stored content hash for change review.",
-    { datamartId, kind: entityKind, name: z27.string().trim().min(1) },
+    { datamartId, kind: entityKind, name: z28.string().trim().min(1) },
     READ_ONLY,
     async ({ datamartId: datamartId2, kind, name }) => {
       try {
@@ -5709,9 +5774,9 @@ function registerApplySemanticChange(server, client) {
     {
       datamartId,
       ...changeInputs,
-      dry_run: z27.boolean().default(true),
+      dry_run: z28.boolean().default(true),
       expected_content_hash: expectedHash,
-      confirm: z27.string().optional().describe("User supplied APPLY_TO_PRODUCTION after reviewing the plan. Never invent confirmation.")
+      confirm: z28.string().optional().describe("User supplied APPLY_TO_PRODUCTION after reviewing the plan. Never invent confirmation.")
     },
     DESTRUCTIVE,
     async (params) => {
@@ -5735,12 +5800,12 @@ function registerEvalSemanticModel(server, client) {
   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: z27.array(z27.union([z27.string().trim().min(1), z27.object({
-      name: z27.string().optional(),
-      question: z27.string().min(1),
-      sql: z27.string().optional(),
-      expected_columns: z27.array(z27.string()).optional(),
-      expected_empty: z27.boolean().optional()
+    { datamartId, source: source.optional(), questions: z28.array(z28.union([z28.string().trim().min(1), z28.object({
+      name: z28.string().optional(),
+      question: z28.string().min(1),
+      sql: z28.string().optional(),
+      expected_columns: z28.array(z28.string()).optional(),
+      expected_empty: z28.boolean().optional()
     }).strict()])).max(100).optional() },
     READ_ONLY,
     async ({ datamartId: datamartId2, source: source2, questions }) => {
@@ -5753,33 +5818,17 @@ function registerEvalSemanticModel(server, client) {
     }
   );
 }
-function registerSemanticReadiness(server, client) {
-  const api = createServiceBundle(client).semanticModelApi;
-  server.tool(
-    "semantic_readiness",
-    "Read the semantic readiness number, verdict and open checks for a stored model. Uses the server result without changing the model.",
-    { datamartId },
-    READ_ONLY,
-    async ({ datamartId: datamartId2 }) => {
-      try {
-        return toolSuccess(stringify(await api.readiness(datamartId2)));
-      } catch (error) {
-        return failure(error);
-      }
-    }
-  );
-}
 
 // src/tools/query/update-semantic-layer.ts
-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(
+import { z as z29 } from "zod";
+var columnSchema2 = z29.object({
+  name: z29.string().describe("Column name (must exist in the datamart)"),
+  description: z29.string().optional().describe("Business-friendly description of what this column represents"),
+  synonyms: z29.array(z29.string()).optional().describe(
     'Alternative names users might use for this column (e.g. ["revenue", "sales amount"])'
   ),
-  miscellaneousInfo: z28.string().optional().describe("Additional context such as valid values, units, or caveats"),
-  columnType: z28.enum([
+  miscellaneousInfo: z29.string().optional().describe("Additional context such as valid values, units, or caveats"),
+  columnType: z29.enum([
     "String",
     "Long String",
     "String (Custom)",
@@ -5794,21 +5843,21 @@ var columnSchema2 = z28.object({
   // The public PUT accepts these three as well (docs: Update Semantic Layer).
   // They were missing here, and zod strips unknown keys, so a caller who set
   // `isIdentifier: true` got a success message and a row with `false`.
-  columnTypeConfig: z28.union([z28.record(z28.string(), z28.string()), z28.string(), z28.object({ lowerLimit: z28.number(), upperLimit: z28.number() }), z28.null()]).optional().describe("Shape depends on columnType: value-to-description object for String / String (Custom) / ENUM / Mapper, { lowerLimit, upperLimit } for Range, a string for Expression and JSON. Omit for Identifier, Number and Long String."),
-  isIdentifier: z28.boolean().optional().describe("Mark the column as an identifier (primary or foreign key)."),
-  isNotIndexed: z28.boolean().optional().describe("Exclude the column from AI indexing.")
+  columnTypeConfig: z29.union([z29.record(z29.string(), z29.string()), z29.string(), z29.object({ lowerLimit: z29.number(), upperLimit: z29.number() }), z29.null()]).optional().describe("Shape depends on columnType: value-to-description object for String / String (Custom) / ENUM / Mapper, { lowerLimit, upperLimit } for Range, a string for Expression and JSON. Omit for Identifier, Number and Long String."),
+  isIdentifier: z29.boolean().optional().describe("Mark the column as an identifier (primary or foreign key)."),
+  isNotIndexed: z29.boolean().optional().describe("Exclude the column from AI indexing.")
 });
-var tableSchema2 = z28.object({
-  name: z28.string().describe("Table name (must exist in the datamart)"),
-  schemaName: z28.string().optional().describe("Schema the table lives in, when the datamart has the same table name in more than one schema."),
-  description: z28.string().optional().describe(
+var tableSchema2 = z29.object({
+  name: z29.string().describe("Table name (must exist in the datamart)"),
+  schemaName: z29.string().optional().describe("Schema the table lives in, when the datamart has the same table name in more than one schema."),
+  description: z29.string().optional().describe(
     "Business-friendly description of what this table represents"
   ),
-  synonyms: z28.array(z28.string()).optional().describe("Alternative names for this table"),
-  miscellaneousInfo: z28.string().optional().describe(
+  synonyms: z29.array(z29.string()).optional().describe("Alternative names for this table"),
+  miscellaneousInfo: z29.string().optional().describe(
     "Additional context such as how the table relates to other tables"
   ),
-  columns: z28.array(columnSchema2).optional().describe("Column-level semantic definitions to update")
+  columns: z29.array(columnSchema2).optional().describe("Column-level semantic definitions to update")
 });
 function columnKey(tableName, columnName) {
   return `${tableName.toLowerCase()}\0${columnName.toLowerCase()}`;
@@ -5885,13 +5934,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: z28.string().optional().describe(
+      datamartName: z29.string().optional().describe(
         "Name of the datamart to update. Omit to list available datamarts."
       ),
-      tables: z28.array(tableSchema2).optional().describe(
+      tables: z29.array(tableSchema2).optional().describe(
         "Table and column definitions to update. Only include tables/columns you want to change."
       ),
-      feedback: z28.string().optional().describe(
+      feedback: z29.string().optional().describe(
         'General feedback or context about the datamart (e.g. "This datamart contains e-commerce data for the US market").'
       )
     },
@@ -5953,7 +6002,7 @@ You can now:
 }
 
 // src/tools/query/semantic-generation.ts
-import { z as z29 } from "zod";
+import { z as z30 } from "zod";
 function nonEmptyString(value) {
   return typeof value === "string" && value.trim().length > 0 ? value : null;
 }
@@ -6059,9 +6108,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: 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.")
+      datamartName: z30.string().optional().describe("Datamart name. Omit to list available datamarts"),
+      workspaceName: z30.string().optional().describe("Workspace linked to the datamart. Use when datamartName resolution needs a dataMartId bridge."),
+      datamartId: z30.string().optional().describe("Datamart UUID. Use only when already known.")
     },
     WRITE_CREATE,
     async (params) => {
@@ -6103,9 +6152,9 @@ function registerGetSemanticLayerGenerationStatus(server, client) {
     "get_semantic_layer_generation_status",
     "Get semantic-layer auto-generation job status for a datamart.",
     {
-      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.")
+      datamartName: z30.string().optional().describe("Datamart name. Omit to list available datamarts"),
+      workspaceName: z30.string().optional().describe("Workspace linked to the datamart. Use when datamartName resolution needs a dataMartId bridge."),
+      datamartId: z30.string().optional().describe("Datamart UUID. Use only when already known.")
     },
     READ_ONLY,
     async (params) => {
@@ -6142,7 +6191,7 @@ function registerGetSemanticLayerGenerationStatus(server, client) {
 }
 
 // src/tools/widgets/list-widgets.ts
-import { z as z30 } from "zod";
+import { z as z31 } from "zod";
 function widgetReferenceId(widget) {
   for (const candidate2 of [widget.externalMetricId, widget.id, widget._id, widget.metricId]) {
     if (typeof candidate2 === "string" && candidate2.trim().length > 0) return candidate2.trim();
@@ -6155,10 +6204,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: 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.")
+      clientId: z31.string().describe("Client/tenant identifier for this dashboard"),
+      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.")
     },
     READ_ONLY,
     async (params) => {
@@ -6222,29 +6271,29 @@ function registerListWidgets(server, client) {
 }
 
 // src/tools/widgets/add-widget.ts
-import { z as z31 } from "zod";
+import { z as z32 } 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: 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.")
+      clientId: z32.string().describe("Client/tenant identifier (widget is created in their scope)"),
+      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 embed; non-technical callers should leave this blank."),
+      templateMetricId: z32.string().optional().describe("Source widget metricId to clone from. Copies query, chartOptions, and datasource fields; caller can override via other params."),
+      name: z32.string().optional().describe("Widget name (overrides template)"),
+      metricId: z32.string().optional().describe("Unique slug for the new widget (auto-generated if omitted)"),
+      query: z32.string().optional().describe("SQL query body (overrides template)"),
+      chartOptions: z32.record(z32.unknown()).optional().describe("Chart config JSON (chart type, colors, legend, axes). Overrides template."),
+      description: z32.string().optional(),
+      companyIntegrationId: z32.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: z32.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: z32.boolean().optional().describe("Publish immediately (default true)"),
+      body: z32.record(z32.unknown()).optional().describe("Raw createMetric body passthrough. If provided, used as-is (after defaults). Overrides all other params."),
+      widgets: z32.array(z32.record(z32.unknown())).min(1).max(50).optional().describe("Batch of raw createMetric bodies. Dashboard attachment is added to each body.")
     },
     WRITE_CREATE,
     async (params) => {
@@ -6392,20 +6441,20 @@ Use \`list_widgets\` to verify, or \`update_widget\`/\`remove_widget\` to adjust
 }
 
 // src/tools/widgets/update-widget.ts
-import { z as z32 } from "zod";
+import { z as z33 } 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: 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.")
+      externalMetricId: z33.string().describe("Internal uuid of the widget (externalMetrics.id). Not the user-facing metricId slug."),
+      clientId: z33.string().describe("Client/tenant identifier"),
+      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."),
+      set: z33.record(z33.unknown()).describe("Partial patch. Keys can include: name, query, chartOptions, description, isPublished, isLive, selectedGroupBy, drillDownSettings, limit, etc.")
     },
     WRITE_IDEMPOTENT,
     async (params) => {
@@ -6468,19 +6517,19 @@ Use \`list_widgets\` to verify.`
 }
 
 // src/tools/widgets/remove-widget.ts
-import { z as z33 } from "zod";
+import { z as z34 } 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: 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.")
+      externalMetricId: z34.string().describe("Internal uuid of the widget (externalMetrics.id)"),
+      clientId: z34.string().describe("Client/tenant identifier \u2014 the widget will be hidden for this client only"),
+      dashboardName: z34.string().optional().describe("Dashboard name (non-technical). Preferred input \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 dashboard; non-technical callers should leave this blank.")
     },
     DESTRUCTIVE,
     async (params) => {
@@ -6536,21 +6585,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 z34 } from "zod";
+import { z as z35 } 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: 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.")
+      clientId: z35.string().describe("Client/tenant identifier"),
+      userInputs: z35.record(z35.unknown()).describe('Prompt + context object. Typical shape: { prompt: "calls per day over last 30 days", schema: {...}, examples: [...] }. Backend decides which keys it honors.'),
+      dashboardName: z35.string().optional().describe("Dashboard name (non-technical). Preferred input for CS/CX flows \u2014 pass this with optional `workspaceName` instead of `embedId`."),
+      workspaceName: z35.string().optional().describe("Workspace name (non-technical). Only needed if `dashboardName` is ambiguous across workspaces."),
+      embedId: z35.string().optional().describe("Technical alternative to `dashboardName`. Pass only if you already have the embed identifier."),
+      dataAppName: z35.string().optional().describe("Technical override. Auto-resolved from the embed; non-technical callers should leave this blank."),
+      integrationId: z35.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: z35.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) => {
@@ -6635,9 +6684,9 @@ function registerGenerateWidget(server, client) {
 }
 
 // src/tools/widgets/create-or-update-metric-from-query.ts
-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");
+import { z as z36 } from "zod";
+var modeSchema = z36.enum(["dry_run", "apply"]).default("dry_run");
+var conflictStrategySchema = z36.enum(["fail", "update", "create_new"]).default("fail");
 function makePlanText(plan) {
   return JSON.stringify(plan, null, 2);
 }
@@ -6654,22 +6703,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: z35.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
+      confirm: z36.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: 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")
+      clientId: z36.string().describe("Client/tenant identifier for the dashboard widget scope"),
+      workspaceName: z36.string().describe("Target 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"),
+      isPublished: z36.boolean().optional().describe("Publish after apply. Defaults to false for production safety"),
+      requestedBy: z36.string().optional().describe("Human operator/request context to store on the metric when supported")
     },
     WRITE_IDEMPOTENT,
     async (params) => {
@@ -6829,8 +6878,8 @@ function registerCreateOrUpdateMetricFromQuery(server, client) {
 }
 
 // src/tools/widgets/create-workspace-metric.ts
-import { z as z36 } from "zod";
-var modeSchema2 = z36.enum(["dry_run", "apply"]).default("dry_run");
+import { z as z37 } from "zod";
+var modeSchema2 = z37.enum(["dry_run", "apply"]).default("dry_run");
 function registerCreateWorkspaceMetric(server, client) {
   server.tool(
     "create_workspace_metric",
@@ -6839,18 +6888,18 @@ function registerCreateWorkspaceMetric(server, client) {
       mode: modeSchema2.describe(
         "dry_run validates the SQL only (no write); apply creates or updates the metric after confirmation"
       ),
-      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(
+      confirm: z37.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
+      workspaceName: z37.string().describe("Target workspace name"),
+      name: z37.string().describe("Metric display name"),
+      query: z37.string().describe(
         "SQL query to validate and store. In a TABLE-tenancy workspace never compare the client column to a fixed client value; use `client_id_variable` so each client sees only its own rows (the backend refuses it with TENANT_KEY_LITERAL)."
       ),
-      metricId: z36.string().optional().describe(
+      metricId: z37.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: z36.string().optional().describe("Metric description"),
-      datasourceId: z36.string().optional().describe("Datasource UUID override; defaults to the workspace datasource"),
-      isPublished: z36.boolean().optional().describe(
+      description: z37.string().optional().describe("Metric description"),
+      datasourceId: z37.string().optional().describe("Datasource UUID override; defaults to the workspace datasource"),
+      isPublished: z37.boolean().optional().describe(
         "Publish after apply. Defaults to false. Applies to creates; on updates the existing publish state is preserved."
       )
     },
@@ -6906,25 +6955,25 @@ function registerCreateWorkspaceMetric(server, client) {
 }
 
 // src/tools/widgets/validate-metric-spec.ts
-import { z as z37 } from "zod";
+import { z as z38 } 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: 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")
+      clientId: z38.string().describe("Client/tenant identifier used to validate dashboard widget scope"),
+      workspaceName: z38.string().describe("Target production-backed workspace name"),
+      dashboardName: z38.string().optional().describe("Dashboard name to attach to"),
+      embedId: z38.string().optional().describe("Technical embed id alternative to dashboardName"),
+      dataAppName: z38.string().optional().describe("Optional data app override"),
+      name: z38.string().describe("Metric/widget display name"),
+      metricId: z38.string().describe("Stable metric slug to create or update"),
+      query: z38.string().describe("SQL query already validated against the warehouse"),
+      description: z38.string().optional().describe("Metric description"),
+      chartOptions: z38.record(z38.unknown()).optional().describe("Chart configuration JSON"),
+      companyIntegrationId: z38.string().optional().describe("Datasource UUID override"),
+      integrationName: z38.string().optional().describe("Datasource display name override")
     },
     READ_ONLY,
     async (params) => {
@@ -7015,20 +7064,20 @@ function registerValidateMetricSpec(server, client) {
 }
 
 // src/tools/reports/list-scheduled-reports.ts
-import { z as z38 } from "zod";
+import { z as z39 } 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: 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")
+      clientId: z39.string().describe("Client/tenant identifier. Required by the current backend API for non-empty results"),
+      dashboardName: z39.string().optional().describe("Dashboard name to inspect"),
+      workspaceName: z39.string().optional().describe("Workspace name if dashboardName is ambiguous"),
+      embedId: z39.string().optional().describe("Technical embed id alternative to dashboardName"),
+      userIdentifier: z39.string().optional().describe("Optional creator/user filter"),
+      pageNumber: z39.number().int().positive().optional().describe("Page number when pagination is enabled"),
+      isPagination: z39.boolean().optional().describe("Enable backend pagination")
     },
     READ_ONLY,
     async (params) => {
@@ -7102,7 +7151,7 @@ function registerWhoami(server, client) {
               status: "authenticated",
               activeBearer: "service-token",
               ...auth.oauthFallback ? { oauthFallback: true } : {},
-              note: auth.oauthFallback ? "OAuth token acquisition failed; the configured static service token is in use. Mutations use the static org-level principal, with actor=system. OAuth will be retried after a short cooldown." : "Org-level service token (DATABRAIN_SERVICE_TOKEN). Per-user identity is NOT bound \u2014 mutations are audit-logged as actor=system. Per-user binding will be available once the OAuth login flow ships."
+              note: auth.oauthFallback ? "OAuth token acquisition failed; the configured static service token is in use. Mutations use the static org-level principal, with actor=system. OAuth will be retried after a short cooldown." : "Org-level service token (DATABRAIN_SERVICE_TOKEN). Per-user identity is NOT bound \u2014 mutations are audit-logged as actor=system. For per-user access, connect an AI app to the hosted server (it signs in with your Databrain account)."
             },
             null,
             2
@@ -7138,19 +7187,19 @@ function registerWhoami(server, client) {
 }
 
 // src/tools/custom-chart/scaffold.ts
-import { z as z40 } from "zod";
+import { z as z41 } from "zod";
 
 // src/tools/custom-chart/shared.ts
-import { z as z39 } from "zod";
+import { z as z40 } from "zod";
 var slotInputSchema = slotSchema;
 var optionInputSchema = optionSchema;
-var manifestInputSchema = z39.record(z39.unknown()).describe("manifest.json as an object (schemaVersion 2). Validated with the same rules as the server.");
+var manifestInputSchema = z40.record(z40.unknown()).describe("manifest.json as an object (schemaVersion 2). Validated with the same rules as the server.");
 var bundleInputShape = {
   manifest: manifestInputSchema.optional(),
-  bundleJs: z39.string().optional().describe("dist/index.js from `databrain custom-chart build` (the shim plus the chart module)."),
-  bundleCss: z39.string().optional().describe("The raw chart.css, kept for provenance."),
-  iconSvg: z39.string().optional().describe("icon.svg, at most 16 KiB, no script, no foreignObject, no external href."),
-  projectDir: z39.string().optional().describe("Local only: a chart project folder. The tool reads it instead of manifest/bundleJs/iconSvg.")
+  bundleJs: z40.string().optional().describe("dist/index.js from `databrain custom-chart build` (the shim plus the chart module)."),
+  bundleCss: z40.string().optional().describe("The raw chart.css, kept for provenance."),
+  iconSvg: z40.string().optional().describe("icon.svg, at most 16 KiB, no script, no foreignObject, no external href."),
+  projectDir: z40.string().optional().describe("Local only: a chart project folder. The tool reads it instead of manifest/bundleJs/iconSvg.")
 };
 function formatProblems(problems) {
   if (problems.length === 0) return "No problems.";
@@ -7217,11 +7266,11 @@ function registerCustomChartScaffold(server, _client) {
     "custom_chart_scaffold",
     "Return the files of a new custom chart project (manifest.json, chart.ts, chart.css, icon.svg, sample data, guide). Nothing is written or persisted; write the files yourself.",
     {
-      key: z40.string().describe("Chart key, becomes chart type custom:<key>. Lowercase letters, digits, _ and -, 64 max."),
-      name: z40.string().describe("Display name shown in the chart picker, 1 to 256 characters."),
-      description: z40.string().optional().describe("Optional description, up to 500 characters."),
-      slots: z40.array(slotInputSchema).optional().describe("Data slots. Defaults to category (dimension), value (measure), target (optional measure)."),
-      options: z40.array(optionInputSchema).optional().describe("Chart options. Defaults to the template options (labels, subtitle, radius, colour, sort).")
+      key: z41.string().describe("Chart key, becomes chart type custom:<key>. Lowercase letters, digits, _ and -, 64 max."),
+      name: z41.string().describe("Display name shown in the chart picker, 1 to 256 characters."),
+      description: z41.string().optional().describe("Optional description, up to 500 characters."),
+      slots: z41.array(slotInputSchema).optional().describe("Data slots. Defaults to category (dimension), value (measure), target (optional measure)."),
+      options: z41.array(optionInputSchema).optional().describe("Chart options. Defaults to the template options (labels, subtitle, radius, colour, sort).")
     },
     READ_ONLY,
     async (params) => {
@@ -7313,18 +7362,18 @@ function registerCustomChartValidate(server, client) {
 }
 
 // src/tools/custom-chart/upload.ts
-import { z as z41 } from "zod";
+import { z as z42 } from "zod";
 function registerCustomChartUpload(server, client) {
   const api = createCustomChartsApi(client);
   server.tool(
     "custom_chart_upload",
     "Upload a built custom chart bundle to the company. Creates the chart (private, version 1) or a new preview version. Defaults to dry_run; apply requires explicit confirmation and can publish in the same call.",
     {
-      mode: z41.enum(["dry_run", "apply"]).default("dry_run").describe("dry_run validates and returns the plan; apply uploads."),
-      confirm: z41.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
-      publish: z41.boolean().default(false).describe("After a successful apply, publish the uploaded version so every builder can use it."),
-      name: z41.string().optional().describe("Display name override. Defaults to manifest.name."),
-      description: z41.string().optional().describe("Description override. Defaults to manifest.description."),
+      mode: z42.enum(["dry_run", "apply"]).default("dry_run").describe("dry_run validates and returns the plan; apply uploads."),
+      confirm: z42.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
+      publish: z42.boolean().default(false).describe("After a successful apply, publish the uploaded version so every builder can use it."),
+      name: z42.string().optional().describe("Display name override. Defaults to manifest.name."),
+      description: z42.string().optional().describe("Description override. Defaults to manifest.description."),
       ...bundleInputShape
     },
     WRITE_CREATE,
@@ -7465,17 +7514,17 @@ function registerListCustomCharts(server, client) {
 }
 
 // src/tools/custom-chart/publish.ts
-import { z as z42 } from "zod";
+import { z as z43 } from "zod";
 function registerPublishCustomChart(server, client) {
   const api = createCustomChartsApi(client);
   server.tool(
     "publish_custom_chart",
     "Publish a custom chart version so every builder in the company can use chart type custom:<key>. Defaults to the preview version. Defaults to dry_run; apply requires explicit confirmation.",
     {
-      key: z42.string().describe("The chart key (manifest.id), for example revenue-bars."),
-      versionId: z42.string().optional().describe("A specific version id to publish. Defaults to the preview version."),
-      mode: z42.enum(["dry_run", "apply"]).default("dry_run").describe("dry_run shows what would be published; apply publishes."),
-      confirm: z42.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`)
+      key: z43.string().describe("The chart key (manifest.id), for example revenue-bars."),
+      versionId: z43.string().optional().describe("A specific version id to publish. Defaults to the preview version."),
+      mode: z43.enum(["dry_run", "apply"]).default("dry_run").describe("dry_run shows what would be published; apply publishes."),
+      confirm: z43.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`)
     },
     WRITE_IDEMPOTENT,
     async (params) => {
@@ -7531,6 +7580,66 @@ function registerPublishCustomChart(server, client) {
   );
 }
 
+// src/tools/tool-titles.ts
+var TOOL_TITLES = {
+  whoami: "Show active credential",
+  list_datasources: "List data sources",
+  discover_datasource_schema: "Discover data source schema",
+  list_datamarts: "List datamarts",
+  list_workspaces: "List workspaces",
+  sync_datasource: "Sync data source",
+  create_datamart: "Create datamart",
+  create_workspace: "Create workspace",
+  list_data_apps: "List data apps",
+  list_tenants: "List tenants",
+  create_data_app: "Create data app",
+  list_api_tokens: "List API tokens",
+  create_api_token: "Create API token",
+  rotate_api_token: "Rotate API token",
+  create_embed: "Create embed",
+  list_embeds: "List embeds",
+  get_embed_details: "Get embed details",
+  update_embed: "Update embed",
+  customize_embed_theme: "Customize embed theme",
+  get_demo_link: "Get demo link",
+  generate_guest_token: "Generate guest token",
+  generate_embed_code: "Generate embed code",
+  list_dashboards: "List dashboards",
+  create_dashboard: "Create dashboard",
+  get_dashboard: "Get dashboard",
+  dashboard_snapshot: "Dashboard snapshot (picture)",
+  generate_dashboard_tiles: "Generate dashboard tiles",
+  ask_question: "Ask a data question",
+  get_semantic_layer: "Get semantic layer",
+  update_semantic_layer: "Update semantic layer",
+  start_semantic_layer_generation: "Start semantic layer generation",
+  get_semantic_layer_generation_status: "Get semantic layer generation status",
+  search_semantic_model: "Search semantic model",
+  get_semantic_entity: "Get semantic entity",
+  propose_semantic_change: "Propose semantic model change",
+  apply_semantic_change: "Apply semantic model change",
+  eval_semantic_model: "Evaluate semantic model",
+  list_widgets: "List widgets",
+  validate_metric_spec: "Validate metric spec",
+  create_or_update_metric_from_query: "Create or update metric from SQL",
+  create_workspace_metric: "Create workspace metric",
+  add_widget: "Add widget",
+  update_widget: "Update widget",
+  remove_widget: "Remove widget",
+  generate_widget: "Generate widget",
+  list_scheduled_reports: "List scheduled reports",
+  custom_chart_scaffold: "Scaffold custom chart",
+  custom_chart_validate: "Validate custom chart",
+  custom_chart_upload: "Upload custom chart",
+  list_custom_charts: "List custom charts",
+  publish_custom_chart: "Publish custom chart"
+};
+function toolTitle(name) {
+  if (TOOL_TITLES[name]) return TOOL_TITLES[name];
+  const words = name.split("_").filter(Boolean);
+  return words.map((word, index) => index === 0 ? word[0].toUpperCase() + word.slice(1) : word).join(" ");
+}
+
 // src/tools/registry.ts
 function instrumentToolRegistration(server) {
   const original = server.tool.bind(server);
@@ -7551,7 +7660,15 @@ function instrumentToolRegistration(server) {
         () => handler(...handlerArgs)
       );
     }
-    return original(...args);
+    const title = toolTitle(name);
+    const annotationIndex = cbIndex - 1;
+    const annotations = args[annotationIndex];
+    if (annotationIndex > 1 && annotations && typeof annotations === "object" && ("readOnlyHint" in annotations || "destructiveHint" in annotations) && !("title" in annotations)) {
+      args[annotationIndex] = { title, ...annotations };
+    }
+    const registered = original(...args);
+    if (registered && typeof registered === "object" && !registered.title) registered.title = title;
+    return registered;
   };
 }
 function registerAllTools(server, client) {
@@ -7580,6 +7697,7 @@ function registerAllTools(server, client) {
   registerListDashboards(server, client);
   registerCreateDashboard(server, client);
   registerGetDashboard(server, client);
+  registerDashboardSnapshot(server, client);
   registerGenerateDashboardTiles(server, client);
   registerAskQuestion(server, client);
   registerGetSemanticLayer(server, client);
@@ -7591,7 +7709,6 @@ function registerAllTools(server, client) {
   registerProposeSemanticChange(server, client);
   registerApplySemanticChange(server, client);
   registerEvalSemanticModel(server, client);
-  registerSemanticReadiness(server, client);
   registerListWidgets(server, client);
   registerValidateMetricSpec(server, client);
   registerCreateOrUpdateMetricFromQuery(server, client);
@@ -9493,7 +9610,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. \`semantic_readiness\` returns the server score, verdict and open checks.
+3. \`eval_semantic_model\` evaluates the proposed source.
 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.
@@ -10487,7 +10604,7 @@ If **no datamarts exist**, tell the user they need to create one in the **Databr
 If **no datasources exist either**, the user must first connect their database in the **Databrain UI**.
 
 **For a v2 semantic model**
-If the datamart uses v2, inspect the question's entities with \`search_semantic_model\` and \`get_semantic_entity\`. Read \`semantic_readiness\` for open checks, then continue to Step 2. If metadata needs correction, use \`propose_semantic_change\`, evaluate its source with \`eval_semantic_model\`, and show the plan. Only apply the reviewed source and expected hash through \`apply_semantic_change\` after the user supplies \`APPLY_TO_PRODUCTION\`. Never use the legacy \`update_semantic_layer\` steps below for v2.
+If the datamart uses v2, inspect the question's entities with \`search_semantic_model\` and \`get_semantic_entity\`. Then continue to Step 2. If metadata needs correction, use \`propose_semantic_change\`, evaluate its source with \`eval_semantic_model\`, and show the plan. Only apply the reviewed source and expected hash through \`apply_semantic_change\` after the user supplies \`APPLY_TO_PRODUCTION\`. Never use the legacy \`update_semantic_layer\` steps below for v2.
 
 **Step 1b \u2014 Verify the Semantic Layer**
 After confirming a datamart exists, use \`get_semantic_layer\` to check its tables. The semantic layer is built on the **datamart** (not the raw datasource) \u2014 do NOT use \`discover_datasource_schema\` to populate it.
@@ -10577,7 +10694,7 @@ If \`list_datamarts\` reports \`semanticLayerVersion: "v2"\`, or the selected da
 3. Call \`eval_semantic_model\` with the returned source. 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 \`semantic_readiness\` and inspect the changed entity. Do not call \`update_semantic_layer\` for a v2 model.
+6. Call \`get_semantic_entity\` and inspect the changed entity. Do not call \`update_semantic_layer\` for a v2 model.
 
 **Why this matters:** Without a populated semantic layer, \`ask_question\` cannot generate SQL \u2014 every query will fail with "out of context." Populating the semantic layer is the critical step between having a datamart and being able to query it.
 
@@ -10955,6 +11072,7 @@ export {
   enableChartApps,
   chartResult,
   draftSchema,
+  PREVIEW_PATH,
   RENDER_TYPES,
   draftPage,
   workspacesForDatamart,
@@ -10963,4 +11081,4 @@ export {
   registerAllResources,
   registerAllPrompts
 };
-//# sourceMappingURL=chunk-JSYG7ULR.js.map
+//# sourceMappingURL=chunk-VK6XPPBT.js.map