@workglow/knowledge-base 0.0.115

package/dist/document/DocumentSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentSchema.d.ts","sourceRoot":"","sources":["../../src/document/DocumentSchema.ts"],"names":[],"mappings":"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"}

package/dist/document/DocumentStorageSchema.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ITabularStorage } from "@workglow/storage";
+import { TypedArraySchemaOptions, type FromSchema } from "@workglow/util";
+/**
+ * Schema for storing documents in tabular storage
+ */
+export declare const DocumentStorageSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly doc_id: {
+            readonly type: "string";
+            readonly "x-auto-generated": true;
+            readonly title: "Document ID";
+            readonly description: "Unique identifier for the document";
+        };
+        readonly data: {
+            readonly type: "string";
+            readonly title: "Document Data";
+            readonly description: "JSON-serialized document";
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly title: "Metadata";
+            readonly description: "Metadata of the document";
+        };
+    };
+    readonly required: readonly ["doc_id", "data"];
+    readonly additionalProperties: true;
+};
+export type DocumentStorageSchema = typeof DocumentStorageSchema;
+export declare const DocumentStorageKey: readonly ["doc_id"];
+export type DocumentStorageKey = typeof DocumentStorageKey;
+export type DocumentStorageEntity = FromSchema<DocumentStorageSchema, TypedArraySchemaOptions>;
+/**
+ * Type for inserting documents - doc_id is optional (auto-generated)
+ */
+export type InsertDocumentStorageEntity = Omit<DocumentStorageEntity, "doc_id"> & Partial<Pick<DocumentStorageEntity, "doc_id">>;
+export type DocumentTabularStorage = ITabularStorage<typeof DocumentStorageSchema, DocumentStorageKey, DocumentStorageEntity>;
+//# sourceMappingURL=DocumentStorageSchema.d.ts.map

package/dist/document/DocumentStorageSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentStorageSchema.d.ts","sourceRoot":"","sources":["../../src/document/DocumentStorageSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,uBAAuB,EAEvB,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;CAsBO,CAAC;AAC1C,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE,eAAO,MAAM,kBAAkB,qBAAsB,CAAC;AACtD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,qBAAqB,EAAE,uBAAuB,CAAC,CAAC;AAE/F;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,GAC7E,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEjD,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAClD,OAAO,qBAAqB,EAC5B,kBAAkB,EAClB,qBAAqB,CACtB,CAAC"}

package/dist/document/StructuralParser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type DocumentRootNode } from "./DocumentSchema";
+/**
+ * Parse markdown into a hierarchical DocumentNode tree
+ */
+export declare class StructuralParser {
+    /**
+     * Parse markdown text into a hierarchical document tree
+     */
+    static parseMarkdown(doc_id: string, text: string, title: string): Promise<DocumentRootNode>;
+    /**
+     * Parse plain text into a hierarchical document tree
+     * Splits by double newlines to create paragraphs
+     */
+    static parsePlainText(doc_id: string, text: string, title: string): Promise<DocumentRootNode>;
+    /**
+     * Auto-detect format and parse
+     */
+    static parse(doc_id: string, text: string, title: string, format?: "markdown" | "text"): Promise<DocumentRootNode>;
+    /**
+     * Check if text contains markdown header patterns
+     * Looks for lines starting with 1-6 hash symbols followed by whitespace
+     */
+    private static looksLikeMarkdown;
+}
+//# sourceMappingURL=StructuralParser.d.ts.map

package/dist/document/StructuralParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructuralParser.d.ts","sourceRoot":"","sources":["../../src/document/StructuralParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;WACU,aAAa,CACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC;IAqH5B;;;OAGG;WACU,cAAc,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC;IAoE5B;;OAEG;IACH,MAAM,CAAC,KAAK,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAC3B,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAIjC"}

package/dist/knowledge-base/InMemoryKnowledgeBaseRepository.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { KnowledgeBaseRepository } from "./KnowledgeBaseRepository";
+/**
+ * In-memory implementation of a knowledge base repository.
+ */
+export declare class InMemoryKnowledgeBaseRepository extends KnowledgeBaseRepository {
+    constructor();
+}
+//# sourceMappingURL=InMemoryKnowledgeBaseRepository.d.ts.map

package/dist/knowledge-base/InMemoryKnowledgeBaseRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryKnowledgeBaseRepository.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/InMemoryKnowledgeBaseRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,uBAAuB;;CAI3E"}

package/dist/knowledge-base/KnowledgeBase.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { HybridSearchOptions, VectorSearchOptions } from "@workglow/storage";
+import type { TypedArray } from "@workglow/util";
+import type { ChunkRecord } from "../chunk/ChunkSchema";
+import type { ChunkSearchResult, ChunkVectorEntity, ChunkVectorStorage, InsertChunkVectorEntity } from "../chunk/ChunkVectorStorageSchema";
+import { Document } from "../document/Document";
+import type { DocumentNode } from "../document/DocumentSchema";
+import type { DocumentTabularStorage } from "../document/DocumentStorageSchema";
+/**
+ * Unified KnowledgeBase that owns both document and vector storage,
+ * providing lifecycle management and cascading deletes.
+ */
+export declare class KnowledgeBase {
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+    private tabularStorage;
+    private chunkStorage;
+    constructor(name: string, documentStorage: DocumentTabularStorage, chunkStorage: ChunkVectorStorage, title?: string, description?: string);
+    /**
+     * Upsert a document.
+     * @returns The document with the generated doc_id if it was auto-generated
+     */
+    upsertDocument(document: Document): Promise<Document>;
+    /**
+     * Get a document by ID
+     */
+    getDocument(doc_id: string): Promise<Document | undefined>;
+    /**
+     * Delete a document and all its chunks (cascading delete).
+     */
+    deleteDocument(doc_id: string): Promise<void>;
+    /**
+     * List all document IDs
+     */
+    listDocuments(): Promise<string[]>;
+    /**
+     * Get a specific node by ID from a document
+     */
+    getNode(doc_id: string, nodeId: string): Promise<DocumentNode | undefined>;
+    /**
+     * Get ancestors of a node (from root to target node)
+     */
+    getAncestors(doc_id: string, nodeId: string): Promise<DocumentNode[]>;
+    /**
+     * Upsert a single chunk vector entity
+     */
+    upsertChunk(chunk: InsertChunkVectorEntity): Promise<ChunkVectorEntity>;
+    /**
+     * Upsert multiple chunk vector entities
+     */
+    upsertChunksBulk(chunks: InsertChunkVectorEntity[]): Promise<ChunkVectorEntity[]>;
+    /**
+     * Delete all chunks for a specific document
+     */
+    deleteChunksForDocument(doc_id: string): Promise<void>;
+    /**
+     * Get all chunks for a specific document
+     */
+    getChunksForDocument(doc_id: string): Promise<ChunkVectorEntity[]>;
+    /**
+     * Search for similar chunks using vector similarity
+     */
+    similaritySearch(query: TypedArray, options?: VectorSearchOptions<ChunkRecord>): Promise<ChunkSearchResult[]>;
+    /**
+     * Hybrid search combining vector similarity and full-text search
+     */
+    hybridSearch(query: TypedArray, options: HybridSearchOptions<ChunkRecord>): Promise<ChunkSearchResult[]>;
+    /**
+     * Prepare a document for re-indexing: deletes all chunks but keeps the document.
+     * @returns The document if found, undefined otherwise
+     */
+    prepareReindex(doc_id: string): Promise<Document | undefined>;
+    /**
+     * Setup the underlying databases
+     */
+    setupDatabase(): Promise<void>;
+    /**
+     * Destroy storage instances
+     */
+    destroy(): void;
+    /**
+     * Get a chunk by ID
+     */
+    getChunk(chunk_id: string): Promise<ChunkVectorEntity | undefined>;
+    /**
+     * Store a single chunk (alias for upsertChunk)
+     */
+    put(chunk: InsertChunkVectorEntity): Promise<ChunkVectorEntity>;
+    /**
+     * Store multiple chunks (alias for upsertChunksBulk)
+     */
+    putBulk(chunks: InsertChunkVectorEntity[]): Promise<ChunkVectorEntity[]>;
+    /**
+     * Get all chunks
+     */
+    getAllChunks(): Promise<ChunkVectorEntity[] | undefined>;
+    /**
+     * Get chunk count
+     */
+    chunkCount(): Promise<number>;
+    /**
+     * Clear all chunks
+     */
+    clearChunks(): Promise<void>;
+    /**
+     * Get vector dimensions
+     */
+    getVectorDimensions(): number;
+    /**
+     * Get chunks from the document JSON (not from vector storage)
+     */
+    getDocumentChunks(doc_id: string): Promise<ChunkRecord[]>;
+    /**
+     * Find chunks in document JSON that contain a specific nodeId in their path
+     */
+    findChunksByNodeId(doc_id: string, nodeId: string): Promise<ChunkRecord[]>;
+}
+//# sourceMappingURL=KnowledgeBase.d.ts.map

package/dist/knowledge-base/KnowledgeBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeBase.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBase.ts"],"names":[],"mappings":"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"}

package/dist/knowledge-base/KnowledgeBaseRegistry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { KnowledgeBase } from "./KnowledgeBase";
+import { KnowledgeBaseRepository } from "./KnowledgeBaseRepository";
+/**
+ * Service token for the knowledge base registry
+ * Maps knowledge base IDs to KnowledgeBase instances
+ */
+export declare const KNOWLEDGE_BASES: import("@workglow/util").ServiceToken<Map<string, KnowledgeBase>>;
+/**
+ * Service token for the knowledge base repository
+ */
+export declare const KNOWLEDGE_BASE_REPOSITORY: import("@workglow/util").ServiceToken<KnowledgeBaseRepository>;
+/**
+ * Gets the global knowledge base registry
+ */
+export declare function getGlobalKnowledgeBases(): Map<string, KnowledgeBase>;
+/**
+ * Gets the global knowledge base repository instance
+ */
+export declare function getGlobalKnowledgeBaseRepository(): KnowledgeBaseRepository;
+/**
+ * Sets the global knowledge base repository instance
+ */
+export declare function setGlobalKnowledgeBaseRepository(repository: KnowledgeBaseRepository): void;
+/**
+ * Registers a knowledge base globally by ID.
+ * Adds to both the live Map and the persistent repository.
+ */
+export declare function registerKnowledgeBase(id: string, kb: KnowledgeBase): Promise<void>;
+/**
+ * Gets a knowledge base by ID from the global registry
+ */
+export declare function getKnowledgeBase(id: string): KnowledgeBase | undefined;
+//# sourceMappingURL=KnowledgeBaseRegistry.d.ts.map

package/dist/knowledge-base/KnowledgeBaseRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeBaseRegistry.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBaseRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE;;;GAGG;AACH,eAAO,MAAM,eAAe,mEAC+C,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB,gEACoC,CAAC;AAoB3E;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAEpE;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,uBAAuB,CAE1E;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAE1F;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtE"}

package/dist/knowledge-base/KnowledgeBaseRepository.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type BaseTabularStorage } from "@workglow/storage";
+import { EventEmitter, type EventParameters } from "@workglow/util";
+import { KnowledgeBasePrimaryKeyNames, type KnowledgeBaseRecord, KnowledgeBaseRecordSchema } from "./KnowledgeBaseSchema";
+/**
+ * Events that can be emitted by the KnowledgeBaseRepository
+ */
+export type KnowledgeBaseEventListeners = {
+    knowledge_base_added: (record: KnowledgeBaseRecord) => void;
+    knowledge_base_removed: (record: KnowledgeBaseRecord) => void;
+    knowledge_base_updated: (record: KnowledgeBaseRecord) => void;
+};
+export type KnowledgeBaseEvents = keyof KnowledgeBaseEventListeners;
+export type KnowledgeBaseEventListener<Event extends KnowledgeBaseEvents> = KnowledgeBaseEventListeners[Event];
+export type KnowledgeBaseEventParameters<Event extends KnowledgeBaseEvents> = EventParameters<KnowledgeBaseEventListeners, Event>;
+/**
+ * Repository for persisting KnowledgeBase metadata to tabular storage.
+ * Follows the same pattern as ModelRepository.
+ */
+export declare class KnowledgeBaseRepository {
+    /**
+     * Storage for KnowledgeBase records
+     */
+    protected readonly storage: BaseTabularStorage<typeof KnowledgeBaseRecordSchema, typeof KnowledgeBasePrimaryKeyNames>;
+    constructor(storage: BaseTabularStorage<typeof KnowledgeBaseRecordSchema, typeof KnowledgeBasePrimaryKeyNames>);
+    /** Event emitter for repository events */
+    protected events: EventEmitter<KnowledgeBaseEventListeners>;
+    /**
+     * Sets up the database for the repository.
+     * Must be called before using any other methods.
+     */
+    setupDatabase(): Promise<void>;
+    /**
+     * Registers an event listener for the specified event
+     */
+    on<Event extends KnowledgeBaseEvents>(name: Event, fn: KnowledgeBaseEventListener<Event>): void;
+    /**
+     * Removes an event listener for the specified event
+     */
+    off<Event extends KnowledgeBaseEvents>(name: Event, fn: KnowledgeBaseEventListener<Event>): void;
+    /**
+     * Adds an event listener that will only be called once
+     */
+    once<Event extends KnowledgeBaseEvents>(name: Event, fn: KnowledgeBaseEventListener<Event>): void;
+    /**
+     * Returns when the event was emitted (promise form of once)
+     */
+    waitOn<Event extends KnowledgeBaseEvents>(name: Event): Promise<import("@workglow/util").EmittedReturnType<KnowledgeBaseEventListeners, Event>>;
+    /**
+     * Adds a new knowledge base record to the repository
+     */
+    addKnowledgeBase(record: KnowledgeBaseRecord): Promise<KnowledgeBaseRecord>;
+    /**
+     * Removes a knowledge base record from the repository
+     */
+    removeKnowledgeBase(kb_id: string): Promise<void>;
+    /**
+     * Retrieves a knowledge base record by ID
+     */
+    getKnowledgeBase(kb_id: string): Promise<KnowledgeBaseRecord | undefined>;
+    /**
+     * Enumerates all knowledge base records
+     */
+    enumerateAll(): Promise<KnowledgeBaseRecord[]>;
+    /**
+     * Gets the total number of knowledge base records
+     */
+    size(): Promise<number>;
+}
+//# sourceMappingURL=KnowledgeBaseRepository.d.ts.map

package/dist/knowledge-base/KnowledgeBaseRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeBaseRepository.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBaseRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EACL,4BAA4B,EAC5B,KAAK,mBAAmB,EACxB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AAEH,MAAM,MAAM,2BAA2B,GAAG;IACxC,oBAAoB,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D,sBAAsB,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC9D,sBAAsB,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,2BAA2B,CAAC;AAEpE,MAAM,MAAM,0BAA0B,CAAC,KAAK,SAAS,mBAAmB,IACtE,2BAA2B,CAAC,KAAK,CAAC,CAAC;AAErC,MAAM,MAAM,4BAA4B,CAAC,KAAK,SAAS,mBAAmB,IAAI,eAAe,CAC3F,2BAA2B,EAC3B,KAAK,CACN,CAAC;AAEF;;;GAGG;AACH,qBAAa,uBAAuB;IAClC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAC5C,OAAO,yBAAyB,EAChC,OAAO,4BAA4B,CACpC,CAAC;gBAGA,OAAO,EAAE,kBAAkB,CACzB,OAAO,yBAAyB,EAChC,OAAO,4BAA4B,CACpC;IAKH,0CAA0C;IAC1C,SAAS,CAAC,MAAM,4CAAmD;IAEnE;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;OAEG;IACH,EAAE,CAAC,KAAK,SAAS,mBAAmB,EAClC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC;IAKvC;;OAEG;IACH,GAAG,CAAC,KAAK,SAAS,mBAAmB,EACnC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC;IAKvC;;OAEG;IACH,IAAI,CAAC,KAAK,SAAS,mBAAmB,EACpC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC;IAKvC;;OAEG;IACH,MAAM,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK;IAIrD;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMjF;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAM/E;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAMpD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAG9B"}

package/dist/knowledge-base/KnowledgeBaseSchema.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FromSchema } from "@workglow/util";
+/**
+ * Schema for persisting KnowledgeBase metadata to tabular storage.
+ */
+export declare const KnowledgeBaseRecordSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly kb_id: {
+            readonly type: "string";
+        };
+        readonly title: {
+            readonly type: "string";
+        };
+        readonly description: {
+            readonly type: "string";
+        };
+        readonly vector_dimensions: {
+            readonly type: "integer";
+        };
+        readonly document_table: {
+            readonly type: "string";
+        };
+        readonly chunk_table: {
+            readonly type: "string";
+        };
+        readonly created_at: {
+            readonly type: "string";
+        };
+        readonly updated_at: {
+            readonly type: "string";
+        };
+    };
+    readonly required: readonly ["kb_id", "title", "description", "vector_dimensions", "document_table", "chunk_table", "created_at", "updated_at"];
+    readonly additionalProperties: false;
+};
+export type KnowledgeBaseRecord = FromSchema<typeof KnowledgeBaseRecordSchema>;
+export declare const KnowledgeBasePrimaryKeyNames: readonly ["kb_id"];
+/**
+ * Generates SQL-safe table names for a knowledge base's document and chunk storage.
+ */
+export declare function knowledgeBaseTableNames(kbId: string): {
+    readonly documentTable: string;
+    readonly chunkTable: string;
+};
+//# sourceMappingURL=KnowledgeBaseSchema.d.ts.map

package/dist/knowledge-base/KnowledgeBaseSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeBaseSchema.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBaseSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAwB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBG,CAAC;AAE1C,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC/E,eAAO,MAAM,4BAA4B,oBAAqB,CAAC;AAE/D;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAMA"}

package/dist/knowledge-base/createKnowledgeBase.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { TypedArray } from "@workglow/util";
+import { KnowledgeBase } from "./KnowledgeBase";
+export interface CreateKnowledgeBaseOptions {
+    readonly name: string;
+    readonly vectorDimensions: number;
+    readonly vectorType?: {
+        new (array: number[]): TypedArray;
+    };
+    readonly register?: boolean;
+    readonly title?: string;
+    readonly description?: string;
+}
+/**
+ * Factory function to create a KnowledgeBase with minimal configuration.
+ *
+ * @example
+ * ```typescript
+ * const kb = await createKnowledgeBase({
+ *   name: "my-kb",
+ *   vectorDimensions: 1024,
+ * });
+ * ```
+ */
+export declare function createKnowledgeBase(options: CreateKnowledgeBaseOptions): Promise<KnowledgeBase>;
+//# sourceMappingURL=createKnowledgeBase.d.ts.map

package/dist/knowledge-base/createKnowledgeBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createKnowledgeBase.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/createKnowledgeBase.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,KAAK,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,aAAa,CAAC,CAsCxB"}