nduka 1.0.0

package/dist/auth/session-admin.js

@@ -0,0 +1,52 @@
+import { copyFileSync, existsSync, mkdirSync, rmSync, statSync } from 'node:fs';
+import { basename, dirname, resolve } from 'node:path';
+function authPath() {
+    return resolve(process.cwd(), process.env.AUTH_FILE_PATH || './data/auth_state.json');
+}
+function backupDirFor(path) {
+    return resolve(dirname(path), 'backups');
+}
+function stamp(date = new Date()) {
+    return date.toISOString().replace(/[:.]/g, '-');
+}
+export function getAuthStatus(path = authPath()) {
+    const target = resolve(path);
+    if (!existsSync(target))
+        return { path: target, exists: false, sizeBytes: 0, modifiedAt: null };
+    const stats = statSync(target);
+    return { path: target, exists: true, sizeBytes: stats.size, modifiedAt: stats.mtime.toISOString() };
+}
+export function backupAuthState(path = authPath(), now = new Date()) {
+    const target = resolve(path);
+    if (!existsSync(target))
+        return { authPath: target, backupPath: null };
+    const dir = backupDirFor(target);
+    mkdirSync(dir, { recursive: true });
+    const backupPath = resolve(dir, `${basename(target)}.${stamp(now)}.backup.json`);
+    copyFileSync(target, backupPath);
+    return { authPath: target, backupPath };
+}
+export function resetAuthState(options = {}) {
+    if (!options.yes)
+        throw new Error('Refusing to reset auth without --yes. This will require pairing again.');
+    const target = resolve(options.path || authPath());
+    const backup = backupAuthState(target);
+    if (existsSync(target))
+        rmSync(target, { force: true });
+    return backup;
+}
+export function loginCommand(path = authPath()) {
+    const auth = resolve(path);
+    return `AUTH_FILE_PATH=${auth} MEDIA_QUEUE_WORKER_ENABLED=true node dist/gateway/bootstrap.js`;
+}
+export function formatAuthStatus(status = getAuthStatus()) {
+    return [
+        '🔐 Auth Status',
+        `Path: ${status.path}`,
+        `State: ${status.exists ? 'present' : 'missing'}`,
+        status.exists ? `Size: ${status.sizeBytes} bytes` : '',
+        status.modifiedAt ? `Modified: ${status.modifiedAt}` : '',
+        status.exists ? 'Login: existing session should be reused.' : 'Login: start the gateway to show a QR/pairing prompt.',
+    ].filter(Boolean).join('\n');
+}
+//# sourceMappingURL=session-admin.js.map

package/dist/auth/session-admin.js.map

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

package/dist/chat-registry/aliases.d.ts

@@ -0,0 +1,55 @@
+import { PersistentMemory } from '../memory/persistent.js';
+export interface ChatAliasRow {
+    alias: string;
+    chatJid: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ChatProfile {
+    chatJid: string;
+    displayName: string | null;
+    lastPreview: string | null;
+    lastSeenAt: number;
+    updatedAt: number;
+}
+export interface ChatTargetResolution {
+    chatJid: string | null;
+    error?: string;
+}
+export declare class ChatAliasService {
+    private db;
+    private memory;
+    private initialized;
+    constructor(memory: PersistentMemory);
+    private init;
+    normalizeAlias(alias: string): string;
+    validateAlias(alias: string): string | null;
+    setAlias(alias: string, chatJid: string): {
+        success: boolean;
+        error?: string;
+        row?: ChatAliasRow;
+    };
+    removeAlias(alias: string): boolean;
+    get(alias: string): ChatAliasRow | null;
+    getAliasForChat(chatJid: string): string | null;
+    list(): ChatAliasRow[];
+    recordProfile(chatJid: string, input: {
+        displayName?: string | null;
+        preview?: string | null;
+        seenAt?: number;
+    }): void;
+    getProfile(chatJid: string): ChatProfile | null;
+    recentChatTargets(limit?: number, excludedChatJids?: string[]): {
+        index: number;
+        chatJid: string;
+        alias: string | null;
+        displayName: string | null;
+        phone: string | null;
+        lastPreview: string | null;
+        messageCount: number;
+        lastMessageAt: string;
+    }[];
+    resolveTarget(input: string, excludedChatJids?: string[]): ChatTargetResolution;
+    private normalizeJid;
+}
+//# sourceMappingURL=aliases.d.ts.map

package/dist/chat-registry/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../../src/chat-registry/aliases.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,gBAAgB;IAKpC,OAAO,CAAC,IAAI;IAuBZ,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIrC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO3C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,YAAY,CAAA;KAAE;IAkBlG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAUvC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAW/C,IAAI,IAAI,YAAY,EAAE;IAQtB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAmBtH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAU/C,iBAAiB,CACf,KAAK,SAAK,EACV,gBAAgB,GAAE,MAAM,EAAO,GAC9B;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE;IAoBxL,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAM,EAAO,GAAG,oBAAoB;IAyBnF,OAAO,CAAC,YAAY;CAGrB"}

package/dist/chat-registry/aliases.js

@@ -0,0 +1,170 @@
+import { DatabaseManager } from '../database/index.js';
+const ALIAS_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,31}$/;
+export class ChatAliasService {
+    db = DatabaseManager.getInstance();
+    memory;
+    initialized = false;
+    constructor(memory) {
+        this.memory = memory;
+        this.init();
+    }
+    init() {
+        if (this.initialized)
+            return;
+        this.db.getDb().exec(`
+      CREATE TABLE IF NOT EXISTS chat_aliases (
+        alias TEXT PRIMARY KEY NOT NULL,
+        chat_jid TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_chat_aliases_chat_jid ON chat_aliases(chat_jid);
+
+      CREATE TABLE IF NOT EXISTS chat_profiles (
+        chat_jid TEXT PRIMARY KEY NOT NULL,
+        display_name TEXT,
+        last_preview TEXT,
+        last_seen_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_chat_profiles_seen ON chat_profiles(last_seen_at);
+    `);
+        this.initialized = true;
+    }
+    normalizeAlias(alias) {
+        return alias.trim().replace(/^@/, '').toLowerCase();
+    }
+    validateAlias(alias) {
+        const normalized = this.normalizeAlias(alias);
+        if (!ALIAS_PATTERN.test(normalized))
+            return 'Alias must be 1-32 characters and use only letters, numbers, underscore, or dash.';
+        if (normalized.includes('@') || normalized.startsWith('#'))
+            return 'Alias cannot look like a JID or numbered shortcut.';
+        return null;
+    }
+    setAlias(alias, chatJid) {
+        const normalized = this.normalizeAlias(alias);
+        const validation = this.validateAlias(normalized);
+        if (validation)
+            return { success: false, error: validation };
+        if (!chatJid || !chatJid.includes('@'))
+            return { success: false, error: 'Target must resolve to a WhatsApp chat JID.' };
+        const now = Date.now();
+        this.db.getDb().prepare(`
+      INSERT INTO chat_aliases (alias, chat_jid, created_at, updated_at)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(alias) DO UPDATE SET
+        chat_jid = excluded.chat_jid,
+        updated_at = excluded.updated_at
+    `).run(normalized, chatJid, now, now);
+        return { success: true, row: { alias: normalized, chatJid, createdAt: now, updatedAt: now } };
+    }
+    removeAlias(alias) {
+        const normalized = this.normalizeAlias(alias);
+        const result = this.db.getDb().prepare('DELETE FROM chat_aliases WHERE alias = ?').run(normalized);
+        return result.changes > 0;
+    }
+    get(alias) {
+        const normalized = this.normalizeAlias(alias);
+        const row = this.db.getDb().prepare(`
+      SELECT alias, chat_jid as chatJid, created_at as createdAt, updated_at as updatedAt
+      FROM chat_aliases
+      WHERE alias = ?
+    `).get(normalized);
+        return row || null;
+    }
+    getAliasForChat(chatJid) {
+        const row = this.db.getDb().prepare(`
+      SELECT alias
+      FROM chat_aliases
+      WHERE chat_jid = ?
+      ORDER BY updated_at DESC
+      LIMIT 1
+    `).get(chatJid);
+        return row?.alias || null;
+    }
+    list() {
+        return this.db.getDb().prepare(`
+      SELECT alias, chat_jid as chatJid, created_at as createdAt, updated_at as updatedAt
+      FROM chat_aliases
+      ORDER BY alias ASC
+    `).all();
+    }
+    recordProfile(chatJid, input) {
+        if (!chatJid || !chatJid.includes('@'))
+            return;
+        const now = Date.now();
+        const displayName = input.displayName?.trim() || null;
+        const preview = input.preview?.replace(/\s+/g, ' ').trim().slice(0, 120) || null;
+        const seenAt = input.seenAt || now;
+        const current = this.getProfile(chatJid);
+        this.db.getDb().prepare(`
+      INSERT INTO chat_profiles (chat_jid, display_name, last_preview, last_seen_at, updated_at)
+      VALUES (?, ?, ?, ?, ?)
+      ON CONFLICT(chat_jid) DO UPDATE SET
+        display_name = COALESCE(excluded.display_name, chat_profiles.display_name),
+        last_preview = COALESCE(excluded.last_preview, chat_profiles.last_preview),
+        last_seen_at = MAX(excluded.last_seen_at, chat_profiles.last_seen_at),
+        updated_at = excluded.updated_at
+    `).run(chatJid, displayName || current?.displayName || null, preview || current?.lastPreview || null, seenAt, now);
+    }
+    getProfile(chatJid) {
+        const row = this.db.getDb().prepare(`
+      SELECT chat_jid as chatJid, display_name as displayName, last_preview as lastPreview,
+             last_seen_at as lastSeenAt, updated_at as updatedAt
+      FROM chat_profiles
+      WHERE chat_jid = ?
+    `).get(chatJid);
+        return row || null;
+    }
+    recentChatTargets(limit = 15, excludedChatJids = []) {
+        const excluded = new Set(excludedChatJids.map((jid) => this.normalizeJid(jid)));
+        return this.memory.listChats()
+            .filter((chat) => !excluded.has(this.normalizeJid(chat.chatJid)))
+            .slice(0, limit)
+            .map((chat, index) => {
+            const profile = this.getProfile(chat.chatJid);
+            return {
+                index: index + 1,
+                chatJid: chat.chatJid,
+                alias: this.getAliasForChat(chat.chatJid),
+                displayName: profile?.displayName || null,
+                phone: chat.chatJid.endsWith('@s.whatsapp.net') ? chat.chatJid.split('@')[0] : null,
+                lastPreview: profile?.lastPreview || null,
+                messageCount: chat.messageCount,
+                lastMessageAt: chat.lastMessageAt,
+            };
+        });
+    }
+    resolveTarget(input, excludedChatJids = []) {
+        const target = input.trim();
+        if (!target)
+            return { chatJid: null, error: 'Missing chat target.' };
+        const excluded = new Set(excludedChatJids.map((jid) => this.normalizeJid(jid)));
+        if (target.startsWith('#')) {
+            const index = Number(target.slice(1));
+            if (!Number.isInteger(index) || index < 1)
+                return { chatJid: null, error: `Invalid numbered shortcut: ${target}` };
+            const hit = this.recentChatTargets(Math.max(index, 15), excludedChatJids).find((chat) => chat.index === index);
+            if (!hit)
+                return { chatJid: null, error: `No recent customer chat found for ${target}. Run /chats first.` };
+            return { chatJid: hit.chatJid };
+        }
+        if (target.includes('@')) {
+            const jid = this.normalizeJid(target);
+            if (excluded.has(jid))
+                return { chatJid: null, error: 'Owner/admin chat cannot be used as a handoff target.' };
+            return { chatJid: jid };
+        }
+        const alias = this.get(target.replace(/^@/, ''));
+        if (!alias)
+            return { chatJid: null, error: `Unknown alias: ${target}. Run /alias list or /chats.` };
+        if (excluded.has(this.normalizeJid(alias.chatJid)))
+            return { chatJid: null, error: 'Alias points to the owner/admin chat and cannot be used as a handoff target.' };
+        return { chatJid: alias.chatJid };
+    }
+    normalizeJid(jid) {
+        return jid.replace(/:(\d+)@/, '@');
+    }
+}
+//# sourceMappingURL=aliases.js.map

package/dist/chat-registry/aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.js","sourceRoot":"","sources":["../../src/chat-registry/aliases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAuBvD,MAAM,aAAa,GAAG,kCAAkC,CAAC;AAEzD,MAAM,OAAO,gBAAgB;IACnB,EAAE,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,CAAmB;IACzB,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,IAAI;QACV,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;KAiBpB,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,cAAc,CAAC,KAAa;QAC1B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACtD,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,mFAAmF,CAAC;QAChI,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,oDAAoD,CAAC;QACxH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,OAAe;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,UAAU;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAC7D,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;QAExH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;;;;KAMvB,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAEtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC;IAChG,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnG,OAAO,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,KAAa;QACf,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;;KAInC,CAAC,CAAC,GAAG,CAAC,UAAU,CAA6B,CAAC;QAC/C,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,eAAe,CAAC,OAAe;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;;;;KAMnC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAkC,CAAC;QACjD,OAAO,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;;KAI9B,CAAC,CAAC,GAAG,EAAoB,CAAC;IAC7B,CAAC;IAED,aAAa,CAAC,OAAe,EAAE,KAAgF;QAC7G,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;QACtD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC;QACjF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;;;;;;KAQvB,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,WAAW,IAAI,IAAI,EAAE,OAAO,IAAI,OAAO,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACrH,CAAC;IAED,UAAU,CAAC,OAAe;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;;;KAKnC,CAAC,CAAC,GAAG,CAAC,OAAO,CAA4B,CAAC;QAC3C,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,iBAAiB,CACf,KAAK,GAAG,EAAE,EACV,mBAA6B,EAAE;QAE/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;aAC3B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;aAChE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO;gBACL,KAAK,EAAE,KAAK,GAAG,CAAC;gBAChB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;gBACzC,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI;gBACzC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBACnF,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI;gBACzC,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;IAED,aAAa,CAAC,KAAa,EAAE,mBAA6B,EAAE;QAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEhF,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,8BAA8B,MAAM,EAAE,EAAE,CAAC;YACnH,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;YAC/G,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,qCAAqC,MAAM,qBAAqB,EAAE,CAAC;YAC5G,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,sDAAsD,EAAE,CAAC;YAC/G,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,MAAM,8BAA8B,EAAE,CAAC;QACpG,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,8EAA8E,EAAE,CAAC;QACpK,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;IAEO,YAAY,CAAC,GAAW;QAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/chat-registry/index.d.ts

@@ -0,0 +1,3 @@
+export { ChatRegistry, ChatLifecycleEngine } from './service.js';
+export type { ChatRecord, LifecycleEvent } from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/chat-registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat-registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/chat-registry/index.js

@@ -0,0 +1,2 @@
+export { ChatRegistry, ChatLifecycleEngine } from './service.js';
+//# sourceMappingURL=index.js.map

package/dist/chat-registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat-registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/chat-registry/service.d.ts

@@ -0,0 +1,54 @@
+import { ChatMode, ChatStateStore } from '../chat-state/store.js';
+export interface ChatRecord {
+    chatId: string;
+    displayName: string;
+    lastCustomerMessage: string;
+    lastOwnerMessage: string;
+    lastAiMessage: string;
+    mode: ChatMode;
+    unreadCount: number;
+    lastActivity: number;
+    summary?: string;
+    facts?: Record<string, string>;
+}
+export declare class ChatRegistry {
+    private db;
+    private stateStore;
+    private initialized;
+    constructor(stateStore: ChatStateStore);
+    private init;
+    /** Record a customer message. */
+    recordCustomer(chatId: string, content: string): void;
+    /** Record an owner message. */
+    recordOwner(chatId: string, content: string): void;
+    /** Record an AI message. */
+    recordAi(chatId: string, content: string): void;
+    /** Get all chats ordered by last activity. */
+    listAll(): ChatRecord[];
+    /** Format chat list for WhatsApp display. */
+    formatChatList(): string;
+    /** Update summary for a chat. */
+    setSummary(chatId: string, summary: string): void;
+    /** Update facts for a chat. */
+    setFacts(chatId: string, facts: Record<string, string>): void;
+    /** Build context string for AI from registry + recent messages. */
+    buildContext(chatId: string, recentMessages: string[], maxMessages: number): string;
+    private upsert;
+}
+export type LifecycleEvent = 'CUSTOMER_MESSAGE' | 'OWNER_MESSAGE' | 'OWNER_TAKEOVER' | 'OWNER_RESUME' | 'OWNER_ESCALATE' | 'OWNER_SHARE' | 'AI_GENERATION_START' | 'AI_GENERATION_END';
+export declare class ChatLifecycleEngine {
+    private stateStore;
+    constructor(stateStore: ChatStateStore);
+    /**
+     * Formal state transition. All mode changes go through here.
+     * Returns the new state.
+     */
+    transition(chatId: string, event: LifecycleEvent): {
+        success: boolean;
+        previousMode: ChatMode;
+        newMode: ChatMode;
+        error?: string;
+    };
+    private determineTransition;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/chat-registry/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/chat-registry/service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIlE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAkB;IAC5B,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,cAAc;IAMtC,OAAO,CAAC,IAAI;IAmBZ,iCAAiC;IACjC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQrD,+BAA+B;IAC/B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQlD,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ/C,8CAA8C;IAC9C,OAAO,IAAI,UAAU,EAAE;IA6BvB,6CAA6C;IAC7C,cAAc,IAAI,MAAM;IAexB,iCAAiC;IACjC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOjD,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAO7D,mEAAmE;IACnE,YAAY,CACV,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EAAE,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM;IA2BT,OAAO,CAAC,MAAM;CAsBf;AAID,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,qBAAqB,GACrB,mBAAmB,CAAC;AAExB,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAiB;gBAEvB,UAAU,EAAE,cAAc;IAItC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG;QACjD,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,QAAQ,CAAC;QACvB,OAAO,EAAE,QAAQ,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IAsBD,OAAO,CAAC,mBAAmB;CAyB5B"}

package/dist/chat-registry/service.js

@@ -0,0 +1,224 @@
+/**
+ * Chat Registry + Context Builder + Lifecycle Engine
+ *
+ * Combined module for: chat metadata, conversation summary,
+ * fact extraction, and formal state transitions.
+ */
+import { DatabaseManager } from '../database/index.js';
+import { ChatMode } from '../chat-state/store.js';
+// ─── Chat Registry ───────────────────────────────────────────────────────────
+export class ChatRegistry {
+    db;
+    stateStore;
+    initialized = false;
+    constructor(stateStore) {
+        this.db = DatabaseManager.getInstance();
+        this.stateStore = stateStore;
+        this.init();
+    }
+    init() {
+        if (this.initialized)
+            return;
+        const rawDb = this.db.getDb();
+        rawDb.exec(`
+      CREATE TABLE IF NOT EXISTS chat_registry (
+        chat_id TEXT PRIMARY KEY NOT NULL,
+        display_name TEXT NOT NULL DEFAULT '',
+        last_customer_msg TEXT NOT NULL DEFAULT '',
+        last_owner_msg TEXT NOT NULL DEFAULT '',
+        last_ai_msg TEXT NOT NULL DEFAULT '',
+        unread_count INTEGER NOT NULL DEFAULT 0,
+        last_activity INTEGER NOT NULL DEFAULT 0,
+        summary TEXT,
+        facts TEXT
+      );
+    `);
+        this.initialized = true;
+    }
+    /** Record a customer message. */
+    recordCustomer(chatId, content) {
+        this.upsert(chatId, {
+            last_customer_msg: content.slice(0, 200),
+            last_activity: Date.now(),
+            unread_count: 1,
+        });
+    }
+    /** Record an owner message. */
+    recordOwner(chatId, content) {
+        this.upsert(chatId, {
+            last_owner_msg: content.slice(0, 200),
+            last_activity: Date.now(),
+            unread_count: 0,
+        });
+    }
+    /** Record an AI message. */
+    recordAi(chatId, content) {
+        this.upsert(chatId, {
+            last_ai_msg: content.slice(0, 200),
+            last_activity: Date.now(),
+            unread_count: 0,
+        });
+    }
+    /** Get all chats ordered by last activity. */
+    listAll() {
+        const rawDb = this.db.getDb();
+        const rows = rawDb.prepare('SELECT * FROM chat_registry ORDER BY last_activity DESC').all();
+        return rows.map((r) => {
+            const state = this.stateStore.get(r.chat_id);
+            let facts;
+            try {
+                if (r.facts)
+                    facts = JSON.parse(r.facts);
+            }
+            catch {
+                facts = undefined;
+            }
+            return {
+                chatId: r.chat_id,
+                displayName: r.display_name,
+                lastCustomerMessage: r.last_customer_msg,
+                lastOwnerMessage: r.last_owner_msg,
+                lastAiMessage: r.last_ai_msg,
+                mode: state.mode,
+                unreadCount: r.unread_count,
+                lastActivity: r.last_activity,
+                summary: r.summary || undefined,
+                facts,
+            };
+        });
+    }
+    /** Format chat list for WhatsApp display. */
+    formatChatList() {
+        const chats = this.listAll();
+        if (chats.length === 0)
+            return '📋 No active chats.';
+        const lines = ['📋 *Active Chats*', ''];
+        for (const c of chats.slice(0, 20)) {
+            const modeIcon = c.mode === ChatMode.AI_ACTIVE ? '🤖' :
+                c.mode === ChatMode.HUMAN_ACTIVE ? '👤' :
+                    c.mode === ChatMode.SHARED ? '🤝' : '🚨';
+            const preview = (c.lastCustomerMessage || c.lastOwnerMessage || c.lastAiMessage).slice(0, 40);
+            lines.push(`${modeIcon} \`${c.chatId.slice(0, 20)}...\`\n   ${preview || '(no messages)'}`);
+        }
+        return lines.join('\n');
+    }
+    /** Update summary for a chat. */
+    setSummary(chatId, summary) {
+        const rawDb = this.db.getDb();
+        rawDb.prepare('INSERT INTO chat_registry (chat_id, summary, last_activity) VALUES (?, ?, ?) ON CONFLICT(chat_id) DO UPDATE SET summary = excluded.summary').run(chatId, summary, Date.now());
+    }
+    /** Update facts for a chat. */
+    setFacts(chatId, facts) {
+        const rawDb = this.db.getDb();
+        rawDb.prepare('INSERT INTO chat_registry (chat_id, facts, last_activity) VALUES (?, ?, ?) ON CONFLICT(chat_id) DO UPDATE SET facts = excluded.facts').run(chatId, JSON.stringify(facts), Date.now());
+    }
+    /** Build context string for AI from registry + recent messages. */
+    buildContext(chatId, recentMessages, maxMessages) {
+        const record = this.listAll().find((c) => c.chatId === chatId);
+        const parts = [];
+        if (record?.facts) {
+            const factEntries = Object.entries(record.facts);
+            if (factEntries.length > 0) {
+                parts.push('[CUSTOMER PROFILE]');
+                for (const [k, v] of factEntries)
+                    parts.push(`${k}: ${v}`);
+                parts.push('');
+            }
+        }
+        if (record?.summary) {
+            parts.push('[CONVERSATION SUMMARY]');
+            parts.push(record.summary);
+            parts.push('');
+        }
+        if (recentMessages.length > 0) {
+            parts.push('[RECENT MESSAGES]');
+            parts.push(...recentMessages.slice(-maxMessages));
+        }
+        return parts.join('\n');
+    }
+    upsert(chatId, fields) {
+        const rawDb = this.db.getDb();
+        const sets = [];
+        const vals = [];
+        if (fields.last_customer_msg !== undefined) {
+            sets.push('last_customer_msg = ?');
+            vals.push(fields.last_customer_msg);
+        }
+        if (fields.last_owner_msg !== undefined) {
+            sets.push('last_owner_msg = ?');
+            vals.push(fields.last_owner_msg);
+        }
+        if (fields.last_ai_msg !== undefined) {
+            sets.push('last_ai_msg = ?');
+            vals.push(fields.last_ai_msg);
+        }
+        if (fields.last_activity !== undefined) {
+            sets.push('last_activity = ?');
+            vals.push(fields.last_activity);
+        }
+        if (fields.unread_count !== undefined) {
+            sets.push('unread_count = ?');
+            vals.push(fields.unread_count);
+        }
+        if (sets.length === 0)
+            return;
+        rawDb.prepare(`INSERT INTO chat_registry (chat_id, ${sets.map(s => s.split(' = ')[0]).join(', ')})
+       VALUES (? ${sets.map(() => ', ?').join('')})
+       ON CONFLICT(chat_id) DO UPDATE SET ${sets.join(', ')}`).run(chatId, ...vals, ...vals);
+    }
+}
+export class ChatLifecycleEngine {
+    stateStore;
+    constructor(stateStore) {
+        this.stateStore = stateStore;
+    }
+    /**
+     * Formal state transition. All mode changes go through here.
+     * Returns the new state.
+     */
+    transition(chatId, event) {
+        const current = this.stateStore.get(chatId);
+        const previousMode = current.mode;
+        const newMode = this.determineTransition(previousMode, event);
+        if (!newMode) {
+            return { success: false, previousMode, newMode: previousMode, error: `Invalid transition: ${previousMode} + ${event}` };
+        }
+        if (newMode === previousMode) {
+            return { success: true, previousMode, newMode };
+        }
+        const result = this.stateStore.setMode(chatId, newMode, current.version);
+        return {
+            success: result.success,
+            previousMode,
+            newMode: result.state.mode,
+            error: result.success ? undefined : 'Version conflict — retry',
+        };
+    }
+    determineTransition(current, event) {
+        switch (event) {
+            case 'OWNER_TAKEOVER':
+                return ChatMode.HUMAN_ACTIVE;
+            case 'OWNER_RESUME':
+                return ChatMode.AI_ACTIVE;
+            case 'OWNER_ESCALATE':
+                return ChatMode.ESCALATED;
+            case 'OWNER_SHARE':
+                return ChatMode.SHARED;
+            case 'OWNER_MESSAGE':
+                // Owner replying in AI_ACTIVE → auto-takeover to HUMAN_ACTIVE
+                if (current === ChatMode.AI_ACTIVE)
+                    return ChatMode.HUMAN_ACTIVE;
+                return current;
+            case 'CUSTOMER_MESSAGE':
+                // Customer message doesn't change mode
+                return current;
+            case 'AI_GENERATION_START':
+            case 'AI_GENERATION_END':
+                // Generation events don't change mode
+                return current;
+            default:
+                return null;
+        }
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/chat-registry/service.js.map

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