@hydradb/mcp 1.1.0 → 1.2.0

package/dist/descriptions.d.ts

@@ -9,70 +9,97 @@
 export declare const TOOL_DESCRIPTIONS: {
     readonly hydradb_query: {
         readonly title: "Query Hydra DB";
-        readonly description: string;
+        readonly description: "Search Hydra DB for anything the user has stored: memories (facts, preferences, decisions, past conversations) and ingested knowledge sources (documents, files, playbooks). Returns matching chunks with their source id, a relevance score, and knowledge-graph context — the entity paths and relations that connect facts across separate sources.\n\nCALL THIS BEFORE ANSWERING whenever the answer could depend on the user's history, preferences, prior decisions, project details, or a document they have ingested — including when you are merely unsure. A query that returns nothing costs one call; answering from a blank slate costs the user a correction.\n\nSearches both families by default. Every result carries `[id: …]` — pass it to hydradb_inspect for the full source, or to hydradb_delete to remove it.\n\nExamples:\n  {\"query\": \"how does the user prefer code review feedback\"}\n  {\"query\": \"postgres connection pooling decision\", \"kind\": \"knowledge\"}\n  {\"query\": \"deploy checklist\", \"mode\": \"fast\", \"max_results\": 5}";
         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 query: string;
+            readonly kind: string;
+            readonly max_results: string;
+            readonly mode: string;
+            readonly graph_context: string;
+            readonly detail: string;
+            readonly operator: string;
+            readonly source_ids: string;
+            readonly metadata_filters: string;
+            readonly num_related_chunks: string;
         };
     };
     readonly hydradb_ingest: {
         readonly title: "Ingest into Hydra DB";
-        readonly description: string;
+        readonly description: "Save information to Hydra DB so it outlives this session. Hydra DB extracts insights, preferences and knowledge-graph entities from what you store.\n\nProvide EXACTLY ONE of:\n  `text`  — a note, fact, decision, or document body\n  `turns` — user/assistant pairs from a conversation\nPassing both is an error; passing neither is an error.\n\nSave proactively: when the user states a preference, makes a decision, corrects you, or reveals a durable fact about themselves or their work, store it without being asked. Store the distilled fact rather than the raw exchange, and always set `title` — it is the only label shown next to this entry in later search results. Before saving something you suspect is already stored, query for it first rather than adding a near-duplicate.\n\nNever store secrets, credentials, or anything the user asked you not to keep.\n\nExamples:\n  {\"text\": \"Prefers tabs over spaces in every language; rejected two prettier configs that used spaces.\", \"title\": \"Indentation preference\"}\n  {\"turns\": [{\"user\": \"let's go with Postgres\", \"assistant\": \"Agreed, I'll set up the schema.\"}], \"title\": \"Datastore decision\"}\n  {\"text\": \"# Runbook\\n\\nRestart order: api, worker, scheduler.\", \"kind\": \"knowledge\", \"title\": \"Restart runbook\"}";
         readonly params: {
-            readonly text: "The information to store in memory";
-            readonly title: "Optional title for the memory entry (default: 'MCP Memory')";
+            readonly text: string;
+            readonly kind: string;
+            readonly title: string;
             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 infer: string;
+            readonly is_markdown: string;
+            readonly overwrite: string;
+            readonly metadata: string;
+            readonly observation_date: string;
+            readonly turns: string;
+            readonly user_name: string;
         };
     };
     readonly hydradb_list: {
         readonly title: "List Hydra DB Context";
-        readonly description: string;
+        readonly description: "Enumerate what is stored in Hydra DB — every memory (kind: \"memory\") or every knowledge source (kind: \"knowledge\"). These are SEPARATE corpora and this tool returns one at a time: listing memories tells you nothing about which knowledge sources exist, and vice versa. Call it twice to see everything.\n\nUse it for inventory questions (\"what do you remember about me?\", \"which documents are indexed?\") and to obtain ids. For \"what do you know about X\", use hydradb_query instead — listing everything and reading it is far more expensive and loses relevance ranking.\n\nResults are paginated. The response says how many of the total it showed and how to reach the rest; do not treat the first page as the whole store.\n\nMemory rows come back as [id] content. Knowledge rows as [id] — title (type), with no content — pass an id to hydradb_inspect for the text.";
         readonly params: {
-            readonly kind: "Which context family to list: 'memory' or 'knowledge' (default: 'memory')";
+            readonly kind: string;
             readonly source_ids: "Optional array of specific source IDs to filter by. If omitted, lists all sources.";
+            readonly page: string;
+            readonly page_size: string;
         };
     };
     readonly hydradb_inspect: {
         readonly title: "Inspect Hydra DB Source";
-        readonly description: string;
+        readonly description: "Fetch the full original content of ONE stored item by its id. Use it after hydradb_query or hydradb_list when a truncated chunk or listing row is not enough and you need the whole document.\n\nThe id is the value shown as `[id: …]` in hydradb_query results and in [brackets] in hydradb_list output. Ids are not guessable — take one from those tools rather than constructing it.\n\nLong sources come back in slices; the response says where it stopped and what offset continues it. Binary sources are never inlined — you get their type and size, and `mode: \"url\"` returns a download link.";
         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 mode: string;
+            readonly offset: string;
+            readonly limit: string;
+            readonly expiry_seconds: string;
         };
     };
     readonly hydradb_delete: {
         readonly title: "Delete from Hydra DB";
-        readonly description: string;
+        readonly description: "Permanently remove one memory or one knowledge source from Hydra DB by id. This cannot be undone; there is no trash.\n\nTake the id from hydradb_query or hydradb_list — never guess one. Confirm with the user before deleting anything they did not name: \"forget that I use vim\" authorises deleting that memory; \"clean up my memories\" authorises nothing until they have seen the list.\n\n`kind` must match the family the id belongs to. A knowledge source id passed with kind \"memory\" reports that nothing was deleted while the source is still there.";
         readonly params: {
-            readonly id: "The ID of the item to delete";
+            readonly ids: string;
+            readonly id: "A single ID to delete. Prefer `ids` when removing more than one.";
             readonly kind: "Which context family the ID belongs to: 'memory' or 'knowledge' (default: 'memory')";
         };
     };
+    readonly hydradb_status: {
+        readonly title: "Check Hydra DB Indexing Status";
+        readonly description: string;
+        readonly params: {
+            readonly ids: "The source IDs to check, as returned by hydradb_ingest.";
+        };
+    };
     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 query: string;
+            readonly kind: string;
+            readonly max_results: string;
+            readonly mode: string;
+            readonly graph_context: string;
         };
     };
     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 text: string;
+            readonly title: string;
             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 metadata: string;
+            readonly observation_date: string;
+            readonly infer: string;
+            readonly is_markdown: string;
+            readonly overwrite: string;
         };
     };
     readonly hydra_db_ingest_conversation: {
@@ -81,7 +108,7 @@ export declare const TOOL_DESCRIPTIONS: {
         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 user_name: string;
         };
     };
     readonly hydra_db_list_memories: {
@@ -100,7 +127,9 @@ export declare const TOOL_DESCRIPTIONS: {
         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 mode: string;
+            readonly offset: string;
+            readonly limit: string;
         };
     };
     readonly hydra_db_delete_memory: {

package/dist/descriptions.js

@@ -9,38 +9,133 @@
 import { ALIAS_REPLACEMENTS, TOOL_NAMES } from "./tool-names.js";
 // Shared parameter blurbs, reused across canonical tools and their aliases.
 const PARAM = {
-    query: "The search query to find relevant memories",
-    max_results: "Maximum number of memory chunks to return (1-50, default: 10)",
-    mode: "Recall mode: 'fast' for quick semantic search, 'thinking' for deeper personalised recall with graph traversal (default: 'thinking')",
-    graph_context: "Whether to include knowledge graph relations in results (default: true)",
-    text: "The information to store in memory",
-    title: "Optional title for the memory entry (default: 'MCP Memory')",
-    source_id: "Optional source identifier to group related memories together. You can use this as " +
-        "your session ID or any other unique identifier for a conversation",
-    infer: "Whether Hydra DB should extract insights and build knowledge graph from this text (default: true)",
-    is_markdown: "Whether the text is in markdown format (default: false)",
+    query: "What you want to know, as a natural-language question or topic — this is semantic " +
+        "search, so a full question beats keywords. Search for the CONCEPT, not the words " +
+        "the user used: 'database migration decisions' will find a memory written as 'we " +
+        "settled on Atlas for schema changes'.",
+    query_kind: "Which context family to search: 'memory' for stored user memories, " +
+        "'knowledge' for ingested documents and sources, or 'all' for both " +
+        "(default: 'all'). Leave unset unless you specifically want to exclude one family.",
+    max_results: "Maximum CHUNKS to return (1-50, default: 10). Chunks, not whole memories or " +
+        "documents — several chunks often come from one source. Raise to 20-30 for broad " +
+        "coverage of a topic; drop to 3-5 when you want one specific fact and a small " +
+        "response.",
+    mode: "'thinking' (default) runs graph traversal and personalised reranking: a few " +
+        "seconds, best recall — use it when the answer matters or the question is about " +
+        "the user. 'fast' is plain semantic search and is markedly quicker — use it for a " +
+        "lookup you expect to hit, or when issuing several queries in a row. 'auto' lets " +
+        "Hydra DB pick based on the query.",
+    query_source_ids: "Restrict the search to these source IDs, taken from hydradb_query or " +
+        "hydradb_list. Turns a search into 'search inside these documents'. This is a " +
+        "hard filter: if none of them match, the result is empty rather than widened.",
+    metadata_filters: "Exact-match filters over stored metadata, as {key: value}. Exact match only — " +
+        "no ranges, no partial matches, no dates-since. Only useful for keys you know " +
+        "exist, typically because you set them when ingesting.",
+    num_related_chunks: "Adjacent chunks to attach to each match for surrounding context (default: 0). " +
+        "Each one multiplies the response size, so use 1-2 only when snippets are " +
+        "arriving mid-sentence; prefer hydradb_inspect when you want a whole source.",
+    operator: "How to combine the terms in your query: 'or' (default) matches any, 'and' " +
+        "requires all, 'phrase' matches the words together in order. Reach for 'phrase' " +
+        "when looking up an exact string such as an error message or a config key.",
+    expiry_seconds: "How long the download link stays valid, in seconds. Only meaningful with " +
+        "mode 'url' or 'both'; ignored otherwise.",
+    graph_context: "Include knowledge-graph relations (default: true). These are the entity paths — " +
+        "(Alice)-[prefers]->(Tea) — that connect facts across separate memories, and they " +
+        "often carry the answer the matching text alone does not. Set false only when you " +
+        "want the raw matching text and nothing else.",
+    text: "The information to store. Provide EXACTLY ONE of `text` or `turns` — passing " +
+        "both is an error, and so is passing neither. Write it standalone: it must still " +
+        "make sense months from now with no surrounding conversation, so resolve pronouns " +
+        "and relative dates ('in March 2026', not 'last week').",
+    ingest_kind: "What to write: 'memory' for a personal fact, preference or conversation " +
+        "(default), or 'knowledge' to store a document as a searchable source. " +
+        "Memory-only options (turns, source_id, infer, is_markdown, user_name) do not " +
+        "apply to knowledge and are rejected rather than ignored.",
+    title: "A short, specific label — always set it. This is the ONLY label shown next to " +
+        "this entry in later hydradb_query results, so 'Deployment rollback policy' is " +
+        "useful where a generic one tells you nothing. If omitted, a title is derived " +
+        "from the first line of the text, which is rarely as good as one you choose.",
+    source_id: "Optional identifier for this entry. Ingesting again with an existing source_id " +
+        "REPLACES everything previously stored under it — it does not add to it. Use a fresh " +
+        "id (or leave it unset) for each new fact, and reuse an id only when you deliberately " +
+        "mean to overwrite, such as correcting a memory you saved earlier. Leave unset if unsure.",
+    overwrite: "Whether ingesting with an existing source_id may replace what is stored there " +
+        "(default: true). Set false to have the server reject the write instead of " +
+        "overwriting, when you expect to be creating something new.",
+    metadata: "Key/value metadata to store with this entry, as {key: value}. These are the " +
+        "keys hydradb_query's metadata_filters can match on later, so set them when you " +
+        "expect to narrow by them — e.g. {\"project\": \"hydradb\", \"kind\": \"decision\"}.",
+    observation_date: "When the fact was true, as an RFC3339 date — distinct from when you stored it. " +
+        "Use it when saving something historical, so recency reflects the fact rather " +
+        "than the write.",
+    infer: "Let Hydra DB extract insights and knowledge-graph entities from this text " +
+        "(default: true). Keep it true for anything about the user or their work — that " +
+        "extraction is what makes the content findable by concept later. Set false only to " +
+        "store text verbatim with no interpretation (a config snippet, an exact error " +
+        "string, a code block).",
+    is_markdown: "Set true when `text` contains markdown (headings, lists, code fences) so Hydra DB " +
+        "chunks on structure instead of splitting mid-section. Default false.",
     turns: "Array of conversation turns, each with a 'user' and 'assistant' field",
-    user_name: "Optional name of the user for personalisation (default: 'User')",
-    kind: "Which context family to list: 'memory' or 'knowledge' (default: 'memory')",
+    user_name: "What to call the user in the stored conversation (default: 'User'). Set it when " +
+        "you know their actual name, so extracted facts read as being about a person " +
+        "rather than about an anonymous participant. Applies to `turns` only.",
+    kind: "Which family to list: 'memory' (stored memories) or 'knowledge' (ingested " +
+        "sources). REQUIRED — these are separate corpora with different output, and no " +
+        "single listing covers both. Call this twice to see everything.",
     source_ids: "Optional array of specific source IDs to filter by. If omitted, lists all sources.",
+    page: "Which page of results to return, 1-indexed (default: 1). The response reports how " +
+        "many of the total it showed; pass the next page to continue rather than assuming " +
+        "the first page is everything.",
+    page_size: "How many items to return per page (1-100). Defaults to the server's page size. " +
+        "Raise it to see more at once; lower it to keep the response small.",
+    detail: "How much of each matching chunk to return. 'compact' (default) trims each " +
+        "chunk to its first ~600 characters and omits the surrounding-context blocks — " +
+        "enough to judge relevance and pick a source to inspect. 'full' returns every " +
+        "chunk whole; use it when the snippets are being cut off mid-answer. Either way " +
+        "the response is capped, and hydradb_inspect returns any single source in full.",
     fetch_source_id: "The source ID to fetch content for",
-    fetch_mode: "Fetch mode: 'content' for text, 'url' for presigned URL, 'both' for both (default: 'content')",
-    delete_id: "The ID of the item to delete",
+    fetch_mode: "'content' (default) returns the text — normally what you want. 'url' returns a " +
+        "short-lived presigned download link INSTEAD of the text, for binary sources or " +
+        "when handing the user a download. 'both' returns text and link.",
+    fetch_offset: "Character offset to start reading from (default: 0). Long sources are returned " +
+        "in slices; the response says where it stopped and what offset to pass next.",
+    fetch_limit: "Maximum characters of text to return (default and maximum: 20000). Lower it when " +
+        "you only need the beginning of a long document.",
+    delete_id: "A single ID to delete. Prefer `ids` when removing more than one.",
+    delete_ids: "The IDs to delete. Accepts several at once — cleaning up N stale entries is " +
+        "one call, not N. Each is reported separately, and the response says how many " +
+        "were actually removed. This is irreversible.",
     delete_kind: "Which context family the ID belongs to: 'memory' or 'knowledge' (default: 'memory')",
     memory_id: "The ID of the memory to delete",
 };
 function deprecated(alias, body) {
     return `DEPRECATED — use \`${ALIAS_REPLACEMENTS[alias]}\` instead. ${body}`;
 }
-const SEARCH_BODY = "Search through Hydra DB State-of-the-art agentic memories. Returns relevant chunks with " +
-    "graph-enriched context including entity paths and knowledge graph relations. " +
-    "Use this to find previously stored information, past conversations, user preferences, " +
-    "or any knowledge that has been ingested into Hydra DB memory. " +
-    "Supports both fast semantic search and deeper thinking mode with graph traversal.";
-const STORE_BODY = "Save important information to Hydra DB State-of-the-art agentic memory. Use this to persist " +
-    "facts, preferences, decisions, notes, or any text the user wants remembered across " +
-    "sessions. Hydra DB automatically extracts insights, preferences, and builds a knowledge " +
-    "graph from the stored content. Supports plain text and markdown.";
+const SEARCH_BODY = `Search Hydra DB for anything the user has stored: memories (facts, preferences, decisions, past conversations) and ingested knowledge sources (documents, files, playbooks). Returns matching chunks with their source id, a relevance score, and knowledge-graph context — the entity paths and relations that connect facts across separate sources.
+
+CALL THIS BEFORE ANSWERING whenever the answer could depend on the user's history, preferences, prior decisions, project details, or a document they have ingested — including when you are merely unsure. A query that returns nothing costs one call; answering from a blank slate costs the user a correction.
+
+Searches both families by default. Every result carries \`[id: …]\` — pass it to hydradb_inspect for the full source, or to hydradb_delete to remove it.
+
+Examples:
+  {"query": "how does the user prefer code review feedback"}
+  {"query": "postgres connection pooling decision", "kind": "knowledge"}
+  {"query": "deploy checklist", "mode": "fast", "max_results": 5}`;
+const STORE_BODY = `Save information to Hydra DB so it outlives this session. Hydra DB extracts insights, preferences and knowledge-graph entities from what you store.
+
+Provide EXACTLY ONE of:
+  \`text\`  — a note, fact, decision, or document body
+  \`turns\` — user/assistant pairs from a conversation
+Passing both is an error; passing neither is an error.
+
+Save proactively: when the user states a preference, makes a decision, corrects you, or reveals a durable fact about themselves or their work, store it without being asked. Store the distilled fact rather than the raw exchange, and always set \`title\` — it is the only label shown next to this entry in later search results. Before saving something you suspect is already stored, query for it first rather than adding a near-duplicate.
+
+Never store secrets, credentials, or anything the user asked you not to keep.
+
+Examples:
+  {"text": "Prefers tabs over spaces in every language; rejected two prettier configs that used spaces.", "title": "Indentation preference"}
+  {"turns": [{"user": "let's go with Postgres", "assistant": "Agreed, I'll set up the schema."}], "title": "Datastore decision"}
+  {"text": "# Runbook\\n\\nRestart order: api, worker, scheduler.", "kind": "knowledge", "title": "Restart runbook"}`;
 const CONVERSATION_BODY = "Ingest one or more user-assistant conversation turns into Hydra DB memory. " +
     "Hydra DB will extract insights, preferences, and knowledge graph entities from the " +
     "conversation. Use this to store conversation history so it can be recalled later. " +
@@ -51,9 +146,11 @@ const LIST_MEMORIES_BODY = "List all stored user memories in Hydra DB. Returns m
 const LIST_SOURCES_BODY = "List all ingested sources in Hydra DB memory. Returns source IDs, titles, types, " +
     "and metadata. Use this to see what data sources have been ingested and to find " +
     "source IDs for fetching content.";
-const INSPECT_BODY = "Fetch the full content of a specific source by its source ID from Hydra DB. " +
-    "Returns the original text content that was ingested. Use this to retrieve " +
-    "the complete content of a previously stored source.";
+const INSPECT_BODY = `Fetch the full original content of ONE stored item by its id. Use it after hydradb_query or hydradb_list when a truncated chunk or listing row is not enough and you need the whole document.
+
+The id is the value shown as \`[id: …]\` in hydradb_query results and in [brackets] in hydradb_list output. Ids are not guessable — take one from those tools rather than constructing it.
+
+Long sources come back in slices; the response says where it stopped and what offset continues it. Binary sources are never inlined — you get their type and size, and \`mode: "url"\` returns a download link.`;
 export const TOOL_DESCRIPTIONS = {
     // --- Canonical tools (CONTRACT §3) ---
     [TOOL_NAMES.QUERY]: {
@@ -61,33 +158,55 @@ export const TOOL_DESCRIPTIONS = {
         description: SEARCH_BODY,
         params: {
             query: PARAM.query,
+            kind: PARAM.query_kind,
             max_results: PARAM.max_results,
             mode: PARAM.mode,
             graph_context: PARAM.graph_context,
+            detail: PARAM.detail,
+            operator: PARAM.operator,
+            source_ids: PARAM.query_source_ids,
+            metadata_filters: PARAM.metadata_filters,
+            num_related_chunks: PARAM.num_related_chunks,
         },
     },
     [TOOL_NAMES.INGEST]: {
         title: "Ingest into Hydra DB",
-        description: STORE_BODY +
-            " To ingest a conversation instead of a single note, provide `turns` " +
-            "(user/assistant pairs) rather than `text`.",
+        // STORE_BODY already states the text/turns rule as "exactly one of". The
+        // sentence that used to be appended here said "provide `turns` … rather
+        // than `text`", which reads as a preference between two allowed options
+        // and contradicts it.
+        description: STORE_BODY,
         params: {
             text: PARAM.text,
+            kind: PARAM.ingest_kind,
             title: PARAM.title,
             source_id: PARAM.source_id,
             infer: PARAM.infer,
             is_markdown: PARAM.is_markdown,
-            turns: "Optional conversation turns to ingest instead of `text`; each has a 'user' and 'assistant' field",
+            overwrite: PARAM.overwrite,
+            metadata: PARAM.metadata,
+            observation_date: PARAM.observation_date,
+            turns: "The conversation to ingest, oldest first, as [{user, assistant}, ...]. Provide " +
+                "EXACTLY ONE of `text` or `turns` — passing both is an error, and so is passing " +
+                "neither. Use this when the exchange itself is worth preserving; when only the " +
+                "conclusion matters, prefer `text` with the distilled fact.",
             user_name: PARAM.user_name,
         },
     },
     [TOOL_NAMES.LIST]: {
         title: "List Hydra DB Context",
-        description: "List stored memories or ingested knowledge sources in Hydra DB. " +
-            "Use `kind` to choose which family to browse.",
+        description: `Enumerate what is stored in Hydra DB — every memory (kind: "memory") or every knowledge source (kind: "knowledge"). These are SEPARATE corpora and this tool returns one at a time: listing memories tells you nothing about which knowledge sources exist, and vice versa. Call it twice to see everything.
+
+Use it for inventory questions ("what do you remember about me?", "which documents are indexed?") and to obtain ids. For "what do you know about X", use hydradb_query instead — listing everything and reading it is far more expensive and loses relevance ranking.
+
+Results are paginated. The response says how many of the total it showed and how to reach the rest; do not treat the first page as the whole store.
+
+Memory rows come back as [id] content. Knowledge rows as [id] — title (type), with no content — pass an id to hydradb_inspect for the text.`,
         params: {
             kind: PARAM.kind,
             source_ids: PARAM.source_ids,
+            page: PARAM.page,
+            page_size: PARAM.page_size,
         },
     },
     [TOOL_NAMES.INSPECT]: {
@@ -96,23 +215,43 @@ export const TOOL_DESCRIPTIONS = {
         params: {
             source_id: PARAM.fetch_source_id,
             mode: PARAM.fetch_mode,
+            offset: PARAM.fetch_offset,
+            limit: PARAM.fetch_limit,
+            expiry_seconds: PARAM.expiry_seconds,
         },
     },
     [TOOL_NAMES.DELETE]: {
         title: "Delete from Hydra DB",
-        description: "Delete a memory or knowledge source from Hydra DB by its ID. " +
-            "Use `kind` to select which family the ID belongs to. This action is irreversible.",
+        description: `Permanently remove one memory or one knowledge source from Hydra DB by id. This cannot be undone; there is no trash.
+
+Take the id from hydradb_query or hydradb_list — never guess one. Confirm with the user before deleting anything they did not name: "forget that I use vim" authorises deleting that memory; "clean up my memories" authorises nothing until they have seen the list.
+
+\`kind\` must match the family the id belongs to. A knowledge source id passed with kind "memory" reports that nothing was deleted while the source is still there.`,
         params: {
+            ids: PARAM.delete_ids,
             id: PARAM.delete_id,
             kind: PARAM.delete_kind,
         },
     },
+    [TOOL_NAMES.STATUS]: {
+        title: "Check Hydra DB Indexing Status",
+        description: "Check whether ingested sources have finished indexing. Ingestion is " +
+            "asynchronous: hydradb_ingest returns as soon as the source is queued, and " +
+            "the content is not searchable until indexing reaches a terminal state. " +
+            "Use this after ingesting when you need to confirm the write landed — " +
+            "an empty hydradb_query result shortly after an ingest usually means " +
+            "'still indexing', not 'the save failed'.",
+        params: {
+            ids: "The source IDs to check, as returned by hydradb_ingest.",
+        },
+    },
     // --- Deprecated aliases ---
     [TOOL_NAMES.SEARCH]: {
         title: "Search Hydra DB Memory (deprecated)",
         description: deprecated(TOOL_NAMES.SEARCH, SEARCH_BODY),
         params: {
             query: PARAM.query,
+            kind: PARAM.query_kind,
             max_results: PARAM.max_results,
             mode: PARAM.mode,
             graph_context: PARAM.graph_context,
@@ -125,8 +264,15 @@ export const TOOL_DESCRIPTIONS = {
             text: PARAM.text,
             title: PARAM.title,
             source_id: PARAM.source_id,
+            metadata: "Key/value metadata to store with this entry, as {key: value}. These are the " +
+                "keys hydradb_query's metadata_filters can match on later, so set them when you " +
+                "expect to narrow by them — e.g. {\"project\": \"hydradb\", \"kind\": \"decision\"}.",
+            observation_date: "When the fact was true, as an RFC3339 date — distinct from when you stored it. " +
+                "Use it when saving something historical, so recency reflects the fact rather " +
+                "than the write.",
             infer: PARAM.infer,
             is_markdown: PARAM.is_markdown,
+            overwrite: PARAM.overwrite,
         },
     },
     [TOOL_NAMES.INGEST_CONVERSATION]: {
@@ -155,6 +301,8 @@ export const TOOL_DESCRIPTIONS = {
         params: {
             source_id: PARAM.fetch_source_id,
             mode: PARAM.fetch_mode,
+            offset: PARAM.fetch_offset,
+            limit: PARAM.fetch_limit,
         },
     },
     [TOOL_NAMES.DELETE_MEMORY]: {
@@ -165,19 +313,25 @@ export const TOOL_DESCRIPTIONS = {
         },
     },
 };
-export const SERVER_INSTRUCTIONS = "Hydra DB MCP server for State-of-the-art agentic memory management. " +
-    `Use ${TOOL_NAMES.QUERY} to find relevant memories and knowledge graph context. ` +
-    `Use ${TOOL_NAMES.INGEST} to save information (a note via 'text', or a conversation via 'turns'). ` +
-    `Use ${TOOL_NAMES.LIST} to browse stored memories or knowledge sources. ` +
-    `Use ${TOOL_NAMES.INSPECT} to retrieve the full content of a source. ` +
-    `Use ${TOOL_NAMES.DELETE} to remove a memory or knowledge source. ` +
-    "Deprecated aliases remain available for backward compatibility but should not be used in new integrations: " +
-    `${TOOL_NAMES.SEARCH} → ${TOOL_NAMES.QUERY}, ` +
-    `${TOOL_NAMES.STORE} → ${TOOL_NAMES.INGEST}, ` +
-    `${TOOL_NAMES.INGEST_CONVERSATION} → ${TOOL_NAMES.INGEST}, ` +
-    `${TOOL_NAMES.LIST_MEMORIES} → ${TOOL_NAMES.LIST}, ` +
-    `${TOOL_NAMES.LIST_SOURCES} → ${TOOL_NAMES.LIST}, ` +
-    `${TOOL_NAMES.FETCH_CONTENT} → ${TOOL_NAMES.INSPECT}, ` +
-    `${TOOL_NAMES.DELETE_MEMORY} → ${TOOL_NAMES.DELETE}. ` +
-    "All tools require a valid Hydra DB API key and tenant ID configured via environment variables.";
+export const SERVER_INSTRUCTIONS = `Hydra DB is the user's persistent memory across sessions. It holds two separate families: memory (facts, preferences, decisions, past conversations) and knowledge (ingested documents and sources). ${TOOL_NAMES.QUERY} searches both together.
+
+WHEN TO USE IT
+
+- Before answering anything that could depend on the user's history, preferences, prior decisions, project details, or a document they have ingested, call ${TOOL_NAMES.QUERY} FIRST — including when you are merely unsure. One query at the start of a task is cheap; answering from a blank slate costs the user a correction. Never ask the user to repeat something Hydra DB may already hold.
+- After the user states a preference, makes a decision, corrects you, or reveals a durable fact about themselves or their work, call ${TOOL_NAMES.INGEST} to save it without being asked. Save the distilled fact, not the transcript: "prefers pnpm over npm in every repo", not "user said maybe we should try pnpm".
+- Never store secrets, credentials, one-off task chatter, or anything the user asked you not to keep.
+- "Remember this" maps to ${TOOL_NAMES.INGEST}, "forget that" to ${TOOL_NAMES.DELETE}, and "what do you know about me" to ${TOOL_NAMES.QUERY} — do not answer that last one from the current conversation alone.
+
+THE TOOLS
+
+- ${TOOL_NAMES.QUERY} — semantic search across memory and knowledge, with knowledge-graph context. Your default read. Every result carries an id.
+- ${TOOL_NAMES.INGEST} — write. A note or document via 'text', or a conversation via 'turns' (exactly one of the two).
+- ${TOOL_NAMES.LIST} — the full inventory of ONE family. Use it for "what do you have?"; for "what do you know about X" use ${TOOL_NAMES.QUERY} instead.
+- ${TOOL_NAMES.INSPECT} — the complete original content of one source you already have an id for.
+- ${TOOL_NAMES.DELETE} — irreversible removal of one item by id.
+- ${TOOL_NAMES.STATUS} — whether an ingested source has finished indexing. Ingestion is asynchronous, so a query issued straight after a save can legitimately return nothing.
+
+Ids flow between these: ${TOOL_NAMES.QUERY} and ${TOOL_NAMES.LIST} emit them, ${TOOL_NAMES.INSPECT}, ${TOOL_NAMES.DELETE} and ${TOOL_NAMES.STATUS} accept them. Never invent one.
+
+All tools require HYDRADB_API_KEY and HYDRADB_DATABASE in the environment.`;
 //# sourceMappingURL=descriptions.js.map

package/dist/descriptions.js.map

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