crewly 1.4.80 → 1.4.82

package/dist/backend/backend/src/services/messaging/response-router.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"response-router.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/response-router.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"response-router.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/response-router.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/messaging/thread-status-queue.service.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Thread Status Queue Service
+ *
+ * Tracks the lifecycle of every inbound message thread across platforms
+ * (Slack, GChat, Telegram, etc.). On orchestrator restart, non-terminal
+ * threads are recovered and re-enqueued so no user messages are silently dropped.
+ *
+ * Persistence is debounced and written to ~/.crewly/thread-status-queue.json
+ * using atomic file I/O to prevent corruption.
+ *
+ * @module services/messaging/thread-status-queue
+ */
+import type { ThreadStatus, ThreadStatusEntry, TrackInboundInput, ThreadStatusStats, ReplyStatus } from '../../types/thread-status.types.js';
+/**
+ * Service that maintains a persistent queue of thread statuses.
+ * Constructed with a crewly home directory path for disk persistence.
+ *
+ * Lifecycle: enqueued → delivered → replied_* (terminal or waiting_actions)
+ *
+ * @example
+ * ```typescript
+ * const svc = new ThreadStatusQueueService('/home/user/.crewly');
+ * await svc.loadPersistedState();
+ *
+ * const entry = svc.trackInbound({
+ *   source: 'slack',
+ *   threadKey: 'C123:170743.001',
+ *   conversationId: 'conv-1',
+ *   messagePreview: 'Deploy the new feature',
+ * });
+ *
+ * svc.markDelivered('C123:170743.001');
+ * svc.markReplied('C123:170743.001', 'replied_completed');
+ * ```
+ */
+export declare class ThreadStatusQueueService {
+    /** Singleton instance */
+    private static instance;
+    /** Logger for this service */
+    private logger;
+    /** All tracked thread entries, keyed by threadKey for O(1) lookup */
+    private entries;
+    /** Path to the persistence file, or null if init() has not been called */
+    private persistPath;
+    /** Debounce timer for batching persistence writes */
+    private persistTimer;
+    /** ISO timestamp of last cleanup run */
+    private lastCleanupAt;
+    /**
+     * Creates a new ThreadStatusQueueService.
+     * Use getInstance() for singleton access, or construct directly for testing.
+     *
+     * @param crewlyHome - Optional crewly home directory path for immediate initialization
+     */
+    constructor(crewlyHome?: string);
+    /**
+     * Returns the singleton instance of ThreadStatusQueueService.
+     * Call init() after this to set the persistence path.
+     *
+     * @returns The singleton instance
+     */
+    static getInstance(): ThreadStatusQueueService;
+    /**
+     * Resets the singleton instance. For testing only.
+     */
+    static resetInstance(): void;
+    /**
+     * Loads persisted state from disk.
+     * If the file doesn't exist or is corrupted, starts with an empty queue.
+     */
+    loadPersistedState(): Promise<void>;
+    /**
+     * Records a new inbound thread message with status `enqueued`.
+     * If a thread with the same threadKey already exists, the existing entry is returned.
+     *
+     * @param input - Inbound message details
+     * @returns The created (or existing) ThreadStatusEntry
+     */
+    trackInbound(input: TrackInboundInput): ThreadStatusEntry;
+    /**
+     * Transitions a thread from `enqueued` (or `error`) to `delivered`.
+     * No-op if thread is already in a terminal or later status.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @throws Error if threadKey is not found
+     */
+    markDelivered(threadKey: string): void;
+    /**
+     * Transitions a thread to one of the replied_* statuses.
+     * Sets the repliedAt timestamp.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @param status - One of: replied_completed, replied_waiting_actions, replied_to_follow_up
+     * @throws Error if threadKey is not found or status is not a valid reply status
+     */
+    markReplied(threadKey: string, status: ReplyStatus): void;
+    /**
+     * Records that an agent was delegated work from this thread.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @param agentSession - Session name of the delegated agent
+     * @throws Error if threadKey is not found
+     */
+    addDelegatedAgent(threadKey: string, agentSession: string): void;
+    /**
+     * Transitions a `replied_waiting_actions` thread to `replied_completed`
+     * when all delegated agents have finished their work.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @throws Error if threadKey is not found
+     */
+    markDelegationsComplete(threadKey: string): void;
+    /**
+     * Returns all entries not in a terminal status. Used for restart recovery.
+     *
+     * @returns Array of non-terminal ThreadStatusEntry objects
+     */
+    getPendingThreads(): ThreadStatusEntry[];
+    /**
+     * Returns all entries matching the given status.
+     *
+     * @param status - The ThreadStatus to filter by
+     * @returns Array of matching ThreadStatusEntry objects
+     */
+    getByStatus(status: ThreadStatus): ThreadStatusEntry[];
+    /**
+     * Retrieves a specific entry by threadKey.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @returns The entry, or null if not found
+     */
+    get(threadKey: string): ThreadStatusEntry | null;
+    /**
+     * Expires entries that have been in a non-terminal status longer than maxAgeMinutes.
+     * Transitions them to `expired`.
+     *
+     * @param maxAgeMinutes - Maximum age in minutes (defaults to STALE_TIMEOUT_MINUTES)
+     * @returns Number of entries expired
+     */
+    expireStale(maxAgeMinutes?: number): number;
+    /**
+     * Removes terminal entries older than retentionHours.
+     * Also enforces MAX_ENTRIES by pruning oldest terminal entries first.
+     *
+     * @param retentionHours - Hours to retain terminal entries (defaults to CLEANUP_RETENTION_HOURS)
+     * @returns Number of entries removed
+     */
+    cleanup(retentionHours?: number): number;
+    /**
+     * Returns statistics for monitoring the thread status queue.
+     *
+     * @returns Stats snapshot including total, per-status counts, and oldest pending timestamp
+     */
+    getStats(): ThreadStatusStats;
+    /**
+     * Initializes the service with a crewly home directory for persistence.
+     * Must be called before loadPersistedState() when using getInstance().
+     *
+     * @param crewlyHome - Absolute path to the crewly home directory (e.g. ~/.crewly)
+     */
+    init(crewlyHome: string): void;
+    /**
+     * Public convenience method: optionally re-inits the persist path,
+     * then loads persisted state from disk.
+     *
+     * @param crewlyHome - Optional crewly home directory to re-initialize with
+     */
+    load(crewlyHome?: string): Promise<void>;
+    /**
+     * Immediately flushes the current state to disk. Call during graceful shutdown
+     * to ensure no in-memory mutations are lost.
+     */
+    persist(): Promise<void>;
+    /**
+     * Cleans up timers. Call on shutdown.
+     */
+    destroy(): void;
+    /**
+     * Retrieves an entry by threadKey or throws an error with a descriptive message.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @param caller - Name of the calling method (for error messages)
+     * @returns The found entry
+     * @throws Error if entry is not found
+     */
+    private getOrThrow;
+    /**
+     * Schedules a debounced persistence write to disk.
+     * Multiple mutations within PERSIST_DEBOUNCE_MS are batched into a single write.
+     */
+    private schedulePersist;
+    /**
+     * Writes the current queue state to disk atomically.
+     */
+    private persistToDisk;
+}
+//# sourceMappingURL=thread-status-queue.service.d.ts.map

package/dist/backend/backend/src/services/messaging/thread-status-queue.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-status-queue.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/thread-status-queue.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAEjB,WAAW,EACZ,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,wBAAwB;IACnC,yBAAyB;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAElD,8BAA8B;IAC9B,OAAO,CAAC,MAAM,CAAkG;IAEhH,qEAAqE;IACrE,OAAO,CAAC,OAAO,CAA6C;IAE5D,0EAA0E;IAC1E,OAAO,CAAC,WAAW,CAAuB;IAE1C,qDAAqD;IACrD,OAAO,CAAC,YAAY,CAA8C;IAElE,wCAAwC;IACxC,OAAO,CAAC,aAAa,CAAoC;IAEzD;;;;;OAKG;gBACS,UAAU,CAAC,EAAE,MAAM;IAO/B;;;;;OAKG;IACH,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAO9C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAO5B;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCzC;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB;IAkCzD;;;;;;OAMG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAetC;;;;;;;OAOG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAmBzD;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAgBhE;;;;;;OAMG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAahD;;;;OAIG;IACH,iBAAiB,IAAI,iBAAiB,EAAE;IAUxC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,EAAE;IAUtD;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAIhD;;;;;;OAMG;IACH,WAAW,CAAC,aAAa,GAAE,MAAsD,GAAG,MAAM;IAuB1F;;;;;;OAMG;IACH,OAAO,CAAC,cAAc,GAAE,MAAwD,GAAG,MAAM;IAqCzF;;;;OAIG;IACH,QAAQ,IAAI,iBAAiB;IA8B7B;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;;OAKG;IACG,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACH,OAAO,IAAI,IAAI;IAWf;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAQlB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;YACW,aAAa;CAe5B"}

package/dist/backend/backend/src/services/messaging/thread-status-queue.service.js

@@ -0,0 +1,458 @@
+/**
+ * Thread Status Queue Service
+ *
+ * Tracks the lifecycle of every inbound message thread across platforms
+ * (Slack, GChat, Telegram, etc.). On orchestrator restart, non-terminal
+ * threads are recovered and re-enqueued so no user messages are silently dropped.
+ *
+ * Persistence is debounced and written to ~/.crewly/thread-status-queue.json
+ * using atomic file I/O to prevent corruption.
+ *
+ * @module services/messaging/thread-status-queue
+ */
+import { randomUUID } from 'crypto';
+import path from 'path';
+import { THREAD_STATUS_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { atomicWriteFile, safeReadJson } from '../../utils/file-io.utils.js';
+import { PERSISTED_THREAD_STATUS_VERSION, isPersistedThreadStatusState, isTerminalStatus, isReplyStatus, } from '../../types/thread-status.types.js';
+/**
+ * Service that maintains a persistent queue of thread statuses.
+ * Constructed with a crewly home directory path for disk persistence.
+ *
+ * Lifecycle: enqueued → delivered → replied_* (terminal or waiting_actions)
+ *
+ * @example
+ * ```typescript
+ * const svc = new ThreadStatusQueueService('/home/user/.crewly');
+ * await svc.loadPersistedState();
+ *
+ * const entry = svc.trackInbound({
+ *   source: 'slack',
+ *   threadKey: 'C123:170743.001',
+ *   conversationId: 'conv-1',
+ *   messagePreview: 'Deploy the new feature',
+ * });
+ *
+ * svc.markDelivered('C123:170743.001');
+ * svc.markReplied('C123:170743.001', 'replied_completed');
+ * ```
+ */
+export class ThreadStatusQueueService {
+    /** Singleton instance */
+    static instance;
+    /** Logger for this service */
+    logger = LoggerService.getInstance().createComponentLogger('ThreadStatusQueueService');
+    /** All tracked thread entries, keyed by threadKey for O(1) lookup */
+    entries = new Map();
+    /** Path to the persistence file, or null if init() has not been called */
+    persistPath = null;
+    /** Debounce timer for batching persistence writes */
+    persistTimer = null;
+    /** ISO timestamp of last cleanup run */
+    lastCleanupAt = new Date().toISOString();
+    /**
+     * Creates a new ThreadStatusQueueService.
+     * Use getInstance() for singleton access, or construct directly for testing.
+     *
+     * @param crewlyHome - Optional crewly home directory path for immediate initialization
+     */
+    constructor(crewlyHome) {
+        if (crewlyHome) {
+            this.persistPath = path.join(crewlyHome, THREAD_STATUS_CONSTANTS.STORAGE_FILE);
+            this.logger.info('Initialized', { persistPath: this.persistPath });
+        }
+    }
+    /**
+     * Returns the singleton instance of ThreadStatusQueueService.
+     * Call init() after this to set the persistence path.
+     *
+     * @returns The singleton instance
+     */
+    static getInstance() {
+        if (!ThreadStatusQueueService.instance) {
+            ThreadStatusQueueService.instance = new ThreadStatusQueueService();
+        }
+        return ThreadStatusQueueService.instance;
+    }
+    /**
+     * Resets the singleton instance. For testing only.
+     */
+    static resetInstance() {
+        if (ThreadStatusQueueService.instance) {
+            ThreadStatusQueueService.instance.destroy();
+        }
+        ThreadStatusQueueService.instance = undefined;
+    }
+    /**
+     * Loads persisted state from disk.
+     * If the file doesn't exist or is corrupted, starts with an empty queue.
+     */
+    async loadPersistedState() {
+        if (!this.persistPath) {
+            this.logger.warn('loadPersistedState called before init — skipping');
+            return;
+        }
+        const defaultState = {
+            version: PERSISTED_THREAD_STATUS_VERSION,
+            entries: [],
+            lastCleanupAt: new Date().toISOString(),
+        };
+        const state = await safeReadJson(this.persistPath, defaultState, this.logger);
+        if (!isPersistedThreadStatusState(state)) {
+            this.logger.warn('Invalid persisted state, starting fresh');
+            return;
+        }
+        this.entries.clear();
+        for (const entry of state.entries) {
+            this.entries.set(entry.threadKey, entry);
+        }
+        this.lastCleanupAt = state.lastCleanupAt;
+        this.logger.info('Loaded persisted state', {
+            entryCount: this.entries.size,
+            lastCleanupAt: this.lastCleanupAt,
+        });
+    }
+    /**
+     * Records a new inbound thread message with status `enqueued`.
+     * If a thread with the same threadKey already exists, the existing entry is returned.
+     *
+     * @param input - Inbound message details
+     * @returns The created (or existing) ThreadStatusEntry
+     */
+    trackInbound(input) {
+        const existing = this.entries.get(input.threadKey);
+        if (existing) {
+            this.logger.debug('Thread already tracked, returning existing', { threadKey: input.threadKey });
+            return existing;
+        }
+        const now = new Date().toISOString();
+        const entry = {
+            id: randomUUID(),
+            source: input.source,
+            threadKey: input.threadKey,
+            conversationId: input.conversationId,
+            status: 'enqueued',
+            receivedAt: now,
+            updatedAt: now,
+            messagePreview: input.messagePreview.slice(0, THREAD_STATUS_CONSTANTS.MAX_PREVIEW_LENGTH),
+            retryCount: 0,
+            queueMessageId: input.queueMessageId,
+            sourceMetadata: input.sourceMetadata,
+        };
+        this.entries.set(input.threadKey, entry);
+        this.schedulePersist();
+        this.logger.info('Tracked inbound thread', {
+            threadKey: input.threadKey,
+            source: input.source,
+            conversationId: input.conversationId,
+        });
+        return entry;
+    }
+    /**
+     * Transitions a thread from `enqueued` (or `error`) to `delivered`.
+     * No-op if thread is already in a terminal or later status.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @throws Error if threadKey is not found
+     */
+    markDelivered(threadKey) {
+        const entry = this.getOrThrow(threadKey, 'markDelivered');
+        if (isTerminalStatus(entry.status) || entry.status === 'delivered') {
+            return;
+        }
+        const now = new Date().toISOString();
+        entry.status = 'delivered';
+        entry.deliveredAt = now;
+        entry.updatedAt = now;
+        this.schedulePersist();
+        this.logger.info('Marked delivered', { threadKey });
+    }
+    /**
+     * Transitions a thread to one of the replied_* statuses.
+     * Sets the repliedAt timestamp.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @param status - One of: replied_completed, replied_waiting_actions, replied_to_follow_up
+     * @throws Error if threadKey is not found or status is not a valid reply status
+     */
+    markReplied(threadKey, status) {
+        if (!isReplyStatus(status)) {
+            throw new Error(`Invalid reply status: ${status}`);
+        }
+        const entry = this.getOrThrow(threadKey, 'markReplied');
+        if (isTerminalStatus(entry.status)) {
+            return;
+        }
+        const now = new Date().toISOString();
+        entry.status = status;
+        entry.repliedAt = now;
+        entry.updatedAt = now;
+        this.schedulePersist();
+        this.logger.info('Marked replied', { threadKey, status });
+    }
+    /**
+     * Records that an agent was delegated work from this thread.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @param agentSession - Session name of the delegated agent
+     * @throws Error if threadKey is not found
+     */
+    addDelegatedAgent(threadKey, agentSession) {
+        const entry = this.getOrThrow(threadKey, 'addDelegatedAgent');
+        if (!entry.delegatedAgents) {
+            entry.delegatedAgents = [];
+        }
+        if (!entry.delegatedAgents.includes(agentSession)) {
+            entry.delegatedAgents.push(agentSession);
+            entry.updatedAt = new Date().toISOString();
+            this.schedulePersist();
+            this.logger.info('Added delegated agent', { threadKey, agentSession });
+        }
+    }
+    /**
+     * Transitions a `replied_waiting_actions` thread to `replied_completed`
+     * when all delegated agents have finished their work.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @throws Error if threadKey is not found
+     */
+    markDelegationsComplete(threadKey) {
+        const entry = this.getOrThrow(threadKey, 'markDelegationsComplete');
+        if (entry.status !== 'replied_waiting_actions') {
+            return;
+        }
+        entry.status = 'replied_completed';
+        entry.updatedAt = new Date().toISOString();
+        this.schedulePersist();
+        this.logger.info('Marked delegations complete', { threadKey });
+    }
+    /**
+     * Returns all entries not in a terminal status. Used for restart recovery.
+     *
+     * @returns Array of non-terminal ThreadStatusEntry objects
+     */
+    getPendingThreads() {
+        const pending = [];
+        for (const entry of this.entries.values()) {
+            if (!isTerminalStatus(entry.status)) {
+                pending.push(entry);
+            }
+        }
+        return pending;
+    }
+    /**
+     * Returns all entries matching the given status.
+     *
+     * @param status - The ThreadStatus to filter by
+     * @returns Array of matching ThreadStatusEntry objects
+     */
+    getByStatus(status) {
+        const results = [];
+        for (const entry of this.entries.values()) {
+            if (entry.status === status) {
+                results.push(entry);
+            }
+        }
+        return results;
+    }
+    /**
+     * Retrieves a specific entry by threadKey.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @returns The entry, or null if not found
+     */
+    get(threadKey) {
+        return this.entries.get(threadKey) ?? null;
+    }
+    /**
+     * Expires entries that have been in a non-terminal status longer than maxAgeMinutes.
+     * Transitions them to `expired`.
+     *
+     * @param maxAgeMinutes - Maximum age in minutes (defaults to STALE_TIMEOUT_MINUTES)
+     * @returns Number of entries expired
+     */
+    expireStale(maxAgeMinutes = THREAD_STATUS_CONSTANTS.STALE_TIMEOUT_MINUTES) {
+        const cutoff = Date.now() - maxAgeMinutes * 60 * 1000;
+        let count = 0;
+        for (const entry of this.entries.values()) {
+            if (isTerminalStatus(entry.status))
+                continue;
+            const updatedTime = new Date(entry.updatedAt).getTime();
+            if (updatedTime < cutoff) {
+                entry.status = 'expired';
+                entry.updatedAt = new Date().toISOString();
+                count++;
+            }
+        }
+        if (count > 0) {
+            this.schedulePersist();
+            this.logger.info('Expired stale threads', { count, maxAgeMinutes });
+        }
+        return count;
+    }
+    /**
+     * Removes terminal entries older than retentionHours.
+     * Also enforces MAX_ENTRIES by pruning oldest terminal entries first.
+     *
+     * @param retentionHours - Hours to retain terminal entries (defaults to CLEANUP_RETENTION_HOURS)
+     * @returns Number of entries removed
+     */
+    cleanup(retentionHours = THREAD_STATUS_CONSTANTS.CLEANUP_RETENTION_HOURS) {
+        const cutoff = Date.now() - retentionHours * 60 * 60 * 1000;
+        let count = 0;
+        // Remove terminal entries older than retention period
+        for (const [key, entry] of this.entries) {
+            if (isTerminalStatus(entry.status)) {
+                const updatedTime = new Date(entry.updatedAt).getTime();
+                if (updatedTime < cutoff) {
+                    this.entries.delete(key);
+                    count++;
+                }
+            }
+        }
+        // Enforce MAX_ENTRIES: prune oldest terminal entries first
+        if (this.entries.size > THREAD_STATUS_CONSTANTS.MAX_ENTRIES) {
+            const terminalEntries = Array.from(this.entries.entries())
+                .filter(([, e]) => isTerminalStatus(e.status))
+                .sort(([, a], [, b]) => new Date(a.updatedAt).getTime() - new Date(b.updatedAt).getTime());
+            for (const [key] of terminalEntries) {
+                if (this.entries.size <= THREAD_STATUS_CONSTANTS.MAX_ENTRIES)
+                    break;
+                this.entries.delete(key);
+                count++;
+            }
+        }
+        if (count > 0) {
+            this.lastCleanupAt = new Date().toISOString();
+            this.schedulePersist();
+            this.logger.info('Cleaned up entries', { removed: count, remaining: this.entries.size });
+        }
+        return count;
+    }
+    /**
+     * Returns statistics for monitoring the thread status queue.
+     *
+     * @returns Stats snapshot including total, per-status counts, and oldest pending timestamp
+     */
+    getStats() {
+        const byStatus = {
+            enqueued: 0,
+            delivered: 0,
+            replied_completed: 0,
+            replied_waiting_actions: 0,
+            replied_to_follow_up: 0,
+            expired: 0,
+            error: 0,
+        };
+        let oldestPending = null;
+        for (const entry of this.entries.values()) {
+            byStatus[entry.status]++;
+            if (!isTerminalStatus(entry.status)) {
+                if (oldestPending === null || entry.receivedAt < oldestPending) {
+                    oldestPending = entry.receivedAt;
+                }
+            }
+        }
+        return {
+            total: this.entries.size,
+            byStatus,
+            oldestPending,
+        };
+    }
+    /**
+     * Initializes the service with a crewly home directory for persistence.
+     * Must be called before loadPersistedState() when using getInstance().
+     *
+     * @param crewlyHome - Absolute path to the crewly home directory (e.g. ~/.crewly)
+     */
+    init(crewlyHome) {
+        this.persistPath = path.join(crewlyHome, THREAD_STATUS_CONSTANTS.STORAGE_FILE);
+        this.logger.info('Initialized', { persistPath: this.persistPath });
+    }
+    /**
+     * Public convenience method: optionally re-inits the persist path,
+     * then loads persisted state from disk.
+     *
+     * @param crewlyHome - Optional crewly home directory to re-initialize with
+     */
+    async load(crewlyHome) {
+        if (crewlyHome) {
+            this.init(crewlyHome);
+        }
+        await this.loadPersistedState();
+    }
+    /**
+     * Immediately flushes the current state to disk. Call during graceful shutdown
+     * to ensure no in-memory mutations are lost.
+     */
+    async persist() {
+        // Cancel any debounced write — we flush synchronously
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = null;
+        }
+        await this.persistToDisk();
+    }
+    /**
+     * Cleans up timers. Call on shutdown.
+     */
+    destroy() {
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = null;
+        }
+    }
+    // ===========================================================================
+    // Private Helpers
+    // ===========================================================================
+    /**
+     * Retrieves an entry by threadKey or throws an error with a descriptive message.
+     *
+     * @param threadKey - Platform-specific thread identifier
+     * @param caller - Name of the calling method (for error messages)
+     * @returns The found entry
+     * @throws Error if entry is not found
+     */
+    getOrThrow(threadKey, caller) {
+        const entry = this.entries.get(threadKey);
+        if (!entry) {
+            throw new Error(`${caller}: thread not found — threadKey=${threadKey}`);
+        }
+        return entry;
+    }
+    /**
+     * Schedules a debounced persistence write to disk.
+     * Multiple mutations within PERSIST_DEBOUNCE_MS are batched into a single write.
+     */
+    schedulePersist() {
+        if (!this.persistPath)
+            return;
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+        }
+        this.persistTimer = setTimeout(() => {
+            this.persistTimer = null;
+            this.persistToDisk().catch((err) => {
+                this.logger.warn('Failed to persist thread status queue', { error: String(err) });
+            });
+        }, THREAD_STATUS_CONSTANTS.PERSIST_DEBOUNCE_MS);
+    }
+    /**
+     * Writes the current queue state to disk atomically.
+     */
+    async persistToDisk() {
+        if (!this.persistPath) {
+            this.logger.warn('persistToDisk called before init — skipping');
+            return;
+        }
+        const state = {
+            version: PERSISTED_THREAD_STATUS_VERSION,
+            entries: Array.from(this.entries.values()),
+            lastCleanupAt: this.lastCleanupAt,
+        };
+        await atomicWriteFile(this.persistPath, JSON.stringify(state, null, 2));
+        this.logger.debug('Persisted to disk', { entryCount: state.entries.length });
+    }
+}
+//# sourceMappingURL=thread-status-queue.service.js.map