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

package/README.md

@@ -29,7 +29,7 @@ Your AI app opens a Databrain sign-in page, you pick one or more workspaces (or
 
 When you approve more than one workspace, the AI names the workspace on each call (`workspace` or `workspaceName`); `whoami` lists the ones you approved. With "All workspaces I can access", workspaces you get later are included, and `create_workspace` can make a new one if your role allows it.
 
-The hosted connector includes chart and KPI MCP Apps. `ask_question` returns an inline tile, and `list_widgets` opens a chart chooser in compatible hosts. Both current `_meta.ui.resourceUri` and legacy `_meta['ui/resourceUri']` pointers are included; other hosts retain the text summary and structured data. Tile controls retain the answer's granted workspace. Saving requires `mcp:dashboards:write`, `mcp:query`, the live workspace role, and `APPLY_TO_PRODUCTION` confirmation. No new environment variable is needed, including on self-hosted installs.
+The hosted connector includes chart and KPI MCP Apps. `render_metric_tile` renders an existing saved metric directly without an embed, data app or datamart; `ask_question` returns a new answer as an inline tile, and `list_widgets` opens a chart chooser in compatible hosts. Both current `_meta.ui.resourceUri` and legacy `_meta['ui/resourceUri']` pointers are included; other hosts retain the text summary and structured data. Tile controls retain the answer's granted workspace. Saving requires `mcp:dashboards:write`, `mcp:query`, the live workspace role, and `APPLY_TO_PRODUCTION` confirmation. No new environment variable is needed, including on self-hosted installs. Saved category and measure settings drive bar, line, pie, doughnut, stacked and combo tiles. Gauges render inline, pivot/table tiles show a scrollable table, and text KPIs stay text. Large dashboard documents open a compact chart picker.
 
 <details>
 <summary><b>Claude (claude.ai and Claude Desktop)</b></summary>
@@ -448,13 +448,13 @@ Prompts are guided workflows your AI assistant can follow. Ask for them by name
 | `ask_question` | Ask a natural language question — gets converted to SQL, returns data + chart suggestion |
 | `get_semantic_layer` | Inspect semantic layer metadata (table/column descriptions, synonyms, completion score) |
 | `update_semantic_layer` | Improve semantic layer quality (add descriptions, synonyms, example questions) |
-| `start_semantic_layer_generation` | Start semantic-layer generation for a datamart |
-| `get_semantic_layer_generation_status` | Check semantic-layer generation progress |
+| `start_semantic_layer_generation` | Start semantic-layer generation for a datamart (hosted OAuth) |
+| `get_semantic_layer_generation_status` | Check semantic-layer generation progress (hosted OAuth) |
 | `search_semantic_model` | Find relevant v2 entities and their related entities |
 | `get_semantic_entity` | Read one v2 entity by kind and name with the current content hash |
 | `propose_semantic_change` | Validate candidate YAML or a patch and return its plan without writing |
 | `apply_semantic_change` | Preview by default, or apply live with a reviewed hash and production confirmation |
-| `eval_semantic_model` | Run saved queries and optional questions and return pass rate and verdicts |
+| `eval_semantic_model` | Check closed-world model assertions (id/question/exercises); does not run SQL |
 
 Semantic-layer generation uses the datamart ID returned by `list_datamarts` and calls the service-token API. Pass `datamartId` directly when the ID is already known.
 
@@ -463,7 +463,7 @@ For a v2 model, the five model tools use `datamartId` and the configured service
 1. Use `search_semantic_model` with `question` and optional `k` (default 10, maximum 100). If the server has no retrieval route, the tool pulls the model and ranks name, alias, synonyms and description, then includes adjacent entities. Hidden tables and columns are excluded from local search.
 2. Use `get_semantic_entity` with `kind` and an exact `name`. Column names use `table.column`. Kinds are `table`, `column`, `measure`, `metric`, `join`, `entity`, `glossary`, `saved_query`, `instruction` and `access_rule`.
 3. Use `propose_semantic_change` with exactly one of `source` (complete YAML), `yaml_patch`, or `change`. It returns the candidate source, validation errors, the server plan and `expected_content_hash`. Invalid source returns errors and no plan.
-4. Use `eval_semantic_model` with the proposed `source` and optional `questions`. Omitting source evaluates the stored model. The server returns pass rate and individual verdicts.
+4. Use `eval_semantic_model` with the proposed `source` and optional `questions`. Omitting source evaluates the stored model. Each question needs `id`, `question`, and `exercises` (exact model entity names). An omitted list becomes empty. This checks the model; it does not execute SQL.
 5. Review the plan. Call `apply_semantic_change` with the exact returned `source` and `expected_content_hash`. Its `dry_run` defaults to true. A live apply requires `dry_run: false` and user supplied `confirm: "APPLY_TO_PRODUCTION"`. The assistant must never supply confirmation on its own. Explicit `expected_content_hash: null` selects the first apply only when no layer is stored. Apply changes the live model for all consumers.
 
 A YAML patch merges mappings and named lists by name, including tables and columns. Other lists replace the original list. An empty list clears a list. Null removes a field. For example, `yaml_patch: "tables:\n  - name: orders\n    description: Customer purchases\n"` changes that description and preserves other tables and fields. Patch output normalizes YAML formatting and does not preserve comments. Review the returned source.
@@ -507,12 +507,18 @@ Production writes through `create_or_update_metric_from_query` default to `dry_r
 | Tool | Description |
 |------|-------------|
 | `custom_chart_scaffold` | Return the files of a new chart project (manifest, chart.ts, css, icon, sample data, author guide). Nothing is written or persisted |
+| `custom_chart_edit` | Iterate a hosted draft through Chart studio Bryn when installed; never saves or publishes |
+| `custom_chart_preview` | Compile a draft in memory and preview real sample rows as a sandboxed MCP App tile |
 | `custom_chart_validate` | Validate a manifest and bundle with the local rules and, when a service token is configured, the server rules. Never persists |
 | `custom_chart_upload` | Dry-run or upload a built bundle as a private chart (version 1) or a preview version; `publish: true` publishes in the same apply |
 | `list_custom_charts` | List the company's custom chart types with status and version ids |
 | `publish_custom_chart` | Dry-run or publish a version so every builder can use chart type `custom:<key>` |
 
-`custom_chart_upload` and `publish_custom_chart` default to `dry_run` and apply only with `confirm: "APPLY_TO_PRODUCTION"`. Hosted scopes: `mcp:custom-charts:read` and `mcp:custom-charts:write`. Build the bundle with the CLI below.
+`custom_chart_upload` and `publish_custom_chart` default to `dry_run` and apply only with `confirm: "APPLY_TO_PRODUCTION"`. Hosted scopes: `mcp:custom-charts:read` and `mcp:custom-charts:write`. Hosted agents can pass `chartTs`, `manifest`, `bundleCss` and `iconSvg` to compile in memory, without local files or imports. `custom_chart_edit` feature-detects the Chart studio Bryn route (#4469); a missing route returns the draft for the calling agent to edit, while an authorization failure stays a failure. `custom_chart_preview` uses sample query rows and slot bindings without saving. Save a version with upload, then ask the user before publishing. Local projects can use the CLI below.
+
+Custom tiles load the trusted sandbox runtime through the app-only `load_custom_chart_runtime` tool only when needed, preserving the built-in tile budget. Bundle chunks check live access and the current published pointer/hash on every call; validated immutable artifacts have a bounded content-hash cache. Calculations use the current bounded row page. Stdio credentials use source authoring directly, since Chart studio Bryn requires a hosted sign-in.
+
+Published custom metric tiles load their company bundle through the same live grant as the chart result. Code runs in the app/embed runtime inside two opaque sandbox frames, with no network, credentials or privileged host actions. A missing/unpublished type or a host that blocks nested sandbox frames shows a fallback and the rows. Bundles are app-only metadata, outside the model context.
 </details>
 
 ---
@@ -612,3 +618,6 @@ All tokens are managed automatically. You provide your service token once in the
 ## License
 
 MIT
+
+
+Saved hosted charts: call `list_dashboards`, then `get_dashboard` or `list_widgets` with its UUID/slug and workspace. Omit clientId for the saved dashboard view. Call `render_metric_tile({workspaceName, metricId, clientId?, display:"chart"})` to open a metricRef directly; the saved client must be supplied for a client-scoped metric. `display:"kpi"` returns the saved scalar, or labels the sum of a chart's sole numeric series across the full authorized result; multiple series refuse instead of guessing. Refresh and date-range controls recheck the same workspace and saved client. Use workspaceId for the wid in app links. Tenant/API-key reads still use embedId/clientId, with optional dataAppName for OAuth ambiguity. These operations create no dashboards, metrics or embeds.

package/dist/apps/server.d.ts

@@ -123,19 +123,37 @@ declare const configSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
 }>;
 type Config = z.infer<typeof configSchema>;
 
-declare const referenceSchema: z.ZodObject<{
+declare const referenceSchema: z.ZodUnion<[z.ZodObject<{
     embedId: z.ZodString;
     clientId: z.ZodString;
     widgetId: z.ZodString;
+    dataAppName: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     clientId: string;
     embedId: string;
     widgetId: string;
+    dataAppName?: string | undefined;
 }, {
     clientId: string;
     embedId: string;
     widgetId: string;
-}>;
+    dataAppName?: string | undefined;
+}>, z.ZodObject<{
+    dashboardId: z.ZodString;
+    widgetId: z.ZodString;
+    clientId: z.ZodOptional<z.ZodString>;
+    display: z.ZodOptional<z.ZodEnum<["chart", "kpi"]>>;
+}, "strict", z.ZodTypeAny, {
+    widgetId: string;
+    dashboardId: string;
+    clientId?: string | undefined;
+    display?: "chart" | "kpi" | undefined;
+}, {
+    widgetId: string;
+    dashboardId: string;
+    clientId?: string | undefined;
+    display?: "chart" | "kpi" | undefined;
+}>]>;
 type ChartReference = z.infer<typeof referenceSchema>;
 declare const viewSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
@@ -157,23 +175,25 @@ declare const viewSchema: z.ZodObject<{
     }>>;
     drillId: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    cursor?: string | undefined;
     drillId?: string | undefined;
+    cursor?: string | undefined;
     dateRange?: {
         from: string;
         to: string;
     } | undefined;
 }, {
-    cursor?: string | undefined;
     drillId?: string | undefined;
+    cursor?: string | undefined;
     dateRange?: {
         from: string;
         to: string;
     } | undefined;
 }>;
 declare const pageSchema: z.ZodEffects<z.ZodObject<{
-    kind: z.ZodEnum<["chart", "kpi"]>;
+    kind: z.ZodEnum<["chart", "kpi", "table"]>;
     title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    rowsTotal: z.ZodOptional<z.ZodNumber>;
     chartSpec: z.ZodObject<{
         type: z.ZodString;
     }, "strict", z.ZodTypeAny, {
@@ -184,6 +204,20 @@ declare const pageSchema: z.ZodEffects<z.ZodObject<{
     rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, "many">;
     columns: z.ZodArray<z.ZodString, "many">;
     svg: z.ZodOptional<z.ZodString>;
+    customChart: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        bindings: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
+        options: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, "strict", z.ZodTypeAny, {
+        options: Record<string, string | number | boolean>;
+        key: string;
+        bindings: Record<string, string[]>;
+    }, {
+        options: Record<string, string | number | boolean>;
+        key: string;
+        bindings: Record<string, string[]>;
+    }>>;
+    fallback: z.ZodOptional<z.ZodString>;
     width: z.ZodNumber;
     height: z.ZodNumber;
     points: z.ZodArray<z.ZodObject<{
@@ -197,116 +231,148 @@ declare const pageSchema: z.ZodEffects<z.ZodObject<{
         drillId: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         value: string | number | boolean | null;
-        key: string;
         label: string;
-        x: number;
-        y: number;
         width: number;
         height: number;
+        x: number;
+        y: number;
+        key: string;
         drillId?: string | undefined;
     }, {
         value: string | number | boolean | null;
-        key: string;
         label: string;
-        x: number;
-        y: number;
         width: number;
         height: number;
+        x: number;
+        y: number;
+        key: string;
         drillId?: string | undefined;
     }>, "many">;
     value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
     nextCursor: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    kind: "chart" | "kpi";
-    title: string;
     columns: string[];
+    rows: Record<string, string | number | boolean | null>[];
+    title: string;
     width: number;
     height: number;
-    chartSpec: {
-        type: string;
-    };
-    rows: Record<string, string | number | boolean | null>[];
     points: {
         value: string | number | boolean | null;
-        key: string;
         label: string;
-        x: number;
-        y: number;
         width: number;
         height: number;
+        x: number;
+        y: number;
+        key: string;
         drillId?: string | undefined;
     }[];
+    kind: "chart" | "kpi" | "table";
+    chartSpec: {
+        type: string;
+    };
     value?: string | number | boolean | null | undefined;
+    description?: string | undefined;
     svg?: string | undefined;
+    rowsTotal?: number | undefined;
+    customChart?: {
+        options: Record<string, string | number | boolean>;
+        key: string;
+        bindings: Record<string, string[]>;
+    } | undefined;
+    fallback?: string | undefined;
     nextCursor?: string | undefined;
 }, {
-    kind: "chart" | "kpi";
-    title: string;
     columns: string[];
+    rows: Record<string, string | number | boolean | null>[];
+    title: string;
     width: number;
     height: number;
-    chartSpec: {
-        type: string;
-    };
-    rows: Record<string, string | number | boolean | null>[];
     points: {
         value: string | number | boolean | null;
-        key: string;
         label: string;
-        x: number;
-        y: number;
         width: number;
         height: number;
+        x: number;
+        y: number;
+        key: string;
         drillId?: string | undefined;
     }[];
+    kind: "chart" | "kpi" | "table";
+    chartSpec: {
+        type: string;
+    };
     value?: string | number | boolean | null | undefined;
+    description?: string | undefined;
     svg?: string | undefined;
+    rowsTotal?: number | undefined;
+    customChart?: {
+        options: Record<string, string | number | boolean>;
+        key: string;
+        bindings: Record<string, string[]>;
+    } | undefined;
+    fallback?: string | undefined;
     nextCursor?: string | undefined;
 }>, {
-    kind: "chart" | "kpi";
-    title: string;
     columns: string[];
+    rows: Record<string, string | number | boolean | null>[];
+    title: string;
     width: number;
     height: number;
-    chartSpec: {
-        type: string;
-    };
-    rows: Record<string, string | number | boolean | null>[];
     points: {
         value: string | number | boolean | null;
-        key: string;
         label: string;
-        x: number;
-        y: number;
         width: number;
         height: number;
+        x: number;
+        y: number;
+        key: string;
         drillId?: string | undefined;
     }[];
+    kind: "chart" | "kpi" | "table";
+    chartSpec: {
+        type: string;
+    };
     value?: string | number | boolean | null | undefined;
+    description?: string | undefined;
     svg?: string | undefined;
+    rowsTotal?: number | undefined;
+    customChart?: {
+        options: Record<string, string | number | boolean>;
+        key: string;
+        bindings: Record<string, string[]>;
+    } | undefined;
+    fallback?: string | undefined;
     nextCursor?: string | undefined;
 }, {
-    kind: "chart" | "kpi";
-    title: string;
     columns: string[];
+    rows: Record<string, string | number | boolean | null>[];
+    title: string;
     width: number;
     height: number;
-    chartSpec: {
-        type: string;
-    };
-    rows: Record<string, string | number | boolean | null>[];
     points: {
         value: string | number | boolean | null;
-        key: string;
         label: string;
-        x: number;
-        y: number;
         width: number;
         height: number;
+        x: number;
+        y: number;
+        key: string;
         drillId?: string | undefined;
     }[];
+    kind: "chart" | "kpi" | "table";
+    chartSpec: {
+        type: string;
+    };
     value?: string | number | boolean | null | undefined;
+    description?: string | undefined;
     svg?: string | undefined;
+    rowsTotal?: number | undefined;
+    customChart?: {
+        options: Record<string, string | number | boolean>;
+        key: string;
+        bindings: Record<string, string[]>;
+    } | undefined;
+    fallback?: string | undefined;
     nextCursor?: string | undefined;
 }>;
 type ChartPage = z.infer<typeof pageSchema>;

package/dist/apps/server.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 import {
   createChartAppServer
-} from "../chunk-N7X762VU.js";
-import "../chunk-5IGP6A6T.js";
-import "../chunk-ERTAKB2H.js";
-import "../chunk-OCBTNAAO.js";
+} from "../chunk-LACJHQYH.js";
+import "../chunk-ZTHGF27R.js";
+import "../chunk-OLOC2MTA.js";
+import "../chunk-347U6GXR.js";
+import "../chunk-Q5EYDKSA.js";
 export {
   createChartAppServer
 };

package/dist/apps/stdio.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 import {
   loadConfig
-} from "../chunk-CUPL7CAN.js";
+} from "../chunk-V3UW3B6U.js";
 import {
   createChartAppServer
-} from "../chunk-N7X762VU.js";
-import "../chunk-5IGP6A6T.js";
-import "../chunk-ERTAKB2H.js";
-import "../chunk-OCBTNAAO.js";
+} from "../chunk-LACJHQYH.js";
+import "../chunk-ZTHGF27R.js";
+import "../chunk-OLOC2MTA.js";
+import "../chunk-347U6GXR.js";
+import "../chunk-Q5EYDKSA.js";
 
 // src/apps/stdio.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/apps/stdio.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/apps/stdio.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { loadConfig } from '../utils/config.js';\nimport { createChartAppServer } from './server.js';\n\n// Separate opt-in command until the owners integrate both shared entrypoints.\nconst server = createChartAppServer(loadConfig());\nawait server.connect(new StdioServerTransport());\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,4BAA4B;AAKrC,IAAM,SAAS,qBAAqB,WAAW,CAAC;AAChD,MAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;","names":[]}
+{"version":3,"sources":["../../src/apps/stdio.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { loadConfig } from '../utils/config.js';\nimport { createChartAppServer } from './server.js';\n\n// Separate opt-in command until the owners integrate both shared entrypoints.\nconst server = createChartAppServer(loadConfig());\nawait server.connect(new StdioServerTransport());\n"],"mappings":";;;;;;;;;;;;;AAAA,SAAS,4BAA4B;AAKrC,IAAM,SAAS,qBAAqB,WAAW,CAAC;AAChD,MAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;","names":[]}

package/dist/bundle-TDQXWIPM.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import {
+  DIST_FILES,
+  buildProject,
+  buildSource,
+  bundleSizeBytes,
+  contentHash,
+  readDist,
+  readProject,
+  validateBundle,
+  validateProject
+} from "./chunk-Q5EYDKSA.js";
+export {
+  DIST_FILES,
+  buildProject,
+  buildSource,
+  bundleSizeBytes,
+  contentHash,
+  readDist,
+  readProject,
+  validateBundle,
+  validateProject
+};
+//# sourceMappingURL=bundle-TDQXWIPM.js.map

package/dist/bundle-TDQXWIPM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}