keywordgraph-mcp-server 1.9.1 → 1.9.5

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":"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"}

package/dist/schemas/index.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { AI_MODELS, DEFAULT_AI_MODEL, DEFAULT_GRAPH_MODEL, } from "../config/models.js";
 import { brand } from "../config/brand.js";
 import { WikilinksModeEnum, categoriesAsNodesDescription, wikilinksModeDescription, } from "../utils/wikilinksMode.js";
 /**
@@ -39,11 +40,34 @@ const timestampsField = z
     .array(z.string())
     .optional()
     .describe("Per-statement date, one entry per statement (empty string = upload time, length must match `statements`). ISO 8601 only — '2026-08-02' or '2026-08-02T14:30:00Z'; other formats are refused because day-first and month-first dates are indistinguishable below the 13th. Stored to minute precision in the server timezone; drives time filters and dynamic graph views. Requires `statements`; omit when the statements are undated.");
+const ENTITY_MODES = [
+    "none",
+    "detectEntities",
+    "extractEntitiesOnly",
+    "aiKnowledgeGraph",
+];
+const entityDetectionDescription = "How the graph's nodes are made. " +
+    "none: from the words of the text (default). " +
+    "detectEntities: an algorithm (TextRazor) finds names of people, places, organizations and the like and marks them as entities; the graph mixes them with ordinary words. " +
+    "extractEntitiesOnly: the same algorithm finds the names, and only they become nodes. For plain text without [[wikilinks]]; for text already written as [[entity]] statements use wikilinksMode: 'wikilinksOnly' instead.";
+const entityModesDescription = "How the graph's nodes are made. " +
+    "none: from the words of the text (default; for text, gap and topical analysis). " +
+    "detectEntities: an algorithm (TextRazor) finds names of people, places, organizations and the like and marks them as entities; the graph mixes them with ordinary words. " +
+    "extractEntitiesOnly: the same algorithm finds the names, and only they become nodes. For plain text without [[wikilinks]]; statements you already wrote as [[entity]] statements go in with wikilinksMode: 'wikilinksOnly' instead. " +
+    "aiKnowledgeGraph: an AI model writes [[entity]] statements about the input, a topic or a text, and only those entities become nodes; no algorithm detection. Use for a knowledge graph of a topic or a text. Slower: one AI call per ~12,000 characters, which counts against the AI quota.";
+const aiGraphModelField = z
+    .enum(AI_MODELS)
+    .optional()
+    .describe("Only with modifyAnalyzedText: 'aiKnowledgeGraph'. AI model that writes the entity statements. Default: claude-opus-5-5; the -mini and -lite variants are faster and cheaper.");
+const aiGraphInstructionsField = z
+    .string()
+    .optional()
+    .describe("Only with modifyAnalyzedText: 'aiKnowledgeGraph'. The user's own instructions for the AI model, e.g. 'only people and organizations' or 'focus on 1950-1970'. They can change which entities and relations to include, the scope and the number of statements, but not the output format.");
 export const GenerateGraphSchema = z.object({
     text: z
         .string()
         .optional()
-        .describe("Text that you'd like to analyze. Use new lines to separate separate statements or paragrams in each text (but not the sentences). Use [[wikilinks]] to mark entities (if required for social / knowledge graphs, ontology, or entity detection). Provide one of: this, url, or statements."),
+        .describe("Text that you'd like to analyze. Use new lines to separate separate statements or paragrams in each text (but not the sentences). Use [[wikilinks]] to mark entities (if required for social / knowledge graphs, ontology, or entity detection). With modifyAnalyzedText: 'aiKnowledgeGraph' this can also be a short topic. Provide one of: this, url, or statements."),
     url: z
         .string()
         .url()
@@ -78,9 +102,11 @@ export const GenerateGraphSchema = z.object({
         .optional()
         .describe("Maximum number of concepts (nodes) in the generated graph. Default 150 — the most relevant nodes are kept and the rest dropped. Increase (e.g. 500) for large texts when a more complete graph is explicitly needed; response size grows accordingly. Omit to use the default."),
     modifyAnalyzedText: z
-        .enum(["none", "detectEntities", "extractEntitiesOnly"])
+        .enum(ENTITY_MODES)
         .default("none")
-        .describe("Text processing setting to use: none (for text, gap, and topical analysis), detectEntities (mix entities and words), extractEntitiesOnly (detect entities only - use for ontology and knowledge graph generation and entity extraction)"),
+        .describe(entityModesDescription),
+    modelToUse: aiGraphModelField,
+    instructions: aiGraphInstructionsField,
     wikilinksMode: WikilinksModeEnum.default("default").describe(wikilinksModeDescription),
 });
 export const CreateGraphSchema = z.object({
@@ -91,7 +117,7 @@ export const CreateGraphSchema = z.object({
     text: z
         .string()
         .optional()
-        .describe("Text that you'd like to analyze. Use new lines to separate separate statements or paragrams in each text (but not the sentences). Provide one of: this, url, or statements."),
+        .describe("Text that you'd like to analyze. Use new lines to separate separate statements or paragrams in each text (but not the sentences). With modifyAnalyzedText: 'aiKnowledgeGraph' this can also be a short topic. Provide one of: this, url, or statements."),
     url: z
         .string()
         .url()
@@ -126,9 +152,11 @@ export const CreateGraphSchema = z.object({
         .optional()
         .describe("Maximum number of concepts (nodes) in the generated graph. Default 150 — the most relevant nodes are kept and the rest dropped. Increase (e.g. 500) for large texts when a more complete graph is explicitly needed; response size grows accordingly. Omit to use the default."),
     modifyAnalyzedText: z
-        .enum(["none", "detectEntities", "extractEntitiesOnly"])
+        .enum(ENTITY_MODES)
         .default("none")
-        .describe("Entity detection: none (normal), detectEntities (mix entities and words), extractEntitiesOnly (detect entities only - use for ontology and knowledge graph creation and entity extraction)"),
+        .describe(entityModesDescription),
+    modelToUse: aiGraphModelField,
+    instructions: aiGraphInstructionsField,
     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."),
 });
@@ -236,7 +264,7 @@ export const AnalyzeTextSchemaBase = z.object({
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
-        .describe("Entity detection: none (normal), detectEntities (mix entities and words), extractEntitiesOnly (detect entities only - use for ontology and knowledge graph creation and entity extraction)"),
+        .describe(entityDetectionDescription),
     wikilinksMode: WikilinksModeEnum.default("default").describe(wikilinksModeDescription),
 });
 export const AnalyzeTextSchema = AnalyzeTextSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
@@ -308,7 +336,7 @@ export const AnalyzeExistingGraphSchemaBase = z.object({
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
-        .describe("Entity detection: none (normal), detectEntities (mix entities and words), extractEntitiesOnly (detect entities only - use for ontology and knowledge graph creation and entity extraction)"),
+        .describe(entityDetectionDescription),
 });
 export const AnalyzeExistingGraphSchema = AnalyzeExistingGraphSchemaBase;
 export const SearchExistingGraphsSchema = z.object({
@@ -436,24 +464,9 @@ export const GenerateOntologyGraphSchema = z.object({
         .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-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("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."),
+        .enum(AI_MODELS)
+        .default(DEFAULT_GRAPH_MODEL)
+        .describe("AI model used to generate the ontology. More capable models (claude-opus-5-5, claude-fable-5-1, gpt-6.1-terra) produce richer, more accurate ontologies; the -mini and -lite variants are faster and cheaper. Default: claude-opus-5-5."),
     saveGraph: z
         .boolean()
         .default(true)
@@ -493,24 +506,9 @@ export const AnalyzeLlmResultsSchema = z.object({
         .optional()
         .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-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("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."),
+        .enum(AI_MODELS)
+        .default(DEFAULT_GRAPH_MODEL)
+        .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-5."),
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
@@ -566,6 +564,21 @@ export const GenerateTopicalClustersSchema = GenerateTopicalClustersSchemaBase.r
     (data.url !== undefined && data.url.length > 0) ||
     (data.graphName !== undefined && data.graphName.trim().length > 0) ||
     (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
+// Which clusters the AI works on (the API's `optimize` query parameter). The
+// default follows the graph's insight clusters, chosen from its structure.
+const OPTIMIZE_MODE_OPTIMIZE = "'optimize' (default): the graph's insight clusters, picked from its structure to move it toward a balanced, diversified shape — in a biased or focused graph the least influential clusters across a gap, in a diversified graph the widest gap, in a dispersed graph the most influential clusters across a gap";
+const OPTIMIZE_MODE_DEVELOP = "'develop': all the main topical clusters, to develop what the content already covers";
+const OPTIMIZE_MODE_LATENT = "'latent': the least represented clusters, to bring out topics that are present but under-developed";
+const OPTIMIZE_MODE_GAP = "'gap': the widest structural gap, whatever the state of the graph";
+const INSIGHT_CLUSTERS_RETURNED = "The response lists the insight clusters as insightClusters, one line per gap depth.";
+const researchOptimizeField = (what) => z
+    .enum(["optimize", "gap", "develop", "latent"])
+    .default("optimize")
+    .describe(`Which clusters the ${what} are generated from. ${OPTIMIZE_MODE_OPTIMIZE}. ${OPTIMIZE_MODE_GAP}. ${OPTIMIZE_MODE_DEVELOP}. ${OPTIMIZE_MODE_LATENT}. ${INSIGHT_CLUSTERS_RETURNED}`);
+const researchGapDepthField = (what) => z
+    .number()
+    .default(0)
+    .describe(`Which gap to generate ${what} for: 0 is the first, higher numbers reach less prominent ones. With optimize 'optimize' it selects the insight clusters at that depth, with 'gap' the next widest gap.`);
 export const GenerateResearchQuestionsSchemaBase = z.object({
     text: z
         .string()
@@ -593,33 +606,16 @@ export const GenerateResearchQuestionsSchemaBase = z.object({
         .boolean()
         .default(false)
         .describe("Generate questions for several content gaps found in text"),
-    gapDepth: z
-        .number()
-        .default(0)
-        .describe("Depth of content gaps to generate questions for"),
+    optimize: researchOptimizeField("questions"),
+    gapDepth: researchGapDepthField("questions"),
     includeGraphSummary: z
         .boolean()
         .default(false)
         .describe("Include graph summary string in the response to provide additional information about the text knowledge graph structure"),
     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 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"),
+        .enum(AI_MODELS)
+        .default(DEFAULT_AI_MODEL)
+        .describe("AI model to use for generating research questions. Default: gpt-6.1-terra."),
 });
 export const GenerateResearchQuestionsSchema = GenerateResearchQuestionsSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -652,10 +648,8 @@ export const GenerateResearchIdeasSchemaBase = z.object({
         .boolean()
         .default(false)
         .describe("Generate ideas for several content gaps found in text"),
-    gapDepth: z
-        .number()
-        .default(0)
-        .describe("Depth of content gaps to generate ideas for"),
+    optimize: researchOptimizeField("ideas"),
+    gapDepth: researchGapDepthField("ideas"),
     shouldTranscend: z
         .boolean()
         .default(false)
@@ -669,24 +663,9 @@ export const GenerateResearchIdeasSchemaBase = z.object({
         .default(false)
         .describe("Include graph summary string in the response to provide additional information about the text knowledge graph structure"),
     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 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"),
+        .enum(AI_MODELS)
+        .default(DEFAULT_AI_MODEL)
+        .describe("AI model to use for generating research questions. Default: gpt-6.1-terra."),
 });
 export const GenerateResearchIdeasSchema = GenerateResearchIdeasSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -716,24 +695,9 @@ export const OptimizeTextStructureSchemaBase = z.object({
         .default("response")
         .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-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 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"),
+        .enum(AI_MODELS)
+        .default(DEFAULT_AI_MODEL)
+        .describe("AI model to use for generating optimization suggestions. Default: gpt-6.1-terra."),
 });
 export const OptimizeTextStructureSchema = OptimizeTextStructureSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -749,24 +713,9 @@ export const OptimizeReasoningSchemaBase = z.object({
     categoriesAsNodes: categoriesAsNodesField,
     timestamps: timestampsField,
     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 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"),
+        .enum(AI_MODELS)
+        .default(DEFAULT_AI_MODEL)
+        .describe("AI model to use for generating the reasoning-optimization suggestions. Default: gpt-6.1-terra."),
 });
 export const OptimizeReasoningSchema = OptimizeReasoningSchemaBase;
 export const DevelopLatentConceptsSchemaBase = z.object({
@@ -793,24 +742,9 @@ export const DevelopLatentConceptsSchemaBase = z.object({
         .default("transcend")
         .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-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 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"),
+        .enum(AI_MODELS)
+        .default(DEFAULT_AI_MODEL)
+        .describe("AI model to use for generating research questions. Default: gpt-6.1-terra."),
 });
 export const DevelopLatentConceptsSchema = DevelopLatentConceptsSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -887,6 +821,38 @@ export const GetNodeNeighborhoodSchema = z.object({
         .default(true)
         .describe("Include the statements on those links (with their categories and hop distance)"),
 });
+export const GetGraphAroundTermSchema = z.object({
+    terms: z
+        .union([z.string().min(1), z.array(z.string().min(1)).min(1).max(5)])
+        .describe("The term to look up — a word, a [[concept]] or an entity name, with or without [[ ]] — or several terms (at most 5): the statements that contain all of them (matchAll, the default) or any of them."),
+    matchAll: z
+        .boolean()
+        .default(true)
+        .describe("With several terms: true (default) takes only the statements that contain all of them — their shared context; false takes the statements that contain any of them — their contexts merged into one graph."),
+    graphNames: z
+        .array(z.string().min(1))
+        .default([])
+        .describe(`Which ${brand.name} graphs to search: one name for one graph, several names for those graphs, empty (the default) for every graph in the account.`),
+    removeTerms: z
+        .boolean()
+        .default(true)
+        .describe("Leave the terms out of the graph (default), so the clusters and gaps describe the context around them rather than the terms themselves. false keeps them in, to see what they bridge."),
+    includeGraph: z
+        .boolean()
+        .default(true)
+        .describe("Include the compact graph (nodes with their betweenness, weighted edges) next to the statistics; the statistics and the summary come either way."),
+    includeStatements: z
+        .boolean()
+        .default(false)
+        .describe("Include the statements that were found, each with the graph it came from and its cluster."),
+    maxNodes: z
+        .number()
+        .int()
+        .min(10)
+        .max(2000)
+        .default(150)
+        .describe("How many of the most important nodes the graph keeps."),
+});
 export const GenerateResponsesFromGraphSchemaBase = z.object({
     graphName: z
         .string()
@@ -915,24 +881,9 @@ export const GenerateResponsesFromGraphSchemaBase = z.object({
         .min(1, "Prompt is required")
         .describe("Prompt to generate responses to from the graph"),
     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 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"),
+        .enum(AI_MODELS)
+        .default(DEFAULT_AI_MODEL)
+        .describe("AI model to use for generating research questions. Default: gpt-6.1-terra."),
 });
 export const GenerateResponsesFromGraphSchema = GenerateResponsesFromGraphSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -976,7 +927,7 @@ export const GenerateGeneralGraphSchema = z.object({
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
-        .describe("Entity detection: none (normal), detectEntities (mix entities and words), extractEntitiesOnly (detect entities only - use for ontology and knowledge graph creation and entity extraction)"),
+        .describe(entityDetectionDescription),
 });
 /** Shared context item: one of { text }, { statements }, { url }, or { graphName }. Used by overlap and difference tools. */
 const contextItemTextUrlOrGraphSchema = z.union([
@@ -1029,7 +980,7 @@ const GenerateOverlapGraphFromTextsSchemaBase = z.object({
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
-        .describe("Entity detection: none (normal), detectEntities (mix entities and words), extractEntitiesOnly (detect entities only - use for ontology and knowledge graph creation and entity extraction)"),
+        .describe(entityDetectionDescription),
     includeStatements: z
         .boolean()
         .default(false)
@@ -1055,7 +1006,7 @@ const GenerateDifferenceGraphFromTextsSchemaBase = z.object({
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
-        .describe("Entity detection: none (normal), detectEntities (mix entities and words), extractEntitiesOnly (detect entities only - use for ontology and knowledge graph creation and entity extraction)"),
+        .describe(entityDetectionDescription),
     includeStatements: z
         .boolean()
         .default(false)
@@ -1508,24 +1459,9 @@ export const DevelopTextToolSchemaBase = z.object({
         .default(false)
         .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-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 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"),
+        .enum(AI_MODELS)
+        .default(DEFAULT_AI_MODEL)
+        .describe("AI model to use for generating insights. Default: gpt-6.1-terra."),
 });
 export const DevelopTextToolSchema = DevelopTextToolSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
@@ -1711,28 +1647,23 @@ export const OptimizeKnowledgeBaseSchema = z.object({
         .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."),
+    optimize: z
+        .enum(["optimize", "develop", "latent"])
+        .default("optimize")
+        .describe(`Which clusters the suggestions work on. ${OPTIMIZE_MODE_OPTIMIZE}. ${OPTIMIZE_MODE_DEVELOP}. ${OPTIMIZE_MODE_LATENT}, with ideas that go beyond the current content. ${INSIGHT_CLUSTERS_RETURNED}`),
+    gapDepth: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe("With optimize 'optimize': which insight clusters the suggestions use. 0 is the first set; raise it on a later call to get suggestions for the next, less prominent set, so repeated calls work through the graph."),
     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."),
+        .optional()
+        .describe("Also run the latent-topics pass (one extra AI call) to list under-developed areas with ideas on how to develop them. When omitted it runs with optimize 'develop' and not with 'optimize', whose suggestions follow the insight clusters only. Never run a second time when optimize is 'latent'."),
     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")
+        .enum(AI_MODELS)
+        .default(DEFAULT_AI_MODEL)
         .describe("AI model for the development suggestions and latent-topic ideas."),
 });
 // ---------------------------------------------------------------------------