@chatman-media/kb 1.3.0

package/dist/server.d.ts

@@ -0,0 +1,77 @@
+import type { AnswerInput, AnswerTelemetry } from "./answer-types.ts";
+import type { ChatClient } from "@chatman-media/llm-router";
+import type { EmbeddingClient } from "@chatman-media/llm-router";
+import type { IKbStore } from "./types.ts";
+export interface RagServerOptions {
+    /** Knowledge base store. */
+    kb: IKbStore;
+    /** LLM chat client. */
+    chat: ChatClient;
+    /** Embedding client. */
+    embedder: EmbeddingClient;
+    /** Port to listen on. Default: 3000. */
+    port?: number;
+    /** Hostname to bind to. Default: "0.0.0.0". */
+    hostname?: string;
+    /**
+     * Path that the server listens on. Default: "/chat".
+     * POST JSON `{ question, userId?, conversationId?, ... }` → SSE stream of tokens.
+     */
+    path?: string;
+    /**
+     * Extra `AnswerInput` defaults merged into every request.
+     * Request body fields take precedence over these defaults.
+     */
+    defaults?: Partial<Omit<AnswerInput, "question" | "kb" | "chat" | "embedder">>;
+    /**
+     * Called after every answered request with the final telemetry.
+     * Use this to log to your analytics backend.
+     */
+    onTelemetry?: (telemetry: AnswerTelemetry) => void;
+    /**
+     * CORS origin header value. Set to `"*"` to allow all origins.
+     * Default: `undefined` (no CORS headers added).
+     */
+    cors?: string;
+}
+/** Shape of the JSON request body accepted by the RAG server. */
+export interface RagRequestBody {
+    question: string;
+    [key: string]: unknown;
+}
+/**
+ * Lightweight Bun HTTP server that exposes `answerWithRagStream` as an SSE endpoint.
+ *
+ * **Request** — `POST {path}` with `Content-Type: application/json`:
+ * ```json
+ * { "question": "What is the onboarding process?" }
+ * ```
+ * Any additional fields in the body are merged into `AnswerInput` (e.g. `style`,
+ * `history`, `conversationSummary`, `userFacts`).
+ *
+ * **Response** — `text/event-stream`:
+ * ```
+ * data: Hello
+ * data:  world
+ * data: [DONE]
+ * ```
+ * Each `data:` line carries one streamed token. The stream ends with `data: [DONE]`.
+ * On error the server emits `data: [ERROR] <message>` and closes the stream.
+ *
+ * @example
+ * ```ts
+ * import { createRagServer } from "@chatman-media/kb";
+ *
+ * const server = createRagServer({
+ *   kb, chat, embedder,
+ *   port: 3000,
+ *   cors: "*",
+ *   onTelemetry: (t) => console.log("path:", t.path, "ms:", t.latencyMs),
+ * });
+ *
+ * console.log(`Listening on http://localhost:${server.port}`);
+ * // server.stop() to shut down
+ * ```
+ */
+export declare function createRagServer(opts: RagServerOptions): ReturnType<typeof Bun.serve>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,uBAAuB;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,wBAAwB;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAC/E;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAoFpF"}

package/dist/stores/memory-store.d.ts

@@ -0,0 +1,72 @@
+import type { IKbStore, KbSearchHit } from "../types.ts";
+/**
+ * Zero-dependency in-memory `IKbStore` implementation.
+ *
+ * Suitable for:
+ * - Unit / integration tests (no database required)
+ * - Quick prototyping and examples
+ * - Demos and tutorials
+ *
+ * Limitations vs a real pgvector store:
+ * - O(n) linear scan for every search (no index) — fine up to ~50k chunks
+ * - BM25 is a minimal TF-IDF approximation, not a full BM25 implementation
+ * - Data is not persisted across process restarts
+ *
+ * @example
+ * ```ts
+ * import { InMemoryKbStore, ingestText, OllamaEmbeddingClient } from "@chatman-media/kb";
+ *
+ * const kb = new InMemoryKbStore();
+ * const embedder = new OllamaEmbeddingClient({ host: "http://localhost:11434", model: "nomic-embed-text", dim: 768 });
+ *
+ * await ingestText({ title: "FAQ", body: "..." }, { kb, embedder });
+ * const hits = await kb.search(await embedder.embed(["query"])[0], 5);
+ * ```
+ */
+export declare class InMemoryKbStore implements IKbStore {
+    private docs;
+    private chunks;
+    private nextDocId;
+    private nextChunkId;
+    search(embedding: number[], k: number, topic?: string | null): Promise<KbSearchHit[]>;
+    hybridSearch(input: {
+        embedding: number[];
+        query: string;
+        k?: number;
+        topic?: string | null;
+    }): Promise<KbSearchHit[]>;
+    prioritySearch(input: {
+        embedding: number[];
+        query: string;
+        k?: number;
+        vectorOnly?: boolean;
+    }): Promise<KbSearchHit[]>;
+    getDocumentBySource(source: string): Promise<{
+        id: number;
+        content_hash: string;
+    } | null>;
+    countChunksForDocument(documentId: number): Promise<number>;
+    deleteDocument(id: number): Promise<boolean>;
+    upsertDocument(input: {
+        source: string;
+        title: string;
+        contentHash: string;
+        topic?: string | null;
+    }): Promise<{
+        id: number;
+    }>;
+    insertChunkWithEmbedding(input: {
+        documentId: number;
+        chunkIndex: number;
+        text: string;
+        tokenCount: number;
+        embedding: number[];
+    }): Promise<void>;
+    /** Total number of indexed chunks. Useful in tests. */
+    get chunkCount(): number;
+    /** Total number of indexed documents. Useful in tests. */
+    get documentCount(): number;
+    private topicOf;
+    private toHit;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/stores/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/stores/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoBzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;IAIlB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAWrF,YAAY,CAAC,KAAK,EAAE;QACxB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,CAAC,CAAC,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoBpB,cAAc,CAAC,KAAK,EAAE;QAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,CAAC,CAAC,EAAE,MAAM,CAAC;QACX,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAWpB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAKzF,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO5C,cAAc,CAAC,KAAK,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBrB,wBAAwB,CAAC,KAAK,EAAE;QACpC,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjB,uDAAuD;IACvD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,0DAA0D;IAC1D,IAAI,aAAa,IAAI,MAAM,CAE1B;IAID,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;CAWd"}

package/dist/structured-output.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+/**
+ * Injects a JSON output instruction into the system prompt when native
+ * structured output is not available (Ollama, OpenRouter, etc.).
+ */
+export declare function injectJsonInstruction(systemPrompt: string, jsonSchema: Record<string, unknown>): string;
+/**
+ * Parses and validates an LLM response against a Zod schema.
+ * Strips markdown code fences if present before parsing.
+ * Returns `{ success: true, data }` or `{ success: false, error }`.
+ */
+export declare function parseStructuredOutput<T extends z.ZodTypeAny>(raw: string, schema: T): {
+    success: true;
+    data: z.infer<T>;
+} | {
+    success: false;
+    error: string;
+};
+/** Converts a Zod schema to a JSON Schema object for OpenAI's response_format. */
+export declare function zodToJsonSchema(schema: z.ZodTypeAny): Record<string, unknown>;
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../src/structured-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC1D,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,GACR;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBzE;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE7E"}

package/dist/styles.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Sales-style engine — typed schema for conversational personas.
+ *
+ * A `Style` bundles persona + voice + sales framework + Cialdini hooks +
+ * per-stage instructions + few-shot examples + guardrails + model pin.
+ * Styles are the unit of A/B testing in the sales engine: hold three of the
+ * four orthogonal concerns constant (persona, framework, hooks, stage) and
+ * rotate one to compare conversion outcomes.
+ */
+import { z } from "zod";
+export declare const FUNNEL_STAGES: readonly ["opener", "qualify", "pitch", "objection", "close"];
+export type FunnelStage = (typeof FUNNEL_STAGES)[number];
+export declare const SALES_FRAMEWORKS: readonly ["AIDA", "PAS", "SPIN", "NEPQ", "straight_line"];
+export type SalesFramework = (typeof SALES_FRAMEWORKS)[number];
+export declare const HOOK_KINDS: readonly ["social_proof", "scarcity", "authority", "liking", "reciprocity", "commitment"];
+export type HookKind = (typeof HOOK_KINDS)[number];
+export declare const HookSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        social_proof: "social_proof";
+        scarcity: "scarcity";
+        authority: "authority";
+        liking: "liking";
+        reciprocity: "reciprocity";
+        commitment: "commitment";
+    }>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type Hook = z.infer<typeof HookSchema>;
+export declare const StageConfigSchema: z.ZodObject<{
+    goal: z.ZodString;
+    guidance: z.ZodOptional<z.ZodString>;
+    groundingRequired: z.ZodDefault<z.ZodBoolean>;
+    maxTurns: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type StageConfig = z.infer<typeof StageConfigSchema>;
+export declare const PersonaSchema: z.ZodObject<{
+    name: z.ZodString;
+    role: z.ZodEnum<{
+        human: "human";
+        assistant: "assistant";
+    }>;
+    company: z.ZodOptional<z.ZodString>;
+    facts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type StylePersona = z.infer<typeof PersonaSchema>;
+export declare const StyleSchema: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    persona: z.ZodObject<{
+        name: z.ZodString;
+        role: z.ZodEnum<{
+            human: "human";
+            assistant: "assistant";
+        }>;
+        company: z.ZodOptional<z.ZodString>;
+        facts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    voice: z.ZodObject<{
+        tone: z.ZodString;
+        language: z.ZodDefault<z.ZodEnum<{
+            ru: "ru";
+            en: "en";
+        }>>;
+        forbid: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        stallCtaReply: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    framework: z.ZodEnum<{
+        AIDA: "AIDA";
+        PAS: "PAS";
+        SPIN: "SPIN";
+        NEPQ: "NEPQ";
+        straight_line: "straight_line";
+    }>;
+    hooks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            social_proof: "social_proof";
+            scarcity: "scarcity";
+            authority: "authority";
+            liking: "liking";
+            reciprocity: "reciprocity";
+            commitment: "commitment";
+        }>;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
+    stages: z.ZodObject<{
+        opener: z.ZodOptional<z.ZodObject<{
+            goal: z.ZodString;
+            guidance: z.ZodOptional<z.ZodString>;
+            groundingRequired: z.ZodDefault<z.ZodBoolean>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        qualify: z.ZodOptional<z.ZodObject<{
+            goal: z.ZodString;
+            guidance: z.ZodOptional<z.ZodString>;
+            groundingRequired: z.ZodDefault<z.ZodBoolean>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        pitch: z.ZodOptional<z.ZodObject<{
+            goal: z.ZodString;
+            guidance: z.ZodOptional<z.ZodString>;
+            groundingRequired: z.ZodDefault<z.ZodBoolean>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        objection: z.ZodOptional<z.ZodObject<{
+            goal: z.ZodString;
+            guidance: z.ZodOptional<z.ZodString>;
+            groundingRequired: z.ZodDefault<z.ZodBoolean>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        close: z.ZodOptional<z.ZodObject<{
+            goal: z.ZodString;
+            guidance: z.ZodOptional<z.ZodString>;
+            groundingRequired: z.ZodDefault<z.ZodBoolean>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    fewShot: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        user: z.ZodString;
+        assistant: z.ZodString;
+        stage: z.ZodOptional<z.ZodEnum<{
+            opener: "opener";
+            qualify: "qualify";
+            pitch: "pitch";
+            objection: "objection";
+            close: "close";
+        }>>;
+    }, z.core.$strip>>>;
+    guardrails: z.ZodObject<{
+        noMinors: z.ZodDefault<z.ZodBoolean>;
+        botDisclosureOnDirectQuestion: z.ZodDefault<z.ZodBoolean>;
+        forbiddenTopics: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    model: z.ZodObject<{
+        id: z.ZodDefault<z.ZodString>;
+        temperature: z.ZodDefault<z.ZodNumber>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Style = z.infer<typeof StyleSchema>;
+/**
+ * A persuasion skill in the shape `composeSystemPrompt` consumes.
+ * Decoupled from DB row shape so the prompt module stays pure.
+ */
+export interface SkillForPrompt {
+    slug: string;
+    displayName: string;
+    promptFragment: string;
+    /**
+     * Stages where this skill applies. Empty array = always applicable.
+     * May contain FunnelStage names ("qualify", "pitch"…) or stage-kind
+     * strings ("intake", "active") — `composeSystemPrompt` does string
+     * comparison against the current stage/kind value so both work.
+     */
+    applicableStages: readonly string[];
+}
+/**
+ * A director-level persuasion hook — tenant-specific scripted mini-technique.
+ * Unlike universal skills (from the catalogue), hooks are always injected for
+ * this tenant regardless of which style or stage is active.
+ */
+export interface DirectorHookForPrompt {
+    name: string;
+    body: string;
+    /** Optional natural-language hint for when to apply this hook. */
+    triggerHint?: string | null;
+}
+export interface ComposeOptions {
+    includeFewShot?: boolean;
+    userFacts?: Record<string, string>;
+    conversationSummary?: string;
+    skills?: readonly SkillForPrompt[];
+    /**
+     * Tenant-specific persuasion scripts added by the director. Injected as a
+     * "ХУКИ УБЕЖДЕНИЯ" block BEFORE the universal skills block. Always active —
+     * not filtered by stage or style.
+     */
+    directorHooks?: readonly DirectorHookForPrompt[];
+    /**
+     * Support mode — set when the lead is past the sales stage and waiting on a
+     * downstream process. When set, the prompt drops the sales framework / hooks
+     * / skills / few-shot / funnel-stage guidance and uses a calm FAQ-support
+     * block instead. `docs` = collecting their documents, `submitted` = filed.
+     */
+    supportPhase?: "docs" | "submitted";
+}
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa,+DAAgE,CAAC;AAC3F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,gBAAgB,2DAA4D,CAAC;AAC1F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,UAAU,2FAOb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,UAAU;;;;;;;;;;iBAGrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,aAAa;;;;;;;;iBAKxB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEzD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsCtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CACrC"}

package/dist/summarize-conversation.d.ts

@@ -0,0 +1,31 @@
+import type { ChatClient, ChatMessage } from "@chatman-media/llm-router";
+/**
+ * Compresses old turns of a long conversation into one short paragraph that
+ * preserves what nuance the user-facts memory layer can't — what the bot
+ * already promised, what the candidate hesitated about, what was already
+ * explained vs. left open. Injected into the next system prompt as
+ * "ИЗ РАННЕЙ ПЕРЕПИСКИ:" so the LLM has continuity past the 12-message
+ * recent-history window.
+ *
+ * Only the OLD tail is summarized — the recent ~12 messages are still
+ * passed to the LLM raw (they fit in the window). Pass them via
+ * `messagesToSummarize` (oldest first).
+ */
+export interface SummarizeInput {
+    /** Old messages to compress, oldest first. Caller must already have
+     *  trimmed off the recent window — those go into LLM context as-is. */
+    messagesToSummarize: ChatMessage[];
+    chat: ChatClient;
+    /** Existing summary to refine (when refreshing an older summary).
+     *  Helps the model preserve what was already known without re-reading
+     *  the whole stretch of dialogue. */
+    previousSummary?: string;
+    /** Hard cap on summary length (chars). Default 600. Past this the
+     *  summary is truncated at the last sentence boundary. */
+    maxLength?: number;
+}
+export declare function summarizeConversation(input: SummarizeInput): Promise<string>;
+/** Strip think-tags / markdown / leading prefixes; cap length at the last
+ *  sentence boundary inside the cap. Exported for unit tests. */
+export declare function cleanSummary(raw: string, maxLength: number): string;
+//# sourceMappingURL=summarize-conversation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-conversation.d.ts","sourceRoot":"","sources":["../src/summarize-conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B;2EACuE;IACvE,mBAAmB,EAAE,WAAW,EAAE,CAAC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB;;yCAEqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;8DAC0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlF;AAED;iEACiE;AACjE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAenE"}

package/dist/system-prompt.d.ts

@@ -0,0 +1,11 @@
+import { type Persona } from "./answer-types.ts";
+/**
+ * Legacy RAG sampling temperature when a sales `style` is not used.
+ * Pass `tempOverride` to apply a custom value (e.g. from an env var).
+ */
+export declare function legacyRagSamplingTemperature(persona: Persona, tempOverride?: number): number;
+export declare const DEFAULT_PERSONA: Persona;
+export declare function renderSummaryBlock(summary?: string): string;
+export declare function renderUserFactsBlock(userFacts?: Record<string, string>): string;
+export declare function buildSystemPrompt(persona: Persona, context: string, userFacts?: Record<string, string>, conversationSummary?: string): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5F;AAED,eAAO,MAAM,eAAe,EAAE,OAI7B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQ/E;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,CA8ER"}

package/dist/text-style-rules.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Post-processing rules for LLM output — the legacy-codebase analog of "skills":
+ * small, named, composable text transforms that run after the model returns.
+ * Each one targets a specific "AI tell" that breaks the human-manager
+ * illusion (the candidate must believe they're talking to a real recruiter,
+ * not a chatbot — see persona role="human" in `buildSystemPrompt`).
+ *
+ * Adding a new rule:
+ *   1. Define it as `TextStyleRule` (name + description + apply function).
+ *   2. Append it to `DEFAULT_STYLE_RULES` (or a style-specific bundle).
+ *   3. Add a unit test in `tests/unit/text-style-rules.test.ts`.
+ *
+ * Rules MUST be:
+ *   - idempotent (`rule(rule(x)) === rule(x)`) so re-application is safe;
+ *   - pure (same input → same output, no I/O, no global state);
+ *   - cheap (sub-ms on a 1 KB string; we run the whole stack on every reply).
+ *
+ * Negative-instruction-in-prompt approach was tried and is unreliable —
+ * LLMs ignore "не используй длинное тире" in 30-50% of replies. Doing it
+ * deterministically as post-processing is bullet-proof.
+ */
+export interface TextStyleRule {
+    name: string;
+    description: string;
+    apply: (text: string) => string;
+}
+/**
+ * Em-dash (`—`, U+2014) — formally correct Russian typography but a dead
+ * giveaway in messenger chat. Real candidates type a plain hyphen `-` or
+ * skip the dash entirely. Replace with regular hyphen, normalising
+ * surrounding whitespace so we don't end up with double-spaces.
+ */
+export declare const replaceEmDash: TextStyleRule;
+/**
+ * En-dash (`–`, U+2013). Less common but appears in date ranges
+ * («10:00–18:00») and is also AI-flavoured in casual chat.
+ */
+export declare const replaceEnDash: TextStyleRule;
+/**
+ * Horizontal bar (`―`, U+2015) and figure dash (`‒`, U+2012) — the rest of
+ * the dash family. Same rule, same reason.
+ */
+export declare const replaceOtherDashes: TextStyleRule;
+/**
+ * Unicode ellipsis (`…`, U+2026) → three ASCII dots. Native typists hit
+ * `...` on a regular keyboard; the single-codepoint ellipsis arrives only
+ * via autocomplete or model output.
+ */
+export declare const replaceEllipsis: TextStyleRule;
+/**
+ * Strip AI-flavoured lead-ins at the start of the reply.
+ *
+ * "Конечно!" / "Безусловно!" / "Разумеется!" / "Хорошо!" alone, followed by
+ * a sentence boundary or comma, are textbook ChatGPT openers. A real
+ * recruiter just answers. We trim the preamble; if the rest of the line is
+ * empty we leave the original untouched (better to keep something than
+ * nothing).
+ */
+export declare const stripAILeadIns: TextStyleRule;
+/**
+ * Capitalise the first alphabetic character of the reply.
+ *
+ * Why: qwen3 (and other models) tend to mirror the candidate's casing —
+ * if the user types «привет», the model replies «привет, ...» in lowercase.
+ * Real recruiters in our corpus (`kb/extracted/dialogs/*`) consistently
+ * start replies with a capital letter («Здравствуйте», «Хорошо»),
+ * regardless of how the candidate wrote.
+ *
+ * Implementation finds the FIRST alphabetic codepoint (skipping leading
+ * whitespace, emoji, punctuation) and uppercases it. Idempotent.
+ */
+export declare const capitalizeFirstLetter: TextStyleRule;
+/**
+ * Strip Markdown bold (`**text**` and `__text__`). Telegram doesn't
+ * render Markdown unless `parse_mode` is set — and the bot uses plain
+ * text — so the asterisks/underscores leak through to the candidate
+ * verbatim ("Зарплата от **₩110 000**" → user sees the stars).
+ *
+ * We strip the markers and keep the inner text. Conservative: requires
+ * non-whitespace content inside, so a literal `**` separator wrapping
+ * spaces stays intact (rare but happens).
+ */
+export declare const stripMarkdownBold: TextStyleRule;
+/**
+ * Strip Markdown italics (`*text*` and `_text_`). Same reason as bold.
+ *
+ * Tricky: bare `*` and `_` appear naturally in URLs, file names, math
+ * expressions, etc. We require:
+ *   - the OPENING marker to be at start-of-string OR preceded by a
+ *     non-letter/non-digit (so `foo_bar` and `https://example_com` stay);
+ *   - the CLOSING marker to be at end-of-string OR followed by the same;
+ *   - inner content to be non-empty + not start/end with whitespace.
+ *
+ * Run AFTER `stripMarkdownBold` so `**bold**` is unwrapped before the
+ * italic regex sees the standalone `*` pair.
+ */
+export declare const stripMarkdownItalic: TextStyleRule;
+/**
+ * Strip Markdown inline / fenced code (`` `code` ``, ``` ```block``` ```).
+ * In a candidate-facing sales chat these are never helpful; the bot
+ * sometimes wraps numbers like `` `₩110 000` `` for emphasis and the
+ * candidate sees the backticks.
+ *
+ * Fenced (triple-backtick) blocks come first so their contents aren't
+ * partially eaten by the inline rule.
+ */
+export declare const stripMarkdownCode: TextStyleRule;
+/**
+ * Strip Markdown headers (`# Heading` at the start of a line). LLMs
+ * sometimes emit `## Условия:` when listing facts; in chat that just
+ * dumps the hashes. We keep the trailing text.
+ */
+export declare const stripMarkdownHeaders: TextStyleRule;
+/**
+ * Strip Markdown links (`[text](url)`) into `text (url)` — keeps the
+ * URL visible, drops the bracket syntax. Telegram autolinks plain
+ * URLs, so the candidate still gets a clickable link.
+ */
+export declare const stripMarkdownLinks: TextStyleRule;
+/**
+ * The standard rule set applied by `sanitizeLlmOutput`.
+ *
+ * Order matters when one rule's output feeds another. Critical:
+ * `stripAILeadIns` MUST run before `capitalizeFirstLetter`, otherwise we
+ * just re-uppercase the «К» in «Конечно!» and the lead-in stays.
+ */
+export declare const DEFAULT_STYLE_RULES: readonly TextStyleRule[];
+/**
+ * Apply a sequence of style rules in order. Returns the input unchanged
+ * when `rules` is empty.
+ */
+export declare function applyStyleRules(text: string, rules?: readonly TextStyleRule[]): string;
+//# sourceMappingURL=text-style-rules.d.ts.map

package/dist/text-style-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-style-rules.d.ts","sourceRoot":"","sources":["../src/text-style-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAID;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,aAI3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aAI3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAIhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,aAI7B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,aAe5B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAYnC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAO/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAOjC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAK/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAIlC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAIhC,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAmBvD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,SAAS,aAAa,EAAwB,GACpD,MAAM,CAER"}

package/dist/tool-loop.d.ts

@@ -0,0 +1,44 @@
+import type { AnswerTelemetry } from "./answer-types.ts";
+import type { ChatClient, ChatCompletionOpts, ChatMessage } from "@chatman-media/llm-router";
+import type { AnyRagTool } from "./tools.ts";
+/** Default maximum number of agentic tool-calling cycles. */
+export declare const DEFAULT_MAX_TOOL_CYCLES = 4;
+/** A single tool execution recorded during an agentic tool loop. */
+export interface ToolCallRecord {
+    name: string;
+    args: Record<string, unknown>;
+    result: unknown;
+    /** True when the tool was unknown or `execute()` threw — `result` holds `{ error }`. */
+    error?: boolean;
+    /** Zero-based index of the loop cycle this call belongs to. */
+    cycle: number;
+}
+export interface ToolLoopResult {
+    /** Final assistant text when the model stopped calling tools, else null. */
+    content: string | null;
+    /** Every tool call executed across all cycles, in order. */
+    toolCalls: ToolCallRecord[];
+    /** True when the loop stopped because `maxCycles` was hit while the model still wanted tools. */
+    exhausted: boolean;
+}
+/**
+ * Runs an agentic tool-calling loop. Mutates `messages` in place, appending an
+ * assistant message (carrying all tool calls) and one `tool` message per call
+ * for every cycle. Returns the final model text (when produced) and the full
+ * tool-call trace.
+ *
+ * Unknown tools and thrown `execute()` errors are fed back to the model as the
+ * tool result so it can recover — the loop never throws on tool failure.
+ *
+ * The caller must guarantee `chat.completeWithTools` exists and `tools` is non-empty.
+ */
+export declare function runToolLoop(opts: {
+    chat: ChatClient;
+    messages: ChatMessage[];
+    tools: AnyRagTool[];
+    llmOpts: ChatCompletionOpts;
+    maxCycles: number;
+}): Promise<ToolLoopResult>;
+/** Builds the tool-related telemetry fields from a tool-call trace. */
+export declare function buildToolTelemetry(records: ToolCallRecord[]): Pick<AnswerTelemetry, "toolCall" | "toolCalls">;
+//# sourceMappingURL=tool-loop.d.ts.map

package/dist/tool-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loop.d.ts","sourceRoot":"","sources":["../src/tool-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,wFAAwF;IACxF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,4DAA4D;IAC5D,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,iGAAiG;IACjG,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoD1B;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EAAE,GACxB,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,WAAW,CAAC,CAOjD"}