@hypequery/mcp 0.10.1 → 0.11.0

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;AAGnD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM;;;;;;;;EA+IjF"}
+{"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;;;;;;;;EAgJjF"}

package/dist/prompts/dataset-guide.js

@@ -121,6 +121,7 @@ ${datasetList.map((name) => `- ${name}`).join('\n')}
 - \`notIn\`: Not in list
 - \`between\`: Between two values
 - \`like\`: Pattern match
+- \`isNull\` / \`isNotNull\`: Field is (not) NULL; omit \`value\`, and only where the filter lists the operator
 
 ## Time Grains
 - \`day\`: Daily aggregation

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,EAElB,MAAM,qBAAqB,CAAC;AAmC7B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGjC,CAAC;AAaH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAS5F;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,EAElB,MAAM,qBAAqB,CAAC;AAmC7B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGjC,CAAC;AAaH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAS5F;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,CAKhB"}

package/dist/tools/args.js

@@ -49,9 +49,8 @@ export function parseToolArgs(schema, toolName, args) {
     return result.data;
 }
 export function toMetricFilters(filters = []) {
-    return filters.map(filter => ({
-        field: filter.field,
-        operator: filter.operator,
-        value: filter.value,
-    }));
+    // A null check (RFC 0023) carries no value, so none is copied onto it.
+    return filters.map(filter => (filter.value === undefined
+        ? { field: filter.field, operator: filter.operator }
+        : { field: filter.field, operator: filter.operator, value: filter.value }));
 }

package/dist/utils/http-client/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/utils/http-client/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAE7E;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM/G;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAY3F"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/utils/http-client/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAA0B,MAAM,qBAAqB,CAAC;AAI1F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAE7E;AAQD,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ/G;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc3F"}

package/dist/utils/http-client/discovery.js

@@ -1,19 +1,29 @@
+const GENERIC_DESCRIPTION = 'Authorized client endpoints.';
 export function clientDatasetNames(contract) {
     return [...new Set(contract.endpoints.map(endpoint => endpoint.dataset))].sort();
 }
+/** Group text from the dataset endpoint when visible, else any endpoint of the group (id order). */
+function groupText(endpoints, key) {
+    const ordered = [...endpoints.filter(endpoint => endpoint.kind === 'dataset'), ...endpoints.filter(endpoint => endpoint.kind === 'metric')];
+    return ordered.find(endpoint => endpoint.annotations?.[key] !== undefined)?.annotations?.[key];
+}
 /** Preserve endpoint-specific permissions instead of merging them into a synthetic dataset. */
 export function clientDatasetProfile(contract, dataset) {
     const endpoints = contract.endpoints.filter(endpoint => endpoint.dataset === dataset);
+    const label = groupText(endpoints, 'label'), description = groupText(endpoints, 'description');
     return {
-        name: dataset, queryable: endpoints.some(endpoint => endpoint.kind === 'dataset'),
+        name: dataset, ...(label === undefined ? {} : { label }), ...(description === undefined ? {} : { description }),
+        queryable: endpoints.some(endpoint => endpoint.kind === 'dataset'),
         endpoints: endpoints.map(({ path: _path, schemaHash: _hash, ...profile }) => profile),
     };
 }
 export function clientDatasetList(contract) {
     const datasets = clientDatasetNames(contract).map(name => {
         const endpoints = contract.endpoints.filter(endpoint => endpoint.dataset === name);
+        const label = groupText(endpoints, 'label');
         return {
-            name, description: 'Authorized client endpoints.',
+            name, ...(label === undefined ? {} : { label }),
+            description: groupText(endpoints, 'description') ?? GENERIC_DESCRIPTION,
             queryable: endpoints.some(endpoint => endpoint.kind === 'dataset'),
             dimensionCount: new Set(endpoints.flatMap(endpoint => Object.keys(endpoint.dimensions))).size,
             measureCount: new Set(endpoints.flatMap(endpoint => Object.keys(endpoint.measures))).size,

package/dist/utils/http-client/manifest.js

@@ -2,14 +2,14 @@ import { buildMCPToolManifest } from '../../tools/tool-manifest.js';
 import { resultSchema } from '../../tools/utils/result-schema.js';
 const profileOutput = resultSchema({
     type: 'object', additionalProperties: false, required: ['name', 'queryable', 'endpoints'],
-    properties: { name: { type: 'string' }, queryable: { type: 'boolean' }, endpoints: { type: 'array', items: { type: 'object' } } },
+    properties: { name: { type: 'string' }, label: { type: 'string' }, description: { type: 'string' }, queryable: { type: 'boolean' }, endpoints: { type: 'array', items: { type: 'object' } } },
 });
 const listOutput = resultSchema({
     type: 'object', additionalProperties: false, required: ['datasets', 'total'],
     properties: {
         datasets: { type: 'array', items: { type: 'object', additionalProperties: false,
                 required: ['name', 'description', 'queryable', 'dimensionCount', 'measureCount', 'metricCount'],
-                properties: { name: { type: 'string' }, description: { type: 'string' }, queryable: { type: 'boolean' },
+                properties: { name: { type: 'string' }, label: { type: 'string' }, description: { type: 'string' }, queryable: { type: 'boolean' },
                     dimensionCount: { type: 'integer', minimum: 0 }, measureCount: { type: 'integer', minimum: 0 }, metricCount: { type: 'integer', minimum: 0 } },
             } }, total: { type: 'integer', minimum: 0 },
     },
@@ -34,12 +34,12 @@ export function clientHttpManifest(schemas, authorizedHash) {
     const manifest = buildMCPToolManifest(schemas);
     for (const tool of manifest.tools) {
         if (tool.name === 'get_dataset_schema') {
-            tool.description = 'Inspect authorized endpoint profiles for a dataset group. Each endpoint retains its own permissions and defaults.';
+            tool.description = 'Inspect authorized endpoint profiles for a dataset group. Each endpoint retains its own permissions and defaults; annotations carry backend-authored field labels and descriptions.';
             tool.inputSchema = { type: 'object', additionalProperties: false, properties: { dataset: { type: 'string' } }, required: ['dataset'] };
             tool.outputSchema = profileOutput;
         }
         else if (tool.name === 'list_datasets') {
-            tool.description = 'List authorized dataset groups, including metric-only groups whose queryable flag is false.';
+            tool.description = 'List authorized dataset groups with their descriptions, including metric-only groups whose queryable flag is false.';
             tool.inputSchema = { type: 'object', additionalProperties: false, properties: {} };
             tool.outputSchema = listOutput;
         }

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const MCP_PACKAGE_VERSION = "0.10.1";
+export declare const MCP_PACKAGE_VERSION = "0.11.0";
 //# 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.10.1';
+export const MCP_PACKAGE_VERSION = '0.11.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/mcp",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "Governed ClickHouse MCP server for semantic metrics, datasets, Claude, Cursor, and AI agents",
   "keywords": [
     "mcp",
@@ -38,10 +38,10 @@
     "!dist/**/type-tests/**"
   ],
   "dependencies": {
-    "@hypequery/datasets": "^0.25.0",
+    "@hypequery/datasets": "^0.27.0",
     "@modelcontextprotocol/sdk": "^1.32.1",
     "zod": "^4.6.6",
-    "@hypequery/protocol": "0.22.0"
+    "@hypequery/protocol": "0.24.0"
   },
   "devDependencies": {
     "@types/node": "^20.11.30",