fawn-memory 0.0.3

package/README.md

@@ -0,0 +1,118 @@
+# fawn
+
+TypeScript toolkit for extracting structured knowledge from text and querying it with natural language. Built on TypeChat, with an in-memory semantic index and a simple REPL for exploration.
+
+## Features
+
+- Extract entities, actions, and topics from messages
+- Build an in-memory semantic reference index
+- Query with natural language or explicit term sets
+- Load pre-extracted knowledge from a file
+- Export index data for visualization
+
+## Install
+
+```sh
+pnpm install
+```
+
+## Quickstart (library)
+
+```ts
+import {
+  createConversation,
+  createMessage,
+  createInMemoryStorageProvider
+} from "fawn";
+
+const storage = createInMemoryStorageProvider();
+const messages = storage.createMessageCollection();
+
+const conversation = await createConversation(messages, "demo", storage);
+
+await conversation.addMessageAsync(
+  createMessage("I bought apples and bananas today.", [])
+);
+
+const answer = await conversation.query("What did I buy?");
+console.log(answer);
+```
+
+## REPL mode
+
+Run the entrypoint directly to use the interactive shell:
+
+```sh
+pnpm dev
+```
+
+Commands inside the REPL:
+
+- `@load <path>`: load a knowledge file into the index
+- `@loadindex <path>`: load a pre-built index JSON file
+- `@export [path]`: export index data to JSON (default: `fawn-index-export.json`)
+- `@lemmatize`: add lemmatized forms to the index
+- `@related [weight] [maxTerms]`: expand index with LLM-generated related terms
+- `@wordnet [weight] [maxTerms]`: expand index with WordNet synonyms
+- `@entity <term>`: print entities matching a term
+- `@action <term>`: print actions matching a term
+- `@topic [term]`: print topics matching a term (omit term to print all topics)
+- `@term <term1> <term2> ...`: query by explicit terms
+- `exit` or `quit`: leave the REPL
+
+There is a sample knowledge file at `data/1984ParagraphOutput.txt`.
+
+## Examples
+
+### Memory Service
+
+A web-based memory service with REST API and chat UI.
+
+```sh
+cd examples/memory
+pnpm install
+pnpm run dev
+```
+
+Open http://localhost:3000/chat for the interactive UI.
+
+### Index Visualizer
+
+Interactive tool for exploring semantic indexes with a relationship graph.
+
+```sh
+cd tools/index-visualizer
+pnpm install
+pnpm run dev
+```
+
+Open http://localhost:3001 to load and visualize index data.
+
+## Environment
+
+Configure your LLM provider via environment variables:
+
+```sh
+# Provider selection (default: 'openai')
+LLM_PROVIDER=openai   # or 'claude'
+
+# API keys (set the one for your chosen provider)
+OPENAI_API_KEY=sk-...        # For OpenAI (also supports legacy OPENAI_SDK_KEY)
+ANTHROPIC_API_KEY=sk-ant-... # For Claude
+
+# Optional: Override default model
+LLM_MODEL=gpt-4-turbo
+```
+
+`dotenv` is enabled, so a local `.env` file works too.
+
+## Scripts
+
+- `pnpm dev`: run the REPL entrypoint with tsx
+- `pnpm lint`: run ESLint
+- `pnpm build`: emit ESM + type declarations to `dist/`
+- `pnpm clean`: remove the `dist/` directory
+
+## Development notes
+
+`prepublishOnly` runs a clean rebuild (`pnpm run clean && pnpm run build`).

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import 'dotenv/config';
+export { createConversation, createMessage, loadConversationFromExport, loadConversationFromExportData } from './knowpro/conversation.js';
+export type { Conversation, Message, ExportedIndex } from './knowpro/conversation.js';
+export { createInMemoryStorageProvider } from './knowpro/storageProvider.js';
+export type { InMemoryStorageProvider } from './knowpro/storageProvider.js';
+export { createKnowledgeExtractor } from './knowpro/knowledge.js';
+export type { KnowledgeExtractor } from './knowpro/interfaces.js';
+export type { InMemorySemanticRefIndex, LemmatizationResult, RelatedTermsExpansionOptions, RelatedTermsExpansionResult, WordNetExpansionOptions } from './knowpro/semanticRefIndex.js';
+export type { DeletionInfo, IMessage, IMessageMetadata, IConversation, MessageTag, SemanticRef, Topic, Knowledge, KnowledgeType, ITermToSemanticRefIndexData, ITermToSemanticRefIndexItem, ScoredSemanticRefOrdinal } from './knowpro/interfaces.js';
+export type { KnowledgeResponse, ConcreteEntity, Action } from './knowpro/knowledgeSchema.js';
+export type { TimestampIndexExtended } from './knowpro/timestampIndex.js';
+export { createTimestampIndex, createTimestampIndexExtended, parseTemporalExpression, hasTemporalReference } from './knowpro/timestampIndex.js';
+export * from './knowpro/llmProvider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,eAAe,CAAC;AAOvB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC1I,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,YAAY,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACvL,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,KAAK,EACL,SAAS,EACT,aAAa,EACb,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC9F,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAChJ,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,183 @@
+import { fileURLToPath } from 'node:url';
+import { writeFileSync } from 'node:fs';
+import { createConversation, loadConversationFromExport } from './knowpro/conversation.js';
+import { createInMemoryStorageProvider } from './knowpro/storageProvider.js';
+import 'dotenv/config';
+import { createInterface } from 'node:readline/promises';
+import { printAction, printEntity, printTopic } from './knowpro/entities.js';
+// Public exports
+export { createConversation, createMessage, loadConversationFromExport, loadConversationFromExportData } from './knowpro/conversation.js';
+export { createInMemoryStorageProvider } from './knowpro/storageProvider.js';
+export { createKnowledgeExtractor } from './knowpro/knowledge.js';
+export { createTimestampIndex, createTimestampIndexExtended, parseTemporalExpression, hasTemporalReference } from './knowpro/timestampIndex.js';
+export * from './knowpro/llmProvider.js';
+const invokedDirectly = process.argv[1] === fileURLToPath(import.meta.url);
+if (invokedDirectly) {
+    const inMemoryStorageProvider = createInMemoryStorageProvider();
+    const messages = inMemoryStorageProvider.createMessageCollection();
+    let conversation = await createConversation(messages, "test conversation", inMemoryStorageProvider);
+    if (!conversation.semanticRefIndex) {
+        console.log("No index found");
+        process.exit();
+    }
+    // console.log(conversation.semanticRefIndex.getTerms());
+    const readline = createInterface({
+        input: process.stdin
+    });
+    let quit = false;
+    console.log("starting repl...");
+    while (!quit) {
+        process.stdout.write("> ");
+        const query = await readline.question("> ");
+        if (query.includes("@entity")) {
+            const refs = conversation.semanticRefIndex?.lookupTerm(query.split(" ")[1]);
+            if (refs) {
+                refs.forEach((refOrdinal) => {
+                    const ref = conversation.semanticRefs?.get(refOrdinal.semanticRefOrdinal);
+                    if (ref && ref.knowledgeType === "entity") {
+                        printEntity(ref.knowledge);
+                    }
+                });
+            }
+            continue;
+        }
+        if (query.includes("@action")) {
+            const refs = conversation.semanticRefIndex?.lookupTerm(query.split(" ")[1]);
+            if (refs) {
+                refs.forEach((refOrdinal) => {
+                    const ref = conversation.semanticRefs?.get(refOrdinal.semanticRefOrdinal);
+                    if (ref && ref.knowledgeType === "action") {
+                        printAction(ref.knowledge);
+                    }
+                });
+            }
+            continue;
+        }
+        if (query.includes("@term")) {
+            const terms = query.split(" ").slice(1);
+            console.log(await conversation.queryTerms(terms));
+            continue;
+        }
+        if (query.includes("@topic")) {
+            const refs = conversation.semanticRefIndex?.lookupTerm(query.split(" ")[1]);
+            if (refs) {
+                refs.forEach((refOrdinal) => {
+                    const ref = conversation.semanticRefs?.get(refOrdinal.semanticRefOrdinal);
+                    if (ref && ref.knowledgeType === "topic") {
+                        printTopic(ref.knowledge);
+                    }
+                });
+            }
+            if (!refs) {
+                const refs = conversation.getAllTopics();
+                refs.forEach((ref) => {
+                    printTopic(ref.knowledge);
+                });
+            }
+            continue;
+        }
+        if (query.startsWith("@load ")) {
+            const filePath = query.slice("@load ".length).trim();
+            if (!filePath) {
+                console.log("ERROR: Provide a file path after @load.");
+                continue;
+            }
+            conversation.loadFromFile(filePath);
+            console.log(`Loaded: ${filePath}`);
+            continue;
+        }
+        if (query.startsWith("@loadindex ")) {
+            const filePath = query.slice("@loadindex ".length).trim();
+            if (!filePath) {
+                console.log("ERROR: Provide a file path after @loadindex.");
+                continue;
+            }
+            try {
+                conversation = loadConversationFromExport(filePath);
+                console.log(`Index loaded from: ${filePath}`);
+            }
+            catch (e) {
+                console.log(`ERROR: Failed to load index: ${e}`);
+            }
+            continue;
+        }
+        if (query.startsWith("@export")) {
+            const outputPath = query.slice("@export".length).trim() || "fawn-index-export.json";
+            // Build index data
+            const semanticRefs = conversation.semanticRefs?.getAll() || [];
+            let indexData = { items: [] };
+            if (conversation.semanticRefIndex) {
+                const terms = conversation.semanticRefIndex.getTerms();
+                indexData = {
+                    items: terms.map(term => ({
+                        term,
+                        semanticRefOrdinals: conversation.semanticRefIndex.lookupTerm(term) || []
+                    }))
+                };
+            }
+            const messages = conversation.messages.getAll().map((msg, index) => ({
+                ordinal: index,
+                content: msg.textChunks.join(''),
+                timestamp: msg.timestamp
+            }));
+            const exportData = {
+                indexData,
+                semanticRefs,
+                messages,
+                stats: {
+                    termCount: indexData.items.length,
+                    refCount: semanticRefs.length,
+                    messageCount: messages.length
+                }
+            };
+            writeFileSync(outputPath, JSON.stringify(exportData, null, 2));
+            console.log(`Exported to: ${outputPath}`);
+            console.log(`  Terms: ${indexData.items.length}`);
+            console.log(`  Semantic Refs: ${semanticRefs.length}`);
+            console.log(`  Messages: ${messages.length}`);
+            continue;
+        }
+        if (query === "@lemmatize") {
+            const result = conversation.lemmatize();
+            console.log(`Lemmatization complete:`);
+            console.log(`  Terms processed: ${result.termsProcessed}`);
+            console.log(`  Lemmas added: ${result.lemmasAdded}`);
+            continue;
+        }
+        if (query.startsWith("@related")) {
+            const parts = query.split(" ");
+            const weight = parts[1] ? parseFloat(parts[1]) : 0.9;
+            const maxTerms = parts[2] ? parseInt(parts[2]) : undefined;
+            console.log(`Expanding related terms with LLM (weight: ${weight}${maxTerms ? `, maxTerms: ${maxTerms}` : ''})...`);
+            const result = await conversation.expandRelatedTerms({
+                relatedTermWeight: weight,
+                maxTerms
+            });
+            console.log(`Related terms expansion complete:`);
+            console.log(`  Terms processed: ${result.termsProcessed}`);
+            console.log(`  Related terms added: ${result.relatedTermsAdded}`);
+            continue;
+        }
+        if (query.startsWith("@wordnet")) {
+            const parts = query.split(" ");
+            const weight = parts[1] ? parseFloat(parts[1]) : 0.9;
+            const maxTerms = parts[2] ? parseInt(parts[2]) : undefined;
+            console.log(`Expanding related terms with WordNet (weight: ${weight}${maxTerms ? `, maxTerms: ${maxTerms}` : ''})...`);
+            const result = await conversation.expandWithWordNet({
+                relatedTermWeight: weight,
+                maxTerms
+            });
+            console.log(`WordNet expansion complete:`);
+            console.log(`  Terms processed: ${result.termsProcessed}`);
+            console.log(`  Related terms added: ${result.relatedTermsAdded}`);
+            continue;
+        }
+        if (query === 'quit' || query === 'exit') {
+            quit = true;
+            break;
+        }
+        console.log(await conversation.query(query));
+    }
+    readline.close();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/knowpro/answerContextSchema.d.ts

@@ -0,0 +1,20 @@
+import type { DateRange } from "./interfaces.js";
+export type AnswerContext = {
+    entities?: RelevantKnowledge[] | undefined;
+    topics?: RelevantKnowledge[] | undefined;
+    messages?: RelevantMessage[] | undefined;
+};
+export type EntityNames = string | string[];
+export type RelevantKnowledge = {
+    knowledge: unknown;
+    origin?: EntityNames | undefined;
+    audience?: EntityNames | undefined;
+    timeRange?: DateRange | undefined;
+};
+export type RelevantMessage = {
+    from?: EntityNames | undefined;
+    to?: EntityNames | undefined;
+    timestamp?: Date | undefined;
+    messageText?: string | string[] | undefined;
+};
+//# sourceMappingURL=answerContextSchema.d.ts.map

package/dist/knowpro/answerContextSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerContextSchema.d.ts","sourceRoot":"","sources":["../../src/knowpro/answerContextSchema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG;IAGxB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IAE3C,MAAM,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IAEzC,QAAQ,CAAC,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GAAG;IAE5B,SAAS,EAAE,OAAO,CAAC;IAEnB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAEjC,QAAQ,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAEnC,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,EAAE,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAE7B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/C,CAAC"}

package/dist/knowpro/answerContextSchema.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=answerContextSchema.js.map

package/dist/knowpro/answerContextSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerContextSchema.js","sourceRoot":"","sources":["../../src/knowpro/answerContextSchema.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/knowpro/answerResponseSchema.d.ts

@@ -0,0 +1,7 @@
+export type AnswerType = "NoAnswer" | "Answered";
+export type AnswerResponse = {
+    type: AnswerType;
+    answer?: string | undefined;
+    whyNoAnswer?: string;
+};
+//# sourceMappingURL=answerResponseSchema.d.ts.map

package/dist/knowpro/answerResponseSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerResponseSchema.d.ts","sourceRoot":"","sources":["../../src/knowpro/answerResponseSchema.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAChB,UAAU,GACV,UAAU,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG;IAEzB,IAAI,EAAE,UAAU,CAAC;IAEjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAG5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC"}

package/dist/knowpro/answerResponseSchema.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=answerResponseSchema.js.map

package/dist/knowpro/answerResponseSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerResponseSchema.js","sourceRoot":"","sources":["../../src/knowpro/answerResponseSchema.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/knowpro/answerTranslator.d.ts

@@ -0,0 +1,5 @@
+import type { TypeChatJsonTranslator, TypeChatLanguageModel } from "typechat";
+import type * as answerSchema from "./answerResponseSchema.js";
+export type AnswerTranslator = TypeChatJsonTranslator<answerSchema.AnswerResponse>;
+export declare function createAnswerTranslator(model: TypeChatLanguageModel): AnswerTranslator;
+//# sourceMappingURL=answerTranslator.d.ts.map

package/dist/knowpro/answerTranslator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerTranslator.d.ts","sourceRoot":"","sources":["../../src/knowpro/answerTranslator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,KAAK,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAI/D,MAAM,MAAM,gBAAgB,GACxB,sBAAsB,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;AAExD,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,qBAAqB,GAC7B,gBAAgB,CAYlB"}

package/dist/knowpro/answerTranslator.js

@@ -0,0 +1,10 @@
+import { createJsonTranslator } from "typechat";
+import { loadSchema } from "./schema.js";
+import { createTypeScriptJsonValidator } from "typechat/ts";
+export function createAnswerTranslator(model) {
+    const typeName = "AnswerResponse";
+    const schema = loadSchema(["answerResponseSchema.ts"], import.meta.url);
+    const translator = createJsonTranslator(model, createTypeScriptJsonValidator(schema, typeName));
+    return translator;
+}
+//# sourceMappingURL=answerTranslator.js.map

package/dist/knowpro/answerTranslator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerTranslator.js","sourceRoot":"","sources":["../../src/knowpro/answerTranslator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAK5D,MAAM,UAAU,sBAAsB,CAClC,KAA4B;IAE5B,MAAM,QAAQ,GAAG,gBAAgB,CAAC;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAExE,MAAM,UAAU,GAAG,oBAAoB,CACnC,KAAK,EACL,6BAA6B,CACzB,MAAM,EACN,QAAQ,CACX,CACJ,CAAC;IACF,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/dist/knowpro/collections.d.ts

@@ -0,0 +1,14 @@
+import type { IMessage, IMessageCollection, ISemanticRefCollection } from "./interfaces.js";
+export declare function createInMemoryCollection<T, TOrdinal>(createOrdinal?: (index: number, item: T) => TOrdinal): {
+    isPersistent: boolean;
+    readonly length: number;
+    get: (ordinal: TOrdinal) => T;
+    getMultiple: (ordinals: TOrdinal[]) => T[];
+    getSlice: (start: number, end: number) => T[];
+    getAll: () => T[];
+    append: (...items: T[]) => void;
+    [Symbol.iterator](): MapIterator<T>;
+};
+export declare function createMessageCollection<TMessage extends IMessage = IMessage>(): IMessageCollection<TMessage>;
+export declare function createSemanticRefCollection(): ISemanticRefCollection;
+//# sourceMappingURL=collections.d.ts.map

package/dist/knowpro/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/knowpro/collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,sBAAsB,EAAmD,MAAM,iBAAiB,CAAC;AAE7I,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,QAAQ,EAChD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,QAAQ;;;mBAK9B,QAAQ,KAAG,CAAC;4BASH,QAAQ,EAAE,KAAG,CAAC,EAAE;sBAMtB,MAAM,OAAO,MAAM,KAAG,CAAC,EAAE;kBAI/B,CAAC,EAAE;uBAII,CAAC,EAAE,KAAG,IAAI;;EAuBvC;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,SAAS,QAAQ,GAAG,QAAQ,KAAK,kBAAkB,CAAC,QAAQ,CAAC,CAE5G;AAED,wBAAgB,2BAA2B,IAAI,sBAAsB,CAEpE"}

package/dist/knowpro/collections.js

@@ -0,0 +1,52 @@
+export function createInMemoryCollection(createOrdinal) {
+    const entries = new Map();
+    const order = [];
+    function get(ordinal) {
+        const value = entries.get(ordinal);
+        if (value === undefined) {
+            throw new RangeError(`No item at ordinal ${ordinal}`);
+        }
+        return value;
+    }
+    // could be optimized look at what ms team does
+    function getMultiple(ordinals) {
+        return ordinals.map((ordinal) => {
+            return get(ordinal);
+        });
+    }
+    function getSlice(start, end) {
+        return order.slice(start, end).map((ordinal) => entries.get(ordinal));
+    }
+    function getAll() {
+        return [...entries.values()];
+    }
+    function append(...items) {
+        items.forEach((value, idx) => {
+            // ask about this cast here
+            const ordinal = createOrdinal ? createOrdinal(idx, value) : order.length;
+            order.push(ordinal);
+            entries.set(ordinal, value);
+        });
+    }
+    return {
+        isPersistent: false,
+        get length() {
+            return order.length;
+        },
+        get,
+        getMultiple,
+        getSlice,
+        getAll,
+        append,
+        [Symbol.iterator]() {
+            return entries.values()[Symbol.iterator]();
+        }
+    };
+}
+export function createMessageCollection() {
+    return createInMemoryCollection();
+}
+export function createSemanticRefCollection() {
+    return createInMemoryCollection();
+}
+//# sourceMappingURL=collections.js.map

package/dist/knowpro/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/knowpro/collections.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CACpC,aAAoD;IAEpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAe,CAAC;IACvC,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,SAAS,GAAG,CAAC,OAAiB;QAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,UAAU,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,+CAA+C;IAC/C,SAAS,WAAW,CAAC,QAAoB;QACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC,CAAA;IACN,CAAC;IAED,SAAS,QAAQ,CAAC,KAAa,EAAE,GAAW;QACxC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,CAAC;IAC3E,CAAC;IAED,SAAS,MAAM;QACX,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,MAAM,CAAC,GAAG,KAAU;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACzB,2BAA2B;YAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAkB,CAAC;YACrF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACH,YAAY,EAAE,KAAK;QACnB,IAAI,MAAM;YACN,OAAO,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC;QACD,GAAG;QACH,WAAW;QACX,QAAQ;QACR,MAAM;QACN,MAAM;QACN,CAAC,MAAM,CAAC,QAAQ,CAAC;YACb,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,CAAC;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB;IACnC,OAAO,wBAAwB,EAA4B,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,2BAA2B;IACvC,OAAO,wBAAwB,EAAmC,CAAC;AACvE,CAAC"}

package/dist/knowpro/conversation.d.ts

@@ -0,0 +1,63 @@
+import type { DateRange, DeletionInfo, IConversation, IMessage, IMessageCollection, IMessageMetadata, MessageTag, SemanticRef } from "./interfaces.js";
+import type { KnowledgeResponse } from "./knowledgeSchema.js";
+import type { PromptSection } from 'typechat';
+import { type LemmatizationResult, type RelatedTermsExpansionOptions, type RelatedTermsExpansionResult, type WordNetExpansionOptions } from "./semanticRefIndex.js";
+import { type InMemoryStorageProvider } from "./storageProvider.js";
+export interface Message extends IMessage {
+    setKnowledge: (knowledge: KnowledgeResponse) => void;
+}
+export declare function createMessage(content: string, tags: MessageTag[], timestamp?: string | undefined, deletionInfo?: DeletionInfo | undefined, metadata?: IMessageMetadata | undefined): Message;
+export interface Conversation extends IConversation {
+    query: (question: string) => Promise<string>;
+    queryTerms: (terms: string[]) => Promise<string>;
+    getAllTopics: () => SemanticRef[];
+    addMessageAsync: (message: Message, rebuild?: boolean) => Promise<boolean>;
+    loadFromFile: (filePath: string, rebuild?: boolean) => void;
+    lemmatize: () => LemmatizationResult;
+    expandRelatedTerms: (options?: RelatedTermsExpansionOptions) => Promise<RelatedTermsExpansionResult>;
+    expandWithWordNet: (options?: WordNetExpansionOptions) => Promise<RelatedTermsExpansionResult>;
+}
+export declare function createConversation(messages: IMessageCollection<Message>, name: string, storageProvider: InMemoryStorageProvider): Conversation;
+/**
+ * Returns the time range for a conversation: the timestamps of the first and last messages
+ * If messages have no timestamps (which are optional), returns undefined
+ * @param conversation
+ * @returns {DateRange}
+ */
+export declare function getTimeRangeForConversation(conversation: IConversation): DateRange | undefined;
+export declare function getTimeRangePromptSectionForConversation(conversation: IConversation): PromptSection[];
+/**
+ * Exported index format (from @export command or benchmark export)
+ */
+export interface ExportedIndex {
+    indexData: {
+        items: Array<{
+            term: string;
+            semanticRefOrdinals: Array<{
+                semanticRefOrdinal: number;
+                score: number;
+            }>;
+        }>;
+    };
+    semanticRefs: SemanticRef[];
+    messages: Array<{
+        ordinal: number;
+        content: string;
+        timestamp?: string;
+    }>;
+    stats?: {
+        termCount: number;
+        refCount: number;
+        messageCount: number;
+    };
+}
+/**
+ * Load a conversation from an exported index JSON file.
+ * This allows querying a pre-built index without re-extracting knowledge.
+ */
+export declare function loadConversationFromExport(exportPath: string, name?: string): Conversation;
+/**
+ * Load a conversation from exported index data.
+ */
+export declare function loadConversationFromExportData(exported: ExportedIndex, name?: string): Conversation;
+//# sourceMappingURL=conversation.d.ts.map

package/dist/knowpro/conversation.d.ts.map

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