@chatman-media/kb 1.3.0

package/dist/conversation-store.d.ts

@@ -0,0 +1,76 @@
+import type { ChatMessage } from "@chatman-media/llm-router";
+/**
+ * Unified interface for persisting conversation history and summaries.
+ *
+ * Implement this for your storage backend (PostgreSQL, Redis, SQLite, …).
+ * An in-memory reference implementation is exported as `InMemoryConversationStore`.
+ */
+export interface IConversationStore {
+    /** Append one message to the conversation history. */
+    addMessage(conversationId: string, message: ChatMessage): Promise<void>;
+    /** Return messages in chronological order. Returns [] for unknown ids. */
+    getHistory(conversationId: string): Promise<ChatMessage[]>;
+    /**
+     * Replace the stored history with a shorter version (e.g. after summarisation).
+     * Typically called with the last N messages after older turns are compressed.
+     */
+    setHistory(conversationId: string, messages: ChatMessage[]): Promise<void>;
+    /** Store or update the running summary for the conversation. */
+    setSummary(conversationId: string, summary: string): Promise<void>;
+    /** Retrieve the current summary, or null if none exists. */
+    getSummary(conversationId: string): Promise<string | null>;
+    /** Remove all data for a conversation (GDPR deletion, session reset, …). */
+    deleteConversation(conversationId: string): Promise<void>;
+}
+/**
+ * Zero-dependency in-memory `IConversationStore`.
+ *
+ * Suitable for tests, prototypes, and single-process deployments.
+ * Data is lost on process restart — use a database-backed implementation
+ * for production.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   InMemoryConversationStore,
+ *   summarizeConversation,
+ *   answerWithRag,
+ * } from "@chatman-media/kb";
+ *
+ * const store = new InMemoryConversationStore({ maxHistoryLength: 20, ttlMs: 2 * 60 * 60_000 });
+ *
+ * // Each turn:
+ * const history = await store.getHistory(userId);
+ * const summary = await store.getSummary(userId);
+ * const result = await answerWithRag({ question, kb, chat, embedder, history, conversationSummary: summary ?? undefined });
+ * await store.addMessage(userId, { role: "user", content: question });
+ * await store.addMessage(userId, { role: "assistant", content: result.text });
+ *
+ * // Compress when history grows long:
+ * if (history.length > 30) {
+ *   const newSummary = await summarizeConversation({ history, chat });
+ *   await store.setSummary(userId, newSummary);
+ *   await store.setHistory(userId, history.slice(-10));
+ * }
+ * ```
+ */
+export declare class InMemoryConversationStore implements IConversationStore {
+    private readonly data;
+    private readonly maxHistoryLength;
+    private readonly ttlMs;
+    constructor(opts?: {
+        maxHistoryLength?: number;
+        ttlMs?: number;
+    });
+    addMessage(conversationId: string, message: ChatMessage): Promise<void>;
+    getHistory(conversationId: string): Promise<ChatMessage[]>;
+    setHistory(conversationId: string, messages: ChatMessage[]): Promise<void>;
+    setSummary(conversationId: string, summary: string): Promise<void>;
+    getSummary(conversationId: string): Promise<string | null>;
+    deleteConversation(conversationId: string): Promise<void>;
+    /** Number of active (non-expired) conversations. */
+    get size(): number;
+    private getOrCreate;
+    private isExpired;
+}
+//# sourceMappingURL=conversation-store.d.ts.map

package/dist/conversation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-store.d.ts","sourceRoot":"","sources":["../src/conversation-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE,0EAA0E;IAC1E,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE3D;;;OAGG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E,gEAAgE;IAChE,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,4DAA4D;IAC5D,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE3D,4EAA4E;IAC5E,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuC;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,IAAI,GAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAK9D,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAM1D,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1E,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM1D,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,oDAAoD;IACpD,IAAI,IAAI,IAAI,MAAM,CAMjB;IAED,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/eval.d.ts

@@ -0,0 +1,64 @@
+import type { KbSearchHit } from "./types.ts";
+/**
+ * One labelled query for retrieval evaluation.
+ * `relevantChunkIds` are the ground-truth chunk ids that should be retrieved.
+ */
+export interface EvalQuery {
+    question: string;
+    relevantChunkIds: number[];
+}
+/** Per-query metrics returned by `evalRetrieval`. */
+export interface QueryMetrics {
+    question: string;
+    /** Fraction of relevant chunks found in the top-k results (0–1). */
+    recallAtK: number;
+    /** Mean Reciprocal Rank — position of the first relevant hit (0–1). */
+    mrr: number;
+    /** Normalised Discounted Cumulative Gain (0–1). */
+    ndcg: number;
+    /** Chunk ids that were retrieved. */
+    retrievedIds: number[];
+}
+/** Aggregated metrics over a full eval set. */
+export interface EvalResult {
+    /** Arithmetic mean of recall@k across all queries. */
+    meanRecallAtK: number;
+    /** Arithmetic mean of MRR across all queries. */
+    meanMrr: number;
+    /** Arithmetic mean of NDCG across all queries. */
+    meanNdcg: number;
+    /** Per-query breakdown. */
+    queries: QueryMetrics[];
+}
+/**
+ * Evaluate retrieval quality over a labelled query set.
+ *
+ * Runs `retrieve(query)` for each `EvalQuery`, compares the returned chunk ids
+ * against the ground-truth relevant ids, and reports recall@k, MRR, and NDCG.
+ *
+ * @param queries     Labelled queries with ground-truth chunk ids.
+ * @param retrieve    Function that takes a question and returns `KbSearchHit[]`.
+ *                    Wrap your `kb.search()` / `kb.hybridSearch()` call here.
+ *
+ * @example
+ * ```ts
+ * import { evalRetrieval } from "@chatman-media/kb";
+ *
+ * const result = await evalRetrieval(
+ *   [
+ *     { question: "Какая зарплата в Дубае?", relevantChunkIds: [12, 15] },
+ *     { question: "Нужна ли виза?",          relevantChunkIds: [7] },
+ *   ],
+ *   async (q) => {
+ *     const [vec] = await embedder.embed([q]);
+ *     return kb.hybridSearch({ embedding: vec!, query: q, k: 5 });
+ *   },
+ * );
+ *
+ * console.log(`recall@5: ${result.meanRecallAtK.toFixed(3)}`);
+ * console.log(`MRR:      ${result.meanMrr.toFixed(3)}`);
+ * console.log(`NDCG:     ${result.meanNdcg.toFixed(3)}`);
+ * ```
+ */
+export declare function evalRetrieval(queries: EvalQuery[], retrieve: (question: string) => Promise<KbSearchHit[]>): Promise<EvalResult>;
+//# sourceMappingURL=eval.d.ts.map

package/dist/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../src/eval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,SAAS,EAAE,EACpB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,GACrD,OAAO,CAAC,UAAU,CAAC,CA0BrB"}

package/dist/extract-user-facts.d.ts

@@ -0,0 +1,27 @@
+import type { ChatClient, ChatMessage } from "@chatman-media/llm-router";
+/**
+ * Extracts persistent facts ABOUT THE CANDIDATE (not the bot persona) from
+ * a slice of conversation. Used by the cross-session memory layer in
+ * webhook → after each turn the new messages are passed here and the result
+ * merged into `users.profile_json.memory.facts`.
+ *
+ * Facts schema is flexible — the prompt encourages the most common keys for
+ * the recruitment use-case but allows free-form keys when the candidate
+ * volunteers something unusual ("instagram", "previous_agency", …). Only
+ * volunteered facts are returned — no inference or guessing.
+ */
+export interface ExtractFactsInput {
+    /** Recent messages, oldest first. Should include both user and bot turns. */
+    messages: ChatMessage[];
+    chat: ChatClient;
+    /** Existing facts so the LLM doesn't re-emit already-known data. */
+    existingFacts?: Record<string, string>;
+}
+export declare function extractUserFacts(input: ExtractFactsInput): Promise<Record<string, string>>;
+/**
+ * Parses the LLM output — strips think-tags and markdown fences, finds the
+ * JSON object, validates that values are short strings, caps total keys.
+ * Exported for unit tests.
+ */
+export declare function parseFactsFromLlmOutput(raw: string): Record<string, string>;
+//# sourceMappingURL=extract-user-facts.d.ts.map

package/dist/extract-user-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-user-facts.d.ts","sourceRoot":"","sources":["../src/extract-user-facts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAmCD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwBhG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiC3E"}

package/dist/fact-checker.d.ts

@@ -0,0 +1,46 @@
+import type { ChatClient } from "@chatman-media/llm-router";
+/**
+ * Unified fact-checker — replaces the separate reflect.ts + vacancy-guard.ts
+ * pipeline with a single LLM call that checks both:
+ *
+ *   1. KB grounding: every concrete fact in the answer is supported by the
+ *      retrieved KB context (no hallucinations).
+ *
+ *   2. Vacancy accuracy: any salary/city/condition data matches the
+ *      authoritative АКТУАЛЬНЫЕ ВАКАНСИИ block from the DB table.
+ *      ВАКАНСИИ always win over KB chunks when they conflict — an old
+ *      chat log with a stale salary is not a valid grounding source.
+ *
+ * Cost: 1 LLM call per turn (was 2 with separate reflect + vacancy-guard).
+ *
+ * **Fail-closed by default**: on any LLM or parse error returns
+ * `{ grounded: false, vacancyOk: false, reason: "checker_error: …" }` so the
+ * caller treats the reply as ungrounded and escalates to silence/operator
+ * instead of shipping a potentially-hallucinated answer. The legacy
+ * fail-open behaviour can be restored with `RAG_FACT_CHECKER_FAIL_OPEN=1`
+ * (kept for test fixtures that drive the checker with mock failures).
+ */
+export interface FactCheckInput {
+    question: string;
+    answer: string;
+    /** KB chunks concatenated — same string passed to the generator. */
+    context: string;
+    chat: ChatClient;
+    /** Optional: rendered АКТУАЛЬНЫЕ ВАКАНСИИ block.
+     *  When provided, vacancy facts are checked against it as the authoritative
+     *  source. KB chunks that contradict it are treated as outdated. */
+    vacanciesBlock?: string;
+}
+export interface FactCheckResult {
+    /** All concrete facts in the answer are found in context (or vacanciesBlock). */
+    grounded: boolean;
+    /** All vacancy-specific facts (salary, city, conditions) match vacanciesBlock.
+     *  Always true when vacanciesBlock was not provided. */
+    vacancyOk: boolean;
+    /** Human-readable reason when grounded=false or vacancyOk=false. */
+    reason?: string;
+}
+export declare function checkFacts(input: FactCheckInput): Promise<FactCheckResult>;
+/** Exported for unit tests. */
+export declare function parseFactCheckResult(raw: string): FactCheckResult;
+//# sourceMappingURL=fact-checker.d.ts.map

package/dist/fact-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-checker.d.ts","sourceRoot":"","sources":["../src/fact-checker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,2BAA2B,CAAC;AAGzE;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB;;wEAEoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB;4DACwD;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0DD,wBAAsB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAyChF;AAED,+BAA+B;AAC/B,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAuBjE"}

package/dist/grade-skills.d.ts

@@ -0,0 +1,29 @@
+/**
+ * After the bot has generated a reply, optionally ask a small LLM to
+ * inspect the (system_prompt → user → assistant) triple and report which
+ * of the configured skills (slugs) it actually used. Output goes into
+ * `messages.meta_json.telemetry.skills_used` for downstream attribution
+ * (Phase 2: ELO over outcomes; Phase 3: self-play).
+ *
+ * Cost: +1 LLM call per assistant turn. Gated behind RAG_SKILL_GRADING=true
+ * because for high-volume single-style production it's overkill — flip on
+ * during A/B research windows, off in steady state.
+ *
+ * Failure-soft: any error → returns empty array, never throws. The whole
+ * point is post-hoc analytics, not a hard dependency.
+ */
+import type { ChatClient } from "@chatman-media/llm-router";
+export interface GradeSkillsInput {
+    question: string;
+    reply: string;
+    /** Slugs offered to the model in the system prompt (only these are valid). */
+    availableSlugs: readonly string[];
+    chat: ChatClient;
+    /** Lightweight model id — falls back to the chat client's default if undefined. */
+    model?: string;
+}
+export declare function gradeSkills(input: GradeSkillsInput): Promise<string[]>;
+/** Tolerant parser — accepts a bare JSON array, code-fenced JSON, or
+ *  comma-separated text. Filters to allowed slugs. Exported for tests. */
+export declare function parseSlugList(raw: string, allowed: readonly string[]): string[];
+//# sourceMappingURL=grade-skills.d.ts.map

package/dist/grade-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-skills.d.ts","sourceRoot":"","sources":["../src/grade-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB5E;AAED;0EAC0E;AAC1E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAuB/E"}

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @chatman-media/kb — production-grade RAG engine for conversational bots.
+ *
+ * Quick start:
+ *
+ * ```ts
+ * import { answerWithRag, OpenAIChatClient, OpenAIEmbeddingClient } from "@chatman-media/kb";
+ *
+ * const chat = new OpenAIChatClient({ apiKey, baseUrl, model: "gpt-4o-mini" });
+ * const embedder = new OpenAIEmbeddingClient({ apiKey, baseUrl, model: "text-embedding-3-small", dim: 1536 });
+ *
+ * const result = await answerWithRag({ question, kb: myKbStore, chat, embedder });
+ * console.log(result.text);
+ * ```
+ *
+ * See README.md for full usage and `IKbStore` implementation guide.
+ */
+export type { ABRouterOptions, ABVariant } from "./ab-router.ts";
+export { ABRouter } from "./ab-router.ts";
+export { answerWithRag, answerWithRagStream, generateSoftFallback, retrieveHits, type RetrievalResult, } from "./answer.ts";
+export type { AnswerInput, AnswerResult, AnswerTelemetry, Persona } from "./answer-types.ts";
+export { NO_CONTEXT_MARKER } from "./answer-types.ts";
+export type { ChatClient, ChatCompletionOpts, ChatMessage, ChatRole, } from "@chatman-media/llm-router";
+export { ChatApiError, OpenAIChatClient } from "@chatman-media/llm-router";
+export type { Chunk, ChunkOptions, SectionChunk } from "./chunk.ts";
+export { chunkBySections, chunkText, estimateTokens } from "./chunk.ts";
+export type { IConversationStore } from "./conversation-store.ts";
+export { InMemoryConversationStore } from "./conversation-store.ts";
+export type { EmbeddingClient } from "@chatman-media/llm-router";
+export { EmbeddingApiError, NullEmbeddingClient, OpenAIEmbeddingClient, } from "@chatman-media/llm-router";
+export type { EvalQuery, EvalResult, QueryMetrics } from "./eval.ts";
+export { evalRetrieval } from "./eval.ts";
+export type { ExtractFactsInput } from "./extract-user-facts.ts";
+export { extractUserFacts, parseFactsFromLlmOutput } from "./extract-user-facts.ts";
+export type { FactCheckInput, FactCheckResult } from "./fact-checker.ts";
+export { checkFacts, parseFactCheckResult } from "./fact-checker.ts";
+export type { GradeSkillsInput } from "./grade-skills.ts";
+export { gradeSkills } from "./grade-skills.ts";
+export type { IngestDeps, IngestDirectorySummary, IngestFileResult } from "./ingest.ts";
+export { deriveTopicFromPath, ingestDirectory, ingestFile, ingestText, stripNonContent, } from "./ingest.ts";
+export { parsePdf, parsePdfBuffer } from "./parse-pdf.ts";
+export { botPresenceReply, isBotPresenceQuestion, isPersonalFactQuestion, isPersonaSmalltalkQuestion, personaFactReply, personaSmalltalkReply, } from "./persona-shortcuts.ts";
+export { composeSystemPrompt } from "./prompt.ts";
+export type { OllamaChatOptions, OllamaEmbeddingOptions, OpenRouterChatOptions, } from "@chatman-media/llm-router";
+export { OllamaChatClient, OllamaEmbeddingClient, OpenRouterChatClient, } from "@chatman-media/llm-router";
+export type { ReflectInput, ReflectResult } from "./reflect.ts";
+export { parseReflection, verifyAnswer } from "./reflect.ts";
+export type { CohereRerankerOptions, JinaRerankerOptions, Reranker } from "./reranker.ts";
+export { CohereReranker, JinaReranker } from "./reranker.ts";
+export type { RetryOptions } from "./retry.ts";
+export { withRetryChatClient, withRetryEmbeddingClient } from "./retry.ts";
+export type { RewriteQueryInput } from "./rewrite-query.ts";
+export { questionNeedsRewrite, rewriteQuery, sanitizeRewritten } from "./rewrite-query.ts";
+export { sanitizeLlmOutput } from "./sanitize.ts";
+export type { SemanticCacheOptions } from "./semantic-cache.ts";
+export { SemanticCache } from "./semantic-cache.ts";
+export type { RagRequestBody, RagServerOptions } from "./server.ts";
+export { createRagServer } from "./server.ts";
+export { InMemoryKbStore } from "./stores/memory-store.ts";
+export { parseStructuredOutput, zodToJsonSchema } from "./structured-output.ts";
+export type { ComposeOptions, DirectorHookForPrompt, FunnelStage, Hook, HookKind, SalesFramework, SkillForPrompt, StageConfig, Style, StylePersona, } from "./styles.ts";
+export { FUNNEL_STAGES, HookSchema, PersonaSchema, SALES_FRAMEWORKS, StyleSchema, } from "./styles.ts";
+export type { SummarizeInput } from "./summarize-conversation.ts";
+export { cleanSummary, summarizeConversation } from "./summarize-conversation.ts";
+export { buildSystemPrompt, DEFAULT_PERSONA, legacyRagSamplingTemperature, renderSummaryBlock, renderUserFactsBlock, } from "./system-prompt.ts";
+export type { TextStyleRule } from "./text-style-rules.ts";
+export { applyStyleRules, capitalizeFirstLetter, DEFAULT_STYLE_RULES, replaceEllipsis, replaceEmDash, stripAILeadIns, stripMarkdownBold, } from "./text-style-rules.ts";
+export type { AnyRagTool, CompleteWithToolsResult, RagTool } from "./tools.ts";
+export { makeBookingLinkTool } from "./built-in-tools/calendly.ts";
+export { buildToolTelemetry, DEFAULT_MAX_TOOL_CYCLES, runToolLoop, type ToolCallRecord, type ToolLoopResult, } from "./tool-loop.ts";
+export { classifyTopic, classifyTopicAll, KNOWN_TOPICS } from "./topic-classifier.ts";
+export type { IKbStore, IKbSuggestionsStore, KbSearchHit } from "./types.ts";
+export { reciprocalRankFusion, sanitizeFtsQuery } from "./utils.ts";
+export type { ClassifyPhotoOptions, PassportIdentity, PhotoClass, VisionProvider, } from "./vision.ts";
+export { classifyPhoto, extractPassportIdentity, PHOTO_CLASSES, parsePassportJson, parsePhotoClass, } from "./vision.ts";
+//# 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":"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"}