drizzle-cube 0.6.0 → 0.6.2

package/dist/server/filter-cache.d.ts

@@ -0,0 +1,73 @@
+import { SQL } from 'drizzle-orm';
+import { Filter, FilterCondition, FilterCache } from './types/index.js';
+/**
+ * Generates a deterministic cache key for a filter
+ * Keys are based on filter content (member, operator, values) not object identity
+ */
+export declare function getFilterKey(filter: Filter): string;
+/**
+ * Generates a cache key for time dimension date range filters
+ */
+export declare function getTimeDimensionFilterKey(dimension: string, dateRange: string | string[]): string;
+/**
+ * Cache statistics for debugging and monitoring
+ */
+export interface FilterCacheStats {
+    hits: number;
+    misses: number;
+    cacheSize: number;
+}
+/**
+ * Manages filter SQL caching for a single query execution
+ *
+ * Design principles:
+ * - Immutable SQL: Once cached, SQL objects are never modified
+ * - Cache lifetime: Created at query start, discarded after query execution
+ * - Key by content: Filters with same member/operator/values share SQL
+ * - Thread-safe: No shared mutable state between queries
+ */
+export declare class FilterCacheManager implements FilterCache {
+    private cache;
+    private stats;
+    /**
+     * Get cached SQL or build and cache it
+     *
+     * @param key - The cache key (use getFilterKey or getTimeDimensionFilterKey)
+     * @param builder - Function to build the SQL if not cached
+     * @returns The cached or freshly built SQL, or null if builder returns null
+     */
+    getOrBuild(key: string, builder: () => SQL | null): SQL | null;
+    /**
+     * Check if a key exists in the cache without affecting stats
+     */
+    has(key: string): boolean;
+    /**
+     * Get cached SQL without building (returns undefined if not cached)
+     */
+    get(key: string): SQL | undefined;
+    /**
+     * Pre-populate cache with multiple filters
+     * Useful for batch initialization at query start
+     */
+    preload(entries: Array<{
+        key: string;
+        sql: SQL;
+    }>): void;
+    /**
+     * Store a single entry in the cache
+     */
+    set(key: string, sql: SQL): void;
+    /**
+     * Get cache statistics for debugging
+     */
+    getStats(): FilterCacheStats;
+    /**
+     * Clear the cache (normally not needed as cache is per-query)
+     */
+    clear(): void;
+}
+/**
+ * Flatten nested AND/OR filters into individual filter conditions
+ * Useful for pre-building all filters at query start
+ */
+export declare function flattenFilters(filters: Filter[]): FilterCondition[];

package/dist/server/gap-filler.d.ts

@@ -0,0 +1,48 @@
+import { SemanticQuery } from './types/query.js';
+import { TimeGranularity } from './types/core.js';
+/**
+ * Maximum number of time buckets gap filling will generate. Beyond this, gap
+ * filling is skipped entirely (data is returned unmodified) to avoid both
+ * runaway memory use and silent truncation of real rows.
+ */
+export declare const MAX_GAP_FILL_BUCKETS = 10000;
+export interface GapFillerConfig {
+    /** The time dimension key (e.g., 'Sales.date') */
+    timeDimensionKey: string;
+    /** Time granularity for bucket generation */
+    granularity: TimeGranularity;
+    /** Date range [start, end] */
+    dateRange: [Date, Date];
+    /** Value to fill for missing measures (default: 0) */
+    fillValue: number | null;
+    /** List of measure keys in the data */
+    measures: string[];
+    /** List of dimension keys in the data (excluding time dimensions) */
+    dimensions: string[];
+}
+/**
+ * Generate all time buckets for a given date range and granularity
+ */
+export declare function generateTimeBuckets(startDate: Date, endDate: Date, granularity: TimeGranularity): Date[];
+/**
+ * Fill time series gaps in query result data
+ *
+ * @param data - Original query result data
+ * @param config - Gap filling configuration
+ * @returns Data with gaps filled
+ */
+export declare function fillTimeSeriesGaps(data: Record<string, unknown>[], config: GapFillerConfig): Record<string, unknown>[];
+/**
+ * Parse date range from query time dimension
+ * Handles both array format ['2024-01-01', '2024-01-31'] and string format
+ */
+export declare function parseDateRange(dateRange: string | string[] | undefined): [Date, Date] | null;
+/**
+ * Apply gap filling to query result data based on query configuration
+ *
+ * @param data - Original query result data
+ * @param query - The semantic query
+ * @param measures - List of measure names in the result
+ * @returns Data with gaps filled (if applicable)
+ */
+export declare function applyGapFilling(data: Record<string, unknown>[], query: SemanticQuery, measures: string[]): Record<string, unknown>[];

package/dist/server/index.cjs

@@ -822,4 +822,4 @@ The query is validated before adding. The portlet fetches its own data.`,paramet
 [IMPORTANT: Your next response MUST start with a brief text message BEFORE any tool calls. Now call add_markdown and add_portlet to visualize these results.]`}}catch(t){let n={measures:e.measures,dimensions:e.dimensions,filters:e.filters,timeDimensions:e.timeDimensions,order:e.order,limit:e.limit,...e.funnel?{funnel:e.funnel}:{},...e.flow?{flow:e.flow}:{},...e.retention?{retention:e.retention}:{}};return{result:`Query execution failed: ${t instanceof Error?t.message:`Unknown error`}\n\nAttempted query:\n${JSON.stringify(n,null,2)}`,isError:!0}}}),r.set(`add_portlet`,async e=>{let n={number:`kpiNumber`,retention:`retentionHeatmap`}[e.chartType]??e.chartType,r;try{r=JSON.parse(e.query)}catch{return{result:"Invalid query: could not parse JSON string. Ensure `query` is a valid JSON string.",isError:!0}}r=Jd(r);let i=t.validateQuery(r);if(!i.isValid)return{result:`Invalid query — fix these errors and retry:\n${i.errors.join(`
 `)}\n\nAttempted query:\n${JSON.stringify(r,null,2)}`,isError:!0};let a=!!(r.funnel||r.flow||r.retention),o;if(a)o=e.chartConfig??{};else{let t=_f(n,e.chartConfig,r),i=mf(n,t,r);if(!i.isValid)return{result:`Chart config invalid — fix these errors and retry:\n${i.errors.join(`
 `)}`,isError:!0};o=t}let s=`portlet-${Date.now()}-${Math.random().toString(36).slice(2,7)}`,c={id:s,title:e.title,query:e.query,chartType:n,chartConfig:o,displayConfig:e.displayConfig};return{result:`Portlet "${e.title}" added to notebook (id: ${s}, chart: ${n}). [Reminder: in your next response, start with a brief sentence about what you will do next BEFORE making any tool calls.]`,sideEffect:{type:`add_portlet`,data:c}}}),r.set(`add_markdown`,async e=>{let t=`markdown-${Date.now()}-${Math.random().toString(36).slice(2,7)}`,n=e.content||e.text||e.markdown||``,r={id:t,title:e.title,content:n};return{result:`Markdown block added to notebook (id: ${t}). [Reminder: in your next response, start with a brief sentence about what you will do next BEFORE making any tool calls.]`,sideEffect:{type:`add_markdown`,data:r}}}),r.set(`save_as_dashboard`,async e=>{try{let n=e.portlets;if(!n||n.length===0)return{result:`Dashboard must contain at least one portlet.`,isError:!0};let r=[];for(let e of n){if(e.chartType===`markdown`)continue;let n=e.query;if(!n){r.push(`Portlet "${e.title}": missing query`);continue}let i;try{i=JSON.parse(n)}catch{r.push(`Portlet "${e.title}": invalid JSON query`);continue}i=Jd(i);let a=t.validateQuery(i);a.isValid||r.push(`Portlet "${e.title}": ${a.errors.join(`, `)}`)}if(r.length>0)return{result:`Dashboard has invalid portlets — fix these errors and retry:\n${r.join(`
-`)}`,isError:!0};let i={portlets:n.map(e=>{let t=e.chartType,n=t===`markdown`,r=n?`query`:e.analysisType||`query`,i=r===`funnel`?`funnel`:r===`flow`?`flow`:r===`retention`?`retention`:`query`,a=e.query||`{}`,o;try{o=JSON.parse(a)}catch{o={}}let s={version:1,analysisType:i,activeView:`chart`,charts:{[i]:{chartType:t,chartConfig:e.chartConfig||{},displayConfig:e.displayConfig||{}}},query:n?{}:o};return{id:e.id,title:e.title,analysisConfig:s,dashboardFilterMapping:e.dashboardFilterMapping,w:e.w,h:e.h,x:e.x,y:e.y}}),filters:e.filters,colorPalette:e.colorPalette},a=e.title;return{result:`Dashboard "${a}" created with ${i.portlets.length} portlets and ${i.filters?.length||0} filters.`,sideEffect:{type:`dashboard_saved`,data:{title:a,description:e.description,dashboardConfig:i}}}}catch(e){return{result:`Failed to save dashboard: ${e instanceof Error?e.message:`Unknown error`}`,isError:!0}}}),r}async function Sf(e,t,n){switch(e){case`anthropic`:{let{AnthropicProvider:e}=await Promise.resolve().then(()=>require("./anthropic-DG4r1LSm.cjs"));return new e(t)}case`openai`:{let{OpenAIProvider:e}=await Promise.resolve().then(()=>require("./openai-vXvLni8v.cjs"));return new e(t,n)}case`google`:{let{GoogleProvider:e}=await Promise.resolve().then(()=>require("./google-BOnRIN1w.cjs"));return new e(t)}default:throw Error(`Unknown LLM provider: "${e}". Supported providers: anthropic, openai, google`)}}function Cf(e,t){if(Array.isArray(t))for(let n of t)e.push(n);else e.push(t)}function wf(e){if(e)try{e()}catch{}}function Tf(e,t){let n=[];if(!e||e.length===0)return n;for(let r of e){if(r.role===`user`){n.push({role:`user`,content:r.content});continue}if(r.role!==`assistant`)continue;let e=[];if(r.content&&e.push({type:`text`,text:r.content}),r.toolCalls&&r.toolCalls.length>0){for(let t of r.toolCalls)e.push({type:`tool_use`,id:t.id,name:t.name,input:t.input||{}});n.push({role:`assistant`,content:e});let i=r.toolCalls.map(e=>({toolUseId:e.id,toolName:e.name,content:typeof e.result==`string`?e.result:JSON.stringify(e.result??``),isError:e.status===`error`}));Cf(n,t.formatToolResults(i))}else e.length>0&&n.push({role:`assistant`,content:r.content})}return n}function Ef(e,t){if(!(e?.type!==`tool_use`||!t))try{e.input=JSON.parse(t)}catch{e.input={}}}function Df(e,t){let n=e.contentBlocks[e.contentBlocks.length-1];n&&n.type===`text`?n.text=(n.text||``)+t:e.contentBlocks.push({type:`text`,text:t})}function Of(e,t){if(e.currentBlockIsToolUse&&e.currentToolInputJson){let t=e.contentBlocks[e.contentBlocks.length-1];if(t?.type===`tool_use`)try{t.input=JSON.parse(e.currentToolInputJson)}catch{}}e.contentBlocks.push({type:`tool_use`,id:t.id,name:t.name,input:{},...t.metadata?{metadata:t.metadata}:{}}),e.currentToolInputJson=``,e.currentBlockIsToolUse=!0}function kf(e,t){if(t.id&&t.input){let n=e.contentBlocks.find(e=>e.type===`tool_use`&&e.id===t.id);n&&(n.input=t.input)}else if(e.currentBlockIsToolUse){let t=e.contentBlocks[e.contentBlocks.length-1];t?.type===`tool_use`&&e.currentToolInputJson&&(Ef(t,e.currentToolInputJson),e.currentToolInputJson=``),e.currentBlockIsToolUse=!1}}async function*Af(e,t){let n={contentBlocks:[],currentToolInputJson:``,currentBlockIsToolUse:!1,stopReason:``};for await(let r of e.parseStreamEvents(t)){let e=r;switch(e.type){case`text_delta`:Df(n,e.text),yield{type:`text_delta`,data:e.text};break;case`tool_use_start`:Of(n,e),yield{type:`tool_use_start`,data:{id:e.id,name:e.name,input:void 0}};break;case`tool_input_delta`:n.currentToolInputJson+=e.json;break;case`tool_use_end`:kf(n,e);break;case`message_meta`:e.inputTokens!=null&&(n.inputTokens=e.inputTokens),e.outputTokens!=null&&(n.outputTokens=e.outputTokens),e.stopReason&&(n.stopReason=e.stopReason);break}}return{contentBlocks:n.contentBlocks,stopReason:n.stopReason,inputTokens:n.inputTokens,outputTokens:n.outputTokens}}async function*jf(e,t){let{executor:n,observability:r,traceId:i,turn:a}=t,o=e.name,s=e.input||{},c=e.id,l=n.get(o);if(!l)return yield{type:`tool_use_result`,data:{id:c,name:o,result:`Unknown tool: ${o}`,isError:!0}},{toolUseId:c,toolName:o,content:`Unknown tool: ${o}`,isError:!0};let u=Date.now();try{let e=await l(s);return e.sideEffect&&(yield e.sideEffect),yield{type:`tool_use_result`,data:{id:c,name:o,result:e.result,...e.isError?{isError:!0}:{}}},wf(()=>r?.onToolEnd?.({traceId:i,turn:a,toolName:o,toolUseId:c,isError:!!e.isError,durationMs:Date.now()-u})),{toolUseId:c,toolName:o,content:e.result,...e.isError?{isError:!0}:{}}}catch(e){let t=e instanceof Error?e.message:`Tool execution failed`;return yield{type:`tool_use_result`,data:{id:c,name:o,result:t,isError:!0}},wf(()=>r?.onToolEnd?.({traceId:i,turn:a,toolName:o,toolUseId:c,isError:!0,durationMs:Date.now()-u})),{toolUseId:c,toolName:o,content:t,isError:!0}}}async function*Mf(e,t){let n=[];for(let r of e){if(r.type!==`tool_use`)continue;let e=yield*jf(r,t);n.push(e)}return n}var Nf={anthropic:`claude-sonnet-4-6`,openai:`gpt-4.1-mini`,google:`gemini-3-flash-preview`};async function*Pf(e){let{message:t,history:n,semanticLayer:r,securityContext:i,agentConfig:a,apiKey:o}=e,s=e.sessionId||crypto.randomUUID(),c=a.observability,l=crypto.randomUUID(),u=Date.now(),d=e.providerOverride||a.provider||`anthropic`,f=e.modelOverride||a.model||Nf[d]||`claude-sonnet-4-6`,p=e.baseURLOverride||a.baseURL,m=a.maxTurns||25,h=a.maxTokens||4096,g;try{g=await Sf(d,o,{baseURL:p})}catch(e){console.error(`[agent] Failed to create %s provider: %s`,String(d).replace(/\n|\r/g,``),String(e instanceof Error?e.message:e).replace(/\n|\r/g,``)),yield{type:`error`,data:{message:e instanceof Error?e.message:k(`server.errors.llmInitFailed`)}};return}let _=bf(),v=xf({semanticLayer:r,securityContext:i}),y=Dd(r.getMetadata());e.systemContext&&(y+=`\n\n## User Context\n\n${e.systemContext}`),wf(()=>c?.onChatStart?.({traceId:l,sessionId:s,message:t,model:f,historyLength:n?.length??0}));let b=Tf(n,g);b.push({role:`user`,content:t});let x=0;try{for(let e=0;e<m;e++){x=e+1;let t=await g.createStream({model:f,maxTokens:h,system:y,tools:_,messages:b}),n=Date.now(),{contentBlocks:r,stopReason:i,inputTokens:a,outputTokens:o}=yield*Af(g,t);if(wf(()=>c?.onGenerationEnd?.({traceId:l,turn:e,model:f,stopReason:i,inputTokens:a,outputTokens:o,durationMs:Date.now()-n,input:b,output:r})),b.push({role:`assistant`,content:r}),!g.shouldContinue(i))break;let s=yield*Mf(r,{executor:v,observability:c,traceId:l,turn:e});yield{type:`turn_complete`,data:{}},Cf(b,g.formatToolResults(s))}wf(()=>c?.onChatEnd?.({traceId:l,sessionId:s,totalTurns:x,durationMs:Date.now()-u})),yield{type:`done`,data:{sessionId:s||``,traceId:l}}}catch(e){try{c?.onChatEnd?.({traceId:l,sessionId:s,totalTurns:0,durationMs:Date.now()-u,error:e instanceof Error?e.message:`Unknown error`})}catch{}console.error(`[agent] Chat error (provider=%s, model=%s): %s`,String(d).replace(/\n|\r/g,``),String(f).replace(/\n|\r/g,``),String(e instanceof Error?e.message:e).replace(/\n|\r/g,``)),yield{type:`error`,data:{message:g.formatError(e)}}}}function Ff(e){return e.toISOString().split(`T`)[0]}function If(e,t){let n=new Date,r=Ff(n);if(/days?/.test(t)){let t=new Date(n);return t.setDate(t.getDate()-e),{dateRange:[Ff(t),r],granularity:`day`}}if(/weeks?/.test(t)){let t=new Date(n);return t.setDate(t.getDate()-e*7),{dateRange:[Ff(t),r],granularity:e<=4?`day`:`week`}}if(/months?/.test(t)){let t=new Date(n);return t.setMonth(t.getMonth()-e),{dateRange:[Ff(t),r],granularity:e<=3?`day`:`month`}}return null}function Lf(e){let t=parseInt(e.slice(1),10),n=new Date().getFullYear(),r=(t-1)*3,i=new Date(n,r,1),a=new Date(n,r+3,0);return{dateRange:[Ff(i),Ff(a)],granularity:`month`}}function Rf(e,t,n,r){let i=0;for(let a of e.measures){let e=[(a.name.split(`.`).pop()||a.name).toLowerCase(),a.title.toLowerCase(),...(a.synonyms||[]).map(e=>e.toLowerCase())];for(let o of e)if(t.includes(o)){n.push(a.name),r.push(`Matched measure '${a.name}' via keyword '${o}'`),i+=.15;break}}return i}function zf(e,t,n,r){let i=e.measures.filter(e=>e.type===t.type);if(i.length>0){n.push(i[0].name),r.push(`Suggested ${i[0].name} based on ${t.type} intent`);return}if(t.type===`count`){let t=e.measures.find(e=>e.type===`count`||e.type===`countDistinct`);t&&(n.push(t.name),r.push(`Suggested ${t.name} for counting`))}}function Bf(e,t,n,r,i){let a=0;for(let n of t){let t=Wd(e,n,`dimension`);t&&(r.push(t.field),i.push(`Matched dimension '${t.field}' from grouping keyword '${n}'`),a+=.1)}for(let t of e)for(let e of t.dimensions){let t=[(e.name.split(`.`).pop()||e.name).toLowerCase(),e.title.toLowerCase(),...(e.synonyms||[]).map(e=>e.toLowerCase())];for(let o of t)if(n.includes(o)&&!r.includes(e.name)&&(n.includes(`by ${o}`)||n.includes(`per ${o}`))){r.push(e.name),i.push(`Matched dimension '${e.name}' as grouping`),a+=.1;break}}return a}function Vf(){let e=new Date,t=e.toISOString().split(`T`)[0],n=e=>e.toISOString().split(`T`)[0],r=e=>new Date(e.getFullYear(),e.getMonth(),1),i=e=>new Date(e.getFullYear(),0,1),a=e=>{let t=Math.floor(e.getMonth()/3);return new Date(e.getFullYear(),t*3,1)},o=e=>{let t=e.getDay(),n=e.getDate()-t+(t===0?-6:1);return new Date(e.getFullYear(),e.getMonth(),n)};return[{pattern:/\btoday\b/i,getDateRange:()=>[t,t],granularity:`day`},{pattern:/\byesterday\b/i,getDateRange:()=>{let t=new Date(e);t.setDate(t.getDate()-1);let r=n(t);return[r,r]},granularity:`day`},{pattern:/\bthis week\b/i,getDateRange:()=>[n(o(e)),t],granularity:`day`},{pattern:/\blast week\b/i,getDateRange:()=>{let t=new Date(o(e));t.setDate(t.getDate()-7);let r=new Date(t);return r.setDate(r.getDate()+6),[n(t),n(r)]},granularity:`day`},{pattern:/\bthis month\b/i,getDateRange:()=>[n(r(e)),t],granularity:`day`},{pattern:/\blast month\b/i,getDateRange:()=>{let t=new Date(e.getFullYear(),e.getMonth()-1,1),r=new Date(e.getFullYear(),e.getMonth(),0);return[n(t),n(r)]},granularity:`day`},{pattern:/\bthis quarter\b/i,getDateRange:()=>[n(a(e)),t],granularity:`month`},{pattern:/\blast quarter\b/i,getDateRange:()=>{let t=new Date(a(e));t.setMonth(t.getMonth()-3);let r=new Date(a(e));return r.setDate(r.getDate()-1),[n(t),n(r)]},granularity:`month`},{pattern:/\bthis year\b/i,getDateRange:()=>[n(i(e)),t],granularity:`month`},{pattern:/\blast year\b/i,getDateRange:()=>{let t=new Date(e.getFullYear()-1,0,1),r=new Date(e.getFullYear()-1,11,31);return[n(t),n(r)]},granularity:`month`},{pattern:/\blast (\d+) days?\b/i,getDateRange:()=>{let r=new Date(e);return r.setDate(r.getDate()-7),[n(r),t]},granularity:`day`},{pattern:/\blast (\d+) weeks?\b/i,getDateRange:()=>{let r=new Date(e);return r.setDate(r.getDate()-28),[n(r),t]},granularity:`week`},{pattern:/\blast (\d+) months?\b/i,getDateRange:()=>{let r=new Date(e);return r.setMonth(r.getMonth()-3),[n(r),t]},granularity:`month`},{pattern:/\bq([1-4])\b/i,getDateRange:()=>[n(new Date(e.getFullYear(),0,1)),n(new Date(e.getFullYear(),2,31))],granularity:`month`}]}var Hf={funnel:/\b(funnel|conversion|drop.?off|steps?|journey|pipeline|stages?)\b/i,flow:/\b(flows?|paths?|sequence|before|after|next|previous|user.?journey)\b/i,retention:/\b(retention|cohort|return|churn|comeback|retained|day.?\d+)\b/i};function Uf(e){let t=e.toLowerCase();return Hf.funnel.test(t)?`funnel`:Hf.flow.test(t)?`flow`:Hf.retention.test(t)?`retention`:`query`}function Wf(e,t){let n=t||`the relevant cube`;switch(e){case`funnel`:return[`Use /mcp/discover to get ${n} funnel configuration and schema`,`Query the event dimension to discover available event types for funnel steps`,`Build funnel query with discovered values using the schema from discover`];case`flow`:return[`Use /mcp/discover to get ${n} flow configuration and schema`,`Query the event dimension to discover available event types`,`Build flow query specifying the starting event and steps before/after`];case`retention`:return[`Use /mcp/discover to get ${n} retention configuration and schema`,`Build retention query specifying granularity (day/week/month) and number of periods`]}}function Gf(e){let t=Vf(),n=e.toLowerCase();for(let e of t){let t=n.match(e.pattern);if(t){if(t[1]&&/^\d+$/.test(t[1])){let e=If(parseInt(t[1],10),n);if(e)return e}return/^q[1-4]$/i.test(t[0])?Lf(t[0]):{dateRange:e.getDateRange(),granularity:e.granularity}}}return null}function Kf(e){let t=e.toLowerCase();for(let{pattern:e,type:n}of[{pattern:/\b(total|sum|combined)\b/i,type:`sum`},{pattern:/\b(count|number of|how many)\b/i,type:`count`},{pattern:/\b(average|avg|mean)\b/i,type:`avg`},{pattern:/\b(maximum|max|highest|top)\b/i,type:`max`},{pattern:/\b(minimum|min|lowest|bottom)\b/i,type:`min`}])if(e.test(t))return{type:n,confidence:.8};return null}function qf(e){let t=e.toLowerCase(),n=[],r=/\bby\s+(\w+(?:\s+\w+)?)/gi,i;for(;(i=r.exec(t))!==null;)n.push(i[1].trim());let a=/\bper\s+(\w+)/gi;for(;(i=a.exec(t))!==null;)n.push(i[1].trim());let o=/\bfor each\s+(\w+)/gi;for(;(i=o.exec(t))!==null;)n.push(i[1].trim());return n}function Jf(e,t,n,r,i){if(n){let t=e.find(e=>e.name===n);return t?(r.push(`Using specified cube: ${n}`),[t]):(i.push(`Specified cube '${n}' not found`),[])}let a=Ud(e,{intent:t,limit:3}).map(t=>e.find(e=>e.name===t.cube)).filter(e=>e!==void 0);return a.length>0&&r.push(`Identified relevant cubes: ${a.map(e=>e.name).join(`, `)}`),a}function Yf(e,t){return e===`query`?{query:{},confidence:0,reasoning:[`Could not identify relevant cubes for this query`],warnings:t,analysisMode:e,nextSteps:void 0}:{query:{},confidence:.7,reasoning:[`Detected ${e} intent from natural language`],warnings:t,analysisMode:e,nextSteps:Wf(e,void 0)}}function Xf(e,t,n){let r=[],i=[],a={},o=Uf(t),s=Jf(e,t,n,r,i);if(s.length===0)return Yf(o,i);let c=s[0],l=.5,u=Kf(t);u&&(r.push(`Detected ${u.type} aggregation intent`),l+=.1);let d=[],f=t.toLowerCase();l+=Rf(c,f,d,r),d.length===0&&u&&zf(c,u,d,r),d.length===0&&c.measures.length>0&&(d.push(c.measures[0].name),r.push(`Using default measure: ${c.measures[0].name}`),i.push(`Could not determine specific measure from query, using default`)),a.measures=d;let p=qf(t),m=[];l+=Bf(s,p,f,m,r),m.length>0&&(a.dimensions=m);let h=Gf(t);if(h){let e=c.dimensions.find(e=>e.type===`time`);if(e){let t={dimension:e.name,dateRange:h.dateRange};h.granularity&&(t.granularity=h.granularity),a.timeDimensions=[t],r.push(`Applied time filter: ${h.dateRange[0]} to ${h.dateRange[1]}`),l+=.15}else i.push(`Time expression found but no time dimension in cube`)}if(l=Math.min(1,l),o!==`query`){let e=s.length>0?s[0].name:void 0;return{query:{},confidence:.7,reasoning:[`Detected ${o} intent from natural language`,...e?[`Found relevant cube: ${e}`]:[]],warnings:i.length>0?i:void 0,analysisMode:o,nextSteps:Wf(o,e)}}return{query:a,confidence:l,reasoning:r,warnings:i.length>0?i:void 0,analysisMode:`query`}}function $(e,t,n,r){e?typeof e==`string`&&n(e,r):r.push({type:`syntax_error`,message:k(t)})}function Zf(e,t){return e.map(e=>t.get(e)||e)}function Qf(e,t){if(t.size===0)return;let n=JSON.parse(JSON.stringify(e));return n.measures&&=Zf(n.measures,t),n.dimensions&&=Zf(n.dimensions,t),n.timeDimensions&&=n.timeDimensions.map(e=>({...e,dimension:t.get(e.dimension)||e.dimension})),n}function $f(e,t){e.measures&&e.measures.length>10&&t.push({type:`performance`,message:k(`server.validation.ai.performanceManyMeasures`,{count:e.measures.length}),suggestion:k(`server.validation.ai.suggestSplitQueries`)}),e.dimensions&&e.dimensions.length>5&&t.push({type:`performance`,message:k(`server.validation.ai.performanceManyDimensions`,{count:e.dimensions.length}),suggestion:k(`server.validation.ai.suggestAddDimensionFilters`)})}function ep(e,t,n){let[r]=e.split(`.`),i=t.find(e=>e.name===r);if(!i)return;let a=i.dimensions.find(t=>t.name===e);a&&a.type!==`time`&&n.push({type:`best_practice`,message:k(`server.validation.ai.dimensionNotTimeType`,{dimension:e,type:a.type}),field:e,suggestion:k(`server.validation.ai.suggestUseTimeDimension`)})}function tp(e,t,n,r,i){let a=e.member,o=a.split(`.`);if(o.length!==2){n.push({type:`invalid_filter`,message:k(`server.validation.ai.invalidFilterMemberFormat`,{member:a}),field:a});return}let[s,c]=o,l=t.find(e=>e.name===s);if(!l){let e=i(s,t.map(e=>e.name));e&&r.set(a,`${e.field}.${c}`),n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundInFilter`,{cubeName:s}),field:a,suggestion:e?`Did you mean '${e.field}'?`:void 0,correctedValue:e?`${e.field}.${c}`:void 0});return}let u=l.dimensions.some(e=>e.name===a),d=l.measures.some(e=>e.name===a);if(u||d)return;let f=i(c,[...l.dimensions.map(e=>e.name.split(`.`).pop()),...l.measures.map(e=>e.name.split(`.`).pop())]);if(f){let e=`${s}.${f.field}`;r.set(a,e),n.push({type:`invalid_filter`,message:k(`server.validation.ai.filterFieldNotFoundWithSuggestion`,{fieldName:c,cubeName:s}),field:a,suggestion:`Did you mean '${f.field}'?`,correctedValue:e})}else n.push({type:`invalid_filter`,message:k(`server.validation.ai.filterFieldNotFound`,{fieldName:c,cubeName:s}),field:a})}function np(e,t){let n=null;for(let r of t){let t=Nd(e.toLowerCase(),r.toLowerCase());t<=3&&(!n||t<n.distance)&&(n={field:r,distance:t})}return n}function rp(e,t,n,r){let i=e.split(`.`);if(i.length!==2){n.push({type:`syntax_error`,message:k(`server.validation.ai.invalidMeasureFormat`,{measure:e}),field:e});return}let[a,o]=i,s=t.find(e=>e.name===a);if(!s){let i=t.map(e=>e.name),s=np(a,i);s?(n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundWithSuggestion`,{cubeName:a}),field:e,suggestion:`Did you mean '${s.field}'?`,correctedValue:`${s.field}.${o}`}),r.set(e,`${s.field}.${o}`)):n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundWithAvailable`,{cubeName:a}),field:e,suggestion:`Available cubes: ${i.join(`, `)}`});return}if(!s.measures.some(t=>t.name===e)){let i=Wd(t,o,`measure`);if(i&&i.cube===a)n.push({type:`measure_not_found`,message:k(`server.validation.ai.measureNotFoundWithSuggestion`,{measureName:o,cubeName:a}),field:e,suggestion:`Did you mean '${i.field}'?`,correctedValue:i.field}),r.set(e,i.field);else{let t=s.measures.map(e=>e.name.split(`.`).pop()),i=np(o,t);if(i){let t=`${a}.${i.field}`;n.push({type:`measure_not_found`,message:k(`server.validation.ai.measureNotFoundWithSuggestion`,{measureName:o,cubeName:a}),field:e,suggestion:`Did you mean '${i.field}'?`,correctedValue:t}),r.set(e,t)}else n.push({type:`measure_not_found`,message:k(`server.validation.ai.measureNotFoundWithAvailable`,{measureName:o,cubeName:a}),field:e,suggestion:`Available measures: ${t.slice(0,5).join(`, `)}${t.length>5?`...`:``}`})}}}function ip(e,t,n,r){let i=e.split(`.`);if(i.length!==2){n.push({type:`syntax_error`,message:k(`server.validation.ai.invalidDimensionFormat`,{dimension:e}),field:e});return}let[a,o]=i,s=t.find(e=>e.name===a);if(!s){let i=t.map(e=>e.name),s=np(a,i);s?(n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundWithSuggestion`,{cubeName:a}),field:e,suggestion:`Did you mean '${s.field}'?`,correctedValue:`${s.field}.${o}`}),r.set(e,`${s.field}.${o}`)):n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundWithAvailable`,{cubeName:a}),field:e,suggestion:`Available cubes: ${i.join(`, `)}`});return}if(!s.dimensions.some(t=>t.name===e)){let i=Wd(t,o,`dimension`);if(i&&i.cube===a)n.push({type:`dimension_not_found`,message:k(`server.validation.ai.dimensionNotFoundWithSuggestion`,{dimensionName:o,cubeName:a}),field:e,suggestion:`Did you mean '${i.field}'?`,correctedValue:i.field}),r.set(e,i.field);else{let t=s.dimensions.map(e=>e.name.split(`.`).pop()),i=np(o,t);if(i){let t=`${a}.${i.field}`;n.push({type:`dimension_not_found`,message:k(`server.validation.ai.dimensionNotFoundWithSuggestion`,{dimensionName:o,cubeName:a}),field:e,suggestion:`Did you mean '${i.field}'?`,correctedValue:t}),r.set(e,t)}else n.push({type:`dimension_not_found`,message:k(`server.validation.ai.dimensionNotFoundWithAvailable`,{dimensionName:o,cubeName:a}),field:e,suggestion:`Available dimensions: ${t.slice(0,5).join(`, `)}${t.length>5?`...`:``}`})}}}function ap(e,t,n,r){for(let i of e){if(`and`in i&&Array.isArray(i.and)){ap(i.and,t,n,r);continue}if(`or`in i&&Array.isArray(i.or)){ap(i.or,t,n,r);continue}`member`in i&&tp(i,t,n,r,np)}}function op(e,t,n,r,i){let a=e.funnel;if(!a)return;let o=(e,n)=>ip(e,t,n,i);if($(a.bindingKey,`server.validation.ai.bindingKeyRequired.funnel`,o,n),$(a.timeDimension,`server.validation.ai.timeDimensionRequired.funnel`,o,n),!a.steps||!Array.isArray(a.steps))n.push({type:`syntax_error`,message:k(`server.validation.ai.funnelStepsRequired`)});else if(a.steps.length<2)n.push({type:`syntax_error`,message:k(`server.validation.ai.funnelRequiresSteps`)});else for(let e=0;e<a.steps.length;e++){let o=a.steps[e];o.name||r.push({type:`best_practice`,message:k(`server.validation.ai.stepMissingName`,{step:e+1}),suggestion:k(`server.validation.ai.suggestAddStepNames`)}),o.filter&&`member`in o.filter&&ap([o.filter],t,n,i)}}function sp(e,t,n,r,i){let a=e.flow;if(!a)return;let o=(e,n)=>ip(e,t,n,i);$(a.bindingKey,`server.validation.ai.bindingKeyRequired.flow`,o,n),$(a.timeDimension,`server.validation.ai.timeDimensionRequired.flow`,o,n),$(a.eventDimension,`server.validation.ai.eventDimensionRequired`,o,n),a.stepsBefore===void 0&&a.stepsAfter===void 0&&r.push({type:`best_practice`,message:k(`server.validation.ai.stepsBothMissing`),suggestion:k(`server.validation.ai.suggestSetSteps`)})}function cp(e,t,n,r,i){let a=e.retention;if(!a)return;let o=(e,n)=>ip(e,t,n,i);$(a.bindingKey,`server.validation.ai.bindingKeyRequired.retention`,o,n),$(a.timeDimension,`server.validation.ai.retentionTimeDimensionRequired`,o,n),a.granularity||r.push({type:`best_practice`,message:k(`server.validation.ai.granularityNotSpecified`),suggestion:k(`server.validation.ai.suggestSpecifyGranularity`)}),a.periods||r.push({type:`best_practice`,message:k(`server.validation.ai.periodsNotSpecified`),suggestion:k(`server.validation.ai.suggestSpecifyPeriods`)})}function lp(e,t,n,r,i){return e.funnel?(op(e,t,n,r,i),!0):e.flow?(sp(e,t,n,r,i),!0):e.retention?(cp(e,t,n,r,i),!0):!1}function up(e,t,n,r,i){if(e.measures)for(let r of e.measures)rp(r,t,n,i);if(e.dimensions)for(let r of e.dimensions)ip(r,t,n,i);if(e.timeDimensions)for(let a of e.timeDimensions)ip(a.dimension,t,n,i),ep(a.dimension,t,r);e.filters&&ap(e.filters,t,n,i),!e.measures?.length&&!e.dimensions?.length&&n.push({type:`syntax_error`,message:k(`server.validation.ai.emptyQuery`)}),$f(e,r)}function dp(e,t){let n=[],r=[],i=new Map;if(lp(e,t,n,r,i))return{isValid:n.length===0,errors:n,warnings:r,correctedQuery:void 0};up(e,t,n,r,i);let a=Qf(e,i);return{isValid:n.length===0,errors:n,warnings:r,correctedQuery:a}}function fp(e){return new td({drizzle:e.drizzle,schema:e.schema})}exports.BaseDatabaseExecutor=S,exports.CTEBuilder=Tn,exports.CalculatedMeasureResolver=j,exports.ComparisonQueryBuilder=Ar,exports.DatabendExecutor=Ve,exports.DrizzlePlanBuilder=Ni,exports.DrizzleSqlBuilder=cn,exports.DuckDBExecutor=Ie,exports.EXPLAIN_ANALYSIS_PROMPT=fd,exports.FlowQueryBuilder=Mr,exports.FunnelQueryBuilder=jr,exports.IdentityOptimiser=Br,exports.JoinPathResolver=ln,exports.LogicalPlanBuilder=zr,exports.LogicalPlanner=Cn,exports.MemoryCacheProvider=rd,exports.MySQLExecutor=Te,exports.OptimiserPipeline=Vr,exports.PostgresExecutor=xe,exports.QueryExecutor=Fi,exports.RetentionQueryBuilder=Rr,exports.SQLiteExecutor=ke,exports.STEP0_VALIDATION_PROMPT=id,exports.STEP1_SYSTEM_PROMPT=cd,exports.STEP2_SYSTEM_PROMPT=ud,exports.SYSTEM_PROMPT_TEMPLATE=od,exports.SemanticLayerCompiler=td,exports.SnowflakeExecutor=qe,exports.aiValidateQuery=dp,exports.buildAgentSystemPrompt=Dd,exports.buildExplainAnalysisPrompt=pd,exports.buildStep0Prompt=ad,exports.buildStep1Prompt=ld,exports.buildStep2Prompt=dd,exports.buildSystemPrompt=sd,exports.createDatabaseExecutor=Ye,exports.createDatabendExecutor=He,exports.createDrizzleSemanticLayer=fp,exports.createDuckDBExecutor=Le,exports.createMultiCubeContext=tt,exports.createMySQLExecutor=Ee,exports.createPostgresExecutor=Se,exports.createSQLiteExecutor=Ae,exports.createSnowflakeExecutor=Je,exports.createToolExecutor=xf,exports.defineCube=nt,exports.detectQueryMode=er,exports.detectQueryModes=Qn,exports.discoverCubes=Ud,exports.findBestFieldMatch=Wd,exports.fnv1aHash=Er,exports.formatCubeSchemaForExplain=md,exports.formatExistingIndexes=hd,exports.generateCacheKey=yr,exports.getActiveQueryModes=$n,exports.getCubeInvalidationPattern=Or,exports.getJoinType=Ze,exports.getToolDefinitions=bf,exports.handleAgentChat=Pf,exports.hasComparisonMode=Jn,exports.hasFlowMode=Xn,exports.hasFunnelMode=Yn,exports.hasRetentionMode=Zn,exports.normalizeQuery=br,exports.resolveCubeReference=w,exports.resolveSqlExpression=T,exports.strongHash=Dr,exports.suggestQuery=Xf;
+`)}`,isError:!0};let i={portlets:n.map(e=>{let t=e.chartType,n=t===`markdown`,r=n?`query`:e.analysisType||`query`,i=r===`funnel`?`funnel`:r===`flow`?`flow`:r===`retention`?`retention`:`query`,a=e.query||`{}`,o;try{o=JSON.parse(a)}catch{o={}}let s={version:1,analysisType:i,activeView:`chart`,charts:{[i]:{chartType:t,chartConfig:e.chartConfig||{},displayConfig:e.displayConfig||{}}},query:n?{}:o};return{id:e.id,title:e.title,analysisConfig:s,dashboardFilterMapping:e.dashboardFilterMapping,w:e.w,h:e.h,x:e.x,y:e.y}}),filters:e.filters,colorPalette:e.colorPalette},a=e.title;return{result:`Dashboard "${a}" created with ${i.portlets.length} portlets and ${i.filters?.length||0} filters.`,sideEffect:{type:`dashboard_saved`,data:{title:a,description:e.description,dashboardConfig:i}}}}catch(e){return{result:`Failed to save dashboard: ${e instanceof Error?e.message:`Unknown error`}`,isError:!0}}}),r}async function Sf(e,t,n){switch(e){case`anthropic`:{let{AnthropicProvider:e}=await Promise.resolve().then(()=>require("./anthropic-DG4r1LSm.cjs"));return new e(t)}case`openai`:{let{OpenAIProvider:e}=await Promise.resolve().then(()=>require("./openai-DTSTMiXL.cjs"));return new e(t,n)}case`google`:{let{GoogleProvider:e}=await Promise.resolve().then(()=>require("./google-BOnRIN1w.cjs"));return new e(t)}default:throw Error(`Unknown LLM provider: "${e}". Supported providers: anthropic, openai, google`)}}function Cf(e,t){if(Array.isArray(t))for(let n of t)e.push(n);else e.push(t)}function wf(e){if(e)try{e()}catch{}}function Tf(e,t){let n=[];if(!e||e.length===0)return n;for(let r of e){if(r.role===`user`){n.push({role:`user`,content:r.content});continue}if(r.role!==`assistant`)continue;let e=[];if(r.content&&e.push({type:`text`,text:r.content}),r.toolCalls&&r.toolCalls.length>0){for(let t of r.toolCalls)e.push({type:`tool_use`,id:t.id,name:t.name,input:t.input||{}});n.push({role:`assistant`,content:e});let i=r.toolCalls.map(e=>({toolUseId:e.id,toolName:e.name,content:typeof e.result==`string`?e.result:JSON.stringify(e.result??``),isError:e.status===`error`}));Cf(n,t.formatToolResults(i))}else e.length>0&&n.push({role:`assistant`,content:r.content})}return n}function Ef(e,t){if(!(e?.type!==`tool_use`||!t))try{e.input=JSON.parse(t)}catch{e.input={}}}function Df(e,t){let n=e.contentBlocks[e.contentBlocks.length-1];n&&n.type===`text`?n.text=(n.text||``)+t:e.contentBlocks.push({type:`text`,text:t})}function Of(e,t){if(e.currentBlockIsToolUse&&e.currentToolInputJson){let t=e.contentBlocks[e.contentBlocks.length-1];if(t?.type===`tool_use`)try{t.input=JSON.parse(e.currentToolInputJson)}catch{}}e.contentBlocks.push({type:`tool_use`,id:t.id,name:t.name,input:{},...t.metadata?{metadata:t.metadata}:{}}),e.currentToolInputJson=``,e.currentBlockIsToolUse=!0}function kf(e,t){if(t.id&&t.input){let n=e.contentBlocks.find(e=>e.type===`tool_use`&&e.id===t.id);n&&(n.input=t.input)}else if(e.currentBlockIsToolUse){let t=e.contentBlocks[e.contentBlocks.length-1];t?.type===`tool_use`&&e.currentToolInputJson&&(Ef(t,e.currentToolInputJson),e.currentToolInputJson=``),e.currentBlockIsToolUse=!1}}async function*Af(e,t){let n={contentBlocks:[],currentToolInputJson:``,currentBlockIsToolUse:!1,stopReason:``};for await(let r of e.parseStreamEvents(t)){let e=r;switch(e.type){case`text_delta`:Df(n,e.text),yield{type:`text_delta`,data:e.text};break;case`tool_use_start`:Of(n,e),yield{type:`tool_use_start`,data:{id:e.id,name:e.name,input:void 0}};break;case`tool_input_delta`:n.currentToolInputJson+=e.json;break;case`tool_use_end`:kf(n,e);break;case`message_meta`:e.inputTokens!=null&&(n.inputTokens=e.inputTokens),e.outputTokens!=null&&(n.outputTokens=e.outputTokens),e.stopReason&&(n.stopReason=e.stopReason);break}}return{contentBlocks:n.contentBlocks,stopReason:n.stopReason,inputTokens:n.inputTokens,outputTokens:n.outputTokens}}async function*jf(e,t){let{executor:n,observability:r,traceId:i,turn:a}=t,o=e.name,s=e.input||{},c=e.id,l=n.get(o);if(!l)return yield{type:`tool_use_result`,data:{id:c,name:o,result:`Unknown tool: ${o}`,isError:!0}},{toolUseId:c,toolName:o,content:`Unknown tool: ${o}`,isError:!0};let u=Date.now();try{let e=await l(s);return e.sideEffect&&(yield e.sideEffect),yield{type:`tool_use_result`,data:{id:c,name:o,result:e.result,...e.isError?{isError:!0}:{}}},wf(()=>r?.onToolEnd?.({traceId:i,turn:a,toolName:o,toolUseId:c,isError:!!e.isError,durationMs:Date.now()-u})),{toolUseId:c,toolName:o,content:e.result,...e.isError?{isError:!0}:{}}}catch(e){let t=e instanceof Error?e.message:`Tool execution failed`;return yield{type:`tool_use_result`,data:{id:c,name:o,result:t,isError:!0}},wf(()=>r?.onToolEnd?.({traceId:i,turn:a,toolName:o,toolUseId:c,isError:!0,durationMs:Date.now()-u})),{toolUseId:c,toolName:o,content:t,isError:!0}}}async function*Mf(e,t){let n=[];for(let r of e){if(r.type!==`tool_use`)continue;let e=yield*jf(r,t);n.push(e)}return n}var Nf={anthropic:`claude-sonnet-4-6`,openai:`gpt-4.1-mini`,google:`gemini-3-flash-preview`};async function*Pf(e){let{message:t,history:n,semanticLayer:r,securityContext:i,agentConfig:a,apiKey:o}=e,s=e.sessionId||crypto.randomUUID(),c=a.observability,l=crypto.randomUUID(),u=Date.now(),d=e.providerOverride||a.provider||`anthropic`,f=e.modelOverride||a.model||Nf[d]||`claude-sonnet-4-6`,p=e.baseURLOverride||a.baseURL,m=a.maxTurns||25,h=a.maxTokens||4096,g;try{g=await Sf(d,o,{baseURL:p})}catch(e){console.error(`[agent] Failed to create %s provider: %s`,String(d).replace(/\n|\r/g,``),String(e instanceof Error?e.message:e).replace(/\n|\r/g,``)),yield{type:`error`,data:{message:e instanceof Error?e.message:k(`server.errors.llmInitFailed`)}};return}let _=bf(),v=xf({semanticLayer:r,securityContext:i}),y=Dd(r.getMetadata());e.systemContext&&(y+=`\n\n## User Context\n\n${e.systemContext}`),wf(()=>c?.onChatStart?.({traceId:l,sessionId:s,message:t,model:f,historyLength:n?.length??0}));let b=Tf(n,g);b.push({role:`user`,content:t});let x=0;try{for(let e=0;e<m;e++){x=e+1;let t=await g.createStream({model:f,maxTokens:h,system:y,tools:_,messages:b}),n=Date.now(),{contentBlocks:r,stopReason:i,inputTokens:a,outputTokens:o}=yield*Af(g,t);if(wf(()=>c?.onGenerationEnd?.({traceId:l,turn:e,model:f,stopReason:i,inputTokens:a,outputTokens:o,durationMs:Date.now()-n,input:b,output:r})),b.push({role:`assistant`,content:r}),!g.shouldContinue(i))break;let s=yield*Mf(r,{executor:v,observability:c,traceId:l,turn:e});yield{type:`turn_complete`,data:{}},Cf(b,g.formatToolResults(s))}wf(()=>c?.onChatEnd?.({traceId:l,sessionId:s,totalTurns:x,durationMs:Date.now()-u})),yield{type:`done`,data:{sessionId:s||``,traceId:l}}}catch(e){try{c?.onChatEnd?.({traceId:l,sessionId:s,totalTurns:0,durationMs:Date.now()-u,error:e instanceof Error?e.message:`Unknown error`})}catch{}console.error(`[agent] Chat error (provider=%s, model=%s): %s`,String(d).replace(/\n|\r/g,``),String(f).replace(/\n|\r/g,``),String(e instanceof Error?e.message:e).replace(/\n|\r/g,``)),yield{type:`error`,data:{message:g.formatError(e)}}}}function Ff(e){return e.toISOString().split(`T`)[0]}function If(e,t){let n=new Date,r=Ff(n);if(/days?/.test(t)){let t=new Date(n);return t.setDate(t.getDate()-e),{dateRange:[Ff(t),r],granularity:`day`}}if(/weeks?/.test(t)){let t=new Date(n);return t.setDate(t.getDate()-e*7),{dateRange:[Ff(t),r],granularity:e<=4?`day`:`week`}}if(/months?/.test(t)){let t=new Date(n);return t.setMonth(t.getMonth()-e),{dateRange:[Ff(t),r],granularity:e<=3?`day`:`month`}}return null}function Lf(e){let t=parseInt(e.slice(1),10),n=new Date().getFullYear(),r=(t-1)*3,i=new Date(n,r,1),a=new Date(n,r+3,0);return{dateRange:[Ff(i),Ff(a)],granularity:`month`}}function Rf(e,t,n,r){let i=0;for(let a of e.measures){let e=[(a.name.split(`.`).pop()||a.name).toLowerCase(),a.title.toLowerCase(),...(a.synonyms||[]).map(e=>e.toLowerCase())];for(let o of e)if(t.includes(o)){n.push(a.name),r.push(`Matched measure '${a.name}' via keyword '${o}'`),i+=.15;break}}return i}function zf(e,t,n,r){let i=e.measures.filter(e=>e.type===t.type);if(i.length>0){n.push(i[0].name),r.push(`Suggested ${i[0].name} based on ${t.type} intent`);return}if(t.type===`count`){let t=e.measures.find(e=>e.type===`count`||e.type===`countDistinct`);t&&(n.push(t.name),r.push(`Suggested ${t.name} for counting`))}}function Bf(e,t,n,r,i){let a=0;for(let n of t){let t=Wd(e,n,`dimension`);t&&(r.push(t.field),i.push(`Matched dimension '${t.field}' from grouping keyword '${n}'`),a+=.1)}for(let t of e)for(let e of t.dimensions){let t=[(e.name.split(`.`).pop()||e.name).toLowerCase(),e.title.toLowerCase(),...(e.synonyms||[]).map(e=>e.toLowerCase())];for(let o of t)if(n.includes(o)&&!r.includes(e.name)&&(n.includes(`by ${o}`)||n.includes(`per ${o}`))){r.push(e.name),i.push(`Matched dimension '${e.name}' as grouping`),a+=.1;break}}return a}function Vf(){let e=new Date,t=e.toISOString().split(`T`)[0],n=e=>e.toISOString().split(`T`)[0],r=e=>new Date(e.getFullYear(),e.getMonth(),1),i=e=>new Date(e.getFullYear(),0,1),a=e=>{let t=Math.floor(e.getMonth()/3);return new Date(e.getFullYear(),t*3,1)},o=e=>{let t=e.getDay(),n=e.getDate()-t+(t===0?-6:1);return new Date(e.getFullYear(),e.getMonth(),n)};return[{pattern:/\btoday\b/i,getDateRange:()=>[t,t],granularity:`day`},{pattern:/\byesterday\b/i,getDateRange:()=>{let t=new Date(e);t.setDate(t.getDate()-1);let r=n(t);return[r,r]},granularity:`day`},{pattern:/\bthis week\b/i,getDateRange:()=>[n(o(e)),t],granularity:`day`},{pattern:/\blast week\b/i,getDateRange:()=>{let t=new Date(o(e));t.setDate(t.getDate()-7);let r=new Date(t);return r.setDate(r.getDate()+6),[n(t),n(r)]},granularity:`day`},{pattern:/\bthis month\b/i,getDateRange:()=>[n(r(e)),t],granularity:`day`},{pattern:/\blast month\b/i,getDateRange:()=>{let t=new Date(e.getFullYear(),e.getMonth()-1,1),r=new Date(e.getFullYear(),e.getMonth(),0);return[n(t),n(r)]},granularity:`day`},{pattern:/\bthis quarter\b/i,getDateRange:()=>[n(a(e)),t],granularity:`month`},{pattern:/\blast quarter\b/i,getDateRange:()=>{let t=new Date(a(e));t.setMonth(t.getMonth()-3);let r=new Date(a(e));return r.setDate(r.getDate()-1),[n(t),n(r)]},granularity:`month`},{pattern:/\bthis year\b/i,getDateRange:()=>[n(i(e)),t],granularity:`month`},{pattern:/\blast year\b/i,getDateRange:()=>{let t=new Date(e.getFullYear()-1,0,1),r=new Date(e.getFullYear()-1,11,31);return[n(t),n(r)]},granularity:`month`},{pattern:/\blast (\d+) days?\b/i,getDateRange:()=>{let r=new Date(e);return r.setDate(r.getDate()-7),[n(r),t]},granularity:`day`},{pattern:/\blast (\d+) weeks?\b/i,getDateRange:()=>{let r=new Date(e);return r.setDate(r.getDate()-28),[n(r),t]},granularity:`week`},{pattern:/\blast (\d+) months?\b/i,getDateRange:()=>{let r=new Date(e);return r.setMonth(r.getMonth()-3),[n(r),t]},granularity:`month`},{pattern:/\bq([1-4])\b/i,getDateRange:()=>[n(new Date(e.getFullYear(),0,1)),n(new Date(e.getFullYear(),2,31))],granularity:`month`}]}var Hf={funnel:/\b(funnel|conversion|drop.?off|steps?|journey|pipeline|stages?)\b/i,flow:/\b(flows?|paths?|sequence|before|after|next|previous|user.?journey)\b/i,retention:/\b(retention|cohort|return|churn|comeback|retained|day.?\d+)\b/i};function Uf(e){let t=e.toLowerCase();return Hf.funnel.test(t)?`funnel`:Hf.flow.test(t)?`flow`:Hf.retention.test(t)?`retention`:`query`}function Wf(e,t){let n=t||`the relevant cube`;switch(e){case`funnel`:return[`Use /mcp/discover to get ${n} funnel configuration and schema`,`Query the event dimension to discover available event types for funnel steps`,`Build funnel query with discovered values using the schema from discover`];case`flow`:return[`Use /mcp/discover to get ${n} flow configuration and schema`,`Query the event dimension to discover available event types`,`Build flow query specifying the starting event and steps before/after`];case`retention`:return[`Use /mcp/discover to get ${n} retention configuration and schema`,`Build retention query specifying granularity (day/week/month) and number of periods`]}}function Gf(e){let t=Vf(),n=e.toLowerCase();for(let e of t){let t=n.match(e.pattern);if(t){if(t[1]&&/^\d+$/.test(t[1])){let e=If(parseInt(t[1],10),n);if(e)return e}return/^q[1-4]$/i.test(t[0])?Lf(t[0]):{dateRange:e.getDateRange(),granularity:e.granularity}}}return null}function Kf(e){let t=e.toLowerCase();for(let{pattern:e,type:n}of[{pattern:/\b(total|sum|combined)\b/i,type:`sum`},{pattern:/\b(count|number of|how many)\b/i,type:`count`},{pattern:/\b(average|avg|mean)\b/i,type:`avg`},{pattern:/\b(maximum|max|highest|top)\b/i,type:`max`},{pattern:/\b(minimum|min|lowest|bottom)\b/i,type:`min`}])if(e.test(t))return{type:n,confidence:.8};return null}function qf(e){let t=e.toLowerCase(),n=[],r=/\bby\s+(\w+(?:\s+\w+)?)/gi,i;for(;(i=r.exec(t))!==null;)n.push(i[1].trim());let a=/\bper\s+(\w+)/gi;for(;(i=a.exec(t))!==null;)n.push(i[1].trim());let o=/\bfor each\s+(\w+)/gi;for(;(i=o.exec(t))!==null;)n.push(i[1].trim());return n}function Jf(e,t,n,r,i){if(n){let t=e.find(e=>e.name===n);return t?(r.push(`Using specified cube: ${n}`),[t]):(i.push(`Specified cube '${n}' not found`),[])}let a=Ud(e,{intent:t,limit:3}).map(t=>e.find(e=>e.name===t.cube)).filter(e=>e!==void 0);return a.length>0&&r.push(`Identified relevant cubes: ${a.map(e=>e.name).join(`, `)}`),a}function Yf(e,t){return e===`query`?{query:{},confidence:0,reasoning:[`Could not identify relevant cubes for this query`],warnings:t,analysisMode:e,nextSteps:void 0}:{query:{},confidence:.7,reasoning:[`Detected ${e} intent from natural language`],warnings:t,analysisMode:e,nextSteps:Wf(e,void 0)}}function Xf(e,t,n){let r=[],i=[],a={},o=Uf(t),s=Jf(e,t,n,r,i);if(s.length===0)return Yf(o,i);let c=s[0],l=.5,u=Kf(t);u&&(r.push(`Detected ${u.type} aggregation intent`),l+=.1);let d=[],f=t.toLowerCase();l+=Rf(c,f,d,r),d.length===0&&u&&zf(c,u,d,r),d.length===0&&c.measures.length>0&&(d.push(c.measures[0].name),r.push(`Using default measure: ${c.measures[0].name}`),i.push(`Could not determine specific measure from query, using default`)),a.measures=d;let p=qf(t),m=[];l+=Bf(s,p,f,m,r),m.length>0&&(a.dimensions=m);let h=Gf(t);if(h){let e=c.dimensions.find(e=>e.type===`time`);if(e){let t={dimension:e.name,dateRange:h.dateRange};h.granularity&&(t.granularity=h.granularity),a.timeDimensions=[t],r.push(`Applied time filter: ${h.dateRange[0]} to ${h.dateRange[1]}`),l+=.15}else i.push(`Time expression found but no time dimension in cube`)}if(l=Math.min(1,l),o!==`query`){let e=s.length>0?s[0].name:void 0;return{query:{},confidence:.7,reasoning:[`Detected ${o} intent from natural language`,...e?[`Found relevant cube: ${e}`]:[]],warnings:i.length>0?i:void 0,analysisMode:o,nextSteps:Wf(o,e)}}return{query:a,confidence:l,reasoning:r,warnings:i.length>0?i:void 0,analysisMode:`query`}}function $(e,t,n,r){e?typeof e==`string`&&n(e,r):r.push({type:`syntax_error`,message:k(t)})}function Zf(e,t){return e.map(e=>t.get(e)||e)}function Qf(e,t){if(t.size===0)return;let n=JSON.parse(JSON.stringify(e));return n.measures&&=Zf(n.measures,t),n.dimensions&&=Zf(n.dimensions,t),n.timeDimensions&&=n.timeDimensions.map(e=>({...e,dimension:t.get(e.dimension)||e.dimension})),n}function $f(e,t){e.measures&&e.measures.length>10&&t.push({type:`performance`,message:k(`server.validation.ai.performanceManyMeasures`,{count:e.measures.length}),suggestion:k(`server.validation.ai.suggestSplitQueries`)}),e.dimensions&&e.dimensions.length>5&&t.push({type:`performance`,message:k(`server.validation.ai.performanceManyDimensions`,{count:e.dimensions.length}),suggestion:k(`server.validation.ai.suggestAddDimensionFilters`)})}function ep(e,t,n){let[r]=e.split(`.`),i=t.find(e=>e.name===r);if(!i)return;let a=i.dimensions.find(t=>t.name===e);a&&a.type!==`time`&&n.push({type:`best_practice`,message:k(`server.validation.ai.dimensionNotTimeType`,{dimension:e,type:a.type}),field:e,suggestion:k(`server.validation.ai.suggestUseTimeDimension`)})}function tp(e,t,n,r,i){let a=e.member,o=a.split(`.`);if(o.length!==2){n.push({type:`invalid_filter`,message:k(`server.validation.ai.invalidFilterMemberFormat`,{member:a}),field:a});return}let[s,c]=o,l=t.find(e=>e.name===s);if(!l){let e=i(s,t.map(e=>e.name));e&&r.set(a,`${e.field}.${c}`),n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundInFilter`,{cubeName:s}),field:a,suggestion:e?`Did you mean '${e.field}'?`:void 0,correctedValue:e?`${e.field}.${c}`:void 0});return}let u=l.dimensions.some(e=>e.name===a),d=l.measures.some(e=>e.name===a);if(u||d)return;let f=i(c,[...l.dimensions.map(e=>e.name.split(`.`).pop()),...l.measures.map(e=>e.name.split(`.`).pop())]);if(f){let e=`${s}.${f.field}`;r.set(a,e),n.push({type:`invalid_filter`,message:k(`server.validation.ai.filterFieldNotFoundWithSuggestion`,{fieldName:c,cubeName:s}),field:a,suggestion:`Did you mean '${f.field}'?`,correctedValue:e})}else n.push({type:`invalid_filter`,message:k(`server.validation.ai.filterFieldNotFound`,{fieldName:c,cubeName:s}),field:a})}function np(e,t){let n=null;for(let r of t){let t=Nd(e.toLowerCase(),r.toLowerCase());t<=3&&(!n||t<n.distance)&&(n={field:r,distance:t})}return n}function rp(e,t,n,r){let i=e.split(`.`);if(i.length!==2){n.push({type:`syntax_error`,message:k(`server.validation.ai.invalidMeasureFormat`,{measure:e}),field:e});return}let[a,o]=i,s=t.find(e=>e.name===a);if(!s){let i=t.map(e=>e.name),s=np(a,i);s?(n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundWithSuggestion`,{cubeName:a}),field:e,suggestion:`Did you mean '${s.field}'?`,correctedValue:`${s.field}.${o}`}),r.set(e,`${s.field}.${o}`)):n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundWithAvailable`,{cubeName:a}),field:e,suggestion:`Available cubes: ${i.join(`, `)}`});return}if(!s.measures.some(t=>t.name===e)){let i=Wd(t,o,`measure`);if(i&&i.cube===a)n.push({type:`measure_not_found`,message:k(`server.validation.ai.measureNotFoundWithSuggestion`,{measureName:o,cubeName:a}),field:e,suggestion:`Did you mean '${i.field}'?`,correctedValue:i.field}),r.set(e,i.field);else{let t=s.measures.map(e=>e.name.split(`.`).pop()),i=np(o,t);if(i){let t=`${a}.${i.field}`;n.push({type:`measure_not_found`,message:k(`server.validation.ai.measureNotFoundWithSuggestion`,{measureName:o,cubeName:a}),field:e,suggestion:`Did you mean '${i.field}'?`,correctedValue:t}),r.set(e,t)}else n.push({type:`measure_not_found`,message:k(`server.validation.ai.measureNotFoundWithAvailable`,{measureName:o,cubeName:a}),field:e,suggestion:`Available measures: ${t.slice(0,5).join(`, `)}${t.length>5?`...`:``}`})}}}function ip(e,t,n,r){let i=e.split(`.`);if(i.length!==2){n.push({type:`syntax_error`,message:k(`server.validation.ai.invalidDimensionFormat`,{dimension:e}),field:e});return}let[a,o]=i,s=t.find(e=>e.name===a);if(!s){let i=t.map(e=>e.name),s=np(a,i);s?(n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundWithSuggestion`,{cubeName:a}),field:e,suggestion:`Did you mean '${s.field}'?`,correctedValue:`${s.field}.${o}`}),r.set(e,`${s.field}.${o}`)):n.push({type:`cube_not_found`,message:k(`server.validation.ai.cubeNotFoundWithAvailable`,{cubeName:a}),field:e,suggestion:`Available cubes: ${i.join(`, `)}`});return}if(!s.dimensions.some(t=>t.name===e)){let i=Wd(t,o,`dimension`);if(i&&i.cube===a)n.push({type:`dimension_not_found`,message:k(`server.validation.ai.dimensionNotFoundWithSuggestion`,{dimensionName:o,cubeName:a}),field:e,suggestion:`Did you mean '${i.field}'?`,correctedValue:i.field}),r.set(e,i.field);else{let t=s.dimensions.map(e=>e.name.split(`.`).pop()),i=np(o,t);if(i){let t=`${a}.${i.field}`;n.push({type:`dimension_not_found`,message:k(`server.validation.ai.dimensionNotFoundWithSuggestion`,{dimensionName:o,cubeName:a}),field:e,suggestion:`Did you mean '${i.field}'?`,correctedValue:t}),r.set(e,t)}else n.push({type:`dimension_not_found`,message:k(`server.validation.ai.dimensionNotFoundWithAvailable`,{dimensionName:o,cubeName:a}),field:e,suggestion:`Available dimensions: ${t.slice(0,5).join(`, `)}${t.length>5?`...`:``}`})}}}function ap(e,t,n,r){for(let i of e){if(`and`in i&&Array.isArray(i.and)){ap(i.and,t,n,r);continue}if(`or`in i&&Array.isArray(i.or)){ap(i.or,t,n,r);continue}`member`in i&&tp(i,t,n,r,np)}}function op(e,t,n,r,i){let a=e.funnel;if(!a)return;let o=(e,n)=>ip(e,t,n,i);if($(a.bindingKey,`server.validation.ai.bindingKeyRequired.funnel`,o,n),$(a.timeDimension,`server.validation.ai.timeDimensionRequired.funnel`,o,n),!a.steps||!Array.isArray(a.steps))n.push({type:`syntax_error`,message:k(`server.validation.ai.funnelStepsRequired`)});else if(a.steps.length<2)n.push({type:`syntax_error`,message:k(`server.validation.ai.funnelRequiresSteps`)});else for(let e=0;e<a.steps.length;e++){let o=a.steps[e];o.name||r.push({type:`best_practice`,message:k(`server.validation.ai.stepMissingName`,{step:e+1}),suggestion:k(`server.validation.ai.suggestAddStepNames`)}),o.filter&&`member`in o.filter&&ap([o.filter],t,n,i)}}function sp(e,t,n,r,i){let a=e.flow;if(!a)return;let o=(e,n)=>ip(e,t,n,i);$(a.bindingKey,`server.validation.ai.bindingKeyRequired.flow`,o,n),$(a.timeDimension,`server.validation.ai.timeDimensionRequired.flow`,o,n),$(a.eventDimension,`server.validation.ai.eventDimensionRequired`,o,n),a.stepsBefore===void 0&&a.stepsAfter===void 0&&r.push({type:`best_practice`,message:k(`server.validation.ai.stepsBothMissing`),suggestion:k(`server.validation.ai.suggestSetSteps`)})}function cp(e,t,n,r,i){let a=e.retention;if(!a)return;let o=(e,n)=>ip(e,t,n,i);$(a.bindingKey,`server.validation.ai.bindingKeyRequired.retention`,o,n),$(a.timeDimension,`server.validation.ai.retentionTimeDimensionRequired`,o,n),a.granularity||r.push({type:`best_practice`,message:k(`server.validation.ai.granularityNotSpecified`),suggestion:k(`server.validation.ai.suggestSpecifyGranularity`)}),a.periods||r.push({type:`best_practice`,message:k(`server.validation.ai.periodsNotSpecified`),suggestion:k(`server.validation.ai.suggestSpecifyPeriods`)})}function lp(e,t,n,r,i){return e.funnel?(op(e,t,n,r,i),!0):e.flow?(sp(e,t,n,r,i),!0):e.retention?(cp(e,t,n,r,i),!0):!1}function up(e,t,n,r,i){if(e.measures)for(let r of e.measures)rp(r,t,n,i);if(e.dimensions)for(let r of e.dimensions)ip(r,t,n,i);if(e.timeDimensions)for(let a of e.timeDimensions)ip(a.dimension,t,n,i),ep(a.dimension,t,r);e.filters&&ap(e.filters,t,n,i),!e.measures?.length&&!e.dimensions?.length&&n.push({type:`syntax_error`,message:k(`server.validation.ai.emptyQuery`)}),$f(e,r)}function dp(e,t){let n=[],r=[],i=new Map;if(lp(e,t,n,r,i))return{isValid:n.length===0,errors:n,warnings:r,correctedQuery:void 0};up(e,t,n,r,i);let a=Qf(e,i);return{isValid:n.length===0,errors:n,warnings:r,correctedQuery:a}}function fp(e){return new td({drizzle:e.drizzle,schema:e.schema})}exports.BaseDatabaseExecutor=S,exports.CTEBuilder=Tn,exports.CalculatedMeasureResolver=j,exports.ComparisonQueryBuilder=Ar,exports.DatabendExecutor=Ve,exports.DrizzlePlanBuilder=Ni,exports.DrizzleSqlBuilder=cn,exports.DuckDBExecutor=Ie,exports.EXPLAIN_ANALYSIS_PROMPT=fd,exports.FlowQueryBuilder=Mr,exports.FunnelQueryBuilder=jr,exports.IdentityOptimiser=Br,exports.JoinPathResolver=ln,exports.LogicalPlanBuilder=zr,exports.LogicalPlanner=Cn,exports.MemoryCacheProvider=rd,exports.MySQLExecutor=Te,exports.OptimiserPipeline=Vr,exports.PostgresExecutor=xe,exports.QueryExecutor=Fi,exports.RetentionQueryBuilder=Rr,exports.SQLiteExecutor=ke,exports.STEP0_VALIDATION_PROMPT=id,exports.STEP1_SYSTEM_PROMPT=cd,exports.STEP2_SYSTEM_PROMPT=ud,exports.SYSTEM_PROMPT_TEMPLATE=od,exports.SemanticLayerCompiler=td,exports.SnowflakeExecutor=qe,exports.aiValidateQuery=dp,exports.buildAgentSystemPrompt=Dd,exports.buildExplainAnalysisPrompt=pd,exports.buildStep0Prompt=ad,exports.buildStep1Prompt=ld,exports.buildStep2Prompt=dd,exports.buildSystemPrompt=sd,exports.createDatabaseExecutor=Ye,exports.createDatabendExecutor=He,exports.createDrizzleSemanticLayer=fp,exports.createDuckDBExecutor=Le,exports.createMultiCubeContext=tt,exports.createMySQLExecutor=Ee,exports.createPostgresExecutor=Se,exports.createSQLiteExecutor=Ae,exports.createSnowflakeExecutor=Je,exports.createToolExecutor=xf,exports.defineCube=nt,exports.detectQueryMode=er,exports.detectQueryModes=Qn,exports.discoverCubes=Ud,exports.findBestFieldMatch=Wd,exports.fnv1aHash=Er,exports.formatCubeSchemaForExplain=md,exports.formatExistingIndexes=hd,exports.generateCacheKey=yr,exports.getActiveQueryModes=$n,exports.getCubeInvalidationPattern=Or,exports.getJoinType=Ze,exports.getToolDefinitions=bf,exports.handleAgentChat=Pf,exports.hasComparisonMode=Jn,exports.hasFlowMode=Xn,exports.hasFunnelMode=Yn,exports.hasRetentionMode=Zn,exports.normalizeQuery=br,exports.resolveCubeReference=w,exports.resolveSqlExpression=T,exports.strongHash=Dr,exports.suggestQuery=Xf;

package/dist/server/index.d.ts

@@ -1,2 +1,38 @@
-export * from './server/index.js'
-export {}
+import { DrizzleDatabase } from './types/index.js';
+import { SemanticLayerCompiler } from './compiler.js';
+/**
+ * Drizzle Cube - Semantic Layer for Drizzle ORM
+ * Drizzle ORM-first semantic layer with Cube.js compatibility
+ */
+export { SemanticLayerCompiler } from './compiler.js';
+export { QueryExecutor } from './executor.js';
+export { detectQueryMode, detectQueryModes, getActiveQueryModes, hasComparisonMode, hasFunnelMode, hasFlowMode, hasRetentionMode } from './query-modes.js';
+export type { QueryMode, QueryModeFlags } from './query-modes.js';
+export { LogicalPlanner } from './logical-plan/index.js';
+export { DrizzleSqlBuilder } from './physical-plan/index.js';
+export { CTEBuilder, ComparisonQueryBuilder, FunnelQueryBuilder, FlowQueryBuilder, RetentionQueryBuilder } from './builders/index.js';
+export { CalculatedMeasureResolver, JoinPathResolver } from './resolvers/index.js';
+export { LogicalPlanBuilder, IdentityOptimiser, OptimiserPipeline } from './logical-plan/index.js';
+export type { LogicalNode, QueryNode, SimpleSource, CTEPreAggregate, CubeRef, MeasureRef, DimensionRef, LogicalPlanWithAnalysis, PlanOptimiser, OptimiserContext } from './logical-plan/index.js';
+export { DrizzlePlanBuilder } from './physical-plan/index.js';
+export { createDatabaseExecutor, createPostgresExecutor, createSQLiteExecutor, createMySQLExecutor, createDuckDBExecutor, createDatabendExecutor, createSnowflakeExecutor, BaseDatabaseExecutor, PostgresExecutor, SQLiteExecutor, MySQLExecutor, DuckDBExecutor, DatabendExecutor, SnowflakeExecutor } from './executors/index.js';
+export { resolveSqlExpression, createMultiCubeContext, resolveCubeReference, getJoinType } from './cube-utils.js';
+export { defineCube } from './cube-utils.js';
+export { generateCacheKey, normalizeQuery, fnv1aHash, strongHash, getCubeInvalidationPattern } from './cache-utils.js';
+export { MemoryCacheProvider } from './cache-providers/index.js';
+export { STEP0_VALIDATION_PROMPT, SYSTEM_PROMPT_TEMPLATE, STEP1_SYSTEM_PROMPT, STEP2_SYSTEM_PROMPT, buildStep0Prompt, buildSystemPrompt, buildStep1Prompt, buildStep2Prompt, EXPLAIN_ANALYSIS_PROMPT, buildExplainAnalysisPrompt, formatCubeSchemaForExplain, formatExistingIndexes } from './prompts/index.js';
+export type { Step0Result, PromptContext, DimensionValues, Step1Result } from './prompts/index.js';
+export { handleAgentChat, getToolDefinitions, createToolExecutor, buildAgentSystemPrompt } from './agent/index.js';
+export type { AgentChatRequest, AgentConfig, AgentObservabilityHooks, AgentSSEEvent, PortletBlockData, MarkdownBlockData, ToolExecutionResult } from './agent/index.js';
+export { discoverCubes, findBestFieldMatch, suggestQuery, validateQuery as aiValidateQuery } from './ai/index.js';
+export type { CubeDiscoveryResult, DiscoveryOptions, QuerySuggestion, ValidationResult as AIValidationResult, ValidationError as AIValidationError, ValidationWarning as AIValidationWarning } from './ai/index.js';
+export type * from './types/index.js';
+export type { SQL } from 'drizzle-orm';
+/**
+ * Create a new semantic layer instance with Drizzle integration
+ * Use this when you need multiple isolated instances
+ */
+export declare function createDrizzleSemanticLayer(options: {
+    drizzle: DrizzleDatabase;
+    schema?: any;
+}): SemanticLayerCompiler;

package/dist/server/index.js

@@ -16754,7 +16754,7 @@ async function Kf(e, t, n) {
 			return new e(t);
 		}
 		case "openai": {
-			let { OpenAIProvider: e } = await import("./openai-cDlFSTk6.js");
+			let { OpenAIProvider: e } = await import("./openai-CtXqeznO.js");
 			return new e(t, n);
 		}
 		case "google": {

package/dist/server/logical-plan/cte-planner-helpers.d.ts

@@ -0,0 +1,37 @@
+import { Cube, CubeJoin, SemanticQuery } from '../types/index.js';
+/** A resolved CTE join key (column names plus the underlying column objects). */
+export interface CTEJoinKey {
+    sourceColumn: string;
+    targetColumn: string;
+    sourceColumnObj: any;
+    targetColumnObj: any;
+}
+/** A join definition located relative to a primary/target cube pair. */
+export interface FoundJoinInfo {
+    sourceCube: Cube;
+    joinDef: CubeJoin;
+    reversed?: boolean;
+}
+/**
+ * Derive the CTE join keys for a located join definition, handling
+ * belongsToMany junctions and reversed (belongsTo-back-to-primary) joins.
+ */
+export declare function deriveCTEJoinKeys(joinInfo: FoundJoinInfo, primaryCube: Cube): CTEJoinKey[];
+/**
+ * Derive the join keys connecting a downstream dimension cube through the CTE
+ * cube, handling belongsToMany (via junction sourceKey) and regular joins.
+ */
+export declare function deriveDownstreamJoinKeys(joinDef: CubeJoin): CTEJoinKey[];
+/**
+ * Find join information for a target cube, searching (in priority order):
+ * 1. The primary cube's direct join to the target.
+ * 2. The target cube's join back to the primary (reverse lookup → reversed).
+ * 3. Any other registered cube's join to the target.
+ */
+export declare function findJoinInfoForCube(cubes: Map<string, Cube>, primaryCube: Cube, targetCubeName: string): FoundJoinInfo | null;
+/**
+ * Collect the names of cubes (other than the CTE cube) that contribute
+ * dimensions, time dimensions, or filter members to the query. These are the
+ * candidate downstream cubes that may need to join through the CTE.
+ */
+export declare function collectDimensionCubeNames(query: SemanticQuery, cteCubeName: string): Set<string>;

package/dist/server/logical-plan/cte-planner.d.ts

@@ -0,0 +1,104 @@
+import { Cube, QueryContext, PhysicalQueryPlan, SemanticQuery } from '../types/index.js';
+import { ResolverCache } from './planner-utils.js';
+import { FilterPropagation } from './filter-propagation.js';
+import { JoinRef } from './types.js';
+export declare class CTEPlanner {
+    private readonly resolverCache;
+    private readonly filterPropagation;
+    constructor(resolverCache: ResolverCache, filterPropagation: FilterPropagation);
+    /**
+     * Plan pre-aggregation CTEs for hasMany relationships to prevent fan-out
+     * Note: belongsToMany relationships handle fan-out differently through their junction table structure
+     * and don't require CTEs - the two-hop join with the junction table provides natural grouping
+     *
+     * CRITICAL FAN-OUT PREVENTION LOGIC:
+     * When a query contains ANY hasMany relationship in the join graph, ALL cubes with measures
+     * that could be affected by row multiplication need CTEs. This includes:
+     *
+     * 1. Cubes with direct hasMany FROM primary (existing logic)
+     * 2. Cubes with measures that would be multiplied due to hasMany elsewhere in the query
+     *    - Example: Query has Departments.totalBudget + Productivity.recordCount
+     *    - Employees hasMany → Productivity causes row multiplication
+     *    - Departments.totalBudget would be inflated without CTE pre-aggregation
+     */
+    planPreAggregationCTEs(cubes: Map<string, Cube>, primaryCube: Cube, joinCubes: JoinRef[], query: SemanticQuery, _ctx: QueryContext): PhysicalQueryPlan['preAggregationCTEs'];
+    /**
+     * Build a single pre-aggregation CTE for one join-cube entry, or return null
+     * when the cube contributes no aggregate measures / has no resolvable join.
+     */
+    private buildCTEForJoinCube;
+    /**
+     * Resolve the join keys (and any intermediate joins to absorb) for a CTE cube.
+     *
+     * Analyses the path from primary to the CTE cube: if an intermediate hasMany
+     * exists, returns the corrected keys plus intermediate joins; otherwise locates
+     * the join definition and derives keys from it.
+     */
+    private resolveCTEJoinKeys;
+    /**
+     * Locate the join definition for a CTE cube, preferring the final step of the
+     * analysed path and falling back to a primary/reverse/any-cube search.
+     */
+    private locateJoinInfo;
+    /**
+     * Analyze the join path from primary cube to a target CTE cube.
+     * Detects if there are intermediate hasMany relationships that would cause fan-out.
+     *
+     * Returns information about:
+     * - The full join path
+     * - Whether there are hasMany relationships ON the path (not just at the end)
+     * - Which intermediate tables need to be absorbed into the CTE
+     * - The correct join key to use (from primary cube's connection point)
+     *
+     * @param cubes Map of all registered cubes
+     * @param primaryCube The primary cube (FROM clause)
+     * @param targetCubeName The CTE cube we're analyzing the path to
+     * @param query The semantic query (drives query-aware path selection)
+     */
+    private analyzeJoinPathToPrimary;
+    /**
+     * Compute CTE reasons from the actual join plan entries.
+     *
+     * Instead of scanning all registered cubes (which causes false positives when
+     * unrelated hasMany relationships exist), this walks only the planned joins
+     * using the `relationship` field now stored on each JoinCubePlanEntry.
+     *
+     * Algorithm:
+     * 1. Scan join plan entries for hasMany/belongsToMany relationships
+     * 2. If none found → return empty map (no CTEs needed)
+     * 3. hasMany/belongsToMany targets with measures → 'hasMany'
+     * 4. Other join cubes with measures (not hasMany source) → 'fanOutPrevention'
+     */
+    private computeCTEReasons;
+    /**
+     * Find downstream cubes that need join keys included in the CTE.
+     *
+     * When a query has dimensions from a cube (e.g., Teams.name) and measures from
+     * a junction cube (e.g., EmployeeTeams.count), the junction CTE needs to include
+     * the join key to the dimension cube (team_id) so the dimension cube can be
+     * joined through the CTE instead of via an alternative path.
+     *
+     * @param cteCube The cube being converted to a CTE (e.g., EmployeeTeams)
+     * @param query The semantic query with dimensions and measures
+     * @param allCubes Map of all registered cubes
+     * @returns Array of downstream join key info for cubes needing join through this CTE
+     */
+    private findDownstreamJoinKeys;
+    /**
+     * Expand calculated measures to include their dependencies
+     */
+    private expandCalculatedMeasureDependencies;
+    /**
+     * Extract measure references from calculatedSql template
+     */
+    private extractDependenciesFromTemplate;
+    /**
+     * Extract measures referenced in filters (for CTE inclusion)
+     */
+    private extractMeasuresFromFilters;
+    /**
+     * Recursively extract measures from filters for a specific cube
+     * Only includes filter members that are actually measures (not dimensions)
+     */
+    private extractMeasuresFromFilter;
+}

package/dist/server/logical-plan/filter-propagation.d.ts

@@ -0,0 +1,44 @@
+import { Cube, SemanticQuery, PropagatingFilter, Filter } from '../types/index.js';
+export declare class FilterPropagation {
+    /**
+     * Find filters that need to propagate from related cubes to a CTE cube.
+     * When cube A has filters and a hasMany relationship to cube B (the CTE cube),
+     * A's filters should propagate into B's CTE via a subquery.
+     *
+     * Example: Employees.createdAt filter should propagate to Productivity CTE
+     * via: employee_id IN (SELECT id FROM employees WHERE created_at >= $date)
+     */
+    findPropagatingFilters(query: SemanticQuery, cteCube: Cube, allCubes: Map<string, Cube>): PropagatingFilter[];
+    /**
+     * Collect cube names referenced by filters and by time-dimension date ranges.
+     */
+    private collectFilterCubeNames;
+    /**
+     * Build a single PropagatingFilter for a filterCube → cteCube hasMany edge,
+     * or null when the cube contributes no filters / the join has no keys.
+     */
+    private buildPropagatingFilter;
+    /**
+     * Extract cube names from filters into a Set (helper for findPropagatingFilters)
+     */
+    extractFilterCubeNamesToSet(filters: Filter[], cubesSet: Set<string>): void;
+    /**
+     * Extract filters for a specific cube from the filter array
+     *
+     * Logic for preserving filter semantics:
+     * - AND: Safe to extract only matching branches (AND of fewer conditions is more permissive)
+     * - OR: Must include ALL branches or skip entirely (partial OR changes semantics)
+     *       If any branch belongs to another cube, skip the entire OR to be safe
+     *       since we can't evaluate the other cube's conditions
+     */
+    extractFiltersForCube(filters: Filter[], targetCubeName: string): Filter[];
+    /**
+     * Check if all simple filters in a filter array belong to the specified cube
+     * Recursively checks nested AND/OR filters
+     */
+    allFiltersFromCube(filters: Filter[], targetCubeName: string): boolean;
+    /**
+     * Extract time dimension date range filters as regular filters for a specific cube
+     */
+    extractTimeDimensionFiltersForCube(query: SemanticQuery, targetCubeName: string): Filter[];
+}

package/dist/server/logical-plan/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Logical Plan module — multi-stage query pipeline.
+ *
+ * Exports:
+ * - Types: LogicalNode tree types
+ * - LogicalPlanBuilder: SemanticQuery → LogicalNode tree
+ * - Optimisers: PlanOptimiser interface and built-in passes
+ */
+export type { LogicalNode, LogicalNodeType, LogicalNodeBase, QueryNode, SimpleSource, FullKeyAggregate, CTEPreAggregate, KeysDeduplication, MultiFactMerge, CubeRef, MeasureRef, DimensionRef, TimeDimensionRef, ColumnRef, OrderByRef, JoinRef, LogicalSchema } from './types.js';
+export { LogicalPlanner } from './logical-planner.js';
+export { LogicalPlanBuilder } from './logical-plan-builder.js';
+export type { LogicalPlanWithAnalysis } from './logical-plan-builder.js';
+export { JoinPlanner } from './join-planner.js';
+export { CTEPlanner } from './cte-planner.js';
+export { FilterPropagation } from './filter-propagation.js';
+export { PlanAnalysisReporter } from './plan-analysis-reporter.js';
+export { ResolverCache, analyzeCubeUsage, extractCubeNamesFromFilter } from './planner-utils.js';
+export type { PlanOptimiser, OptimiserContext, OptimiserEngineType } from './optimiser.js';
+export { IdentityOptimiser, OptimiserPipeline } from './optimiser.js';

package/dist/server/logical-plan/join-planner.d.ts

@@ -0,0 +1,27 @@
+import { Cube, CubeJoin, SemanticQuery } from '../types/index.js';
+import { ResolverCache } from './planner-utils.js';
+import { JoinRef } from './types.js';
+export declare class JoinPlanner {
+    private readonly resolverCache;
+    constructor(resolverCache: ResolverCache);
+    /**
+     * Build join plan for multi-cube query
+     * Supports both direct joins and transitive joins through intermediate cubes
+     *
+     * Uses query-aware path selection to prefer joining through cubes that have
+     * measures in the query (e.g., joining Teams through EmployeeTeams when
+     * EmployeeTeams.count is a measure)
+     */
+    buildJoinPlan(cubes: Map<string, Cube>, primaryCube: Cube, cubeNames: string[], _ctx: unknown, query: SemanticQuery): JoinRef[];
+    /**
+     * Build a single symbolic JoinRef for a join-path step. Handles belongsToMany
+     * (junction-table) joins and regular (belongsTo/hasOne/hasMany) joins. The join
+     * conditions and security WHERE are materialized later by DrizzlePlanBuilder;
+     * only the join type is resolved here (it depends on the effective relationship).
+     */
+    private buildJoinRef;
+    /**
+     * Find hasMany join definition from primary cube to target cube
+     */
+    findHasManyJoinDef(primaryCube: Cube, targetCubeName: string, cubes?: Map<string, Cube>): CubeJoin | null;
+}

package/dist/server/logical-plan/logical-plan-builder.d.ts

@@ -0,0 +1,58 @@
+import { Cube, QueryContext } from '../types/index.js';
+import { QueryAnalysis } from '../types/analysis.js';
+import { SemanticQuery } from '../types/query.js';
+import { LogicalPlanner } from './logical-planner.js';
+import { QueryNode } from './types.js';
+export interface LogicalPlanWithAnalysis {
+    plan: QueryNode;
+    analysis: QueryAnalysis;
+}
+export declare class LogicalPlanBuilder {
+    private readonly queryPlanner;
+    constructor(queryPlanner: LogicalPlanner);
+    /**
+     * Build a logical plan from a semantic query.
+     */
+    plan(cubes: Map<string, Cube>, query: SemanticQuery, ctx: QueryContext): QueryNode;
+    /**
+     * Build a logical plan and an explicit decision trace for dry-run/explain.
+     * The analysis is produced from the same phase outputs used to build the plan.
+     */
+    planWithAnalysis(cubes: Map<string, Cube>, query: SemanticQuery, ctx: QueryContext): LogicalPlanWithAnalysis;
+    private buildSourceFromPhases;
+    private buildSimpleSourceFromPhases;
+    /**
+     * Detect and build multi-fact merge for star-schema style queries where:
+     * - measures come from 2+ cubes
+     * - all grouping dimensions/timeDimensions come from one shared dimension cube
+     * - each measure cube directly belongsTo/hasOne that shared cube
+     */
+    private tryBuildMultiFactMergeSource;
+    private hasDirectJoinToSharedDimension;
+    private buildGroupQueryNode;
+    private projectFiltersToAllowedCubes;
+    private projectFilterNodeToAllowedCubes;
+    private classifyMeasuresForStrategy;
+    private selectMeasureStrategy;
+    /**
+     * Initial execution scope for keys deduplication:
+     * - exactly one multiplied cube
+     * - all query measures belong to that cube
+     * - only additive measure types currently handled by the physical keys path
+     * - no measure filters (HAVING) in the query
+     */
+    private isKeysDeduplicationExecutionSupported;
+    private queryHasMeasureFilter;
+    private buildKeysDeduplicationSource;
+    private isDeduplicationSafeMeasure;
+    private getPrimaryKeyColumns;
+    private deduplicateColumnRefs;
+    private buildQueryNode;
+    private buildPreAggregationAnalysis;
+    private buildMeasureRefs;
+    private buildDimensionRefs;
+    private buildTimeDimensionRefs;
+    private buildOrderByRefs;
+    private toCubeRef;
+    private buildCTESchema;
+}

package/dist/server/logical-plan/logical-planner.d.ts

@@ -0,0 +1,39 @@
+import { Cube, QueryContext, PhysicalQueryPlan, SemanticQuery, PrimaryCubeAnalysis, JoinPathAnalysis, QueryWarning } from '../types/index.js';
+import { JoinRef } from './types.js';
+export declare class LogicalPlanner {
+    private readonly resolverCache;
+    private readonly joinPlanner;
+    private readonly ctePlanner;
+    private readonly reporter;
+    /**
+     * Analyze a semantic query to determine which cubes are involved
+     */
+    analyzeCubeUsage(query: SemanticQuery): Set<string>;
+    /**
+     * Analyze primary cube selection with candidate details.
+     * Exposed for LogicalPlanBuilder so dry-run/analyze can report
+     * exactly which selection rule was used.
+     */
+    analyzePrimaryCube(cubeNames: string[], query: SemanticQuery, cubes: Map<string, Cube>): PrimaryCubeAnalysis;
+    /**
+     * Analyze join path for a specific target cube.
+     * Exposed for LogicalPlanBuilder to provide join decision trace.
+     */
+    analyzeJoinPathForTarget(cubes: Map<string, Cube>, fromCube: string, toCube: string, query?: SemanticQuery): JoinPathAnalysis;
+    /**
+     * Build join plan for a known primary cube.
+     * Exposed for LogicalPlanBuilder so logical planning can compose
+     * planner phases directly.
+     */
+    buildJoinPlanForPrimary(cubes: Map<string, Cube>, primaryCube: Cube, cubeNames: string[], ctx: QueryContext, query: SemanticQuery): JoinRef[];
+    /**
+     * Build pre-aggregation CTE plan from a primary cube and join plan.
+     * Exposed for LogicalPlanBuilder phase composition.
+     */
+    buildPreAggregationCTEs(cubes: Map<string, Cube>, primaryCube: Cube, joinCubes: JoinRef[], query: SemanticQuery, ctx: QueryContext): PhysicalQueryPlan['preAggregationCTEs'];
+    /**
+     * Generate query warnings from pre-aggregation analysis.
+     * Exposed for LogicalPlanBuilder phase composition.
+     */
+    buildWarnings(query: SemanticQuery, preAggregationCTEs?: PhysicalQueryPlan['preAggregationCTEs']): QueryWarning[];
+}