@hydradb/mcp 0.0.1 → 1.1.0

package/README.md

@@ -4,61 +4,106 @@ MCP (Model Context Protocol) server for [Hydra DB](https://hydradb.com), the sta
 
 ## Available Tools
 
-### **hydra_db_search**
+The tool names follow the canonical HydraDB vocabulary. Every previous name still
+works as a **deprecated alias** (marked as such in its description) so existing
+`mcp.json` files keep working — but new integrations should use the canonical
+names below.
+
+| Canonical tool | Deprecated alias(es) |
+|---|---|
+| `hydradb_query` | `hydra_db_search` |
+| `hydradb_ingest` | `hydra_db_store`, `hydra_db_ingest_conversation` |
+| `hydradb_list` | `hydra_db_list_memories`, `hydra_db_list_sources` |
+| `hydradb_inspect` | `hydra_db_fetch_content` |
+| `hydradb_delete` | `hydra_db_delete_memory` |
+
+### **hydradb_query**
 
 Search through Hydra DB memories. Returns relevant chunks with graph-enriched context including entity paths and knowledge graph relations.
 
-### **hydra_db_store**
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | Yes | The search query to find relevant memories |
+| `max_results` | number | No | Maximum number of memory chunks to return (1-50, default: 10) |
+| `mode` | string | No | Recall mode: `fast` for quick semantic search, `thinking` for deeper personalised recall with graph traversal (default: `thinking`) |
+| `graph_context` | boolean | No | Whether to include knowledge graph relations in results (default: true) |
 
-Save important information to Hydra DB memory. Hydra DB automatically extracts insights, preferences, and builds a knowledge graph from the stored content.
+### **hydradb_ingest**
 
-### **hydra_db_ingest_conversation**
+Save information to Hydra DB memory. Hydra DB automatically extracts insights, preferences, and builds a knowledge graph from the stored content. Provide `text` to store a note/document, or `turns` to ingest a conversation.
 
-Ingest user-assistant conversation turns into Hydra DB memory. Hydra DB extracts insights, preferences, and knowledge graph entities from the conversation.
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `text` | string | No\* | The information to store in memory |
+| `title` | string | No | Title for the memory entry (default: `MCP Memory`) |
+| `source_id` | string | No | Source identifier to group related memories together (e.g. session ID) |
+| `infer` | boolean | No | Whether Hydra DB should extract insights and build knowledge graph (default: true) |
+| `is_markdown` | boolean | No | Whether the text is in markdown format (default: false) |
+| `turns` | array | No\* | Conversation turns (each with a `user` and `assistant` field) to ingest instead of `text` |
+| `user_name` | string | No | Name of the user for personalisation, used with `turns` (default: `User`) |
 
-### **hydra_db_list_memories**
+\* Provide exactly one of `text` or `turns`.
 
-List all stored user memories in Hydra DB. Returns memory IDs and their content.
+### **hydradb_list**
 
-### **hydra_db_delete_memory**
+List stored memories or ingested knowledge sources in Hydra DB.
 
-Delete a specific user memory from Hydra DB by its memory ID.
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `kind` | string | No | Which family to list: `memory` or `knowledge` (default: `memory`) |
+| `source_ids` | array | No | For `knowledge`, an array of specific source IDs to filter by. If omitted, lists all |
 
-### **hydra_db_fetch_content**
+### **hydradb_inspect**
 
 Fetch the full content of a specific source by its source ID.
 
-### **hydra_db_list_sources**
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `source_id` | string | Yes | The source ID to fetch content for |
+| `mode` | string | No | Fetch mode: `content` for text, `url` for presigned URL, `both` for both (default: `content`) |
+
+### **hydradb_delete**
+
+Delete a memory or knowledge source from Hydra DB by its ID. This action is irreversible.
 
-List all ingested sources in Hydra DB memory.
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | Yes | The ID of the item to delete |
+| `kind` | string | No | Which family the ID belongs to: `memory` or `knowledge` (default: `memory`) |
 
 ## Configuration
 
 ### Get Your Credentials
 
 1. Get your Hydra DB API Key from [Hydra DB](https://app.hydradb.com)
-2. Get your Tenant ID from the Hydra DB dashboard
+2. Get your database name from the Hydra DB dashboard
 
 ### Environment Variables
 
-| Variable                 | Description                         | Default        |
-| ------------------------ | ----------------------------------- | -------------- |
-| `HYDRA_DB_API_KEY`       | Your Hydra-DB API key                 | *Required*   |
-| `HYDRA_DB_TENANT_ID`     | Your Hydra-DB tenant identifier       | *Required*   |
-| `HYDRA_DB_SUB_TENANT_ID` | Sub-tenant for data partitioning    | `hydra-db-mcp` |
-| `HYDRA_DB_LOG_LEVEL`     | Log level: DEBUG, INFO, WARN, ERROR | `ERROR`      |
+| Variable             | Description                          | Default                   |
+| -------------------- | ------------------------------------ | ------------------------- |
+| `HYDRADB_API_KEY`    | Your Hydra DB API key                | *Required*                |
+| `HYDRADB_DATABASE`   | Your Hydra DB database (tenant scope) | *Required*                |
+| `HYDRADB_COLLECTION` | Collection (sub-tenant) for partitioning | `hydra-db-mcp`        |
+| `HYDRADB_BASE_URL`   | Base URL override                    | `https://api.hydradb.com` |
+| `HYDRADB_LOG_LEVEL`  | Log level: DEBUG, INFO, WARN, ERROR  | `ERROR`                   |
+
+The legacy `HYDRA_DB_*` names — `HYDRA_DB_API_KEY`, `HYDRA_DB_TENANT_ID`,
+`HYDRA_DB_SUB_TENANT_ID`, `HYDRA_DB_BASE_URL`, `HYDRA_DB_LOG_LEVEL` — remain
+honoured as **deprecated aliases** (canonical wins when both are set; using an
+alias prints a one-time warning naming its replacement).
 
 ### Claude Desktop
 
 ```json
 {
   "mcpServers": {
-        "hydradb": {
+    "hydradb": {
       "command": "npx",
-      "args": ["-y", "@hydra_db/mcp@0.1.1"],
+      "args": ["-y", "@hydradb/mcp@latest"],
       "env": {
-        "HYDRA_DB_API_KEY": "your-api-key",
-        "HYDRA_DB_TENANT_ID": "your-tenant-id"
+        "HYDRADB_API_KEY": "your-api-key",
+        "HYDRADB_DATABASE": "your-database"
       }
     }
   }
@@ -75,12 +120,12 @@ List all ingested sources in Hydra DB memory.
 ```json
 {
   "mcpServers": {
-      "hydradb": {
+    "hydradb": {
       "command": "npx",
-      "args": ["-y", "@hydra_db/mcp@0.1.1"],
+      "args": ["-y", "@hydradb/mcp@latest"],
       "env": {
-        "HYDRA_DB_API_KEY": "your-api-key",
-        "HYDRA_DB_TENANT_ID": "your-tenant-id"
+        "HYDRADB_API_KEY": "your-api-key",
+        "HYDRADB_DATABASE": "your-database"
       }
     }
   }
@@ -94,13 +139,13 @@ Add to `.vscode/mcp.json`:
 ```json
 {
   "servers": {
-        "hydradb": {
+    "hydradb": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@hydra_db/mcp@0.1.1"],
+      "args": ["-y", "@hydradb/mcp@latest"],
       "env": {
-        "HYDRA_DB_API_KEY": "your-api-key",
-        "HYDRA_DB_TENANT_ID": "your-tenant-id"
+        "HYDRADB_API_KEY": "your-api-key",
+        "HYDRADB_DATABASE": "your-database"
       }
     }
   }
@@ -109,18 +154,18 @@ Add to `.vscode/mcp.json`:
 
 ### Custom Sub-Tenant
 
-To partition data, set the `HYDRA_DB_SUB_TENANT_ID` environment variable:
+To partition data, set the `HYDRADB_COLLECTION` environment variable:
 
 ```json
 {
   "mcpServers": {
-        "hydradb": {
+    "hydradb": {
       "command": "npx",
-      "args": ["-y", "@hydra_db/mcp@0.1.1"],
+      "args": ["-y", "@hydradb/mcp@latest"],
       "env": {
-        "HYDRA_DB_API_KEY": "your-api-key",
-        "HYDRA_DB_TENANT_ID": "your-tenant-id",
-        "HYDRA_DB_SUB_TENANT_ID": "my-project"
+        "HYDRADB_API_KEY": "your-api-key",
+        "HYDRADB_DATABASE": "your-database",
+        "HYDRADB_COLLECTION": "my-project"
       }
     }
   }
@@ -129,43 +174,50 @@ To partition data, set the `HYDRA_DB_SUB_TENANT_ID` environment variable:
 
 ## How It Works
 
-- **hydra_db_search** queries `/recall/recall_preferences` for relevant memories and returns graph-enriched context (entity paths, chunk relations, extra context).
-- **hydra_db_store** sends text to `/memories/add_memory` with `infer: true` and `upsert: true`. Hydra-DB extracts insights and builds a knowledge graph automatically.
-- **hydra_db_ingest_conversation** sends user-assistant pairs to `/memories/add_memory` as conversation turns, grouped by `source_id`.
-- **hydra_db_list_memories** and **hydra_db_list_sources** query `/list/data` to browse stored data.
-- **hydra_db_delete_memory** calls `DELETE /memories/delete_memory` to remove a specific memory.
-- **hydra_db_fetch_content** calls `/fetch/content` to retrieve the original ingested content.
+The server talks to Hydra DB through the generated [`@hydradb/sdk`](https://www.npmjs.com/package/@hydradb/sdk)
+(pinned exactly), behind a thin hand-owned wrapper in `src/hydra`. The wrapper
+owns scope injection, envelope unwrapping and error translation; the tools call
+it and render the results.
+
+- **hydradb_query** retrieves relevant memories and returns graph-enriched context (entity paths, chunk relations, extra context). Supports `fast` and `thinking` recall modes.
+- **hydradb_ingest** stores a note (`text`) or a conversation (`turns`) as a memory, with configurable `infer`, `is_markdown`, `title`, and `source_id`. Hydra DB extracts insights and builds a knowledge graph automatically.
+- **hydradb_list** browses stored memories (`kind: memory`) or ingested knowledge sources (`kind: knowledge`, with an optional `source_ids` filter).
+- **hydradb_inspect** retrieves the original ingested content of a source, with mode options (`content`, `url`, or `both`).
+- **hydradb_delete** removes a memory or knowledge source by ID.
 
 ## Development
 
 ```bash
-npm install
+npm ci
 npm run build
-HYDRA_DB_API_KEY=your-key HYDRA_DB_TENANT_ID=your-tenant npm start
+HYDRADB_API_KEY=your-key HYDRADB_DATABASE=your-database npm start
 ```
 
 For development with auto-reload:
 
 ```bash
-HYDRA_DB_API_KEY=your-key HYDRA_DB_TENANT_ID=your-tenant npm run dev
+HYDRADB_API_KEY=your-key HYDRADB_DATABASE=your-database npm run dev
 ```
 
 ## Testing
 
 ```bash
-# unit tests (mocked HTTP)
+# unit + conformance tests (wrapper driven against a mocked SDK transport)
 npm test
 
-# live integration test against Hydra DB
-RUN_LIVE_TESTS=true HYDRA_DB_API_KEY=your-key HYDRA_DB_TENANT_ID=your-tenant npm run test:integration
+# just the shared conformance vectors
+npm run test:conformance
+
+# live integration test against Hydra DB (drives the wrapper end to end)
+RUN_LIVE_TESTS=true HYDRADB_API_KEY=your-key HYDRADB_DATABASE=your-database npm run test:integration
 ```
 
 ## Troubleshooting
 
-- **API Key Issues**: Ensure `HYDRA_DB_API_KEY` is set correctly
+- **API Key Issues**: Ensure `HYDRADB_API_KEY` is set correctly
 - **Connection Errors**: Check your internet connection and API key validity
 - **Tool Not Found**: Make sure the package is installed and the command path is correct
-- **Debug Logging**: Set `HYDRA_DB_LOG_LEVEL=DEBUG` for verbose output
+- **Debug Logging**: Set `HYDRADB_LOG_LEVEL=DEBUG` for verbose output
 
 ## Contributing / Developer Setup
 
@@ -187,4 +239,3 @@ make check-types  # Type-check without emitting
 ```
 
 Run `make help` to see all available targets.
-

package/dist/adapters.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Adapters from the SDK's (camelCase) response payloads back into the legacy
+ * snake_case shapes this server already renders.
+ *
+ * These live in the MCP layer — NOT the portable wrapper — because they exist
+ * only to keep `src/context.ts` (the high-value, byte-identical recall
+ * renderer) and the existing tool output strings unchanged across the v1 → SDK
+ * migration. The wrapper returns SDK-native `.data`; the server adapts it here.
+ *
+ * Note: with `skipValidation`, the SDK transforms known fields to camelCase but
+ * leaves the untyped triplet innards (`relation`/`source`/`target`) as raw
+ * snake_case — which is exactly what `formatTriplet` reads — so triplets pass
+ * through untouched.
+ */
+import type { HydraDB as SDK } from "@hydradb/sdk";
+import type { AddMemoryResponse, RecallResponse } from "./types.js";
+/** SDK retrieval result → the legacy `RecallResponse` fed to `buildRecalledContext`. */
+export declare function toRecallResponse(data: SDK.SearchV2RetrievalResult): RecallResponse;
+/** SDK ingest result → the legacy `AddMemoryResponse` (success/failed counts). */
+export declare function toAddMemoryResponse(data: SDK.IngestionV2SourceUploadResponse): AddMemoryResponse;
+export interface MemoryListItem {
+    memory_id: string;
+    memory_content: string;
+}
+/** SDK list result → memory rows. Field names vary across v2 records, so read defensively. */
+export declare function toMemoryList(data: SDK.ListV2SourceListResponse): MemoryListItem[];
+export interface SourceListItem {
+    id: string;
+    title?: string;
+    type?: string;
+}
+export interface SourceList {
+    sources: SourceListItem[];
+    total: number;
+}
+/** SDK list result → knowledge source rows + total. */
+export declare function toSourceList(data: SDK.ListV2SourceListResponse): SourceList;

package/dist/adapters.js

@@ -0,0 +1,113 @@
+/**
+ * Adapters from the SDK's (camelCase) response payloads back into the legacy
+ * snake_case shapes this server already renders.
+ *
+ * These live in the MCP layer — NOT the portable wrapper — because they exist
+ * only to keep `src/context.ts` (the high-value, byte-identical recall
+ * renderer) and the existing tool output strings unchanged across the v1 → SDK
+ * migration. The wrapper returns SDK-native `.data`; the server adapts it here.
+ *
+ * Note: with `skipValidation`, the SDK transforms known fields to camelCase but
+ * leaves the untyped triplet innards (`relation`/`source`/`target`) as raw
+ * snake_case — which is exactly what `formatTriplet` reads — so triplets pass
+ * through untouched.
+ */
+function toScoredPath(path) {
+    return {
+        // Triplet innards are already raw snake_case (untyped in the SDK schema).
+        triplets: (path.triplets ?? []),
+        relevancy_score: path.relevancyScore ?? 0,
+        combined_context: path.combinedContext ?? null,
+        group_id: path.groupId ?? null,
+    };
+}
+function toVectorChunk(chunk) {
+    return {
+        chunk_uuid: chunk.chunkUuid ?? "",
+        source_id: chunk.id ?? "",
+        chunk_content: chunk.chunkContent ?? "",
+        source_title: chunk.sourceTitle,
+        source_type: chunk.sourceType,
+        source_upload_time: chunk.sourceUploadTime,
+        source_last_updated_time: chunk.sourceLastUpdatedTime,
+        relevancy_score: chunk.relevancyScore ?? null,
+        document_metadata: chunk.additionalMetadata ?? null,
+        tenant_metadata: chunk.metadata ?? null,
+        extra_context_ids: chunk.extraContextIds ?? null,
+        layout: chunk.layout ?? null,
+    };
+}
+/** SDK retrieval result → the legacy `RecallResponse` fed to `buildRecalledContext`. */
+export function toRecallResponse(data) {
+    const graph = data.graphContext;
+    const additional = {};
+    for (const [id, chunk] of Object.entries(data.additionalContext ?? {})) {
+        additional[id] = toVectorChunk(chunk);
+    }
+    return {
+        chunks: (data.chunks ?? []).map(toVectorChunk),
+        graph_context: graph
+            ? {
+                query_paths: (graph.queryPaths ?? []).map(toScoredPath),
+                chunk_relations: (graph.chunkRelations ?? []).map(toScoredPath),
+                chunk_id_to_group_ids: graph.chunkIdToGroupIds ?? {},
+            }
+            : undefined,
+        additional_context: additional,
+    };
+}
+/** SDK ingest result → the legacy `AddMemoryResponse` (success/failed counts). */
+export function toAddMemoryResponse(data) {
+    return {
+        success: data.success ?? false,
+        message: data.message ?? "",
+        results: [],
+        success_count: data.successCount ?? 0,
+        failed_count: data.failedCount ?? 0,
+    };
+}
+function str(record, ...keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === "string")
+            return value;
+    }
+    return undefined;
+}
+function asRecords(value) {
+    return Array.isArray(value)
+        ? value
+        : undefined;
+}
+/** SDK list result → memory rows. Field names vary across v2 records, so read defensively. */
+export function toMemoryList(data) {
+    // Memory listings surface at top-level `user_memories` — not under an
+    // `.inner` wrapper, and not under `sources` (that is the knowledge shape).
+    const d = data;
+    const records = asRecords(d.user_memories) ??
+        asRecords(d.inner?.user_memories) ??
+        [];
+    return records.map((record) => ({
+        memory_id: str(record, "memory_id", "id", "source_id") ?? "",
+        memory_content: str(record, "memory_content", "content", "text", "memory", "title") ?? "",
+    }));
+}
+/** SDK list result → knowledge source rows + total. */
+export function toSourceList(data) {
+    // Knowledge listings surface at top-level `sources`, not under `.inner`.
+    const d = data;
+    const records = asRecords(d.sources) ??
+        asRecords(d.inner?.sources) ??
+        [];
+    const sources = records.map((record) => ({
+        id: str(record, "id", "source_id") ?? "",
+        title: str(record, "title"),
+        type: str(record, "type", "source_type"),
+    }));
+    const total = d.total ?? d.inner?.total;
+    return {
+        sources,
+        total: typeof total === "number" ? total : sources.length,
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Server configuration from the environment.
+ *
+ * Adopts the canonical `HYDRADB_*` names (CONTRACT §1) as PRIMARY, while still
+ * honouring the legacy `HYDRA_DB_*` names as deprecated aliases so existing
+ * setups keep working. The canonical name wins when both are set; using a
+ * deprecated alias emits exactly one stderr warning per process naming the
+ * canonical replacement.
+ */
+export interface HydraDBConfig {
+    apiKey: string;
+    database: string;
+    collection: string;
+    baseUrl?: string;
+}
+export type EnvSource = Record<string, string | undefined>;
+export type WarnFn = (message: string) => void;
+/**
+ * Read a canonical `HYDRADB_*` variable, falling back to the legacy `HYDRA_DB_*`
+ * spelling with a once-per-process warning. Exported so every variable this
+ * server reads goes through the same rule - `HYDRADB_LOG_LEVEL` is resolved by
+ * the logger, which owns its own module state but must not invent a second
+ * deprecation policy.
+ */
+export declare function readEnv(env: EnvSource, canonical: string, deprecated: string, warn?: WarnFn): string | undefined;
+export declare function resolveConfig(env?: EnvSource, warn?: WarnFn): HydraDBConfig;

package/dist/config.js

@@ -0,0 +1,55 @@
+/**
+ * Server configuration from the environment.
+ *
+ * Adopts the canonical `HYDRADB_*` names (CONTRACT §1) as PRIMARY, while still
+ * honouring the legacy `HYDRA_DB_*` names as deprecated aliases so existing
+ * setups keep working. The canonical name wins when both are set; using a
+ * deprecated alias emits exactly one stderr warning per process naming the
+ * canonical replacement.
+ */
+const DEFAULT_COLLECTION = "hydra-db-mcp";
+// Process-lifetime dedupe so each deprecated alias warns at most once.
+const warnedOnce = new Set();
+function defaultWarn(message) {
+    console.error(message);
+}
+function warnOnce(message, warn) {
+    if (warnedOnce.has(message))
+        return;
+    warnedOnce.add(message);
+    warn(message);
+}
+/**
+ * Read a canonical `HYDRADB_*` variable, falling back to the legacy `HYDRA_DB_*`
+ * spelling with a once-per-process warning. Exported so every variable this
+ * server reads goes through the same rule - `HYDRADB_LOG_LEVEL` is resolved by
+ * the logger, which owns its own module state but must not invent a second
+ * deprecation policy.
+ */
+export function readEnv(env, canonical, deprecated, warn = defaultWarn) {
+    const canonicalValue = env[canonical];
+    if (canonicalValue != null && canonicalValue !== "") {
+        return canonicalValue;
+    }
+    const deprecatedValue = env[deprecated];
+    if (deprecatedValue != null && deprecatedValue !== "") {
+        warnOnce(`[hydradb-mcp] Environment variable ${deprecated} is deprecated; use ${canonical} instead.`, warn);
+        return deprecatedValue;
+    }
+    return undefined;
+}
+export function resolveConfig(env = process.env, warn = defaultWarn) {
+    const apiKey = readEnv(env, "HYDRADB_API_KEY", "HYDRA_DB_API_KEY", warn);
+    if (!apiKey) {
+        throw new Error("HYDRADB_API_KEY (or its deprecated alias HYDRA_DB_API_KEY) environment variable is required");
+    }
+    const database = readEnv(env, "HYDRADB_DATABASE", "HYDRA_DB_TENANT_ID", warn);
+    if (!database) {
+        throw new Error("HYDRADB_DATABASE (or its deprecated alias HYDRA_DB_TENANT_ID) environment variable is required");
+    }
+    const collection = readEnv(env, "HYDRADB_COLLECTION", "HYDRA_DB_SUB_TENANT_ID", warn) ??
+        DEFAULT_COLLECTION;
+    const baseUrl = readEnv(env, "HYDRADB_BASE_URL", "HYDRA_DB_BASE_URL", warn);
+    return { apiKey, database, collection, baseUrl };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAE1C,uEAAuE;AACvE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AACrC,SAAS,WAAW,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AACD,SAAS,QAAQ,CAAC,OAAe,EAAE,IAAY;IAC9C,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IACpC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,IAAI,CAAC,OAAO,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CACtB,GAAc,EACd,SAAiB,EACjB,UAAkB,EAClB,OAAe,WAAW;IAE1B,MAAM,cAAc,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,cAAc,IAAI,IAAI,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;QACrD,OAAO,cAAc,CAAC;IACvB,CAAC;IACD,MAAM,eAAe,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,eAAe,IAAI,IAAI,IAAI,eAAe,KAAK,EAAE,EAAE,CAAC;QACvD,QAAQ,CACP,sCAAsC,UAAU,uBAAuB,SAAS,WAAW,EAC3F,IAAI,CACJ,CAAC;QACF,OAAO,eAAe,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAC5B,MAAiB,OAAO,CAAC,GAAG,EAC5B,OAAe,WAAW;IAE1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,6FAA6F,CAC7F,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAC9E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,gGAAgG,CAChG,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GACf,OAAO,CAAC,GAAG,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,IAAI,CAAC;QAClE,kBAAkB,CAAC;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAE5E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,5 @@
+import type { RecallResponse } from "./types.js";
+export declare function buildRecalledContext(response: RecallResponse, opts?: {
+    maxGroupOccurrences?: number;
+    minEvidenceScore?: number;
+}): string;

package/dist/context.js.map

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

package/dist/descriptions.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Tool descriptions for the Hydra DB MCP server.
+ * Kept in a separate file for easy editing and localisation.
+ *
+ * Every canonical tool (CONTRACT §3) and every deprecated alias has an entry.
+ * Alias descriptions are prefixed with a DEPRECATED notice naming the canonical
+ * replacement so the model prefers the new name.
+ */
+export declare const TOOL_DESCRIPTIONS: {
+    readonly hydradb_query: {
+        readonly title: "Query Hydra DB";
+        readonly description: string;
+        readonly params: {
+            readonly query: "The search query to find relevant memories";
+            readonly max_results: "Maximum number of memory chunks to return (1-50, default: 10)";
+            readonly mode: "Recall mode: 'fast' for quick semantic search, 'thinking' for deeper personalised recall with graph traversal (default: 'thinking')";
+            readonly graph_context: "Whether to include knowledge graph relations in results (default: true)";
+        };
+    };
+    readonly hydradb_ingest: {
+        readonly title: "Ingest into Hydra DB";
+        readonly description: string;
+        readonly params: {
+            readonly text: "The information to store in memory";
+            readonly title: "Optional title for the memory entry (default: 'MCP Memory')";
+            readonly source_id: string;
+            readonly infer: "Whether Hydra DB should extract insights and build knowledge graph from this text (default: true)";
+            readonly is_markdown: "Whether the text is in markdown format (default: false)";
+            readonly turns: "Optional conversation turns to ingest instead of `text`; each has a 'user' and 'assistant' field";
+            readonly user_name: "Optional name of the user for personalisation (default: 'User')";
+        };
+    };
+    readonly hydradb_list: {
+        readonly title: "List Hydra DB Context";
+        readonly description: string;
+        readonly params: {
+            readonly kind: "Which context family to list: 'memory' or 'knowledge' (default: 'memory')";
+            readonly source_ids: "Optional array of specific source IDs to filter by. If omitted, lists all sources.";
+        };
+    };
+    readonly hydradb_inspect: {
+        readonly title: "Inspect Hydra DB Source";
+        readonly description: string;
+        readonly params: {
+            readonly source_id: "The source ID to fetch content for";
+            readonly mode: "Fetch mode: 'content' for text, 'url' for presigned URL, 'both' for both (default: 'content')";
+        };
+    };
+    readonly hydradb_delete: {
+        readonly title: "Delete from Hydra DB";
+        readonly description: string;
+        readonly params: {
+            readonly id: "The ID of the item to delete";
+            readonly kind: "Which context family the ID belongs to: 'memory' or 'knowledge' (default: 'memory')";
+        };
+    };
+    readonly hydra_db_search: {
+        readonly title: "Search Hydra DB Memory (deprecated)";
+        readonly description: string;
+        readonly params: {
+            readonly query: "The search query to find relevant memories";
+            readonly max_results: "Maximum number of memory chunks to return (1-50, default: 10)";
+            readonly mode: "Recall mode: 'fast' for quick semantic search, 'thinking' for deeper personalised recall with graph traversal (default: 'thinking')";
+            readonly graph_context: "Whether to include knowledge graph relations in results (default: true)";
+        };
+    };
+    readonly hydra_db_store: {
+        readonly title: "Store to Hydra DB Memory (deprecated)";
+        readonly description: string;
+        readonly params: {
+            readonly text: "The information to store in memory";
+            readonly title: "Optional title for the memory entry (default: 'MCP Memory')";
+            readonly source_id: string;
+            readonly infer: "Whether Hydra DB should extract insights and build knowledge graph from this text (default: true)";
+            readonly is_markdown: "Whether the text is in markdown format (default: false)";
+        };
+    };
+    readonly hydra_db_ingest_conversation: {
+        readonly title: "Ingest Conversation (deprecated)";
+        readonly description: string;
+        readonly params: {
+            readonly turns: "Array of conversation turns, each with a 'user' and 'assistant' field";
+            readonly source_id: "Source identifier to group all turns from the same session together";
+            readonly user_name: "Optional name of the user for personalisation (default: 'User')";
+        };
+    };
+    readonly hydra_db_list_memories: {
+        readonly title: "List Memories (deprecated)";
+        readonly description: string;
+    };
+    readonly hydra_db_list_sources: {
+        readonly title: "List Sources (deprecated)";
+        readonly description: string;
+        readonly params: {
+            readonly source_ids: "Optional array of specific source IDs to filter by. If omitted, lists all sources.";
+        };
+    };
+    readonly hydra_db_fetch_content: {
+        readonly title: "Fetch Source Content (deprecated)";
+        readonly description: string;
+        readonly params: {
+            readonly source_id: "The source ID to fetch content for";
+            readonly mode: "Fetch mode: 'content' for text, 'url' for presigned URL, 'both' for both (default: 'content')";
+        };
+    };
+    readonly hydra_db_delete_memory: {
+        readonly title: "Delete Memory (deprecated)";
+        readonly description: string;
+        readonly params: {
+            readonly memory_id: "The ID of the memory to delete";
+        };
+    };
+};
+export declare const SERVER_INSTRUCTIONS: string;