@chatman-media/conversation-engine 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alexander Kireev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# @chatman-media/conversation-engine
+
+[![npm version](https://img.shields.io/npm/v/@chatman-media/conversation-engine?logo=npm&color=22c55e)](https://www.npmjs.com/package/@chatman-media/conversation-engine)
+[![CI](https://github.com/chatman-media/lead-engine/actions/workflows/ci.yml/badge.svg)](https://github.com/chatman-media/lead-engine/actions/workflows/ci.yml)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Bun](https://img.shields.io/badge/Bun-compatible-fbf0df?logo=bun&logoColor=black)](https://bun.sh/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Channel-agnostic inbound pipeline: contact-resolve → conversation lookup → mode routing → AI reply / queued / human → outbound. The heart of the data plane.
+
+Part of the [**lead-engine**](https://github.com/chatman-media/lead-engine) monorepo — a multi-tenant SaaS platform for AI sales bots on Telegram / WhatsApp.
+
+## Install
+
+```bash
+bun add @chatman-media/conversation-engine     # Bun
+npm install @chatman-media/conversation-engine # npm / pnpm / yarn
+```
+
+## License
+
+[MIT](LICENSE) — Alexander Kireev / [chatman-media](https://github.com/chatman-media)

package/dist/compact-conversation.d.ts

@@ -0,0 +1,16 @@
+import type { ChatClient, ChatMessage } from "@chatman-media/llm-router";
+/**
+ * Conversation compaction — summarise a message list into a dense text block
+ * that fits into the `conversationSummary` field of answerWithRag.
+ *
+ * Produced summary is ≤ ~500 words.  The call is intentionally cheap:
+ *  - temperature = 0 (deterministic, no creativity needed)
+ *  - short max-tokens
+ *  - no KB retrieval — pure LLM condensation
+ *
+ * @param messages  Recent messages chronologically (oldest first).
+ * @param chat      Chat LLM client (same as the main pipeline).
+ * @returns Russian-language summary text, or null if messages list is empty.
+ */
+export declare function compactConversation(messages: ChatMessage[], chat: ChatClient): Promise<string | null>;
+//# sourceMappingURL=compact-conversation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compact-conversation.d.ts","sourceRoot":"","sources":["../src/compact-conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+BxB"}

package/dist/compact-conversation.test.d.ts

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

package/dist/compact-conversation.test.d.ts.map

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

package/dist/contact-resolver.d.ts

@@ -0,0 +1,16 @@
+import type { Inbound } from "@chatman-media/channel-core";
+import type { ChannelIdentitiesRepo, ContactRow, ContactsRepo } from "./dal/index.ts";
+/**
+ * Резолвит Contact по входящему сообщению. Если ChannelIdentity для
+ * (channel, externalUserId) уже есть — возвращает существующий Contact;
+ * иначе создаёт новый Contact + ChannelIdentity. Идемпотентно при
+ * параллельных webhooks (на уровне БД UNIQUE(channel_id, external_user_id)
+ * защищает от дублей).
+ */
+export declare function resolveContact(opts: {
+    inbound: Inbound;
+    channelDbId: number;
+    contacts: ContactsRepo;
+    identities: ChannelIdentitiesRepo;
+}): Promise<ContactRow>;
+//# sourceMappingURL=contact-resolver.d.ts.map

package/dist/contact-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-resolver.d.ts","sourceRoot":"","sources":["../src/contact-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtF;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,qBAAqB,CAAC;CACnC,GAAG,OAAO,CAAC,UAAU,CAAC,CA0BtB"}

package/dist/conversation-resolver.d.ts

@@ -0,0 +1,17 @@
+import type { ConversationRow, ConversationsRepo } from "./dal/index.ts";
+/**
+ * Find-or-create conversation для (contact, channel.kind). Уникальный
+ * conversations.user_id × source гарантирует одну строку на канал.
+ * Если контакт пишет одновременно в bot и userbot — получает две
+ * независимые conversations.
+ */
+export declare function resolveConversation(opts: {
+    contactId: number;
+    channelKind: string;
+    conversations: ConversationsRepo;
+    nowEpoch: number;
+}): Promise<{
+    conversation: ConversationRow;
+    created: boolean;
+}>;
+//# sourceMappingURL=conversation-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-resolver.d.ts","sourceRoot":"","sources":["../src/conversation-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAqBzE;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,iBAAiB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAa/D"}

package/dist/dal/channel-identities.d.ts

@@ -0,0 +1,26 @@
+import type { RepoCtx } from "./types.ts";
+export interface ChannelIdentityRow {
+    id: number;
+    contactId: number;
+    channelId: number;
+    externalUserId: string;
+    createdAt: number;
+}
+/**
+ * channel_identities не имеет tenant_id напрямую — scoped через channels.tenant_id.
+ * RepoCtx.tenantId всё равно прокидывается для defence-in-depth: SELECT'ы JOIN'ят
+ * с channels и фильтруют по tenant_id, чтобы случайный bug в channel-resolver'е
+ * не вернул foreign-tenant'овский row.
+ */
+export declare class ChannelIdentitiesRepo {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    /** Найти существующую идентичность по (channelId, externalUserId). */
+    find(channelId: number, externalUserId: string): Promise<ChannelIdentityRow | null>;
+    create(opts: {
+        contactId: number;
+        channelId: number;
+        externalUserId: string;
+    }): Promise<ChannelIdentityRow>;
+}
+//# sourceMappingURL=channel-identities.d.ts.map

package/dist/dal/channel-identities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-identities.d.ts","sourceRoot":"","sources":["../../src/dal/channel-identities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEzC,sEAAsE;IAChE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAanF,MAAM,CAAC,IAAI,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAYhC"}

package/dist/dal/contacts.d.ts

@@ -0,0 +1,30 @@
+import type { RepoCtx } from "./types.ts";
+export interface ContactRow {
+    id: number;
+    tenantId: number;
+    displayName: string | null;
+    attributesJson: string | null;
+    createdAt: number;
+    updatedAt: number;
+}
+export declare class ContactsRepo {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    byId(id: number): Promise<ContactRow | null>;
+    create(opts: {
+        displayName?: string;
+        attributesJson?: string;
+    }): Promise<ContactRow>;
+    /**
+     * Merge'нет partialAttributes поверх существующих contact.attributes_json
+     * и обновит updated_at. Если partial пустой — no-op (без UPDATE).
+     *
+     * JSON merging — shallow: ключи верхнего уровня в partial перезаписывают
+     * существующие; вложенные объекты НЕ деep-merge'атся (это позволяет
+     * вертикали atomically заменить целый struct, например visa_docs).
+     *
+     * Возвращает обновлённый ContactRow.
+     */
+    mergeAttributes(contactId: number, partial: Record<string, unknown>, nowEpoch: number): Promise<ContactRow | null>;
+}
+//# sourceMappingURL=contacts.d.ts.map

package/dist/dal/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/dal/contacts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEnC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQ5C,MAAM,CAAC,IAAI,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAa1F;;;;;;;;;OASG;IACG,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAmB9B"}

package/dist/dal/conversations.d.ts

@@ -0,0 +1,67 @@
+import type { RepoCtx } from "./types.ts";
+export interface ConversationRow {
+    id: number;
+    tenantId: number;
+    userId: number;
+    source: string;
+    mode: "ai" | "queued" | "human";
+    status: "open" | "pending" | "resolved";
+    unreadCount: number;
+    lastMessageText: string | null;
+    escalatedAt: number | null;
+    assignedAdminId: number | null;
+    lastMessageAt: number | null;
+    createdAt: number;
+    styleId: number | null;
+    experimentId: number | null;
+    currentStage: string | null;
+    summaryJson: string | null;
+    metaJson: string | null;
+}
+/**
+ * Conversations repo. Поле `userId` — legacy: было задумано как ссылка
+ * на старую таблицу users. Сейчас conversations.user_id хранит contact.id
+ * (мы reused колонку чтобы избежать схема-миграции при backfill).
+ * После Этапа 8 (миграция users → contacts) переименуем колонку в
+ * contact_id.
+ *
+ * `source` — legacy enum 'bot|userbot|self_play'. В будущей миграции
+ * заменяется на channel_id напрямую (FK на channels). Сейчас contactId
+ * прокидывается дополнительно — каждая conversation per (contact_id, source).
+ */
+export declare class ConversationsRepo {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    /**
+     * Найти существующую conversation per (contactId, source). UNIQUE
+     * uniq_conversations_user_source гарантирует одну строку.
+     */
+    findByContactAndSource(contactId: number, source: string): Promise<ConversationRow | null>;
+    create(opts: {
+        contactId: number;
+        source: string;
+        mode?: "ai" | "queued" | "human";
+        styleId?: number | null;
+        experimentId?: number | null;
+        nowEpoch: number;
+    }): Promise<ConversationRow>;
+    /**
+     * Последние N conversations tenant'а, sorted DESC by last_message_at
+     * (NULLS LAST). Для admin-UI inbox.
+     */
+    recent(limit: number): Promise<ConversationRow[]>;
+    touchLastMessageAt(conversationId: number, nowEpoch: number): Promise<void>;
+    updateInboxMetadata(conversationId: number, opts: {
+        lastMessageText?: string;
+        lastMessageAt?: number;
+        incrementUnread?: boolean;
+        status?: "open" | "pending" | "resolved";
+    }): Promise<void>;
+    markAsRead(conversationId: number): Promise<void>;
+    setAssignee(conversationId: number, adminId: number | null): Promise<void>;
+    /** Сохранить сжатое резюме диалога (conversation compaction). */
+    setSummaryJson(conversationId: number, summaryJson: string): Promise<void>;
+    /** Загрузить conversation по ID. Null если не найдена (или другой tenant). */
+    findById(conversationId: number): Promise<ConversationRow | null>;
+}
+//# sourceMappingURL=conversations.d.ts.map

package/dist/dal/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/dal/conversations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEzC;;;OAGG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAc1F,MAAM,CAAC,IAAI,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;QACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiB5B;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAUjD,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3E,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE;QACJ,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;KAC1C,GACA,OAAO,CAAC,IAAI,CAAC;IAsBV,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhF,iEAAiE;IAC3D,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhF,8EAA8E;IACxE,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAYxE"}

package/dist/dal/experiments.d.ts

@@ -0,0 +1,47 @@
+import type { RepoCtx } from "./types.ts";
+export interface ExperimentRow {
+    id: number;
+    tenantId: number;
+    slug: string;
+    status: string;
+    allocationJson: string;
+    successMetric: string;
+    startedAt: number | null;
+    endedAt: number | null;
+    createdAt: number;
+}
+/**
+ * Experiments repo. allocation_json — TEXT с JSON-массивом
+ *   [{ "style_slug": "empathetic-nepq-v1", "weight": 2 }, ...]
+ * status — enum 'draft|running|paused|done' (storage CHECK).
+ */
+export declare class ExperimentsRepo {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    byId(id: number): Promise<ExperimentRow | null>;
+    findRunningBySlug(slug: string): Promise<ExperimentRow | null>;
+    /**
+     * Все experiments tenant'а (для admin-UI list view, включая draft/done).
+     * Sorted DESC by created_at — recent first.
+     */
+    listAll(): Promise<ExperimentRow[]>;
+    create(data: {
+        slug: string;
+        allocationJson: string;
+        successMetric: string;
+    }): Promise<ExperimentRow>;
+    update(id: number, data: Partial<{
+        allocationJson: string;
+        successMetric: string;
+    }>): Promise<ExperimentRow | null>;
+    setStatus(id: number, status: "running" | "paused" | "done"): Promise<ExperimentRow | null>;
+}
+/**
+ * Parsed единица allocation_json. Weight default 1 если не указан.
+ */
+export interface ExperimentAllocationEntry {
+    styleSlug: string;
+    weight: number;
+}
+export declare function parseAllocation(allocationJson: string): ExperimentAllocationEntry[];
+//# sourceMappingURL=experiments.d.ts.map

package/dist/dal/experiments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.d.ts","sourceRoot":"","sources":["../../src/dal/experiments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEnC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAa/C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAcpE;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IASnC,MAAM,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBpB,MAAM,CACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,GAC/D,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAS1B,SAAS,CACb,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GACpC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAYjC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,yBAAyB,EAAE,CAuBnF"}

package/dist/dal/index.d.ts

@@ -0,0 +1,14 @@
+export { ChannelIdentitiesRepo, type ChannelIdentityRow } from "./channel-identities.ts";
+export { KbSuggestionsRepo } from "./kb-suggestions.ts";
+export { ContactsRepo, type ContactRow } from "./contacts.ts";
+export { ConversationsRepo, type ConversationRow } from "./conversations.ts";
+export { DrizzleKbStore } from "./kb-store.ts";
+export { type ExperimentAllocationEntry, ExperimentsRepo, type ExperimentRow, parseAllocation, } from "./experiments.ts";
+export { LeadsRepo, type LeadRow } from "./leads.ts";
+export { MessagesRepo, type MessageRow } from "./messages.ts";
+export { OutboundQueueRepo, type OutboundQueueRow } from "./outbound.ts";
+export { type SkillAggregateRow, type SkillOutcomeRow, SkillOutcomesRepo, } from "./skill-outcomes.ts";
+export { StylesRepo, type StyleRow } from "./styles.ts";
+export { NotificationsRepo, type NotificationRule, type OperatorSettings } from "./notifications.ts";
+export type { Db, RepoCtx } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/dal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,KAAK,yBAAyB,EAC9B,eAAe,EACf,KAAK,aAAa,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrG,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/dal/kb-store.d.ts

@@ -0,0 +1,58 @@
+import { type IKbStore, type KbSearchHit } from "@chatman-media/kb";
+import type { RepoCtx } from "./types.ts";
+/**
+ * Drizzle/Postgres implementation `IKbStore` контракта из @chatman-media/kb.
+ * Все запросы tenant_id-scoped: WHERE c.tenant_id = ? AND d.tenant_id = ?.
+ *
+ * Ingest-методы реализованы — пакет нужен и admin'ам (через
+ * @chatman-media/kb's ingestFile/Directory) и runtime (search).
+ *
+ * Особенности относительно legacy kb-store implementation:
+ *   - tenant_id обязателен в KOAЖ-дый JOIN'е (защита от cross-tenant leak)
+ *   - конструируем pgvector литерал как '[...]' строку → cast ::vector
+ *   - sanitizeFtsQuery импортируется из @chatman-media/kb (общая логика)
+ *   - hybridSearch использует RRF из @chatman-media/kb
+ */
+export declare class DrizzleKbStore implements IKbStore {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    private vec;
+    search(embedding: number[], k: number, topic?: string | null): Promise<KbSearchHit[]>;
+    private searchBm25;
+    /** BM25-only text search (без vector embeddings). Используется MCP-сервером. */
+    textSearch(query: string, 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>;
+}
+//# sourceMappingURL=kb-store.d.ts.map

package/dist/dal/kb-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-store.d.ts","sourceRoot":"","sources":["../../src/dal/kb-store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,WAAW,EAGjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,YAAW,QAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEzC,OAAO,CAAC,GAAG;IAML,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAuC7E,UAAU;IA2CxB,gFAAgF;IAC1E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI/E,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;IAapB,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;IAWzF,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU3D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB5C,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;IAgBrB,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;CAQlB"}

package/dist/dal/kb-suggestions.d.ts

@@ -0,0 +1,26 @@
+import type { RepoCtx } from "./types.ts";
+/**
+ * Repo для логирования вопросов, на которые бот не смог найти ответ в KB.
+ *
+ * Операторы видят эти записи в admin-UI и могут:
+ *  - Принять (ingested) → написать документ и загрузить в KB.
+ *  - Отклонить (rejected) → пометить как нерелевантный вопрос.
+ *
+ * Используется в RagReplyStrategy когда answerWithRag возвращает NO_CONTEXT_MARKER.
+ */
+export declare class KbSuggestionsRepo {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    /**
+     * Записать незакрытый вопрос.
+     * Fire-and-forget: ошибки залоггированы, но не пробрасываются — чтобы не
+     * блокировать основной pipeline если insert упадёт.
+     */
+    log(opts: {
+        questionText: string;
+        sourceConversationId?: number;
+        sourceMessageId?: number;
+        nowEpoch: number;
+    }): Promise<void>;
+}
+//# sourceMappingURL=kb-suggestions.d.ts.map

package/dist/dal/kb-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-suggestions.d.ts","sourceRoot":"","sources":["../../src/dal/kb-suggestions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEzC;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;CAalB"}

package/dist/dal/leads.d.ts

@@ -0,0 +1,38 @@
+import type { RepoCtx } from "./types.ts";
+export interface LeadRow {
+    id: number;
+    tenantId: number;
+    userId: number;
+    state: string;
+    assignedAdminId?: number | null;
+    intakeJson: string | null;
+    visaDocsJson: string | null;
+    applicationId: string | null;
+    opsChatId: number | null;
+    opsMessageId: number | null;
+    rejectedReason: string | null;
+    decidedByAdminId: number | null;
+    decidedAt: number | null;
+    lastCheckinAt: number | null;
+    visaInterviewField: string | null;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Leads repo. Schema-колонка user_id хранит contact.id (см. ConversationsRepo
+ * docstring о legacy-имени). UNIQUE(user_id) гарантирует один лид на контакт
+ * — даже при нескольких conversations (bot + userbot) лид всё ещё один.
+ */
+export declare class LeadsRepo {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    byId(id: number): Promise<LeadRow | null>;
+    findByContactId(contactId: number): Promise<LeadRow | null>;
+    create(opts: {
+        contactId: number;
+        state: string;
+        nowEpoch: number;
+    }): Promise<LeadRow>;
+    updateState(leadId: number, newState: string, nowEpoch: number): Promise<void>;
+}
+//# sourceMappingURL=leads.d.ts.map

package/dist/dal/leads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leads.d.ts","sourceRoot":"","sources":["../../src/dal/leads.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEnC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQzC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAU3D,MAAM,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAetF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrF"}

package/dist/dal/messages.d.ts

@@ -0,0 +1,48 @@
+import type { RepoCtx } from "./types.ts";
+export interface MessageRow {
+    id: number;
+    tenantId: number;
+    conversationId: number;
+    role: "user" | "assistant" | "human" | "system";
+    text: string;
+    tgMessageId: number | null;
+    metaJson: string | null;
+    createdAt: number;
+    stage: string | null;
+    deletedAt: number | null;
+}
+export declare class MessagesRepo {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    insert(opts: {
+        conversationId: number;
+        role: "user" | "assistant" | "human" | "system";
+        text: string;
+        externalMessageId?: string;
+        metaJson?: string;
+        stage?: string;
+        nowEpoch: number;
+    }): Promise<MessageRow>;
+    /**
+     * Дедупликационный path для пользовательских сообщений: один tg_message_id
+     * per (conversation_id, role='user') уже защищён partial UNIQUE
+     * uniq_msg_user_tg, но мы делаем явный pre-check чтобы вернуть существующую
+     * строку вместо ON CONFLICT (нужны её id и timestamp для downstream).
+     */
+    findUserByExternalId(conversationId: number, externalMessageId: string): Promise<MessageRow | null>;
+    /**
+     * Последние N не-удалённых сообщений в conversation, в хронологическом
+     * порядке (oldest → newest). Используется ReplyStrategy для построения
+     * history-промпта.
+     *
+     * Skip'ает soft-deleted (deleted_at NOT NULL) и system-role (их не
+     * показываем LLM как историю — они для внутренних флагов).
+     */
+    recent(conversationId: number, limit: number): Promise<MessageRow[]>;
+    /**
+     * Подсчитать общее кол-во non-deleted, non-system сообщений в диалоге.
+     * Используется для compaction threshold check.
+     */
+    countByConversation(conversationId: number): Promise<number>;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/dal/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/dal/messages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEnC,MAAM,CAAC,IAAI,EAAE;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;QAChD,IAAI,EAAE,MAAM,CAAC;QACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBvB;;;;;OAKG;IACG,oBAAoB,CACxB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAiB7B;;;;;;;OAOG;IACG,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAiB1E;;;OAGG;IACG,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAcnE"}

package/dist/dal/notifications.d.ts

@@ -0,0 +1,32 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type notificationRules as nrTable, type operatorSettings as osTable, type notificationTemplates as ntTable } from "@chatman-media/storage";
+export type NotificationRule = typeof nrTable.$inferSelect;
+export type OperatorSettings = typeof osTable.$inferSelect;
+export type NotificationTemplate = typeof ntTable.$inferSelect;
+export declare class NotificationsRepo {
+    private readonly db;
+    constructor(db: PostgresJsDatabase);
+    findRulesByEvent(tenantId: number, eventType: string): Promise<NotificationRule[]>;
+    findOperatorSettings(adminId: number): Promise<OperatorSettings | undefined>;
+    findByLinkToken(token: string): Promise<OperatorSettings | undefined>;
+    generateLinkToken(adminId: number, tenantId: number): Promise<string>;
+    linkChat(adminId: number, telegramChatId: string): Promise<void>;
+    findOperatorSettingsByTenant(tenantId: number): Promise<OperatorSettings[]>;
+    partialUpdateSettings(adminId: number, tenantId: number, fields: Partial<Pick<OperatorSettings, "telegramChatId" | "notifyOnAssignedOnly">>): Promise<void>;
+    upsertOperatorSettings(settings: Omit<OperatorSettings, "id" | "updatedAt">): Promise<void>;
+    createRule(rule: Omit<NotificationRule, "id" | "createdAt" | "updatedAt">): Promise<NotificationRule>;
+    listRules(tenantId: number): Promise<NotificationRule[]>;
+    deleteRule(tenantId: number, id: number): Promise<void>;
+    findTemplate(tenantId: number, slug: string): Promise<NotificationTemplate | undefined>;
+    upsertTemplate(tpl: Omit<NotificationTemplate, "id" | "updatedAt">): Promise<void>;
+    listTemplates(tenantId: number): Promise<NotificationTemplate[]>;
+    deleteTemplate(tenantId: number, slug: string): Promise<void>;
+    generateGroupLinkToken(tenantId: number, adminId: number, eventType: string): Promise<string>;
+    findGroupLinkToken(token: string): Promise<{
+        tenantId: number;
+        adminId: number;
+        eventType: string;
+    } | undefined>;
+    deleteGroupLinkToken(token: string): Promise<void>;
+}
+//# sourceMappingURL=notifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/dal/notifications.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAuF,KAAK,iBAAiB,IAAI,OAAO,EAAE,KAAK,gBAAgB,IAAI,OAAO,EAAE,KAAK,qBAAqB,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEzO,MAAM,MAAM,gBAAgB,GAAG,OAAO,OAAO,CAAC,YAAY,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,OAAO,OAAO,CAAC,YAAY,CAAC;AAC3D,MAAM,MAAM,oBAAoB,GAAG,OAAO,OAAO,CAAC,YAAY,CAAC;AAE/D,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,kBAAkB;IAE7C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAalF,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAS5E,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAerE,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBrE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAO3E,qBAAqB,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,sBAAsB,CAAC,CAAC,GACjF,OAAO,CAAC,IAAI,CAAC;IAWV,sBAAsB,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3F,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASrG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAOxD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IASvF,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAalF,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOhE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7D,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc7F,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAUhH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzD"}

package/dist/dal/outbound.d.ts

@@ -0,0 +1,70 @@
+import type { OutboundEnvelope } from "@chatman-media/channel-core";
+import type { RepoCtx } from "./types.ts";
+export interface OutboundQueueRow {
+    id: number;
+    tenantId: number;
+    channelId: number;
+    conversationId: number | null;
+    payloadJson: string;
+    idempotencyKey: string | null;
+    scheduledAt: number;
+    status: "pending" | "processing" | "sent" | "failed" | "cancelled";
+    attempt: number;
+    lastError: string | null;
+    externalMessageId: string | null;
+    sentAt: number | null;
+    createdAt: number;
+}
+export declare class OutboundQueueRepo {
+    private readonly ctx;
+    constructor(ctx: RepoCtx);
+    /**
+     * Поставить envelope в очередь. Идемпотентный insert через
+     * idempotency_key — если строка уже существует, возвращается имеющаяся
+     * вместо дубля. Это защищает от retry'я process-inbound'а после краша
+     * worker'а (Telegram повторно постит webhook).
+     */
+    enqueue(opts: {
+        channelId: number;
+        conversationId?: number | null;
+        envelope: OutboundEnvelope;
+        scheduledAt?: number;
+        nowEpoch: number;
+    }): Promise<OutboundQueueRow>;
+    /**
+     * Атомарно claim'ает до `limit` pending envelope'ов: UPDATE'ом переводит
+     * их в status='processing' и returning'ом отдаёт worker'у. Использует
+     * `FOR UPDATE SKIP LOCKED` в inner SELECT — multi-worker safe: каждая
+     * row claim'ается ровно одним worker'ом, остальные пропускают её
+     * без блокировки.
+     *
+     * Worker'у обязательно вызвать markSent или markFailed после processing —
+     * row застрянет в processing иначе. Cleanup-cron для возврата
+     * processing→pending после timeout'а — отдельный job в Issue #3 / M-2.
+     */
+    /**
+     * @param opts.kinds  Опциональный whitelist `channels.kind` для claim'а.
+     *   Когда задан, JOIN'имся с `channels` и берём только rows для каналов
+     *   указанных типов. Используется чтобы worker не claim'ил web-rows
+     *   (адаптер web-канала живёт в apps/api in-memory с WS-connection'ом —
+     *   worker до него не достанется и mark'нет fail спустя no_adapter).
+     *   undefined → не фильтруем (legacy / тесты).
+     */
+    claimPending(opts: {
+        limit: number;
+        nowEpoch: number;
+        kinds?: string[];
+    }): Promise<OutboundQueueRow[]>;
+    /**
+     * Откатить зависшие processing rows обратно в pending. Идёт по rows
+     * у которых status='processing' дольше `stuckSec` секунд (worker умер
+     * не дойдя до markSent/markFailed). Cron'ится из apps/worker раз в N минут.
+     */
+    releaseStuckProcessing(opts: {
+        nowEpoch: number;
+        stuckSec: number;
+    }): Promise<number>;
+    markSent(id: number, externalMessageId: string, nowEpoch: number): Promise<void>;
+    markFailed(id: number, error: string): Promise<void>;
+}
+//# sourceMappingURL=outbound.d.ts.map