@chatman-media/conversation-engine 1.2.0

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

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

package/dist/rls-guard.d.ts

@@ -0,0 +1,23 @@
+import type { Db } from "./dal/types.ts";
+export interface RlsRoleCheck {
+    /** current_user в этом connection'е. */
+    role: string;
+    /** rolsuper — superuser bypass'ит RLS всегда. */
+    isSuperuser: boolean;
+    /** rolbypassrls — explicit BYPASSRLS attribute. */
+    hasBypassRls: boolean;
+    /** Resultant: будет ли RLS реально enforce'иться для этой роли. */
+    isEnforced: boolean;
+}
+/**
+ * Возвращает информацию о том, enforce'ится ли RLS на текущем connection'е.
+ * apps/api / apps/worker зовут это в boot и логируют warning если RLS
+ * по факту выключен (superuser / BYPASSRLS).
+ *
+ * Миграция 0004 включает FORCE ROW LEVEL SECURITY на всех tenant-scoped
+ * таблицах, но Postgres exempt'ит superuser-роли и роли с BYPASSRLS=true.
+ * Production deploy ДОЛЖЕН использовать ordinary role'ью (NOSUPERUSER
+ * NOBYPASSRLS) — иначе RLS бесполезен как defense-in-depth.
+ */
+export declare function checkRlsEnforcement(db: Db): Promise<RlsRoleCheck>;
+//# sourceMappingURL=rls-guard.d.ts.map

package/dist/rls-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rls-guard.d.ts","sourceRoot":"","sources":["../src/rls-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAC;IACtB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAyBvE"}

package/dist/rls-guard.integration.test.d.ts

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

package/dist/rls-guard.integration.test.d.ts.map

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

package/dist/secrets.d.ts

@@ -0,0 +1,27 @@
+import type { Db } from "./dal/types.ts";
+export declare class SecretCryptoError extends Error {
+    constructor(reason: string);
+}
+export declare function encryptSecret(masterKeyHex: string, plaintext: string): string;
+export declare function decryptSecret(masterKeyHex: string, ciphertext: string): string;
+/**
+ * Прочитать и расшифровать secret. Возвращает null если ключ не существует
+ * для данного tenant'а. Бросает SecretCryptoError если ciphertext битый или
+ * master-key неверный (auth tag mismatch).
+ */
+export declare function getDecryptedSecret(opts: {
+    db: Db;
+    tenantId: number;
+    key: string;
+    masterKeyHex: string;
+}): Promise<string | null>;
+/** Upsert зашифрованного secret'а. */
+export declare function setEncryptedSecret(opts: {
+    db: Db;
+    tenantId: number;
+    key: string;
+    value: string;
+    masterKeyHex: string;
+    nowEpoch: number;
+}): Promise<void>;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAkBzC,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,MAAM,EAAE,MAAM;CAI3B;AAeD,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAc7E;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAoB9E;AAID;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOzB;AAED,sCAAsC;AACtC,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB"}

package/dist/secrets.test.d.ts

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

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

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

package/dist/stage-classifier.d.ts

@@ -0,0 +1,48 @@
+import type { FunnelStage } from "@chatman-media/kb";
+import type { Db } from "./dal/types.ts";
+/**
+ * Pipeline contract: что pipeline ожидает от любого stage-classifier
+ * (regex/LLM/external). Implementations живут в `@chatman-media/sales`
+ * как sales-domain logic — sales имеет access к ChatClient и регекспам
+ * для русских sales-cues.
+ *
+ * Здесь только TYPE — чтобы processInbound и apps/api могли референсить
+ * без создания circular dep (sales → conv-engine для Db типов).
+ *
+ * НЕ путать с vertical-template'овским lead.state (intake_pending → docs →
+ * visa) — это разные оси:
+ *   - lead.state: операционный pipeline найма (один на лида)
+ *   - conversation.current_stage: micro-state диалога продажи (per turn)
+ */
+export interface StageClassifier {
+    /**
+     * Классифицирует stage по тексту user-message + опц. контексту.
+     * Возвращает FunnelStage или null если уверенности нет.
+     */
+    classify(input: {
+        /**
+         * Tenant контекст — нужен LLM-based реализациям для resolveChat
+         * (per-tenant LLM-config). Regex-impl игнорирует, но в interface
+         * required чтобы pipeline call-site всегда передавал реальный
+         * tenantId из processInbound deps.
+         */
+        tenantId: number;
+        userMessageText: string;
+        previousStage: string | null;
+        isFirstUserMessage: boolean;
+    }): Promise<FunnelStage | null> | FunnelStage | null;
+}
+/**
+ * Обновляет `conversations.current_stage` если new стадия отличается от
+ * существующей. Idempotent: same-stage → no UPDATE. Pipeline-side persistence
+ * step — живёт в conv-engine (где DAL), а не в sales (где stage classifier
+ * impls). Чтобы избежать circular dep, sales-impl'ы возвращают FunnelStage,
+ * conv-engine берёт результат и применяет через applyClassifiedStage.
+ */
+export declare function applyClassifiedStage(opts: {
+    db: Db;
+    tenantId: number;
+    conversationId: number;
+    newStage: FunnelStage | null;
+}): Promise<boolean>;
+//# sourceMappingURL=stage-classifier.d.ts.map

package/dist/stage-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-classifier.d.ts","sourceRoot":"","sources":["../src/stage-classifier.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE;QACd;;;;;WAKG;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,kBAAkB,EAAE,OAAO,CAAC;KAC7B,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC;CACtD;AAID;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBnB"}

package/dist/testkit.d.ts

@@ -0,0 +1,82 @@
+import type { ChannelIdentityRow, ContactRow, ConversationRow, MessageRow, OutboundQueueRow } from "./dal/index.ts";
+export declare class FakeContactsRepo {
+    readonly tenantId: number;
+    private nextId;
+    private readonly rows;
+    constructor(tenantId: number);
+    byId(id: number): Promise<ContactRow | null>;
+    create(opts: {
+        displayName?: string;
+        attributesJson?: string;
+    }): Promise<ContactRow>;
+    mergeAttributes(contactId: number, partial: Record<string, unknown>, nowEpoch: number): Promise<ContactRow | null>;
+    all(): ContactRow[];
+}
+export declare class FakeChannelIdentitiesRepo {
+    private nextId;
+    private readonly rows;
+    find(channelId: number, externalUserId: string): Promise<ChannelIdentityRow | null>;
+    create(opts: {
+        contactId: number;
+        channelId: number;
+        externalUserId: string;
+    }): Promise<ChannelIdentityRow>;
+    all(): ChannelIdentityRow[];
+}
+export declare class FakeConversationsRepo {
+    readonly tenantId: number;
+    private nextId;
+    private readonly rows;
+    constructor(tenantId: number);
+    findByContactAndSource(contactId: number, source: string): Promise<ConversationRow | null>;
+    create(opts: {
+        contactId: number;
+        source: string;
+        mode?: "ai" | "queued" | "human";
+        nowEpoch: 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>;
+    all(): ConversationRow[];
+}
+export declare class FakeMessagesRepo {
+    readonly tenantId: number;
+    private nextId;
+    private readonly rows;
+    constructor(tenantId: number);
+    insert(opts: {
+        conversationId: number;
+        role: "user" | "assistant" | "human" | "system";
+        text: string;
+        externalMessageId?: string;
+        metaJson?: string;
+        stage?: string;
+        nowEpoch: number;
+    }): Promise<MessageRow>;
+    findUserByExternalId(conversationId: number, externalMessageId: string): Promise<MessageRow | null>;
+    all(): MessageRow[];
+}
+export declare class FakeOutboundQueueRepo {
+    readonly tenantId: number;
+    private nextId;
+    private readonly rows;
+    constructor(tenantId: number);
+    enqueue(opts: {
+        channelId: number;
+        conversationId?: number | null;
+        envelope: {
+            idempotencyKey?: string;
+        };
+        scheduledAt?: number;
+        nowEpoch: number;
+    }): Promise<OutboundQueueRow>;
+    all(): OutboundQueueRow[];
+}
+//# sourceMappingURL=testkit.d.ts.map

package/dist/testkit.d.ts.map

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

package/dist/transcriber.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Интерфейс для STT-транскрибации голосовых сообщений.
+ * Pipeline инжектит реализацию через ProcessInboundDeps.transcriber.
+ * Реализация живёт в apps/api (WhisperTranscriber).
+ */
+export interface ITranscriber {
+    /**
+     * Транскрибирует аудиофайл в текст.
+     * @param audio  Raw bytes аудиофайла (OGG, MP3, WAV, …)
+     * @param filename  Имя файла с расширением — провайдер определяет по нему формат
+     * @returns Текст транскрипции, или null если транскрипция не удалась
+     */
+    transcribe(audio: Uint8Array, filename: string): Promise<string | null>;
+}
+//# sourceMappingURL=transcriber.d.ts.map

package/dist/transcriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber.d.ts","sourceRoot":"","sources":["../src/transcriber.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACzE"}

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+import type { Inbound, OutboundEnvelope } from "@chatman-media/channel-core";
+/**
+ * Минимальный snapshot tenant'а нужный для pipeline. Резолвится по
+ * channels.tenant_id один раз на inbound и прокидывается через context.
+ */
+export interface TenantContext {
+    tenantId: number;
+    slug: string;
+    llmBillingMode: "byok" | "managed";
+}
+/**
+ * Канал-уровневый контекст. channelId стабильный — соответствует
+ * channels.id в БД, использовать его, не external_id.
+ */
+export interface ChannelContext {
+    channelId: number;
+    kind: "telegram_bot" | "telegram_userbot" | "whatsapp" | "web";
+    /** External id канала у провайдера (bot username, phone). Для логов. */
+    externalId: string;
+}
+/**
+ * Решение pipeline по входящему: что было сделано и нужны ли downstream
+ * действия. Возвращается из processInbound() так чтобы apps/worker мог
+ * dispatch'ить telemetry / WebSocket events без дёрганья БД.
+ */
+export interface ProcessInboundResult {
+    contactId: number;
+    conversationId: number;
+    /**
+     * Сообщение записано в messages? Может быть false если inbound полностью
+     * проигнорирован (например, callback_query без матча на функционал).
+     */
+    persisted: boolean;
+    /**
+     * Сколько OutboundEnvelope'ов было поставлено в outbound_queue в этом
+     * pipeline-проходе. 0 = бот ничего не отвечает (mediaOnly / handover-mode).
+     */
+    outboundEnqueued: number;
+    /**
+     * Текст user-сообщения (после inboundText() свёртки). Заполняется когда
+     * pipeline вызван с `deferReply: true` — `generateReplyAndEnqueue` потом
+     * использует это значение для reply.generate БЕЗ нового read'а из БД.
+     * Когда deferReply=false (default) — поле не выставляется.
+     */
+    userMessageText?: string;
+    /** True если только media без caption (бот не должен отвечать). */
+    mediaOnly?: boolean;
+    /**
+     * True если processInbound пропустил reply.generate (deferReply=true) —
+     * caller должен вызвать `generateReplyAndEnqueue` чтобы завершить
+     * pipeline. False (или undefined) = pipeline отработал полностью.
+     */
+    replyDeferred?: boolean;
+    /** Если конверсация переключилась в режим оператора — сюда попадает причина. */
+    escalatedReason?: string;
+}
+/**
+ * Дешёвый side-effect sink. Тонкая обёртка чтобы pipeline не зависел от
+ * конкретного логгера/EventBus'а. apps/worker подсоединяет реальный sink
+ * на boot. Все поля опциональные — testkit-fake может не реализовывать
+ * ничего и pipeline всё равно работает.
+ */
+export interface PipelineSink {
+    log?: (level: "debug" | "info" | "warn" | "error", msg: string, meta?: Record<string, unknown>) => void;
+    emit?: (event: PipelineEvent) => void;
+}
+export type PipelineEvent = {
+    type: "inbound-received";
+    tenantId: number;
+    conversationId: number;
+    inbound: Inbound;
+} | {
+    type: "message-persisted";
+    tenantId: number;
+    conversationId: number;
+    messageId: number;
+    role: "user" | "assistant";
+} | {
+    type: "outbound-enqueued";
+    tenantId: number;
+    conversationId: number;
+    queueItemId: number;
+    envelope: OutboundEnvelope;
+} | {
+    type: "conversation-escalated";
+    tenantId: number;
+    conversationId: number;
+    reason: string;
+};
+/**
+ * Стандартный clock — для тестирования (replace на fake clock в unit-тестах).
+ * `nowEpoch()` возвращает unix-seconds — формат, в котором БД хранит timestamps.
+ */
+export interface Clock {
+    nowEpoch(): number;
+}
+export declare const systemClock: Clock;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,GAAG,kBAAkB,GAAG,UAAU,GAAG,KAAK,CAAC;IAC/D,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACxG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,GACtH;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GACxH;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAC"}

package/dist/with-tenant.d.ts

@@ -0,0 +1,25 @@
+import type { Db } from "./dal/types.ts";
+/**
+ * Открывает транзакцию, выставляет `SET LOCAL app.tenant_id = <id>` (для
+ * Postgres RLS-policy `tenant_isolation`), потом вызывает `fn(tx)`.
+ *
+ * RLS-policies в миграции 0004 сравнивают `tenant_id` колонку с
+ * `current_setting('app.tenant_id', true)::int`. Без SET LOCAL var = NULL
+ * → policy всегда false → 0 видимых строк (fail-safe).
+ *
+ * Использование в apps/api / apps/worker:
+ *   const result = await withTenant(db, tenantId, async (tx) => {
+ *     const repo = new ContactsRepo({ db: tx, tenantId });
+ *     return repo.byId(42);
+ *   });
+ *
+ * `tx` имеет тот же тип что `Db` (Drizzle PostgresJsDatabase) — repo-методы
+ * принимают его без изменений. SET LOCAL scoped в транзакцию: после COMMIT
+ * setting сбрасывается, connection возвращается в pool clean.
+ *
+ * Idempotent при nested-вызовах: вложенный withTenant с тем же tenantId
+ * просто переоткроет SET LOCAL (no-op effectively); с разным — переопределит
+ * (caller responsibility — не делать так без чёткого понимания).
+ */
+export declare function withTenant<T>(db: Db, tenantId: number, fn: (tx: Db) => Promise<T>): Promise<T>;
+//# sourceMappingURL=with-tenant.d.ts.map

package/dist/with-tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-tenant.d.ts","sourceRoot":"","sources":["../src/with-tenant.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@chatman-media/conversation-engine",
+  "version": "1.2.0",
+  "description": "Channel-agnostic pipeline обработки inbound сообщений: contact-resolve → conversation lookup → mode routing → AI-reply / queued / human → outbound. Сердце data plane.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --format esm --external '@chatman-media/*' --external drizzle-orm && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "check": "biome check ./src",
+    "format": "biome format --write ./src",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "lead-engine",
+    "conversation",
+    "pipeline",
+    "multi-tenant"
+  ],
+  "author": "Alexander Kireev",
+  "license": "MIT",
+  "dependencies": {
+    "@chatman-media/channel-core": "1.0.0",
+    "@chatman-media/channel-telegram": "1.0.0",
+    "@chatman-media/llm-router": "1.0.0",
+    "@chatman-media/kb": "1.2.0",
+    "@chatman-media/storage": "1.3.0",
+    "@chatman-media/verticals": "1.1.0"
+  },
+  "peerDependencies": {
+    "drizzle-orm": ">=0.36.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.14",
+    "@types/bun": "1.3.14",
+    "drizzle-orm": "^0.36.0",
+    "postgres": "^3.4.5",
+    "typescript": "^6.0.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chatman-media/lead-engine.git",
+    "directory": "packages/conversation-engine"
+  },
+  "homepage": "https://github.com/chatman-media/lead-engine/tree/main/packages/conversation-engine#readme",
+  "bugs": {
+    "url": "https://github.com/chatman-media/lead-engine/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}