keywordgraph-mcp-server 1.7.0 → 1.7.3

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,15 +1,41 @@
 import { z } from "zod";
 import { brand } from "../config/brand.js";
+import { WikilinksModeEnum, 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.
+ */
+const statementsField = z
+    .array(z.string().min(1))
+    .min(1)
+    .optional()
+    .describe("Alternative to `text`: already-separated statements, each one unit of analysis (the role a line plays in `text`). Use only for short discrete items — notes, records, memory entries, survey answers, relations — especially when they carry `categories` or `timestamps`. For prose or long content use text/url instead, which is split on new lines anyway.");
+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.");
+/** 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 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.");
 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 either this or url."),
+        .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."),
     url: z
         .string()
         .url()
         .optional()
         .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide either this or text, not both."),
+    statements: statementsField,
+    categories: categoriesField,
+    timestamps: timestampsField,
     includeStatements: z
         .boolean()
         .default(false)
@@ -22,10 +48,22 @@ export const GenerateGraphSchema = z.object({
         .boolean()
         .default(false)
         .describe("Include nodes and edges in response (true only if explicitly needed, not recommended for longer texts)"),
+    fullGraph: z
+        .boolean()
+        .default(false)
+        .describe("Return the complete non-compacted graph: all node attributes (degree, betweenness centrality, community), all edge attributes including context_matrix (which statements produced each edge, with weights), the nodes-to-statements map, and full statement metadata. Overrides includeGraph / addNodesAndEdges / compaction. Token-heavy — use only when the raw graph data is explicitly needed (e.g. export, rendering, or programmatic processing)."),
+    maxNodes: z
+        .number()
+        .int()
+        .positive()
+        .max(1000)
+        .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"])
         .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)"),
+    wikilinksMode: WikilinksModeEnum.default("default").describe(wikilinksModeDescription),
 });
 export const CreateGraphSchema = z.object({
     graphName: z
@@ -35,12 +73,15 @@ 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 either this or url."),
+        .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."),
     url: z
         .string()
         .url()
         .optional()
         .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}`),
+    timestamps: timestampsField,
     includeStatements: z
         .boolean()
         .default(false)
@@ -53,10 +94,23 @@ export const CreateGraphSchema = z.object({
         .boolean()
         .default(false)
         .describe("Include nodes and edges in response (add only if explicitly needed, not recommended for longer texts)"),
+    fullGraph: z
+        .boolean()
+        .default(false)
+        .describe("Return the complete non-compacted graph: all node attributes (degree, betweenness centrality, community), all edge attributes including context_matrix (which statements produced each edge, with weights), the nodes-to-statements map, and full statement metadata. Overrides includeGraph / addNodesAndEdges / compaction. Token-heavy — use only when the raw graph data is explicitly needed (e.g. export, rendering, or programmatic processing)."),
+    maxNodes: z
+        .number()
+        .int()
+        .positive()
+        .max(1000)
+        .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"])
         .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)"),
+    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."),
 });
 export const AddMemorySchema = z.object({
     graphName: z
@@ -66,8 +120,11 @@ export const AddMemorySchema = z.object({
         .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.`),
     text: z
         .string()
-        .min(1, "Text is required for analysis")
-        .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."),
+        .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),
+    timestamps: timestampsField,
     includeStatements: z
         .boolean()
         .default(false)
@@ -89,12 +146,15 @@ export const AnalyzeTextSchemaBase = 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 either this or url."),
+        .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."),
     url: z
         .string()
         .url()
         .optional()
         .describe("URL to fetch content from (e.g. webpage or YouTube video transcript). Provide either this or text."),
+    statements: statementsField,
+    categories: categoriesField,
+    timestamps: timestampsField,
     includeStatements: z
         .boolean()
         .default(false)
@@ -107,6 +167,10 @@ export const AnalyzeTextSchemaBase = z.object({
         .boolean()
         .default(false)
         .describe("Include nodes and edges in response (add only if explicitly needed, not recommended for longer texts)"),
+    fullGraph: z
+        .boolean()
+        .default(false)
+        .describe("Return the complete non-compacted graph: all node attributes (degree, betweenness centrality, community), all edge attributes including context_matrix (which statements produced each edge, with weights), the nodes-to-statements map, and full statement metadata. Overrides includeGraph / addNodesAndEdges / compaction. Token-heavy — use only when the raw graph data is explicitly needed (e.g. export, rendering, or programmatic processing)."),
     includeGraphSummary: z
         .boolean()
         .default(false)
@@ -115,9 +179,11 @@ export const AnalyzeTextSchemaBase = z.object({
         .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)"),
+    wikilinksMode: WikilinksModeEnum.default("default").describe(wikilinksModeDescription),
 });
 export const AnalyzeTextSchema = AnalyzeTextSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
-    (data.url !== undefined && data.url.length > 0), { message: "Provide either text or url for analysis." });
+    (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()
@@ -139,6 +205,10 @@ export const AnalyzeExistingGraphSchemaBase = z.object({
         .boolean()
         .default(false)
         .describe("Include nodes and edges in response (add only if explicitly needed, not recommended for longer texts)"),
+    fullGraph: z
+        .boolean()
+        .default(false)
+        .describe("Return the complete non-compacted graph: all node attributes (degree, betweenness centrality, community), all edge attributes including context_matrix (which statements produced each edge, with weights), the nodes-to-statements map, and full statement metadata. Overrides includeGraph / addNodesAndEdges / compaction. Token-heavy — use only when the raw graph data is explicitly needed (e.g. export, rendering, or programmatic processing)."),
     includeGraphSummary: z
         .boolean()
         .default(false)
@@ -188,7 +258,10 @@ export const GenerateContentGapsSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     graphName: z
         .string()
         .min(1, "Graph name must be non-empty when provided")
@@ -207,7 +280,10 @@ export const generateContextualHintSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     graphName: z
         .string()
         .min(1, "Graph name must be non-empty when provided")
@@ -220,7 +296,8 @@ export const generateContextualHintSchemaBase = z.object({
 });
 export const generateContextualHintSchema = generateContextualHintSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
-    (data.graphName !== undefined && data.graphName.trim().length > 0), { message: "Provide either text, url, or graphName for analysis." });
+    (data.graphName !== undefined && data.graphName.trim().length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
 export const GenerateOntologyGraphSchema = z.object({
     prompt: z
         .string()
@@ -254,6 +331,17 @@ export const GenerateOntologyGraphSchema = z.object({
         .boolean()
         .default(false)
         .describe("Include the compact graph structure — nodes (entities), edges (relations between them), and clusters — in the response. False by default to keep the response small; the ontology statements and analytics usually carry what's needed. Set to true when you also want to inspect the node/edge structure or render it."),
+    fullGraph: z
+        .boolean()
+        .default(false)
+        .describe("Return the complete non-compacted graph: all node attributes (degree, betweenness centrality, community), all edge attributes including context_matrix (which statements produced each edge, with weights), and the nodes-to-statements map. Implies includeGraph and overrides compaction. Token-heavy — use only when the raw graph data is explicitly needed (e.g. export, rendering, or programmatic processing)."),
+    maxNodes: z
+        .number()
+        .int()
+        .positive()
+        .max(1000)
+        .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 ontologies when a more complete graph is explicitly needed; response size grows accordingly. Omit to use the default."),
     includeAnalytics: z
         .boolean()
         .default(true)
@@ -318,7 +406,10 @@ export const GenerateTopicalClustersSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     graphName: z
         .string()
         .min(1, "Graph name must be non-empty when provided")
@@ -336,7 +427,8 @@ export const GenerateTopicalClustersSchemaBase = z.object({
 });
 export const GenerateTopicalClustersSchema = GenerateTopicalClustersSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
-    (data.graphName !== undefined && data.graphName.trim().length > 0), { message: "Provide either text, url, or graphName for analysis." });
+    (data.graphName !== undefined && data.graphName.trim().length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
 export const GenerateResearchQuestionsSchemaBase = z.object({
     text: z
         .string()
@@ -346,7 +438,10 @@ export const GenerateResearchQuestionsSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     graphName: z
         .string()
         .min(1, "Graph name must be non-empty when provided")
@@ -382,12 +477,13 @@ export const GenerateResearchQuestionsSchemaBase = z.object({
         "gpt-5.4",
         "gpt-5.4-mini",
     ])
-        .default("gpt-4o")
+        .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"),
 });
 export const GenerateResearchQuestionsSchema = GenerateResearchQuestionsSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
-    (data.graphName !== undefined && data.graphName.trim().length > 0), { message: "Provide either text, url, or graphName for analysis." });
+    (data.graphName !== undefined && data.graphName.trim().length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
 export const GenerateResearchIdeasSchemaBase = z.object({
     text: z
         .string()
@@ -397,7 +493,10 @@ export const GenerateResearchIdeasSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     graphName: z
         .string()
         .min(1, "Graph name must be non-empty when provided")
@@ -441,12 +540,13 @@ export const GenerateResearchIdeasSchemaBase = z.object({
         "gpt-5.4",
         "gpt-5.4-mini",
     ])
-        .default("gpt-4o")
+        .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"),
 });
 export const GenerateResearchIdeasSchema = GenerateResearchIdeasSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
-    (data.graphName !== undefined && data.graphName.trim().length > 0), { message: "Provide either text, url, or graphName for analysis." });
+    (data.graphName !== undefined && data.graphName.trim().length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
 export const OptimizeTextStructureSchemaBase = z.object({
     text: z
         .string()
@@ -456,7 +556,10 @@ export const OptimizeTextStructureSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     graphName: z
         .string()
         .min(1, "Graph name must be non-empty when provided")
@@ -480,12 +583,39 @@ export const OptimizeTextStructureSchemaBase = z.object({
         "gpt-5.4",
         "gpt-5.4-mini",
     ])
-        .default("gpt-4o")
+        .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"),
 });
 export const OptimizeTextStructureSchema = OptimizeTextStructureSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
-    (data.graphName !== undefined && data.graphName.trim().length > 0), { message: "Provide either text, url, or graphName for analysis." });
+    (data.graphName !== undefined && data.graphName.trim().length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
+export const OptimizeReasoningSchemaBase = z.object({
+    text: z
+        .string()
+        .optional()
+        .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,
+    timestamps: timestampsField,
+    modelToUse: z
+        .enum([
+        "claude-opus-4.6",
+        "claude-sonnet-4.6",
+        "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",
+    ])
+        .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"),
+});
+export const OptimizeReasoningSchema = OptimizeReasoningSchemaBase;
 export const DevelopLatentConceptsSchemaBase = z.object({
     text: z
         .string()
@@ -495,7 +625,10 @@ export const DevelopLatentConceptsSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     graphName: z
         .string()
         .min(1, "Graph name must be non-empty when provided")
@@ -519,12 +652,13 @@ export const DevelopLatentConceptsSchemaBase = z.object({
         "gpt-5.4",
         "gpt-5.4-mini",
     ])
-        .default("gpt-4o")
+        .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"),
 });
 export const DevelopLatentConceptsSchema = DevelopLatentConceptsSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
-    (data.graphName !== undefined && data.graphName.trim().length > 0), { message: "Provide either text, url, or graphName for analysis." });
+    (data.graphName !== undefined && data.graphName.trim().length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
 export const RetrieveContextForPromptFromGraphSchema = z.object({
     graphName: z
         .string()
@@ -573,7 +707,10 @@ export const GenerateResponsesFromGraphSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     prompt: z
         .string()
         .min(1, "Prompt is required")
@@ -592,12 +729,13 @@ export const GenerateResponsesFromGraphSchemaBase = z.object({
         "gpt-5.4",
         "gpt-5.4-mini",
     ])
-        .default("gpt-4o")
+        .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"),
 });
 export const GenerateResponsesFromGraphSchema = GenerateResponsesFromGraphSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
-    (data.graphName !== undefined && data.graphName.trim().length > 0), { message: "Provide either text, url, or graphName for analysis." });
+    (data.graphName !== undefined && data.graphName.trim().length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
 // This is used for adding options later to each tool
 export const GenerateGeneralGraphSchema = z.object({
     text: z
@@ -638,7 +776,7 @@ export const GenerateGeneralGraphSchema = z.object({
         .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)"),
 });
-/** Shared context item: one of { text }, { url }, or { graphName }. Used by overlap and difference tools. */
+/** Shared context item: one of { text }, { statements }, { url }, or { graphName }. Used by overlap and difference tools. */
 const contextItemTextUrlOrGraphSchema = z.union([
     z
         .object({
@@ -647,7 +785,19 @@ const contextItemTextUrlOrGraphSchema = z.union([
             .min(1, "Text is required for analysis")
             .describe("Text content - use new lines to separate statements (but not sentences)."),
     })
+        .strict()
         .describe("Context from plain text."),
+    z
+        .object({
+        statements: z
+            .array(z.string().min(1))
+            .min(1)
+            .describe("Short discrete statements, one unit of analysis each."),
+        categories: categoriesField,
+        timestamps: timestampsField,
+    })
+        .strict()
+        .describe("Context from short discrete statements. Categories and timestamps apply only when every context uses statements; otherwise the statements are joined into text."),
     z
         .object({
         url: z
@@ -656,6 +806,7 @@ const contextItemTextUrlOrGraphSchema = z.union([
             .url("Must be a valid URL")
             .describe("URL to fetch content from (or YouTube transcript)."),
     })
+        .strict()
         .describe("Context from a URL."),
     z
         .object({
@@ -664,13 +815,14 @@ const contextItemTextUrlOrGraphSchema = z.union([
             .min(1, "Graph name is required when provided")
             .describe(`Name of an existing ${brand.name} graph; its statements are retrieved and used as text.`),
     })
+        .strict()
         .describe(`Context from an existing ${brand.name} graph by name.`),
 ]);
 const GenerateOverlapGraphFromTextsSchemaBase = z.object({
     contexts: z
         .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 }, { url: string }, or { graphName: string }. Example: [{ text: '...' }, { url: 'https://...' }, { graphName: 'my-graph' }]."),
+        .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' }]."),
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
@@ -694,7 +846,7 @@ const GenerateDifferenceGraphFromTextsSchemaBase = z.object({
     contexts: z
         .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 }, { url: string }, or { graphName: string }. Example: [{ text: '...' }, { url: 'https://...' }, { graphName: 'my-graph' }]."),
+        .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' }]."),
     modifyAnalyzedText: z
         .enum(["none", "detectEntities", "extractEntitiesOnly"])
         .default("none")
@@ -1042,6 +1194,8 @@ export const GenerateSEOGraphSchema = z.object({
         .url()
         .optional()
         .describe("URL to fetch content from for SEO analysis. Provide either this or text, not both."),
+    statements: statementsField,
+    categories: categoriesField,
     contentToExtract: z
         .enum(["all", "header tags", "link tags"])
         .default("all")
@@ -1124,7 +1278,10 @@ export const DevelopTextToolSchemaBase = z.object({
         .string()
         .url()
         .optional()
-        .describe("URL to fetch content from or YouTube video URL to fetch transcript. Provide one of: text, url, or graphName."),
+        .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,
+    timestamps: timestampsField,
     graphName: z
         .string()
         .min(1, "Graph name must be non-empty when provided")
@@ -1156,12 +1313,13 @@ export const DevelopTextToolSchemaBase = z.object({
         "gpt-5.4",
         "gpt-5.4-mini",
     ])
-        .default("gpt-4o")
+        .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"),
 });
 export const DevelopTextToolSchema = DevelopTextToolSchemaBase.refine((data) => (data.text !== undefined && data.text.trim().length > 0) ||
     (data.url !== undefined && data.url.length > 0) ||
-    (data.graphName !== undefined && data.graphName.trim().length > 0), { message: "Provide either text, url, or graphName for analysis." });
+    (data.graphName !== undefined && data.graphName.trim().length > 0) ||
+    (data.statements !== undefined && data.statements.length > 0), { message: "Provide text, url, statements, or graphName for analysis." });
 export const ListGraphsSchema = z.object({
     nameContains: z
         .string()