@hypequery/mcp 0.9.0 → 0.10.1

package/README.md

@@ -48,6 +48,76 @@ Add it to an MCP client:
 
 Now an agent can ask, “Show revenue by region for the last month,” using the same metric definition as your backend and dashboard.
 
+## Connect to a Python HTTP backend
+
+An existing Python server can own definitions, authorization, tenancy and SQL.
+Opt its dataset/metric routes into `ClientQueryProfile` and install
+`add_client_contract_endpoint` from `hypequery.serve`. The MCP bridge consumes that
+endpoint's **authorized** view; an offline `build` export cannot be used as live
+discovery. No Node dataset registry or Python application import is needed.
+
+```ts
+import {
+  createMCPHttpExecutor,
+  createMCPProtocolServer,
+  connectMCPServerStdio,
+} from '@hypequery/mcp';
+
+const url = process.env.HYPEQUERY_CLIENT_CONTRACT_URL;
+const token = process.env.HYPEQUERY_API_KEY;
+if (!url || !token) throw new Error('Configure the backend discovery URL and credential.');
+
+const executor = await createMCPHttpExecutor({
+  url,
+  headers: { authorization: `Bearer ${token}` },
+});
+await connectMCPServerStdio(createMCPProtocolServer({ executor }));
+```
+
+The URL is the full discovery endpoint, including its mount prefix. HTTPS is
+required except for loopback development. URLs cannot contain credentials,
+queries or fragments. Keep one executor/session per principal; a headers resolver
+may rotate credentials for that same principal. Browser code must never contain
+this server credential. Remote MCP hosting/OAuth is a separate transport concern.
+
+The four tool names stay the same. HTTP mode preserves each authorized endpoint's
+own dimensions, filters, defaults, time controls and limits. Metric-only groups
+have `queryable: false`; inspecting them does not invent a dataset query route.
+Introspection returns endpoint profiles rather than merging permissions into a
+synthetic dataset. Unsupported segments, SQL/debug options and caller-selected
+tenants, tokens, origins or routes are rejected before backend requests.
+
+HTTP query responses preserve the public backend envelope: `data`, plus optional
+`meta` with request ID, timing, row count, pagination and optional `cache.hit`.
+Set `includeMeta: true` when the endpoint advertises metadata and use
+`pagination.hasMore` with `offset + limit` to page. This differs from the existing
+local executor's cache-status metadata; each mode advertises its actual output
+schema. Returned rows must contain exactly the selected fields with their
+advertised scalar/null types. Private diagnostics or unexpected fields fail
+closed instead of being forwarded to the agent.
+
+The bridge rechecks its authorized view before discovery, prompts and execution,
+and pins each POST to the validated endpoint schema. View changes or backend 409s
+invalidate the session: construct a new executor/reconnect explicitly. No query
+is automatically replayed with new semantics. Backend authorization is still
+checked on every request, including after discovery.
+
+Budgets default to 30 seconds, 256 KiB discovery/manifests and 1 MiB query responses.
+HTTP mode has a hard 1 MiB response ceiling, 1,000 rows/filter-list values, 10,000
+JSON nodes, 1,000 members per JSON collection and nesting depth 16. Query ceilings
+can be lowered through `queryLimits`; unservable default selections are refused
+rather than silently changed. `executionBudget`, `catalogBudget` and
+`maxContractBytes` allow smaller deployment limits. Streamed/decompressed bytes
+are bounded even without Content-Length, and redirects are refused. Request
+cancellation aborts the HTTP operation; the backend must carry disconnection into
+its executor (the Python serve adapter does so). End-to-end ClickHouse cancellation
+remains part of integrated release qualification.
+
+A TypeScript consumer of the MCP SDK needs its Fetch/DOM type names available
+(e.g. `lib: ["ES2022", "DOM"]` alongside Node types); this does not require a browser
+runtime. The repository's installed-artifact smoke checks this without
+`skipLibCheck` and without the optional ClickHouse peer installed.
+
 ## Tools agents receive
 
 - `list_datasets` discovers available analytics models;

package/dist/executor.d.ts

@@ -24,10 +24,10 @@ export interface MCPServerConfig extends MCPExecutorConfig {
     version?: string;
 }
 export interface MCPToolExecutor {
-    listTools(): Promise<ListToolsResult>;
+    listTools(signal?: AbortSignal): Promise<ListToolsResult>;
     callTool(name: string, args?: Record<string, unknown>, signal?: AbortSignal): Promise<CallToolResult>;
-    listPrompts(): Promise<ListPromptsResult>;
-    getPrompt(name: string, args?: Record<string, string>): Promise<GetPromptResult>;
+    listPrompts(signal?: AbortSignal): Promise<ListPromptsResult>;
+    getPrompt(name: string, args?: Record<string, string>, signal?: AbortSignal): Promise<GetPromptResult>;
     getManifestHash(): string;
 }
 /**

package/dist/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAoB7B,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,EAAE,eAAe,CAAC;IAC1B,wEAAwE;IACxE,SAAS,EAAE,aAAa,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,wEAAwE;IACxE,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACtC,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACjF,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAK9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;gBAE1B,MAAM,EAAE,iBAAiB;IAQtD,eAAe,IAAI,MAAM;IAInB,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAIrC,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC;IAwDpB,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAkBzC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;CAOvF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,CAEjF"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAoB7B,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,EAAE,eAAe,CAAC;IAC1B,wEAAwE;IACxE,SAAS,EAAE,aAAa,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,wEAAwE;IACxE,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvG,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAK9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;gBAE1B,MAAM,EAAE,iBAAiB;IAQtD,eAAe,IAAI,MAAM;IAInB,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAIrC,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC;IAwDpB,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAkBzC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;CAOvF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,CAEjF"}

package/dist/http-executor.d.ts

@@ -0,0 +1,40 @@
+import type { CallToolResult, GetPromptResult, ListPromptsResult, ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
+import type { MCPToolExecutor } from './executor.js';
+import type { MCPCatalogBudget, MCPExecutionBudget, MCPQueryLimits } from './types.js';
+import { type BackendHeaders } from './utils/http-client/transport.js';
+export interface MCPHttpExecutorConfig {
+    /** Full authorized discovery URL. Backend origin and credentials are host configuration. */
+    url: string;
+    /** One principal's credentials; a resolver may rotate credentials for that same principal. */
+    headers?: BackendHeaders;
+    fetchFn?: typeof fetch;
+    queryLimits?: MCPQueryLimits;
+    executionBudget?: MCPExecutionBudget;
+    catalogBudget?: MCPCatalogBudget;
+    /** Whole discovery response ceiling, default 256 KiB, hard maximum 1 MiB. */
+    maxContractBytes?: number;
+}
+/** Execute client tools through an authorized HTTP backend; Python retains SQL/auth/tenant ownership. */
+export declare class HypequeryMCPHttpExecutor implements MCPToolExecutor {
+    private readonly backend;
+    private readonly authorizedHash;
+    private readonly budget;
+    private readonly contractBytes;
+    private readonly schemas;
+    private readonly manifest;
+    private invalidated;
+    private constructor();
+    static create(config: MCPHttpExecutorConfig, signal?: AbortSignal): Promise<HypequeryMCPHttpExecutor>;
+    private static decodeContract;
+    private static requireSuccess;
+    private assertActive;
+    private current;
+    getManifestHash(): string;
+    listTools(signal?: AbortSignal): Promise<ListToolsResult>;
+    private plan;
+    callTool(name: string, args?: Record<string, unknown>, signal?: AbortSignal): Promise<CallToolResult>;
+    listPrompts(signal?: AbortSignal): Promise<ListPromptsResult>;
+    getPrompt(name: string, args?: Record<string, string>, signal?: AbortSignal): Promise<GetPromptResult>;
+}
+export declare function createMCPHttpExecutor(config: MCPHttpExecutorConfig, signal?: AbortSignal): Promise<HypequeryMCPHttpExecutor>;
+//# sourceMappingURL=http-executor.d.ts.map

package/dist/http-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-executor.d.ts","sourceRoot":"","sources":["../src/http-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC9H,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKvF,OAAO,EAA+D,KAAK,cAAc,EAAoB,MAAM,kCAAkC,CAAC;AAOtJ,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,GAAG,EAAE,MAAM,CAAC;IACZ,8FAA8F;IAC9F,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,yGAAyG;AACzG,qBAAa,wBAAyB,YAAW,eAAe;IAM5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IARhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;WAYM,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAiB3G,OAAO,CAAC,MAAM,CAAC,cAAc;IAQ7B,OAAO,CAAC,MAAM,CAAC,cAAc;IAQ7B,OAAO,CAAC,YAAY;YAIN,OAAO;IAarB,eAAe,IAAI,MAAM;IAEnB,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAK/D,OAAO,CAAC,IAAI;IAWN,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAiCrG,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAK7D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAS7G;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAE5H"}

package/dist/http-executor.js

@@ -0,0 +1,178 @@
+import { buildClientContractQuerySchemas } from '@hypequery/datasets/schemas';
+import { decodeProtocolClientContract, validateProtocolClientQuery } from '@hypequery/protocol';
+import { MCPToolError } from './errors.js';
+import { assertWithinBudget, executeWithinBudget, resolveExecutionBudget } from './tools/utils/execution-budget.js';
+import { resolveQueryLimits } from './tools/utils/query-limits.js';
+import { assertManifestWithinBudget, resolveCatalogBudget } from './tools/utils/catalog-budget.js';
+import { createMCPErrorResponse, createMCPResultTooLargeResponse, createMCPToolResponse } from './tools/utils/tool-response.js';
+import { backendRequest, backendText, backendUrl, discardBackendBody } from './utils/http-client/transport.js';
+import { httpToolArguments } from './utils/http-client/arguments.js';
+import { mcpClientProfile } from './utils/http-client/profile.js';
+import { clientHttpResult } from './utils/http-client/result.js';
+import { clientHttpManifest } from './utils/http-client/manifest.js';
+import { clientDatasetList, clientDatasetNames, clientDatasetProfile } from './utils/http-client/discovery.js';
+/** Execute client tools through an authorized HTTP backend; Python retains SQL/auth/tenant ownership. */
+export class HypequeryMCPHttpExecutor {
+    backend;
+    authorizedHash;
+    budget;
+    contractBytes;
+    schemas;
+    manifest;
+    invalidated = false;
+    constructor(backend, authorizedHash, budget, contractBytes, contract, config) {
+        this.backend = backend;
+        this.authorizedHash = authorizedHash;
+        this.budget = budget;
+        this.contractBytes = contractBytes;
+        this.schemas = buildClientContractQuerySchemas(mcpClientProfile(contract, config.queryLimits));
+        this.manifest = assertManifestWithinBudget(clientHttpManifest(this.schemas, authorizedHash), resolveCatalogBudget(config.catalogBudget));
+    }
+    static async create(config, signal) {
+        const backend = { discovery: backendUrl(config.url), headers: config.headers, fetchFn: config.fetchFn ?? fetch };
+        const configuredBudget = resolveExecutionBudget(config.executionBudget);
+        const budget = Object.freeze({ ...configuredBudget, maxResponseBytes: Math.min(configuredBudget.maxResponseBytes, 1_048_576) });
+        const maximum = config.maxContractBytes ?? 262_144;
+        if (!Number.isSafeInteger(maximum) || maximum < 1 || maximum > 1_048_576)
+            throw new Error('maxContractBytes must be an integer between 1 and 1048576.');
+        // Validate all host limits before making a request.
+        resolveCatalogBudget(config.catalogBudget);
+        resolveQueryLimits(undefined, config.queryLimits);
+        return executeWithinBudget(async (requestSignal) => {
+            const response = await backendRequest(backend, backend.discovery, requestSignal);
+            HypequeryMCPHttpExecutor.requireSuccess(response);
+            const contract = HypequeryMCPHttpExecutor.decodeContract(await backendText(response, maximum, requestSignal));
+            return new HypequeryMCPHttpExecutor(backend, contract.contentHash, budget, maximum, contract, config);
+        }, budget, signal);
+    }
+    static decodeContract(text) {
+        try {
+            const contract = decodeProtocolClientContract(text);
+            if (contract.view !== 'authorized')
+                throw new Error();
+            return contract;
+        }
+        catch {
+            throw new MCPToolError('MCP_EXECUTION_FAILED', 'Backend returned an invalid authorized client contract.', { retryable: false });
+        }
+    }
+    static requireSuccess(response) {
+        if (response.status === 200)
+            return;
+        discardBackendBody(response);
+        if (response.status === 401 || response.status === 403)
+            throw new MCPToolError('MCP_UNAUTHORIZED', 'Backend access denied.');
+        if (response.status === 409)
+            throw new MCPToolError('MCP_STALE_CONTRACT', 'Backend client contract changed; reconnect.', { retryable: false });
+        throw new MCPToolError('MCP_EXECUTION_FAILED', 'Backend request was refused.', { retryable: response.status === 429 || response.status >= 500 });
+    }
+    assertActive() {
+        if (this.invalidated)
+            throw new MCPToolError('MCP_STALE_CONTRACT', 'Backend client contract changed; reconnect.', { retryable: false });
+    }
+    async current(signal) {
+        this.assertActive();
+        const response = await backendRequest(this.backend, this.backend.discovery, signal);
+        try {
+            HypequeryMCPHttpExecutor.requireSuccess(response);
+        }
+        catch (error) {
+            if (response.status === 409)
+                this.invalidated = true;
+            throw error;
+        }
+        const contract = HypequeryMCPHttpExecutor.decodeContract(await backendText(response, this.contractBytes, signal));
+        if (contract.contentHash !== this.authorizedHash) {
+            this.invalidated = true;
+            this.assertActive();
+        }
+        this.assertActive();
+    }
+    getManifestHash() { return this.schemas.manifestHash; }
+    async listTools(signal) {
+        await executeWithinBudget(requestSignal => this.current(requestSignal), this.budget, signal);
+        return structuredClone(this.manifest);
+    }
+    plan(name, args) {
+        const input = httpToolArguments(args, ['dataset', 'metric', 'dimensions', 'measures', 'filters', 'having', 'grain', 'timezone', 'orderBy', 'limit', 'offset', 'includeMeta']);
+        const endpoint = this.schemas.contract.endpoints.find(item => name === 'query_dataset'
+            ? item.kind === 'dataset' && item.id === input.dataset
+            : item.kind === 'metric' && item.dataset === input.dataset && item.id === input.metric);
+        if (!endpoint)
+            throw new MCPToolError('MCP_INVALID_ARGUMENTS', 'Invalid client query target.');
+        try {
+            return validateProtocolClientQuery(this.schemas.contract, endpoint.id, input, 'mcp');
+        }
+        catch {
+            throw new MCPToolError('MCP_INVALID_ARGUMENTS', 'Invalid client query.');
+        }
+    }
+    async callTool(name, args, signal) {
+        try {
+            this.assertActive();
+            let plan;
+            let dataset;
+            if (name === 'query_dataset' || name === 'query_metric')
+                plan = this.plan(name, args);
+            else if (name === 'list_datasets')
+                httpToolArguments(args, []);
+            else if (name === 'get_dataset_schema') {
+                const input = httpToolArguments(args, ['dataset']);
+                if (typeof input.dataset !== 'string' || !clientDatasetNames(this.schemas.contract).includes(input.dataset))
+                    throw new MCPToolError('MCP_NOT_FOUND', 'Dataset group not found.');
+                dataset = input.dataset;
+            }
+            else
+                throw new MCPToolError('MCP_UNKNOWN_TOOL', 'Unknown client tool.');
+            return await executeWithinBudget(async (requestSignal) => {
+                await this.current(requestSignal);
+                let value;
+                if (plan) {
+                    const url = new URL(plan.endpoint.path, this.backend.discovery.origin);
+                    const response = await backendRequest(this.backend, url, requestSignal, plan.body, plan.endpoint.schemaHash);
+                    try {
+                        HypequeryMCPHttpExecutor.requireSuccess(response);
+                    }
+                    catch (error) {
+                        if (response.status === 409)
+                            this.invalidated = true;
+                        throw error;
+                    }
+                    value = clientHttpResult(await backendText(response, this.budget.maxResponseBytes, requestSignal), plan);
+                }
+                else
+                    value = dataset === undefined ? clientDatasetList(this.schemas.contract) : clientDatasetProfile(this.schemas.contract, dataset);
+                const result = createMCPToolResponse(value);
+                assertWithinBudget(result, this.budget);
+                return result;
+            }, this.budget, signal);
+        }
+        catch (error) {
+            const result = createMCPErrorResponse(error);
+            try {
+                assertWithinBudget(result, this.budget);
+                return result;
+            }
+            catch {
+                return createMCPResultTooLargeResponse();
+            }
+        }
+    }
+    async listPrompts(signal) {
+        await executeWithinBudget(requestSignal => this.current(requestSignal), this.budget, signal);
+        return { prompts: [{ name: 'dataset_guide', description: 'Guide to the authorized client endpoint profiles', arguments: [{ name: 'dataset', required: false }] }] };
+    }
+    async getPrompt(name, args, signal) {
+        const input = httpToolArguments(args, ['dataset']);
+        if (name !== 'dataset_guide' || input.dataset !== undefined && (typeof input.dataset !== 'string' || !clientDatasetNames(this.schemas.contract).includes(input.dataset)))
+            throw new MCPToolError('MCP_NOT_FOUND', 'Client guide not found.');
+        await executeWithinBudget(requestSignal => this.current(requestSignal), this.budget, signal);
+        const profiles = input.dataset === undefined ? clientDatasetList(this.schemas.contract) : clientDatasetProfile(this.schemas.contract, input.dataset);
+        const result = { messages: [{ role: 'user', content: { type: 'text', text: 'Use only the authorized endpoints and tool schemas. A metric-only dataset group is not a query_dataset target. Each endpoint retains its own fields, defaults and limits. For pagination, request includeMeta=true when metadata is available and follow pagination.hasMore and offset + limit. Tenant and credentials belong to the backend host. Reconnect explicitly after a stale-contract error.\n' + JSON.stringify(profiles) } }] };
+        assertWithinBudget(result, this.budget);
+        return result;
+    }
+}
+export function createMCPHttpExecutor(config, signal) {
+    return HypequeryMCPHttpExecutor.create(config, signal);
+}

package/dist/index.d.ts

@@ -18,4 +18,5 @@ export type { DatasetRegistry, QueryMetricArgs, QueryDatasetArgs, QueryToolOptio
 export { MCPCatalogBudgetError, MCPExecutionBudgetError, MCPToolError, classifyMCPToolError, formatMCPToolError, type MCPErrorDetails, type MCPExecutionErrorCode, type MCPToolErrorCode, type MCPToolErrorCategory, } from './errors.js';
 export { MAX_QUERY_LIMIT, DEFAULT_QUERY_LIMIT, MAX_QUERY_OFFSET, MAX_QUERY_DIMENSIONS, MAX_QUERY_MEASURES, MAX_QUERY_FILTERS, MAX_QUERY_ORDER_BY, DEFAULT_QUERY_TIMEOUT_MS, MAX_QUERY_TIMEOUT_MS, DEFAULT_RESPONSE_BYTES, MAX_RESPONSE_BYTES, DEFAULT_MANIFEST_TOOLS, MAX_MANIFEST_TOOLS, DEFAULT_MANIFEST_BYTES, MAX_MANIFEST_BYTES, } from './types.js';
 export { MCP_PACKAGE_VERSION } from './version.js';
+export { HypequeryMCPHttpExecutor, createMCPHttpExecutor, type MCPHttpExecutorConfig } from './http-executor.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -17,3 +17,4 @@ export { datasetGuidePrompt } from './prompts/dataset-guide.js';
 export { MCPCatalogBudgetError, MCPExecutionBudgetError, MCPToolError, classifyMCPToolError, formatMCPToolError, } from './errors.js';
 export { MAX_QUERY_LIMIT, DEFAULT_QUERY_LIMIT, MAX_QUERY_OFFSET, MAX_QUERY_DIMENSIONS, MAX_QUERY_MEASURES, MAX_QUERY_FILTERS, MAX_QUERY_ORDER_BY, DEFAULT_QUERY_TIMEOUT_MS, MAX_QUERY_TIMEOUT_MS, DEFAULT_RESPONSE_BYTES, MAX_RESPONSE_BYTES, DEFAULT_MANIFEST_TOOLS, MAX_MANIFEST_TOOLS, DEFAULT_MANIFEST_BYTES, MAX_MANIFEST_BYTES, } from './types.js';
 export { MCP_PACKAGE_VERSION } from './version.js';
+export { HypequeryMCPHttpExecutor, createMCPHttpExecutor } from './http-executor.js';

package/dist/protocol-server.js

@@ -24,10 +24,10 @@ export class HypequeryMCPProtocolServer {
         this.setupHandlers();
     }
     setupHandlers() {
-        this.server.setRequestHandler(ListToolsRequestSchema, async () => (this.executor.listTools()));
+        this.server.setRequestHandler(ListToolsRequestSchema, async (_request, extra) => (this.executor.listTools(extra?.signal)));
         this.server.setRequestHandler(CallToolRequestSchema, async (request, extra) => (this.executor.callTool(request.params.name, request.params.arguments, extra?.signal)));
-        this.server.setRequestHandler(ListPromptsRequestSchema, async () => (this.executor.listPrompts()));
-        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => (this.executor.getPrompt(request.params.name, request.params.arguments)));
+        this.server.setRequestHandler(ListPromptsRequestSchema, async (_request, extra) => (this.executor.listPrompts(extra?.signal)));
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request, extra) => (this.executor.getPrompt(request.params.name, request.params.arguments, extra?.signal)));
     }
     getManifestHash() {
         return this.executor.getManifestHash();

package/dist/tools/args.d.ts

@@ -1,146 +1,88 @@
 import { z } from 'zod';
-import { type MetricFilter, type TimeGrain } from '@hypequery/datasets';
+import { type MetricFilter } from '@hypequery/datasets';
 export declare const queryMetricArgsSchema: z.ZodObject<{
-    dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dimensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
     filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodString;
-        operator: z.ZodEnum<["eq", "neq", "gt", "gte", "lt", "lte", "in", "notIn", "between", "like"]>;
-        value: z.ZodEffects<z.ZodAny, any, any>;
-    }, "strict", z.ZodTypeAny, {
-        field: string;
-        operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
-        value?: any;
-    }, {
-        field: string;
-        operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
-        value?: any;
-    }>, "many">>;
-    segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    grain: z.ZodOptional<z.ZodEnum<[TimeGrain, ...TimeGrain[]]>>;
+        operator: z.ZodEnum<{
+            eq: "eq";
+            neq: "neq";
+            gt: "gt";
+            gte: "gte";
+            lt: "lt";
+            lte: "lte";
+            in: "in";
+            notIn: "notIn";
+            between: "between";
+            like: "like";
+        }>;
+        value: z.ZodAny;
+    }, z.core.$strict>>>;
+    segments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    grain: z.ZodOptional<z.ZodEnum<{
+        minute: "minute";
+        hour: "hour";
+        day: "day";
+        week: "week";
+        month: "month";
+        quarter: "quarter";
+        year: "year";
+    }>>;
     timezone: z.ZodOptional<z.ZodString>;
     orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodString;
-        direction: z.ZodEnum<["asc", "desc"]>;
-    }, "strict", z.ZodTypeAny, {
-        field: string;
-        direction: "asc" | "desc";
-    }, {
-        field: string;
-        direction: "asc" | "desc";
-    }>, "many">>;
+        direction: z.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>;
+    }, z.core.$strict>>>;
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
-} & {
     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;
-    grain?: TimeGrain | undefined;
-    timezone?: string | undefined;
-    orderBy?: {
-        field: string;
-        direction: "asc" | "desc";
-    }[] | undefined;
-    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;
-    grain?: TimeGrain | undefined;
-    timezone?: string | undefined;
-    orderBy?: {
-        field: string;
-        direction: "asc" | "desc";
-    }[] | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-}>;
+}, z.core.$strict>;
 export declare const queryDatasetArgsSchema: z.ZodObject<{
-    dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dimensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
     filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodString;
-        operator: z.ZodEnum<["eq", "neq", "gt", "gte", "lt", "lte", "in", "notIn", "between", "like"]>;
-        value: z.ZodEffects<z.ZodAny, any, any>;
-    }, "strict", z.ZodTypeAny, {
-        field: string;
-        operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
-        value?: any;
-    }, {
-        field: string;
-        operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "between" | "like";
-        value?: any;
-    }>, "many">>;
-    segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    grain: z.ZodOptional<z.ZodEnum<[TimeGrain, ...TimeGrain[]]>>;
+        operator: z.ZodEnum<{
+            eq: "eq";
+            neq: "neq";
+            gt: "gt";
+            gte: "gte";
+            lt: "lt";
+            lte: "lte";
+            in: "in";
+            notIn: "notIn";
+            between: "between";
+            like: "like";
+        }>;
+        value: z.ZodAny;
+    }, z.core.$strict>>>;
+    segments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    grain: z.ZodOptional<z.ZodEnum<{
+        minute: "minute";
+        hour: "hour";
+        day: "day";
+        week: "week";
+        month: "month";
+        quarter: "quarter";
+        year: "year";
+    }>>;
     timezone: z.ZodOptional<z.ZodString>;
     orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodString;
-        direction: z.ZodEnum<["asc", "desc"]>;
-    }, "strict", z.ZodTypeAny, {
-        field: string;
-        direction: "asc" | "desc";
-    }, {
-        field: string;
-        direction: "asc" | "desc";
-    }>, "many">>;
+        direction: z.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>;
+    }, z.core.$strict>>>;
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
-} & {
     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;
-    segments?: string[] | undefined;
-    grain?: TimeGrain | undefined;
-    timezone?: string | undefined;
-    orderBy?: {
-        field: string;
-        direction: "asc" | "desc";
-    }[] | undefined;
-    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;
-    segments?: string[] | undefined;
-    grain?: TimeGrain | undefined;
-    timezone?: string | undefined;
-    orderBy?: {
-        field: string;
-        direction: "asc" | "desc";
-    }[] | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-}>;
-export declare function parseToolArgs<T>(schema: z.ZodType<T>, toolName: string, args: unknown): T;
+    measures: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare function parseToolArgs<T = any>(schema: z.ZodType, toolName: string, args: unknown): T;
 export declare function toMetricFilters(filters?: Array<{
     field: string;
     operator: MetricFilter['operator'];

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;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"}
+{"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"}

package/dist/tools/args.js

@@ -34,11 +34,13 @@ export const queryDatasetArgsSchema = baseQuerySchema.extend({
 function formatZodError(error) {
     return error.issues
         .map(issue => {
-        const path = issue.path.length > 0 ? issue.path.join('.') : 'arguments';
+        const path = issue.path.length > 0 ? issue.path.map(String).join('.') : 'arguments';
         return `${path}: ${issue.message}`;
     })
         .join('; ');
 }
+// Canonical schemas are built per catalog, so their parsed type is not known
+// statically; callers name it, as Zod 3's `ZodTypeAny` used to imply `any`.
 export function parseToolArgs(schema, toolName, args) {
     const result = schema.safeParse(args);
     if (!result.success) {

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

@@ -1,4 +1,4 @@
-import { type CanonicalSemanticQuerySchemas } from '@hypequery/datasets';
+import type { CanonicalSemanticQuerySchemas } from '@hypequery/datasets/schemas';
 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,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"}
+{"version":3,"file":"tool-manifest.d.ts","sourceRoot":"","sources":["../../src/tools/tool-manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAQ,MAAM,oCAAoC,CAAC;AAehF,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"}