@workglow/knowledge-base 0.1.2 → 0.2.0

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

@@ -26,11 +26,27 @@ export declare function getGlobalKnowledgeBaseRepository(): KnowledgeBaseReposit
  * Sets the global knowledge base repository instance
  */
 export declare function setGlobalKnowledgeBaseRepository(repository: KnowledgeBaseRepository): void;
+export interface RegisterKnowledgeBaseOptions {
+    /** When true, record uses shared table names instead of per-KB table names. */
+    readonly sharedTables?: boolean;
+}
 /**
  * Registers a knowledge base globally by ID.
  * Adds to both the live Map and the persistent repository.
+ * Serialized per-ID to prevent Map/repo divergence on concurrent calls.
  */
-export declare function registerKnowledgeBase(id: string, kb: KnowledgeBase): Promise<void>;
+export declare function registerKnowledgeBase(id: string, kb: KnowledgeBase, options?: RegisterKnowledgeBaseOptions): Promise<void>;
+/**
+ * Unregisters a knowledge base by ID.
+ * Removes from both the persistent repository and the live Map.
+ * Serialized per-ID to prevent Map/repo divergence on concurrent calls.
+ */
+export declare function unregisterKnowledgeBase(id: string): Promise<void>;
+/**
+ * Deregisters a knowledge base by ID.
+ * Removes from both the live Map and the persistent repository.
+ */
+export declare function deregisterKnowledgeBase(id: string): Promise<void>;
 /**
  * Gets a knowledge base by ID from the global registry
  */

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

@@ -1 +1 @@
-{"version":3,"file":"KnowledgeBaseRegistry.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBaseRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE;;;GAGG;AACH,eAAO,MAAM,eAAe,mEAC+C,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB,gEAErC,CAAC;AAoBF;;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,CAsBxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtE"}
+{"version":3,"file":"KnowledgeBaseRegistry.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBaseRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAKpE;;;GAGG;AACH,eAAO,MAAM,eAAe,mEAC+C,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB,gEAErC,CAAC;AAgBF;;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,MAAM,WAAW,4BAA4B;IAC3C,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AA0BD;;;;GAIG;AAEH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,aAAa,EACjB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjE;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtE"}

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

@@ -3,9 +3,11 @@
  * Copyright 2025 Steven Roussey <sroussey@gmail.com>
  * SPDX-License-Identifier: Apache-2.0
  */
-import { type ITabularStorage } from "@workglow/storage";
-import { EventEmitter, type EventParameters } from "@workglow/util";
-import { KnowledgeBasePrimaryKeyNames, type KnowledgeBaseRecord, KnowledgeBaseRecordSchema } from "./KnowledgeBaseSchema";
+import type { ITabularStorage } from "@workglow/storage";
+import { EventEmitter } from "@workglow/util";
+import type { EventParameters } from "@workglow/util";
+import { KnowledgeBasePrimaryKeyNames, KnowledgeBaseRecordSchema } from "./KnowledgeBaseSchema";
+import type { KnowledgeBaseRecord } from "./KnowledgeBaseSchema";
 /**
  * Events that can be emitted by the KnowledgeBaseRepository
  */

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

@@ -1 +1 @@
-{"version":3,"file":"KnowledgeBaseRepository.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBaseRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,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,eAAe,CACzC,OAAO,yBAAyB,EAChC,OAAO,4BAA4B,CACpC,CAAC;IAEF,YACE,OAAO,EAAE,eAAe,CAAC,OAAO,yBAAyB,EAAE,OAAO,4BAA4B,CAAC,EAGhG;IAED,0CAA0C;IAC1C,SAAS,CAAC,MAAM,4CAAmD;IAEnE;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnC;IAED;;OAEG;IACH,EAAE,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC,QAEvF;IAED;;OAEG;IACH,GAAG,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC,QAExF;IAED;;OAEG;IACH,IAAI,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC,QAEzF;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK,2FAEpD;IAED;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAIhF;IAED;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtD;IAED;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAI9E;IAED;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAInD;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5B;CACF"}
+{"version":3,"file":"KnowledgeBaseRepository.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBaseRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;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,eAAe,CACzC,OAAO,yBAAyB,EAChC,OAAO,4BAA4B,CACpC,CAAC;IAEF,YACE,OAAO,EAAE,eAAe,CAAC,OAAO,yBAAyB,EAAE,OAAO,4BAA4B,CAAC,EAGhG;IAED,0CAA0C;IAC1C,SAAS,CAAC,MAAM,4CAAmD;IAEnE;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnC;IAED;;OAEG;IACH,EAAE,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC,QAEvF;IAED;;OAEG;IACH,GAAG,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC,QAExF;IAED;;OAEG;IACH,IAAI,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC,QAEzF;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,SAAS,mBAAmB,EAAE,IAAI,EAAE,KAAK,2FAEpD;IAED;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAIhF;IAED;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtD;IAED;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAI9E;IAED;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAInD;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5B;CACF"}

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

@@ -47,4 +47,8 @@ export declare function knowledgeBaseTableNames(kbId: string): {
     readonly documentTable: string;
     readonly chunkTable: string;
 };
+/**
+ * Checks whether a KnowledgeBaseRecord uses shared-table mode.
+ */
+export declare function isSharedTableMode(record: KnowledgeBaseRecord): boolean;
 //# sourceMappingURL=KnowledgeBaseSchema.d.ts.map

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

@@ -1 +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,uBAAuB,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,yBAAyB;mBAC9B,QAAQ;;iBAEZ,KAAK;qBAAI,IAAI,EAAE,QAAQ;;iBACvB,KAAK;qBAAI,IAAI,EAAE,QAAQ;;iBACvB,WAAW;qBAAI,IAAI,EAAE,QAAQ;;iBAC7B,iBAAiB;qBAAI,IAAI,EAAE,SAAS;;iBACpC,cAAc;qBAAI,IAAI,EAAE,QAAQ;;iBAChC,WAAW;qBAAI,IAAI,EAAE,QAAQ;;iBAC7B,UAAU;qBAAI,IAAI,EAAE,QAAQ;;iBAC5B,UAAU;qBAAI,IAAI,EAAE,QAAQ;;;;;CAaS,CAAC;AAE1C,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC/E,eAAO,MAAM,4BAA4B,YAAI,OAAO,CAAU,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"}
+{"version":3,"file":"KnowledgeBaseSchema.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/KnowledgeBaseSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAwB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAG9E;;GAEG;AACH,eAAO,MAAM,yBAAyB;mBAC9B,QAAQ;;iBAEZ,KAAK;qBAAI,IAAI,EAAE,QAAQ;;iBACvB,KAAK;qBAAI,IAAI,EAAE,QAAQ;;iBACvB,WAAW;qBAAI,IAAI,EAAE,QAAQ;;iBAC7B,iBAAiB;qBAAI,IAAI,EAAE,SAAS;;iBACpC,cAAc;qBAAI,IAAI,EAAE,QAAQ;;iBAChC,WAAW;qBAAI,IAAI,EAAE,QAAQ;;iBAC7B,UAAU;qBAAI,IAAI,EAAE,QAAQ;;iBAC5B,UAAU;qBAAI,IAAI,EAAE,QAAQ;;;;;CAaS,CAAC;AAE1C,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC/E,eAAO,MAAM,4BAA4B,YAAI,OAAO,CAAU,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;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAItE"}

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

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AnyTabularStorage, DeleteSearchCriteria, ITabularStorage, QueryOptions, SearchCriteria, TabularChangePayload, TabularEventListener, TabularEventListeners, TabularEventName, TabularEventParameters, TabularSubscribeOptions } from "@workglow/storage";
+import { EventEmitter } from "@workglow/util";
+import type { DataPortSchemaObject } from "@workglow/util/schema";
+/**
+ * Wrapper implementing `ITabularStorage` that delegates to an inner shared
+ * storage instance, injecting `kb_id` on writes and filtering by `kb_id` on
+ * reads. The outer interface does not include `kb_id` — it is transparent to
+ * the `KnowledgeBase` class.
+ */
+export declare class ScopedTabularStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = any, PrimaryKey = any, InsertType = any> implements ITabularStorage<Schema, PrimaryKeyNames, Entity, PrimaryKey, InsertType> {
+    protected readonly inner: AnyTabularStorage;
+    protected readonly kbId: string;
+    protected readonly events: EventEmitter<TabularEventListeners<PrimaryKey, Entity>>;
+    constructor(inner: AnyTabularStorage, kbId: string);
+    private inject;
+    private strip;
+    private stripArray;
+    put(value: InsertType): Promise<Entity>;
+    putBulk(values: InsertType[]): Promise<Entity[]>;
+    get(key: PrimaryKey): Promise<Entity | undefined>;
+    delete(key: PrimaryKey | Entity): Promise<void>;
+    getAll(options?: QueryOptions<Entity>): Promise<Entity[] | undefined>;
+    deleteAll(): Promise<void>;
+    size(): Promise<number>;
+    query(criteria: SearchCriteria<Entity>, options?: QueryOptions<Entity>): Promise<Entity[] | undefined>;
+    deleteSearch(criteria: DeleteSearchCriteria<Entity>): Promise<void>;
+    getBulk(offset: number, limit: number): Promise<Entity[] | undefined>;
+    records(pageSize?: number): AsyncGenerator<Entity, void, undefined>;
+    pages(pageSize?: number): AsyncGenerator<Entity[], void, undefined>;
+    on<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    off<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    emit<Event extends TabularEventName>(name: Event, ...args: TabularEventParameters<Event, PrimaryKey, Entity>): void;
+    once<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    waitOn<Event extends TabularEventName>(name: Event): Promise<TabularEventParameters<Event, PrimaryKey, Entity>>;
+    subscribeToChanges(callback: (change: TabularChangePayload<Entity>) => void, options?: TabularSubscribeOptions): () => void;
+    setupDatabase(): Promise<void>;
+    destroy(): void;
+    [Symbol.dispose](): void;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=ScopedTabularStorage.d.ts.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AnyVectorStorage, HybridSearchOptions, IVectorStorage, VectorSearchOptions } from "@workglow/storage";
+import type { DataPortSchemaObject, TypedArray } from "@workglow/util/schema";
+import { ScopedTabularStorage } from "./ScopedTabularStorage";
+/**
+ * Wrapper extending `ScopedTabularStorage` that also implements `IVectorStorage`.
+ * Delegates vector search methods to the inner shared vector storage,
+ * post-filtering results by `kb_id`.
+ */
+export declare class ScopedVectorStorage<Metadata extends Record<string, unknown> | undefined, Schema extends DataPortSchemaObject, Entity = any, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]> = ReadonlyArray<keyof Schema["properties"]>> extends ScopedTabularStorage<Schema, PrimaryKeyNames, Entity> implements IVectorStorage<Metadata, Schema, Entity, PrimaryKeyNames> {
+    protected readonly inner: AnyVectorStorage;
+    private readonly overFetchMultiplier;
+    constructor(inner: AnyVectorStorage, kbId: string, overFetchMultiplier?: number);
+    getVectorDimensions(): number;
+    private filterAndStrip;
+    similaritySearch(query: TypedArray, options?: VectorSearchOptions<Metadata>): Promise<(Entity & {
+        score: number;
+    })[]>;
+    hybridSearch(query: TypedArray, options: HybridSearchOptions<Metadata>): Promise<(Entity & {
+        score: number;
+    })[]>;
+}
+//# sourceMappingURL=ScopedVectorStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScopedVectorStorage.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/ScopedVectorStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,mBAAmB,CAC9B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACpD,MAAM,SAAS,oBAAoB,EACnC,MAAM,GAAG,GAAG,EACZ,eAAe,SAAS,aAAa,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,aAAa,CAC/E,MAAM,MAAM,CAAC,YAAY,CAAC,CAC3B,CAED,SAAQ,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAC5D,YAAW,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;IAEpE,mBAA4B,KAAK,EAAE,gBAAgB,CAAC;IACpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAE7C,YAAY,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,GAAE,MAAU,EAIjF;IAED,mBAAmB,IAAI,MAAM,CAE5B;IAED,OAAO,CAAC,cAAc;IAuBhB,gBAAgB,CACpB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GACtC,OAAO,CAAC,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC,CAQzC;IAEK,YAAY,CAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GACrC,OAAO,CAAC,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC,CAczC;CACF"}

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

@@ -0,0 +1,93 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Default table names for shared-table mode.
+ */
+export declare const SHARED_DOCUMENT_TABLE = "shared_documents";
+export declare const SHARED_CHUNK_TABLE = "shared_chunks";
+/**
+ * Augmented document storage schema with kb_id column for shared-table mode.
+ */
+export declare const SharedDocumentStorageSchema: {
+    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 kb_id: {
+            readonly type: "string";
+            readonly title: "Knowledge Base ID";
+            readonly description: "Owning knowledge base identifier";
+        };
+        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", "kb_id", "data"];
+    readonly additionalProperties: true;
+};
+/**
+ * Augmented chunk vector storage schema with kb_id column for shared-table mode.
+ */
+export declare const SharedChunkVectorStorageSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly chunk_id: {
+            readonly type: "string";
+            readonly "x-auto-generated": true;
+        };
+        readonly kb_id: {
+            readonly type: "string";
+        };
+        readonly doc_id: {
+            readonly type: "string";
+        };
+        readonly vector: {
+            readonly type: "array";
+            readonly format: "TypedArray";
+            readonly title: "Typed Array";
+            readonly description: "A typed array (Float32Array, Int8Array, etc.)";
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly format: "metadata";
+            readonly additionalProperties: true;
+        };
+    };
+    readonly required: readonly ["chunk_id", "kb_id", "doc_id", "vector", "metadata"];
+    readonly additionalProperties: false;
+};
+/**
+ * Composite primary key for shared document table — includes `kb_id` to prevent
+ * cross-KB key collisions when multiple knowledge bases share the same table.
+ */
+export declare const SharedDocumentPrimaryKey: readonly ["kb_id", "doc_id"];
+export type SharedDocumentPrimaryKey = typeof SharedDocumentPrimaryKey;
+/**
+ * Composite primary key for shared chunk table — includes `kb_id` to prevent
+ * cross-KB key collisions when multiple knowledge bases share the same table.
+ */
+export declare const SharedChunkPrimaryKey: readonly ["kb_id", "chunk_id"];
+export type SharedChunkPrimaryKey = typeof SharedChunkPrimaryKey;
+/**
+ * Index definitions for efficient KB-scoped queries on shared document table.
+ */
+export declare const SharedDocumentIndexes: readonly [readonly ["kb_id"]];
+/**
+ * Index definitions for efficient KB-scoped queries on shared chunk table.
+ */
+export declare const SharedChunkIndexes: readonly [readonly ["kb_id"], readonly ["kb_id", "doc_id"]];
+//# sourceMappingURL=SharedTableSchemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SharedTableSchemas.d.ts","sourceRoot":"","sources":["../../src/knowledge-base/SharedTableSchemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,2BAA2B;mBAChC,QAAQ;;iBAEZ,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,kBAAkB;qBAClB,KAAK,EAAE,aAAa;qBACpB,WAAW,EAAE,oCAAoC;;iBAEnD,KAAK;qBACH,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,mBAAmB;qBAC1B,WAAW,EAAE,kCAAkC;;iBAEjD,IAAI;qBACF,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,eAAe;qBACtB,WAAW,EAAE,0BAA0B;;iBAEzC,QAAQ;qBACN,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,UAAU;qBACjB,WAAW,EAAE,0BAA0B;;;;;CAKJ,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,8BAA8B;mBACnC,QAAQ;;iBAEZ,QAAQ;qBAAI,IAAI,EAAE,QAAQ;qBAAE,kBAAkB;;iBAC9C,KAAK;qBAAI,IAAI,EAAE,QAAQ;;iBACvB,MAAM;qBAAI,IAAI,EAAE,QAAQ;;iBACxB,MAAM;;;;;;iBACN,QAAQ;qBAAI,IAAI,EAAE,QAAQ;qBAAE,MAAM,EAAE,UAAU;qBAAE,oBAAoB;;;;;CAI/B,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,YAAI,OAAO,EAAE,QAAQ,CAAU,CAAC;AACrE,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,YAAI,OAAO,EAAE,UAAU,CAAU,CAAC;AACpE,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,qBAAqB,+BAG/B,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,kBAAkB,6DAG5B,CAAC"}