@hydradb/mcp 1.2.0 → 1.2.2

package/dist/hydra/errors.d.ts

@@ -30,6 +30,20 @@ export declare class HydraWrapperError extends Error {
         cause?: unknown;
     });
 }
+/**
+ * Build the same error from a raw HTTP response, for calls that do not go
+ * through the SDK.
+ *
+ * The BYOG endpoints have no SDK resource to throw `HydraDBError`, so
+ * `translateError` alone would send every one of their failures down its
+ * generic branch and drop the response body — losing the error code, the
+ * server's explanation and the request id, which on a rejected Cypher query is
+ * the entire diagnosis.
+ *
+ * Routing them here instead keeps ONE formatting path, so a BYOG failure and an
+ * SDK failure are indistinguishable to everything above the wrapper.
+ */
+export declare function responseError(path: string, status: number, body: unknown): HydraWrapperError;
 /**
  * Translate any error thrown by an SDK call into a `HydraWrapperError` carrying
  * the byte-identical `Hydra DB ${path} → ${status}: ${body}` message.

package/dist/hydra/errors.js

@@ -124,6 +124,22 @@ function truncate(text) {
         return text;
     return `${text.slice(0, MAX_BODY_CHARS)}… (truncated, ${text.length} chars)`;
 }
+/**
+ * Build the same error from a raw HTTP response, for calls that do not go
+ * through the SDK.
+ *
+ * The BYOG endpoints have no SDK resource to throw `HydraDBError`, so
+ * `translateError` alone would send every one of their failures down its
+ * generic branch and drop the response body — losing the error code, the
+ * server's explanation and the request id, which on a rejected Cypher query is
+ * the entire diagnosis.
+ *
+ * Routing them here instead keeps ONE formatting path, so a BYOG failure and an
+ * SDK failure are indistinguishable to everything above the wrapper.
+ */
+export function responseError(path, status, body) {
+    return new HydraWrapperError(`Hydra DB ${path} → ${status}: ${bodyToString(body)}`, path, { status, body });
+}
 /**
  * Translate any error thrown by an SDK call into a `HydraWrapperError` carrying
  * the byte-identical `Hydra DB ${path} → ${status}: ${body}` message.

package/dist/hydra/errors.js.map

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

package/dist/hydra/graph.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The BYOG (Bring Your Own Graph) half of the wrapper.
+ *
+ * Everything else in this directory delegates to `@hydradb/sdk`. This file
+ * cannot: the generated SDK at the pinned 2.1.2 exposes `context`, `databases`,
+ * `connectors` and `webhooks` and has no `byog` resource at all, so the
+ * `/byog/*` endpoints are unreachable through it.
+ *
+ * So this is a hand-rolled HTTP path — but it is NOT a second client. It sits
+ * behind the same wrapper surface, unwraps the same `HandlerEnvelope` by shape
+ * (see ./envelope), and raises the same `HydraWrapperError` with the same
+ * message template (see ./errors). A caller cannot tell which of its methods
+ * went through the SDK and which did not, which is the property that matters:
+ * when the SDK grows a `byog` resource, this file is replaced and nothing above
+ * it changes.
+ *
+ * CONTRACT §2 rule 1 pins the SDK exactly because generated method names churn.
+ * That reasoning is unaffected here — there is no generated name to be
+ * insulated from yet.
+ */
+export interface GraphConfig {
+    token: string;
+    baseUrl?: string;
+    timeoutSeconds?: number;
+    maxRetries?: number;
+}
+export interface GraphQueryParams {
+    database: string;
+    collection: string;
+    query: string;
+    params?: Record<string, unknown>;
+}
+export interface GraphScopeParams {
+    database: string;
+    collection?: string;
+}
+/** One row of a Cypher result: keys are the RETURN column names. */
+export type GraphRow = Record<string, unknown>;
+export interface RequestOptions {
+    signal?: AbortSignal;
+}
+export declare class GraphResource {
+    private readonly config;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    constructor(config: GraphConfig);
+    /**
+     * Run Cypher against one collection (`POST /byog/query`).
+     *
+     * Returns the rows verbatim — an array of row objects keyed by the query's
+     * RETURN column names. A write with no RETURN yields `[]`, which is a
+     * success and must not be read as a failure.
+     */
+    query(params: GraphQueryParams, opts?: RequestOptions): Promise<GraphRow[]>;
+    /** Create a graph database (`POST /byog/databases`). Ready immediately. */
+    createDatabase(database: string, opts?: RequestOptions): Promise<{
+        database?: string;
+        status?: string;
+        cluster?: string;
+    }>;
+    /** List the collections in a graph database (`GET /byog/collections`). */
+    listCollections(params: GraphScopeParams, opts?: RequestOptions): Promise<string[]>;
+    /** Drop one collection and all its data (`DELETE /byog/collections`). Idempotent. */
+    dropCollection(params: {
+        database: string;
+        collection: string;
+    }, opts?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * Drop a graph database (`DELETE /byog/databases`).
+     *
+     * `deleted` is false when the database was created through the standard
+     * database API and merely holds graph collections — in that case only the
+     * collections go. That distinction is reported, not smoothed over.
+     */
+    dropDatabase(database: string, opts?: RequestOptions): Promise<{
+        deleted?: boolean;
+        deleted_collections?: string[];
+    }>;
+    private send;
+    private attempt;
+}

package/dist/hydra/graph.js

@@ -0,0 +1,217 @@
+/**
+ * The BYOG (Bring Your Own Graph) half of the wrapper.
+ *
+ * Everything else in this directory delegates to `@hydradb/sdk`. This file
+ * cannot: the generated SDK at the pinned 2.1.2 exposes `context`, `databases`,
+ * `connectors` and `webhooks` and has no `byog` resource at all, so the
+ * `/byog/*` endpoints are unreachable through it.
+ *
+ * So this is a hand-rolled HTTP path — but it is NOT a second client. It sits
+ * behind the same wrapper surface, unwraps the same `HandlerEnvelope` by shape
+ * (see ./envelope), and raises the same `HydraWrapperError` with the same
+ * message template (see ./errors). A caller cannot tell which of its methods
+ * went through the SDK and which did not, which is the property that matters:
+ * when the SDK grows a `byog` resource, this file is replaced and nothing above
+ * it changes.
+ *
+ * CONTRACT §2 rule 1 pins the SDK exactly because generated method names churn.
+ * That reasoning is unaffected here — there is no generated name to be
+ * insulated from yet.
+ */
+import { unwrap } from "./envelope.js";
+import { HydraWrapperError, responseError, translateError } from "./errors.js";
+/** The SDK's own default, restated so this file does not depend on importing it. */
+const DEFAULT_BASE_URL = "https://api.hydradb.com";
+/**
+ * Status codes worth retrying.
+ *
+ * 429 and 5xx are documented as transient. 4xx other than 429 are not: a
+ * rejected construct, a Cypher error and a bad collection name all fail
+ * identically on retry, so retrying them only delays the message.
+ */
+function isRetryable(status) {
+    return status === 429 || (status >= 500 && status <= 599);
+}
+/**
+ * A 2xx whose body is not the shape this endpoint promises.
+ *
+ * Raised rather than coerced to an empty result. An empty array is a perfectly
+ * ordinary answer here — a query that matched nothing, a database with no
+ * graphs — so silently substituting one for a malformed response makes a broken
+ * integration indistinguishable from a true negative, which is the one case a
+ * caller cannot debug. The `path` and a bounded preview of what actually
+ * arrived are carried through so the failure is actionable.
+ */
+function unexpectedShape(path, expected, got) {
+    let preview;
+    try {
+        preview = JSON.stringify(got) ?? String(got);
+    }
+    catch {
+        preview = String(got);
+    }
+    if (preview.length > 200)
+        preview = `${preview.slice(0, 200)}…`;
+    return new HydraWrapperError(`Hydra DB ${path} → ERR: expected ${expected}, got ${preview}. ` +
+        "This is a response-shape mismatch, not an empty result.", path, { body: got });
+}
+export class GraphResource {
+    constructor(config) {
+        this.config = config;
+        // Trailing slashes would produce `//byog/query`, which some proxies treat
+        // as a different path.
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeoutMs = (config.timeoutSeconds ?? 30) * 1000;
+        this.maxRetries = config.maxRetries ?? 2;
+    }
+    /**
+     * Run Cypher against one collection (`POST /byog/query`).
+     *
+     * Returns the rows verbatim — an array of row objects keyed by the query's
+     * RETURN column names. A write with no RETURN yields `[]`, which is a
+     * success and must not be read as a failure.
+     */
+    async query(params, opts) {
+        const body = {
+            database: params.database,
+            collection: params.collection,
+            query: params.query,
+            ...(params.params != null ? { params: params.params } : {}),
+        };
+        const rows = await this.send("/byog/query", "POST", body, opts);
+        // `data` is ALWAYS an array on success — verified against the live API,
+        // including a write with no RETURN, which yields `[]`. So anything else
+        // means the response contract moved, and coercing it to `[]` would
+        // present that as a legitimate "no rows matched": the caller would read a
+        // broken integration as an empty graph and act on it. Fail loudly instead.
+        if (!Array.isArray(rows)) {
+            throw unexpectedShape("/byog/query", "an array of row objects", rows);
+        }
+        // Element-wise, not just the container. `renderRows` calls `Object.keys`
+        // on each row, which throws a bare TypeError on `null` and on a string —
+        // an unactionable crash inside a tool handler, where the caller sees a
+        // stack rather than "the response was not what we expected".
+        const bad = rows.findIndex((row) => row == null || typeof row !== "object" || Array.isArray(row));
+        if (bad !== -1) {
+            throw unexpectedShape("/byog/query", `an array of row objects (row ${bad} is not one)`, rows[bad]);
+        }
+        return rows;
+    }
+    /** Create a graph database (`POST /byog/databases`). Ready immediately. */
+    createDatabase(database, opts) {
+        return this.send("/byog/databases", "POST", { database }, opts);
+    }
+    /** List the collections in a graph database (`GET /byog/collections`). */
+    async listCollections(params, opts) {
+        const res = await this.send(`/byog/collections?database=${encodeURIComponent(params.database)}`, "GET", undefined, opts);
+        // Same reasoning as `query`: a missing or non-array `collections` is a
+        // contract change, and reporting it as "no collections yet" would send
+        // the caller off to create graphs that already exist.
+        if (!Array.isArray(res?.collections)) {
+            throw unexpectedShape("/byog/collections", "an object with a `collections` array", res);
+        }
+        // A non-string element would be rendered as a collection name the caller
+        // could then pass back as scope, so it is reported rather than coerced.
+        const notAName = res.collections.findIndex((name) => typeof name !== "string");
+        if (notAName !== -1) {
+            throw unexpectedShape("/byog/collections", `an array of collection names (index ${notAName} is not a string)`, res.collections[notAName]);
+        }
+        return res.collections;
+    }
+    /** Drop one collection and all its data (`DELETE /byog/collections`). Idempotent. */
+    dropCollection(params, opts) {
+        return this.send("/byog/collections", "DELETE", params, opts);
+    }
+    /**
+     * Drop a graph database (`DELETE /byog/databases`).
+     *
+     * `deleted` is false when the database was created through the standard
+     * database API and merely holds graph collections — in that case only the
+     * collections go. That distinction is reported, not smoothed over.
+     */
+    dropDatabase(database, opts) {
+        return this.send("/byog/databases", "DELETE", { database }, opts);
+    }
+    // --- Transport ---
+    async send(path, method, body, opts) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                return await this.attempt(path, method, body, opts);
+            }
+            catch (err) {
+                lastError = err;
+                const status = err instanceof HydraWrapperError ? err.status : undefined;
+                // A caller who cancelled is not waiting for a retry.
+                if (opts?.signal?.aborted)
+                    throw err;
+                if (attempt === this.maxRetries)
+                    break;
+                if (status != null && !isRetryable(status))
+                    break;
+                // Exponential backoff. Bounded so a 429 on the last attempt does not
+                // hold the MCP host's tool timeout open for its own sake.
+                const delay = Math.min(250 * 2 ** attempt, 2000);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        throw lastError;
+    }
+    async attempt(path, method, body, opts) {
+        // The host's cancellation and our own deadline both have to be able to
+        // abort the request, and `AbortSignal.any` is not available on every Node
+        // 18 this package supports — so they are combined by hand.
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        const onAbort = () => controller.abort();
+        opts?.signal?.addEventListener("abort", onAbort, { once: true });
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: {
+                    Authorization: `Bearer ${this.config.token}`,
+                    "Content-Type": "application/json",
+                    // CONTRACT §2 rule 6. The SDK sends this on every call; a
+                    // hand-rolled path that omitted it would silently get v1
+                    // behaviour from the same endpoints.
+                    "API-Version": "2",
+                },
+                ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+                signal: controller.signal,
+            });
+            const text = await response.text();
+            let parsed;
+            try {
+                parsed = text === "" ? null : JSON.parse(text);
+            }
+            catch {
+                parsed = text;
+            }
+            if (!response.ok) {
+                // Hand the parsed envelope to the shared formatter so a BYOG
+                // failure reads exactly like an SDK one, error code and request id
+                // and all.
+                throw responseError(path, response.status, parsed);
+            }
+            return unwrap(parsed);
+        }
+        catch (err) {
+            if (err instanceof HydraWrapperError)
+                throw err;
+            // Distinguish our own deadline from the caller's cancellation: they
+            // need different actions, and "aborted" alone says neither.
+            if (err instanceof Error && err.name === "AbortError") {
+                if (opts?.signal?.aborted) {
+                    throw new HydraWrapperError(`Hydra DB ${path} → ERR: request cancelled by the caller`, path, { cause: err });
+                }
+                throw new HydraWrapperError(`Hydra DB ${path} → ERR: request timed out after ${this.timeoutMs / 1000}s`, path, { cause: err });
+            }
+            throw translateError(path, err);
+        }
+        finally {
+            clearTimeout(timer);
+            opts?.signal?.removeEventListener("abort", onAbort);
+        }
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/hydra/graph.js.map

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

package/dist/hydra/index.d.ts

@@ -7,5 +7,7 @@
  */
 export { HydraDB, ContextResource, DatabasesResource, DEFAULT_TIMEOUT_SECONDS, DEFAULT_MAX_RETRIES, } from "./client.js";
 export type { HydraConfig, ContextKind, RequestOptions, QueryKind, ConversationTurn, QueryParams, IngestParams, ListParams, InspectParams, IngestionStatusParams, RelationsParams, DeleteParams, CreateDatabaseParams, } from "./client.js";
-export { HydraWrapperError, translateError } from "./errors.js";
+export { GraphResource } from "./graph.js";
+export type { GraphConfig, GraphQueryParams, GraphScopeParams, GraphRow, } from "./graph.js";
+export { HydraWrapperError, responseError, translateError } from "./errors.js";
 export { unwrap } from "./envelope.js";

package/dist/hydra/index.js

@@ -6,6 +6,7 @@
  * other client repos (per CONTRACT.md).
  */
 export { HydraDB, ContextResource, DatabasesResource, DEFAULT_TIMEOUT_SECONDS, DEFAULT_MAX_RETRIES, } from "./client.js";
-export { HydraWrapperError, translateError } from "./errors.js";
+export { GraphResource } from "./graph.js";
+export { HydraWrapperError, responseError, translateError } from "./errors.js";
 export { unwrap } from "./envelope.js";
 //# sourceMappingURL=index.js.map

package/dist/hydra/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hydra/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACN,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,aAAa,CAAC;AAgBrB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hydra/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACN,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,aAAa,CAAC;AAgBrB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO3C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/server.d.ts

@@ -1,3 +1,4 @@
+import type { GraphConfig } from "./config.js";
 import { HydraDB } from "./hydra/index.js";
 /** Stop accepting tool calls. Idempotent. */
 export declare function beginShutdown(): void;
@@ -18,7 +19,12 @@ export declare function inFlightCount(): number;
 export declare function legacyToolsEnabled(env?: NodeJS.ProcessEnv): boolean;
 /** Test-only: reset the once-per-process alias warning dedupe. */
 export declare function __resetAliasWarnings(): void;
-export declare function createHydraDBServer(hydraOverride?: HydraDB): import("@modelcontextprotocol/sdk/server").Server<{
+export declare function createHydraDBServer(hydraOverride?: HydraDB, 
+/**
+ * Graph scope/gating override, for tests and embedders. Without it the graph
+ * config is read from the environment exactly as the rest of the config is.
+ */
+graphOverride?: Partial<GraphConfig>): import("@modelcontextprotocol/sdk/server").Server<{
     method: string;
     params?: {
         [x: string]: unknown;