keywordgraph-mcp-server 1.7.4 → 1.8.5

package/dist/schemas/index.js

@@ -1,6 +1,6 @@
 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
@@ -14,11 +14,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,6 +42,7 @@ 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()
@@ -81,6 +89,7 @@ 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()
@@ -124,6 +133,7 @@ export const AddMemorySchema = z.object({
         .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()
@@ -154,6 +164,7 @@ 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()
@@ -261,6 +272,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 +295,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()
@@ -301,16 +314,36 @@ export const generateContextualHintSchema = generateContextualHintSchemaBase.ref
 export const GenerateOntologyGraphSchema = z.object({
     prompt: z
         .string()
-        .min(1, "Provide a topic, prompt, or text to generate an ontology for")
-        .describe("The topic, prompt, or text to generate a reasoning ontology graph for. For example: 'build an ontology on AI attention mechanisms' or 'the main principles of Ray Dalio applied to investment'. The AI generates entities and the relations between them."),
+        .optional()
+        .describe("A topic or short prompt to generate a reasoning ontology for, e.g. 'build an ontology on AI attention mechanisms' or 'the main principles of Ray Dalio applied to investment'. Sent to the AI as-is in one call. Provide exactly one of: prompt, text, sourceGraphName."),
+    text: z
+        .string()
+        .optional()
+        .describe("A long text, document, or structure map of a project (file tree, imports, exports, docstring headlines) to EXTRACT an ontology from. Chunked server-side (see chunkSize); every chunk's ontology is appended to the same graph. Provide exactly one of: prompt, text, sourceGraphName."),
+    sourceGraphName: z
+        .string()
+        .optional()
+        .describe(`Name of an existing ${brand.name} graph whose statements are the source: they are read back, chunked, and an ontology is generated from each chunk into the graph named by graphName. Use it to condense a fully ingested repo, vault, or corpus graph (e.g. repo-<project>-docs or repo-<project>-structure) into an ontology, or — with ontologyMode 'procedural' — into a digest of how the project works. Provide exactly one of: prompt, text, sourceGraphName.`),
+    ontologyMode: z
+        .enum(["general", "codebase", "procedural"])
+        .default("general")
+        .describe("'general' (default): entities and relations of any domain. 'codebase': the source is a software project's structure map or code documentation — entities are modules/files, functions, classes, data stores, external services, configuration, and the domain concepts they implement; relations favour dependsOn / partOf / exposes / calls / stores / implements. 'procedural': instead of an ontology, write a DIGEST of how the project works — one prose statement per line with [[wikilinks]] on the modules, concepts, and files involved, each ending with its type in [brackets] — [principles], [rules], [procedures], [handoffs], [main_ideas], [gaps] — which is saved as the statement's category; save it as repo-<project>-digest or vault-<project>-digest and feed it to optimize_knowledge_base. Use it when the content already lives in a graph (docs, structure, notes) and nobody can or should re-read the files. Applies to text and sourceGraphName inputs."),
+    chunkSize: z
+        .number()
+        .int()
+        .min(2000)
+        .max(40000)
+        .default(12000)
+        .describe("Characters per chunk for text / sourceGraphName inputs (split on line boundaries). Smaller chunks give more detailed, more expensive ontologies. Default 12000."),
     graphName: z
         .string()
         .optional()
         .describe(`Name of the ${brand.name} graph to save the ontology to. Only used when saveGraph is true. If omitted, a name is auto-generated from the prompt. Note: saving to a name that already exists appends the new statements to that graph rather than replacing it.`),
     modelToUse: z
         .enum([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -320,9 +353,11 @@ export const GenerateOntologyGraphSchema = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
-        .default("claude-opus-4.6")
-        .describe("AI model used to generate the ontology. More capable models (claude-opus-4.6, gpt-5.4) produce richer, more accurate ontologies; the -mini and -lite variants are faster and cheaper. Default: claude-opus-4.6."),
+        .default("claude-opus-5")
+        .describe("AI model used to generate the ontology. More capable models (claude-opus-5, claude-fable-5, gpt-5.6-terra) produce richer, more accurate ontologies; the -mini and -lite variants are faster and cheaper. Default: claude-opus-5."),
     saveGraph: z
         .boolean()
         .default(true)
@@ -362,8 +397,9 @@ export const AnalyzeLlmResultsSchema = z.object({
         .describe(`Name of the ${brand.name} graph to save the LLM overview to. Only used when saveGraph is true. If omitted, a name is auto-generated from the prompt. Note: saving to a name that already exists appends the new statements to that graph rather than replacing it.`),
     modelToUse: z
         .enum([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -373,9 +409,11 @@ export const AnalyzeLlmResultsSchema = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
-        .default("claude-opus-4.6")
-        .describe("AI model whose view of the topic is being analyzed. Pick the model the user is curious about — different models surface different framings. Default: claude-opus-4.6."),
+        .default("claude-opus-5")
+        .describe("AI model whose view of the topic is being analyzed. Pick the model the user is curious about — different models surface different framings. Default: claude-opus-5."),
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
@@ -409,6 +447,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()
@@ -441,6 +480,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()
@@ -465,8 +505,9 @@ export const GenerateResearchQuestionsSchemaBase = z.object({
         .describe("Include graph summary string in the response to provide additional information about the text knowledge graph structure"),
     modelToUse: z
         .enum([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -476,9 +517,11 @@ export const GenerateResearchQuestionsSchemaBase = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
         .default("gpt-5.4")
-        .describe("AI model to use for generating research questions: claude-opus-4.6, claude-sonnet-4.6, gemini-2.5-flash, gemini-2.5-flash-lite, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini"),
+        .describe("AI model to use for generating research questions: claude-opus-5, claude-sonnet-5, claude-fable-5, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, grok-4.1-fast-non-reasoning, grok-4.1-fast-reasoning, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini, gpt-5.6-terra, gpt-5.6-sol"),
 });
 export const GenerateResearchQuestionsSchema = GenerateResearchQuestionsSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -496,6 +539,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()
@@ -528,8 +572,9 @@ export const GenerateResearchIdeasSchemaBase = z.object({
         .describe("Include graph summary string in the response to provide additional information about the text knowledge graph structure"),
     modelToUse: z
         .enum([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -539,9 +584,11 @@ export const GenerateResearchIdeasSchemaBase = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
         .default("gpt-5.4")
-        .describe("AI model to use for generating research questions: claude-opus-4.6, claude-sonnet-4.6, gemini-2.5-flash, gemini-2.5-flash-lite, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini"),
+        .describe("AI model to use for generating research questions: claude-opus-5, claude-sonnet-5, claude-fable-5, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, grok-4.1-fast-non-reasoning, grok-4.1-fast-reasoning, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini, gpt-5.6-terra, gpt-5.6-sol"),
 });
 export const GenerateResearchIdeasSchema = GenerateResearchIdeasSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -559,6 +606,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()
@@ -571,8 +619,9 @@ export const OptimizeTextStructureSchemaBase = z.object({
         .describe("Type of response to generate: 'response' — generates a response based on the gaps identified; 'idea' — generate a business idea that bridges the gap; 'question' — generate questions that focus on this context; 'transcend' — generate responses that go beyond the text and relate to a broader discourse."),
     modelToUse: z
         .enum([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -582,9 +631,11 @@ export const OptimizeTextStructureSchemaBase = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
         .default("gpt-5.4")
-        .describe("AI model to use for generating optimization suggestions: claude-opus-4.6, claude-sonnet-4.6, gemini-2.5-flash, gemini-2.5-flash-lite, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini"),
+        .describe("AI model to use for generating optimization suggestions: claude-opus-5, claude-sonnet-5, claude-fable-5, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, grok-4.1-fast-non-reasoning, grok-4.1-fast-reasoning, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini, gpt-5.6-terra, gpt-5.6-sol"),
 });
 export const OptimizeTextStructureSchema = OptimizeTextStructureSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -597,11 +648,13 @@ 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([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -611,9 +664,11 @@ export const OptimizeReasoningSchemaBase = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
         .default("gpt-5.4")
-        .describe("AI model to use for generating the reasoning-optimization suggestions: claude-opus-4.6, claude-sonnet-4.6, gemini-2.5-flash, gemini-2.5-flash-lite, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini"),
+        .describe("AI model to use for generating the reasoning-optimization suggestions: claude-opus-5, claude-sonnet-5, claude-fable-5, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, grok-4.1-fast-non-reasoning, grok-4.1-fast-reasoning, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini, gpt-5.6-terra, gpt-5.6-sol"),
 });
 export const OptimizeReasoningSchema = OptimizeReasoningSchemaBase;
 export const DevelopLatentConceptsSchemaBase = z.object({
@@ -628,6 +683,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()
@@ -640,8 +696,9 @@ export const DevelopLatentConceptsSchemaBase = z.object({
         .describe("Request mode: 'question' — generate questions that focus on this context; 'transcend' — generate responses that transcend and go beyond the content of the text and relate to a broader discourse."),
     modelToUse: z
         .enum([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -651,9 +708,11 @@ export const DevelopLatentConceptsSchemaBase = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
         .default("gpt-5.4")
-        .describe("AI model to use for generating research questions: claude-opus-4.6, claude-sonnet-4.6, gemini-2.5-flash, gemini-2.5-flash-lite, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini"),
+        .describe("AI model to use for generating research questions: claude-opus-5, claude-sonnet-5, claude-fable-5, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, grok-4.1-fast-non-reasoning, grok-4.1-fast-reasoning, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini, gpt-5.6-terra, gpt-5.6-sol"),
 });
 export const DevelopLatentConceptsSchema = DevelopLatentConceptsSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -710,6 +769,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()
@@ -717,8 +777,9 @@ export const GenerateResponsesFromGraphSchemaBase = z.object({
         .describe("Prompt to generate responses to from the graph"),
     modelToUse: z
         .enum([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -728,9 +789,11 @@ export const GenerateResponsesFromGraphSchemaBase = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
         .default("gpt-5.4")
-        .describe("AI model to use for generating research questions: claude-opus-4.6, claude-sonnet-4.6, gemini-2.5-flash, gemini-2.5-flash-lite, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini"),
+        .describe("AI model to use for generating research questions: claude-opus-5, claude-sonnet-5, claude-fable-5, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, grok-4.1-fast-non-reasoning, grok-4.1-fast-reasoning, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini, gpt-5.6-terra, gpt-5.6-sol"),
 });
 export const GenerateResponsesFromGraphSchema = GenerateResponsesFromGraphSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -823,6 +886,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")
@@ -847,6 +911,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")
@@ -1196,6 +1261,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")
@@ -1281,6 +1347,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()
@@ -1301,8 +1368,9 @@ export const DevelopTextToolSchemaBase = z.object({
         .describe("Shall we transcend and go beyond this text to relate to a broader discourse? If false, the focus is on this text only."),
     modelToUse: z
         .enum([
-        "claude-opus-4.6",
-        "claude-sonnet-4.6",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.5-flash-lite",
@@ -1312,9 +1380,11 @@ export const DevelopTextToolSchemaBase = z.object({
         "gpt-4o-mini",
         "gpt-5.4",
         "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
     ])
         .default("gpt-5.4")
-        .describe("AI model to use for generating insights: claude-opus-4.6, claude-sonnet-4.6, gemini-2.5-flash, gemini-2.5-flash-lite, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini"),
+        .describe("AI model to use for generating insights: claude-opus-5, claude-sonnet-5, claude-fable-5, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, grok-4.1-fast-non-reasoning, grok-4.1-fast-reasoning, gpt-4o, gpt-4o-mini, gpt-5.4, gpt-5.4-mini, gpt-5.6-terra, gpt-5.6-sol"),
 });
 export const DevelopTextToolSchema = DevelopTextToolSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -1347,4 +1417,335 @@ export const ListGraphsSchema = z.object({
         .describe("Filter by language code (e.g., 'EN', 'AUTO', 'DE', 'FR', 'ES', etc.)"),
     favorite: z.boolean().optional().describe("Filter by favorite status"),
 });
+// ---------------------------------------------------------------------------
+// Project learnings (see docs/drafts/project-learnings-graph.md)
+// ---------------------------------------------------------------------------
+const projectField = z
+    .string()
+    .min(1, "Project name is required")
+    .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,
+});
+// 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,
+    statements: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(10)
+        .describe("One learning per statement, at most 2 sentences each, with at least two [[wikilinked]] entities (file paths, modules, concepts, tools). Only project knowledge that is not derivable from the code in a few reads, would have saved time up front, survived verification, and ideally connects things that are not obviously connected. Include a self-assessment of how the work went: what approach worked well in this project and should be repeated, and what should be done differently next time (type 'approach'). Never anything about the user; never secrets, hostnames, env values, or verbatim error output."),
+    types: z
+        .array(z.enum([
+        "location",
+        "trap",
+        "convention",
+        "decision",
+        "workflow",
+        "question",
+        "approach",
+    ]))
+        .min(1)
+        .max(10)
+        .describe("One type per statement, parallel to `statements`: location (where X lives), trap (what went wrong first), convention (how things are done here), decision (what was chosen and why), workflow (how to run/test/build/deploy), question (open, unresolved), approach (self-assessment: what worked well and should be repeated, or what should be done differently next time in this project)."),
+    confirm: z
+        .boolean()
+        .default(false)
+        .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({
+    project: z
+        .string()
+        .optional()
+        .describe("Project name (same as used when enabling). Omit to list the projects that have learnings enabled in this account."),
+    prompt: z
+        .string()
+        .optional()
+        .describe("The task or question at hand. Retrieves the most relevant learnings for it (GraphRAG) plus a structural overview of what is known. Use at the start of a substantive task."),
+    entity: z
+        .string()
+        .optional()
+        .describe("A file path, module, or concept. Returns every learning that mentions it. Use before working on an unfamiliar area."),
+    type: z
+        .enum(["location", "trap", "convention", "decision", "workflow", "question", "approach"])
+        .optional()
+        .describe("Only return learnings of this type (e.g. 'trap' for the fragile areas of the project, 'approach' for what worked well or should be done differently). Applies to the overview and prompt modes."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(15)
+        .describe("Maximum number of learnings to return."),
+});
+// ---------------------------------------------------------------------------
+// Workflow feedback (see docs/drafts/workflow-feedback-tool.md)
+// ---------------------------------------------------------------------------
+export const SubmitWorkflowFeedbackSchema = z.object({
+    workflow: z
+        .string()
+        .min(1)
+        .describe("One sentence: what the user was trying to accomplish."),
+    toolsUsed: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe(`Names of the ${brand.name} tools called in this workflow, in order.`),
+    consumption: z
+        .enum(["none", "some", "most"])
+        .describe("How much of the tool output you carried into your reply to the user."),
+    usedExample: z
+        .string()
+        .optional()
+        .describe("Quote ONE specific item from the output that you used (a gap, a question, a cluster name, a bridge). Required when consumption is not 'none'. Never invent one."),
+    novelty: z
+        .enum(["nothing_new", "some_new", "mostly_new"])
+        .describe("Did the output contain things you would NOT have produced from the source text on your own?"),
+    taskFit: z
+        .enum(["right_tool", "needed_another", "wrong_tool"])
+        .describe("Was this the right tool for the request, or did you have to call another tool / do the work yourself to compensate?"),
+    callsNeeded: z
+        .number()
+        .int()
+        .min(1)
+        .describe("How many InfraNodus calls it took to get a usable result (including retries with changed parameters)."),
+    defects: z
+        .array(z.enum([
+        "too_generic",
+        "off_topic",
+        "wrong_language",
+        "truncated",
+        "duplicates",
+        "too_long_to_read",
+        "error",
+        "empty",
+    ]))
+        .default([])
+        .describe("Concrete problems observed in the output. Empty array if none."),
+    userNext: z
+        .enum(["built_on_it", "asked_followup", "ignored", "redirected", "unknown"])
+        .default("unknown")
+        .describe("Only if you can observe it: what the user did after your reply. Leave 'unknown' when reporting before the user has responded."),
+    reason: z
+        .string()
+        .min(1)
+        .describe("One line justifying the observations above."),
+});
+// ---------------------------------------------------------------------------
+// optimize_knowledge_base — structural feedback on a code base / vault / rule set
+// ---------------------------------------------------------------------------
+export const OptimizeKnowledgeBaseSchema = z.object({
+    graphName: z
+        .string()
+        .optional()
+        .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()
+        .describe("Alternative to graphName: a digest of the project as text that YOU write after reading its files — one statement per line describing how it works (principles, rules, procedures, hand-offs, main ideas, gaps), in your own words, with [[wikilinks]] on the modules, concepts, tools, and files each statement is about, grouped under `## [[Topic]]` heading lines; no tags; 100–300 lines. Analyzed without saving unless saveAs is given."),
+    saveAs: z
+        .string()
+        .optional()
+        .describe("With statements/text: save the submitted digest as this graph first (e.g. repo-<project>-digest, vault-<project>-digest), then analyse the saved graph. `## [[Topic]]` heading lines become the parent of the statements under them. Makes compareWith available in the same call and keeps the digest for later questions. Use a name no other producer writes to: a graph created here is in parent mode, and appending generate_ontology_graph 'procedural' output (whose [type] tags are categories) to it would turn those tags into central nodes. Ignored when graphName is given."),
+    focus: z
+        .enum(["general", "codebase", "vault", "procedural"])
+        .default("general")
+        .describe("How to read the structure: 'codebase' (modules, features, integrations), 'vault' (notes, themes, bridge notes), 'procedural' (rules, frameworks, hand-offs between them), or 'general'. Changes the interpretation of the diagnosis, not the analysis."),
+    compareWith: z
+        .array(z.string().min(1))
+        .max(2)
+        .optional()
+        .describe("Up to two other saved graphs of the same project to compare against (e.g. repo-<project>-structure when the primary is the digest, or docs when the primary is code). Each comparison reports what the other layer covers that the primary lacks, and the reverse — rules without code, code without documentation, features described but not built. Requires the primary to be a saved graph: graphName, or statements/text with saveAs."),
+    includeLatent: z
+        .boolean()
+        .default(true)
+        .describe("Also run the latent-topics pass (one extra AI call) to list under-developed areas with ideas on how to develop them. Default true."),
+    modelToUse: z
+        .enum([
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-fable-5",
+        "gemini-2.5-pro",
+        "gemini-2.5-flash",
+        "gemini-2.5-flash-lite",
+        "grok-4.1-fast-non-reasoning",
+        "grok-4.1-fast-reasoning",
+        "gpt-4o",
+        "gpt-4o-mini",
+        "gpt-5.4",
+        "gpt-5.4-mini",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
+    ])
+        .default("gpt-5.4")
+        .describe("AI model for the development suggestions and latent-topic ideas."),
+});
+// ---------------------------------------------------------------------------
+// delete_statements (see docs/drafts/delete-statements-tool.md)
+// ---------------------------------------------------------------------------
+// "Exactly one selector" is checked in the handler (a .refine() would hide
+// `.shape`, which tool registration needs). There is deliberately no
+// `userName`: the tool only ever addresses graphs in the caller's own account.
+export const DeleteStatementsSchema = z.object({
+    graphName: z
+        .string()
+        .min(1, "graphName is required")
+        .describe(`Name of the graph in your own ${brand.name} account to delete from. It must already exist (use list_graphs to check the exact name); other users' graphs cannot be targeted and this tool never creates a graph.`),
+    categories: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Delete every statement that carries any of these category labels (exact match). Categories are the source labels statements were uploaded with — a file path, a page name, the [[label]] parent from a '## [[Topic]]' heading — so this is how you remove everything that came from one source before re-uploading its new version with create_knowledge_graph to the same graphName."),
+    statements: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Delete statements whose text equals one of these exactly (whitespace-normalised)."),
+    query: z
+        .string()
+        .optional()
+        .describe("Delete statements containing this text (case-insensitive substring), or matching a regular expression written as /pattern/flags."),
+    before: z
+        .string()
+        .optional()
+        .describe("Delete statements dated before this ISO 8601 date or datetime (e.g. 2026-08-01 or 2026-08-01T12:00:00Z). Combine with after for a window; the two together count as one selector."),
+    after: z
+        .string()
+        .optional()
+        .describe("Delete statements dated after this ISO 8601 date or datetime. Combine with before for a window."),
+    deleteAll: z
+        .boolean()
+        .optional()
+        .describe("Delete every statement but keep the graph: its name, URL, and settings (e.g. wikilinksMode) stay valid, so it can be rebuilt in place with create_knowledge_graph."),
+    statementIds: z
+        .array(z.number().int())
+        .optional()
+        .describe("Advanced: delete by statement id (ids come from an earlier dry run of this tool or from retrieve_from_knowledge_base). Ids that do not belong to this graph are ignored and reported as ignoredIds."),
+    confirm: z
+        .boolean()
+        .default(false)
+        .describe("Without this (the default) the call is a DRY RUN that only reports what would be deleted. Set true, with the same filter, only after the user has agreed to delete what the dry run showed. The deletion is irreversible."),
+});
+// ---------------------------------------------------------------------------
+// delete_graph
+// ---------------------------------------------------------------------------
+export const DeleteGraphSchema = z.object({
+    graphName: z
+        .string()
+        .min(1, "graphName is required")
+        .describe(`Exact name of the graph in your own ${brand.name} account to delete (use list_graphs to check it). Other users' graphs cannot be targeted.`),
+    confirm: z
+        .boolean()
+        .default(false)
+        .describe("Without this (the default) the call is a DRY RUN that only confirms the graph exists and reports what would be removed. Set true, with the same graphName, only after the user has agreed to delete that graph. The deletion is irreversible."),
+});
+// ---------------------------------------------------------------------------
+// update_statements (see docs/drafts/update-statements-tool.md)
+// ---------------------------------------------------------------------------
+/** One targeted edit for update_statements (Mode A). */
+export const UpdateStatementEditSchema = z.object({
+    match: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("The exact current text of the statement to edit (whitespace-normalised), e.g. as returned by analyze_existing_graph_by_name with includeStatements, retrieve_from_knowledge_base, or an earlier dry run. Give exactly one of match or statementId."),
+    statementId: z
+        .number()
+        .int()
+        .optional()
+        .describe("Advanced: the id of the statement to edit (ids come from a dry run of this tool, of delete_statements, or from retrieve_from_knowledge_base). Give exactly one of match or statementId."),
+    content: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("The new text of the statement (at most 1000 characters). [[wikilinks]] are honoured as in create_knowledge_graph. Omit to keep the current text."),
+    categories: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("The new full list of category labels for this statement (replaces the current list). Omit to keep the current categories."),
+    timestamp: z
+        .string()
+        .optional()
+        .describe("The new ISO 8601 date or datetime for this statement (e.g. 2026-08-01 or 2026-08-01T12:00:00Z). Omit to keep the current one."),
+});
+// Cross-field rules (Mode A xor Mode B, exactly one selector, at least one
+// operation, one of match/statementId per edit) are checked in the handler
+// (a .refine() would hide `.shape`, which tool registration needs). No
+// `userName`: the tool only ever addresses graphs in the caller's own account.
+export const UpdateStatementsSchema = z.object({
+    graphName: z
+        .string()
+        .min(1, "graphName is required")
+        .describe(`Name of the graph in your own ${brand.name} account to edit. It must already exist (use list_graphs to check the exact name); other users' graphs cannot be targeted and this tool never creates a graph.`),
+    edits: z
+        .array(UpdateStatementEditSchema)
+        .optional()
+        .describe("Mode A — rewrite specific statements. Each item names one statement (exactly one of match — its exact current text — or statementId) and at least one field to change (content, categories, timestamp). Cannot be combined with the Mode B fields below. Items that match no statement are reported as unmatched, not errors."),
+    categories: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Mode B selector: every statement carrying any of these category labels (exact match) — everything uploaded under one source (a file path, a page name, the [[label]] parent of a '## [[Topic]]' heading)."),
+    statements: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Mode B selector: statements whose text equals one of these exactly (whitespace-normalised)."),
+    query: z
+        .string()
+        .optional()
+        .describe("Mode B selector: statements containing this text (case-insensitive substring), or matching a regular expression written as /pattern/flags."),
+    before: z
+        .string()
+        .optional()
+        .describe("Mode B selector: statements dated before this ISO 8601 date or datetime (e.g. 2026-08-01 or 2026-08-01T12:00:00Z). Combine with after for a window; the two together count as one selector."),
+    after: z
+        .string()
+        .optional()
+        .describe("Mode B selector: statements dated after this ISO 8601 date or datetime. Combine with before for a window."),
+    all: z
+        .boolean()
+        .optional()
+        .describe("Mode B selector: every statement in the graph (e.g. to rename a [[concept]] or a source path everywhere with replace)."),
+    statementIds: z
+        .array(z.number().int())
+        .optional()
+        .describe("Mode B selector (advanced): statements by id (ids come from an earlier dry run of this tool or of delete_statements, or from retrieve_from_knowledge_base). Ids that do not belong to this graph are reported as unmatched."),
+    set: z
+        .object({
+        addCategories: z
+            .array(z.string().min(1))
+            .optional()
+            .describe("Category labels to add to every selected statement (existing ones are kept)."),
+        removeCategories: z
+            .array(z.string().min(1))
+            .optional()
+            .describe("Category labels to remove from every selected statement."),
+        categories: z
+            .array(z.string().min(1))
+            .optional()
+            .describe("The new full list of category labels for every selected statement (replaces the current list). Cannot be combined with addCategories or removeCategories."),
+        timestamp: z
+            .string()
+            .optional()
+            .describe("The new ISO 8601 date or datetime for every selected statement."),
+    })
+        .optional()
+        .describe("Mode B operation: change the metadata of every selected statement — addCategories, removeCategories, categories (full replacement; exclusive with add/remove), timestamp. At least one of set or replace is required in Mode B."),
+    replace: z
+        .object({
+        pattern: z
+            .string()
+            .min(1)
+            .describe("What to find in the text of every selected statement: a plain substring (every occurrence, case-sensitive) or a regular expression written as /pattern/flags (e.g. /\\[\\[Old Name\\]\\]/g)."),
+        with: z
+            .string()
+            .describe("The replacement text ($1-style backreferences work with a regex pattern). An empty string removes the match. The resulting statement must stay at most 1000 characters."),
+    })
+        .optional()
+        .describe("Mode B operation: find-and-replace in the text of every selected statement, e.g. to rename a [[concept]] or a source path across the graph. At least one of set or replace is required in Mode B."),
+    confirm: z
+        .boolean()
+        .default(false)
+        .describe("Without this (the default) the call is a DRY RUN that only reports what would change (before → after for each statement). Set true, with the same arguments, only after the user has agreed to the changes the dry run showed. The edit is irreversible: the previous text survives only in the dry-run output."),
+});
 //# sourceMappingURL=index.js.map