@hypequery/mcp 0.8.3 → 0.8.4

package/dist/prompts/dataset-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataset-guide.d.ts","sourceRoot":"","sources":["../../src/prompts/dataset-guide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM;;;;;;;;EAuIjF"}
+{"version":3,"file":"dataset-guide.d.ts","sourceRoot":"","sources":["../../src/prompts/dataset-guide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM;;;;;;;;EA+IjF"}

package/dist/prompts/dataset-guide.js

@@ -3,6 +3,7 @@
  *
  * Provides natural language guidance for querying datasets.
  */
+import { getDatasetCatalog } from '@hypequery/datasets';
 export function datasetGuidePrompt(datasets, datasetName) {
     if (datasetName) {
         const dataset = datasets[datasetName];
@@ -12,7 +13,10 @@ export function datasetGuidePrompt(datasets, datasetName) {
         const datasetAny = dataset;
         // Generate dataset-specific guide
         const dimensions = datasetAny.dimensions ? Object.keys(datasetAny.dimensions) : [];
-        const measures = datasetAny.measures ? Object.keys(datasetAny.measures) : [];
+        const catalog = datasetAny.__type === 'dataset' ? getDatasetCatalog(datasetAny) : undefined;
+        const measures = catalog
+            ? [...Object.keys(catalog.measures), ...Object.keys(catalog.derivedMeasures ?? {})]
+            : datasetAny.measures ? Object.keys(datasetAny.measures) : [];
         const metrics = datasetAny.metrics ? Object.keys(datasetAny.metrics) : [];
         const guide = `# Querying the ${datasetName} dataset
 
@@ -20,7 +24,12 @@ export function datasetGuidePrompt(datasets, datasetName) {
 ${dimensions.map((d) => `- ${d}`).join('\n')}
 
 ## Available Measures
-${measures.map((m) => `- ${m}`).join('\n')}
+${measures.map((m) => {
+            const definition = catalog?.measures[m] ?? catalog?.derivedMeasures?.[m];
+            const range = definition?.requiresTimeRange ? ` (requires by and a bounded ISO time range on ${catalog?.timeKey})` : '';
+            const grains = definition?.supportedGrains ? ` [grains: ${definition.supportedGrains.join(', ')}]` : '';
+            return `- ${m}${range}${grains}`;
+        }).join('\n')}
 
 ## Available Metrics
 ${metrics.map((m) => `- ${m}`).join('\n')}

package/dist/tools/args.d.ts

@@ -17,6 +17,7 @@ export declare const queryMetricArgsSchema: z.ZodObject<{
     }>, "many">>;
     segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     grain: z.ZodOptional<z.ZodEnum<[TimeGrain, ...TimeGrain[]]>>;
+    timezone: z.ZodOptional<z.ZodString>;
     orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodString;
         direction: z.ZodEnum<["asc", "desc"]>;
@@ -43,6 +44,7 @@ export declare const queryMetricArgsSchema: z.ZodObject<{
     segments?: string[] | undefined;
     metric?: string | undefined;
     grain?: TimeGrain | undefined;
+    timezone?: string | undefined;
     orderBy?: {
         field: string;
         direction: "asc" | "desc";
@@ -60,6 +62,7 @@ export declare const queryMetricArgsSchema: z.ZodObject<{
     segments?: string[] | undefined;
     metric?: string | undefined;
     grain?: TimeGrain | undefined;
+    timezone?: string | undefined;
     orderBy?: {
         field: string;
         direction: "asc" | "desc";
@@ -84,6 +87,7 @@ export declare const queryDatasetArgsSchema: z.ZodObject<{
     }>, "many">>;
     segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     grain: z.ZodOptional<z.ZodEnum<[TimeGrain, ...TimeGrain[]]>>;
+    timezone: z.ZodOptional<z.ZodString>;
     orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodString;
         direction: z.ZodEnum<["asc", "desc"]>;
@@ -110,6 +114,7 @@ export declare const queryDatasetArgsSchema: z.ZodObject<{
     }[] | undefined;
     segments?: string[] | undefined;
     grain?: TimeGrain | undefined;
+    timezone?: string | undefined;
     orderBy?: {
         field: string;
         direction: "asc" | "desc";
@@ -127,6 +132,7 @@ export declare const queryDatasetArgsSchema: z.ZodObject<{
     }[] | undefined;
     segments?: string[] | undefined;
     grain?: TimeGrain | undefined;
+    timezone?: string | undefined;
     orderBy?: {
         field: string;
         direction: "asc" | "desc";

package/dist/tools/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/tools/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAkC7B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjC,CAAC;AAWH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CASzF;AAED,wBAAgB,eAAe,CAC7B,OAAO,GAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAM,GAC1F,YAAY,EAAE,CAMhB"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/tools/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAmC7B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjC,CAAC;AAWH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CASzF;AAED,wBAAgB,eAAe,CAC7B,OAAO,GAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAM,GAC1F,YAAY,EAAE,CAMhB"}

package/dist/tools/args.js

@@ -18,6 +18,7 @@ const baseQuerySchema = z.object({
     segments: z.array(z.string().min(1)).max(MAX_QUERY_FILTERS).optional(),
     // Each dataset narrows this further through its catalog `supportedGrains`.
     grain: z.enum(SUPPORTED_TIME_GRAINS).optional(),
+    timezone: z.string().min(1).max(100).optional(),
     orderBy: z.array(orderBySchema).max(MAX_QUERY_ORDER_BY).optional(),
     limit: z.number().int().positive().max(MAX_QUERY_LIMIT).optional(),
     offset: z.number().int().nonnegative().max(MAX_QUERY_OFFSET).optional(),

package/dist/tools/query-dataset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-dataset.d.ts","sourceRoot":"","sources":["../../src/tools/query-dataset.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,qBAAqB,CAAC;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAYtF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA+D1B"}
+{"version":3,"file":"query-dataset.d.ts","sourceRoot":"","sources":["../../src/tools/query-dataset.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,qBAAqB,CAAC;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAYtF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAiE1B"}

package/dist/tools/query-dataset.js

@@ -13,7 +13,7 @@ import { createMCPToolResponse } from './utils/tool-response.js';
 export async function queryDatasetTool(datasets, analytics, args, options = {}) {
     const inputSchema = options.inputSchema ?? buildMCPQuerySchemas(datasets, options.limits).queryDataset;
     const validatedArgs = parseToolArgs(inputSchema, 'query_dataset', args);
-    const { dataset: datasetName, dimensions, measures, filters, segments, grain, orderBy } = validatedArgs;
+    const { dataset: datasetName, dimensions, measures, filters, segments, grain, timezone, orderBy } = validatedArgs;
     if (!datasetName) {
         throw new MCPToolError('MCP_INVALID_ARGUMENTS', 'dataset parameter is required');
     }
@@ -34,6 +34,8 @@ export async function queryDatasetTool(datasets, analytics, args, options = {})
         orderBy: orderBy || [],
         limit: pagination.limit,
     };
+    if (timezone !== undefined)
+        query.timezone = timezone;
     if (grain) {
         query.by = grain;
     }

package/dist/tools/query-metric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-metric.d.ts","sourceRoot":"","sources":["../../src/tools/query-metric.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAYtF,wBAAsB,eAAe,CACnC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAsE1B"}
+{"version":3,"file":"query-metric.d.ts","sourceRoot":"","sources":["../../src/tools/query-metric.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAYtF,wBAAsB,eAAe,CACnC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAwE1B"}

package/dist/tools/query-metric.js

@@ -13,7 +13,7 @@ import { createMCPToolResponse } from './utils/tool-response.js';
 export async function queryMetricTool(datasets, analytics, args, options = {}) {
     const inputSchema = options.inputSchema ?? buildMCPQuerySchemas(datasets, options.limits).queryMetric;
     const validatedArgs = parseToolArgs(inputSchema, 'query_metric', args);
-    const { dataset: datasetName, metric: metricName, dimensions, filters, segments, grain, orderBy } = validatedArgs;
+    const { dataset: datasetName, metric: metricName, dimensions, filters, segments, grain, timezone, orderBy } = validatedArgs;
     if (!datasetName) {
         throw new MCPToolError('MCP_INVALID_ARGUMENTS', 'dataset parameter is required');
     }
@@ -38,6 +38,8 @@ export async function queryMetricTool(datasets, analytics, args, options = {}) {
         orderBy: orderBy || [],
         limit: pagination.limit,
     };
+    if (timezone !== undefined)
+        query.timezone = timezone;
     if (grain) {
         query.by = grain;
     }

package/dist/tools/tool-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-manifest.d.ts","sourceRoot":"","sources":["../../src/tools/tool-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAQ,MAAM,oCAAoC,CAAC;AAkEhF,eAAO,MAAM,0BAA0B;;;;;;;2BAsBrC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;2BA0HvC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;2BAwC9B,CAAC;AAYH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,6BAA6B,GAC1C,eAAe,CA8CjB"}
+{"version":3,"file":"tool-manifest.d.ts","sourceRoot":"","sources":["../../src/tools/tool-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAQ,MAAM,oCAAoC,CAAC;AAiEhF,eAAO,MAAM,0BAA0B;;;;;;;2BAsBrC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;2BAmIvC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;2BAwC9B,CAAC;AAYH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,6BAA6B,GAC1C,eAAe,CA8CjB"}

package/dist/tools/tool-manifest.js

@@ -5,7 +5,6 @@ const semanticMetadataProperties = {
     format: { type: 'string' },
     unit: { type: 'string' },
     currency: { type: 'string' },
-    timezone: { type: 'string' },
     sensitivity: {
         type: 'string',
         enum: ['public', 'internal', 'confidential', 'restricted'],
@@ -131,6 +130,15 @@ export const DATASET_SCHEMA_OUTPUT_SCHEMA = resultSchema({
                     label: { type: 'string' },
                     description: { type: 'string' },
                     ...semanticMetadataProperties,
+                    kind: { type: 'string', enum: ['window', 'shift'] },
+                    measure: { type: 'string' },
+                    interval: { type: 'object', properties: { amount: { type: 'integer', minimum: 1 }, unit: { type: 'string', enum: [...SUPPORTED_TIME_GRAINS] } }, required: ['amount', 'unit'], additionalProperties: false },
+                    trailing: { type: 'object', properties: { amount: { type: 'integer', minimum: 1 }, unit: { type: 'string', enum: [...SUPPORTED_TIME_GRAINS] } }, required: ['amount', 'unit'], additionalProperties: false },
+                    toDate: { type: 'string', enum: SUPPORTED_TIME_GRAINS.filter(grain => grain !== 'minute') },
+                    cumulative: { const: true },
+                    requiresTimeRange: { const: true },
+                    supportedGrains: { type: 'array', items: { type: 'string', enum: [...SUPPORTED_TIME_GRAINS] } },
+                    approximate: { const: true },
                 },
                 required: ['name'],
             },

package/dist/tools/utils/legacy-agent-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-agent-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/legacy-agent-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAQpB,MAAM,qBAAqB,CAAC;AAG7B,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4F7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAC/C,mBAAmB,CAuFrB"}
+{"version":3,"file":"legacy-agent-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/legacy-agent-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAQpB,MAAM,qBAAqB,CAAC;AAG7B,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA2F7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAC/C,mBAAmB,CAuFrB"}

package/dist/tools/utils/legacy-agent-catalog.js

@@ -43,7 +43,6 @@ function semanticMetadata(value) {
         ...(text(value.format) !== undefined ? { format: text(value.format) } : {}),
         ...(text(value.unit) !== undefined ? { unit: text(value.unit) } : {}),
         ...(/^[A-Z]{3}$/.test(String(value.currency)) ? { currency: String(value.currency) } : {}),
-        ...(text(value.timezone) !== undefined ? { timezone: text(value.timezone) } : {}),
         ...(sensitivity !== undefined ? { sensitivity } : {}),
     };
 }

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const MCP_PACKAGE_VERSION = "0.8.3";
+export declare const MCP_PACKAGE_VERSION = "0.8.4";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,4 +2,4 @@
 //
 // Resolved at build time rather than read from package.json at import time, so
 // importing this package touches no filesystem and survives bundling.
-export const MCP_PACKAGE_VERSION = '0.8.3';
+export const MCP_PACKAGE_VERSION = '0.8.4';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/mcp",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "Governed ClickHouse MCP server for semantic metrics, datasets, Claude, Cursor, and AI agents",
   "keywords": [
     "mcp",
@@ -33,7 +33,7 @@
     "dist"
   ],
   "dependencies": {
-    "@hypequery/datasets": "^0.19.0",
+    "@hypequery/datasets": "^0.20.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.23.8"
   },
@@ -41,7 +41,7 @@
     "@types/node": "^20.11.30",
     "typescript": "^5.7.3",
     "vitest": "^3.2.6",
-    "@hypequery/clickhouse": "2.12.0"
+    "@hypequery/clickhouse": "2.12.1"
   },
   "repository": {
     "type": "git",