@databrainhq/mcp-server 0.3.0-rc.3 → 0.3.0-rc.5

package/dist/{chunk-DZOYK5BB.js → chunk-5IQ7MVUH.js}

@@ -1,620 +1,68 @@
 #!/usr/bin/env node
-
-// src/utils/logger.ts
-var LOG_LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
-var currentLevel = process.env.DATABRAIN_LOG_LEVEL || "warn";
-function log(level, message, data) {
-  if (LOG_LEVELS[level] < LOG_LEVELS[currentLevel]) return;
-  const line = `[databrain-mcp] [${level.toUpperCase()}] ${message}`;
-  if (data !== void 0) {
-    process.stderr.write(`${line} ${JSON.stringify(data)}
-`);
-  } else {
-    process.stderr.write(`${line}
-`);
-  }
-}
-var logger = {
-  debug: (msg, data) => log("debug", msg, data),
-  info: (msg, data) => log("info", msg, data),
-  warn: (msg, data) => log("warn", msg, data),
-  error: (msg, data) => log("error", msg, data)
-};
-
-// package.json
-var package_default = {
-  name: "@databrainhq/mcp-server",
-  version: "0.3.0-rc.3",
-  description: "MCP server for Databrain embedded analytics - connect databases, create datamarts, configure embeds, and generate frontend code",
-  type: "module",
-  bin: {
-    "mcp-server": "dist/index.js",
-    "databrain-mcp-server": "dist/index.js",
-    "databrain-mcp-chart-apps": "dist/apps/stdio.js"
-  },
-  main: "dist/index.js",
-  types: "dist/index.d.ts",
-  files: [
-    "dist",
-    "skills",
-    ".claude-plugin",
-    ".mcp.json"
-  ],
-  scripts: {
-    build: "tsup",
-    dev: "tsx src/index.ts",
-    test: "vitest run",
-    "test:watch": "vitest",
-    "test:live": "vitest run tests/integration/prompt-flows.test.ts",
-    lint: "tsc --noEmit",
-    prepublishOnly: "npm run build"
-  },
-  keywords: [
-    "mcp",
-    "databrain",
-    "embedded-analytics",
-    "ai",
-    "model-context-protocol"
-  ],
-  license: "MIT",
-  dependencies: {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "@posthog/mcp": "^0.10.7",
-    "posthog-node": "^5.21.2",
-    zod: "^3.24.0"
-  },
-  devDependencies: {
-    "@types/node": "^25.3.5",
-    tsup: "^8.4.0",
-    tsx: "^4.19.0",
-    typescript: "^5.7.0",
-    vitest: "^3.0.0"
-  },
-  publishConfig: {
-    access: "public"
-  },
-  repository: {
-    type: "git",
-    url: "git+https://github.com/databrainhq/mcp-server.git"
-  },
-  engines: {
-    node: ">=18.0.0"
-  }
-};
-
-// src/version.ts
-var MCP_SERVER_VERSION = package_default.version;
-
-// src/utils/cache.ts
-var TtlCache = class {
-  store = /* @__PURE__ */ new Map();
-  get(key) {
-    const entry = this.store.get(key);
-    if (!entry) return void 0;
-    if (Date.now() > entry.expiresAt) {
-      this.store.delete(key);
-      return void 0;
-    }
-    return entry.value;
-  }
-  set(key, value, ttlMs) {
-    this.store.set(key, { value, expiresAt: Date.now() + ttlMs });
-  }
-  invalidateByPrefix(prefix) {
-    for (const key of this.store.keys()) {
-      if (key.startsWith(prefix)) {
-        this.store.delete(key);
-      }
-    }
-  }
-  clear() {
-    this.store.clear();
-  }
-};
-
-// src/utils/errors.ts
-var DatabrainApiError = class extends Error {
-  constructor(status, code, message, details) {
-    super(message);
-    this.status = status;
-    this.code = code;
-    this.details = details;
-    this.name = "DatabrainApiError";
-  }
-  toToolResponse() {
-    const parts = [`Error: ${this.message}`];
-    const detailDump = this.formatDetails();
-    if (detailDump) parts.push(detailDump);
-    const hint = this.hint();
-    if (hint) parts.push(hint);
-    return {
-      content: [{ type: "text", text: parts.join("\n\n") }],
-      isError: true
-    };
-  }
-  /**
-   * Surface API-returned details for 4xx errors so the LLM can recover or
-   * report the real reason (validation messages, field names, etc.). Skips
-   * fields already collapsed into `message`/`code`, and skips 5xx where the
-   * payload usually isn't actionable.
-   */
-  formatDetails() {
-    if (this.status < 400 || this.status >= 500) return "";
-    if (!this.details || typeof this.details !== "object") return "";
-    const skipKeys = /* @__PURE__ */ new Set(["message", "detail", "error", "code"]);
-    const extra = {};
-    for (const [k, v] of Object.entries(this.details)) {
-      if (skipKeys.has(k)) continue;
-      if (v === null || v === void 0) continue;
-      extra[k] = v;
-    }
-    if (Object.keys(extra).length === 0) return "";
-    try {
-      return `API details: ${JSON.stringify(extra)}`;
-    } catch {
-      return "";
-    }
-  }
-  hint() {
-    if (this.status === 401 || this.status === 403) {
-      if (this.code === "OAUTH_API_ERROR") {
-        return "Hint: Check that the backend accepts the configured OAuth issuer and resource, and that the service principal has permission for this operation. Static fallback applies only to token acquisition failures.";
-      }
-      if (this.code === "INVALID_SERVICE_TOKEN" || this.code === "MISSING_SERVICE_TOKEN" || this.message.toLowerCase().includes("service token")) {
-        return "Hint: The service token (DATABRAIN_SERVICE_TOKEN) is invalid, expired, or missing. It must be set in the MCP server config (not at runtime). Check Settings > Service Tokens in the Databrain UI.";
-      }
-      return "Hint: The per-data-app API token is invalid or expired. Use `create_api_token` to generate a new one. Do not ask the user \u2014 manage tokens via MCP tools.";
-    }
-    if (this.status === 400) {
-      return "Hint: The request was invalid. Check parameter values match expected types and formats. Use the corresponding list tool to verify IDs and names.";
-    }
-    if (this.status === 404) {
-      return "Hint: The requested resource was not found. Verify the ID or name is correct using the corresponding list tool.";
-    }
-    if (this.status === 409) {
-      return "Hint: A resource with this name already exists. Use a different name or list existing resources first.";
-    }
-    if (this.status === 422) {
-      return "Hint: The request parameters are invalid. Check the required fields and their formats.";
-    }
-    if (this.status === 429) {
-      return "Hint: API rate limit reached. Wait a moment and try again.";
-    }
-    if (this.status >= 500) {
-      return "Hint: The Databrain API is experiencing issues. Try again in a few moments.";
-    }
-    return "";
-  }
-};
-function toolError(message) {
-  return {
-    content: [{ type: "text", text: message }],
-    isError: true
-  };
-}
-function stringify(value) {
-  if (typeof value === "string") return value;
-  try {
-    return JSON.stringify(value, null, 2);
-  } catch {
-    return String(value);
-  }
-}
-function toolSuccess(text) {
-  return {
-    content: [{ type: "text", text }]
-  };
-}
-
-// src/utils/tool-context.ts
-import { AsyncLocalStorage } from "async_hooks";
-var toolContext = new AsyncLocalStorage();
-
-// src/client/oauth-client-credentials.ts
-import { z } from "zod";
-var oauthHttpsUrl = z.string().refine((value) => {
-  try {
-    const url = new URL(value);
-    return url.protocol === "https:" && !url.username && !url.password && !url.hash;
-  } catch {
-    return false;
-  }
-}, "OAuth URLs must use HTTPS without userinfo or fragments");
-var oauthConfigSchema = z.object({
-  issuer: oauthHttpsUrl.refine((value) => {
-    try {
-      return !new URL(value).search;
-    } catch {
-      return false;
-    }
-  }, "OAuth issuer must not contain a query"),
-  clientId: z.string().min(1),
-  clientSecret: z.string().min(1),
-  resource: oauthHttpsUrl,
-  scope: z.string().min(1).optional(),
-  authMethod: z.enum(["client_secret_basic", "client_secret_post"]).default("client_secret_basic")
-});
-var metadataSchema = z.object({
-  issuer: z.string(),
-  token_endpoint: oauthHttpsUrl,
-  token_endpoint_auth_methods_supported: z.array(z.string()).optional(),
-  grant_types_supported: z.array(z.string()).optional()
-});
-var tokenSchema = z.object({
-  access_token: z.string().regex(/^[A-Za-z0-9\-._~+/]+=*$/),
-  token_type: z.string().refine((value) => value.toLowerCase() === "bearer"),
-  expires_in: z.number().finite().positive().optional()
-});
-var TOKEN_TIMEOUT_MS = 1e4;
-var FAILURE_COOLDOWN_MS = 3e4;
-var MAX_REFRESH_SKEW_MS = 6e4;
-function authError() {
-  return new Error("OAuth token acquisition failed. Check the configured issuer, client credentials, resource and scopes.");
-}
-var OAuthClientCredentials = class {
-  config;
-  tokenEndpoint;
-  cached;
-  pending;
-  retryAt = 0;
-  constructor(config) {
-    const parsed = oauthConfigSchema.safeParse(config);
-    if (!parsed.success) throw authError();
-    this.config = Object.freeze(parsed.data);
-  }
-  getStatus() {
-    if (this.cached && Date.now() < this.cached.renewAt) return "ready";
-    if (this.retryAt > 0) return "unavailable";
-    return "configured";
-  }
-  async getToken() {
-    if (this.cached && Date.now() < this.cached.renewAt) return this.cached.value;
-    if (this.pending) return this.pending;
-    if (Date.now() < this.retryAt) throw authError();
-    this.cached = void 0;
-    this.pending = this.acquire().catch(() => {
-      this.retryAt = Date.now() + FAILURE_COOLDOWN_MS;
-      throw authError();
-    }).finally(() => {
-      this.pending = void 0;
-    });
-    return this.pending;
-  }
-  async discoverTokenEndpoint(signal) {
-    if (this.tokenEndpoint) return this.tokenEndpoint;
-    const issuer = new URL(this.config.issuer);
-    const path = issuer.pathname.replace(/\/$/, "");
-    const candidates = [.../* @__PURE__ */ new Set([
-      `${issuer.origin}/.well-known/oauth-authorization-server${path}`,
-      `${issuer.origin}/.well-known/openid-configuration${path}`,
-      `${issuer.origin}${path}/.well-known/openid-configuration`
-    ])];
-    for (const url of candidates) {
-      const response = await fetch(url, {
-        headers: { Accept: "application/json" },
-        redirect: "error",
-        signal
-      });
-      if (response.status === 404 || response.status === 405) continue;
-      if (!response.ok) throw authError();
-      const metadata = metadataSchema.parse(await response.json());
-      if (metadata.issuer !== this.config.issuer) throw authError();
-      const methods = metadata.token_endpoint_auth_methods_supported ?? ["client_secret_basic"];
-      if (!methods.includes(this.config.authMethod)) throw authError();
-      if (metadata.grant_types_supported && !metadata.grant_types_supported.includes("client_credentials")) {
-        throw authError();
-      }
-      this.tokenEndpoint = metadata.token_endpoint;
-      return this.tokenEndpoint;
-    }
-    throw authError();
-  }
-  async acquire() {
-    const signal = AbortSignal.timeout(TOKEN_TIMEOUT_MS);
-    const endpoint = await this.discoverTokenEndpoint(signal);
-    const body = new URLSearchParams({
-      grant_type: "client_credentials",
-      resource: this.config.resource
-    });
-    if (this.config.scope) body.set("scope", this.config.scope);
-    const headers = {
-      Accept: "application/json",
-      "Content-Type": "application/x-www-form-urlencoded"
-    };
-    if (this.config.authMethod === "client_secret_post") {
-      body.set("client_id", this.config.clientId);
-      body.set("client_secret", this.config.clientSecret);
-    } else {
-      const encode = (value) => new URLSearchParams({ value }).toString().slice(6);
-      headers.Authorization = `Basic ${Buffer.from(`${encode(this.config.clientId)}:${encode(this.config.clientSecret)}`).toString("base64")}`;
-    }
-    const startedAt = Date.now();
-    const response = await fetch(endpoint, {
-      method: "POST",
-      headers,
-      body: body.toString(),
-      redirect: "error",
-      signal
-    });
-    if (!response.ok) throw authError();
-    const token = tokenSchema.parse(await response.json());
-    if (token.expires_in !== void 0) {
-      const lifetimeMs = token.expires_in * 1e3;
-      const expiresAt = startedAt + lifetimeMs;
-      if (!Number.isFinite(expiresAt) || Date.now() >= expiresAt) throw authError();
-      this.cached = {
-        value: token.access_token,
-        renewAt: expiresAt - Math.min(MAX_REFRESH_SKEW_MS, lifetimeMs * 0.1)
-      };
-    }
-    this.retryAt = 0;
-    return token.access_token;
-  }
-};
-
-// src/client/databrain-client.ts
-var MCP_USER_AGENT = `databrain-mcp-server/${MCP_SERVER_VERSION}`;
-var MAX_RETRIES = 3;
-var REQUEST_TIMEOUT_MS = 3e4;
-var NON_TRANSIENT_PATTERNS = [
-  "out of context",
-  "Definition not found",
-  "not a data question",
-  "Query generation failed",
-  "not found",
-  "not authenticated",
-  "Invalid Service Token",
-  "service token"
-];
-var DatabrainClient = class {
-  constructor(config) {
-    this.config = config;
-    if (config.oauth) {
-      if (!oauthHttpsUrl.safeParse(config.apiUrl).success) {
-        throw new Error("OAuth requires an HTTPS Databrain API URL without userinfo or fragments.");
-      }
-      this.oauth = new OAuthClientCredentials(config.oauth);
-      this.config = Object.freeze({ ...config });
-    }
-  }
-  cache = new TtlCache();
-  runtimeApiToken;
-  oauth;
-  oauthFallback = false;
-  hasApiToken() {
-    return !!(this.runtimeApiToken || this.config.apiToken);
-  }
-  setRuntimeApiToken(token) {
-    this.runtimeApiToken = token;
-    logger.info("Runtime API token set for this session");
-  }
-  getServiceToken() {
-    return this.config.serviceToken;
-  }
-  getApiUrl() {
-    return this.config.apiUrl;
-  }
-  getDemoDomain() {
-    return this.config.demoDomain;
-  }
-  /**
-   * Describes which credential is currently used as the bearer for outgoing
-   * API calls. Used by `whoami` so the LLM can give the user a truthful answer.
-   */
-  getActiveAuth() {
-    if (this.oauth) {
-      if (this.oauthFallback) return { source: "service-token", oauthFallback: true };
-      return { source: "oauth-client-credentials", status: this.oauth.getStatus() };
-    }
-    if (this.config.serviceToken) return { source: "service-token" };
-    if (this.runtimeApiToken || this.config.apiToken) return { source: "api-token" };
-    return { source: "none" };
-  }
-  async getToken(auth) {
-    if (auth === "none") return void 0;
-    if (auth === "service") {
-      if (this.oauth) {
-        try {
-          const token = await this.oauth.getToken();
-          this.oauthFallback = false;
-          return token;
-        } catch {
-          if (!this.config.serviceToken) {
-            throw new DatabrainApiError(
-              0,
-              "OAUTH_TOKEN_ERROR",
-              "OAuth token acquisition failed. Check the configured issuer, client credentials, resource and scopes."
-            );
-          }
-          if (!this.oauthFallback) logger.warn("OAuth unavailable; using the configured static service token.");
-          this.oauthFallback = true;
-        }
-      }
-      return this.config.serviceToken;
-    }
-    return this.runtimeApiToken || this.config.apiToken;
-  }
-  async request(options) {
-    return this.requestInternal(options);
-  }
-  async requestInternal(options) {
-    const usesOAuth = !!this.oauth && options.auth === "service" && !options.token;
-    const cacheAllowed = !usesOAuth;
-    if (options.invalidateCache) {
-      for (const prefix of options.invalidateCache) {
-        this.cache.invalidateByPrefix(prefix);
-      }
-    }
-    if (cacheAllowed && options.cacheKey && options.cacheTtlMs) {
-      const cached = this.cache.get(options.cacheKey);
-      if (cached !== void 0) {
-        logger.debug(`Cache hit: ${options.cacheKey}`);
-        return cached;
-      }
-    }
-    let token = options.token ?? await this.getToken(options.auth);
-    if (options.auth !== "none" && !options.token && !token) {
-      if (options.auth === "service") {
-        throw new DatabrainApiError(
-          401,
-          "MISSING_SERVICE_TOKEN",
-          "DATABRAIN_SERVICE_TOKEN is required for this operation (org-level token for discovery and data app management). It must be set in the MCP server configuration \u2014 do not ask the user for it at runtime."
-        );
-      }
-      throw new DatabrainApiError(
-        401,
-        "MISSING_API_TOKEN",
-        "A per-data-app API token is required for this embedding operation but none is configured. Call `create_api_token` to generate one, or `set_api_token` if you already have the value. Do not ask the user for this token \u2014 create it via the MCP tools."
-      );
-    }
-    let url = `${this.config.apiUrl}${options.path}`;
-    if (options.query) {
-      const params = new URLSearchParams(options.query);
-      url += `?${params.toString()}`;
-    }
-    let lastError;
-    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
-      try {
-        if (usesOAuth && attempt > 1) token = await this.getToken(options.auth);
-        const headers = {
-          "Content-Type": "application/json",
-          Accept: "application/json",
-          "User-Agent": MCP_USER_AGENT,
-          "X-Databrain-Client": MCP_USER_AGENT,
-          ...options.headers
-        };
-        const ctx = toolContext.getStore();
-        if (ctx) {
-          headers["X-Databrain-MCP-Tool"] = ctx.tool;
-          headers["X-Databrain-MCP-Tool-Category"] = ctx.category;
-          headers["X-Databrain-MCP-Workflow-Intent"] = ctx.workflowIntent;
-          headers["X-Databrain-MCP-Input-Mode"] = ctx.inputMode;
-        }
-        if (token) {
-          if (options.auth === "none") {
-            headers["x-plugin-token"] = token;
-            headers["Origin"] = "https://mcp.usedatabrain.com";
-          } else {
-            headers["Authorization"] = `Bearer ${token}`;
-          }
-        }
-        const response = await fetch(url, {
-          method: options.method,
-          headers,
-          body: options.body ? JSON.stringify(options.body) : void 0,
-          signal: AbortSignal.timeout(options.timeoutMs || REQUEST_TIMEOUT_MS),
-          ...usesOAuth ? { redirect: "error" } : {}
-        });
-        if (!response.ok) {
-          if (usesOAuth) {
-            throw new DatabrainApiError(
-              response.status,
-              "OAUTH_API_ERROR",
-              `Databrain API request failed with status ${response.status} using configured service credentials.`
-            );
-          }
-          const errorBody = await response.text();
-          logger.warn(`[API Error] ${options.method} ${options.path} status=${response.status} body=${errorBody.slice(0, 500)}`);
-          let parsed = {};
-          try {
-            parsed = JSON.parse(errorBody);
-          } catch {
-          }
-          const errorMsg = parsed.message || parsed.detail || (typeof parsed.error === "string" ? parsed.error : JSON.stringify(parsed.error)) || `API request failed with status ${response.status}`;
-          const error = new DatabrainApiError(
-            response.status,
-            parsed.code || `HTTP_${response.status}`,
-            errorMsg,
-            parsed
-          );
-          const isTransient = response.status === 429 || response.status >= 500 && !NON_TRANSIENT_PATTERNS.some((p) => errorMsg.includes(p));
-          if (isTransient && attempt < MAX_RETRIES) {
-            const delay = Math.min(1e3 * Math.pow(2, attempt - 1), 8e3);
-            logger.warn(`Retrying in ${delay}ms (attempt ${attempt}/${MAX_RETRIES})`, {
-              status: response.status,
-              path: options.path
-            });
-            await new Promise((r) => setTimeout(r, delay));
-            lastError = error;
-            continue;
-          }
-          throw error;
-        }
-        const text = await response.text();
-        let data = text ? JSON.parse(text) : {};
-        if (!options.skipDataUnwrap && data && typeof data === "object" && !Array.isArray(data) && "data" in data) {
-          const inner = data.data;
-          if (inner !== null && inner !== void 0) {
-            data = inner;
-          }
-        }
-        if (cacheAllowed && options.cacheKey && options.cacheTtlMs) {
-          this.cache.set(options.cacheKey, data, options.cacheTtlMs);
-        }
-        return data;
-      } catch (err) {
-        if (err instanceof DatabrainApiError) throw err;
-        if (attempt < MAX_RETRIES && err?.name === "TimeoutError" && !options.noRetryOnTimeout) {
-          const delay = Math.min(1e3 * Math.pow(2, attempt - 1), 8e3);
-          logger.warn(`Request timed out, retrying in ${delay}ms`, { path: options.path });
-          await new Promise((r) => setTimeout(r, delay));
-          lastError = err;
-          continue;
-        }
-        throw new DatabrainApiError(
-          0,
-          "NETWORK_ERROR",
-          usesOAuth ? "Failed to connect to Databrain API using configured service credentials." : `Failed to connect to Databrain API: ${err.message}`
-        );
-      }
-    }
-    throw lastError || new DatabrainApiError(0, "UNKNOWN", "Request failed after retries");
-  }
-};
+import {
+  CustomChartsApi,
+  DatabrainApiError,
+  apiProblems,
+  buildProject,
+  bundleSizeBytes,
+  contentHash,
+  createCustomChartsApi,
+  logger,
+  optionSchema,
+  planUpload,
+  readDist,
+  scaffoldProject,
+  slotSchema,
+  stringify,
+  toolContext,
+  toolError,
+  toolSuccess,
+  validateBundle
+} from "./chunk-PRE4CGOV.js";
 
 // src/apps/contract.ts
-import { z as z2 } from "zod";
+import { z } from "zod";
 var CHART_URI = "ui://databrain/chart-tile";
 var KPI_URI = "ui://databrain/kpi-tile";
 var APP_MIME = "text/html;profile=mcp-app";
 var RESOURCE_URI_META_KEY = "ui/resourceUri";
 var PAGE_SIZE = 50;
 var MAX_RESULT_CHARS = 125e3;
-var id = z2.string().trim().min(1).max(256);
-var cell = z2.union([z2.string().max(2e3), z2.number().finite(), z2.boolean(), z2.null()]);
-var rowsSchema = z2.array(z2.record(cell)).max(PAGE_SIZE);
-var referenceSchema = z2.object({ embedId: id, clientId: id, widgetId: id }).strict();
-var point = z2.object({
+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 point = z.object({
   key: id,
-  label: z2.string().max(2e3),
+  label: z.string().max(2e3),
   value: cell,
-  x: z2.number().min(0),
-  y: z2.number().min(0),
-  width: z2.number().positive(),
-  height: z2.number().positive(),
+  x: z.number().min(0),
+  y: z.number().min(0),
+  width: z.number().positive(),
+  height: z.number().positive(),
   drillId: id.optional()
 }).strict();
-var dateRangeSchema = z2.object({
-  from: z2.string().date(),
-  to: z2.string().date()
+var dateRangeSchema = z.object({
+  from: z.string().date(),
+  to: z.string().date()
 }).strict().refine((value) => value.from <= value.to, "Date range must be ordered");
-var viewSchema = z2.object({
-  cursor: z2.string().min(1).max(2048).optional(),
+var viewSchema = z.object({
+  cursor: z.string().min(1).max(2048).optional(),
   dateRange: dateRangeSchema.optional(),
   drillId: id.optional()
 }).strict();
-var pageSchema = z2.object({
-  kind: z2.enum(["chart", "kpi"]),
-  title: z2.string().max(500),
-  chartSpec: z2.object({ type: z2.string().max(80) }).strict(),
+var pageSchema = z.object({
+  kind: z.enum(["chart", "kpi"]),
+  title: z.string().max(500),
+  chartSpec: z.object({ type: z.string().max(80) }).strict(),
   rows: rowsSchema,
-  columns: z2.array(z2.string().max(128)).max(20),
-  svg: z2.string().max(1e5).optional(),
-  width: z2.number().int().min(240).max(1200),
-  height: z2.number().int().min(120).max(800),
-  points: z2.array(point).max(PAGE_SIZE),
+  columns: z.array(z.string().max(128)).max(20),
+  svg: z.string().max(1e5).optional(),
+  width: z.number().int().min(240).max(1200),
+  height: z.number().int().min(120).max(800),
+  points: z.array(point).max(PAGE_SIZE),
   value: cell.optional(),
-  nextCursor: z2.string().min(1).max(2048).optional()
+  nextCursor: z.string().min(1).max(2048).optional()
 }).strict().superRefine((page, ctx) => {
   if (page.kind === "chart" && !page.svg) ctx.addIssue({ code: "custom", message: "SVG required" });
   if (page.kind === "kpi" && (page.svg || page.points.length || page.value === void 0)) {
@@ -664,70 +112,95 @@ function chartResult(summary, payload) {
 // src/tools/tool-metadata.ts
 var DEFAULT_TOOL_META = {
   category: "discovery",
-  workflowIntent: "other"
+  workflowIntent: "other",
+  // Fail closed: an unregistered/unclassified tool is treated as a commit
+  // until someone deliberately marks it read or view.
+  effect: "commit"
 };
 var TOOL_METADATA = {
   // Identity / discovery
-  whoami: { category: "discovery", workflowIntent: "discovery" },
+  whoami: { category: "discovery", workflowIntent: "discovery", effect: "read" },
   // Infrastructure / data setup
-  list_datasources: { category: "infrastructure", workflowIntent: "setup_data" },
-  discover_datasource_schema: { category: "infrastructure", workflowIntent: "setup_data" },
-  list_datamarts: { category: "infrastructure", workflowIntent: "setup_data" },
-  list_workspaces: { category: "infrastructure", workflowIntent: "setup_data" },
-  sync_datasource: { category: "infrastructure", workflowIntent: "setup_data" },
-  create_datamart: { category: "infrastructure", workflowIntent: "setup_data" },
+  list_datasources: { category: "infrastructure", workflowIntent: "setup_data", effect: "read" },
+  discover_datasource_schema: { category: "infrastructure", workflowIntent: "setup_data", effect: "read" },
+  list_datamarts: { category: "infrastructure", workflowIntent: "setup_data", effect: "read" },
+  list_workspaces: { category: "infrastructure", workflowIntent: "setup_data", effect: "read" },
+  // Triggers a backend sync job that refreshes stored schema metadata — a real mutation, not a read.
+  sync_datasource: { category: "infrastructure", workflowIntent: "setup_data", effect: "commit" },
+  // dry_run is the default, but mode:"apply" performs a real POST that creates the datamart.
+  create_datamart: { category: "infrastructure", workflowIntent: "setup_data", effect: "commit" },
   // Embedding — data apps & tokens
-  list_data_apps: { category: "embedding", workflowIntent: "embed_dashboard" },
-  list_tenants: { category: "embedding", workflowIntent: "embed_dashboard" },
-  create_data_app: { category: "embedding", workflowIntent: "embed_dashboard" },
-  list_api_tokens: { category: "embedding", workflowIntent: "embed_dashboard" },
-  create_api_token: { category: "embedding", workflowIntent: "embed_dashboard" },
-  rotate_api_token: { category: "embedding", workflowIntent: "embed_dashboard" },
+  list_data_apps: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  list_tenants: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  create_data_app: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  list_api_tokens: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  create_api_token: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  rotate_api_token: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
   // Embedding — embed management
-  create_embed: { category: "embedding", workflowIntent: "embed_dashboard" },
-  list_embeds: { category: "embedding", workflowIntent: "embed_dashboard" },
-  get_embed_details: { category: "embedding", workflowIntent: "embed_dashboard" },
-  update_embed: { category: "embedding", workflowIntent: "embed_dashboard" },
-  customize_embed_theme: { category: "embedding", workflowIntent: "embed_dashboard" },
-  get_demo_link: { category: "embedding", workflowIntent: "embed_dashboard" },
+  create_embed: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  list_embeds: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  get_embed_details: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
+  update_embed: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  // Persists theme/access config on the embed record — a real write, not a display-only tweak.
+  customize_embed_theme: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  // Mints and returns a live guest token embedded in the demo URL.
+  get_demo_link: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
   // Embedding — frontend
-  generate_guest_token: { category: "embedding", workflowIntent: "embed_dashboard" },
-  generate_embed_code: { category: "embedding", workflowIntent: "embed_dashboard" },
+  generate_guest_token: { category: "embedding", workflowIntent: "embed_dashboard", effect: "commit" },
+  generate_embed_code: { category: "embedding", workflowIntent: "embed_dashboard", effect: "read" },
   // Embedding — customer dashboards & widgets
-  list_dashboards: { category: "embedding", workflowIntent: "embedded_widget" },
-  create_dashboard: { category: "embedding", workflowIntent: "author_dashboard" },
-  get_dashboard: { category: "embedding", workflowIntent: "author_dashboard" },
-  generate_dashboard_tiles: { category: "embedding", workflowIntent: "author_dashboard" },
-  list_widgets: { category: "embedding", workflowIntent: "embedded_widget" },
-  add_widget: { category: "embedding", workflowIntent: "embedded_widget" },
-  update_widget: { category: "embedding", workflowIntent: "embedded_widget" },
-  remove_widget: { category: "embedding", workflowIntent: "embedded_widget" },
-  generate_widget: { category: "embedding", workflowIntent: "embedded_widget" },
-  validate_metric_spec: { category: "embedding", workflowIntent: "sql_to_embedded_metric" },
+  list_dashboards: { category: "embedding", workflowIntent: "embedded_widget", effect: "read" },
+  create_dashboard: { category: "embedding", workflowIntent: "author_dashboard", effect: "commit" },
+  get_dashboard: { category: "embedding", workflowIntent: "author_dashboard", effect: "read" },
+  // Does not persist a dashboard, but mints an internal guest token to render tile previews.
+  generate_dashboard_tiles: { category: "embedding", workflowIntent: "author_dashboard", effect: "commit" },
+  list_widgets: { category: "embedding", workflowIntent: "embedded_widget", effect: "read" },
+  add_widget: { category: "embedding", workflowIntent: "embedded_widget", effect: "commit" },
+  update_widget: { category: "embedding", workflowIntent: "embedded_widget", effect: "commit" },
+  remove_widget: { category: "embedding", workflowIntent: "embedded_widget", effect: "commit" },
+  // Returns an unsaved draft, but mints an internal write-capable guest token to generate it.
+  generate_widget: { category: "embedding", workflowIntent: "embedded_widget", effect: "commit" },
+  // Dry-run validation only, but mints an internal write-capable guest token to check conflicts.
+  validate_metric_spec: { category: "embedding", workflowIntent: "sql_to_embedded_metric", effect: "commit" },
   create_or_update_metric_from_query: {
     category: "embedding",
-    workflowIntent: "sql_to_embedded_metric"
+    workflowIntent: "sql_to_embedded_metric",
+    effect: "commit"
   },
   // Internal analytics
   create_workspace_metric: {
     category: "internal_analytics",
-    workflowIntent: "sql_to_workspace_metric"
+    workflowIntent: "sql_to_workspace_metric",
+    effect: "commit"
   },
-  ask_question: { category: "internal_analytics", workflowIntent: "query_data" },
+  // Runs a query and returns rows; no dashboard/widget/row is persisted.
+  ask_question: { category: "internal_analytics", workflowIntent: "query_data", effect: "read" },
+  preview_chart: { category: "internal_analytics", workflowIntent: "query_data", effect: "view" },
+  save_chart_as_dashboard: { category: "internal_analytics", workflowIntent: "author_dashboard", effect: "commit" },
   // Semantic layer
-  get_semantic_layer: { category: "semantic_layer", workflowIntent: "query_data" },
-  update_semantic_layer: { category: "semantic_layer", workflowIntent: "query_data" },
-  start_semantic_layer_generation: { category: "semantic_layer", workflowIntent: "query_data" },
+  get_semantic_layer: { category: "semantic_layer", workflowIntent: "query_data", effect: "read" },
+  update_semantic_layer: { category: "semantic_layer", workflowIntent: "query_data", effect: "commit" },
+  start_semantic_layer_generation: { category: "semantic_layer", workflowIntent: "query_data", effect: "commit" },
   get_semantic_layer_generation_status: {
     category: "semantic_layer",
-    workflowIntent: "query_data"
+    workflowIntent: "query_data",
+    effect: "read"
   },
   // Reports
-  list_scheduled_reports: { category: "reports", workflowIntent: "reports" }
+  list_scheduled_reports: { category: "reports", workflowIntent: "reports", effect: "read" },
+  // Custom chart types (DAT-925)
+  // Returns template files; nothing is written or persisted.
+  custom_chart_scaffold: { category: "custom_charts", workflowIntent: "custom_chart", effect: "read" },
+  // Local rules plus POST /validate, which never persists.
+  custom_chart_validate: { category: "custom_charts", workflowIntent: "custom_chart", effect: "read" },
+  // dry_run is the default, but mode:"apply" creates a chart or a version (and may publish).
+  custom_chart_upload: { category: "custom_charts", workflowIntent: "custom_chart", effect: "commit" },
+  list_custom_charts: { category: "custom_charts", workflowIntent: "custom_chart", effect: "read" },
+  publish_custom_chart: { category: "custom_charts", workflowIntent: "custom_chart", effect: "commit" }
 };
 
 // src/tools/data-app/list-data-apps.ts
-import { z as z3 } from "zod";
+import { z as z2 } from "zod";
 
 // src/api/dashboards-api.ts
 var DashboardsApi = class {
@@ -1022,7 +495,7 @@ var QueryApi = class {
   async startSemanticLayerGeneration(datamartId) {
     return this.client.request({
       method: "POST",
-      path: `/schema/datamart/${encodeURIComponent(datamartId)}/semantic-layer/auto-generate`,
+      path: `/api/v2/data-app/datamarts/${encodeURIComponent(datamartId)}/semantic-layer/generate`,
       auth: "service",
       invalidateCache: ["semantic_layer_"]
     });
@@ -1030,7 +503,7 @@ var QueryApi = class {
   async getSemanticLayerGenerationStatus(datamartId) {
     return this.client.request({
       method: "GET",
-      path: `/schema/datamart/${encodeURIComponent(datamartId)}/semantic-layer/generation-status`,
+      path: `/api/v2/data-app/datamarts/${encodeURIComponent(datamartId)}/semantic-layer/generation-status`,
       auth: "service"
     });
   }
@@ -1999,6 +1472,7 @@ function createServiceBundle(client) {
   const guestTokenApi = new GuestTokenApi(client);
   const queryApi = new QueryApi(client);
   const scheduledReportsApi = new ScheduledReportsApi(client);
+  const customChartsApi = new CustomChartsApi(client);
   const tenantsApi = new TenantsApi(client);
   const widgetsApi = new WidgetsApi(client);
   const workspacesApi = new WorkspacesApi(client);
@@ -2013,6 +1487,7 @@ function createServiceBundle(client) {
     workspacesApi,
     queryApi,
     scheduledReportsApi,
+    customChartsApi,
     tenantsApi,
     widgetsApi,
     embedService: new EmbedService(embedsApi, datamartsApi),
@@ -2063,7 +1538,7 @@ function registerListDataApps(server, client) {
     "list_data_apps",
     "List data apps in your organization. Start here for embed setup.",
     {
-      workspaceName: z3.string().optional().describe("Filter by workspace name")
+      workspaceName: z2.string().optional().describe("Filter by workspace name")
     },
     READ_ONLY,
     async (params) => {
@@ -2092,7 +1567,7 @@ function registerListDataApps(server, client) {
 }
 
 // src/tools/data-app/list-tenants.ts
-import { z as z4 } from "zod";
+import { z as z3 } from "zod";
 var isNonEmptyString4 = (value) => typeof value === "string" && value.trim().length > 0;
 function workspaceIdFrom(workspace) {
   return isNonEmptyString4(workspace.id) && workspace.id || isNonEmptyString4(workspace._id) && workspace._id || isNonEmptyString4(workspace.workspaceId) && workspace.workspaceId || null;
@@ -2130,12 +1605,12 @@ function registerListTenants(server, client) {
     "list_tenants",
     "List available tenants/clients from the workspace tenancy database. Use this to pick a valid clientId before creating guest tokens or editing customer dashboards.",
     {
-      workspaceName: z4.string().optional().describe("Workspace name. Preferred for non-technical callers; the tool resolves it to a workspaceId."),
-      workspaceId: z4.string().optional().describe("Technical workspace UUID. Provide this instead of workspaceName if already known."),
-      searchValue: z4.string().optional().describe("Optional case-insensitive search string for tenant/client labels."),
-      limit: z4.number().int().positive().max(500).optional().describe("Maximum number of tenants to return. Backend may apply connector-specific limits."),
-      datasourceId: z4.string().optional().describe("Optional datasource UUID override when the workspace has multiple datasource contexts."),
-      datamartId: z4.string().optional().describe("Optional datamart UUID override when tenant lookup should use a specific datamart.")
+      workspaceName: z3.string().optional().describe("Workspace name. Preferred for non-technical callers; the tool resolves it to a workspaceId."),
+      workspaceId: z3.string().optional().describe("Technical workspace UUID. Provide this instead of workspaceName if already known."),
+      searchValue: z3.string().optional().describe("Optional case-insensitive search string for tenant/client labels."),
+      limit: z3.number().int().positive().max(500).optional().describe("Maximum number of tenants to return. Backend may apply connector-specific limits."),
+      datasourceId: z3.string().optional().describe("Optional datasource UUID override when the workspace has multiple datasource contexts."),
+      datamartId: z3.string().optional().describe("Optional datamart UUID override when tenant lookup should use a specific datamart.")
     },
     READ_ONLY,
     async (params) => {
@@ -2229,15 +1704,15 @@ function registerListTenants(server, client) {
 }
 
 // src/tools/data-app/create-data-app.ts
-import { z as z5 } from "zod";
+import { z as z4 } from "zod";
 function registerCreateDataApp(server, client) {
   server.tool(
     "create_data_app",
     "Create a new data app.",
     {
-      name: z5.string().describe("Data app name"),
-      workspaceName: z5.string().optional().describe("Optional workspace name if required by backend"),
-      body: z5.record(z5.unknown()).optional().describe("Raw API body passthrough for POST /api/v2/data-app/")
+      name: z4.string().describe("Data app name"),
+      workspaceName: z4.string().optional().describe("Optional workspace name if required by backend"),
+      body: z4.record(z4.unknown()).optional().describe("Raw API body passthrough for POST /api/v2/data-app/")
     },
     WRITE_CREATE,
     async (params) => {
@@ -2271,7 +1746,7 @@ function registerCreateDataApp(server, client) {
 }
 
 // src/tools/data-app/list-api-tokens.ts
-import { z as z6 } from "zod";
+import { z as z5 } from "zod";
 
 // src/utils/resolve-resource.ts
 function resolveResource(options) {
@@ -2340,7 +1815,7 @@ function registerListApiTokens(server, client) {
     "list_api_tokens",
     "List API tokens for a data app. Omit dataAppName to auto-resolve.",
     {
-      dataAppName: z6.string().optional().describe("Data app name. Omit to list available data apps.")
+      dataAppName: z5.string().optional().describe("Data app name. Omit to list available data apps.")
     },
     READ_ONLY,
     async (params) => {
@@ -2385,16 +1860,16 @@ function registerListApiTokens(server, client) {
 }
 
 // src/tools/data-app/create-api-token.ts
-import { z as z7 } from "zod";
+import { z as z6 } from "zod";
 function registerCreateApiToken(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "create_api_token",
     "Create an API token for a data app and activate it for this session. Omit dataAppName to auto-resolve.",
     {
-      dataAppName: z7.string().optional().describe("Data app name. Omit to list available data apps."),
-      name: z7.string().optional().describe("Optional token name"),
-      body: z7.record(z7.unknown()).optional().describe("Raw API body passthrough for POST /api/v2/data-app/api-tokens")
+      dataAppName: z6.string().optional().describe("Data app name. Omit to list available data apps."),
+      name: z6.string().optional().describe("Optional token name"),
+      body: z6.record(z6.unknown()).optional().describe("Raw API body passthrough for POST /api/v2/data-app/api-tokens")
     },
     WRITE_CREATE,
     async (params) => {
@@ -2446,16 +1921,16 @@ Save this in backend secrets immediately. This value may not be returned again.`
 }
 
 // src/tools/data-app/rotate-api-token.ts
-import { z as z8 } from "zod";
+import { z as z7 } 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.",
     {
-      dataAppName: z8.string().optional().describe("Data app name. Omit to list available data apps."),
-      tokenId: z8.string().optional().describe("Optional token ID to rotate"),
-      body: z8.record(z8.unknown()).optional().describe("Raw API body passthrough for rotate endpoint")
+      dataAppName: z7.string().optional().describe("Data app name. Omit to list available data apps."),
+      tokenId: z7.string().optional().describe("Optional token ID to rotate"),
+      body: z7.record(z7.unknown()).optional().describe("Raw API body passthrough for rotate endpoint")
     },
     DESTRUCTIVE,
     async (params) => {
@@ -2574,14 +2049,14 @@ function registerListDatasources(server, client) {
 }
 
 // src/tools/infrastructure/discover-datasource-schema.ts
-import { z as z9 } from "zod";
+import { z as z8 } from "zod";
 function registerDiscoverDatasourceSchema(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "discover_datasource_schema",
     "Inspect tables and columns in a datasource. Omit datasourceName to list available datasources.",
     {
-      datasourceName: z9.string().optional().describe(
+      datasourceName: z8.string().optional().describe(
         "Name of the datasource to inspect. Omit to list available datasources."
       )
     },
@@ -2664,13 +2139,13 @@ Fix the connection or add a new database in the **Databrain UI**.`
 }
 
 // src/tools/infrastructure/list-datamarts.ts
-import { z as z10 } from "zod";
+import { z as z9 } from "zod";
 function registerListDatamarts(server, client) {
   server.tool(
     "list_datamarts",
     "List datamarts with table counts and semantic layer scores.",
     {
-      dataAppName: z10.string().optional().describe("Filter by data app name")
+      dataAppName: z9.string().optional().describe("Filter by data app name")
     },
     READ_ONLY,
     async (params) => {
@@ -2759,7 +2234,7 @@ function registerListWorkspaces(server, client) {
 }
 
 // src/tools/infrastructure/create-datamart.ts
-import { z as z11 } from "zod";
+import { z as z10 } from "zod";
 
 // src/tools/widgets/production-guards.ts
 var APPLY_TO_PRODUCTION_CONFIRMATION = "APPLY_TO_PRODUCTION";
@@ -2777,29 +2252,29 @@ function genericProductionSafetyNote() {
 }
 
 // src/tools/infrastructure/create-datamart.ts
-var columnSchema = z11.object({
-  name: z11.string(),
-  alias: z11.string().optional(),
-  label: z11.string().optional(),
-  isHide: z11.boolean().optional(),
-  isCustomColumn: z11.boolean().optional(),
-  sql: z11.string().optional()
+var columnSchema = z10.object({
+  name: z10.string(),
+  alias: z10.string().optional(),
+  label: z10.string().optional(),
+  isHide: z10.boolean().optional(),
+  isCustomColumn: z10.boolean().optional(),
+  sql: z10.string().optional()
 });
-var tableSchema = z11.object({
-  name: z11.string(),
-  schemaName: z11.string().optional(),
-  clientColumn: z11.string().optional(),
-  label: z11.string().optional(),
-  columns: z11.array(columnSchema)
+var tableSchema = z10.object({
+  name: z10.string(),
+  schemaName: z10.string().optional(),
+  clientColumn: z10.string().optional(),
+  label: z10.string().optional(),
+  columns: z10.array(columnSchema)
 });
-var relationshipSchema = z11.object({
-  parentTableName: z11.string(),
-  parentColumnName: z11.string(),
-  childTableName: z11.string(),
-  childColumnName: z11.string(),
-  cardinality: z11.enum(["OneToOne", "OneToMany", "ManyToOne", "ManyToMany"]),
-  join: z11.enum(["INNER JOIN", "LEFT JOIN", "RIGHT JOIN", "FULL JOIN"]),
-  relationshipName: z11.string()
+var relationshipSchema = z10.object({
+  parentTableName: z10.string(),
+  parentColumnName: z10.string(),
+  childTableName: z10.string(),
+  childColumnName: z10.string(),
+  cardinality: z10.enum(["OneToOne", "OneToMany", "ManyToOne", "ManyToMany"]),
+  join: z10.enum(["INNER JOIN", "LEFT JOIN", "RIGHT JOIN", "FULL JOIN"]),
+  relationshipName: z10.string()
 });
 function datamartSuccessMessage(name, result) {
   return `Datamart "${name}" created successfully (ID: ${result.id || result._id || "UNKNOWN"}).
@@ -2820,21 +2295,21 @@ function registerCreateDatamart(server, client) {
     "create_datamart",
     "Create a production datamart from selected tables and relationships. Defaults to dry-run; apply requires explicit confirmation.",
     {
-      mode: z11.enum(["dry_run", "apply"]).default("dry_run").describe("dry_run returns the plan only; apply creates the datamart"),
-      confirm: z11.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
-      name: z11.string().describe("Unique datamart name"),
-      datasourceName: z11.string().optional().describe("Name of the datasource to use. Omit to list available datasources."),
-      tableList: z11.array(tableSchema).optional().describe("Array of tables with their columns"),
-      relationships: z11.array(relationshipSchema).optional().describe("Join definitions between tables"),
-      tenancySettings: z11.object({
-        tenancyLevel: z11.enum(["TABLE", "DATABASE"]).optional(),
-        clientColumnType: z11.string().optional(),
-        schemaName: z11.string().optional(),
-        tableName: z11.string().optional(),
-        tableClientNameColumn: z11.string().optional(),
-        tablePrimaryKeyColumn: z11.string().optional()
+      mode: z10.enum(["dry_run", "apply"]).default("dry_run").describe("dry_run returns the plan only; apply creates the datamart"),
+      confirm: z10.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
+      name: z10.string().describe("Unique datamart name"),
+      datasourceName: z10.string().optional().describe("Name of the datasource to use. Omit to list available datasources."),
+      tableList: z10.array(tableSchema).optional().describe("Array of tables with their columns"),
+      relationships: z10.array(relationshipSchema).optional().describe("Join definitions between tables"),
+      tenancySettings: z10.object({
+        tenancyLevel: z10.enum(["TABLE", "DATABASE"]).optional(),
+        clientColumnType: z10.string().optional(),
+        schemaName: z10.string().optional(),
+        tableName: z10.string().optional(),
+        tableClientNameColumn: z10.string().optional(),
+        tablePrimaryKeyColumn: z10.string().optional()
       }).optional().describe("Multi-tenant configuration"),
-      body: z11.record(z11.unknown()).optional().describe("Raw API body passthrough for POST /api/v2/data-app/datamarts")
+      body: z10.record(z10.unknown()).optional().describe("Raw API body passthrough for POST /api/v2/data-app/datamarts")
     },
     WRITE_CREATE,
     async (params) => {
@@ -2929,14 +2404,14 @@ function registerCreateDatamart(server, client) {
 }
 
 // src/tools/infrastructure/sync-datasource.ts
-import { z as z12 } from "zod";
+import { z as z11 } from "zod";
 function registerSyncDatasource(server, client) {
   const datasourcesApi = new DatasourcesApi(client);
   server.tool(
     "sync_datasource",
     "Trigger a datasource schema sync to refresh table and column metadata. If datasourceName is omitted and there are multiple datasources, returns the list so the user can choose.",
     {
-      datasourceName: z12.string().optional().describe("Name of the datasource to sync. Omit to list available datasources.")
+      datasourceName: z11.string().optional().describe("Name of the datasource to sync. Omit to list available datasources.")
     },
     WRITE_IDEMPOTENT,
     async (params) => {
@@ -2985,7 +2460,7 @@ The schema metadata will be refreshed. You can now use \`discover_datasource_sch
 }
 
 // src/tools/embed/create-embed.ts
-import { z as z13 } from "zod";
+import { z as z12 } from "zod";
 var DEFAULT_ACCESS_SETTINGS2 = {
   isAllowMetricCreation: false,
   isAllowMetricDeletion: false,
@@ -2998,18 +2473,18 @@ var DEFAULT_ACCESS_SETTINGS2 = {
   isAllowCreateDashboardView: false,
   metricCreationMode: "DRAG_DROP"
 };
-var accessSettingsSchema = z13.object({
-  datamartName: z13.string().describe("Name of the datamart (required)"),
-  isAllowMetricCreation: z13.boolean().optional().describe("Allow end-users to create metrics"),
-  metricCreationMode: z13.enum(["DRAG_DROP", "CHAT"]).optional().describe("Metric creation mode"),
-  isAllowMetricDeletion: z13.boolean().optional().describe("Allow metric deletion"),
-  isAllowMetricUpdate: z13.boolean().optional().describe("Allow metric editing"),
-  isAllowMetricLayoutChange: z13.boolean().optional().describe("Allow layout changes"),
-  isAllowManageMetrics: z13.boolean().optional().describe("Show manage metrics UI"),
-  isAllowUnderlyingData: z13.boolean().optional().describe("Allow viewing underlying data"),
-  isAllowAiPilot: z13.boolean().optional().describe("Enable AI pilot features"),
-  isAllowEmailReports: z13.boolean().optional().describe("Allow email report scheduling"),
-  isAllowCreateDashboardView: z13.boolean().optional().describe("Allow creating dashboard views")
+var accessSettingsSchema = z12.object({
+  datamartName: z12.string().describe("Name of the datamart (required)"),
+  isAllowMetricCreation: z12.boolean().optional().describe("Allow end-users to create metrics"),
+  metricCreationMode: z12.enum(["DRAG_DROP", "CHAT"]).optional().describe("Metric creation mode"),
+  isAllowMetricDeletion: z12.boolean().optional().describe("Allow metric deletion"),
+  isAllowMetricUpdate: z12.boolean().optional().describe("Allow metric editing"),
+  isAllowMetricLayoutChange: z12.boolean().optional().describe("Allow layout changes"),
+  isAllowManageMetrics: z12.boolean().optional().describe("Show manage metrics UI"),
+  isAllowUnderlyingData: z12.boolean().optional().describe("Allow viewing underlying data"),
+  isAllowAiPilot: z12.boolean().optional().describe("Enable AI pilot features"),
+  isAllowEmailReports: z12.boolean().optional().describe("Allow email report scheduling"),
+  isAllowCreateDashboardView: z12.boolean().optional().describe("Allow creating dashboard views")
 }).describe("Embed access settings. Only datamartName is required \u2014 all flags default to false.");
 function registerCreateEmbed(server, client) {
   const services = createServiceBundle(client);
@@ -3017,23 +2492,23 @@ function registerCreateEmbed(server, client) {
     "create_embed",
     "Create an embed. Provide dashboardId, workspaceName, accessSettings.datamartName. Add clientId for multi-tenant per-client dashboards. All isAllow* flags default to false.",
     {
-      body: z13.record(z13.unknown()).optional().describe(
+      body: z12.record(z12.unknown()).optional().describe(
         "Raw API body passthrough. If provided, all other fields are ignored."
       ),
-      dashboardId: z13.string().optional().describe("Dashboard identifier for embed creation"),
-      workspaceName: z13.string().optional().describe("Workspace name. Omit to auto-resolve if only one exists."),
-      embedType: z13.enum(["dashboard", "metric"]).optional().describe("Embed type"),
-      metricId: z13.string().optional().describe("Required for metric embed type"),
-      name: z13.string().optional().describe("Human-readable embed config name"),
+      dashboardId: z12.string().optional().describe("Dashboard identifier for embed creation"),
+      workspaceName: z12.string().optional().describe("Workspace name. Omit to auto-resolve if only one exists."),
+      embedType: z12.enum(["dashboard", "metric"]).optional().describe("Embed type"),
+      metricId: z12.string().optional().describe("Required for metric embed type"),
+      name: z12.string().optional().describe("Human-readable embed config name"),
       accessSettings: accessSettingsSchema.optional(),
       // Multi-tenant (dashboard embed) params
-      clientId: z13.string().optional().describe(
+      clientId: z12.string().optional().describe(
         "Client identifier for multi-tenant isolation. When provided, creates a dashboard embed (each client gets their own dashboard copy)."
       ),
-      templateDashboardId: z13.string().optional().describe("Template dashboard ID to clone metrics from"),
-      isImportMetrics: z13.boolean().optional().describe("Import metrics from template dashboard"),
-      metricImportMode: z13.enum(["COPY", "LINK"]).optional().describe("COPY duplicates metrics, LINK shares them"),
-      isRenameDashboard: z13.boolean().optional().describe("Rename the dashboard for this client")
+      templateDashboardId: z12.string().optional().describe("Template dashboard ID to clone metrics from"),
+      isImportMetrics: z12.boolean().optional().describe("Import metrics from template dashboard"),
+      metricImportMode: z12.enum(["COPY", "LINK"]).optional().describe("COPY duplicates metrics, LINK shares them"),
+      isRenameDashboard: z12.boolean().optional().describe("Rename the dashboard for this client")
     },
     WRITE_CREATE,
     async (params) => {
@@ -3135,14 +2610,14 @@ Next: run \`get_embed_details\` to verify the embed configuration.`
 }
 
 // src/tools/embed/list-embeds.ts
-import { z as z14 } from "zod";
+import { z as z13 } from "zod";
 function registerListEmbeds(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "list_embeds",
     "List embed configurations. Requires an API token (use create_api_token first). Use `list_tenants` for authoritative client discovery from the tenancy database.",
     {
-      dataAppName: z14.string().optional().describe("Filter by data app name")
+      dataAppName: z13.string().optional().describe("Filter by data app name")
     },
     READ_ONLY,
     async (params) => {
@@ -3193,14 +2668,14 @@ function registerListEmbeds(server, client) {
 }
 
 // src/tools/embed/get-embed-details.ts
-import { z as z15 } from "zod";
+import { z as z14 } from "zod";
 function registerGetEmbedDetails(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "get_embed_details",
     "Get full embed configuration including access settings and theme.",
     {
-      embedId: z15.string().describe("ID of the embed")
+      embedId: z14.string().describe("ID of the embed")
     },
     READ_ONLY,
     async (params) => {
@@ -3216,7 +2691,7 @@ function registerGetEmbedDetails(server, client) {
 }
 
 // src/tools/embed/update-embed.ts
-import { z as z16 } from "zod";
+import { z as z15 } from "zod";
 
 // src/tools/embed/helpers.ts
 var GUEST_TOKEN_REMINDER = "\n\n\u26A0\uFE0F **Guest tokens must be regenerated** for these changes to take effect. Existing guest tokens still carry the old settings. Call `generate_guest_token` to create a new token with the updated configuration.";
@@ -3254,15 +2729,15 @@ function registerUpdateEmbed(server, client) {
     "update_embed",
     "Update embed access settings, permissions, theme, or name.",
     {
-      embedId: z16.string().describe("ID of the embed to update"),
-      body: z16.record(z16.unknown()).optional().describe(
+      embedId: z15.string().describe("ID of the embed to update"),
+      body: z15.record(z15.unknown()).optional().describe(
         "Raw API body for PUT /api/v2/data-app/embeds. If provided, it is sent directly (passthrough mode)."
       ),
-      name: z16.string().optional().describe("New name for the embed"),
-      accessSettings: z16.record(z16.unknown()).optional().describe(
+      name: z15.string().optional().describe("New name for the embed"),
+      accessSettings: z15.record(z15.unknown()).optional().describe(
         "Partial update of access settings. See `get_embed_details` for current settings."
       ),
-      theme: z16.record(z16.unknown()).optional().describe(
+      theme: z15.record(z15.unknown()).optional().describe(
         "Theme configuration object. See databrain://theme-reference for the full schema."
       )
     },
@@ -3308,7 +2783,7 @@ function registerUpdateEmbed(server, client) {
 }
 
 // src/tools/embed/customize-theme.ts
-import { z as z17 } from "zod";
+import { z as z16 } from "zod";
 var THEME_PRESETS = {
   light: {
     general: {
@@ -3442,7 +2917,7 @@ var ACCESS_PRESETS = {
     metricCreationMode: "CHAT"
   }
 };
-var fontFamilyEnum = z17.enum([
+var fontFamilyEnum = z16.enum([
   "Inter",
   "Roboto",
   "Open Sans",
@@ -3454,17 +2929,17 @@ var fontFamilyEnum = z17.enum([
   "Nunito",
   "system-ui"
 ]).describe("Font family");
-var tooltipFontSchema = z17.object({
-  fontFamily: z17.string().optional(),
-  fontSize: z17.number().optional(),
-  fontWeight: z17.number().optional(),
-  fontColor: z17.string().optional()
+var tooltipFontSchema = z16.object({
+  fontFamily: z16.string().optional(),
+  fontSize: z16.number().optional(),
+  fontWeight: z16.number().optional(),
+  fontColor: z16.string().optional()
 }).optional();
-var fontConfigInputSchema = z17.object({
-  fontSize: z17.number().optional(),
-  fontFamily: z17.string().optional(),
-  fontWeight: z17.number().optional(),
-  color: z17.string().optional()
+var fontConfigInputSchema = z16.object({
+  fontSize: z16.number().optional(),
+  fontFamily: z16.string().optional(),
+  fontWeight: z16.number().optional(),
+  color: z16.string().optional()
 }).optional();
 function mapToFrontendFontConfig(input) {
   if (!input) return void 0;
@@ -3475,23 +2950,23 @@ function mapToFrontendFontConfig(input) {
     ...input.color && { color: input.color }
   };
 }
-var axisSchema = z17.object({
-  hideAxisLines: z17.boolean().optional().describe("Hide axis lines"),
-  hideSplitLines: z17.boolean().optional().describe("Hide grid/split lines"),
-  hideAxisLabels: z17.boolean().optional().describe("Hide axis labels"),
-  hideAxisTicks: z17.boolean().optional().describe("Hide axis tick marks"),
-  axisName: z17.string().optional().describe("Axis title text"),
-  axisNameOffset: z17.number().optional().describe("Axis title offset from axis"),
-  axisLabelMargin: z17.number().optional().describe("Margin between axis labels and chart area in pixels"),
-  fontSize: z17.number().optional().describe("Axis label font size"),
-  fontFamily: z17.string().optional().describe("Axis label font family"),
-  fontWeight: z17.number().optional().describe("Axis label font weight"),
-  color: z17.string().optional().describe("Axis label color (hex)"),
-  axisColor: z17.string().optional().describe("Axis line color (hex)"),
-  axisNameFontConfig: z17.object({
-    fontFamily: z17.string().optional(),
-    fontSize: z17.number().optional(),
-    fontWeight: z17.number().optional()
+var axisSchema = z16.object({
+  hideAxisLines: z16.boolean().optional().describe("Hide axis lines"),
+  hideSplitLines: z16.boolean().optional().describe("Hide grid/split lines"),
+  hideAxisLabels: z16.boolean().optional().describe("Hide axis labels"),
+  hideAxisTicks: z16.boolean().optional().describe("Hide axis tick marks"),
+  axisName: z16.string().optional().describe("Axis title text"),
+  axisNameOffset: z16.number().optional().describe("Axis title offset from axis"),
+  axisLabelMargin: z16.number().optional().describe("Margin between axis labels and chart area in pixels"),
+  fontSize: z16.number().optional().describe("Axis label font size"),
+  fontFamily: z16.string().optional().describe("Axis label font family"),
+  fontWeight: z16.number().optional().describe("Axis label font weight"),
+  color: z16.string().optional().describe("Axis label color (hex)"),
+  axisColor: z16.string().optional().describe("Axis line color (hex)"),
+  axisNameFontConfig: z16.object({
+    fontFamily: z16.string().optional(),
+    fontSize: z16.number().optional(),
+    fontWeight: z16.number().optional()
   }).optional().describe("Axis title font configuration")
 }).optional();
 function buildAdminTheme(p, presetBase) {
@@ -3647,94 +3122,94 @@ function registerCustomizeTheme(server, client) {
     "customize_embed_theme",
     `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: z17.string().describe("ID of the embed to theme"),
-      body: z17.record(z17.unknown()).optional().describe(
+      embedId: z16.string().describe("ID of the embed to theme"),
+      body: z16.record(z16.unknown()).optional().describe(
         "Raw API body for PUT /api/v2/data-app/embeds. If provided, sent directly and all convenience fields are ignored."
       ),
       // --- Presets ---
-      themePreset: z17.enum(["light", "dark", "corporate", "minimal"]).optional().describe("Apply a theme preset as the base. Granular params below override preset values."),
-      accessPreset: z17.enum(["view-only", "power-user", "export-only", "ai-enabled"]).optional().describe("Apply an access settings preset"),
+      themePreset: z16.enum(["light", "dark", "corporate", "minimal"]).optional().describe("Apply a theme preset as the base. Granular params below override preset values."),
+      accessPreset: z16.enum(["view-only", "power-user", "export-only", "ai-enabled"]).optional().describe("Apply an access settings preset"),
       // --- General ---
       fontFamily: fontFamilyEnum.optional().describe("Global font family"),
-      datePickerFormat: z17.string().optional().describe("Date picker display format"),
+      datePickerFormat: z16.string().optional().describe("Date picker display format"),
       // --- Colors ---
-      primaryColor: z17.string().optional().describe("Primary accent color (hex)"),
-      backgroundColor: z17.string().optional().describe("Overall background color (hex)"),
-      textColor: z17.string().optional().describe("Default text color (hex)"),
-      ctaColor: z17.string().optional().describe("Call-to-action button color (hex)"),
-      ctaTextColor: z17.string().optional().describe("CTA button text color (hex)"),
+      primaryColor: z16.string().optional().describe("Primary accent color (hex)"),
+      backgroundColor: z16.string().optional().describe("Overall background color (hex)"),
+      textColor: z16.string().optional().describe("Default text color (hex)"),
+      ctaColor: z16.string().optional().describe("Call-to-action button color (hex)"),
+      ctaTextColor: z16.string().optional().describe("CTA button text color (hex)"),
       // --- Dashboard ---
-      dashboardBackgroundColor: z17.string().optional().describe("Dashboard container background (hex)"),
-      selectBoxSize: z17.enum(["small", "medium", "large"]).optional().describe("Filter select box size"),
-      selectBoxVariant: z17.enum(["floating", "outlined", "standard"]).optional().describe("Filter select box style"),
-      selectBoxBorderRadius: z17.string().optional().describe('Select box border radius (e.g. "20px")'),
-      selectBoxTextColor: z17.string().optional().describe("Select box text color (hex)"),
-      metricCardColor: z17.string().optional().describe("Metric card background color (hex)"),
+      dashboardBackgroundColor: z16.string().optional().describe("Dashboard container background (hex)"),
+      selectBoxSize: z16.enum(["small", "medium", "large"]).optional().describe("Filter select box size"),
+      selectBoxVariant: z16.enum(["floating", "outlined", "standard"]).optional().describe("Filter select box style"),
+      selectBoxBorderRadius: z16.string().optional().describe('Select box border radius (e.g. "20px")'),
+      selectBoxTextColor: z16.string().optional().describe("Select box text color (hex)"),
+      metricCardColor: z16.string().optional().describe("Metric card background color (hex)"),
       // --- Card Title ---
-      cardTitleFontSize: z17.string().optional().describe('Card title font size (e.g. "16px")'),
-      cardTitleFontWeight: z17.string().optional().describe('Card title font weight (e.g. "600")'),
-      cardTitleColor: z17.string().optional().describe("Card title text color (hex)"),
+      cardTitleFontSize: z16.string().optional().describe('Card title font size (e.g. "16px")'),
+      cardTitleFontWeight: z16.string().optional().describe('Card title font weight (e.g. "600")'),
+      cardTitleColor: z16.string().optional().describe("Card title text color (hex)"),
       // --- Card Description ---
-      cardDescriptionFontSize: z17.string().optional().describe("Card description font size"),
-      cardDescriptionFontWeight: z17.string().optional().describe("Card description font weight"),
-      cardDescriptionColor: z17.string().optional().describe("Card description text color (hex)"),
+      cardDescriptionFontSize: z16.string().optional().describe("Card description font size"),
+      cardDescriptionFontWeight: z16.string().optional().describe("Card description font weight"),
+      cardDescriptionColor: z16.string().optional().describe("Card description text color (hex)"),
       // --- Card Customization ---
-      cardPadding: z17.string().optional().describe("Card internal padding"),
-      cardBorderRadius: z17.string().optional().describe("Card border radius"),
-      cardShadow: z17.string().optional().describe("Card box-shadow CSS value"),
-      disableShadowOnHover: z17.boolean().optional().describe("Disable shadow on card hover"),
-      disableCardStroke: z17.boolean().optional().describe("Remove card border stroke"),
-      cardStrokeColor: z17.string().optional().describe("Card border stroke color (hex)"),
+      cardPadding: z16.string().optional().describe("Card internal padding"),
+      cardBorderRadius: z16.string().optional().describe("Card border radius"),
+      cardShadow: z16.string().optional().describe("Card box-shadow CSS value"),
+      disableShadowOnHover: z16.boolean().optional().describe("Disable shadow on card hover"),
+      disableCardStroke: z16.boolean().optional().describe("Remove card border stroke"),
+      cardStrokeColor: z16.string().optional().describe("Card border stroke color (hex)"),
       // --- Chart Colors (admin theme level) ---
-      chartFontFamily: z17.string().optional().describe("Font family for chart text"),
-      chartFontColor: z17.string().optional().describe("Font color for chart text (hex)"),
-      chartColors: z17.array(z17.string()).optional().describe("Array of chart series colors (hex)"),
-      chartPaletteName: z17.string().optional().describe("Name for a custom palette"),
-      chartPaletteColors: z17.array(z17.string()).optional().describe("9 colors for a custom palette"),
+      chartFontFamily: z16.string().optional().describe("Font family for chart text"),
+      chartFontColor: z16.string().optional().describe("Font color for chart text (hex)"),
+      chartColors: z16.array(z16.string()).optional().describe("Array of chart series colors (hex)"),
+      chartPaletteName: z16.string().optional().describe("Name for a custom palette"),
+      chartPaletteColors: z16.array(z16.string()).optional().describe("9 colors for a custom palette"),
       // --- Chart Tooltip (admin theme level) ---
       tooltipHeader: tooltipFontSchema.describe("Tooltip header font config"),
       tooltipLabel: tooltipFontSchema.describe("Tooltip label font config"),
       tooltipValue: tooltipFontSchema.describe("Tooltip value font config"),
       // --- Component Theme ---
-      buttonPrimaryColor: z17.string().optional().describe("Primary button background (hex)"),
-      buttonPrimaryTextColor: z17.string().optional().describe("Primary button text (hex)"),
-      buttonSecondaryColor: z17.string().optional().describe("Secondary button background (hex)"),
-      buttonSecondaryTextColor: z17.string().optional().describe("Secondary button text (hex)"),
-      checkboxCheckedColor: z17.string().optional().describe("Checked checkbox color (hex)"),
-      checkboxUncheckedColor: z17.string().optional().describe("Unchecked checkbox color (hex)"),
-      switchEnabledColor: z17.string().optional().describe("Enabled switch color (hex)"),
-      switchDisabledColor: z17.string().optional().describe("Disabled switch color (hex)"),
-      breadcrumbFontFamily: z17.string().optional().describe("Drill breadcrumb font family"),
-      breadcrumbFontColor: z17.string().optional().describe("Drill breadcrumb font color (hex)"),
-      breadcrumbActiveColor: z17.string().optional().describe("Active breadcrumb color (hex)"),
-      filterBadgeColor: z17.string().optional().describe("Multi-select filter badge color (hex)"),
-      filterBadgeTextColor: z17.string().optional().describe("Filter badge text color (hex)"),
-      datePickerColor: z17.string().optional().describe("Date picker accent color (hex)"),
+      buttonPrimaryColor: z16.string().optional().describe("Primary button background (hex)"),
+      buttonPrimaryTextColor: z16.string().optional().describe("Primary button text (hex)"),
+      buttonSecondaryColor: z16.string().optional().describe("Secondary button background (hex)"),
+      buttonSecondaryTextColor: z16.string().optional().describe("Secondary button text (hex)"),
+      checkboxCheckedColor: z16.string().optional().describe("Checked checkbox color (hex)"),
+      checkboxUncheckedColor: z16.string().optional().describe("Unchecked checkbox color (hex)"),
+      switchEnabledColor: z16.string().optional().describe("Enabled switch color (hex)"),
+      switchDisabledColor: z16.string().optional().describe("Disabled switch color (hex)"),
+      breadcrumbFontFamily: z16.string().optional().describe("Drill breadcrumb font family"),
+      breadcrumbFontColor: z16.string().optional().describe("Drill breadcrumb font color (hex)"),
+      breadcrumbActiveColor: z16.string().optional().describe("Active breadcrumb color (hex)"),
+      filterBadgeColor: z16.string().optional().describe("Multi-select filter badge color (hex)"),
+      filterBadgeTextColor: z16.string().optional().describe("Filter badge text color (hex)"),
+      datePickerColor: z16.string().optional().describe("Date picker accent color (hex)"),
       // --- Responsive Breakpoints ---
-      breakpointXl: z17.number().optional().describe("XL breakpoint width in px"),
-      breakpointLg: z17.number().optional().describe("LG breakpoint width in px"),
-      breakpointMd: z17.number().optional().describe("MD breakpoint width in px"),
-      breakpointSm: z17.number().optional().describe("SM breakpoint width in px"),
-      breakpointXs: z17.number().optional().describe("XS breakpoint width in px"),
+      breakpointXl: z16.number().optional().describe("XL breakpoint width in px"),
+      breakpointLg: z16.number().optional().describe("LG breakpoint width in px"),
+      breakpointMd: z16.number().optional().describe("MD breakpoint width in px"),
+      breakpointSm: z16.number().optional().describe("SM breakpoint width in px"),
+      breakpointXs: z16.number().optional().describe("XS breakpoint width in px"),
       // --- Metric Layout Columns ---
-      layoutColsXl: z17.number().optional().describe("Grid columns at XL breakpoint"),
-      layoutColsLg: z17.number().optional().describe("Grid columns at LG breakpoint"),
-      layoutColsMd: z17.number().optional().describe("Grid columns at MD breakpoint"),
-      layoutColsSm: z17.number().optional().describe("Grid columns at SM breakpoint"),
-      layoutColsXs: z17.number().optional().describe("Grid columns at XS breakpoint"),
-      layoutColsXxs: z17.number().optional().describe("Grid columns at XXS breakpoint"),
+      layoutColsXl: z16.number().optional().describe("Grid columns at XL breakpoint"),
+      layoutColsLg: z16.number().optional().describe("Grid columns at LG breakpoint"),
+      layoutColsMd: z16.number().optional().describe("Grid columns at MD breakpoint"),
+      layoutColsSm: z16.number().optional().describe("Grid columns at SM breakpoint"),
+      layoutColsXs: z16.number().optional().describe("Grid columns at XS breakpoint"),
+      layoutColsXxs: z16.number().optional().describe("Grid columns at XXS breakpoint"),
       // --- Chart Appearance (detailed) ---
       tooltipHeaderStyle: fontConfigInputSchema.describe("Tooltip header: fontSize, fontFamily, fontWeight, color"),
       tooltipLabelStyle: fontConfigInputSchema.describe("Tooltip label: fontSize, fontFamily, fontWeight, color"),
       tooltipValueStyle: fontConfigInputSchema.describe("Tooltip value: fontSize, fontFamily, fontWeight, color"),
-      labelPosition: z17.enum(["hidden", "top", "left", "right", "bottom", "inside"]).optional().describe("Data label position on charts"),
-      radialLabelPosition: z17.enum(["outside", "inside"]).optional().describe("Label position for radial/pie charts"),
-      marginTop: z17.number().optional().describe("Chart top margin in pixels"),
-      marginLeft: z17.number().optional().describe("Chart left margin in pixels"),
-      marginRight: z17.number().optional().describe("Chart right margin in pixels"),
-      marginBottom: z17.number().optional().describe("Chart bottom margin in pixels"),
-      legendShow: z17.boolean().optional().describe("Show or hide chart legend"),
-      legendPosition: z17.enum([
+      labelPosition: z16.enum(["hidden", "top", "left", "right", "bottom", "inside"]).optional().describe("Data label position on charts"),
+      radialLabelPosition: z16.enum(["outside", "inside"]).optional().describe("Label position for radial/pie charts"),
+      marginTop: z16.number().optional().describe("Chart top margin in pixels"),
+      marginLeft: z16.number().optional().describe("Chart left margin in pixels"),
+      marginRight: z16.number().optional().describe("Chart right margin in pixels"),
+      marginBottom: z16.number().optional().describe("Chart bottom margin in pixels"),
+      legendShow: z16.boolean().optional().describe("Show or hide chart legend"),
+      legendPosition: z16.enum([
         "top-left",
         "top-center",
         "top-right",
@@ -3744,17 +3219,17 @@ function registerCustomizeTheme(server, client) {
         "bottom-center",
         "bottom-right"
       ]).optional().describe("Legend position"),
-      legendLayout: z17.enum(["horizontal", "vertical"]).optional().describe("Legend layout direction"),
-      legendShape: z17.enum(["circle", "rect", "roundRect", "triangle", "diamond", "arrow", "none"]).optional().describe("Legend icon shape"),
-      legendFontSize: z17.number().optional().describe("Legend font size"),
-      legendFontWeight: z17.number().optional().describe("Legend font weight"),
-      legendFontFamily: z17.string().optional().describe("Legend font family"),
-      legendColor: z17.string().optional().describe("Legend text color (hex)"),
-      legendTruncateLength: z17.number().optional().describe("Max characters before truncating legend"),
-      disableLegendScrolling: z17.boolean().optional().describe("Disable scrolling in legend"),
-      enableVariableLegendPosition: z17.boolean().optional().describe("Allow user to drag legend"),
-      legendTop: z17.number().optional().describe("Custom legend top offset"),
-      legendLeft: z17.number().optional().describe("Custom legend left offset"),
+      legendLayout: z16.enum(["horizontal", "vertical"]).optional().describe("Legend layout direction"),
+      legendShape: z16.enum(["circle", "rect", "roundRect", "triangle", "diamond", "arrow", "none"]).optional().describe("Legend icon shape"),
+      legendFontSize: z16.number().optional().describe("Legend font size"),
+      legendFontWeight: z16.number().optional().describe("Legend font weight"),
+      legendFontFamily: z16.string().optional().describe("Legend font family"),
+      legendColor: z16.string().optional().describe("Legend text color (hex)"),
+      legendTruncateLength: z16.number().optional().describe("Max characters before truncating legend"),
+      disableLegendScrolling: z16.boolean().optional().describe("Disable scrolling in legend"),
+      enableVariableLegendPosition: z16.boolean().optional().describe("Allow user to drag legend"),
+      legendTop: z16.number().optional().describe("Custom legend top offset"),
+      legendLeft: z16.number().optional().describe("Custom legend left offset"),
       verticalAxis: axisSchema.describe("Vertical (Y) axis configuration"),
       horizontalAxis: axisSchema.describe("Horizontal (X) axis configuration")
     },
@@ -3829,7 +3304,7 @@ Use \`get_embed_details\` to view the full current theme configuration.` + GUEST
 }
 
 // src/tools/embed/get-demo-link.ts
-import { z as z18 } from "zod";
+import { z as z17 } from "zod";
 var HOUR_MS = 60 * 60 * 1e3;
 var DEFAULT_EXPIRY_HOURS = 24;
 var MAX_EXPIRY_HOURS = 24 * 30;
@@ -3839,11 +3314,11 @@ function registerGetDemoLink(server, client) {
     "get_demo_link",
     `Get a shareable demo URL for a dashboard embed scoped to a specific clientId \u2014 same link the UI's "Share Demo Link" generates. Loads the dashboard as that end-customer sees it. Use to verify ops-built widgets without a test app.`,
     {
-      clientId: z18.string().describe("End-customer identifier to scope the preview to."),
-      dashboardName: z18.string().optional().describe("Dashboard name (non-technical). Preferred \u2014 pass with optional `workspaceName`."),
-      workspaceName: z18.string().optional().describe("Workspace name. Only needed if `dashboardName` is ambiguous."),
-      embedId: z18.string().optional().describe("Technical alternative to `dashboardName`."),
-      expiryHours: z18.number().min(1).max(MAX_EXPIRY_HOURS).optional().describe(`Token TTL in hours. Defaults to ${DEFAULT_EXPIRY_HOURS}. Max ${MAX_EXPIRY_HOURS} (30 days).`)
+      clientId: z17.string().describe("End-customer identifier to scope the preview to."),
+      dashboardName: z17.string().optional().describe("Dashboard name (non-technical). Preferred \u2014 pass with optional `workspaceName`."),
+      workspaceName: z17.string().optional().describe("Workspace name. Only needed if `dashboardName` is ambiguous."),
+      embedId: z17.string().optional().describe("Technical alternative to `dashboardName`."),
+      expiryHours: z17.number().min(1).max(MAX_EXPIRY_HOURS).optional().describe(`Token TTL in hours. Defaults to ${DEFAULT_EXPIRY_HOURS}. Max ${MAX_EXPIRY_HOURS} (30 days).`)
     },
     WRITE_CREATE,
     async (params) => {
@@ -3899,70 +3374,70 @@ function registerGetDemoLink(server, client) {
 }
 
 // src/tools/frontend/generate-guest-token.ts
-import { z as z19 } from "zod";
+import { z as z18 } from "zod";
 function registerGenerateGuestToken(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "generate_guest_token",
     "Generate a guest token for frontend embedding. Requires clientId. Omit dataAppName to auto-resolve.",
     {
-      clientId: z19.string().describe('Unique end-user identifier for multi-tenant filtering. Use "None" if no tenancy.'),
-      dataAppName: z19.string().optional().describe("Name of the data app. Omit to list available data apps."),
-      body: z19.record(z19.unknown()).optional().describe(
+      clientId: z18.string().describe('Unique end-user identifier for multi-tenant filtering. Use "None" if no tenancy.'),
+      dataAppName: z18.string().optional().describe("Name of the data app. Omit to list available data apps."),
+      body: z18.record(z18.unknown()).optional().describe(
         "Raw API body for POST /api/v2/guest-token/create. If provided, sent directly and convenience fields are ignored."
       ),
-      params: z19.object({
-        allowedEmbeds: z19.array(z19.string()).optional().describe("Restrict token to specific embed IDs"),
-        rlsSettings: z19.array(z19.object({
-          metricId: z19.string().describe("Metric ID"),
-          values: z19.record(z19.unknown()).describe("RLS values by column name")
+      params: z18.object({
+        allowedEmbeds: z18.array(z18.string()).optional().describe("Restrict token to specific embed IDs"),
+        rlsSettings: z18.array(z18.object({
+          metricId: z18.string().describe("Metric ID"),
+          values: z18.record(z18.unknown()).describe("RLS values by column name")
         })).optional().describe("Legacy alias used in docs/examples; forwarded as params.rlsSettings"),
-        appFilters: z19.array(z19.object({
-          metricId: z19.string().describe("Metric ID"),
-          values: z19.record(z19.unknown()).describe("Filter values by column name")
+        appFilters: z18.array(z18.object({
+          metricId: z18.string().describe("Metric ID"),
+          values: z18.record(z18.unknown()).describe("Filter values by column name")
         })).optional().describe("Metric-level app filters"),
-        dashboardAppFilters: z19.array(z19.object({
-          dashboardId: z19.string().describe("Dashboard ID"),
-          values: z19.record(z19.unknown()).describe("Filter values by dashboard filter name"),
-          isShowOnUrl: z19.boolean().optional().describe("Whether filters are shown in URL params")
+        dashboardAppFilters: z18.array(z18.object({
+          dashboardId: z18.string().describe("Dashboard ID"),
+          values: z18.record(z18.unknown()).describe("Filter values by dashboard filter name"),
+          isShowOnUrl: z18.boolean().optional().describe("Whether filters are shown in URL params")
         })).optional().describe("Dashboard-level app filters"),
-        hideDashboardFilters: z19.array(z19.string()).optional().describe("Dashboard filter names to hide"),
-        userIdentifier: z19.string().optional().describe("End-user identifier for private metrics support"),
-        timezone: z19.string().optional().describe('IANA timezone, e.g. "America/New_York"')
+        hideDashboardFilters: z18.array(z18.string()).optional().describe("Dashboard filter names to hide"),
+        userIdentifier: z18.string().optional().describe("End-user identifier for private metrics support"),
+        timezone: z18.string().optional().describe('IANA timezone, e.g. "America/New_York"')
       }).optional().describe("Advanced token params"),
       // Legacy convenience fields (auto-mapped into params for backward compatibility)
-      timezone: z19.string().optional().describe("Legacy: moved under params.timezone"),
-      allowedEmbeds: z19.array(z19.string()).optional().describe("Legacy: moved under params.allowedEmbeds"),
-      rlsSettings: z19.array(z19.object({
-        metricId: z19.string().describe("Metric ID"),
-        values: z19.record(z19.unknown()).describe("RLS values by column name")
+      timezone: z18.string().optional().describe("Legacy: moved under params.timezone"),
+      allowedEmbeds: z18.array(z18.string()).optional().describe("Legacy: moved under params.allowedEmbeds"),
+      rlsSettings: z18.array(z18.object({
+        metricId: z18.string().describe("Metric ID"),
+        values: z18.record(z18.unknown()).describe("RLS values by column name")
       })).optional().describe("Legacy: moved under params.rlsSettings"),
-      appFilters: z19.array(z19.object({
-        metricId: z19.string().describe("Metric ID"),
-        values: z19.record(z19.unknown()).describe("Filter values by column name")
+      appFilters: z18.array(z18.object({
+        metricId: z18.string().describe("Metric ID"),
+        values: z18.record(z18.unknown()).describe("Filter values by column name")
       })).optional().describe("Legacy: moved under params.appFilters"),
-      dashboardAppFilters: z19.array(z19.object({
-        dashboardId: z19.string().describe("Dashboard ID to apply filters to"),
-        values: z19.record(z19.unknown()).describe("Filter values for this dashboard"),
-        isShowOnUrl: z19.boolean().optional().describe("Whether filters are shown in URL params")
+      dashboardAppFilters: z18.array(z18.object({
+        dashboardId: z18.string().describe("Dashboard ID to apply filters to"),
+        values: z18.record(z18.unknown()).describe("Filter values for this dashboard"),
+        isShowOnUrl: z18.boolean().optional().describe("Whether filters are shown in URL params")
       })).optional().describe("Legacy: moved under params.dashboardAppFilters"),
-      permissions: z19.object({
-        isEnableArchiveMetrics: z19.boolean().optional(),
-        isEnableManageMetrics: z19.boolean().optional(),
-        isEnableCreateDashboardView: z19.boolean().optional(),
-        isEnableMetricUpdation: z19.boolean().optional(),
-        isEnableCustomizeLayout: z19.boolean().optional(),
-        isEnableUnderlyingData: z19.boolean().optional(),
-        isEnableDownloadMetrics: z19.boolean().optional(),
-        isShowSideBar: z19.boolean().optional(),
-        isShowDashboardName: z19.boolean().optional(),
-        isDisableMetricCreation: z19.boolean().optional()
+      permissions: z18.object({
+        isEnableArchiveMetrics: z18.boolean().optional(),
+        isEnableManageMetrics: z18.boolean().optional(),
+        isEnableCreateDashboardView: z18.boolean().optional(),
+        isEnableMetricUpdation: z18.boolean().optional(),
+        isEnableCustomizeLayout: z18.boolean().optional(),
+        isEnableUnderlyingData: z18.boolean().optional(),
+        isEnableDownloadMetrics: z18.boolean().optional(),
+        isShowSideBar: z18.boolean().optional(),
+        isShowDashboardName: z18.boolean().optional(),
+        isDisableMetricCreation: z18.boolean().optional()
       }).optional().describe("Runtime permission overrides (merge with and override embed-level settings)"),
-      theme: z19.record(z19.unknown()).optional().describe("Runtime theme overrides (overrides embed-level theme)"),
-      hideDashboardFilters: z19.array(z19.string()).optional().describe("Legacy: moved under params.hideDashboardFilters"),
-      userIdentifier: z19.string().optional().describe("Legacy: moved under params.userIdentifier"),
-      expiryTime: z19.number().optional().describe("Token TTL in milliseconds"),
-      datasourceName: z19.string().optional().describe("Datasource name for multi-datasource routing")
+      theme: z18.record(z18.unknown()).optional().describe("Runtime theme overrides (overrides embed-level theme)"),
+      hideDashboardFilters: z18.array(z18.string()).optional().describe("Legacy: moved under params.hideDashboardFilters"),
+      userIdentifier: z18.string().optional().describe("Legacy: moved under params.userIdentifier"),
+      expiryTime: z18.number().optional().describe("Token TTL in milliseconds"),
+      datasourceName: z18.string().optional().describe("Datasource name for multi-datasource routing")
     },
     WRITE_CREATE,
     async (params) => {
@@ -4015,7 +3490,7 @@ Next step: Use \`generate_embed_code\` to get copy-paste-ready frontend code.`
 }
 
 // src/tools/frontend/generate-embed-code.ts
-import { z as z20 } from "zod";
+import { z as z19 } from "zod";
 
 // src/templates/react.ts
 function kebabCase(str) {
@@ -5011,22 +4486,22 @@ function registerGenerateEmbedCode(server, _client) {
     "generate_embed_code",
     "Generate framework-specific embed code (React, Next.js, Vue, Angular, Svelte, SolidJS, vanilla HTML).",
     {
-      embedId: z20.string().describe("The embed ID to generate code for"),
-      framework: z20.enum(FRAMEWORKS).describe("Frontend framework"),
-      embedType: z20.enum(["dashboard", "metric"]).optional().default("dashboard"),
-      options: z20.object({
-        enableDownloadCsv: z20.boolean().optional(),
-        enableEmailCsv: z20.boolean().optional(),
-        enableDownloadAllMetrics: z20.boolean().optional(),
-        enableDownloadAllPdf: z20.boolean().optional(),
-        disableFullscreen: z20.boolean().optional(),
-        isHideTablePreview: z20.boolean().optional(),
-        isHideChartSettings: z20.boolean().optional(),
-        isStickyDashboardFilters: z20.boolean().optional(),
-        enableMultiMetricFilters: z20.boolean().optional(),
-        themeName: z20.string().optional(),
-        customTheme: z20.record(z20.unknown()).optional(),
-        optionsIcon: z20.enum(["kebab-menu-vertical", "download"]).optional()
+      embedId: z19.string().describe("The embed ID to generate code for"),
+      framework: z19.enum(FRAMEWORKS).describe("Frontend framework"),
+      embedType: z19.enum(["dashboard", "metric"]).optional().default("dashboard"),
+      options: z19.object({
+        enableDownloadCsv: z19.boolean().optional(),
+        enableEmailCsv: z19.boolean().optional(),
+        enableDownloadAllMetrics: z19.boolean().optional(),
+        enableDownloadAllPdf: z19.boolean().optional(),
+        disableFullscreen: z19.boolean().optional(),
+        isHideTablePreview: z19.boolean().optional(),
+        isHideChartSettings: z19.boolean().optional(),
+        isStickyDashboardFilters: z19.boolean().optional(),
+        enableMultiMetricFilters: z19.boolean().optional(),
+        themeName: z19.string().optional(),
+        customTheme: z19.record(z19.unknown()).optional(),
+        optionsIcon: z19.enum(["kebab-menu-vertical", "download"]).optional()
       }).optional()
     },
     READ_ONLY,
@@ -5066,17 +4541,17 @@ ${generated.instructions}`;
 }
 
 // src/tools/analytics/list-dashboards.ts
-import { z as z21 } from "zod";
+import { z as z20 } from "zod";
 function registerListDashboards(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "list_dashboards",
     "List dashboards globally or for a specific data app.",
     {
-      scope: z21.enum(["auto", "global", "data_app"]).optional().describe(
+      scope: z20.enum(["auto", "global", "data_app"]).optional().describe(
         "Dashboard listing scope. auto: use data_app when dataAppName + API token are available, otherwise global."
       ),
-      dataAppName: z21.string().optional().describe("Data app name for data_app scope. Ignored for global scope.")
+      dataAppName: z20.string().optional().describe("Data app name for data_app scope. Ignored for global scope.")
     },
     READ_ONLY,
     async (params) => {
@@ -5111,36 +4586,36 @@ function registerListDashboards(server, client) {
 }
 
 // src/tools/dashboard/schema.ts
-import { z as z22 } from "zod";
-var dashboardPositionSchema = z22.object({
-  x: z22.number().int().min(0).max(23),
-  y: z22.number().int().min(0),
-  w: z22.number().int().min(1).max(24),
-  h: z22.number().int().min(1).max(40)
+import { z as z21 } from "zod";
+var dashboardPositionSchema = z21.object({
+  x: z21.number().int().min(0).max(23),
+  y: z21.number().int().min(0),
+  w: z21.number().int().min(1).max(24),
+  h: z21.number().int().min(1).max(40)
 }).strict();
-var dashboardChartSchema = z22.object({
-  type: z22.string(),
-  metricRef: z22.string().optional(),
-  query: z22.string().optional(),
-  companyIntegrationId: z22.string().optional(),
-  chartOptions: z22.record(z22.unknown()).optional()
+var dashboardChartSchema = z21.object({
+  type: z21.string(),
+  metricRef: z21.string().optional(),
+  query: z21.string().optional(),
+  companyIntegrationId: z21.string().optional(),
+  chartOptions: z21.record(z21.unknown()).optional()
 }).passthrough();
-var dashboardTileSchema = z22.object({
-  id: z22.string().regex(/^[a-z0-9][a-z0-9-]{0,62}$/),
-  kind: z22.literal("databrain-chart"),
+var dashboardTileSchema = z21.object({
+  id: z21.string().regex(/^[a-z0-9][a-z0-9-]{0,62}$/),
+  kind: z21.literal("databrain-chart"),
   position: dashboardPositionSchema,
-  title: z22.string().min(1).max(200),
+  title: z21.string().min(1).max(200),
   chart: dashboardChartSchema.optional()
 }).strict();
 var dashboardDocumentShape = {
-  schemaVersion: z22.literal(1),
-  title: z22.string().min(1).max(200),
-  description: z22.string().max(2e3).optional(),
-  layout: z22.object({ columns: z22.union([z22.literal(12), z22.literal(24)]).default(24) }).strict().optional(),
-  tiles: z22.array(dashboardTileSchema).min(1).max(50)
+  schemaVersion: z21.literal(1),
+  title: z21.string().min(1).max(200),
+  description: z21.string().max(2e3).optional(),
+  layout: z21.object({ columns: z21.union([z21.literal(12), z21.literal(24)]).default(24) }).strict().optional(),
+  tiles: z21.array(dashboardTileSchema).min(1).max(50)
 };
-var workspaceNameSchema = z22.string().min(1).describe("Target workspace name");
-var idempotencyKeySchema = z22.string().regex(
+var workspaceNameSchema = z21.string().min(1).describe("Target workspace name");
+var idempotencyKeySchema = z21.string().regex(
   /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
   "idempotencyKey must be a UUID v4"
 ).describe("UUID v4 unique to this workspace dashboard create request");
@@ -5193,7 +4668,7 @@ ${stringify(validation)}`
 }
 
 // src/tools/dashboard/generate-dashboard-tiles.ts
-import { z as z23 } from "zod";
+import { z as z22 } from "zod";
 function registerGenerateDashboardTiles(server, client) {
   const services = createServiceBundle(client);
   server.tool(
@@ -5201,15 +4676,15 @@ function registerGenerateDashboardTiles(server, client) {
     "Generate multiple workspace dashboard tile drafts without persisting them.",
     {
       workspaceName: workspaceNameSchema,
-      dataAppName: z23.string().optional().describe("Data app in the workspace; auto-resolved when unique"),
-      integrationId: z23.string().optional().describe("Datasource UUID override"),
-      integrationName: z23.string().optional().describe("Datasource name override"),
-      tiles: z23.array(
-        z23.object({
-          id: z23.string().regex(/^[a-z0-9][a-z0-9-]{0,62}$/),
-          title: z23.string().min(1).max(200),
+      dataAppName: z22.string().optional().describe("Data app in the workspace; auto-resolved when unique"),
+      integrationId: z22.string().optional().describe("Datasource UUID override"),
+      integrationName: z22.string().optional().describe("Datasource name override"),
+      tiles: z22.array(
+        z22.object({
+          id: z22.string().regex(/^[a-z0-9][a-z0-9-]{0,62}$/),
+          title: z22.string().min(1).max(200),
           position: dashboardPositionSchema,
-          userInputs: z23.record(z23.unknown())
+          userInputs: z22.record(z22.unknown())
         }).strict()
       ).min(1).max(50)
     },
@@ -5293,14 +4768,14 @@ function registerGenerateDashboardTiles(server, client) {
 }
 
 // src/tools/dashboard/get-dashboard.ts
-import { z as z24 } from "zod";
+import { z as z23 } from "zod";
 function registerGetDashboard(server, client) {
   server.tool(
     "get_dashboard",
     "Retrieve a workspace dashboard projected back into the versioned tile-list contract.",
     {
       workspaceName: workspaceNameSchema,
-      dashboardId: z24.string().min(1).describe("Dashboard identifier returned by create_dashboard")
+      dashboardId: z23.string().min(1).describe("Dashboard identifier returned by create_dashboard")
     },
     READ_ONLY,
     async (params) => {
@@ -5323,8 +4798,174 @@ function registerGetDashboard(server, client) {
   );
 }
 
+// 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(),
+  /** Workspaces built on this datamart. One means Save needs no choice. */
+  workspaces: z24.array(z24.string().max(256)).max(50).default([])
+}).strict();
+var PREVIEW_PATH = "/api/v2/data-app/chart-preview";
+var METRIC_PATH = "/api/mcp/metrics/create";
+var DASHBOARD_PATH = "/api/v2/workspace/dashboard";
+var PREVIEW_TYPES = ["bar", "row", "line", "area", "pie", "doughnut", "table"];
+var RENDER_TYPES = [...PREVIEW_TYPES, "single value"];
+async function previewPage(client, draft, rows, chartType) {
+  const page = await client.request({
+    method: "POST",
+    path: PREVIEW_PATH,
+    auth: "service",
+    skipDataUnwrap: true,
+    body: {
+      rows: firstRows(rows),
+      chartType,
+      title: draft.title,
+      dimensions: draft.dimensions,
+      measures: draft.measures,
+      width: 600,
+      height: 320
+    }
+  });
+  return pageSchema.parse(page);
+}
+function tablePage(draft, rows) {
+  const page = firstRows(rows);
+  return {
+    kind: "table",
+    title: draft.title,
+    chartSpec: { type: "table" },
+    rows: page,
+    columns: Object.keys(page[0] ?? {})
+  };
+}
+async function draftPage(client, draft, rows, chartType) {
+  const data = rowsSchema.parse(firstRows(rows));
+  const carry = { draft: { ...draft, chartType }, previewTypes: PREVIEW_TYPES };
+  if (chartType === "table" || !data.length) return { ...tablePage(draft, data), ...carry };
+  try {
+    return { ...await previewPage(client, draft, data, chartType), ...carry };
+  } catch (error) {
+    const previewError = error instanceof DatabrainApiError ? error.code : "PREVIEW_UNAVAILABLE";
+    return { ...tablePage(draft, data), ...carry, draft: { ...draft, chartType: "table" }, previewError };
+  }
+}
+var sameName = (a, b) => typeof a === "string" && a.trim().toLowerCase() === b.trim().toLowerCase();
+async function workspacesForDatamart(client, datamartName, mode = "hint") {
+  const cached = (key) => mode === "hint" ? { cacheKey: key, cacheTtlMs: 5 * 60 * 1e3 } : {};
+  try {
+    const [workspaces, datamarts] = await Promise.all([
+      client.request({ method: "GET", path: "/api/v2/workspace", auth: "service", ...cached("list_workspaces") }),
+      client.request({ method: "GET", path: "/api/v2/data-app/datamarts", auth: "service", ...cached("list_datamarts") })
+    ]);
+    const datasource = (Array.isArray(datamarts) ? datamarts : []).find((d) => sameName(d?.name ?? d?.datamartName, datamartName))?.companyIntegration?.id;
+    const all = (Array.isArray(workspaces) ? workspaces : []).filter((w) => typeof w?.name === "string");
+    const onDatamart = all.filter((w) => sameName(w.datamart?.name ?? w.datamartName, datamartName));
+    const onDatasource = datasource ? all.filter((w) => !w.datamart && w.companyIntegration?.id === datasource) : [];
+    return [...new Set([...onDatamart, ...onDatasource].map((w) => w.name))];
+  } catch {
+    return [];
+  }
+}
+function saveKey(draft, input) {
+  const h = createHash("sha256").update(JSON.stringify({
+    sql: draft.sql,
+    datamartName: draft.datamartName,
+    workspaceName: input.workspaceName,
+    dashboardTitle: input.dashboardTitle,
+    chartType: input.chartType,
+    // One attempt, many retries: the tile mints an id when the form opens and re-sends it on
+    // retry, so a retry replays and a fresh Save is a fresh key. Without one, content is the key.
+    attemptId: input.attemptId ?? null
+  })).digest();
+  h[6] = h[6] & 15 | 64;
+  h[8] = h[8] & 63 | 128;
+  const x = h.subarray(0, 16).toString("hex");
+  return `${x.slice(0, 8)}-${x.slice(8, 12)}-${x.slice(12, 16)}-${x.slice(16, 20)}-${x.slice(20, 32)}`;
+}
+async function saveDraftAsDashboard(client, draft, input) {
+  const metric = await client.request({
+    method: "POST",
+    path: METRIC_PATH,
+    auth: "service",
+    body: {
+      workspaceName: input.workspaceName,
+      name: input.dashboardTitle,
+      query: draft.sql,
+      description: draft.question,
+      isPublished: false,
+      validateOnly: false
+    }
+  });
+  const metricId = metric?.metricId || metric?.id;
+  if (!metricId) throw new DatabrainApiError(502, "METRIC_ID_MISSING", "The metric was created but returned no id.");
+  const slug = input.dashboardTitle.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 63) || "chart";
+  const body = {
+    schemaVersion: 1,
+    title: input.dashboardTitle,
+    description: draft.question,
+    layout: { columns: 24 },
+    tiles: [{
+      id: slug,
+      kind: "databrain-chart",
+      title: input.dashboardTitle,
+      position: { x: 0, y: 0, w: 12, h: 8 },
+      chart: { type: input.chartType, metricRef: metricId }
+    }]
+  };
+  const dashboard = await client.request({
+    method: "POST",
+    path: DASHBOARD_PATH,
+    auth: "service",
+    query: { workspaceName: input.workspaceName },
+    headers: { "Idempotency-Key": saveKey(draft, input) },
+    body,
+    invalidateCache: ["list_dashboards"],
+    // A metadata insert: 15s keeps the attempt and its retries inside the host's 60s window.
+    timeoutMs: 15e3
+  });
+  if (!dashboard?.dashboardId) {
+    throw new DatabrainApiError(502, "DASHBOARD_ID_MISSING", `Metric ${metricId} was saved but the dashboard returned no id.`);
+  }
+  return { dashboardId: dashboard.dashboardId, metricId, workspaceName: input.workspaceName, title: input.dashboardTitle };
+}
+
 // src/tools/query/ask-question.ts
 import { z as z25 } from "zod";
+
+// src/tools/query/answer-format.ts
+function formatConfidence(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return null;
+  const percent = value > 1 ? value : value * 100;
+  return `${Math.round(Math.min(Math.max(percent, 0), 100))}%`;
+}
+function formatProse(value) {
+  if (Array.isArray(value)) {
+    const items = value.filter((item) => typeof item === "string" && item.trim() !== "").map((item) => `- ${item.trim()}`);
+    return items.length ? items.join("\n") : null;
+  }
+  if (typeof value === "string" && value.trim() !== "") return value.trim();
+  return null;
+}
+
+// src/tools/query/ask-question.ts
+function normalizePreviewType(type) {
+  const t = (type || "").toLowerCase().trim();
+  if (RENDER_TYPES.includes(t)) return t;
+  if (t === "single value" || t === "kpi" || t === "number") return "single value";
+  if (t === "time series" || t === "stepped") return "line";
+  if (t === "stack" || t === "column") return "bar";
+  if (t === "horizontal stack" || t === "horizontal bar") return "row";
+  if (t === "stacked area") return "area";
+  return "table";
+}
 var MAX_DISPLAY_ROWS = 50;
 function formatDataTable(data, columns) {
   if (!Array.isArray(data) || data.length === 0) return "_No data returned._";
@@ -5468,15 +5109,22 @@ You can verify with \`get_semantic_layer\` using datamartName "${datamartName}".
         });
         const data = Array.isArray(result.data) ? result.data : [];
         if (hasChartApps(server)) {
+          const chartType = normalizePreviewType(result.suggestedChartType);
+          const draft = {
+            question: params.question,
+            sql: result.query || "",
+            datamartName,
+            dimensions: result.columns?.dimensions || [],
+            measures: result.columns?.measures || [],
+            chartType,
+            title: params.question.slice(0, 200),
+            sessionId: result.sessionId || void 0,
+            workspaces: await workspacesForDatamart(client, datamartName)
+          };
           const rows = firstRows(data);
-          return chartResult(`Query Results: ${data.length} rows returned; showing the first ${rows.length}.`, {
-            kind: "table",
-            title: "Query results",
-            chartSpec: { type: result.suggestedChartType || "table" },
-            rows,
-            columns: Object.keys(rows[0] ?? {}),
-            description: "Showing the first page. Interactive chart preview is not available for this query yet."
-          });
+          const page = draft.sql ? await draftPage(client, draft, rows, chartType) : { ...tablePage(draft, rows), previewTypes: [] };
+          const shown = rows.length === data.length ? `${data.length} rows` : `first ${rows.length} of ${data.length} rows`;
+          return chartResult(`${page.kind === "table" ? "Table" : "Chart"} ready (${page.chartSpec && page.chartSpec.type}): ${shown}.` + (result.summary ? ` ${result.summary}` : ""), { ...page, rowsTotal: data.length });
         }
         const table = formatDataTable(data, result.columns);
         const parts = [];
@@ -5488,23 +5136,24 @@ You can verify with \`get_semantic_layer\` using datamartName "${datamartName}".
         parts.push(
           `**Suggested chart type:** ${result.suggestedChartType}`
         );
-        if (result.confidence !== null) {
-          parts.push(
-            `**Confidence:** ${Math.round(result.confidence * 100)}%`
-          );
+        const confidence = formatConfidence(result.confidence);
+        if (confidence) {
+          parts.push(`**Confidence:** ${confidence}`);
         }
         parts.push(
           `**Rows returned:** ${data.length} | **Time:** ${result.timeTaken}ms`
         );
-        if (result.reasoning) {
+        const reasoning = formatProse(result.reasoning);
+        if (reasoning) {
           parts.push(`
 ### Reasoning
-${result.reasoning}`);
+${reasoning}`);
         }
-        if (result.summary) {
+        const summary = formatProse(result.summary);
+        if (summary) {
           parts.push(`
 ### Summary
-${result.summary}`);
+${summary}`);
         }
         parts.push(`
 ### Data
@@ -5687,10 +5336,17 @@ var columnSchema2 = z27.object({
     "Identifier",
     "Number",
     "JSON"
-  ]).nullable().optional().describe('Semantic column type. Use "Identifier" for IDs/foreign keys, "Number" for numeric values, "String" for text. Omit for date and boolean columns.')
+  ]).nullable().optional().describe('Semantic column type. Use "Identifier" for IDs/foreign keys, "Number" for numeric values, "String" for text. Omit for date and boolean columns.'),
+  // 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: z27.union([z27.record(z27.string(), z27.string()), z27.string(), z27.object({ lowerLimit: z27.number(), upperLimit: z27.number() }), z27.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: z27.boolean().optional().describe("Mark the column as an identifier (primary or foreign key)."),
+  isNotIndexed: z27.boolean().optional().describe("Exclude the column from AI indexing.")
 });
 var tableSchema2 = z27.object({
   name: z27.string().describe("Table name (must exist in the datamart)"),
+  schemaName: z27.string().optional().describe("Schema the table lives in, when the datamart has the same table name in more than one schema."),
   description: z27.string().optional().describe(
     "Business-friendly description of what this table represents"
   ),
@@ -5730,6 +5386,7 @@ function normalizeTablesForApi(tables, datatypesByColumn) {
   if (!tables) return void 0;
   return tables.map((table) => {
     const normalized = { name: table.name };
+    if (table.schemaName !== void 0) normalized.schemaName = table.schemaName;
     if (table.description !== void 0) normalized.description = table.description;
     if (table.synonyms !== void 0) normalized.synonyms = table.synonyms;
     if (table.miscellaneousInfo !== void 0) {
@@ -5753,6 +5410,15 @@ function normalizeTablesForApi(tables, datatypesByColumn) {
             normalizedColumn.columnType = column.columnType;
           }
         }
+        if (column.columnTypeConfig !== void 0) {
+          normalizedColumn.columnTypeConfig = column.columnTypeConfig;
+        }
+        if (column.isIdentifier !== void 0) {
+          normalizedColumn.isIdentifier = column.isIdentifier;
+        }
+        if (column.isNotIndexed !== void 0) {
+          normalizedColumn.isNotIndexed = column.isNotIndexed;
+        }
         return normalizedColumn;
       });
     }
@@ -5890,35 +5556,6 @@ async function resolveDatamartFromWorkspace(params) {
     workspaceName: resolution.name
   };
 }
-async function findDatamartIdInLinkedWorkspaces(params) {
-  const services = createServiceBundle(params.client);
-  const workspaces = await services.workspacesApi.listWorkspaces();
-  const matches = workspaces.map((workspace) => {
-    const record = workspace;
-    return {
-      name: nonEmptyString(record.name),
-      datamartName: workspaceDatamartNameFrom(record),
-      datamartId: workspaceDatamartIdFrom(record)
-    };
-  }).filter(
-    (workspace) => workspace.datamartName?.toLowerCase() === params.datamartName.toLowerCase() && workspace.datamartId
-  );
-  const uniqueIds = [...new Set(matches.map((workspace) => workspace.datamartId))];
-  if (uniqueIds.length === 1 && uniqueIds[0]) {
-    return {
-      kind: "resolved",
-      datamartId: uniqueIds[0],
-      workspaceName: matches.find((workspace) => workspace.datamartId === uniqueIds[0])?.name || void 0
-    };
-  }
-  if (uniqueIds.length > 1) {
-    return {
-      kind: "ambiguous",
-      workspaceNames: matches.map((workspace) => workspace.name).filter((name) => !!name)
-    };
-  }
-  return { kind: "none" };
-}
 async function resolveDatamart(params) {
   if (params.datamartId) {
     return {
@@ -5949,30 +5586,10 @@ async function resolveDatamart(params) {
   if (resolution.kind !== "resolved") return { ok: false, response: resolution.response };
   const datamartId = datamartIdFrom(resolution.selected);
   if (!datamartId) {
-    const workspaceMatch = await findDatamartIdInLinkedWorkspaces({
-      client: params.client,
-      datamartName: resolution.name
-    });
-    if (workspaceMatch.kind === "resolved") {
-      return {
-        ok: true,
-        datamartName: resolution.name,
-        datamartId: workspaceMatch.datamartId,
-        workspaceName: workspaceMatch.workspaceName
-      };
-    }
-    if (workspaceMatch.kind === "ambiguous") {
-      return {
-        ok: false,
-        response: toolError(
-          `Datamart "${resolution.name}" is linked from multiple workspaces with different IDs. Call ${params.toolName} again with workspaceName. Matching workspaces: ${workspaceMatch.workspaceNames.join(", ")}`
-        )
-      };
-    }
     return {
       ok: false,
       response: toolError(
-        `Datamart "${resolution.name}" resolved by name but no id/_id/datamartId/dataMartId was returned and no linked workspace exposed its ID. Pass workspaceName for a workspace linked to this datamart, pass datamartId directly, or update the datamart list API to include IDs.`
+        `Datamart "${resolution.name}" did not include an ID in the datamart list. Refresh the list and try again, or pass datamartId directly.`
       )
     };
   }
@@ -7064,6 +6681,400 @@ function registerWhoami(server, client) {
   );
 }
 
+// src/tools/custom-chart/scaffold.ts
+import { z as z39 } from "zod";
+
+// src/tools/custom-chart/shared.ts
+import { z as z38 } from "zod";
+var slotInputSchema = slotSchema;
+var optionInputSchema = optionSchema;
+var manifestInputSchema = z38.record(z38.unknown()).describe("manifest.json as an object (schemaVersion 2). Validated with the same rules as the server.");
+var bundleInputShape = {
+  manifest: manifestInputSchema.optional(),
+  bundleJs: z38.string().optional().describe("dist/index.js from `databrain custom-chart build` (the shim plus the chart module)."),
+  bundleCss: z38.string().optional().describe("The raw chart.css, kept for provenance."),
+  iconSvg: z38.string().optional().describe("icon.svg, at most 16 KiB, no script, no foreignObject, no external href."),
+  projectDir: z38.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.";
+  return problems.map((p) => `${p.path || "/"}  ${p.code}  ${p.message}`).join("\n");
+}
+function projectDirRefusal() {
+  if (process.env.DATABRAIN_HOSTED_PUBLIC_URL) {
+    return "projectDir is not available on the hosted server. Pass manifest, bundleJs, bundleCss and iconSvg instead.";
+  }
+  return null;
+}
+async function resolveBundleInput(params, options) {
+  if (params.projectDir) {
+    const refusal = projectDirRefusal();
+    if (refusal) return { problems: [], error: refusal, source: "projectDir" };
+    if (params.manifest || params.bundleJs || params.iconSvg) {
+      return { problems: [], error: "Pass either projectDir or manifest/bundleJs/iconSvg, not both.", source: "projectDir" };
+    }
+    if (options.build) {
+      const result = await buildProject(params.projectDir, { write: false });
+      if (!result.ok || !result.outputs) return { problems: result.problems, source: "projectDir" };
+      const { manifest, bundleJs, bundleCss, iconSvg } = result.outputs;
+      return { bundle: { manifest, bundleJs, bundleCss, iconSvg }, problems: [], source: "projectDir" };
+    }
+    const dist = readDist(params.projectDir);
+    if (!dist.bundle) return { problems: dist.problems, source: "projectDir" };
+    return { bundle: dist.bundle, problems: [], source: "projectDir" };
+  }
+  if (!params.manifest) {
+    return { problems: [], error: "manifest is required (or pass projectDir when running locally).", source: "arguments" };
+  }
+  return {
+    bundle: {
+      manifest: params.manifest,
+      bundleJs: params.bundleJs,
+      bundleCss: params.bundleCss,
+      iconSvg: params.iconSvg
+    },
+    problems: [],
+    source: "arguments"
+  };
+}
+async function remoteValidate(client, bundle) {
+  try {
+    const result = await createCustomChartsApi(client).validate(bundle);
+    return { status: "ok", result };
+  } catch (err) {
+    if (err instanceof DatabrainApiError) {
+      if (err.code === "MISSING_SERVICE_TOKEN") {
+        return { status: "skipped", reason: "No service token is configured, so only the local validator ran." };
+      }
+      return { status: "failed", reason: err.message, problems: apiProblems(err) };
+    }
+    return { status: "failed", reason: err.message, problems: [] };
+  }
+}
+function isCompleteBundle(bundle) {
+  return typeof bundle.bundleJs === "string" && typeof bundle.iconSvg === "string";
+}
+
+// src/tools/custom-chart/scaffold.ts
+function registerCustomChartScaffold(server, _client) {
+  server.tool(
+    "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: z39.string().describe("Chart key, becomes chart type custom:<key>. Lowercase letters, digits, _ and -, 64 max."),
+      name: z39.string().describe("Display name shown in the chart picker, 1 to 256 characters."),
+      description: z39.string().optional().describe("Optional description, up to 500 characters."),
+      slots: z39.array(slotInputSchema).optional().describe("Data slots. Defaults to category (dimension), value (measure), target (optional measure)."),
+      options: z39.array(optionInputSchema).optional().describe("Chart options. Defaults to the template options (labels, subtitle, radius, colour, sort).")
+    },
+    READ_ONLY,
+    async (params) => {
+      try {
+        const result = scaffoldProject({
+          key: params.key,
+          name: params.name,
+          description: params.description,
+          slots: params.slots,
+          options: params.options
+        });
+        if (!result.ok) {
+          return toolError(`The requested manifest is not valid:
+${formatProblems(result.problems)}`);
+        }
+        return toolSuccess(
+          JSON.stringify(
+            {
+              status: "scaffold_only",
+              key: params.key,
+              chartType: `custom:${params.key}`,
+              files: result.files,
+              nextStep: result.nextStep
+            },
+            null,
+            2
+          )
+        );
+      } catch (err) {
+        return toolError(`Unexpected error: ${err.message}`);
+      }
+    }
+  );
+}
+
+// src/tools/custom-chart/validate.ts
+function registerCustomChartValidate(server, client) {
+  server.tool(
+    "custom_chart_validate",
+    "Validate a custom chart manifest and bundle with the local rules and, when a service token is configured, the server rules. Never persists anything.",
+    bundleInputShape,
+    READ_ONLY,
+    async (params) => {
+      try {
+        const resolved = await resolveBundleInput(params, { build: true });
+        if (resolved.error) return toolError(resolved.error);
+        if (!resolved.bundle) {
+          return toolSuccess(JSON.stringify({ ok: false, problems: resolved.problems, source: resolved.source }, null, 2));
+        }
+        const { bundle } = resolved;
+        const problems = validateBundle(bundle);
+        const complete = isCompleteBundle(bundle);
+        const result = {
+          ok: problems.length === 0,
+          problems,
+          source: resolved.source,
+          contentHash: complete && problems.length === 0 ? contentHash(bundle) : void 0,
+          sizeBytes: complete && problems.length === 0 ? bundleSizeBytes(bundle) : void 0
+        };
+        if (!complete) {
+          result.note = "Only the manifest was checked. Pass bundleJs and iconSvg (or projectDir) to check the whole package.";
+        } else if (problems.length === 0) {
+          const remote = await remoteValidate(client, bundle);
+          if (remote.status === "ok") {
+            result.remote = remote.result;
+            if (!remote.result.ok) {
+              result.ok = false;
+              result.problems = remote.result.problems;
+            }
+            if (remote.result.contentHash) result.contentHash = remote.result.contentHash;
+            if (typeof remote.result.sizeBytes === "number") result.sizeBytes = remote.result.sizeBytes;
+          } else if (remote.status === "skipped") {
+            result.remote = { status: "skipped", reason: remote.reason };
+          } else {
+            result.remote = { status: "failed", reason: remote.reason };
+            if (remote.problems.length > 0) {
+              result.ok = false;
+              result.problems = remote.problems;
+            }
+          }
+        }
+        result.nextStep = result.ok ? "Upload with custom_chart_upload (mode dry_run first) or `databrain custom-chart upload`." : "Fix every problem (path, code, message), then validate again.";
+        return toolSuccess(JSON.stringify(result, null, 2));
+      } catch (err) {
+        return toolError(`Unexpected error: ${err.message}`);
+      }
+    }
+  );
+}
+
+// src/tools/custom-chart/upload.ts
+import { z as z40 } 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: z40.enum(["dry_run", "apply"]).default("dry_run").describe("dry_run validates and returns the plan; apply uploads."),
+      confirm: z40.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
+      publish: z40.boolean().default(false).describe("After a successful apply, publish the uploaded version so every builder can use it."),
+      name: z40.string().optional().describe("Display name override. Defaults to manifest.name."),
+      description: z40.string().optional().describe("Description override. Defaults to manifest.description."),
+      ...bundleInputShape
+    },
+    WRITE_CREATE,
+    async (params) => {
+      try {
+        const mode = params.mode || "dry_run";
+        const resolved = await resolveBundleInput(params, { build: false });
+        if (resolved.error) return toolError(resolved.error);
+        if (!resolved.bundle) {
+          return toolError(`The project could not be read:
+${formatProblems(resolved.problems)}`);
+        }
+        const { bundle } = resolved;
+        if (!isCompleteBundle(bundle)) {
+          return toolError("manifest, bundleJs and iconSvg are all required to upload. Run `databrain custom-chart build` and pass dist/index.js, dist/manifest.json and dist/icon.svg (or projectDir when local).");
+        }
+        const problems = validateBundle(bundle);
+        if (problems.length > 0) {
+          return toolError(`The bundle is not valid. Fix these and try again:
+${formatProblems(problems)}`);
+        }
+        const manifest = bundle.manifest;
+        const key = manifest.id;
+        const body = {
+          manifest,
+          bundleJs: bundle.bundleJs,
+          bundleCss: bundle.bundleCss,
+          iconSvg: bundle.iconSvg,
+          ...params.name ? { name: params.name } : {},
+          ...params.description ? { description: params.description } : {}
+        };
+        const localHash = contentHash(bundle);
+        const localSize = bundleSizeBytes(bundle);
+        if (mode === "dry_run") {
+          const remote = await remoteValidate(client, bundle);
+          let existing;
+          let planNote;
+          try {
+            existing = (await api.list()).find((chart) => chart.key === key);
+          } catch (err) {
+            planNote = err instanceof DatabrainApiError && err.code === "MISSING_SERVICE_TOKEN" ? "No service token is configured, so the plan could not check whether the chart exists." : `Could not list custom charts: ${err.message}`;
+          }
+          const plan = planUpload(key, existing);
+          const remoteOk = remote.status !== "ok" || remote.result.ok;
+          return toolSuccess(
+            JSON.stringify(
+              {
+                status: "dry_run_only",
+                safety: genericProductionSafetyNote(),
+                ok: remoteOk,
+                key,
+                chartType: `custom:${key}`,
+                contentHash: remote.status === "ok" && remote.result.contentHash ? remote.result.contentHash : localHash,
+                sizeBytes: remote.status === "ok" && typeof remote.result.sizeBytes === "number" ? remote.result.sizeBytes : localSize,
+                problems: remote.status === "ok" ? remote.result.problems : remote.status === "failed" ? remote.problems : [],
+                remote: remote.status === "ok" ? "validated by the server" : remote.reason,
+                plan: plan.summary,
+                ...planNote ? { planNote } : {},
+                publishAfterUpload: params.publish === true,
+                requiredApplyConfirmation: APPLY_TO_PRODUCTION_CONFIRMATION,
+                nextStep: remoteOk ? `Review this plan. To execute, call again with mode="apply" and confirm="${APPLY_TO_PRODUCTION_CONFIRMATION}"${params.publish ? " (publish=true will publish the new version right away)" : ""}.` : "Fix every problem, rebuild, then run dry_run again."
+              },
+              null,
+              2
+            )
+          );
+        }
+        const guardError = validateProductionApply({ confirm: params.confirm });
+        if (guardError) return toolError(guardError);
+        const uploaded = await api.upload(body);
+        const versionNumber = uploaded.version?.versionNumber;
+        const lines = [];
+        if (uploaded.created === "none") {
+          lines.push(`This exact bundle is already v${versionNumber ?? "?"} of custom:${key}. Nothing was created.`);
+        } else if (uploaded.created === "chart") {
+          lines.push(`Created custom chart custom:${key} (v${versionNumber ?? 1}, status private).`);
+        } else {
+          lines.push(`Uploaded v${versionNumber ?? "?"} of custom:${key}. It is in preview until you publish it.`);
+        }
+        lines.push(`contentHash: ${uploaded.version?.contentHash ?? localHash}`);
+        if (params.publish) {
+          const published = await api.publish(key, uploaded.version?.id);
+          lines.push(`Published v${versionNumber ?? "?"} of custom:${key}. Status: ${published.chart?.status ?? "published"}. Every dashboard using custom:${key} now renders this version.`);
+        } else if (uploaded.created !== "none" || uploaded.chart?.status !== "published") {
+          lines.push(`To make it available to builders: publish_custom_chart with key "${key}" and confirm="${APPLY_TO_PRODUCTION_CONFIRMATION}", or Settings > Developers > Custom charts.`);
+        }
+        return toolSuccess(lines.join("\n"));
+      } catch (err) {
+        if (err instanceof DatabrainApiError) {
+          const problems = apiProblems(err);
+          if (problems.length > 0) {
+            return toolError(`The server refused the bundle: ${err.message}
+${formatProblems(problems)}`);
+          }
+          return err.toToolResponse();
+        }
+        return toolError(`Unexpected error: ${err.message}`);
+      }
+    }
+  );
+}
+
+// src/tools/custom-chart/list.ts
+function registerListCustomCharts(server, client) {
+  server.tool(
+    "list_custom_charts",
+    "List the custom chart types of the company (key, name, status, published and preview versions). Uses the service token.",
+    {},
+    READ_ONLY,
+    async () => {
+      try {
+        const charts = await createCustomChartsApi(client).list();
+        const rows = charts.map((chart) => ({
+          key: chart.key,
+          chartType: `custom:${chart.key}`,
+          name: chart.name,
+          status: chart.status,
+          publishedVersionId: chart.publishedVersionId ?? null,
+          publishedVersionNumber: typeof chart.publishedVersionNumber === "number" ? chart.publishedVersionNumber : void 0,
+          previewVersionId: chart.previewVersionId ?? null,
+          previewVersionNumber: typeof chart.previewVersionNumber === "number" ? chart.previewVersionNumber : void 0,
+          versionsCount: typeof chart.versionsCount === "number" ? chart.versionsCount : void 0,
+          updatedAt: chart.updatedAt,
+          createdBy: chart.createdBy ?? null
+        }));
+        if (rows.length === 0) {
+          return toolSuccess(
+            "No custom charts yet. Scaffold one with custom_chart_scaffold, build it with `databrain custom-chart build`, then upload with custom_chart_upload."
+          );
+        }
+        return toolSuccess(JSON.stringify({ count: rows.length, charts: rows }, null, 2));
+      } catch (err) {
+        if (err instanceof DatabrainApiError) return err.toToolResponse();
+        return toolError(`Unexpected error: ${err.message}`);
+      }
+    }
+  );
+}
+
+// src/tools/custom-chart/publish.ts
+import { z as z41 } 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: z41.string().describe("The chart key (manifest.id), for example revenue-bars."),
+      versionId: z41.string().optional().describe("A specific version id to publish. Defaults to the preview version."),
+      mode: z41.enum(["dry_run", "apply"]).default("dry_run").describe("dry_run shows what would be published; apply publishes."),
+      confirm: z41.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`)
+    },
+    WRITE_IDEMPOTENT,
+    async (params) => {
+      try {
+        const mode = params.mode || "dry_run";
+        const detail = await api.get(params.key);
+        const versions = Array.isArray(detail.versions) ? detail.versions : [];
+        const targetId = params.versionId ?? detail.previewVersionId ?? null;
+        const target = versions.find((version) => version.id === targetId);
+        if (!targetId) {
+          return toolError(
+            `custom:${params.key} has no preview version to publish${detail.publishedVersionId ? ` (v published: ${detail.publishedVersionId})` : ""}. Upload a new version first, or pass versionId.`
+          );
+        }
+        if (params.versionId && versions.length > 0 && !target) {
+          return toolError(`custom:${params.key} has no version with id ${params.versionId}. Versions: ${versions.map((v) => `${v.id} (v${v.versionNumber})`).join(", ")}.`);
+        }
+        if (detail.publishedVersionId === targetId) {
+          return toolSuccess(`custom:${params.key} already has ${target ? `v${target.versionNumber}` : targetId} published. Nothing to do.`);
+        }
+        if (mode === "dry_run") {
+          return toolSuccess(
+            JSON.stringify(
+              {
+                status: "dry_run_only",
+                safety: genericProductionSafetyNote(),
+                key: params.key,
+                chartType: `custom:${params.key}`,
+                name: detail.name,
+                currentStatus: detail.status,
+                currentPublishedVersionId: detail.publishedVersionId ?? null,
+                willPublish: { versionId: targetId, versionNumber: target?.versionNumber, contentHash: target?.contentHash },
+                impact: `Every dashboard using custom:${params.key} will render this version.`,
+                requiredApplyConfirmation: APPLY_TO_PRODUCTION_CONFIRMATION,
+                nextStep: `Ask the user to confirm, then call again with mode="apply" and confirm="${APPLY_TO_PRODUCTION_CONFIRMATION}".`
+              },
+              null,
+              2
+            )
+          );
+        }
+        const guardError = validateProductionApply({ confirm: params.confirm });
+        if (guardError) return toolError(guardError);
+        const result = await api.publish(params.key, targetId);
+        return toolSuccess(
+          `Published ${target ? `v${target.versionNumber}` : targetId} of custom:${params.key} (${result.chart?.name ?? detail.name}). Status: ${result.chart?.status ?? "published"}. Every dashboard using custom:${params.key} now renders this version.`
+        );
+      } catch (err) {
+        if (err instanceof DatabrainApiError) return err.toToolResponse();
+        return toolError(`Unexpected error: ${err.message}`);
+      }
+    }
+  );
+}
+
 // src/tools/registry.ts
 function instrumentToolRegistration(server) {
   const original = server.tool.bind(server);
@@ -7128,6 +7139,11 @@ function registerAllTools(server, client) {
   registerRemoveWidget(server, client);
   registerGenerateWidget(server, client);
   registerListScheduledReports(server, client);
+  registerCustomChartScaffold(server, client);
+  registerCustomChartValidate(server, client);
+  registerCustomChartUpload(server, client);
+  registerListCustomCharts(server, client);
+  registerPublishCustomChart(server, client);
 }
 
 // src/resources/content/getting-started.ts
@@ -10436,28 +10452,27 @@ function registerAllPrompts(server) {
 }
 
 export {
-  oauthHttpsUrl,
-  oauthConfigSchema,
-  DatabrainApiError,
-  toolError,
-  toolSuccess,
-  logger,
-  MCP_SERVER_VERSION,
-  toolContext,
-  DatabrainClient,
   createServiceBundle,
   READ_ONLY,
+  WRITE_CREATE,
+  APPLY_TO_PRODUCTION_CONFIRMATION,
   CHART_URI,
   KPI_URI,
   APP_MIME,
+  rowsSchema,
   referenceSchema,
   viewSchema,
   pageSchema,
   appMeta,
   enableChartApps,
   chartResult,
+  draftSchema,
+  RENDER_TYPES,
+  draftPage,
+  workspacesForDatamart,
+  saveDraftAsDashboard,
   registerAllTools,
   registerAllResources,
   registerAllPrompts
 };
-//# sourceMappingURL=chunk-DZOYK5BB.js.map
+//# sourceMappingURL=chunk-5IQ7MVUH.js.map