@chatman-media/conversation-engine 1.2.0

package/dist/lead-lifecycle.d.ts

@@ -0,0 +1,46 @@
+import type { VerticalTemplate } from "@chatman-media/verticals";
+import type { LeadRow, LeadsRepo } from "./dal/leads.ts";
+import type { NotificationService } from "./notifications.ts";
+/**
+ * Find-or-create Lead на (tenant, contact). При создании stage берётся
+ * из template.funnelStages[0] (обычно 'intake_pending'). Vertical-hook
+ * onLeadStageChange при создании НЕ вызывается — у нас нет fromState;
+ * хук рассчитан на смены состояния, а не на initial-create.
+ */
+export declare function ensureLead(opts: {
+    contactId: number;
+    template: VerticalTemplate;
+    leads: LeadsRepo;
+    nowEpoch: number;
+}): Promise<{
+    lead: LeadRow;
+    created: boolean;
+}>;
+/**
+ * Контекст для vertical-hooks — мини-DI прокидывается в каждый хук.
+ * Зачем нужен сам объект (вместо просто полей): vertical-template'у
+ * нужен escape-hatch чтобы пробросить дополнительные deps через cast'у.
+ */
+export interface LeadHookContext {
+    tenantId: number;
+    contactId: number;
+    leadId: number;
+    template: VerticalTemplate;
+}
+/**
+ * Переход lead.state с валидацией по template.funnelStages и вызовом
+ * хуков. Атомарность: UPDATE leads.state делается ДО вызова хука —
+ * если хук бросит, мы НЕ откатываем состояние, потому что хук может
+ * быть side-effect'ом (например, послать DM кандидату). Хуки должны
+ * быть идемпотентны.
+ */
+export declare function transitionLeadState(opts: {
+    lead: LeadRow;
+    toState: string;
+    template: VerticalTemplate;
+    leads: LeadsRepo;
+    notifications?: NotificationService;
+    nowEpoch: number;
+    hookContext?: Partial<LeadHookContext>;
+}): Promise<LeadRow>;
+//# sourceMappingURL=lead-lifecycle.d.ts.map

package/dist/lead-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-lifecycle.d.ts","sourceRoot":"","sources":["../src/lead-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAS/C;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACxC,GAAG,OAAO,CAAC,OAAO,CAAC,CAuCnB"}

package/dist/lead-lifecycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lead-lifecycle.test.d.ts.map

package/dist/lead-lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-lifecycle.test.d.ts","sourceRoot":"","sources":["../src/lead-lifecycle.test.ts"],"names":[],"mappings":""}

package/dist/memory-extractor.d.ts

@@ -0,0 +1,62 @@
+import type { ChatClient } from "@chatman-media/llm-router";
+import type { ContactsRepo } from "./dal/contacts.ts";
+import type { MessagesRepo } from "./dal/messages.ts";
+/**
+ * Memory extractor — LLM-based анализ диалога, извлекает факты о кандидате
+ * (name/city/age/experience/...) и merge'ит их в contact.attributes_json.
+ *
+ * Дополняет vertical-template'овский hooks.extractFields:
+ *   - extractFields — regex/regex-based, дёшево и быстро, но узко (имя/возраст
+ *     по паттерну)
+ *   - LlmMemoryExtractor — LLM-call, дороже, но универсально (русский NER,
+ *     импликации типа "работала в Дубае" → country_target=Dubai)
+ *
+ * Вызывается после persist user-message в pipeline. Не блокирует reply-loop:
+ *   - exception → log + continue
+ *   - extractor сам skip'ает LLM call если нет user-сообщений
+ */
+export interface MemoryExtractor {
+    /** Извлекает facts; возвращает только новые/обновлённые. Empty = no-op. */
+    extract(opts: {
+        tenantId: number;
+        conversationId: number;
+        contactId: number;
+        existingFacts: Record<string, string>;
+    }): Promise<Record<string, string>>;
+}
+/**
+ * LLM-based реализация через @chatman-media/kb.extractUserFacts.
+ * MessagesRepo — для загрузки history, ChatClient — для LLM-вызова.
+ */
+export declare class LlmMemoryExtractor implements MemoryExtractor {
+    private readonly opts;
+    private readonly messagesRepoFor;
+    constructor(opts: {
+        historyLimit?: number;
+        resolveChat: (tenantId: number) => ChatClient;
+    }, messagesRepoFor: (tenantId: number) => MessagesRepo);
+    extract(input: {
+        tenantId: number;
+        conversationId: number;
+        contactId: number;
+        existingFacts: Record<string, string>;
+    }): Promise<Record<string, string>>;
+}
+/**
+ * Дёргает extractor + merge'ит результат в contact.attributes_json.
+ * Используется из process-inbound (опционально через memoryExtractor dep).
+ *
+ * Контракт: existing facts читаются из contact.attributesJson; только string-
+ * value поля считаются "facts" (rag's extractUserFacts возвращает
+ * Record<string,string>). Не-string полей (age:number и т.п.) сохраняются
+ * как-есть.
+ */
+export declare function runMemoryExtraction(opts: {
+    extractor: MemoryExtractor;
+    tenantId: number;
+    conversationId: number;
+    contactId: number;
+    contacts: ContactsRepo;
+    nowEpoch: number;
+}): Promise<Record<string, string>>;
+//# sourceMappingURL=memory-extractor.d.ts.map

package/dist/memory-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-extractor.d.ts","sourceRoot":"","sources":["../src/memory-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAiC,MAAM,2BAA2B,CAAC;AAE3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,OAAO,CAAC,IAAI,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IAEtD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAIrB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAJf,IAAI,EAAE;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,CAAC;KAC/C,EACgB,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY;IAGhE,OAAO,CAAC,KAAK,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAepC;AAcD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoBlC"}

package/dist/memory-extractor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-extractor.test.d.ts.map

package/dist/memory-extractor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-extractor.test.d.ts","sourceRoot":"","sources":["../src/memory-extractor.test.ts"],"names":[],"mappings":""}

package/dist/notifications.d.ts

@@ -0,0 +1,32 @@
+import type { NotificationRule, NotificationsRepo } from "./dal/notifications.ts";
+export interface NotificationEvent {
+    tenantId: number;
+    eventType: string;
+    leadId?: number;
+    conversationId?: number;
+    contactId?: number;
+    /** assignedAdminId — если задан, проверяется notifyOnAssignedOnly */
+    assignedAdminId?: number;
+    data: Record<string, unknown>;
+}
+export declare class NotificationService {
+    private readonly repo;
+    private readonly botToken;
+    private readonly appUrl;
+    private client;
+    constructor(repo: NotificationsRepo, botToken: string, appUrl: string);
+    notify(event: NotificationEvent): Promise<void>;
+    sendTestMessage(chatId: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    private sendMessage;
+    matchesCondition(rule: NotificationRule, event: NotificationEvent): boolean;
+    renderTemplate(body: string, event: NotificationEvent): string;
+    formatMessage(event: NotificationEvent): string;
+    private formatButtons;
+    private getEventEmoji;
+    private getEventTitle;
+    private formatKey;
+}
+//# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,MAAM,CAA+B;gBAG1B,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;IAO3B,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC/C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAcjE,WAAW;IAazB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAa3E,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAc9D,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAsB/C,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,SAAS;CAUlB"}

package/dist/notifications.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=notifications.test.d.ts.map

package/dist/notifications.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.test.d.ts","sourceRoot":"","sources":["../src/notifications.test.ts"],"names":[],"mappings":""}

package/dist/operator-bot-handler.d.ts

@@ -0,0 +1,13 @@
+import { type TgUpdate } from "@chatman-media/channel-telegram";
+import type { NotificationsRepo } from "./dal/notifications.ts";
+export declare class OperatorBotHandler {
+    private readonly repo;
+    private readonly botToken;
+    private client;
+    constructor(repo: NotificationsRepo, botToken: string);
+    handleUpdate(update: TgUpdate): Promise<void>;
+    private handleLinkToken;
+    private handleGroupLinkToken;
+    private handleSetupGroup;
+}
+//# sourceMappingURL=operator-bot-handler.d.ts.map

package/dist/operator-bot-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-bot-handler.d.ts","sourceRoot":"","sources":["../src/operator-bot-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,MAAM,CAA+B;gBAG1B,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,MAAM;IAO7B,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAwCrC,eAAe;YAoBf,oBAAoB;YAmCpB,gBAAgB;CAkB/B"}

package/dist/operator-bot-handler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operator-bot-handler.test.d.ts.map

package/dist/operator-bot-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-bot-handler.test.d.ts","sourceRoot":"","sources":["../src/operator-bot-handler.test.ts"],"names":[],"mappings":""}

package/dist/outbound-dispatch.d.ts

@@ -0,0 +1,17 @@
+import type { OutboundEnvelope } from "@chatman-media/channel-core";
+import type { OutboundQueueRepo, OutboundQueueRow } from "./dal/index.ts";
+/**
+ * Поставить envelope в outbound_queue. Worker'у дальше pop'ить
+ * pending записи и слать через ChannelAdapter.send().
+ *
+ * `idempotencyKey` на envelope защищает от дублей при retry processInbound'а.
+ * Рекомендованный формат ключа — `${channelId}:${externalUserId}:${reasonHash}`.
+ */
+export declare function dispatchOutbound(opts: {
+    channelDbId: number;
+    conversationId: number | null;
+    envelope: OutboundEnvelope;
+    outbound: OutboundQueueRepo;
+    nowEpoch: number;
+}): Promise<OutboundQueueRow>;
+//# sourceMappingURL=outbound-dispatch.d.ts.map

package/dist/outbound-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-dispatch.d.ts","sourceRoot":"","sources":["../src/outbound-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAO5B"}

package/dist/process-inbound.d.ts

@@ -0,0 +1,126 @@
+import type { Inbound, OutboundEnvelope } from "@chatman-media/channel-core";
+import type { VerticalTemplate } from "@chatman-media/verticals";
+import type { ChannelIdentitiesRepo, ContactsRepo, ConversationsRepo, MessagesRepo, OutboundQueueRepo } from "./dal/index.ts";
+import { type MemoryExtractor } from "./memory-extractor.ts";
+import { type StageClassifier } from "./stage-classifier.ts";
+import type { ITranscriber } from "./transcriber.ts";
+import type { NotificationService } from "./notifications.ts";
+import { ChannelContext, type Clock, type PipelineSink, type ProcessInboundResult, type TenantContext } from "./types.ts";
+/**
+ * Стратегия генерации ответа. Pipeline сам не дёргает LLM напрямую —
+ * вместо этого consumer (apps/worker) инжектит ReplyStrategy. Это
+ * позволяет:
+ *   - заменять стратегию для тестов на fake (вернёт фиксированный ответ)
+ *   - поэтапно вводить RAG / sales-engine / vertical-hooks без trogания
+ *     pipeline'а
+ *   - выключать reply вообще (mediaOnly turn, режим оператора, и т.д.)
+ *
+ * Возвращает null — значит бот молчит. Возвращает envelope'ы — они
+ * пушатся в outbound_queue в порядке возврата.
+ */
+export interface ReplyStrategy {
+    generate(opts: {
+        tenant: TenantContext;
+        channel: ChannelContext;
+        conversationId: number;
+        contactId: number;
+        inbound: Inbound;
+        userMessageText: string;
+    }): Promise<OutboundEnvelope[] | null>;
+}
+export interface ProcessInboundDeps {
+    tenant: TenantContext;
+    channel: ChannelContext;
+    channelDbId: number;
+    contacts: ContactsRepo;
+    identities: ChannelIdentitiesRepo;
+    conversations: ConversationsRepo;
+    messages: MessagesRepo;
+    outbound: OutboundQueueRepo;
+    /** Стратегия ответа. null = pipeline сохраняет inbound и не отвечает. */
+    reply?: ReplyStrategy | null;
+    /**
+     * Vertical-template для текущей conversation. Если задан и в нём
+     * есть hooks.extractFields — pipeline после persist user-message
+     * дёрнет hook и merge'нёт извлечённые поля в contact.attributes_json.
+     * Это даёт автозаполнение questionnaire (имя/возраст/паспорт/...)
+     * без блокировки reply-loop.
+     */
+    template?: VerticalTemplate;
+    /**
+     * Опциональный LLM-based memory extractor. Если задан, после persist
+     * user-message pipeline вытащит из истории facts через
+     * extractUserFacts и merge'нёт в contact.attributes_json. Дополняет
+     * template.hooks.extractFields (тот — regex; этот — LLM).
+     */
+    memoryExtractor?: MemoryExtractor;
+    /**
+     * Опциональный stage classifier (opener|qualify|pitch|objection|close).
+     * Если задан, после persist user-message pipeline классифицирует stage
+     * и пишет в conversations.current_stage (если отличается от previous).
+     *
+     * Sales-engine использует current_stage для выбора stage-specific
+     * промптов в composeSystemPrompt; admin-UI — для отображения позиции
+     * кандидата в воронке.
+     */
+    stageClassifier?: StageClassifier;
+    /**
+     * Drizzle db, нужен stage classifier'у для UPDATE conversations.current_stage.
+     * Когда stageClassifier=null — может быть опущен.
+     */
+    db?: import("./dal/types.ts").Db;
+    /**
+     * Когда true — pipeline ЗАВЕРШАЕТСЯ после persist + classify + memory
+     * extract БЕЗ вызова `reply.generate` и enqueue outbound. Result содержит
+     * `replyDeferred: true`, `userMessageText`, `mediaOnly` — caller должен
+     * затем вызвать `generateReplyAndEnqueue(...)` ВНЕ открытой Postgres-tx.
+     *
+     * Зачем: reply.generate — это LLM call ~1-2s, который не должен держать
+     * Postgres pool connection. Pool=10, под нагрузкой это становится
+     * bottleneck'ом. Split на phases освобождает connection для других
+     * inbound'ов пока ждём LLM.
+     *
+     * Default false (legacy single-tx path для existing callers).
+     */
+    deferReply?: boolean;
+    sink?: PipelineSink;
+    clock?: Clock;
+    notifications?: NotificationService;
+    /**
+     * Опциональный STT-транскрибер. Если задан и inbound содержит voice-part —
+     * pipeline транскрибирует аудио перед persist'ом. Транскрипт становится
+     * текстом сообщения; остальной pipeline работает без изменений.
+     * downloadVoice должен быть задан вместе с transcriber.
+     */
+    transcriber?: ITranscriber | null;
+    /** Загружает аудиофайл. Нужен для transcriber. externalUserId нужен userbot-адаптеру. */
+    downloadVoice?: ((mediaRef: import("@chatman-media/channel-core").MediaRef, externalUserId: string) => Promise<Response>) | null;
+}
+/**
+ * Основной pipeline. Channel-agnostic, tenant-scoped. apps/worker дёргает
+ * это для каждого Inbound из ChannelAdapter.receive().
+ *
+ * Шаги:
+ *   1. resolveContact — find/create Contact + ChannelIdentity
+ *   2. resolveConversation — find/create Conversation per (contact, kind)
+ *   3. Persist user message в messages (с idempotency через
+ *      uniq_msg_user_tg)
+ *   4. Если conversation.mode === 'ai' и reply-strategy задана → сгенерить
+ *      OutboundEnvelope[]. Для 'queued'/'human' — pipeline пропускает
+ *      генерацию (оператор отвечает сам).
+ *   5. Push каждого envelope в outbound_queue.
+ *   6. Touch conversations.last_message_at.
+ *
+ * Реализовано: vertical-hooks.extractFields (шаг 5), LLM-memory extraction
+ * (шаг 5b), stage classifier (шаг 5a-bis), RAG + LLM reply через
+ * ReplyStrategy (шаг 6). Оставшиеся TODO:
+ *   - conversation summarization при длинных диалогах (context overflow)
+ *   - escalation rules (не отвечать N часов → перевод в queued)
+ *   - A/B routing (styleId → experiment allocation через ExperimentsRepo)
+ *
+ * Photo classification + passport OCR реализованы в apps/api/src/lib/
+ * photo-processor.ts — выполняется ПОСЛЕ pipeline'а (Phase 4, async,
+ * без tx) через PhotoProcessor.process().
+ */
+export declare function processInbound(inbound: Inbound, deps: ProcessInboundDeps): Promise<ProcessInboundResult>;
+//# sourceMappingURL=process-inbound.d.ts.map

package/dist/process-inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-inbound.d.ts","sourceRoot":"","sources":["../src/process-inbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,eAAe,EAAuB,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAEzB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE;QACb,MAAM,EAAE,aAAa,CAAC;QACtB,OAAO,EAAE,cAAc,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,qBAAqB,CAAC;IAClC,aAAa,EAAE,iBAAiB,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,yEAAyE;IACzE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;OAGG;IACH,EAAE,CAAC,EAAE,OAAO,gBAAgB,EAAE,EAAE,CAAC;IACjC;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,yFAAyF;IACzF,aAAa,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,6BAA6B,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;CAClI;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA6T/B"}

package/dist/process-inbound.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=process-inbound.test.d.ts.map

package/dist/process-inbound.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-inbound.test.d.ts","sourceRoot":"","sources":["../src/process-inbound.test.ts"],"names":[],"mappings":""}

package/dist/reply-strategy/index.d.ts

@@ -0,0 +1,3 @@
+export { LlmReplyStrategy, type LlmReplyStrategyOpts } from "./llm-reply.ts";
+export { parseStyleConfig, RagReplyStrategy, type RagReplyStrategyOpts } from "./rag-reply.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/reply-strategy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reply-strategy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/reply-strategy/llm-reply.d.ts

@@ -0,0 +1,69 @@
+import type { OutboundEnvelope } from "@chatman-media/channel-core";
+import type { ChatClient } from "@chatman-media/llm-router";
+import type { VerticalTemplate } from "@chatman-media/verticals";
+import type { MessagesRepo } from "../dal/messages.ts";
+import type { ReplyStrategy } from "../process-inbound.ts";
+/**
+ * Минимальный LLM-based ReplyStrategy. Шаги на каждый inbound:
+ *   1. Загрузить последние N сообщений из conversation (history).
+ *   2. Собрать system prompt (template.systemPromptFragment + base).
+ *   3. Послать history → ChatClient.complete().
+ *   4. Вернуть OutboundEnvelope с text-частью.
+ *
+ * Что отсутствует (полная RAG / sales — следующая итерация):
+ *   - KB search + chunks в контекст
+ *   - sales-style selection и A/B routing
+ *   - memory extraction в contacts.attributes_json
+ *   - conversation summarization для длинных history
+ *   - extractFields hook на user message
+ *   - photo/voice handling (сейчас игнорируем, нет multimodal через chat)
+ *
+ * Truncated ответы (ChatTruncatedError) ловятся выше — strategy
+ * пробрасывает их в processInbound, где попадают в sink.log; envelope
+ * НЕ ставится в outbound_queue, бот молчит вместо half-формы.
+ */
+export interface LlmReplyStrategyOpts {
+    template: VerticalTemplate;
+    /**
+     * Лимит сообщений в history-prompt'е. Default 20.
+     * При больших значениях нужен conversation summary (следующая итерация).
+     */
+    historyLimit?: number;
+    /** Per-call temperature, default 0.7. */
+    temperature?: number;
+    /** Output token cap, default 600. */
+    maxOutputTokens?: number;
+    /**
+     * Resolver ChatClient'а. apps/api прокидывает функцию которая знает
+     * tenant_id из request scope: (tenantId) => llmRouter.resolveChat(tenantId, 'chat').
+     * Это даёт per-call swap клиента — если оператор поменял конфиг через
+     * admin-UI и invalidate'нул router, следующий resolveChat() построит
+     * нового.
+     */
+    resolveChat: (tenantId: number) => ChatClient;
+    /** Если возвращает true — стадия лида помечена supportMode, бот молчит. */
+    resolveIsSupport?: (input: {
+        tenantId: number;
+        contactId: number;
+    }) => Promise<boolean>;
+}
+export declare class LlmReplyStrategy implements ReplyStrategy {
+    private readonly opts;
+    private readonly messagesRepoFor;
+    constructor(opts: LlmReplyStrategyOpts, messagesRepoFor: (tenantId: number) => MessagesRepo);
+    generate(input: {
+        tenant: {
+            tenantId: number;
+        };
+        channel: {
+            channelId: number;
+        };
+        conversationId: number;
+        contactId: number;
+        inbound: {
+            externalUserId: string;
+        };
+        userMessageText: string;
+    }): Promise<OutboundEnvelope[] | null>;
+}
+//# sourceMappingURL=llm-reply.d.ts.map

package/dist/reply-strategy/llm-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-reply.d.ts","sourceRoot":"","sources":["../../src/reply-strategy/llm-reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,CAAC;IAC9C,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAkBD,qBAAa,gBAAiB,YAAW,aAAa;IAElD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBADf,IAAI,EAAE,oBAAoB,EAC1B,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY;IAGhE,QAAQ,CAAC,KAAK,EAAE;QACpB,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7B,OAAO,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/B,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE;YAAE,cAAc,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAqCvC"}

package/dist/reply-strategy/llm-reply.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=llm-reply.test.d.ts.map

package/dist/reply-strategy/llm-reply.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-reply.test.d.ts","sourceRoot":"","sources":["../../src/reply-strategy/llm-reply.test.ts"],"names":[],"mappings":""}

package/dist/reply-strategy/rag-reply.d.ts

@@ -0,0 +1,175 @@
+import type { OutboundEnvelope } from "@chatman-media/channel-core";
+import type { ChatClient, EmbeddingClient as RagEmbeddingClient } from "@chatman-media/llm-router";
+import { type AnyRagTool, type DirectorHookForPrompt, type IKbStore, type Reranker, type SkillForPrompt, type Style } from "@chatman-media/kb";
+import type { VerticalTemplate } from "@chatman-media/verticals";
+import type { ConversationsRepo } from "../dal/conversations.ts";
+import type { KbSuggestionsRepo } from "../dal/kb-suggestions.ts";
+import type { MessagesRepo } from "../dal/messages.ts";
+import type { ReplyStrategy } from "../process-inbound.ts";
+/**
+ * RAG-аware ReplyStrategy. На каждый user message:
+ *   1. Загрузить последние N сообщений (history).
+ *   2. Эмбеддинг user message → KbStore.hybridSearch → chunks.
+ *   3. answerWithRag(chunks + history + system prompt) → text reply.
+ *   4. Вернуть OutboundEnvelope.
+ *
+ * answerWithRag из @chatman-media/kb сам строит system prompt из chunks,
+ * делает query rewriting + reflection (если флаги включены) и
+ * sanitize'ит output. Мы только инжектим деп'ы и history.
+ *
+ * Vertical-template'овский systemPromptFragment пробрасывается через
+ * persona.role — это не идеально, но answerWithRag не предоставляет
+ * прямой override system-промпта; нужная extension-точка появится при
+ * рефакторе rag (вне scope этого pkg'а).
+ */
+export interface RagReplyStrategyOpts {
+    template: VerticalTemplate;
+    /** Лимит history сообщений (default 12 — answerWithRag сам ужмёт через summary). */
+    historyLimit?: number;
+    /**
+     * Включить hybrid retrieval (vector + BM25 RRF). Default true.
+     * False = pure vector — быстрее, но хуже на keyword-questions.
+     */
+    hybridSearch?: boolean;
+    /**
+     * Query rewriting перед retrieval (LLM-вызов до search). Default true.
+     * Помогает на ambiguous follow-up'ах ("а что насчёт оплаты?" → "оплата контракта в UAE").
+     */
+    rewriteQueryBeforeRetrieval?: boolean;
+    /**
+     * Reflection-guard после генерации (LLM фактчекит chunks vs answer).
+     * Default false — дополнительная LLM-стоимость и latency.
+     */
+    reflect?: boolean;
+    /** topK chunks для контекста. Default 5. */
+    topK?: number;
+    /** Per-call temperature, default 0.7. */
+    temperature?: number;
+    maxOutputTokens?: number;
+    resolveChat: (tenantId: number) => ChatClient;
+    resolveEmbed: (tenantId: number) => RagEmbeddingClient;
+    resolveKb: (tenantId: number) => IKbStore;
+    /**
+     * Опциональный sales-style resolver. Если задан и возвращает Style —
+     * answerWithRag использует его для построения system-prompt (persona,
+     * sales framework, hooks, skills). При null/undefined — rag fallback'нет
+     * на DEFAULT_PERSONA. Лёгкое расширение для A/B routing в будущем:
+     * resolveStyle может смотреть на conversation.style_id или experiment_id.
+     */
+    resolveStyle?: (input: {
+        tenantId: number;
+        conversationId: number;
+        contactId: number;
+    }) => Promise<Style | null> | Style | null;
+    /**
+     * Опциональная проверка support-mode. Если возвращает true — стадия лида
+     * помечена как supportMode и бот не отвечает (возвращает null). Оператор
+     * ведёт диалог вручную пока лид не переведут на другую стадию.
+     */
+    resolveIsSupport?: (input: {
+        tenantId: number;
+        contactId: number;
+    }) => Promise<boolean>;
+    /**
+     * Загрузить включённые навыки убеждения для тенанта. Возвращает список
+     * SkillForPrompt, уже отфильтрованных по is_enabled = true.
+     * Stage-фильтрация (intake/active/always) выполняется внутри
+     * composeSystemPrompt по applicableStages.
+     * Если не задан — навыки не инжектируются (silent fallback).
+     */
+    resolveSkills?: (input: {
+        tenantId: number;
+    }) => Promise<readonly SkillForPrompt[]>;
+    /**
+     * Загрузить активные директорские хуки тенанта (is_active = true).
+     * Если не задан — хуки не инжектируются.
+     */
+    resolveDirectorHooks?: (input: {
+        tenantId: number;
+    }) => Promise<readonly DirectorHookForPrompt[]>;
+    /**
+     * Загрузить активные agentic tools для тенанта.
+     * Вызывается один раз на каждый входящий message.
+     * Если не задан или возвращает пустой массив — tool-loop не запускается
+     * (поведение как раньше: один LLM-вызов без инструментов).
+     *
+     * @example
+     * ```ts
+     * resolveTools: async ({ tenantId }) => {
+     *   const url = await getBookingUrl(tenantId);
+     *   return url ? [makeBookingLinkTool(url)] : [];
+     * }
+     * ```
+     */
+    resolveTools?: (input: {
+        tenantId: number;
+        conversationId: number;
+    }) => Promise<AnyRagTool[]> | AnyRagTool[];
+    /**
+     * Если true — когда RAG не находит контекста (NO_CONTEXT_MARKER) бот всё
+     * равно отвечает через `generateSoftFallback` (честное «уточню и вернусь»
+     * без выдумывания конкретики). Вопрос при этом логируется в kb_suggestions.
+     *
+     * Если false (по умолчанию) — бот молчит (возвращает null), как раньше.
+     */
+    softFallback?: boolean;
+    /**
+     * Фабрика KbSuggestionsRepo для fire-and-forget логирования незакрытых вопросов.
+     * Используется только если softFallback=true.
+     */
+    resolveSuggestions?: (tenantId: number) => KbSuggestionsRepo;
+    /**
+     * Conversation compaction: если кол-во сообщений в диалоге достигает порога —
+     * pipeline генерирует резюме и сохраняет его в conversations.summary_json.
+     * Резюме передаётся в answerWithRag как conversationSummary, сокращая effective
+     * history window и предотвращая overflow LLM context.
+     *
+     * Default: 20. Отключить: 0 или Infinity.
+     */
+    compactAfterMessages?: number;
+    /**
+     * Фабрика ConversationsRepo для сохранения compaction summary.
+     * Если не задан — compaction происходит в памяти (summary не сохраняется).
+     */
+    resolveConversations?: (tenantId: number) => ConversationsRepo;
+    /**
+     * Optional cross-encoder reranker resolver. Called once per turn — should
+     * return a `Reranker` instance (Jina or Cohere) configured for the tenant,
+     * or null/undefined if no reranker is configured. Results are expected to be
+     * cached by the caller (building a reranker per-call is cheap — the API key
+     * lookup is the expensive part, which the caller should cache).
+     */
+    resolveReranker?: (input: {
+        tenantId: number;
+    }) => Promise<Reranker | null> | Reranker | null;
+}
+/**
+ * Helper: распарсить style.config_json (из storage StyleRow) в типизированный
+ * rag's Style через zod StyleSchema. Возвращает null если JSON невалидный —
+ * pipeline'у тогда fall back на DEFAULT_PERSONA вместо crash'а.
+ *
+ * Использовать снаружи (apps/api) при построении resolveStyle hook'а:
+ *   const styleRow = await stylesRepo.findActiveBySlug(slug);
+ *   return parseStyleConfig(styleRow.configJson);
+ */
+export declare function parseStyleConfig(configJson: string): Style | null;
+export declare class RagReplyStrategy implements ReplyStrategy {
+    private readonly opts;
+    private readonly messagesRepoFor;
+    constructor(opts: RagReplyStrategyOpts, messagesRepoFor: (tenantId: number) => MessagesRepo);
+    generate(input: {
+        tenant: {
+            tenantId: number;
+        };
+        channel: {
+            channelId: number;
+        };
+        conversationId: number;
+        contactId: number;
+        inbound: {
+            externalUserId: string;
+        };
+        userMessageText: string;
+    }): Promise<OutboundEnvelope[] | null>;
+}
+//# sourceMappingURL=rag-reply.d.ts.map