fawn-memory 0.0.3

package/dist/knowpro/knowledge.js

@@ -0,0 +1,97 @@
+import { createJsonTranslator } from "typechat";
+import { loadSchema } from "./schema.js";
+import { createTypeScriptJsonValidator } from "typechat/ts";
+import { mergeEntityFacet } from "./entities.js";
+import { getResultWithRetry } from "../utils/async.js";
+export function createKnowledgeTranslator(model) {
+    const schema = loadSchema(["knowledgeSchema.ts"], import.meta.url);
+    const typeName = "KnowledgeResponse";
+    const validator = createTypeScriptJsonValidator(schema, typeName);
+    const translator = createJsonTranslator(model, validator);
+    translator.createRequestPrompt = createRequestPrompt;
+    return translator;
+    function createRequestPrompt(request) {
+        return (`You are a service that translates user messages in a conversation into JSON objects of type "${typeName}" according to the following TypeScript definitions:\n` +
+            `\`\`\`\n${schema}\`\`\`\n` +
+            `The following are messages in a conversation:\n` +
+            `"""\n${request}\n"""\n` +
+            `The following is the user request translated into a JSON object with 2 spaces of indentation and no properties with the value undefined:\n`);
+    }
+}
+/**
+ * Return default settings
+ * @param maxCharsPerChunk (optional)
+ * @returns
+ */
+export function createKnowledgeExtractorSettings(maxCharsPerChunk = 2048) {
+    return {
+        maxContextLength: maxCharsPerChunk,
+        mergeActionKnowledge: true,
+    };
+}
+/**
+ * Create a new knowledge extractor
+ * @param model
+ * @param extractorSettings
+ * @param knowledgeTranslator (optional) knowledge translator to use
+ * @returns
+ */
+export function createKnowledgeExtractor(model, extractorSettings, knowledgeTranslator) {
+    const settings = extractorSettings ?? createKnowledgeExtractorSettings();
+    const translator = knowledgeTranslator ?? createKnowledgeTranslator(model);
+    const extractor = {
+        settings,
+        extract,
+        extractWithRetry,
+        translator,
+    };
+    return extractor;
+    async function extract(message) {
+        const result = await extractKnowledge(message);
+        if (!result.success) {
+            return undefined;
+        }
+        return result.data;
+    }
+    function extractWithRetry(message, maxRetries) {
+        return getResultWithRetry(() => extractKnowledge(message), maxRetries);
+    }
+    async function extractKnowledge(message) {
+        const result = await (extractor.translator ?? translator).translate(message);
+        if (result.success) {
+            if (settings.mergeActionKnowledge || settings.mergeEntityFacets) {
+                mergeActionKnowledge(result.data);
+            }
+        }
+        return result;
+    }
+    //
+    // Some knowledge found via actions is actually meant for entities...
+    //
+    function mergeActionKnowledge(knowledge) {
+        if (knowledge.actions === undefined) {
+            knowledge.actions = [];
+        }
+        if (settings.mergeActionKnowledge) {
+            // Merge all inverse actions into regular actions.
+            if (knowledge.inverseActions &&
+                knowledge.inverseActions.length > 0) {
+                knowledge.actions.push(...knowledge.inverseActions);
+                knowledge.inverseActions = [];
+            }
+        }
+        if (settings.mergeActionKnowledge || settings.mergeEntityFacets) {
+            // Also merge in any facets into
+            for (const action of knowledge.actions) {
+                if (action.subjectEntityFacet) {
+                    const entity = knowledge.entities.find((c) => c.name === action.subjectEntityName);
+                    if (entity) {
+                        mergeEntityFacet(entity, action.subjectEntityFacet);
+                    }
+                    action.subjectEntityFacet = undefined;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/knowpro/knowledge.js.map

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

package/dist/knowpro/knowledgeSchema.d.ts

@@ -0,0 +1,39 @@
+export type Quantity = {
+    amount: number;
+    units: string;
+};
+export type Quantifier = {
+    amount: string;
+    units: string;
+};
+export type Value = string | number | boolean | Quantity | Quantifier;
+export type Facet = {
+    name: string;
+    value: Value;
+};
+export type ConcreteEntity = {
+    name: string;
+    type: string[];
+    facets?: Facet[];
+};
+export type ActionParam = {
+    name: string;
+    value: Value;
+};
+export type VerbTense = "past" | "present" | "future";
+export type Action = {
+    verbs: string[];
+    verbTense: VerbTense;
+    subjectEntityName: string | "none";
+    objectEntityName: string | "none";
+    indirectObjectEntityName: string | "none";
+    params?: (string | ActionParam)[];
+    subjectEntityFacet?: Facet | undefined;
+};
+export type KnowledgeResponse = {
+    entities: ConcreteEntity[];
+    actions: Action[];
+    inverseActions: Action[];
+    topics: string[];
+};
+//# sourceMappingURL=knowledgeSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeSchema.d.ts","sourceRoot":"","sources":["../../src/knowpro/knowledgeSchema.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAGF,MAAM,MAAM,UAAU,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtE,MAAM,MAAM,KAAK,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,KAAK,CAAC;CAChB,CAAC;AAGF,MAAM,MAAM,cAAc,GAAG;IAEzB,IAAI,EAAE,MAAM,CAAC;IAGb,IAAI,EAAE,MAAM,EAAE,CAAC;IAIf,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,MAAM,GAAG;IAEjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,wBAAwB,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC;IAElC,kBAAkB,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1C,CAAC;AAGF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAGlB,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC"}

package/dist/knowpro/knowledgeSchema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=knowledgeSchema.js.map

package/dist/knowpro/knowledgeSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeSchema.js","sourceRoot":"","sources":["../../src/knowpro/knowledgeSchema.ts"],"names":[],"mappings":""}

package/dist/knowpro/llmProvider.d.ts

@@ -0,0 +1,17 @@
+import type { TypeChatLanguageModel } from 'typechat';
+export type LLMProviderType = 'openai' | 'claude';
+export interface LLMProviderConfig {
+    provider: LLMProviderType;
+    apiKey: string;
+    model?: string;
+}
+export interface LLMProvider {
+    readonly name: LLMProviderType;
+    readonly model: string;
+    getLanguageModel(): TypeChatLanguageModel;
+}
+export declare function createOpenAIProvider(apiKey: string, model?: string): LLMProvider;
+export declare function createClaudeProvider(apiKey: string, model?: string): LLMProvider;
+export declare function createLLMProvider(config: LLMProviderConfig): LLMProvider;
+export declare function createLLMProviderFromEnv(): LLMProvider;
+//# sourceMappingURL=llmProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llmProvider.d.ts","sourceRoot":"","sources":["../../src/knowpro/llmProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAyB,MAAM,UAAU,CAAC;AAG7E,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gBAAgB,IAAI,qBAAqB,CAAC;CAC3C;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAiB,GACvB,WAAW,CAOb;AAiBD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAmC,GACzC,WAAW,CA0Db;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CASxE;AAED,wBAAgB,wBAAwB,IAAI,WAAW,CAiBtD"}

package/dist/knowpro/llmProvider.js

@@ -0,0 +1,105 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { createOpenAILanguageModel, success, error } from 'typechat';
+export function createOpenAIProvider(apiKey, model = 'gpt-4o') {
+    const languageModel = createOpenAILanguageModel(apiKey, model);
+    return {
+        name: 'openai',
+        model,
+        getLanguageModel: () => languageModel
+    };
+}
+function getContentAsString(content) {
+    if (typeof content === 'string') {
+        return content;
+    }
+    return content.map(c => {
+        if (typeof c === 'string') {
+            return c;
+        }
+        if (c.type === 'text') {
+            return c.text;
+        }
+        return '';
+    }).join('');
+}
+export function createClaudeProvider(apiKey, model = 'claude-sonnet-4-20250514') {
+    const client = new Anthropic({ apiKey });
+    const languageModel = {
+        retryMaxAttempts: 3,
+        retryPauseMs: 1000,
+        async complete(prompt) {
+            try {
+                let systemMessage;
+                let userMessages = [];
+                if (typeof prompt === 'string') {
+                    userMessages = [{ role: 'user', content: prompt }];
+                }
+                else {
+                    for (const section of prompt) {
+                        const contentStr = getContentAsString(section.content);
+                        if (section.role === 'system') {
+                            systemMessage = systemMessage
+                                ? `${systemMessage}\n\n${contentStr}`
+                                : contentStr;
+                        }
+                        else if (section.role === 'user' || section.role === 'assistant') {
+                            userMessages.push({
+                                role: section.role,
+                                content: contentStr
+                            });
+                        }
+                    }
+                }
+                if (userMessages.length === 0) {
+                    userMessages = [{ role: 'user', content: '' }];
+                }
+                const response = await client.messages.create({
+                    model,
+                    max_tokens: 4096,
+                    system: systemMessage,
+                    messages: userMessages
+                });
+                const textContent = response.content.find(block => block.type === 'text');
+                if (!textContent || textContent.type !== 'text') {
+                    return error('No text response from Claude');
+                }
+                return success(textContent.text);
+            }
+            catch (e) {
+                const message = e instanceof Error ? e.message : String(e);
+                return error(`Claude API error: ${message}`);
+            }
+        }
+    };
+    return {
+        name: 'claude',
+        model,
+        getLanguageModel: () => languageModel
+    };
+}
+export function createLLMProvider(config) {
+    switch (config.provider) {
+        case 'openai':
+            return createOpenAIProvider(config.apiKey, config.model);
+        case 'claude':
+            return createClaudeProvider(config.apiKey, config.model);
+        default:
+            throw new Error(`Unknown provider: ${config.provider}`);
+    }
+}
+export function createLLMProviderFromEnv() {
+    const provider = (process.env.LLM_PROVIDER || 'openai');
+    let apiKey;
+    if (provider === 'claude') {
+        apiKey = process.env.ANTHROPIC_API_KEY;
+    }
+    else {
+        apiKey = process.env.OPENAI_API_KEY || process.env.OPENAI_SDK_KEY;
+    }
+    const model = process.env.LLM_MODEL;
+    if (!apiKey) {
+        throw new Error(`Missing API key for provider: ${provider}`);
+    }
+    return createLLMProvider({ provider, apiKey, model });
+}
+//# sourceMappingURL=llmProvider.js.map

package/dist/knowpro/llmProvider.js.map

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

package/dist/knowpro/relatedTermsSchema.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Schema for LLM-based related terms expansion.
+ * Given a list of terms, the LLM returns semantically related words.
+ */
+/**
+ * A term and its semantically related words.
+ */
+export interface TermWithRelated {
+    /** The original term */
+    term: string;
+    /** Semantically related words (synonyms, near-synonyms, conceptually related).
+     * Do NOT include morphological variants (plurals, verb tenses) - only semantically different words.
+     * Examples: book -> [novel, publication, text], buy -> [purchase, acquire], happy -> [joyful, pleased]
+     */
+    relatedTerms: string[];
+}
+/**
+ * Response containing related terms for a batch of input terms.
+ */
+export interface RelatedTermsResponse {
+    /** Array of terms with their related words */
+    terms: TermWithRelated[];
+}
+//# sourceMappingURL=relatedTermsSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relatedTermsSchema.d.ts","sourceRoot":"","sources":["../../src/knowpro/relatedTermsSchema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,8CAA8C;IAC9C,KAAK,EAAE,eAAe,EAAE,CAAC;CAC5B"}

package/dist/knowpro/relatedTermsSchema.js

@@ -0,0 +1,6 @@
+/**
+ * Schema for LLM-based related terms expansion.
+ * Given a list of terms, the LLM returns semantically related words.
+ */
+export {};
+//# sourceMappingURL=relatedTermsSchema.js.map

package/dist/knowpro/relatedTermsSchema.js.map

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

package/dist/knowpro/schema.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Schema for a type
+ */
+export type TypeSchema = {
+    /**
+     * Name of the type for which this is a schema
+     */
+    typeName: string;
+    /**
+     * Schema text for the type
+     */
+    schemaText: string;
+};
+/**
+ * Loads schema files and combines them into one
+ * Also removes all import statements from the combined file, to prevent
+ * module install/dependency issues when TypeChat validates messages
+ * @param filePaths file paths to import from
+ * @param basePath base path if file paths are relative
+ * @returns
+ */
+export declare function loadSchema(filePaths: string[], basePath?: string): string;
+export declare function loadSchemaFiles(filePaths: string[], basePath?: string): string[];
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/knowpro/schema.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAOzE;AAED,wBAAgB,eAAe,CAC3B,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,CAAC,EAAE,MAAM,GAClB,MAAM,EAAE,CAaV"}

package/dist/knowpro/schema.js

@@ -0,0 +1,55 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Module with Schema related functions
+import fs from "fs";
+import ts from "typescript";
+import { fileURLToPath } from "url";
+import path from "path";
+/**
+ * Loads schema files and combines them into one
+ * Also removes all import statements from the combined file, to prevent
+ * module install/dependency issues when TypeChat validates messages
+ * @param filePaths file paths to import from
+ * @param basePath base path if file paths are relative
+ * @returns
+ */
+export function loadSchema(filePaths, basePath) {
+    let schemaText = "";
+    for (const fileText of loadSchemaFiles(filePaths, basePath)) {
+        schemaText += fileText;
+        schemaText += "\n";
+    }
+    return schemaText;
+}
+export function loadSchemaFiles(filePaths, basePath) {
+    const schemaText = [];
+    for (const file of filePaths) {
+        let filePath = file;
+        if (!path.isAbsolute(file) && basePath) {
+            filePath = fileURLToPath(new URL(file, basePath));
+        }
+        const rawText = fs.readFileSync(filePath, "utf-8");
+        let fileText = stripImports(filePath, rawText);
+        fileText = stripCopyright(fileText);
+        schemaText.push(fileText);
+    }
+    return schemaText;
+}
+function stripImports(filePath, schemaText) {
+    const sourceFile = ts.createSourceFile(filePath, schemaText, ts.ScriptTarget.Latest);
+    const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
+    const nodes = sourceFile?.statements.filter((node) => {
+        return !ts.isImportDeclaration(node);
+    });
+    let text = "";
+    nodes.forEach((n) => (text +=
+        printer.printNode(ts.EmitHint.Unspecified, n, sourceFile) +
+            "\n"));
+    return text;
+}
+function stripCopyright(schemaText) {
+    schemaText = schemaText.replace("// Copyright (c) Microsoft Corporation.", "");
+    schemaText = schemaText.replace("// Licensed under the MIT License.", "");
+    return schemaText;
+}
+//# sourceMappingURL=schema.js.map

package/dist/knowpro/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/knowpro/schema.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,uCAAuC;AACvC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAgBxB;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,SAAmB,EAAE,QAAiB;IAC7D,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,QAAQ,IAAI,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC1D,UAAU,IAAI,QAAQ,CAAC;QACvB,UAAU,IAAI,IAAI,CAAC;IACvB,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,eAAe,CAC3B,SAAmB,EACnB,QAAiB;IAEjB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,QAAQ,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;YACrC,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,OAAO,GAAW,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,UAAkB;IACtD,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAClC,QAAQ,EACR,UAAU,EACV,EAAE,CAAC,YAAY,CAAC,MAAM,CACzB,CAAC;IACF,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACjD,OAAO,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAM,CAAC,OAAO,CACV,CAAC,CAAC,EAAE,EAAE,CACF,CAAC,IAAI;QACD,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,UAAW,CAAC;YAC1D,IAAI,CAAC,CAChB,CAAC;IACF,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB;IACtC,UAAU,GAAG,UAAU,CAAC,OAAO,CAC3B,yCAAyC,EACzC,EAAE,CACL,CAAC;IACF,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,oCAAoC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/dist/knowpro/search.d.ts

@@ -0,0 +1,8 @@
+import type * as contextSchema from "./answerContextSchema.js";
+import type { AnswerTranslator } from "./answerTranslator.js";
+import type { Message } from "./conversation.js";
+import type { IConversationSecondaryIndexes, IMessageCollection, ISemanticRefCollection, ITermToSemanticRefIndex } from "./interfaces.js";
+import type { SearchQuery } from "./searchQuerySchema.js";
+export declare function generateAnswer(rawQuery: string, compiledQuery: contextSchema.AnswerContext, answerTranslator: AnswerTranslator): Promise<import("typechat").Result<import("./answerResponseSchema.js").AnswerResponse>>;
+export declare function compileContext(query: SearchQuery, semanticRefIndex: ITermToSemanticRefIndex, semanticRefs: ISemanticRefCollection, messages: IMessageCollection<Message>, secondaryIndexes?: IConversationSecondaryIndexes, originalQuery?: string): contextSchema.AnswerContext;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/knowpro/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,uBAAuB,EAAsB,MAAM,iBAAiB,CAAC;AAG9J,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAyC1D,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,aAAa,CAAC,aAAa,EAC1C,gBAAgB,EAAE,gBAAgB,0FAsBrC;AAqHD,wBAAgB,cAAc,CAC1B,KAAK,EAAE,WAAW,EAClB,gBAAgB,EAAE,uBAAuB,EACzC,YAAY,EAAE,sBAAsB,EACpC,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,EACrC,gBAAgB,CAAC,EAAE,6BAA6B,EAChD,aAAa,CAAC,EAAE,MAAM,GACvB,aAAa,CAAC,aAAa,CAwU7B"}