nduka 1.0.0

package/dist/conversation/lock-manager.js

@@ -0,0 +1,144 @@
+/**
+ * Conversation Lock Manager
+ *
+ * Per-chat locking to prevent concurrent AI + human responses.
+ * Uses keyed mutex pattern — one lock per chatId so different
+ * chats process concurrently while same chat serializes.
+ *
+ * Based on: async-mutex keyed locking pattern used in
+ * OpenClaw's SQLite outbox and production WhatsApp systems.
+ */
+import { Mutex } from 'async-mutex';
+// ─── Config ──────────────────────────────────────────────────────────────────
+const DEFAULT_LOCK_TIMEOUT_MS = 30_000; // 30 seconds max lock hold
+const STALE_LOCK_MS = 60_000; // Stale after 60s
+// ─── Conversation Lock Manager ────────────────────────────────────────────────
+export class ConversationLockManager {
+    locks = new Map();
+    lockInfo = new Map();
+    activeLocks = new Set();
+    /**
+     * Acquire a lock for a specific chat.
+     * Returns a release function. Blocks until lock is acquired.
+     */
+    async acquire(chatId, holderId, timeoutMs = DEFAULT_LOCK_TIMEOUT_MS) {
+        // Get or create mutex for this chat
+        let mutex = this.locks.get(chatId);
+        if (!mutex) {
+            mutex = new Mutex();
+            this.locks.set(chatId, mutex);
+        }
+        let acquired = false;
+        let releaseFn = null;
+        try {
+            releaseFn = await mutex.acquire();
+            // Check for stale locks
+            const existing = this.lockInfo.get(chatId);
+            if (existing && Date.now() - existing.acquiredAt > STALE_LOCK_MS) {
+                // Stale lock — force release and reacquire
+                this.release(chatId, existing.holderId);
+            }
+            if (this.activeLocks.has(chatId)) {
+                releaseFn();
+                return {
+                    acquired: false,
+                    chatId,
+                    reason: `Already locked by ${this.lockInfo.get(chatId)?.holderId}`,
+                    release: () => { },
+                };
+            }
+            this.activeLocks.add(chatId);
+            this.lockInfo.set(chatId, {
+                chatId,
+                acquiredAt: Date.now(),
+                holderId,
+                timeoutMs,
+            });
+            acquired = true;
+            // Auto-release after timeout
+            const timer = setTimeout(() => {
+                this.release(chatId, holderId);
+            }, timeoutMs);
+            return {
+                acquired: true,
+                chatId,
+                release: () => {
+                    clearTimeout(timer);
+                    this.release(chatId, holderId);
+                    if (releaseFn)
+                        releaseFn();
+                },
+            };
+        }
+        catch (err) {
+            if (releaseFn)
+                releaseFn();
+            return {
+                acquired: false,
+                chatId,
+                reason: `Lock acquisition failed: ${err.message}`,
+                release: () => { },
+            };
+        }
+    }
+    /**
+     * Release a lock for a chat.
+     */
+    release(chatId, holderId) {
+        this.activeLocks.delete(chatId);
+        this.lockInfo.delete(chatId);
+    }
+    /**
+     * Check if a chat is currently locked.
+     */
+    isLocked(chatId) {
+        return this.activeLocks.has(chatId);
+    }
+    /**
+     * Get lock info for a chat.
+     */
+    getLockInfo(chatId) {
+        return this.lockInfo.get(chatId);
+    }
+    /**
+     * Force release all locks (e.g., on shutdown).
+     */
+    releaseAll() {
+        let count = 0;
+        for (const chatId of this.activeLocks) {
+            this.activeLocks.delete(chatId);
+            this.lockInfo.delete(chatId);
+            count++;
+        }
+        // Release all mutexes
+        for (const [chatId, mutex] of this.locks) {
+            try {
+                mutex.cancel();
+            }
+            catch { }
+            count++;
+        }
+        this.locks.clear();
+        return count;
+    }
+    /**
+     * Get count of active locks.
+     */
+    getActiveLockCount() {
+        return this.activeLocks.size;
+    }
+    /**
+     * Detect deadlocks — locks held beyond timeout.
+     */
+    detectDeadlocks() {
+        const now = Date.now();
+        const deadlocks = [];
+        for (const info of this.lockInfo.values()) {
+            if (now - info.acquiredAt > info.timeoutMs * 2) {
+                deadlocks.push(info);
+            }
+        }
+        return deadlocks;
+    }
+}
+//# sourceMappingURL=lock-manager.js.map

package/dist/conversation/lock-manager.js.map

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

package/dist/conversation/memory-trace.d.ts

@@ -0,0 +1,16 @@
+export interface MemoryTracePayload {
+    event: string;
+    chatJid: string;
+    senderJid?: string;
+    messageId?: string;
+    role?: string;
+    textLength?: number;
+    historyCount?: number;
+    userCount?: number;
+    assistantCount?: number;
+    latestPreview?: string;
+    error?: string;
+}
+export declare function memoryTrace(payload: MemoryTracePayload): void;
+export declare function memoryError(payload: MemoryTracePayload): void;
+//# sourceMappingURL=memory-trace.d.ts.map

package/dist/conversation/memory-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-trace.d.ts","sourceRoot":"","sources":["../../src/conversation/memory-trace.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAS7D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAE7D"}

package/dist/conversation/memory-trace.js

@@ -0,0 +1,13 @@
+export function memoryTrace(payload) {
+    if (process.env.CHATBOT_MEMORY_TRACE !== 'true')
+        return;
+    const safe = {
+        ...payload,
+        latestPreview: payload.latestPreview ? payload.latestPreview.slice(0, 120) : undefined,
+    };
+    console.info(`[MemoryTrace] ${JSON.stringify(safe)}`);
+}
+export function memoryError(payload) {
+    console.error(`[MemoryTraceError] ${JSON.stringify(payload)}`);
+}
+//# sourceMappingURL=memory-trace.js.map

package/dist/conversation/memory-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-trace.js","sourceRoot":"","sources":["../../src/conversation/memory-trace.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM;QAAE,OAAO;IAExD,MAAM,IAAI,GAAG;QACX,GAAG,OAAO;QACV,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;KACvF,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,OAAO,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/conversation/natural-schedule-command-controller.d.ts

@@ -0,0 +1,21 @@
+export interface NaturalScheduleCommandInput {
+    text: string;
+    chatJid: string;
+    isOwnerSelfChat: boolean;
+    isGroup: boolean;
+    ownerExcludedChatJids?: string[];
+}
+export interface NaturalScheduleCommandResult {
+    reply: string;
+}
+export declare class NaturalScheduleCommandController {
+    private memory;
+    private aliases;
+    private support;
+    private scheduled;
+    private resolveCandidate;
+    private isKnownDirectTarget;
+    private extractTarget;
+    handle(input: NaturalScheduleCommandInput): NaturalScheduleCommandResult | null;
+}
+//# sourceMappingURL=natural-schedule-command-controller.d.ts.map

package/dist/conversation/natural-schedule-command-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-schedule-command-controller.d.ts","sourceRoot":"","sources":["../../src/conversation/natural-schedule-command-controller.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AA0HD,qBAAa,gCAAgC;IAC3C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,SAAS,CAA+B;IAEhD,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,aAAa;IA8BrB,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,4BAA4B,GAAG,IAAI;CAmChF"}

package/dist/conversation/natural-schedule-command-controller.js

@@ -0,0 +1,180 @@
+import { ChatAliasService } from '../chat-registry/aliases.js';
+import { PersistentMemory } from '../memory/persistent.js';
+import { SupportStore } from '../support/store.js';
+import { ScheduledMessageStore } from '../scheduler/store.js';
+import { parseScheduleTime } from '../scheduler/time.js';
+import { resolveChatTargetFromInbox } from './target-resolver.js';
+function compact(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+function preview(text, max = 180) {
+    const oneLine = compact(text);
+    return oneLine.length > max ? `${oneLine.slice(0, max - 1)}…` : oneLine;
+}
+function cleanToken(raw) {
+    return raw.trim().replace(/[.,;:!?]+$/, '').replace(/^@/, '');
+}
+function normalizePhoneTarget(raw) {
+    const trimmed = raw.trim();
+    if (!/^\+?\d[\d\s().-]{6,}$/.test(trimmed))
+        return null;
+    const digits = trimmed.replace(/\D/g, '');
+    if (digits.length < 8 || digits.length > 15)
+        return null;
+    return `${digits}@s.whatsapp.net`;
+}
+function hasActionTime(text) {
+    const normalized = compact(text)
+        .replace(/\bthe\s+next\b/gi, 'next')
+        .replace(/\bin\s+next\b/gi, 'in')
+        .replace(/\bmins\b/gi, 'minutes')
+        .replace(/\bmin\b/gi, 'minute')
+        .replace(/\bhrs\b/gi, 'hours')
+        .replace(/\bhr\b/gi, 'hour');
+    return /\b(?:in|after)\s+\d+\s+(?:minute|minutes|hour|hours|day|days|week|weeks)\b/i.test(normalized) ||
+        /\b(?:today|tomorrow)\s+(?:morning|afternoon|evening|at\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?|\d{1,2}(?::\d{2})?\s*(?:am|pm))\b/i.test(normalized) ||
+        /\btonight\b/i.test(normalized) ||
+        /\bat\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?\b/i.test(normalized);
+}
+function extractTimeTokens(text) {
+    const normalized = compact(text)
+        .replace(/\bthe\s+next\b/gi, 'next')
+        .replace(/\bin\s+next\b/gi, 'in')
+        .replace(/\bmins\b/gi, 'minutes')
+        .replace(/\bmin\b/gi, 'minute')
+        .replace(/\bhrs\b/gi, 'hours')
+        .replace(/\bhr\b/gi, 'hour');
+    const patterns = [
+        /\b(?:in|after)\s+\d+\s+(?:minute|minutes|hour|hours|day|days|week|weeks)\b/i,
+        /\b(?:today|tomorrow)\s+(?:morning|afternoon|evening|at\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?|\d{1,2}(?::\d{2})?\s*(?:am|pm))\b/i,
+        /\btonight\b/i,
+        /\bat\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?\b/i,
+    ];
+    for (const pattern of patterns) {
+        const match = pattern.exec(normalized);
+        if (match?.[0])
+            return match[0].split(/\s+/);
+    }
+    return null;
+}
+function stripAfterActionBoundary(tail) {
+    const endPatterns = [
+        /[.!?]\s*schedule\s+(?:this\s+message|the\s+message|it|am)?\b/i,
+        /[.!?]\s*send\s+(?:this\s+message|the\s+message|it|am)?\b/i,
+        /\bschedule\s+(?:this\s+message|the\s+message|it|am)?\b/i,
+        /\bsend\s+(?:this\s+message|the\s+message|it|am)\s+(?:in|after|at|today|tomorrow|tonight)\b/i,
+        /\bin\s+(?:the\s+)?next\s+\d+\s+(?:min|mins|minute|minutes|hr|hrs|hour|hours|day|days|week|weeks)\b/i,
+        /\bin\s+\d+\s+(?:min|mins|minute|minutes|hr|hrs|hour|hours|day|days|week|weeks)\b/i,
+        /\bafter\s+\d+\s+(?:min|mins|minute|minutes|hr|hrs|hour|hours|day|days|week|weeks)\b/i,
+    ];
+    const candidates = endPatterns
+        .map((pattern) => pattern.exec(tail)?.index)
+        .filter((value) => typeof value === 'number' && value > 0);
+    const end = candidates.length ? Math.min(...candidates) : tail.length;
+    return tail.slice(0, end);
+}
+function cleanBody(raw) {
+    const body = raw
+        .replace(/^\s*(?:and\s+)?(?:that\s+|say\s+)?/i, '')
+        .replace(/^['“”"]+/, '')
+        .replace(/['“”".!?\s]+$/, '')
+        .trim();
+    return body.length >= 1 ? body : null;
+}
+function extractBody(text, target) {
+    const markerPatterns = [
+        /\btell\s+(?:him|her|them|it|am|[a-z0-9_@.+-]+)\s+(?:say|that)?\s*/ig,
+        /\blet\s+(?:him|her|them|it|am|[a-z0-9_@.+-]+)\s+know\s+(?:that\s+)?/ig,
+        /\bsaying\s+['“”"]?/ig,
+        /\bmessage\s+['“”"]?/ig,
+    ];
+    for (const pattern of markerPatterns) {
+        for (const hit of text.matchAll(pattern)) {
+            const start = (hit.index || 0) + hit[0].length;
+            if (start <= target.index)
+                continue;
+            const body = cleanBody(stripAfterActionBoundary(text.slice(start)));
+            if (body)
+                return body;
+        }
+    }
+    return null;
+}
+export class NaturalScheduleCommandController {
+    memory = new PersistentMemory();
+    aliases = new ChatAliasService(this.memory);
+    support = new SupportStore();
+    scheduled = new ScheduledMessageStore();
+    resolveCandidate(raw, input) {
+        const clean = cleanToken(raw);
+        const phoneTarget = normalizePhoneTarget(clean);
+        if (phoneTarget)
+            return { chatJid: phoneTarget };
+        if (clean.includes('@'))
+            return { chatJid: clean };
+        return resolveChatTargetFromInbox(clean, this.aliases, this.support, input.ownerExcludedChatJids || [input.chatJid]);
+    }
+    isKnownDirectTarget(raw, input) {
+        return Boolean(this.resolveCandidate(raw, input).chatJid);
+    }
+    extractTarget(text, input) {
+        const explicitPatterns = [
+            /\b(?:send|schedule)\s+(?:a\s+)?message\s+to\s+([^\s,;]+)/ig,
+            /\b(?:text|whatsapp|dm|buzz|write)\s+to\s+([^\s,;]+)/ig,
+            /\bto\s+([^\s,;]+)\s+(?:and\s+)?(?:tell|let)\b/ig,
+        ];
+        for (const pattern of explicitPatterns) {
+            for (const match of text.matchAll(pattern)) {
+                const raw = cleanToken(match[1] || '');
+                if (raw)
+                    return { raw, index: match.index || 0, explicit: true };
+            }
+        }
+        const directPatterns = [
+            /\b(?:text|whatsapp|dm|buzz|write)\s+([^\s,;]+)/ig,
+        ];
+        for (const pattern of directPatterns) {
+            for (const match of text.matchAll(pattern)) {
+                const raw = cleanToken(match[1] || '');
+                if (raw && this.isKnownDirectTarget(raw, input)) {
+                    return { raw, index: match.index || 0, explicit: false };
+                }
+            }
+        }
+        return null;
+    }
+    handle(input) {
+        const text = compact(input.text);
+        if (!input.isOwnerSelfChat || input.isGroup || text.startsWith('/'))
+            return null;
+        if (!hasActionTime(text))
+            return null;
+        const targetCandidate = this.extractTarget(text, input);
+        if (!targetCandidate)
+            return null;
+        const body = extractBody(text, targetCandidate);
+        if (!body)
+            return null;
+        const timeTokens = extractTimeTokens(text);
+        if (!timeTokens)
+            return null;
+        const resolved = this.resolveCandidate(targetCandidate.raw, input);
+        if (!resolved.chatJid) {
+            return { reply: `Usage: /schedule <target> <time> <message>\n${resolved.error || `Unknown target: ${targetCandidate.raw}. Run /chats or set an alias first.`}` };
+        }
+        const parsed = parseScheduleTime(timeTokens);
+        if (!parsed)
+            return { reply: 'I understood the scheduled message request, but not the time. Use: /schedule <target> <time> <message>' };
+        const item = this.scheduled.create({
+            chatJid: resolved.chatJid,
+            body,
+            sendAt: parsed.sendAt,
+            timezone: parsed.timezone,
+            createdBy: input.chatJid || 'owner-self-chat',
+        });
+        const alias = this.aliases.getAliasForChat(resolved.chatJid);
+        const target = alias ? `@${alias} (\`${resolved.chatJid}\`)` : `\`${resolved.chatJid}\``;
+        return { reply: `🗓️ Scheduled #${item.id} for ${target} at ${parsed.display}\nMessage: ${preview(body)}` };
+    }
+}
+//# sourceMappingURL=natural-schedule-command-controller.js.map

package/dist/conversation/natural-schedule-command-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-schedule-command-controller.js","sourceRoot":"","sources":["../../src/conversation/natural-schedule-command-controller.ts"],"names":[],"mappings":"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"}

package/dist/conversation/ops.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Conversation Operations Dashboard
+ *
+ * Provides owner visibility into conversation health, memory quality,
+ * context pressure, and system-wide metrics — directly from WhatsApp self-chat.
+ *
+ * Addresses next_step_k.md Problems 1-15:
+ *  - Context health (/context)
+ *  - Memory inspection (/memory)
+ *  - System stats (/stats)
+ *  - Memory confidence tracking
+ *  - Context pressure monitoring
+ */
+import { PersistentMemory } from '../memory/persistent.js';
+import { ChatStateStore } from '../chat-state/store.js';
+import { ChatRegistry } from '../chat-registry/service.js';
+import { EventSourcingStore } from '../event-sourcing/store.js';
+export interface ContextHealth {
+    chatId: string;
+    customerName: string;
+    mode: string;
+    messageCount: number;
+    summaryCount: number;
+    factCount: number;
+    contextPressurePct: number;
+    health: 'GOOD' | 'FAIR' | 'POOR';
+    lastSummary: string;
+    estimatedRemainingPct: number;
+    recommendations: string[];
+}
+export interface SystemStats {
+    activeChats: number;
+    aiControlled: number;
+    humanControlled: number;
+    escalated: number;
+    totalMessages: number;
+    totalFacts: number;
+    totalSummaries: number;
+    averageHealth: number;
+    pendingReviews: number;
+}
+export declare class ConversationOps {
+    private memory;
+    private stateStore;
+    private registry;
+    private eventStore;
+    constructor(memory: PersistentMemory, stateStore: ChatStateStore, registry: ChatRegistry, eventStore: EventSourcingStore);
+    /**
+     * Get context health for a specific chat.
+     * Command: /context <customer>
+     */
+    getContextHealth(chatId: string): ContextHealth;
+    /**
+     * Format context health for WhatsApp display.
+     */
+    formatContextHealth(h: ContextHealth): string;
+    /**
+     * Get system-wide stats.
+     * Command: /stats
+     */
+    getSystemStats(): SystemStats;
+    /**
+     * Format system stats for WhatsApp display.
+     */
+    formatSystemStats(s: SystemStats): string;
+    /**
+     * Run memory garbage collection — remove stale/contradicted/low-confidence facts.
+     */
+    runMemoryGC(chatId: string, maxAgeDays?: number): {
+        removed: number;
+        kept: number;
+    };
+    private pressureBar;
+}
+//# sourceMappingURL=ops.d.ts.map

package/dist/conversation/ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../src/conversation/ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAY,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIhE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AASD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,UAAU,CAAqB;gBAGrC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,cAAc,EAC1B,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,kBAAkB;IAQhC;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IA+C/C;;OAEG;IACH,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM;IAwB7C;;;OAGG;IACH,cAAc,IAAI,WAAW;IAgC7B;;OAEG;IACH,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM;IAazC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IA6B/E,OAAO,CAAC,WAAW;CAIpB"}

package/dist/conversation/ops.js

@@ -0,0 +1,169 @@
+import { ChatMode } from '../chat-state/store.js';
+// ─── Constants ───────────────────────────────────────────────────────────────
+const CONTEXT_PRESSURE_THRESHOLD = 50; // messages before pressure builds
+const MAX_HEALTHY_MESSAGES = 100; // more than this = pressure
+// ─── Conversation Ops Service ────────────────────────────────────────────────
+export class ConversationOps {
+    memory;
+    stateStore;
+    registry;
+    eventStore;
+    constructor(memory, stateStore, registry, eventStore) {
+        this.memory = memory;
+        this.stateStore = stateStore;
+        this.registry = registry;
+        this.eventStore = eventStore;
+    }
+    /**
+     * Get context health for a specific chat.
+     * Command: /context <customer>
+     */
+    getContextHealth(chatId) {
+        const state = this.stateStore.get(chatId);
+        const msgCount = this.memory.getCount(chatId);
+        const records = this.registry.listAll().filter(c => c.chatId === chatId);
+        const record = records[0] || { displayName: 'Unknown', facts: {}, summary: '' };
+        const factCount = record.facts ? Object.keys(record.facts).length : 0;
+        const summaryCount = record.summary ? 1 : 0;
+        // Context pressure: messages minus summaries and facts (they reduce cognitive load)
+        const effectiveLoad = Math.max(0, msgCount - (summaryCount * 30) - (factCount * 10));
+        const pressure = Math.min(100, Math.round((effectiveLoad / MAX_HEALTHY_MESSAGES) * 100));
+        const remaining = 100 - pressure;
+        // Health assessment
+        let health;
+        const recommendations = [];
+        if (pressure < 30) {
+            health = 'GOOD';
+        }
+        else if (pressure < 60) {
+            health = 'FAIR';
+            recommendations.push('Consider summarizing older messages');
+        }
+        else if (pressure < 90) {
+            health = 'POOR';
+            recommendations.push('Memory is full — compaction recommended');
+        }
+        else {
+            health = 'POOR';
+            recommendations.push('URGENT: Compact memory now');
+        }
+        if (factCount > 20)
+            recommendations.push(`${factCount - 20} stale facts — review /memory`);
+        return {
+            chatId,
+            customerName: record.displayName || chatId.slice(0, 15),
+            mode: state.mode,
+            messageCount: msgCount,
+            summaryCount,
+            factCount,
+            contextPressurePct: pressure,
+            health,
+            lastSummary: record.summary ? record.summary.slice(0, 80) + '...' : 'None',
+            estimatedRemainingPct: remaining,
+            recommendations,
+        };
+    }
+    /**
+     * Format context health for WhatsApp display.
+     */
+    formatContextHealth(h) {
+        const healthIcon = h.health === 'GOOD' ? '🟢' : h.health === 'FAIR' ? '🟡' : '🔴';
+        const modeIcon = h.mode === 'AI_ACTIVE' ? '🤖' : h.mode === 'HUMAN_ACTIVE' ? '👤' : '🚨';
+        const lines = [
+            `${modeIcon} *${h.customerName}*`,
+            '',
+            `Context: ${h.contextPressurePct}% ${this.pressureBar(h.contextPressurePct)}`,
+            `Health: ${healthIcon} ${h.health}`,
+            `Messages: ${h.messageCount} | Facts: ${h.factCount}`,
+            `Mode: ${h.mode}`,
+            `Last Summary: ${h.lastSummary}`,
+            `Remaining: ${h.estimatedRemainingPct}%`,
+        ];
+        if (h.recommendations.length > 0) {
+            lines.push('');
+            lines.push('*Recommendations:*');
+            for (const r of h.recommendations)
+                lines.push(`• ${r}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get system-wide stats.
+     * Command: /stats
+     */
+    getSystemStats() {
+        const allStates = this.stateStore.listAll();
+        const modeCounts = this.stateStore.countByMode();
+        const aiControlled = modeCounts.get(ChatMode.AI_ACTIVE) || 0;
+        const humanControlled = modeCounts.get(ChatMode.HUMAN_ACTIVE) || 0;
+        const escalated = modeCounts.get(ChatMode.ESCALATED) || 0;
+        const totalMessages = this.memory.getTotalCount();
+        const totalFacts = this.registry.listAll().reduce((sum, c) => sum + (c.facts ? Object.keys(c.facts).length : 0), 0);
+        const totalSummaries = this.registry.listAll().filter(c => c.summary).length;
+        // Average health: chats with < 50% pressure
+        const lowPressureChats = allStates.filter(() => {
+            const msgCount = this.memory.getCount(''); // Broadcast doesn't have per-chat
+            return msgCount < MAX_HEALTHY_MESSAGES;
+        }).length;
+        const avgHealth = allStates.length > 0 ? Math.round((lowPressureChats / allStates.length) * 100) : 100;
+        return {
+            activeChats: allStates.length,
+            aiControlled,
+            humanControlled,
+            escalated,
+            totalMessages,
+            totalFacts,
+            totalSummaries,
+            averageHealth: avgHealth,
+            pendingReviews: humanControlled + escalated,
+        };
+    }
+    /**
+     * Format system stats for WhatsApp display.
+     */
+    formatSystemStats(s) {
+        return [
+            '📊 *System Stats*',
+            '',
+            `Active Chats: ${s.activeChats}`,
+            `🤖 AI: ${s.aiControlled} | 👤 Human: ${s.humanControlled} | 🚨 Escalated: ${s.escalated}`,
+            `Messages: ${s.totalMessages.toLocaleString()}`,
+            `Facts: ${s.totalFacts} | Summaries: ${s.totalSummaries}`,
+            `Avg Health: ${s.averageHealth}%`,
+            `Pending Reviews: ${s.pendingReviews}`,
+        ].join('\n');
+    }
+    /**
+     * Run memory garbage collection — remove stale/contradicted/low-confidence facts.
+     */
+    runMemoryGC(chatId, maxAgeDays = 90) {
+        const records = this.registry.listAll().filter(c => c.chatId === chatId);
+        if (records.length === 0)
+            return { removed: 0, kept: 0 };
+        const record = records[0];
+        const facts = record.facts || {};
+        const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+        let removed = 0;
+        let kept = 0;
+        for (const [key] of Object.entries(facts)) {
+            // Simple age-based GC: remove facts that haven't been updated
+            // In production, this would check last_verified timestamp
+            if (Date.now() - (record.lastActivity || 0) > cutoff) {
+                delete facts[key];
+                removed++;
+            }
+            else {
+                kept++;
+            }
+        }
+        if (removed > 0) {
+            this.registry.setFacts(chatId, facts);
+        }
+        return { removed, kept };
+    }
+    pressureBar(pct) {
+        const filled = Math.round(pct / 10);
+        return '█'.repeat(filled) + '░'.repeat(10 - filled);
+    }
+}
+//# sourceMappingURL=ops.js.map