drizzle-cube 0.5.3 → 0.5.4

package/dist/adapters/utils.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./utils-XPOzzMdY.cjs`);exports.buildTransformedQuery=e.t,exports.calculateQueryComplexity=e.n,exports.formatCubeResponse=e.r,exports.formatErrorResponse=e.i,exports.formatMetaResponse=e.a,exports.formatSqlResponse=e.o,exports.formatSqlString=e.s,exports.generateRequestId=e.c,exports.getDatabaseType=e.l,exports.handleBatchRequest=e.u,exports.handleDiscover=e.d,exports.handleDryRun=e.f,exports.handleLoad=e.p,exports.handleSuggest=e.m,exports.handleValidate=e.h,exports.normalizeQueryFields=e.g;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./utils-DrWvXf0G.cjs`);exports.buildTransformedQuery=e.t,exports.calculateQueryComplexity=e.n,exports.formatCubeResponse=e.r,exports.formatErrorResponse=e.i,exports.formatMetaResponse=e.a,exports.formatSqlResponse=e.o,exports.formatSqlString=e.s,exports.generateRequestId=e.c,exports.getDatabaseType=e.l,exports.handleBatchRequest=e.u,exports.handleDiscover=e.d,exports.handleDryRun=e.f,exports.handleLoad=e.p,exports.handleSuggest=e.m,exports.handleValidate=e.h,exports.normalizeQueryFields=e.g;

package/dist/adapters/utils.d.ts

@@ -1,5 +1,5 @@
 import { SemanticLayerCompiler, SemanticQuery, SecurityContext, CubeDiscoveryResult, QuerySuggestion, AIValidationResult } from '../server';
-import { MCPPromptResolver, MCPResourceResolver } from './mcp-transport';
+import { MCPPromptResolver, MCPResourceResolver, MCPInstructionsResolver } from './mcp-transport';
 /**
  * Calculate query complexity based on query structure
  */
@@ -297,6 +297,18 @@ export interface MCPOptions {
      * The live schema resource is always appended automatically.
      */
     resources?: MCPResourceResolver;
+    /**
+     * Override the `InitializeResult.instructions` string returned by the
+     * MCP `initialize` handshake. Per the MCP spec, this is the only
+     * server-authored guidance that clients are expected to surface to the
+     * model (it is typically merged into the system prompt).
+     *
+     * Pass a string to replace the defaults entirely, or a function to
+     * derive from / extend them. Use this to append project-specific
+     * guidance (e.g. cube semantics, naming conventions) without losing
+     * the built-in workflow rules.
+     */
+    instructions?: MCPInstructionsResolver;
     /**
      * OAuth 2.1 Protected Resource Metadata URL (RFC 9728).
      * When set, MCP endpoints require a Bearer token in the Authorization header.
@@ -347,11 +359,41 @@ export interface LoadRequest {
     query: SemanticQuery;
 }
 /**
- * Handle /discover endpoint - find relevant cubes based on topic/intent
+ * Discovery response shape returned by `handleDiscover`.
+ *
+ * In addition to the matched cubes, the response embeds the full query
+ * language reference and the date filtering decision tree. This is the
+ * primary delivery mechanism for query-construction guidance: clients
+ * cannot be relied upon to forward `prompts/*` content to the model, so
+ * we piggyback on `discover` (the mandated first call in our workflow)
+ * to guarantee the model sees the rules before it builds a query.
+ *
+ * The fields are stable strings — consumers may render or strip them as
+ * they see fit, but the MCP `discover` tool relies on them being present.
  */
-export declare function handleDiscover(semanticLayer: SemanticLayerCompiler, body: DiscoverRequest): Promise<{
+export interface DiscoverResponse {
+    /** Matched cubes (possibly empty) with measures, dimensions, and joins */
     cubes: CubeDiscoveryResult[];
-}>;
+    /**
+     * Complete TypeScript DSL reference for query construction. Source of
+     * truth for field naming, filter operators, time dimensions, and
+     * analysis modes (funnel/flow/retention).
+     */
+    queryLanguageReference: string;
+    /**
+     * Decision tree for date filtering vs time grouping. The single most
+     * common source of incorrect queries — read this whenever the user
+     * mentions a time period.
+     */
+    dateFilteringGuide: string;
+}
+/**
+ * Handle /discover endpoint - find relevant cubes based on topic/intent.
+ *
+ * Always returns `queryLanguageReference` and `dateFilteringGuide` alongside
+ * the matched cubes. See `DiscoverResponse` for the rationale.
+ */
+export declare function handleDiscover(semanticLayer: SemanticLayerCompiler, body: DiscoverRequest): Promise<DiscoverResponse>;
 /**
  * Handle /suggest endpoint - generate query from natural language
  */

package/dist/adapters/utils.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./utils-CTYvfZ3I.js";
+import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./utils-DG8ti3FT.js";
 export { m as buildTransformedQuery, l as calculateQueryComplexity, f as formatCubeResponse, o as formatErrorResponse, e as formatMetaResponse, u as formatSqlResponse, p as formatSqlString, t as generateRequestId, s as getDatabaseType, h as handleBatchRequest, n as handleDiscover, r as handleDryRun, d as handleLoad, c as handleSuggest, a as handleValidate, i as normalizeQueryFields };

package/dist/client/charts.js

@@ -1,13 +1,13 @@
-import { C as e, D as t, E as n, S as r, T as i, _ as a, b as o, g as s, h as c, m as l, p as u, t as d, v as f, w as p, x as m, y as h } from "./chunks/chart-data-table-Qrt6EAno.js";
-import { t as g } from "./chunks/chart-funnel-C7pgktN5.js";
-import { a as _, i as v, n as y, o as b } from "./chunks/chart-activity-grid-CWT0gLv4.js";
-import { t as x } from "./chunks/chart-area-DDti9Qtp.js";
-import { i as S } from "./chunks/utils-BHZdKxua.js";
-import { t as C } from "./chunks/chart-line-RdZwtk27.js";
-import { t as w } from "./chunks/chart-bar-B3s9qDlh.js";
-import { t as T } from "./chunks/chart-pie-BvY4FY__.js";
-import { t as E } from "./chunks/chart-scatter-DwXnI0rr.js";
-import { t as D } from "./chunks/chart-radar-DjiiEAmc.js";
-import { t as O } from "./chunks/chart-radial-bar-lla_JEYu.js";
-import { t as k } from "./chunks/chart-tree-map-DJHoA26f.js";
+import { C as e, D as t, E as n, S as r, T as i, _ as a, b as o, g as s, h as c, m as l, p as u, t as d, v as f, w as p, x as m, y as h } from "./chunks/chart-data-table-zZtwLf55.js";
+import { t as g } from "./chunks/chart-funnel-COTJy8BP.js";
+import { a as _, i as v, n as y, o as b } from "./chunks/chart-activity-grid-VFFm85hC.js";
+import { t as x } from "./chunks/chart-area-CwwIHTmK.js";
+import { i as S } from "./chunks/utils-BIuqPQuJ.js";
+import { t as C } from "./chunks/chart-line-DKvW32U-.js";
+import { t as w } from "./chunks/chart-bar-Bmny922L.js";
+import { t as T } from "./chunks/chart-pie-CzYnncO-.js";
+import { t as E } from "./chunks/chart-scatter-NMjD1lbW.js";
+import { t as D } from "./chunks/chart-radar-8iAt3QZl.js";
+import { t as O } from "./chunks/chart-radial-bar-CJbG7RIe.js";
+import { t as k } from "./chunks/chart-tree-map-CetaLMt8.js";
 export { y as CHART_COLORS, v as CHART_MARGINS, d as DataTable, g as FunnelChart, m as LazyChart, _ as NEGATIVE_COLOR, b as POSITIVE_COLOR, x as RechartsAreaChart, w as RechartsBarChart, C as RechartsLineChart, T as RechartsPieChart, D as RechartsRadarChart, O as RechartsRadialBarChart, E as RechartsScatterChart, k as RechartsTreeMapChart, u as clearChartConfigCache, S as formatChartData, r as getAvailableChartTypes, l as getChartConfigAsync, c as getChartConfigSync, e as getUnavailableChartTypes, s as isChartConfigLoaded, p as isChartTypeAvailable, i as isValidChartType, a as loadAllChartConfigs, n as preloadChart, f as preloadChartConfig, h as preloadChartConfigs, t as preloadCharts, o as useChartConfig };

package/dist/client/chunks/{DashboardEditModal-IU_0dgfC.js → DashboardEditModal-BBcB0E2g.js}

@@ -1,13 +1,13 @@
-import { a as e, n as t, o as n, r, s as i, u as a } from "./vendor-CBD_Olr0.js";
-import { A as o, G as s, H as c, K as l, T as u, U as d, V as f, b as p, lt as m, q as h, x as g } from "./chart-data-table-Qrt6EAno.js";
-import { C as _, D as v, E as y, O as b, S as x, T as S, a as C, b as w, c as T, l as E, n as D, r as ee, s as te, t as O, w as k, y as ne } from "./useDebounce-DyJVREop.js";
-import { r as re } from "./chart-sankey-WwkZAhLy.js";
+import { a as e, n as t, o as n, r, s as i, u as a } from "./vendor-BxLCTfvm.js";
+import { A as o, G as s, H as c, K as l, T as u, U as d, V as f, b as p, lt as m, q as h, x as g } from "./chart-data-table-zZtwLf55.js";
+import { C as _, D as v, E as y, O as b, S as x, T as S, a as C, b as w, c as T, l as E, n as D, r as ee, s as te, t as O, w as k, y as ne } from "./useDebounce-BOBSvhHy.js";
+import { r as re } from "./chart-sankey-C-wLBUmb.js";
 import { n as A, t as j } from "./providers-DX3Vw5kc.js";
-import { F as ie, M, k as N } from "./chart-activity-grid-CWT0gLv4.js";
-import { u as ae } from "./chart-area-DDti9Qtp.js";
+import { F as ie, M, k as N } from "./chart-activity-grid-VFFm85hC.js";
+import { u as ae } from "./chart-area-CwwIHTmK.js";
 import { l as oe } from "./retention-YhT1Oohi.js";
-import { S as P, _ as se, a as F, b as ce, c as le, g as I, h as L, i as R, l as z, m as B, n as V, o as H, p as ue, r as de, s as fe, t as U, v as pe, y as W } from "./FieldSearchModal-BCWanpPX.js";
-import { t as G } from "./chart-markdown-CiGRZdJj.js";
+import { S as P, _ as se, a as F, b as ce, c as le, g as I, h as L, i as R, l as z, m as B, n as V, o as H, p as ue, r as de, s as fe, t as U, v as pe, y as W } from "./FieldSearchModal-CisOov-_.js";
+import { t as G } from "./chart-markdown-CJU2hUq3.js";
 import { n as me, t as he } from "./useDirtyStateTracking-KAjwj1Ht.js";
 import ge, { Component as _e, Suspense as ve, createContext as ye, forwardRef as be, lazy as xe, startTransition as Se, useCallback as K, useContext as Ce, useEffect as q, useImperativeHandle as we, useMemo as J, useRef as Y, useState as X } from "react";
 import { Fragment as Z, jsx as Q, jsxs as $ } from "react/jsx-runtime";
@@ -2459,7 +2459,7 @@ function Zt({ position: e, currentPalette: t, onPaletteChange: n }) {
 }
 //#endregion
 //#region src/client/components/AnalysisBuilderLazy.tsx
-var Qt = xe(() => import("./analysis-builder-Dm6eD_AX.js")), $t = be((e, t) => /* @__PURE__ */ Q(ve, {
+var Qt = xe(() => import("./analysis-builder-0o1W-k3K.js")), $t = be((e, t) => /* @__PURE__ */ Q(ve, {
 	fallback: /* @__PURE__ */ Q("div", {
 		className: "dc:flex dc:items-center dc:justify-center dc:w-full dc:py-6",
 		children: /* @__PURE__ */ Q(ae, {})
@@ -6693,4 +6693,4 @@ function Ar({ isOpen: e, onClose: t, onSave: n, title: r, submitText: i, initial
 //#endregion
 export { at as A, Ct as C, ct as D, lt as E, Re as M, ke as N, ot as O, St as S, ut as T, At as _, cr as a, Nt as b, bt as c, Dt as d, Mt as f, Et as g, jt as h, Dr as i, Ue as j, st as k, gt as l, wt as m, kr as n, en as o, kt as p, Or as r, $t as s, Ar as t, Pt as u, Tt as v, ft as w, xt as x, Ot as y };
 
-//# sourceMappingURL=DashboardEditModal-IU_0dgfC.js.map
+//# sourceMappingURL=DashboardEditModal-BBcB0E2g.js.map