@hypequery/mcp 0.8.2 → 0.8.4

package/dist/api.type-test.js

@@ -1,4 +1,5 @@
 import { expectTypeOf, it } from 'vitest';
+import { dataset, dimension, measure } from '@hypequery/datasets';
 import { HypequeryMCPExecutor, HypequeryMCPProtocolServer, HypequeryMCPServer, MCPToolError, connectMCPServerStdio, createMCPExecutor, createMCPProtocolServer, createMCPServer, startStdioMCPServer, } from './index.js';
 it('exports the transport-neutral and backwards-compatible MCP APIs', () => {
     expectTypeOf(HypequeryMCPExecutor).toBeConstructibleWith({});
@@ -12,3 +13,19 @@ it('exports the transport-neutral and backwards-compatible MCP APIs', () => {
     expectTypeOf(new MCPToolError('MCP_UNAUTHORIZED', 'Forbidden').code)
         .toMatchTypeOf();
 });
+it('accepts segments in the exported query argument types', () => {
+    expectTypeOf().toEqualTypeOf();
+    expectTypeOf().toEqualTypeOf();
+    const _orders = dataset('orders', {
+        source: 'orders',
+        dimensions: { status: dimension.string() },
+        measures: { revenue: measure.sum('amount') },
+        segments: { paid: { filters: [{ field: 'status', operator: 'eq', value: 'paid' }] } },
+    });
+    expectTypeOf()
+        .toEqualTypeOf();
+    expectTypeOf()
+        .toEqualTypeOf();
+    expectTypeOf().toEqualTypeOf();
+    expectTypeOf().toEqualTypeOf();
+});

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { type MetricFilter } from '@hypequery/datasets';
+import { type MetricFilter, type TimeGrain } from '@hypequery/datasets';
 export declare const queryMetricArgsSchema: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -15,7 +15,9 @@ export declare const queryMetricArgsSchema: z.ZodObject<{
         operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
         value?: any;
     }>, "many">>;
-    grain: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year"]>>;
+    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"]>;
@@ -32,15 +34,17 @@ export declare const queryMetricArgsSchema: z.ZodObject<{
     dataset: z.ZodOptional<z.ZodString>;
     metric: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    dataset?: string | undefined;
     dimensions?: string[] | undefined;
     filters?: {
         field: string;
         operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
         value?: any;
     }[] | undefined;
+    segments?: string[] | undefined;
     metric?: string | undefined;
-    dataset?: string | undefined;
-    grain?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    grain?: TimeGrain | undefined;
+    timezone?: string | undefined;
     orderBy?: {
         field: string;
         direction: "asc" | "desc";
@@ -48,15 +52,17 @@ export declare const queryMetricArgsSchema: z.ZodObject<{
     limit?: number | undefined;
     offset?: number | undefined;
 }, {
+    dataset?: string | undefined;
     dimensions?: string[] | undefined;
     filters?: {
         field: string;
         operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
         value?: any;
     }[] | undefined;
+    segments?: string[] | undefined;
     metric?: string | undefined;
-    dataset?: string | undefined;
-    grain?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    grain?: TimeGrain | undefined;
+    timezone?: string | undefined;
     orderBy?: {
         field: string;
         direction: "asc" | "desc";
@@ -79,7 +85,9 @@ export declare const queryDatasetArgsSchema: z.ZodObject<{
         operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
         value?: any;
     }>, "many">>;
-    grain: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year"]>>;
+    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"]>;
@@ -96,15 +104,17 @@ export declare const queryDatasetArgsSchema: z.ZodObject<{
     dataset: z.ZodOptional<z.ZodString>;
     measures: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
+    dataset?: string | undefined;
     dimensions?: string[] | undefined;
+    measures?: string[] | undefined;
     filters?: {
         field: string;
         operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
         value?: any;
     }[] | undefined;
-    measures?: string[] | undefined;
-    dataset?: string | undefined;
-    grain?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    segments?: string[] | undefined;
+    grain?: TimeGrain | undefined;
+    timezone?: string | undefined;
     orderBy?: {
         field: string;
         direction: "asc" | "desc";
@@ -112,15 +122,17 @@ export declare const queryDatasetArgsSchema: z.ZodObject<{
     limit?: number | undefined;
     offset?: number | undefined;
 }, {
+    dataset?: string | undefined;
     dimensions?: string[] | undefined;
+    measures?: string[] | undefined;
     filters?: {
         field: string;
         operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
         value?: any;
     }[] | undefined;
-    measures?: string[] | undefined;
-    dataset?: string | undefined;
-    grain?: "day" | "week" | "month" | "quarter" | "year" | 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,EAA6B,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA+BnF,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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { SEMANTIC_FILTER_OPERATORS } from '@hypequery/datasets';
+import { SEMANTIC_FILTER_OPERATORS, SUPPORTED_TIME_GRAINS, } from '@hypequery/datasets';
 import { MCPToolError } from '../errors.js';
 import { MAX_QUERY_DIMENSIONS, MAX_QUERY_FILTERS, MAX_QUERY_LIMIT, MAX_QUERY_MEASURES, MAX_QUERY_OFFSET, MAX_QUERY_ORDER_BY, } from '../types.js';
 const filterSchema = z.object({
@@ -14,7 +14,11 @@ const orderBySchema = z.object({
 const baseQuerySchema = z.object({
     dimensions: z.array(z.string().min(1)).max(MAX_QUERY_DIMENSIONS).optional(),
     filters: z.array(filterSchema).max(MAX_QUERY_FILTERS).optional(),
-    grain: z.enum(['day', 'week', 'month', 'quarter', 'year']).optional(),
+    // Each dataset narrows this to the segment names it declares.
+    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,CA2D1B"}
+{"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, 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,9 +34,14 @@ export async function queryDatasetTool(datasets, analytics, args, options = {})
         orderBy: orderBy || [],
         limit: pagination.limit,
     };
+    if (timezone !== undefined)
+        query.timezone = timezone;
     if (grain) {
         query.by = grain;
     }
+    if (segments?.length) {
+        query.segments = segments;
+    }
     if (pagination.offset !== undefined) {
         query.offset = pagination.offset;
     }

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,CAkE1B"}
+{"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, 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,9 +38,14 @@ export async function queryMetricTool(datasets, analytics, args, options = {}) {
         orderBy: orderBy || [],
         limit: pagination.limit,
     };
+    if (timezone !== undefined)
+        query.timezone = timezone;
     if (grain) {
         query.by = grain;
     }
+    if (segments?.length) {
+        query.segments = segments;
+    }
     if (pagination.offset !== undefined) {
         query.offset = pagination.offset;
     }

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

@@ -1,4 +1,4 @@
-import type { CanonicalSemanticQuerySchemas } from '@hypequery/datasets';
+import { type CanonicalSemanticQuerySchemas } from '@hypequery/datasets';
 import type { ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const DATASET_LIST_OUTPUT_SCHEMA: {
     [x: string]: unknown;

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,KAAK,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACzE,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

@@ -1,10 +1,10 @@
+import { SUPPORTED_TIME_GRAINS } from '@hypequery/datasets';
 const semanticMetadataProperties = {
     examples: { type: 'array', items: { type: 'string' } },
     synonyms: { type: 'array', items: { type: 'string' } },
     format: { type: 'string' },
     unit: { type: 'string' },
     currency: { type: 'string' },
-    timezone: { type: 'string' },
     sensitivity: {
         type: 'string',
         enum: ['public', 'internal', 'confidential', 'restricted'],
@@ -99,7 +99,7 @@ export const DATASET_SCHEMA_OUTPUT_SCHEMA = resultSchema({
             additionalProperties: false,
             properties: {
                 dimensions: { type: 'array', items: { type: 'string' } },
-                timeGrain: { type: 'string', enum: ['day', 'week', 'month', 'quarter', 'year'] },
+                timeGrain: { type: 'string', enum: [...SUPPORTED_TIME_GRAINS] },
             },
         },
         timeDimension: { type: ['string', 'null'] },
@@ -130,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;AAE7B,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

@@ -1,8 +1,9 @@
+import { SUPPORTED_TIME_GRAINS } from '@hypequery/datasets';
 /**
  * Grains the semantic planner can actually execute. A legacy registry is
  * untyped, so anything outside this set is dropped rather than advertised.
  */
-const TIME_GRAINS = new Set(['day', 'week', 'month', 'quarter', 'year']);
+const TIME_GRAINS = new Set(SUPPORTED_TIME_GRAINS);
 function record(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value)
         ? value
@@ -42,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/types.d.ts

@@ -1,33 +1,37 @@
 /**
  * Type definitions for MCP Server
  */
-import type { AgentCatalogDataset, AgentCatalogDimension, AgentCatalogFilter, AgentCatalogMeasure, AgentCatalogMetric, AgentCatalogRelationship, AnyDatasetInstance, MetricFilter, TimeGrain, MetricOrderBy } from '@hypequery/datasets';
+import type { AgentCatalogDataset, AgentCatalogDimension, AgentCatalogFilter, AgentCatalogMeasure, AgentCatalogMetric, AgentCatalogRelationship, AnyDatasetInstance, DatasetSegmentNames, MetricFilter, TimeGrain, MetricOrderBy } from '@hypequery/datasets';
 import type { ZodTypeAny } from 'zod';
 /**
  * Registry of datasets - maps dataset names to dataset instances
  */
 export type DatasetRegistry = Record<string, AnyDatasetInstance | Record<string, unknown>>;
 /**
- * Arguments for query_metric tool
+ * Arguments for query_metric tool. Supply a dataset type to restrict the
+ * dataset and segment names; the default supports dynamic registries.
  */
-export interface QueryMetricArgs {
-    dataset: string;
+export interface QueryMetricArgs<TDataset extends AnyDatasetInstance = AnyDatasetInstance> {
+    dataset: TDataset['name'];
     metric: string;
     dimensions?: string[];
     filters?: MetricFilter[];
+    segments?: DatasetSegmentNames<TDataset>[];
     grain?: TimeGrain;
     orderBy?: MetricOrderBy[];
     limit?: number;
     offset?: number;
 }
 /**
- * Arguments for query_dataset tool
+ * Arguments for query_dataset tool. Supply a dataset type to restrict the
+ * dataset and segment names; the default supports dynamic registries.
  */
-export interface QueryDatasetArgs {
-    dataset: string;
+export interface QueryDatasetArgs<TDataset extends AnyDatasetInstance = AnyDatasetInstance> {
+    dataset: TDataset['name'];
     dimensions?: string[];
     measures?: string[];
     filters?: MetricFilter[];
+    segments?: DatasetSegmentNames<TDataset>[];
     grain?: TimeGrain;
     orderBy?: MetricOrderBy[];
     limit?: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const MCP_PACKAGE_VERSION = "0.8.2";
+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.2';
+export const MCP_PACKAGE_VERSION = '0.8.4';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/mcp",
-  "version": "0.8.2",
+  "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.18.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.11.2"
+    "@hypequery/clickhouse": "2.12.1"
   },
   "repository": {
     "type": "git",