keywordgraph-mcp-server 1.8.4 → 1.9.0

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6DxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6D9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoE5B,CAAC;AAwCH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqD1B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDhC,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCzC,CAAC;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMtC,CAAC;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDzC,CAAC;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAiC,CAAC;AAEzE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAiBrC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC1B,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;EAO1C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;EAyBxC,CAAC;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMrC,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B3C,CAAC;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQvC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqGtC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiElC,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsC5C,CAAC;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQxC,CAAC;AAEH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkE9C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8E1C,CAAC;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoD1C,CAAC;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAgCtC,CAAC;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAA8B,CAAC;AAEnE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoD1C,CAAC;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,CAAC;AAEH,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDlD,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EA8BpC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwD/C,CAAC;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ3C,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDrC,CAAC;AAmDH,QAAA,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC3C,CAAC;AAEH,OAAO,EAAE,uCAAuC,EAAE,CAAC;AACnD,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EACR,CAAC;AAEzC,QAAA,MAAM,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC9C,CAAC;AAEH,OAAO,EAAE,0CAA0C,EAAE,CAAC;AACtD,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EACR,CAAC;AAE5C,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6FjD,CAAC;AAEH,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkGlD,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmGjD,CAAC;AAEH,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;EAqFpD,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsGjC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DpC,CAAC;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;EAsC3B,CAAC;AAaH,eAAO,MAAM,4BAA4B;;;;;;;;;EAGvC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAQ7B,CAAC;AAIH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAiCnC,CAAC;AAEJ,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EAkCpC,CAAC;AAMH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgEvC,CAAC;AAMH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DtC,CAAC;AASH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDjC,CAAC;AAMH,eAAO,MAAM,iBAAiB;;;;;;;;;EAa5B,CAAC;AAMH,wDAAwD;AACxD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAkCpC,CAAC;AAMH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwGjC,CAAC"}

package/dist/schemas/index.js

@@ -1,11 +1,20 @@
 import { z } from "zod";
 import { brand } from "../config/brand.js";
-import { WikilinksModeEnum, wikilinksModeDescription, } from "../utils/wikilinksMode.js";
+import { WikilinksModeEnum, categoriesAsNodesDescription, wikilinksModeDescription, } from "../utils/wikilinksMode.js";
 /**
  * Optional alternative to `text` / `url`, shared by every tool that builds a
  * graph from content: discrete statements with optional per-statement
  * metadata. Reused across schemas — zod field instances are immutable.
  */
+/**
+ * Opt-in multifractal spectrum inside `fractal_variability`. Shared by the
+ * graph-generation tools whose endpoints (/graphAndStatements,
+ * /graphsAndStatements) honor the flag.
+ */
+const multifractalField = z
+    .boolean()
+    .default(false)
+    .describe("Compute the multifractal spectrum (q, h(q), width, label) inside the fractal_variability statistics. Off by default: it adds ~0.5 s per graph. Only meaningful when the graph statistics are returned (includeGraph, fullGraph, addNodesAndEdges, or extractEntitiesOnly); without them the basic fractal_variability block is returned with multifractal: null.");
 const statementsField = z
     .array(z.string().min(1))
     .min(1)
@@ -14,11 +23,18 @@ const statementsField = z
 const categoriesField = z
     .array(z.array(z.string()))
     .optional()
-    .describe("Per-statement metadata labels, one entry per statement (empty array for none, length must match `statements`). Each label becomes a [[label]] node linked to that statement's concepts only, so author / source / tag / section can be filtered and grouped in the graph. Requires `statements`; omit when there is no metadata.");
+    .describe("Per-statement metadata labels, one entry per statement (empty array for none, length must match `statements`). Each label is stored on its statement as metadata, so author / source / tag / section can be filtered and grouped in the app and targeted by delete_statements / update_statements; labels become [[label]] nodes only when `categoriesAsNodes` is true. Requires `statements`; omit when there is no metadata.");
+/** Companion of `categories`: off by default so the labels stay metadata;
+ * on only when the connections between pages/files (the labels) are the
+ * point, as in large knowledge bases and Obsidian vaults. */
+const categoriesAsNodesField = z
+    .boolean()
+    .default(false)
+    .describe(categoriesAsNodesDescription);
 /** Saved graphs freeze their processing settings at creation (lib/context.js
  * applies contextSettings only when the context does not already exist), so
  * categories on a later upload to the same graph produce no label nodes. */
-const SAVED_GRAPH_CATEGORIES_NOTE = "Per-statement metadata labels, one entry per statement (empty array for none, length must match `statements`). Each label becomes a [[label]] node linked to that statement's concepts only, so author / source / tag / section can be filtered and grouped in the graph. Takes effect only when the graph is FIRST created — uploads to an existing graphName keep its original settings and the labels are ignored. Requires `statements`; omit when there is no metadata.";
+const SAVED_GRAPH_CATEGORIES_NOTE = "Per-statement metadata labels, one entry per statement (empty array for none, length must match `statements`). Each label is stored on its statement as metadata, so author / source / tag / section can be filtered and grouped in the app and targeted by delete_statements / update_statements; labels become [[label]] nodes only when `categoriesAsNodes` is true. Takes effect only when the graph is FIRST created — uploads to an existing graphName keep its original settings and the labels are ignored. Requires `statements`; omit when there is no metadata.";
 const timestampsField = z
     .array(z.string())
     .optional()
@@ -35,11 +51,13 @@ export const GenerateGraphSchema = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide either this or text, not both."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     includeStatements: z
         .boolean()
         .default(false)
         .describe("Include processed statements in response (true only if explicitly needed or requested)"),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(true)
@@ -81,11 +99,13 @@ export const CreateGraphSchema = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide either this or text, not both."),
     statements: statementsField,
     categories: categoriesField.describe(`${SAVED_GRAPH_CATEGORIES_NOTE}`),
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     includeStatements: z
         .boolean()
         .default(false)
         .describe("Include processed statements in response (add only if explicitly needed)"),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(false)
@@ -112,23 +132,59 @@ export const CreateGraphSchema = z.object({
     wikilinksMode: WikilinksModeEnum.default("default").describe(wikilinksModeDescription +
         " For saved graphs this applies only when the graph is FIRST created; uploads to an existing graphName keep its original setting."),
 });
+// Memory scopes (see docs/drafts/infranodus-memory-system.md): `topic` is an
+// outside subject, client or case (graph memory-<topic>), `personal` the
+// user's own preferences and setup (personal-<user>). Both need
+// enable_memory once and write through a dry run, like project learnings.
+// Processing language for the memory and learnings graphs. Passed on to the
+// app, which validates it against its supported list.
+const memoryHopsField = z
+    .number()
+    .int()
+    .min(1)
+    .max(3)
+    .optional()
+    .describe("How far to follow the graph's links. With `prompt`: default 2, so statements connected to the task's concepts through one intermediate concept come too (similarity 1 = direct, 0.5 = through a hop). With an entity: 2 or 3 returns what the entity is connected to, by hop distance (`connected`: node, hop, via), with the statements on those links; omitted, every statement that mentions it.");
+const memoryLanguageField = z
+    .string()
+    .optional()
+    .describe("Processing language (e.g. 'EN', 'DE', 'FR', 'AUTO'). Only when the content is not in the account's default language.");
+const memoryScopeField = z
+    .enum(["topic", "personal"])
+    .optional()
+    .describe("Which kept memory to use instead of a free graphName: 'topic' (facts about an outside subject, client or case; needs `topic`) or 'personal' (the user's own preferences and setup). The graph is named for you (memory-<topic> / personal-<user>) and must have been enabled with enable_memory.");
+const memoryTopicField = z
+    .string()
+    .min(1)
+    .optional()
+    .describe("Topic name when scope is 'topic' (e.g. the client, case or subject). Use the same name every time for the same topic.");
 export const AddMemorySchema = z.object({
+    scope: memoryScopeField,
+    topic: memoryTopicField,
+    language: memoryLanguageField,
+    confirm: z
+        .boolean()
+        .default(false)
+        .describe("Only with `scope`: false (default) = dry run that returns what would be written; show it to the user and ask. true = write. Ignored with graphName, which writes immediately."),
     graphName: z
         .string()
-        .min(1, "Graph name is required")
+        .min(1, "Graph name must be non-empty when provided")
         .max(28, "Graph name must be less than 28 characters")
-        .describe(`Name of the graph to add the memory to in ${brand.name} - lowercase, dashes for spaces, no special characters. Auto-generate from the context of the conversation (if previously available) or use the nanme of the LLM client or project, or use the name the user explicitly provided or requested.`),
+        .optional()
+        .describe(`Without \`scope\`: name of the graph to add the memory to in ${brand.name} - lowercase, dashes for spaces, no special characters. Auto-generate from the context of the conversation (if previously available) or use the name of the LLM client or project, or use the name the user explicitly provided or requested.`),
     text: z
         .string()
         .optional()
         .describe("Text that you'd like to analyze. Use new lines to separate separate statements, relations, and paragraphs in each text (but not the sentences). Detect the entities in every statement and use [[wikilinks]] syntax to mark them, unless the user explicitly requests automatic entity detection. Every statement should have at least two entities marked. Provide either this or statements."),
     statements: statementsField,
     categories: categoriesField.describe(SAVED_GRAPH_CATEGORIES_NOTE),
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     includeStatements: z
         .boolean()
         .default(false)
         .describe("Include processed statements in response (add only if needed for further analysis)"),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(false)
@@ -154,11 +210,13 @@ export const AnalyzeTextSchemaBase = z.object({
         .describe("URL to fetch content from (e.g. webpage or YouTube video transcript). Provide either this or text."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     includeStatements: z
         .boolean()
         .default(false)
         .describe("Include processed statements in response (add only if explicitly needed or if user requested the text of the URL / YouTube transcript)"),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(false)
@@ -184,6 +242,39 @@ export const AnalyzeTextSchemaBase = z.object({
 export const AnalyzeTextSchema = AnalyzeTextSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
     (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, or statements for analysis." });
+export const AnalyzeTextSignatureSchemaBase = z.object({
+    text: z
+        .string()
+        .optional()
+        .describe("Text whose signature to measure. Use new lines to separate paragraphs (not sentences). Provide one of: this, url, or statements. Under ~30 sentences the rhythm measures are noisy."),
+    url: z
+        .string()
+        .url()
+        .optional()
+        .describe("URL to fetch content from (webpage or YouTube video transcript). Provide either this or text."),
+    statements: statementsField,
+    categories: categoriesField,
+    timestamps: timestampsField,
+    multifractal: z
+        .boolean()
+        .default(true)
+        .describe("Compute the multifractal spectrum of the topic path (adds ~0.5-1 s). On by default here because it feeds the pacing reading and the AI-likeness estimate; set false for speed."),
+    maxNodes: z
+        .number()
+        .int()
+        .positive()
+        .max(1000)
+        .optional()
+        .describe("Maximum number of concepts kept in the graph (default 150). Words cut by the cap are dropped from the word path; raise it (e.g. 500) for long texts so the path is complete."),
+    modifyAnalyzedText: z
+        .enum(["none", "detectEntities", "extractEntitiesOnly"])
+        .default("none")
+        .describe("Entity detection: none (normal, recommended for signatures), detectEntities (mix entities and words), extractEntitiesOnly (entities only)."),
+    wikilinksMode: WikilinksModeEnum.default("default").describe(wikilinksModeDescription),
+});
+export const AnalyzeTextSignatureSchema = AnalyzeTextSignatureSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
+    (data.url !== undefined && data.url.length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, or statements for analysis." });
 export const AnalyzeExistingGraphSchemaBase = z.object({
     graphName: z
         .string()
@@ -197,6 +288,7 @@ export const AnalyzeExistingGraphSchemaBase = z.object({
         .boolean()
         .default(false)
         .describe("Include processed statements in response (add only if explicitly needed)"),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(false)
@@ -234,6 +326,21 @@ export const SearchExistingGraphsSchema = z.object({
         .describe(`Types of the existing ${brand.name} graphs to search in (array of strings, empty for all)`),
 });
 export const getMemorySchema = z.object({
+    scope: memoryScopeField,
+    topic: memoryTopicField,
+    language: memoryLanguageField,
+    hops: memoryHopsField.describe("Only with `scope`. How far to follow the graph's links. With `prompt`: default 2 (statements connected through one intermediate concept come too). With entityName: 2 or 3 returns what it is connected to, by hop distance (`connected`: node, hop, via), with the statements on those links; omitted, every statement that mentions it."),
+    prompt: z
+        .string()
+        .optional()
+        .describe("Only with `scope`: the task or question at hand; returns the most relevant statements (GraphRAG) plus an overview."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(15)
+        .describe("Only with `scope`: maximum number of statements to return."),
     entityName: z
         .string()
         .default("")
@@ -261,6 +368,7 @@ export const GenerateContentGapsSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     graphName: z
         .string()
@@ -283,6 +391,7 @@ export const generateContextualHintSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     graphName: z
         .string()
@@ -349,6 +458,7 @@ export const GenerateOntologyGraphSchema = z.object({
         .boolean()
         .default(true)
         .describe(`Whether to save the generated ontology as a persistent ${brand.name} graph (true by default). When true, the graph is stored under your account and a link is returned. Set to false if the user explicitly asks not to save, or when you only need a one-off AI ontology overview of a topic for the current context that won't be reused later — in that case the generated ontology statements are returned directly without being persisted.`),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(false)
@@ -409,6 +519,7 @@ export const AnalyzeLlmResultsSchema = z.object({
         .boolean()
         .default(false)
         .describe(`Whether to save the LLM overview as a persistent ${brand.name} graph (true by default). Set to false if the user asks not to save, or when you only need a one-off look at how the LLM frames the topic for the current conversation.`),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(false)
@@ -434,6 +545,7 @@ export const GenerateTopicalClustersSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     graphName: z
         .string()
@@ -466,6 +578,7 @@ export const GenerateResearchQuestionsSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     graphName: z
         .string()
@@ -524,6 +637,7 @@ export const GenerateResearchIdeasSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     graphName: z
         .string()
@@ -590,6 +704,7 @@ export const OptimizeTextStructureSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     graphName: z
         .string()
@@ -631,6 +746,7 @@ export const OptimizeReasoningSchemaBase = z.object({
         .describe("The current reasoning trace or chat conversation to analyze structurally. Paste the model's own chain-of-thought / reasoning output, the running dialogue with the user, or both concatenated. Use new lines to separate distinct reasoning steps, turns, or paragraphs (but not individual sentences). Provide either this or statements."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     modelToUse: z
         .enum([
@@ -665,6 +781,7 @@ export const DevelopLatentConceptsSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     graphName: z
         .string()
@@ -728,6 +845,47 @@ export const RetrieveContextForPromptFromGraphSchema = z.object({
         .boolean()
         .default(false)
         .describe("Include graph in the response to provide underlying knowledge graph structure"),
+    hops: z
+        .number()
+        .int()
+        .min(1)
+        .max(3)
+        .default(1)
+        .describe("How far from the prompt's concepts to retrieve. 1 = statements sharing a concept with the prompt; 2 = also statements connected through one intermediate concept (similarityScore 1 = direct, 1/hops = through a hop). Use 2 for a question about one concept and what it relates to."),
+    topK: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(8)
+        .describe("How many of the strongest matching relations (edges) to read statements from"),
+});
+export const GetNodeNeighborhoodSchema = z.object({
+    graphName: z
+        .string()
+        .min(1, "Graph name is required")
+        .describe(`Name of the existing ${brand.name} graph in your account`),
+    node: z
+        .union([z.string().min(1), z.array(z.string().min(1)).min(1).max(5)])
+        .describe("The concept to look up, with or without [[ ]] (case, spaces and hyphens don't matter). Several spellings of one concept can be passed together, e.g. [\"gpu\", \"gpus\"]."),
+    hops: z
+        .number()
+        .int()
+        .min(1)
+        .max(3)
+        .default(2)
+        .describe("How many steps away to go: 1 = the concepts it is directly linked to; 2 = also the concepts linked to those; 3 = one step further."),
+    maxNeighbors: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(30)
+        .describe("Maximum number of connected concepts to return, nearest and strongest first"),
+    includeStatements: z
+        .boolean()
+        .default(true)
+        .describe("Include the statements on those links (with their categories and hop distance)"),
 });
 export const GenerateResponsesFromGraphSchemaBase = z.object({
     graphName: z
@@ -750,6 +908,7 @@ export const GenerateResponsesFromGraphSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     prompt: z
         .string()
@@ -866,6 +1025,7 @@ const GenerateOverlapGraphFromTextsSchemaBase = z.object({
         .array(contextItemTextUrlOrGraphSchema)
         .min(2, "At least two contexts are required for overlap")
         .describe("Array of sources to analyze and find content overlaps for. Each item is an object with exactly one of: { text: string }, { statements: string[] } (optionally with categories / timestamps), { url: string }, or { graphName: string }. Example: [{ text: '...' }, { url: 'https://...' }, { graphName: 'my-graph' }]."),
+    categoriesAsNodes: categoriesAsNodesField,
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
@@ -874,6 +1034,7 @@ const GenerateOverlapGraphFromTextsSchemaBase = z.object({
         .boolean()
         .default(false)
         .describe("Include processed statements in response (add only if explicitly needed)"),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(false)
@@ -890,6 +1051,7 @@ const GenerateDifferenceGraphFromTextsSchemaBase = z.object({
         .array(contextItemTextUrlOrGraphSchema)
         .min(2, "At least two contexts (target + one reference) are required")
         .describe("Array where the FIRST item is the target to analyze for missing parts; REMAINING items are reference sources. Each item is an object with exactly one of: { text: string }, { statements: string[] } (optionally with categories / timestamps), { url: string }, or { graphName: string }. Example: [{ text: '...' }, { url: 'https://...' }, { graphName: 'my-graph' }]."),
+    categoriesAsNodes: categoriesAsNodesField,
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
@@ -898,6 +1060,7 @@ const GenerateDifferenceGraphFromTextsSchemaBase = z.object({
         .boolean()
         .default(false)
         .describe("Include processed statements in response (add only if explicitly needed)"),
+    multifractal: multifractalField,
     includeGraph: z
         .boolean()
         .default(false)
@@ -1239,6 +1402,7 @@ export const GenerateSEOGraphSchema = z.object({
         .describe("URL to fetch content from for SEO analysis. Provide either this or text, not both."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     contentToExtract: z
         .enum(["all", "header tags", "link tags"])
         .default("all")
@@ -1324,6 +1488,7 @@ export const DevelopTextToolSchemaBase = z.object({
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, statements, or graphName."),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     graphName: z
         .string()
@@ -1402,11 +1567,20 @@ const projectField = z
     .describe("Name of the project the learnings belong to — the repo or folder name, git remote basename, or whatever the user calls it. Use the same name every time for the same project (call get_project_learnings without a project to list the names already in use). Becomes the graph name learn-<slug>.");
 export const EnableProjectLearningsSchema = z.object({
     project: projectField,
+    language: memoryLanguageField,
+});
+export const EnableMemorySchema = z.object({
+    scope: z
+        .enum(["topic", "personal"])
+        .describe("'topic' for facts about an outside subject, client or case (needs `topic`); 'personal' for the user's own preferences and setup."),
+    topic: memoryTopicField,
+    language: memoryLanguageField,
 });
 // Length parity between `types` and `statements` is checked in the handler
 // (a .refine() would hide `.shape`, which tool registration needs).
 export const AddProjectLearningsSchema = z.object({
     project: projectField,
+    language: memoryLanguageField,
     statements: z
         .array(z.string().min(1))
         .min(1)
@@ -1431,6 +1605,8 @@ export const AddProjectLearningsSchema = z.object({
         .describe("false (default) = dry run: returns what would be written (new vs reinforced duplicates) and writes nothing — show it to the user and ask whether to save. true = write. Pass true directly only when the user has said they don't want to be asked each time."),
 });
 export const GetProjectLearningsSchema = z.object({
+    language: memoryLanguageField,
+    hops: memoryHopsField,
     project: z
         .string()
         .optional()
@@ -1517,6 +1693,7 @@ export const OptimizeKnowledgeBaseSchema = z.object({
         .describe(`Name of the saved ${brand.name} graph that represents the project: e.g. repo-<project>-digest or vault-<project>-digest (the LLM-written digest of how it works), repo-<project>-structure (the deterministic map of files, imports, exports), repo-<project>-docs, vault-<project>-links, or learn-<project>. Provide this or statements/text.`),
     statements: statementsField,
     categories: categoriesField,
+    categoriesAsNodes: categoriesAsNodesField,
     text: z
         .string()
         .optional()