@workglow/knowledge-base 0.0.115

package/dist/document/DocumentSchema.d.ts

@@ -0,0 +1,1203 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FromSchema } from "@workglow/util";
+/**
+ * Node kind discriminator for hierarchical document structure
+ */
+export declare const NodeKind: {
+    readonly DOCUMENT: "document";
+    readonly SECTION: "section";
+    readonly PARAGRAPH: "paragraph";
+    readonly SENTENCE: "sentence";
+    readonly TOPIC: "topic";
+};
+export type NodeKind = (typeof NodeKind)[keyof typeof NodeKind];
+/**
+ * Schema for source range of a node (character offsets)
+ */
+export declare const NodeRangeSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly startOffset: {
+            readonly type: "integer";
+            readonly title: "Start Offset";
+            readonly description: "Starting character offset";
+        };
+        readonly endOffset: {
+            readonly type: "integer";
+            readonly title: "End Offset";
+            readonly description: "Ending character offset";
+        };
+    };
+    readonly required: readonly ["startOffset", "endOffset"];
+    readonly additionalProperties: false;
+};
+export type NodeRange = FromSchema<typeof NodeRangeSchema>;
+/**
+ * Schema for named entity extracted from text
+ */
+export declare const EntitySchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly text: {
+            readonly type: "string";
+            readonly title: "Text";
+            readonly description: "Entity text";
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly title: "Type";
+            readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+        };
+        readonly score: {
+            readonly type: "number";
+            readonly title: "Score";
+            readonly description: "Confidence score";
+        };
+    };
+    readonly required: readonly ["text", "type", "score"];
+    readonly additionalProperties: false;
+};
+export type Entity = FromSchema<typeof EntitySchema>;
+/**
+ * Schema for enrichment data attached to a node
+ */
+export declare const NodeEnrichmentSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly summary: {
+            readonly type: "string";
+            readonly title: "Summary";
+            readonly description: "Summary of the node content";
+        };
+        readonly entities: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly text: {
+                        readonly type: "string";
+                        readonly title: "Text";
+                        readonly description: "Entity text";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly title: "Type";
+                        readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                    };
+                    readonly score: {
+                        readonly type: "number";
+                        readonly title: "Score";
+                        readonly description: "Confidence score";
+                    };
+                };
+                readonly required: readonly ["text", "type", "score"];
+                readonly additionalProperties: false;
+            };
+            readonly title: "Entities";
+            readonly description: "Named entities extracted from the node";
+        };
+        readonly keywords: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly title: "Keywords";
+            readonly description: "Keywords associated with the node";
+        };
+    };
+    readonly additionalProperties: false;
+};
+export type NodeEnrichment = FromSchema<typeof NodeEnrichmentSchema>;
+/**
+ * Schema for base document node fields (used for runtime validation)
+ * Note: Individual node types and DocumentNode union are defined as interfaces
+ * below because FromSchema cannot properly infer recursive discriminated unions.
+ */
+export declare const DocumentNodeBaseSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly nodeId: {
+            readonly type: "string";
+            readonly title: "Node ID";
+            readonly description: "Unique identifier for this node";
+        };
+        readonly kind: {
+            readonly type: "string";
+            readonly enum: ("document" | "section" | "paragraph" | "sentence" | "topic")[];
+            readonly title: "Kind";
+            readonly description: "Node type discriminator";
+        };
+        readonly range: {
+            readonly type: "object";
+            readonly properties: {
+                readonly startOffset: {
+                    readonly type: "integer";
+                    readonly title: "Start Offset";
+                    readonly description: "Starting character offset";
+                };
+                readonly endOffset: {
+                    readonly type: "integer";
+                    readonly title: "End Offset";
+                    readonly description: "Ending character offset";
+                };
+            };
+            readonly required: readonly ["startOffset", "endOffset"];
+            readonly additionalProperties: false;
+        };
+        readonly text: {
+            readonly type: "string";
+            readonly title: "Text";
+            readonly description: "Text content of the node";
+        };
+        readonly enrichment: {
+            readonly type: "object";
+            readonly properties: {
+                readonly summary: {
+                    readonly type: "string";
+                    readonly title: "Summary";
+                    readonly description: "Summary of the node content";
+                };
+                readonly entities: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: "string";
+                                readonly title: "Text";
+                                readonly description: "Entity text";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly title: "Type";
+                                readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                            };
+                            readonly score: {
+                                readonly type: "number";
+                                readonly title: "Score";
+                                readonly description: "Confidence score";
+                            };
+                        };
+                        readonly required: readonly ["text", "type", "score"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly title: "Entities";
+                    readonly description: "Named entities extracted from the node";
+                };
+                readonly keywords: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly title: "Keywords";
+                    readonly description: "Keywords associated with the node";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["nodeId", "kind", "range", "text"];
+    readonly additionalProperties: true;
+};
+/**
+ * Schema for document node (generic, for runtime validation)
+ * This is a simplified schema for task input/output validation.
+ * The actual TypeScript types use a proper discriminated union.
+ */
+export declare const DocumentNodeSchema: {
+    readonly type: "object";
+    readonly title: "Document Node";
+    readonly description: "A node in the hierarchical document tree";
+    readonly properties: {
+        readonly level: {
+            readonly type: "integer";
+            readonly title: "Level";
+            readonly description: "Header level for section nodes";
+        };
+        readonly title: {
+            readonly type: "string";
+            readonly title: "Title";
+            readonly description: "Section title";
+        };
+        readonly children: {
+            readonly type: "array";
+            readonly title: "Children";
+            readonly description: "Child nodes";
+        };
+        readonly nodeId: {
+            readonly type: "string";
+            readonly title: "Node ID";
+            readonly description: "Unique identifier for this node";
+        };
+        readonly kind: {
+            readonly type: "string";
+            readonly enum: ("document" | "section" | "paragraph" | "sentence" | "topic")[];
+            readonly title: "Kind";
+            readonly description: "Node type discriminator";
+        };
+        readonly range: {
+            readonly type: "object";
+            readonly properties: {
+                readonly startOffset: {
+                    readonly type: "integer";
+                    readonly title: "Start Offset";
+                    readonly description: "Starting character offset";
+                };
+                readonly endOffset: {
+                    readonly type: "integer";
+                    readonly title: "End Offset";
+                    readonly description: "Ending character offset";
+                };
+            };
+            readonly required: readonly ["startOffset", "endOffset"];
+            readonly additionalProperties: false;
+        };
+        readonly text: {
+            readonly type: "string";
+            readonly title: "Text";
+            readonly description: "Text content of the node";
+        };
+        readonly enrichment: {
+            readonly type: "object";
+            readonly properties: {
+                readonly summary: {
+                    readonly type: "string";
+                    readonly title: "Summary";
+                    readonly description: "Summary of the node content";
+                };
+                readonly entities: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: "string";
+                                readonly title: "Text";
+                                readonly description: "Entity text";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly title: "Type";
+                                readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                            };
+                            readonly score: {
+                                readonly type: "number";
+                                readonly title: "Score";
+                                readonly description: "Confidence score";
+                            };
+                        };
+                        readonly required: readonly ["text", "type", "score"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly title: "Entities";
+                    readonly description: "Named entities extracted from the node";
+                };
+                readonly keywords: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly title: "Keywords";
+                    readonly description: "Keywords associated with the node";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["nodeId", "kind", "range", "text"];
+    readonly additionalProperties: false;
+};
+/**
+ * Schema for paragraph node
+ */
+export declare const ParagraphNodeSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly kind: {
+            readonly type: "string";
+            readonly const: "paragraph";
+            readonly title: "Kind";
+            readonly description: "Node type discriminator";
+        };
+        readonly nodeId: {
+            readonly type: "string";
+            readonly title: "Node ID";
+            readonly description: "Unique identifier for this node";
+        };
+        readonly range: {
+            readonly type: "object";
+            readonly properties: {
+                readonly startOffset: {
+                    readonly type: "integer";
+                    readonly title: "Start Offset";
+                    readonly description: "Starting character offset";
+                };
+                readonly endOffset: {
+                    readonly type: "integer";
+                    readonly title: "End Offset";
+                    readonly description: "Ending character offset";
+                };
+            };
+            readonly required: readonly ["startOffset", "endOffset"];
+            readonly additionalProperties: false;
+        };
+        readonly text: {
+            readonly type: "string";
+            readonly title: "Text";
+            readonly description: "Text content of the node";
+        };
+        readonly enrichment: {
+            readonly type: "object";
+            readonly properties: {
+                readonly summary: {
+                    readonly type: "string";
+                    readonly title: "Summary";
+                    readonly description: "Summary of the node content";
+                };
+                readonly entities: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: "string";
+                                readonly title: "Text";
+                                readonly description: "Entity text";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly title: "Type";
+                                readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                            };
+                            readonly score: {
+                                readonly type: "number";
+                                readonly title: "Score";
+                                readonly description: "Confidence score";
+                            };
+                        };
+                        readonly required: readonly ["text", "type", "score"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly title: "Entities";
+                    readonly description: "Named entities extracted from the node";
+                };
+                readonly keywords: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly title: "Keywords";
+                    readonly description: "Keywords associated with the node";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["nodeId", "kind", "range", "text"];
+    readonly additionalProperties: false;
+};
+/**
+ * Schema for sentence node
+ */
+export declare const SentenceNodeSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly kind: {
+            readonly type: "string";
+            readonly const: "sentence";
+            readonly title: "Kind";
+            readonly description: "Node type discriminator";
+        };
+        readonly nodeId: {
+            readonly type: "string";
+            readonly title: "Node ID";
+            readonly description: "Unique identifier for this node";
+        };
+        readonly range: {
+            readonly type: "object";
+            readonly properties: {
+                readonly startOffset: {
+                    readonly type: "integer";
+                    readonly title: "Start Offset";
+                    readonly description: "Starting character offset";
+                };
+                readonly endOffset: {
+                    readonly type: "integer";
+                    readonly title: "End Offset";
+                    readonly description: "Ending character offset";
+                };
+            };
+            readonly required: readonly ["startOffset", "endOffset"];
+            readonly additionalProperties: false;
+        };
+        readonly text: {
+            readonly type: "string";
+            readonly title: "Text";
+            readonly description: "Text content of the node";
+        };
+        readonly enrichment: {
+            readonly type: "object";
+            readonly properties: {
+                readonly summary: {
+                    readonly type: "string";
+                    readonly title: "Summary";
+                    readonly description: "Summary of the node content";
+                };
+                readonly entities: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: "string";
+                                readonly title: "Text";
+                                readonly description: "Entity text";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly title: "Type";
+                                readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                            };
+                            readonly score: {
+                                readonly type: "number";
+                                readonly title: "Score";
+                                readonly description: "Confidence score";
+                            };
+                        };
+                        readonly required: readonly ["text", "type", "score"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly title: "Entities";
+                    readonly description: "Named entities extracted from the node";
+                };
+                readonly keywords: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly title: "Keywords";
+                    readonly description: "Keywords associated with the node";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["nodeId", "kind", "range", "text"];
+    readonly additionalProperties: false;
+};
+/**
+ * Schema for section node
+ */
+export declare const SectionNodeSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly kind: {
+            readonly type: "string";
+            readonly const: "section";
+            readonly title: "Kind";
+            readonly description: "Node type discriminator";
+        };
+        readonly level: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 6;
+            readonly title: "Level";
+            readonly description: "Header level (1-6 for markdown)";
+        };
+        readonly title: {
+            readonly type: "string";
+            readonly title: "Title";
+            readonly description: "Section title";
+        };
+        readonly children: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly title: "Document Node";
+                readonly description: "A node in the hierarchical document tree";
+                readonly properties: {
+                    readonly level: {
+                        readonly type: "integer";
+                        readonly title: "Level";
+                        readonly description: "Header level for section nodes";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly title: "Title";
+                        readonly description: "Section title";
+                    };
+                    readonly children: {
+                        readonly type: "array";
+                        readonly title: "Children";
+                        readonly description: "Child nodes";
+                    };
+                    readonly nodeId: {
+                        readonly type: "string";
+                        readonly title: "Node ID";
+                        readonly description: "Unique identifier for this node";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly enum: ("document" | "section" | "paragraph" | "sentence" | "topic")[];
+                        readonly title: "Kind";
+                        readonly description: "Node type discriminator";
+                    };
+                    readonly range: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly startOffset: {
+                                readonly type: "integer";
+                                readonly title: "Start Offset";
+                                readonly description: "Starting character offset";
+                            };
+                            readonly endOffset: {
+                                readonly type: "integer";
+                                readonly title: "End Offset";
+                                readonly description: "Ending character offset";
+                            };
+                        };
+                        readonly required: readonly ["startOffset", "endOffset"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly text: {
+                        readonly type: "string";
+                        readonly title: "Text";
+                        readonly description: "Text content of the node";
+                    };
+                    readonly enrichment: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly summary: {
+                                readonly type: "string";
+                                readonly title: "Summary";
+                                readonly description: "Summary of the node content";
+                            };
+                            readonly entities: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly text: {
+                                            readonly type: "string";
+                                            readonly title: "Text";
+                                            readonly description: "Entity text";
+                                        };
+                                        readonly type: {
+                                            readonly type: "string";
+                                            readonly title: "Type";
+                                            readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                                        };
+                                        readonly score: {
+                                            readonly type: "number";
+                                            readonly title: "Score";
+                                            readonly description: "Confidence score";
+                                        };
+                                    };
+                                    readonly required: readonly ["text", "type", "score"];
+                                    readonly additionalProperties: false;
+                                };
+                                readonly title: "Entities";
+                                readonly description: "Named entities extracted from the node";
+                            };
+                            readonly keywords: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly title: "Keywords";
+                                readonly description: "Keywords associated with the node";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly required: readonly ["nodeId", "kind", "range", "text"];
+                readonly additionalProperties: false;
+            };
+            readonly title: "Children";
+            readonly description: "Child nodes";
+        };
+        readonly nodeId: {
+            readonly type: "string";
+            readonly title: "Node ID";
+            readonly description: "Unique identifier for this node";
+        };
+        readonly range: {
+            readonly type: "object";
+            readonly properties: {
+                readonly startOffset: {
+                    readonly type: "integer";
+                    readonly title: "Start Offset";
+                    readonly description: "Starting character offset";
+                };
+                readonly endOffset: {
+                    readonly type: "integer";
+                    readonly title: "End Offset";
+                    readonly description: "Ending character offset";
+                };
+            };
+            readonly required: readonly ["startOffset", "endOffset"];
+            readonly additionalProperties: false;
+        };
+        readonly text: {
+            readonly type: "string";
+            readonly title: "Text";
+            readonly description: "Text content of the node";
+        };
+        readonly enrichment: {
+            readonly type: "object";
+            readonly properties: {
+                readonly summary: {
+                    readonly type: "string";
+                    readonly title: "Summary";
+                    readonly description: "Summary of the node content";
+                };
+                readonly entities: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: "string";
+                                readonly title: "Text";
+                                readonly description: "Entity text";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly title: "Type";
+                                readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                            };
+                            readonly score: {
+                                readonly type: "number";
+                                readonly title: "Score";
+                                readonly description: "Confidence score";
+                            };
+                        };
+                        readonly required: readonly ["text", "type", "score"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly title: "Entities";
+                    readonly description: "Named entities extracted from the node";
+                };
+                readonly keywords: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly title: "Keywords";
+                    readonly description: "Keywords associated with the node";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["nodeId", "kind", "range", "text", "level", "title", "children"];
+    readonly additionalProperties: false;
+};
+/**
+ * Schema for topic node
+ */
+export declare const TopicNodeSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly kind: {
+            readonly type: "string";
+            readonly const: "topic";
+            readonly title: "Kind";
+            readonly description: "Node type discriminator";
+        };
+        readonly children: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly title: "Document Node";
+                readonly description: "A node in the hierarchical document tree";
+                readonly properties: {
+                    readonly level: {
+                        readonly type: "integer";
+                        readonly title: "Level";
+                        readonly description: "Header level for section nodes";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly title: "Title";
+                        readonly description: "Section title";
+                    };
+                    readonly children: {
+                        readonly type: "array";
+                        readonly title: "Children";
+                        readonly description: "Child nodes";
+                    };
+                    readonly nodeId: {
+                        readonly type: "string";
+                        readonly title: "Node ID";
+                        readonly description: "Unique identifier for this node";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly enum: ("document" | "section" | "paragraph" | "sentence" | "topic")[];
+                        readonly title: "Kind";
+                        readonly description: "Node type discriminator";
+                    };
+                    readonly range: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly startOffset: {
+                                readonly type: "integer";
+                                readonly title: "Start Offset";
+                                readonly description: "Starting character offset";
+                            };
+                            readonly endOffset: {
+                                readonly type: "integer";
+                                readonly title: "End Offset";
+                                readonly description: "Ending character offset";
+                            };
+                        };
+                        readonly required: readonly ["startOffset", "endOffset"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly text: {
+                        readonly type: "string";
+                        readonly title: "Text";
+                        readonly description: "Text content of the node";
+                    };
+                    readonly enrichment: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly summary: {
+                                readonly type: "string";
+                                readonly title: "Summary";
+                                readonly description: "Summary of the node content";
+                            };
+                            readonly entities: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly text: {
+                                            readonly type: "string";
+                                            readonly title: "Text";
+                                            readonly description: "Entity text";
+                                        };
+                                        readonly type: {
+                                            readonly type: "string";
+                                            readonly title: "Type";
+                                            readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                                        };
+                                        readonly score: {
+                                            readonly type: "number";
+                                            readonly title: "Score";
+                                            readonly description: "Confidence score";
+                                        };
+                                    };
+                                    readonly required: readonly ["text", "type", "score"];
+                                    readonly additionalProperties: false;
+                                };
+                                readonly title: "Entities";
+                                readonly description: "Named entities extracted from the node";
+                            };
+                            readonly keywords: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly title: "Keywords";
+                                readonly description: "Keywords associated with the node";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly required: readonly ["nodeId", "kind", "range", "text"];
+                readonly additionalProperties: false;
+            };
+            readonly title: "Children";
+            readonly description: "Child nodes";
+        };
+        readonly nodeId: {
+            readonly type: "string";
+            readonly title: "Node ID";
+            readonly description: "Unique identifier for this node";
+        };
+        readonly range: {
+            readonly type: "object";
+            readonly properties: {
+                readonly startOffset: {
+                    readonly type: "integer";
+                    readonly title: "Start Offset";
+                    readonly description: "Starting character offset";
+                };
+                readonly endOffset: {
+                    readonly type: "integer";
+                    readonly title: "End Offset";
+                    readonly description: "Ending character offset";
+                };
+            };
+            readonly required: readonly ["startOffset", "endOffset"];
+            readonly additionalProperties: false;
+        };
+        readonly text: {
+            readonly type: "string";
+            readonly title: "Text";
+            readonly description: "Text content of the node";
+        };
+        readonly enrichment: {
+            readonly type: "object";
+            readonly properties: {
+                readonly summary: {
+                    readonly type: "string";
+                    readonly title: "Summary";
+                    readonly description: "Summary of the node content";
+                };
+                readonly entities: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: "string";
+                                readonly title: "Text";
+                                readonly description: "Entity text";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly title: "Type";
+                                readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                            };
+                            readonly score: {
+                                readonly type: "number";
+                                readonly title: "Score";
+                                readonly description: "Confidence score";
+                            };
+                        };
+                        readonly required: readonly ["text", "type", "score"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly title: "Entities";
+                    readonly description: "Named entities extracted from the node";
+                };
+                readonly keywords: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly title: "Keywords";
+                    readonly description: "Keywords associated with the node";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["nodeId", "kind", "range", "text", "children"];
+    readonly additionalProperties: false;
+};
+/**
+ * Schema for document root node
+ */
+export declare const DocumentRootNodeSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly kind: {
+            readonly type: "string";
+            readonly const: "document";
+            readonly title: "Kind";
+            readonly description: "Node type discriminator";
+        };
+        readonly title: {
+            readonly type: "string";
+            readonly title: "Title";
+            readonly description: "Document title";
+        };
+        readonly children: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly title: "Document Node";
+                readonly description: "A node in the hierarchical document tree";
+                readonly properties: {
+                    readonly level: {
+                        readonly type: "integer";
+                        readonly title: "Level";
+                        readonly description: "Header level for section nodes";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly title: "Title";
+                        readonly description: "Section title";
+                    };
+                    readonly children: {
+                        readonly type: "array";
+                        readonly title: "Children";
+                        readonly description: "Child nodes";
+                    };
+                    readonly nodeId: {
+                        readonly type: "string";
+                        readonly title: "Node ID";
+                        readonly description: "Unique identifier for this node";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly enum: ("document" | "section" | "paragraph" | "sentence" | "topic")[];
+                        readonly title: "Kind";
+                        readonly description: "Node type discriminator";
+                    };
+                    readonly range: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly startOffset: {
+                                readonly type: "integer";
+                                readonly title: "Start Offset";
+                                readonly description: "Starting character offset";
+                            };
+                            readonly endOffset: {
+                                readonly type: "integer";
+                                readonly title: "End Offset";
+                                readonly description: "Ending character offset";
+                            };
+                        };
+                        readonly required: readonly ["startOffset", "endOffset"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly text: {
+                        readonly type: "string";
+                        readonly title: "Text";
+                        readonly description: "Text content of the node";
+                    };
+                    readonly enrichment: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly summary: {
+                                readonly type: "string";
+                                readonly title: "Summary";
+                                readonly description: "Summary of the node content";
+                            };
+                            readonly entities: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly text: {
+                                            readonly type: "string";
+                                            readonly title: "Text";
+                                            readonly description: "Entity text";
+                                        };
+                                        readonly type: {
+                                            readonly type: "string";
+                                            readonly title: "Type";
+                                            readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                                        };
+                                        readonly score: {
+                                            readonly type: "number";
+                                            readonly title: "Score";
+                                            readonly description: "Confidence score";
+                                        };
+                                    };
+                                    readonly required: readonly ["text", "type", "score"];
+                                    readonly additionalProperties: false;
+                                };
+                                readonly title: "Entities";
+                                readonly description: "Named entities extracted from the node";
+                            };
+                            readonly keywords: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly title: "Keywords";
+                                readonly description: "Keywords associated with the node";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly required: readonly ["nodeId", "kind", "range", "text"];
+                readonly additionalProperties: false;
+            };
+            readonly title: "Children";
+            readonly description: "Child nodes";
+        };
+        readonly nodeId: {
+            readonly type: "string";
+            readonly title: "Node ID";
+            readonly description: "Unique identifier for this node";
+        };
+        readonly range: {
+            readonly type: "object";
+            readonly properties: {
+                readonly startOffset: {
+                    readonly type: "integer";
+                    readonly title: "Start Offset";
+                    readonly description: "Starting character offset";
+                };
+                readonly endOffset: {
+                    readonly type: "integer";
+                    readonly title: "End Offset";
+                    readonly description: "Ending character offset";
+                };
+            };
+            readonly required: readonly ["startOffset", "endOffset"];
+            readonly additionalProperties: false;
+        };
+        readonly text: {
+            readonly type: "string";
+            readonly title: "Text";
+            readonly description: "Text content of the node";
+        };
+        readonly enrichment: {
+            readonly type: "object";
+            readonly properties: {
+                readonly summary: {
+                    readonly type: "string";
+                    readonly title: "Summary";
+                    readonly description: "Summary of the node content";
+                };
+                readonly entities: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: "string";
+                                readonly title: "Text";
+                                readonly description: "Entity text";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly title: "Type";
+                                readonly description: "Entity type (e.g., PERSON, ORG, LOC)";
+                            };
+                            readonly score: {
+                                readonly type: "number";
+                                readonly title: "Score";
+                                readonly description: "Confidence score";
+                            };
+                        };
+                        readonly required: readonly ["text", "type", "score"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly title: "Entities";
+                    readonly description: "Named entities extracted from the node";
+                };
+                readonly keywords: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly title: "Keywords";
+                    readonly description: "Keywords associated with the node";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["nodeId", "kind", "range", "text", "title", "children"];
+    readonly additionalProperties: false;
+};
+/**
+ * Base document node fields
+ */
+interface DocumentNodeBase {
+    readonly nodeId: string;
+    readonly kind: NodeKind;
+    readonly range: NodeRange;
+    readonly text: string;
+    readonly enrichment?: NodeEnrichment;
+}
+/**
+ * Document root node
+ */
+export interface DocumentRootNode extends DocumentNodeBase {
+    readonly kind: typeof NodeKind.DOCUMENT;
+    readonly title: string;
+    readonly children: DocumentNode[];
+}
+/**
+ * Section node (from markdown headers or structural divisions)
+ */
+export interface SectionNode extends DocumentNodeBase {
+    readonly kind: typeof NodeKind.SECTION;
+    readonly level: number;
+    readonly title: string;
+    readonly children: DocumentNode[];
+}
+/**
+ * Paragraph node
+ */
+export interface ParagraphNode extends DocumentNodeBase {
+    readonly kind: typeof NodeKind.PARAGRAPH;
+}
+/**
+ * Sentence node (optional fine-grained segmentation)
+ */
+export interface SentenceNode extends DocumentNodeBase {
+    readonly kind: typeof NodeKind.SENTENCE;
+}
+/**
+ * Topic segment node (from TopicSegmenter)
+ */
+export interface TopicNode extends DocumentNodeBase {
+    readonly kind: typeof NodeKind.TOPIC;
+    readonly children: DocumentNode[];
+}
+/**
+ * Discriminated union of all document node types
+ */
+export type DocumentNode = DocumentRootNode | SectionNode | ParagraphNode | SentenceNode | TopicNode;
+/**
+ * Schema for token budget configuration
+ */
+export declare const TokenBudgetSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly maxTokensPerChunk: {
+            readonly type: "integer";
+            readonly title: "Max Tokens Per Chunk";
+            readonly description: "Maximum tokens allowed per chunk";
+        };
+        readonly overlapTokens: {
+            readonly type: "integer";
+            readonly title: "Overlap Tokens";
+            readonly description: "Number of tokens to overlap between chunks";
+        };
+        readonly reservedTokens: {
+            readonly type: "integer";
+            readonly title: "Reserved Tokens";
+            readonly description: "Tokens reserved for metadata or context";
+        };
+    };
+    readonly required: readonly ["maxTokensPerChunk", "overlapTokens", "reservedTokens"];
+    readonly additionalProperties: false;
+};
+export type TokenBudget = FromSchema<typeof TokenBudgetSchema>;
+/**
+ * Schema for document metadata
+ */
+export declare const DocumentMetadataSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly title: {
+            readonly type: "string";
+            readonly title: "Title";
+            readonly description: "Document title";
+        };
+        readonly sourceUri: {
+            readonly type: "string";
+            readonly title: "Source URI";
+            readonly description: "Original source URI of the document";
+        };
+        readonly createdAt: {
+            readonly type: "string";
+            readonly title: "Created At";
+            readonly description: "ISO timestamp of creation";
+        };
+    };
+    readonly required: readonly ["title"];
+    readonly additionalProperties: true;
+};
+export type DocumentMetadata = FromSchema<typeof DocumentMetadataSchema>;
+export {};
+//# sourceMappingURL=DocumentSchema.d.ts.map