@databasin/mcp-client 0.1.0 → 0.2.0-beta.1

package/dist/api-client.js

@@ -1,154 +1,151 @@
-import { DataBasinError, LoginRequiredError } from './errors.js';
+import { assertBuiltInProfile, fixedFacadeBaseUrl, normalizeTestOnlyBaseUrl } from './api-profile.js';
+import { defaultRetryDelay, executeFacadeRequest } from './api-request.js';
+import { parseRetryAfter } from './api-response.js';
+import { DataBasinError } from './errors.js';
+import { AgentRunEnvelopeSchema, AgentRunRequestSchema, AssistantEnvelopeSchema, CapabilitiesEnvelopeSchema, ContextEnvelopeSchema, GetSchemaEnvelopeSchema, GetSchemaInputSchema, QueryEnvelopeSchema, QueryLookupInputSchema, RunAssistantInputSchema, RunIdSchema, RunQueryInputSchema, SearchEnvelopeSchema, SearchInputSchema } from './schemas.js';
 export class DataBasinApiClient {
-    baseUrl;
-    auth;
-    fetchImpl;
-    maxResponseBytes;
-    timeoutMs;
-    constructor(options) {
-        this.baseUrl = normalizeApiBase(options.baseUrl);
-        this.auth = options.auth;
-        this.fetchImpl = options.fetchImpl ?? fetch;
-        this.maxResponseBytes = options.maxResponseBytes ?? 5_000_000;
-        this.timeoutMs = options.timeoutMs ?? 30_000;
-    }
-    getProjects(signal) {
-        return this.request('GET', '/my/projects', undefined, signal);
-    }
-    getAccessibleConnections(signal) {
-        return this.request('GET', '/connections/accessible', undefined, signal);
-    }
-    search(input, signal) {
-        const params = new URLSearchParams({ q: input.q, limit: String(input.limit) });
-        if (input.projectId)
-            params.set('projectId', input.projectId);
-        if (input.organizationId !== undefined)
-            params.set('orgId', String(input.organizationId));
-        if (input.types?.length)
-            params.set('types', input.types.join(','));
-        return this.request('GET', `/search?${params.toString()}`, undefined, signal);
-    }
-    browseSchema(input, signal) {
-        const params = new URLSearchParams({ connectorId: String(input.connectorId) });
-        let path = '/databasin/catalogs';
-        if (input.level !== 'catalogs')
-            params.set('catalog', input.catalog);
-        if (input.level === 'schemas')
-            path = '/databasin/schemas';
-        if (input.level === 'tables' || input.level === 'columns') {
-            path = input.level === 'tables' ? '/databasin/tables' : '/databasin/columns';
-            params.set('schema', input.schema);
-        }
-        if (input.level === 'columns')
-            params.set('table', input.table);
-        return this.request('GET', `${path}?${params.toString()}`, undefined, signal);
-    }
-    async getOperation(operationId, options, signal) {
-        const encoded = encodeURIComponent(operationId);
-        const status = await this.request('GET', `/databasin/query/${encoded}/status`, undefined, signal, true);
-        const statusObject = asRecord(status);
-        if (String(statusObject.status ?? '').toLowerCase() !== 'completed')
-            return status;
-        const params = new URLSearchParams({ offset: String(options.offset), limit: String(options.limit) });
-        const results = await this.request('GET', `/databasin/query/${encoded}/results?${params.toString()}`, undefined, signal);
-        return { ...statusObject, ...asRecord(results) };
-    }
-    cancelOperation(operationId, signal) {
-        return this.request('POST', `/databasin/query/${encodeURIComponent(operationId)}/cancel`, undefined, signal);
-    }
-    async request(method, path, body, callerSignal, allowFailedOperation = false) {
-        const accessToken = await this.auth.getAccessToken();
-        const timeoutSignal = AbortSignal.timeout(this.timeoutMs);
-        const signal = callerSignal ? AbortSignal.any([callerSignal, timeoutSignal]) : timeoutSignal;
-        let response;
-        try {
-            response = await this.fetchImpl(`${this.baseUrl}${path}`, {
-                method,
-                signal,
-                redirect: 'error',
-                headers: {
-                    accept: 'application/json',
-                    authorization: `Bearer ${accessToken}`,
-                    ...(body === undefined ? {} : { 'content-type': 'application/json' })
-                },
-                ...(body === undefined ? {} : { body: JSON.stringify(body) })
-            });
-        }
-        catch {
-            throw new DataBasinError('DEPENDENCY_UNAVAILABLE', 'The DataBasin API could not be reached.');
-        }
-        const payload = await readJson(response, this.maxResponseBytes);
-        if (response.ok)
-            return payload;
-        if (allowFailedOperation && response.status === 500 && isFailedOperation(payload))
-            return payload;
-        if (response.status === 401)
-            throw new LoginRequiredError(this.auth.profile.environment);
-        if (response.status === 403)
-            throw new DataBasinError('POLICY_DENIED', 'DataBasin denied access to this resource.');
-        if (response.status === 404)
-            throw new DataBasinError('NOT_FOUND', 'The requested DataBasin resource was not found.');
-        if (response.status >= 500)
-            throw new DataBasinError('DEPENDENCY_UNAVAILABLE', 'The DataBasin API is temporarily unavailable.');
-        throw new DataBasinError('OPERATION_FAILED', `The DataBasin API rejected the request with HTTP ${response.status}.`);
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    static forProfile(auth) {
+        assertBuiltInProfile(auth.profile);
+        return new DataBasinApiClient(transportOptions(fixedFacadeBaseUrl(auth.profile.environment), auth));
+    }
+    static createForTests(options) {
+        return new DataBasinApiClient({
+            ...transportOptions(normalizeTestOnlyBaseUrl(options.testOnlyBaseUrl), options.auth),
+            fetchImpl: options.fetchImpl,
+            maxResponseBytes: options.maxResponseBytes ?? 5_000_000,
+            timeoutMs: options.timeoutMs ?? 30_000,
+            sleepImpl: options.sleepImpl ?? defaultRetryDelay,
+            now: options.now ?? Date.now
+        });
+    }
+    getCapabilities(signal) {
+        return this.execute({ endpoint: 'capabilities', schema: CapabilitiesEnvelopeSchema, signal });
+    }
+    getContext(signal) {
+        return this.execute({ endpoint: 'context', schema: ContextEnvelopeSchema, signal });
+    }
+    async search(input, signal) {
+        const request = SearchInputSchema.safeParse(input);
+        if (!request.success)
+            throw invalidArgument('search');
+        return this.execute({ endpoint: 'search', schema: SearchEnvelopeSchema, body: request.data, signal });
+    }
+    async getSchema(input, signal) {
+        const request = GetSchemaInputSchema.safeParse(input);
+        if (!request.success)
+            throw invalidArgument('schema');
+        return this.execute({
+            endpoint: 'schema',
+            schema: GetSchemaEnvelopeSchema,
+            query: schemaQuery(request.data),
+            signal
+        });
+    }
+    async createAgentRun(input, idempotencyKey, signal) {
+        assertUuid(idempotencyKey, 'idempotency key');
+        const request = AgentRunRequestSchema.safeParse(input);
+        if (!request.success)
+            throw invalidArgument('agent run');
+        return this.execute({
+            endpoint: 'createAgentRun',
+            schema: AgentRunEnvelopeSchema,
+            body: request.data,
+            signal,
+            headers: { 'idempotency-key': idempotencyKey }
+        });
+    }
+    async getAgentRun(runId, signal) {
+        assertRunId(runId);
+        return this.execute({ endpoint: 'getAgentRun', schema: AgentRunEnvelopeSchema, runId, signal });
+    }
+    async cancelAgentRun(runId, idempotencyKey, reason, signal) {
+        assertUuid(idempotencyKey, 'idempotency key');
+        assertRunId(runId);
+        return this.execute({
+            endpoint: 'cancelAgentRun',
+            schema: AgentRunEnvelopeSchema,
+            runId,
+            body: { reason },
+            signal,
+            headers: { 'idempotency-key': idempotencyKey }
+        });
+    }
+    async runQuery(input, signal) {
+        const request = RunQueryInputSchema.safeParse(input);
+        if (!request.success)
+            throw invalidArgument('query');
+        return this.execute({ endpoint: 'runQuery', schema: QueryEnvelopeSchema, body: request.data, signal });
+    }
+    async getQueryStatus(queryId, signal) {
+        assertQueryId(queryId);
+        return this.execute({ endpoint: 'getQueryStatus', schema: QueryEnvelopeSchema, queryId, signal });
+    }
+    async cancelQuery(queryId, signal) {
+        assertQueryId(queryId);
+        return this.execute({ endpoint: 'cancelQuery', schema: QueryEnvelopeSchema, queryId, signal });
+    }
+    async runAssistant(input, signal) {
+        const request = RunAssistantInputSchema.safeParse(input);
+        if (!request.success)
+            throw invalidArgument('assistant');
+        return this.execute({
+            endpoint: 'assistant',
+            schema: AssistantEnvelopeSchema,
+            body: request.data,
+            signal,
+            timeoutMs: ASSISTANT_REQUEST_TIMEOUT_MS
+        });
+    }
+    execute(request) {
+        return executeFacadeRequest(this.transport, request);
     }
 }
-export function normalizeApiBase(raw) {
-    const url = new URL(raw);
-    if (url.protocol !== 'https:') {
-        throw new Error('The DataBasin API URL must use HTTPS.');
-    }
-    url.search = '';
-    url.hash = '';
-    url.username = '';
-    url.password = '';
-    const path = url.pathname.replace(/\/+$/u, '');
-    url.pathname = path.endsWith('/api') ? path : `${path}/api`;
-    return url.toString().replace(/\/$/u, '');
+export function createDataBasinApiClientForTests(options) {
+    return DataBasinApiClient.createForTests(options);
 }
-async function readJson(response, maxBytes) {
-    const contentLength = Number(response.headers.get('content-length'));
-    if (Number.isFinite(contentLength) && contentLength > maxBytes) {
-        throw new DataBasinError('POLICY_DENIED', 'The DataBasin API response exceeded the size limit.');
-    }
-    if (!response.body)
-        return null;
-    const reader = response.body.getReader();
-    const chunks = [];
-    let total = 0;
-    while (true) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        total += value.byteLength;
-        if (total > maxBytes) {
-            await reader.cancel();
-            throw new DataBasinError('POLICY_DENIED', 'The DataBasin API response exceeded the size limit.');
-        }
-        chunks.push(value);
-    }
-    if (total === 0)
-        return null;
-    const bytes = new Uint8Array(total);
-    let offset = 0;
-    for (const chunk of chunks) {
-        bytes.set(chunk, offset);
-        offset += chunk.byteLength;
-    }
-    try {
-        return JSON.parse(new TextDecoder().decode(bytes));
-    }
-    catch {
-        if (response.ok)
-            throw new DataBasinError('OPERATION_FAILED', 'The DataBasin API returned an invalid response.');
-        return null;
+export { fixedFacadeBaseUrl, parseRetryAfter };
+// The assistant call runs synchronously and the facade caps its own wall clock
+// at ~5 minutes, always returning a definitive envelope rather than hanging --
+// this is deliberately longer than the shared 30s default so a legitimate
+// in-progress run is never cut off from the client side first.
+export const ASSISTANT_REQUEST_TIMEOUT_MS = 5 * 60_000 + 60_000;
+function transportOptions(baseUrl, auth) {
+    return {
+        baseUrl,
+        getAccessToken: () => auth.getAccessToken(),
+        maxResponseBytes: 5_000_000,
+        timeoutMs: 30_000,
+        sleepImpl: defaultRetryDelay,
+        now: Date.now
+    };
+}
+function schemaQuery(input) {
+    const query = new URLSearchParams({ connectorId: input.connectorId, level: input.level });
+    for (const key of ['catalog', 'schema', 'table']) {
+        const value = input[key];
+        if (value !== undefined)
+            query.set(key, value);
     }
+    return query;
+}
+function assertRunId(runId) {
+    if (!RunIdSchema.safeParse(runId).success)
+        throw invalidArgument('agent run ID');
 }
-function asRecord(value) {
-    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+function assertQueryId(queryId) {
+    if (!QueryLookupInputSchema.shape.queryId.safeParse(queryId).success)
+        throw invalidArgument('query ID');
+}
+function assertUuid(value, label) {
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu.test(value)) {
+        throw new DataBasinError('INVALID_ARGUMENT', `The ${label} must be a UUID.`);
+    }
 }
-function isFailedOperation(value) {
-    const record = asRecord(value);
-    return record.status === 'failed' && typeof record.queryId === 'string' && record.queryId.length > 0;
+function invalidArgument(subject) {
+    return new DataBasinError('INVALID_ARGUMENT', `The DataBasin ${subject} request was invalid.`);
 }
 //# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACtG,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EAIrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EAUlB,MAAM,cAAc,CAAC;AAoCtB,MAAM,OAAO,kBAAkB;IACQ;IAArC,YAAqC,SAAkC;QAAlC,cAAS,GAAT,SAAS,CAAyB;IAAG,CAAC;IAE3E,MAAM,CAAC,UAAU,CAAC,IAAkB;QAClC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,kBAAkB,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACtG,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAA0C;QAC9D,OAAO,IAAI,kBAAkB,CAAC;YAC5B,GAAG,gBAAgB,CAAC,wBAAwB,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC;YACpF,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,SAAS;YACvD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,iBAAiB;YACjD,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,MAAoB;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,UAAU,CAAC,MAAoB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkB,EAAE,MAAoB;QACnD,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAqB,EAAE,MAAoB;QACzD,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,uBAAuB;YAC/B,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;YAChC,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,KAAsB,EACtB,cAAsB,EACtB,MAAoB;QAEpB,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM;YACN,OAAO,EAAE,EAAE,iBAAiB,EAAE,cAAc,EAAE;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,MAAoB;QACnD,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,cAAsB,EACtB,MAAc,EACd,MAAoB;QAEpB,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QAC9C,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,sBAAsB;YAC9B,KAAK;YACL,IAAI,EAAE,EAAE,MAAM,EAAE;YAChB,MAAM;YACN,OAAO,EAAE,EAAE,iBAAiB,EAAE,cAAc,EAAE;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAoB,EAAE,MAAoB;QACvD,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,MAAoB;QACxD,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACpG,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,MAAoB;QACrD,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAwB,EAAE,MAAoB;QAC/D,MAAM,OAAO,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,uBAAuB;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM;YACN,SAAS,EAAE,4BAA4B;SACxC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO,CAAI,OAAyD;QAC1E,OAAO,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAA0C;IAE1C,OAAO,kBAAkB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC;AAE/C,+EAA+E;AAC/E,+EAA+E;AAC/E,0EAA0E;AAC1E,+DAA+D;AAC/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhE,SAAS,gBAAgB,CAAC,OAAe,EAAE,IAAkB;IAC3D,OAAO;QACL,OAAO;QACP,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE;QAC3C,gBAAgB,EAAE,SAAS;QAC3B,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,iBAAiB;QAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAqB;IACxC,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1F,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAU,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO;QAAE,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO;QAAE,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;AAC1G,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,KAAa;IAC9C,IAAI,CAAC,6EAA6E,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,cAAc,CAAC,kBAAkB,EAAE,OAAO,KAAK,kBAAkB,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,IAAI,cAAc,CAAC,kBAAkB,EAAE,iBAAiB,OAAO,uBAAuB,CAAC,CAAC;AACjG,CAAC"}

package/dist/api-contract.d.ts

@@ -0,0 +1,59 @@
+export declare const MCP_FACADE_ROOT: "/api/v1/mcp";
+export declare const MCP_ENDPOINTS: Readonly<{
+    readonly capabilities: Readonly<{
+        method: "GET";
+        path: "/capabilities";
+    }>;
+    readonly context: Readonly<{
+        method: "GET";
+        path: "/context";
+    }>;
+    readonly search: Readonly<{
+        method: "POST";
+        path: "/search";
+    }>;
+    readonly schema: Readonly<{
+        method: "GET";
+        path: "/schema";
+    }>;
+    readonly createAgentRun: Readonly<{
+        method: "POST";
+        path: "/agent-runs";
+    }>;
+    readonly getAgentRun: Readonly<{
+        method: "GET";
+        path: "/agent-runs/:runId";
+    }>;
+    readonly cancelAgentRun: Readonly<{
+        method: "POST";
+        path: "/agent-runs/:runId/cancel";
+    }>;
+    readonly runQuery: Readonly<{
+        method: "POST";
+        path: "/query";
+    }>;
+    readonly getQueryStatus: Readonly<{
+        method: "GET";
+        path: "/query/:queryId";
+    }>;
+    readonly cancelQuery: Readonly<{
+        method: "POST";
+        path: "/query/:queryId/cancel";
+    }>;
+    readonly assistant: Readonly<{
+        method: "POST";
+        path: "/assistant";
+    }>;
+}>;
+export type McpHttpMethod = 'GET' | 'POST';
+export type McpEndpointName = keyof typeof MCP_ENDPOINTS;
+export interface ResolvedMcpEndpoint {
+    method: McpHttpMethod;
+    path: string;
+}
+export declare function resolveMcpEndpoint(name: McpEndpointName, options?: {
+    runId?: string | undefined;
+    queryId?: string | undefined;
+    query?: URLSearchParams | undefined;
+}): ResolvedMcpEndpoint;
+//# sourceMappingURL=api-contract.d.ts.map

package/dist/api-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-contract.d.ts","sourceRoot":"","sources":["../src/api-contract.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,EAAG,aAAsB,CAAC;AAEtD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYf,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAC3C,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,aAAa,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;CAAO,GAC9G,mBAAmB,CAMrB"}

package/dist/api-contract.js

@@ -0,0 +1,47 @@
+export const MCP_FACADE_ROOT = '/api/v1/mcp';
+export const MCP_ENDPOINTS = Object.freeze({
+    capabilities: Object.freeze({ method: 'GET', path: '/capabilities' }),
+    context: Object.freeze({ method: 'GET', path: '/context' }),
+    search: Object.freeze({ method: 'POST', path: '/search' }),
+    schema: Object.freeze({ method: 'GET', path: '/schema' }),
+    createAgentRun: Object.freeze({ method: 'POST', path: '/agent-runs' }),
+    getAgentRun: Object.freeze({ method: 'GET', path: '/agent-runs/:runId' }),
+    cancelAgentRun: Object.freeze({ method: 'POST', path: '/agent-runs/:runId/cancel' }),
+    runQuery: Object.freeze({ method: 'POST', path: '/query' }),
+    getQueryStatus: Object.freeze({ method: 'GET', path: '/query/:queryId' }),
+    cancelQuery: Object.freeze({ method: 'POST', path: '/query/:queryId/cancel' }),
+    assistant: Object.freeze({ method: 'POST', path: '/assistant' })
+});
+export function resolveMcpEndpoint(name, options = {}) {
+    const endpoint = MCP_ENDPOINTS[name];
+    const path = resolvePath(name, endpoint.path, options.runId, options.queryId);
+    if (options.query && name !== 'schema')
+        throw new Error('Only the schema endpoint accepts query parameters.');
+    const suffix = options.query?.toString();
+    return { method: endpoint.method, path: suffix ? `${path}?${suffix}` : path };
+}
+function fillPathId(template, placeholder, value) {
+    const encoded = encodeURIComponent(value);
+    if (!encoded || encoded === '.' || encoded === '..') {
+        throw new Error('The DataBasin resource ID is invalid.');
+    }
+    return template.replace(placeholder, encoded);
+}
+function resolvePath(name, path, runId, queryId) {
+    if (name === 'getAgentRun' || name === 'cancelAgentRun') {
+        if (runId === undefined)
+            throw new Error(`The ${name} endpoint requires a run ID.`);
+        return fillPathId(path, ':runId', runId);
+    }
+    if (name === 'getQueryStatus' || name === 'cancelQuery') {
+        if (queryId === undefined)
+            throw new Error(`The ${name} endpoint requires a query ID.`);
+        return fillPathId(path, ':queryId', queryId);
+    }
+    if (runId !== undefined)
+        throw new Error(`The ${name} endpoint does not accept a run ID.`);
+    if (queryId !== undefined)
+        throw new Error(`The ${name} endpoint does not accept a query ID.`);
+    return path;
+}
+//# sourceMappingURL=api-contract.js.map

package/dist/api-contract.js.map

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

package/dist/api-profile.d.ts

@@ -0,0 +1,5 @@
+import { type DataBasinEnvironment, type DataBasinProfile } from './config.js';
+export declare function fixedFacadeBaseUrl(environment: DataBasinEnvironment): string;
+export declare function assertBuiltInProfile(profile: DataBasinProfile): void;
+export declare function normalizeTestOnlyBaseUrl(raw: string): string;
+//# sourceMappingURL=api-profile.d.ts.map

package/dist/api-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-profile.d.ts","sourceRoot":"","sources":["../src/api-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQ3F,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,oBAAoB,GAAG,MAAM,CAI5E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CASpE;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY5D"}

package/dist/api-profile.js

@@ -0,0 +1,38 @@
+import { getProfile } from './config.js';
+import { MCP_FACADE_ROOT } from './api-contract.js';
+const FIXED_FACADE_ORIGINS = Object.freeze({
+    prod: 'https://databasin.cloud',
+    np: 'https://databasin-ui-np.grayriver-813df174.centralus.azurecontainerapps.io'
+});
+export function fixedFacadeBaseUrl(environment) {
+    const origin = FIXED_FACADE_ORIGINS[environment];
+    if (!origin)
+        throw new Error('Only the built-in DataBasin production and NP profiles are permitted.');
+    return `${origin}${MCP_FACADE_ROOT}`;
+}
+export function assertBuiltInProfile(profile) {
+    const expected = getProfile(profile.environment);
+    const matches = profile.label === expected.label
+        && profile.apiBaseUrl === FIXED_FACADE_ORIGINS[profile.environment]
+        && profile.tenantId === expected.tenantId
+        && profile.clientId === expected.clientId
+        && profile.scopes.length === expected.scopes.length
+        && profile.scopes.every((scope, index) => scope === expected.scopes[index]);
+    if (!matches)
+        throw new Error('Only the built-in DataBasin production and NP profiles are permitted.');
+}
+export function normalizeTestOnlyBaseUrl(raw) {
+    const url = new URL(raw);
+    const loopback = url.hostname === 'localhost' || url.hostname === '127.0.0.1' || url.hostname === '::1';
+    if (url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) {
+        throw new Error('The test-only DataBasin URL must use HTTPS or loopback HTTP.');
+    }
+    if (url.username || url.password)
+        throw new Error('The test-only DataBasin URL must not contain credentials.');
+    url.search = '';
+    url.hash = '';
+    const path = url.pathname.replace(/\/+$/u, '');
+    url.pathname = path.endsWith(MCP_FACADE_ROOT) ? path : `${path}${MCP_FACADE_ROOT}`;
+    return url.toString().replace(/\/$/u, '');
+}
+//# sourceMappingURL=api-profile.js.map

package/dist/api-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-profile.js","sourceRoot":"","sources":["../src/api-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoD,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,oBAAoB,GAAmD,MAAM,CAAC,MAAM,CAAC;IACzF,IAAI,EAAE,yBAAyB;IAC/B,EAAE,EAAE,4EAA4E;CACjF,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,WAAiC;IAClE,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACtG,OAAO,GAAG,MAAM,GAAG,eAAe,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK;WAC3C,OAAO,CAAC,UAAU,KAAK,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC;WAChE,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;WACtC,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;WACtC,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM;WAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC;IACxG,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/G,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/C,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,eAAe,EAAE,CAAC;IACnF,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/api-request.d.ts

@@ -0,0 +1,27 @@
+import type { ZodType } from 'zod';
+import { type McpEndpointName } from './api-contract.js';
+import type { SuccessEnvelope } from './schemas.js';
+export type Sleep = (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+export interface RequestTransportOptions {
+    baseUrl: string;
+    getAccessToken: () => Promise<string>;
+    fetchImpl?: typeof fetch;
+    maxResponseBytes: number;
+    timeoutMs: number;
+    sleepImpl: Sleep;
+    now: () => number;
+}
+export interface FacadeRequest<T> {
+    endpoint: McpEndpointName;
+    schema: ZodType<SuccessEnvelope<T>>;
+    runId?: string | undefined;
+    queryId?: string | undefined;
+    query?: URLSearchParams | undefined;
+    body?: unknown;
+    signal?: AbortSignal | undefined;
+    headers?: Record<string, string> | undefined;
+    timeoutMs?: number | undefined;
+}
+export declare function executeFacadeRequest<T>(options: RequestTransportOptions, request: FacadeRequest<T>): Promise<SuccessEnvelope<T>>;
+export declare const defaultRetryDelay: Sleep;
+//# sourceMappingURL=api-request.d.ts.map

package/dist/api-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-request.d.ts","sourceRoot":"","sources":["../src/api-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAGnC,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAY7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElF,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,CAAC;IACjB,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAI7C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAOD,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAsB7B;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAsB,CAAC"}