drizzle-cube 0.9.0 → 0.9.2

package/dist/adapters/mcp-app-html.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./mcp-app-html-V1nZOil3.cjs");exports.mcpAppHtml=e.t;

package/dist/adapters/mcp-app-html.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The bundled MCP App HTML — public subpath `drizzle-cube/mcp-app-html`.
+ *
+ * This is the ~2 MB single-file MCP App (React + charts, inlined by
+ * `vite-plugin-singlefile` → `src/mcp-app/generated-html.ts`). It is only ever
+ * needed when `mcp.app` is enabled and a client lists or reads the
+ * `ui://drizzle-cube/visualization.html` resource, so the MCP transport loads it
+ * with a dynamic `import()` at that moment rather than at adapter import time.
+ *
+ * **Invariant:** nothing reachable from the adapter entries (`hono`, `express`,
+ * `fastify`, `nextjs`, `core`, `utils`) may import this module — or
+ * `../mcp-app/generated-html.js` — statically. A static import drags the blob
+ * into every consumer's server bundle even with `mcp.enabled: false`
+ * (`tests/adapters/mcp-app-html-lazy.test.ts` guards this). The one deliberate
+ * static importer is `mcp-tools.ts` (`drizzle-cube/mcp`), whose `resources`
+ * array is synchronous public API.
+ *
+ * In the published build the transport's `import()` targets the bare specifier
+ * `drizzle-cube/mcp-app-html` (see `vite.config.adapters.ts`), so bundlers that
+ * count every emitted module against a size budget (e.g. wrangler for
+ * Cloudflare Workers) can alias it to a stub exporting `mcpAppHtml = ''` when the
+ * MCP App is not used.
+ */
+/** The bundled MCP App as a single HTML document. Empty string if not yet built. */
+export declare const mcpAppHtml: string;

package/dist/adapters/mcp-app-html.js

@@ -0,0 +1,2 @@
+import { t as e } from "./mcp-app-html-sD7j035f.js";
+export { e as mcpAppHtml };

package/dist/adapters/mcp-tools.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./utils-DXWQUJbD.cjs"),t=require("./mcp-transport-DXIfb0p-.cjs");async function n(t,n,r){let i=await t.getSecurityContext(r);return t.wrapContent(await e.p(t.semanticLayer,i,n||{}))}async function r(t,n,r){let i=n||{};if(!i.query)return t.wrapError(`query is required`);let a=await t.getSecurityContext(r);return t.wrapContent(await e.f(t.semanticLayer,a,i))}async function i(t,n,r){let i=n||{};if(!i.query)return t.wrapError(`query is required`);let a=await t.getSecurityContext(r);return t.wrapContent(await e.m(t.semanticLayer,a,i))}function a(e){return{content:[{type:`text`,text:typeof e==`string`?e:JSON.stringify(e)}],isError:!1}}function o(e){return{content:[{type:`text`,text:e instanceof Error?e.message:String(e)}],isError:!0}}function s(e){let{semanticLayer:s,getSecurityContext:l,toolPrefix:u=`drizzle_cube_`,tools:d=[`discover`,`validate`,`load`,`chart`],prompts:f=t.u(),resources:p,app:m=!1}=e,h=!!m,g=typeof m==`object`?m:void 0,_=p??t.d(),v=h?[..._,...c(g)]:_,y=t.o({appEnabled:h}),b=new Map(y.map(e=>[e.name,e])),x=d.filter(e=>b.has(e)).map(e=>{let t=b.get(e),n={name:`${u}${e}`,description:t.description,inputSchema:t.inputSchema},r=t._meta;return r&&(n._meta=r),n}),S=x.map(e=>e.name),C=new Set;for(let e of d)C.add(e),C.add(`${u}${e}`);function w(e){return C.has(e)}let T={semanticLayer:s,getSecurityContext:l,wrapContent:a,wrapError:o},E={discover:(e,t)=>n(T,e,t),validate:(e,t)=>r(T,e,t),load:(e,t)=>i(T,e,t),chart:(e,t)=>i(T,e,t)};async function D(e,t,n){let r=e.startsWith(u)?e.slice(u.length):e,i=d.includes(r)?E[r]:void 0;if(!i)return o(`Unknown tool: ${e}`);try{return await i(t,n)}catch(e){return o(e)}}return{definitions:x,handle:D,handles:w,prompts:f,resources:v,toolNames:S}}function c(e){let n=t.f(e);return n?[{uri:t.n,name:`Drizzle Cube Visualization`,description:`Interactive chart visualization for query results`,mimeType:t.t,text:n}]:[]}exports.getCubeTools=s;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./utils-BkdzL4m9.cjs"),t=require("./mcp-transport-BQxL1h2h.cjs"),n=require("./mcp-app-html-V1nZOil3.cjs");async function r(t,n,r){let i=await t.getSecurityContext(r);return t.wrapContent(await e.p(t.semanticLayer,i,n||{}))}async function i(t,n,r){let i=n||{};if(!i.query)return t.wrapError(`query is required`);let a=await t.getSecurityContext(r);return t.wrapContent(await e.f(t.semanticLayer,a,i))}async function a(t,n,r){let i=n||{};if(!i.query)return t.wrapError(`query is required`);let a=await t.getSecurityContext(r);return t.wrapContent(await e.m(t.semanticLayer,a,i))}function o(e){return{content:[{type:`text`,text:typeof e==`string`?e:JSON.stringify(e)}],isError:!1}}function s(e){return{content:[{type:`text`,text:e instanceof Error?e.message:String(e)}],isError:!0}}function c(e){let{semanticLayer:n,getSecurityContext:c,toolPrefix:u=`drizzle_cube_`,tools:d=[`discover`,`validate`,`load`,`chart`],prompts:f=t.u(),resources:p,app:m=!1}=e,h=!!m,g=typeof m==`object`?m:void 0,_=p??t.d(),v=h?[..._,...l(g)]:_,y=t.o({appEnabled:h}),b=new Map(y.map(e=>[e.name,e])),x=d.filter(e=>b.has(e)).map(e=>{let t=b.get(e),n={name:`${u}${e}`,description:t.description,inputSchema:t.inputSchema},r=t._meta;return r&&(n._meta=r),n}),S=x.map(e=>e.name),C=new Set;for(let e of d)C.add(e),C.add(`${u}${e}`);function w(e){return C.has(e)}let T={semanticLayer:n,getSecurityContext:c,wrapContent:o,wrapError:s},E={discover:(e,t)=>r(T,e,t),validate:(e,t)=>i(T,e,t),load:(e,t)=>a(T,e,t),chart:(e,t)=>a(T,e,t)};async function D(e,t,n){let r=e.startsWith(u)?e.slice(u.length):e,i=d.includes(r)?E[r]:void 0;if(!i)return s(`Unknown tool: ${e}`);try{return await i(t,n)}catch(e){return s(e)}}return{definitions:x,handle:D,handles:w,prompts:f,resources:v,toolNames:S}}function l(e){let r=t.f(n.t,e);return r?[{uri:t.n,name:`Drizzle Cube Visualization`,description:`Interactive chart visualization for query results`,mimeType:t.t,text:r}]:[]}exports.getCubeTools=c;

package/dist/adapters/mcp-tools.js

@@ -1,17 +1,18 @@
-import { f as e, m as t, p as n } from "./utils-C_RKaP0n.js";
-import { d as r, f as i, n as a, o, t as s, u as c } from "./mcp-transport-CpF7usmR.js";
+import { f as e, m as t, p as n } from "./utils-BY3FDOmN.js";
+import { d as r, f as i, n as a, o, t as s, u as c } from "./mcp-transport-yJDy3T6W.js";
+import { t as l } from "./mcp-app-html-sD7j035f.js";
 //#region src/adapters/mcp-tools-handlers.ts
-async function l(e, t, r) {
+async function u(e, t, r) {
 	let i = await e.getSecurityContext(r);
 	return e.wrapContent(await n(e.semanticLayer, i, t || {}));
 }
-async function u(t, n, r) {
+async function d(t, n, r) {
 	let i = n || {};
 	if (!i.query) return t.wrapError("query is required");
 	let a = await t.getSecurityContext(r);
 	return t.wrapContent(await e(t.semanticLayer, a, i));
 }
-async function d(e, n, r) {
+async function f(e, n, r) {
 	let i = n || {};
 	if (!i.query) return e.wrapError("query is required");
 	let a = await e.getSecurityContext(r);
@@ -19,7 +20,7 @@ async function d(e, n, r) {
 }
 //#endregion
 //#region src/adapters/mcp-tools.ts
-function f(e) {
+function p(e) {
 	return {
 		content: [{
 			type: "text",
@@ -28,7 +29,7 @@ function f(e) {
 		isError: !1
 	};
 }
-function p(e) {
+function m(e) {
 	return {
 		content: [{
 			type: "text",
@@ -37,13 +38,13 @@ function p(e) {
 		isError: !0
 	};
 }
-function m(e) {
+function h(e) {
 	let { semanticLayer: t, getSecurityContext: n, toolPrefix: i = "drizzle_cube_", tools: a = [
 		"discover",
 		"validate",
 		"load",
 		"chart"
-	], prompts: s = c(), resources: m, app: g = !1 } = e, _ = !!g, v = typeof g == "object" ? g : void 0, y = m ?? r(), b = _ ? [...y, ...h(v)] : y, x = o({ appEnabled: _ }), S = new Map(x.map((e) => [e.name, e])), C = a.filter((e) => S.has(e)).map((e) => {
+	], prompts: s = c(), resources: l, app: h = !1 } = e, _ = !!h, v = typeof h == "object" ? h : void 0, y = l ?? r(), b = _ ? [...y, ...g(v)] : y, x = o({ appEnabled: _ }), S = new Map(x.map((e) => [e.name, e])), C = a.filter((e) => S.has(e)).map((e) => {
 		let t = S.get(e), n = {
 			name: `${i}${e}`,
 			description: t.description,
@@ -58,21 +59,21 @@ function m(e) {
 	let D = {
 		semanticLayer: t,
 		getSecurityContext: n,
-		wrapContent: f,
-		wrapError: p
+		wrapContent: p,
+		wrapError: m
 	}, O = {
-		discover: (e, t) => l(D, e, t),
-		validate: (e, t) => u(D, e, t),
-		load: (e, t) => d(D, e, t),
-		chart: (e, t) => d(D, e, t)
+		discover: (e, t) => u(D, e, t),
+		validate: (e, t) => d(D, e, t),
+		load: (e, t) => f(D, e, t),
+		chart: (e, t) => f(D, e, t)
 	};
 	async function k(e, t, n) {
 		let r = e.startsWith(i) ? e.slice(i.length) : e, o = a.includes(r) ? O[r] : void 0;
-		if (!o) return p(`Unknown tool: ${e}`);
+		if (!o) return m(`Unknown tool: ${e}`);
 		try {
 			return await o(t, n);
 		} catch (e) {
-			return p(e);
+			return m(e);
 		}
 	}
 	return {
@@ -84,8 +85,8 @@ function m(e) {
 		toolNames: w
 	};
 }
-function h(e) {
-	let t = i(e);
+function g(e) {
+	let t = i(l, e);
 	return t ? [{
 		uri: a,
 		name: "Drizzle Cube Visualization",
@@ -95,4 +96,4 @@ function h(e) {
 	}] : [];
 }
 //#endregion
-export { m as getCubeTools };
+export { h as getCubeTools };

package/dist/adapters/mcp-transport-BQxL1h2h.cjs

@@ -0,0 +1,42 @@
+const e=require("./utils-BkdzL4m9.cjs");var t={valueField:{type:`array`,items:{type:`string`},description:`heatmap and activityGrid: single measure driving cell colour intensity. Required for both — the chart renders empty without it.`},dateField:{type:`array`,items:{type:`string`},description:`activityGrid only: single time dimension laying out the grid. Query it with day granularity over several months, or the grid has nothing to show.`}},n={minValue:{type:`number`,description:`gauge only: scale minimum (defaults to 0).`},maxValue:{type:`number`,description:`gauge only: scale maximum. ALWAYS set this — without it the gauge scales to the data it was given, so a single value always reads as 100%.`},template:{type:`string`,description:'kpiText only: sentence template around the value, e.g. "${fieldLabel}: ${value}". Defaults to that if omitted.'}},r={columns:{type:`array`,items:{type:`string`},description:`recordsTable only: fields to render as columns, in this order. Omit to show every field the query returns, in query order.`},hiddenColumns:{type:`array`,items:{type:`string`},description:`recordsTable only: fields fetched for row context or rowLink tokens but never displayed (e.g. an id used in the URL template). Leave empty unless a field is genuinely only needed behind the scenes — anything listed here disappears from the table.`}},i={columnFormats:{type:`object`,description:`recordsTable only: how each column renders, keyed by field name (e.g. "Employees.salary"). Formats are never inferred from the data — a column is plain text unless you say otherwise, so set this for any numeric, date, status or ratio column.`,additionalProperties:{type:`object`,required:[`kind`],properties:{kind:{type:`string`,enum:[`text`,`number`,`date`,`badge`,`progress`],description:`Required on every entry. text: as-is. number: formatted numeric. date: formatted date. badge: coloured pill for statuses/categories. progress: bar or ring for a bounded value. Use "text" when you only want to set a label.`},numberFormat:{type:`object`,description:`kind "number": { unit: "currency"|"percent"|"number"|"custom", decimals, abbreviate (K/M/B), currencyCode, customPrefix, customSuffix }.`},dateGranularity:{type:`string`,description:`kind "date": granularity to render at (e.g. "day", "month", "year").`},badgeColors:{type:`array`,description:`kind "badge": an ARRAY of { value, colorIndex } entries, not an object keyed by value. colorIndex is a number index into the dashboard palette (0, 1, 2, …), never a colour name like "green" — the palette is themed, so names would not follow it. A value with no entry renders neutral rather than being assigned a guessed colour.`,items:{type:`object`,required:[`value`,`colorIndex`],properties:{value:{type:`string`,description:`Cell value to colour, matched exactly`},colorIndex:{type:`number`,description:`Index into the dashboard colour palette`}}}},progressMin:{type:`number`,description:`kind "progress": lower bound (default 0). Values are clamped.`},progressMax:{type:`number`,description:`kind "progress": upper bound (default 100). Values are clamped.`},progressStyle:{type:`string`,enum:[`bar`,`circle`],description:`kind "progress": full-width bar, or a compact ring for narrow columns.`},label:{type:`string`,description:`Header override; defaults to the field title from the cube metadata.`},align:{type:`string`,enum:[`left`,`right`],description:`Cell alignment. Numbers usually read better right-aligned.`}}}},rowLink:{type:`object`,description:`recordsTable only: makes each row a link.`,required:[`urlTemplate`],properties:{urlTemplate:{type:`string`,description:`URL with {Cube.field} tokens substituted from the row, including hidden columns (e.g. "/employees/{Employees.id}"). Relative paths and http(s) URLs only.`},target:{type:`string`,enum:[`self`,`blank`],description:`Open in the same tab (default) or a new one.`}}},pageSize:{type:`number`,enum:[25,50,100],description:`recordsTable only: rows per page (default 25).`}},a=[`bar`,`line`,`area`,`pie`,`scatter`,`treemap`,`kpiNumber`,`kpiDelta`,`kpiText`,`table`,`recordsTable`,`radar`,`radialBar`,`bubble`,`funnel`,`waterfall`,`gauge`,`boxPlot`,`candlestick`,`activityGrid`,`measureProfile`,`sankey`,`sunburst`,`heatmap`,`markdown`];new Set(a);var o=`ui://drizzle-cube/visualization.html`,s=`text/html;profile=mcp-app`,c=a.filter(e=>e!==`markdown`);function l(e,t){if(!e||!t)return e;let n=`<script>window.__DRIZZLE_CUBE_MCP_APP_CONFIG__ = ${JSON.stringify({defaultLocale:t.defaultLocale,detectBrowserLocale:t.detectBrowserLocale}).replace(/<\//g,`<\\/`)}<\/script>`;return e.replace(`</head>`,`${n}</head>`)}async function u(e){let{mcpAppHtml:t}=await import(`drizzle-cube/mcp-app-html`);return l(t,e)}var d=[`2025-11-25`,`2025-06-18`,`2025-03-26`],f=`2025-11-25`;function p(e){let t=M(e[`mcp-protocol-version`])||`2025-11-25`;return{ok:d.includes(t),negotiated:d.includes(t)?t:null,supported:d}}function m(e){if(!e)return!1;let t=e.split(`,`).map(e=>e.trim().toLowerCase()),n=t.includes(`text/event-stream`),r=t.includes(`application/json`);return n&&!r}var h=`mcp-session-id`;function g(e){if(!e)return!1;let t=e.split(`,`).map(e=>e.trim().toLowerCase().split(`;`)[0]),n=t.some(e=>e===`application/json`),r=t.some(e=>e===`text/event-stream`),i=t.some(e=>e===`*/*`);return n&&r||n||i}function _(e){let t=e.hostname;return t===`localhost`||t===`::1`||t===`[::1]`||/^127(?:\.\d{1,3}){3}$/.test(t)}function v(e,t={}){let{allowMissingOrigin:n=!0,allowedOrigins:r}=t;if(!e)return n?{valid:!0}:{valid:!1,reason:`Origin header is required`};let i;try{i=new URL(e)}catch{return{valid:!1,reason:`Invalid Origin header format`}}let a=r&&r.length>0;return a&&r.includes(`*`)?{valid:!0}:a?r.map(e=>{try{return new URL(e).origin}catch{return e}}).includes(i.origin)?{valid:!0}:{valid:!1,reason:`Origin not in allowed list`}:_(i)?{valid:!0}:{valid:!1,reason:`Origin not allowed (default policy permits loopback origins only; configure mcp.allowedOrigins to allow this origin)`}}function y(e){return e.allowedOrigins?{allowedOrigins:e.allowedOrigins}:{}}function b(e){if(!e)return null;let t=/^Bearer\s+(\S+)$/i.exec(e);return t?t[1]:null}function x(e){return`Bearer resource_metadata="${e}"`}function S(e,t,n){let r=[];return t&&r.push(`id: ${t}`),n&&n>0&&r.push(`retry: ${n}`),r.push(`event: message`),r.push(`data: ${JSON.stringify(e)}`),r.push(``),r.join(`
+`)}function C(e,t,n,r){return{jsonrpc:`2.0`,id:e??null,error:{code:t,message:n,...r===void 0?{}:{data:r}}}}function w(e,t){return{jsonrpc:`2.0`,id:e??null,result:t}}function T(e){if(!e||typeof e!=`object`)return null;let t=e;return t.jsonrpc!==`2.0`||typeof t.method!=`string`?null:{jsonrpc:`2.0`,method:t.method,id:t.id,params:t.params}}function E(e,t){let n=e?.protocolVersion;return{protocolVersion:n&&d.includes(n)?n:f,capabilities:{tools:{listChanged:!1},resources:{listChanged:!1},prompts:{listChanged:!1},sampling:{}},sessionId:P(),serverInfo:{name:t.serverName,version:typeof process<`u`?process.env?.npm_package_version||`dev`:`worker`},instructions:t.instructions}}async function D(e){return{resources:(await e.getResources()).map(({uri:e,name:t,description:n,mimeType:r})=>({uri:e,name:t,description:n,mimeType:r})),nextCursor:``}}async function O(e,t){let n=e?.uri,r=await t.getResources(),i=r.find(e=>e.uri===n)||r[0];if(!i)throw j(-32602,`resource not found`);return{contents:[{uri:i.uri,mimeType:i.mimeType,text:i.text}]}}function k(e,t){let n=e?.name,r=t.prompts.find(e=>e.name===n)||t.prompts[0];if(!r)throw j(-32602,`prompt not found`);return{name:r.name,description:r.description,messages:r.messages}}async function A(t,n,r){let{appEnabled:i,appConfig:a}=r,o=r.resources??B,s={appEnabled:i,serverName:r.serverName??`drizzle-cube`,prompts:r.prompts??z,getResources:async()=>{let e=await r.extractSecurityContext(r.rawRequest,r.rawResponse),t=J(r.semanticLayer,e,o);return i?[...t,...await R(a)]:t},instructions:r.instructions??e.y()};switch(t){case`initialize`:return E(n,s);case`list_tools`:case`tools/list`:return{tools:F({appEnabled:i}),nextCursor:``};case`call_tool`:case`tools/call`:return I(n,r);case`resources/list`:return await D(s);case`resources/templates/list`:return{resourceTemplates:[],nextCursor:``};case`resources/read`:return await O(n,s);case`prompts/list`:return{prompts:s.prompts.map(({name:e,description:t})=>({name:e,description:t})),nextCursor:``};case`ping`:return{};case`notifications/initialized`:return{};case`prompts/get`:return k(n,s);default:throw j(-32601,`Unknown MCP method: ${t}`)}}function j(e,t,n){let r=Error(t);return r.code=e,n!==void 0&&(r.data=n),r}function M(e){return e?Array.isArray(e)?e[0]||null:e:null}function N(e){return e.id===void 0||e.id===null}function P(){return`evt-${e.s()}`}function F(t){let n=[{name:`discover`,description:`MANDATORY FIRST CALL. You MUST call this before constructing any query — even if you think you know the schema.
+
+Returns:
+- 'cubes': matched cubes with measures, dimensions, joins, and metadata hints (eventStream for funnels, etc.)
+- 'queryLanguageReference': the COMPLETE TypeScript DSL for query construction. This is the source of truth for field naming, filter operators, time dimensions, and analysis modes (funnel/flow/retention). READ IT before building queries — do not guess syntax.
+- 'dateFilteringGuide': decision tree for date filtering vs time grouping. READ IT whenever the user mentions a time period — this is the #1 source of incorrect queries.
+
+The 'joins' property on each cube shows relationships. You can include dimensions from ANY related cube in your query — the system auto-joins them.
+
+Example: If Productivity has a join to Employees, you can query:
+{ "measures": ["Productivity.totalPullRequests"], "dimensions": ["Employees.name"] }`,inputSchema:{type:`object`,properties:{topic:{type:`string`,description:`Keyword to search (e.g., "sales", "employees")`},intent:{type:`string`,description:`Natural language goal (e.g., "analyze productivity trends")`},limit:{type:`number`,description:`Max results (default: 10)`},minScore:{type:`number`,description:`Min relevance 0-1 (default: 0.1)`}}}},{name:`validate`,description:`Validate a query and get auto-corrections for issues.
+
+Checks:
+- Field existence (measures, dimensions exist in schema)
+- Filter syntax and operators
+- Cross-cube join validity
+
+Returns corrected query if issues found, plus the generated SQL for debugging.`,inputSchema:{type:`object`,required:[`query`],properties:{query:{type:`object`,description:`CubeQuery to validate`}}}},{name:`load`,description:`Execute a semantic query and return aggregated results.
+
+PREREQUISITE: You MUST have called 'discover' first in this session. The discover response contains the 'queryLanguageReference' (full DSL) and 'dateFilteringGuide' you need to construct a correct query. If you have not yet called discover, call it NOW before calling load.
+
+Supports regular queries (measures/dimensions), funnel, flow, and retention analysis modes — see the queryLanguageReference returned by discover for the full DSL.
+
+Key rules (the queryLanguageReference is authoritative — these are reminders, not the full spec):
+- Fields are EXACTLY "CubeName.fieldName" (two parts, one dot). Copy verbatim from discover.
+- Cross-cube joins: include dimensions from related cubes (system auto-joins).
+- Aggregated totals over a period: use filters with inDateRange — NOT timeDimensions.
+- Time series ("by month", "daily trend"): use timeDimensions WITH granularity.
+- Top N: filters + order + limit.
+
+Use "load" for data retrieval. Use "chart" to visualise results with an interactive chart.`,inputSchema:{type:`object`,required:[`query`],properties:{query:{type:`object`,description:`Semantic query object. Regular: { measures, dimensions, filters, timeDimensions, order, limit }. Funnel: { funnel: {...} }. Flow: { flow: {...} }. Retention: { retention: {...} }.`,properties:e.b}}}}];if(t?.appEnabled){n.push({name:`chart`,description:`Execute a semantic query and render an interactive chart visualization.
+
+Same query format as "load", but renders results in the MCP App chart UI.
+Include a "chart" object to control the visualization.
+
+Chart types: ${c.join(`, `)}
+Guidelines: single number -> kpiNumber, trend -> line/area, categories -> bar, part-of-whole -> pie, correlation -> scatter/bubble, distribution -> boxPlot, record-level listing -> recordsTable
+
+recordsTable renders one row per record, so pair it with "ungrouped": true in the query. Its columns are plain text unless you say otherwise: use chart.displayConfig.columnFormats to give each column a kind (number, date, badge, progress), which is what makes the listing readable.`,inputSchema:{type:`object`,required:[`query`],properties:{query:{type:`object`,description:`Semantic query object. Same format as the load tool.`,properties:e.b},chart:{type:`object`,description:`Chart configuration for the visualization. If omitted, chart type is auto-detected from query shape.`,properties:{type:{type:`string`,enum:c,description:`Chart type to render`},title:{type:`string`,description:`Chart title`},chartConfig:{type:`object`,description:`Axis configuration — same schema as agent add_portlet chartConfig.`,properties:{xAxis:{type:`array`,items:{type:`string`},description:`Dimension fields for X axis`},yAxis:{type:`array`,items:{type:`string`},description:`Measure fields for Y axis`},series:{type:`array`,items:{type:`string`},description:`Dimension for series splitting (grouped/stacked)`},yAxisAssignment:{type:`object`,description:`Dual Y-axis: map measure fields to "left" or "right". Only bar/line/area with 2+ measures of different scales.`},sizeField:{type:`string`,description:`Bubble chart size field`},colorField:{type:`string`,description:`Bubble chart color field`},...r}},displayConfig:{type:`object`,description:`Display options.`,properties:{showLegend:{type:`boolean`},showGrid:{type:`boolean`},showTooltip:{type:`boolean`},stacked:{type:`boolean`},stackType:{type:`string`,enum:[`none`,`normal`,`percent`]},orientation:{type:`string`,enum:[`horizontal`,`vertical`]},...i}},xAxis:{type:`string`,description:`Deprecated: use chartConfig.xAxis`},yAxis:{type:`array`,items:{type:`string`},description:`Deprecated: use chartConfig.yAxis`}}}}}});let t=n.find(e=>e.name===`chart`);t&&(t._meta={ui:{resourceUri:o}})}return n}async function I(t,n){let{semanticLayer:r,extractSecurityContext:i,rawRequest:a,rawResponse:o}=n,s=t||{};if(!s.name)throw j(-32602,`name is required for tools/call`);let c=s.arguments;try{switch(s.name){case`discover`:{let t=await i(a,o);return L(await e.p(r,t,c||{}))}case`validate`:{let t=c||{};if(!t.query)throw j(-32602,`query is required`);let n=await i(a,o);return L(await e.f(r,n,t))}case`load`:{let t=c||{};if(!t.query)throw j(-32602,`query is required`);let n=await i(a,o);return L(await e.m(r,n,t))}case`chart`:{let t=c||{};if(!t.query)throw j(-32602,`query is required`);let n=await i(a,o);return L(await e.m(r,n,t))}default:throw j(-32601,`Unknown tool: ${s.name}`)}}catch(e){if(e?.code===-32602||e?.code===-32601)throw e;let t=e instanceof Error?e.message:String(e);return{content:[{type:`text`,text:JSON.stringify({error:t})}],isError:!0}}}function L(e){return{content:[{type:`text`,text:typeof e==`string`?e:JSON.stringify(e)}],isError:!1}}async function R(e){let t=await u(e);return t?[{uri:o,name:`Drizzle Cube Visualization`,description:`Interactive chart visualization for query results`,mimeType:s,text:t}]:[]}var z=e.v(),B=[{uri:`drizzle-cube://quickstart`,name:`Drizzle Cube MCP Quickstart`,description:`Minimal guide for using discover/validate/load`,mimeType:`text/markdown`,text:[`# Drizzle Cube MCP Quickstart`,``,`Tools:`,`- discover: { topic?, intent?, limit?, minScore? } -> cubes list`,`- validate: { query } -> corrected query + issues`,`- load: { query } -> data + annotation (text only)`,`- chart: { query, chart? } -> data + interactive chart visualization`,``,`Recommended flow:`,`1) tools/call name=discover intent="<goal>"`,`2) tools/call name=validate query=<draft> (optional)`,`3) tools/call name=load query=<validated> (data only) OR name=chart query=<validated> chart={type, ...} (with visualization)`,``,`Query shapes supported:`,`- regular: { measures, dimensions, filters, timeDimensions, order, limit, offset, ungrouped }`,`- funnel: { funnel: { bindingKey, timeDimension, steps[], includeTimeMetrics?, globalTimeWindow? } }`,`- flow: { flow: { bindingKey, timeDimension, eventDimension, startingStep: { name, filter }, stepsBefore, stepsAfter } }`,`- retention: { retention: { timeDimension, bindingKey, dateRange: { start, end }, granularity, periods, retentionType } }`,``,`Filter rules: flat arrays of { member, operator, values }. Use { and: [...] } or { or: [...] } for logical grouping.`].join(`
+`)},{uri:`drizzle-cube://query-shapes`,name:`Query Shapes Reference`,description:`Detailed schema examples for regular, funnel, flow, and retention queries`,mimeType:`text/markdown`,text:[`# Query Shapes`,``,`## Regular query`,"```json",`{`,`  "measures": ["Sales.count"],`,`  "dimensions": ["Sales.channel"],`,`  "filters": [`,`    { "member": "Sales.status", "operator": "equals", "values": ["paid"] },`,`    { "or": [`,`      { "member": "Sales.region", "operator": "equals", "values": ["US"] },`,`      { "member": "Sales.region", "operator": "equals", "values": ["EU"] }`,`    ]}`,`  ],`,`  "timeDimensions": [{ "dimension": "Sales.createdAt", "dateRange": "last 30 days", "granularity": "day" }],`,`  "order": { "Sales.createdAt": "asc" },`,`  "limit": 500`,`}`,"```",``,`## Funnel`,"```json",`{`,`  "funnel": {`,`    "bindingKey": "Events.userId",`,`    "timeDimension": "Events.timestamp",`,`    "steps": [`,`      {`,`        "name": "Signup",`,`        "filter": [`,`          { "member": "Events.eventType", "operator": "equals", "values": ["signup"] },`,`          { "member": "Events.timestamp", "operator": "inDateRange", "values": ["last 6 months"] }`,`        ]`,`      },`,`      {`,`        "name": "Purchase",`,`        "filter": [{ "member": "Events.eventType", "operator": "equals", "values": ["purchase"] }],`,`        "timeToConvert": "P7D"`,`      }`,`    ],`,`    "includeTimeMetrics": true`,`  }`,`}`,"```",``,`## Flow`,"```json",`{`,`  "flow": {`,`    "bindingKey": "Events.userId",`,`    "timeDimension": "Events.timestamp",`,`    "eventDimension": "Events.eventType",`,`    "startingStep": {`,`      "name": "Checkout",`,`      "filter": { "member": "Events.eventType", "operator": "equals", "values": ["checkout"] }`,`    },`,`    "stepsBefore": 2,`,`    "stepsAfter": 3`,`  }`,`}`,"```",``,`## Retention`,"```json",`{`,`  "retention": {`,`    "timeDimension": "Events.timestamp",`,`    "bindingKey": "Events.userId",`,`    "dateRange": { "start": "2024-01-01", "end": "2024-03-31" },`,`    "granularity": "week",`,`    "periods": 8,`,`    "retentionType": "classic",`,`    "breakdownDimensions": ["Events.country"]`,`  }`,`}`,"```",``,`### Filter operators`,`String: equals, notEquals, contains, notContains, startsWith, endsWith, like, ilike, regex`,`Numeric: gt, gte, lt, lte, between, notBetween`,`Set: in, notIn, set, notSet, isEmpty, isNotEmpty`,`Date: inDateRange, beforeDate, afterDate`,``,`### Time handling`,`- Aggregated totals: use filters with inDateRange (NOT timeDimensions)`,`- Time series grouping: use timeDimensions with granularity`,`- Both can be combined: inDateRange filter + timeDimensions with granularity`,`- Period comparison: use compareDateRange in timeDimensions`].join(`
+`)}];function V(){return B}function H(){return z}function U(){return e.y()}function W(e){let t=H();return typeof e==`function`?e(t):e??t}function G(e){let t=V();return typeof e==`function`?e(t):e??t}function K(e){let t=U();return typeof e==`function`?e(t):e??t}function q(e,t){return{uri:`drizzle-cube://schema`,name:`Cube Schema`,description:`Current cube metadata as JSON`,mimeType:`application/json`,text:JSON.stringify(e.getMetadata(t),null,2)}}function J(e,t,n){let r=q(e,t);return[...G(n).filter(e=>e.uri!==r.uri),r]}Object.defineProperty(exports,"C",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"D",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"E",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"O",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"S",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"T",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"_",{enumerable:!0,get:function(){return P}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"b",{enumerable:!0,get:function(){return G}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return V}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return F}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return H}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return K}}),Object.defineProperty(exports,"w",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"x",{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,"y",{enumerable:!0,get:function(){return W}});