@poolzin/pool-bot 2026.4.36 → 2026.4.37

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.4.36",
-  "commit": "713ea950b901906b93c4bd9d8a313731671f40e5",
-  "builtAt": "2026-04-07T11:46:07.534Z"
+  "version": "2026.4.37",
+  "commit": "10cf8ee6ea482359cdb4eb35103b39d6e2f10a55",
+  "builtAt": "2026-04-07T16:52:50.808Z"
 }

package/dist/cli/mcp-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-cli.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,QAqD9C"}
+{"version":3,"file":"mcp-cli.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,QA2D9C"}

package/dist/infra/heartbeat-monitor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Heartbeat health monitoring and auto-recovery.
+ * Detects when heartbeat stops running and triggers recovery.
+ */
+interface MonitorState {
+    lastCheck: number;
+    lastRecovery: number;
+    consecutiveFailures: number;
+}
+/**
+ * Monitor heartbeat health.
+ * Call this periodically (e.g., every 15 minutes).
+ */
+export declare function monitorHeartbeatHealth(workspaceDir: string): {
+    healthy: boolean;
+    lastAudit?: string;
+    action?: string;
+};
+/**
+ * Get monitor status for debugging.
+ */
+export declare function getMonitorStatus(): MonitorState & {
+    lastCheckAgo: string;
+};
+/**
+ * Reset monitor state (for testing/manual recovery).
+ */
+export declare function resetMonitorState(): void;
+export {};
+//# sourceMappingURL=heartbeat-monitor.d.ts.map

package/dist/infra/heartbeat-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-monitor.d.ts","sourceRoot":"","sources":["../../src/infra/heartbeat-monitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAyDD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAsDA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAQ1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAOxC"}

package/dist/infra/heartbeat-monitor.js

@@ -0,0 +1,128 @@
+/**
+ * Heartbeat health monitoring and auto-recovery.
+ * Detects when heartbeat stops running and triggers recovery.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createSubsystemLogger } from '../logging/subsystem.js';
+const log = createSubsystemLogger('heartbeat-monitor');
+const HEARTBEAT_MAX_AGE_MS = 90 * 60 * 1000; // 90 minutes (should run every 30min)
+const RECOVERY_COOLDOWN_MS = 60 * 60 * 1000; // 1 hour between recovery attempts
+let monitorState = {
+    lastCheck: 0,
+    lastRecovery: 0,
+    consecutiveFailures: 0,
+};
+/**
+ * Load heartbeat state file.
+ */
+function loadHeartbeatState(workspaceDir) {
+    const statePath = join(workspaceDir, 'memory', 'heartbeat-state.json');
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(statePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if heartbeat is stale.
+ */
+function isHeartbeatStale(state) {
+    if (!state)
+        return true;
+    const lastAudit = state.lastSecurityAudit;
+    if (!lastAudit)
+        return true;
+    try {
+        const lastAuditTime = new Date(lastAudit).getTime();
+        const now = Date.now();
+        return now - lastAuditTime > HEARTBEAT_MAX_AGE_MS;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Trigger recovery action.
+ */
+async function triggerRecovery() {
+    log.info('[heartbeat-monitor] Triggering recovery action...');
+    // In a full implementation, this would:
+    // 1. Send alert to admin channel
+    // 2. Try to restart heartbeat cron job
+    // 3. Log recovery attempt
+    monitorState.lastRecovery = Date.now();
+    monitorState.consecutiveFailures = 0;
+}
+/**
+ * Monitor heartbeat health.
+ * Call this periodically (e.g., every 15 minutes).
+ */
+export function monitorHeartbeatHealth(workspaceDir) {
+    const now = Date.now();
+    // Don't check too frequently
+    if (now - monitorState.lastCheck < 15 * 60 * 1000) {
+        return { healthy: true };
+    }
+    monitorState.lastCheck = now;
+    const state = loadHeartbeatState(workspaceDir);
+    const stale = isHeartbeatStale(state);
+    if (stale) {
+        monitorState.consecutiveFailures++;
+        const lastAudit = state?.lastSecurityAudit || 'never';
+        log.warn(`[heartbeat-monitor] Heartbeat is STALE! Last audit: ${lastAudit}. Failures: ${monitorState.consecutiveFailures}`);
+        // Trigger recovery if:
+        // 1. Consecutive failures >= 2 (heartbeat missed 2+ cycles)
+        // 2. Recovery cooldown has passed
+        const canRecover = now - monitorState.lastRecovery > RECOVERY_COOLDOWN_MS;
+        if (monitorState.consecutiveFailures >= 2 && canRecover) {
+            void triggerRecovery();
+            return {
+                healthy: false,
+                lastAudit,
+                action: 'recovery_triggered',
+            };
+        }
+        return {
+            healthy: false,
+            lastAudit,
+            action: monitorState.consecutiveFailures >= 2 ? 'recovery_pending' : 'monitoring',
+        };
+    }
+    // Heartbeat is healthy
+    if (monitorState.consecutiveFailures > 0) {
+        log.info(`[heartbeat-monitor] Heartbeat recovered after ${monitorState.consecutiveFailures} failures`);
+        monitorState.consecutiveFailures = 0;
+    }
+    return {
+        healthy: true,
+        lastAudit: state?.lastSecurityAudit,
+    };
+}
+/**
+ * Get monitor status for debugging.
+ */
+export function getMonitorStatus() {
+    const agoMs = Date.now() - monitorState.lastCheck;
+    const agoMin = Math.round(agoMs / 60000);
+    return {
+        ...monitorState,
+        lastCheckAgo: `${agoMin}m ago`,
+    };
+}
+/**
+ * Reset monitor state (for testing/manual recovery).
+ */
+export function resetMonitorState() {
+    monitorState = {
+        lastCheck: 0,
+        lastRecovery: 0,
+        consecutiveFailures: 0,
+    };
+    log.info('[heartbeat-monitor] Monitor state reset');
+}

package/dist/telegram/retry-logic.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Telegram API retry logic with exponential backoff.
+ * Prevents transient network errors from breaking message delivery.
+ */
+import { Context } from 'grammy';
+/**
+ * Execute a Telegram API call with retry logic.
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, context: {
+    action: string;
+    chatId?: string | number;
+}, log?: (msg: string) => void): Promise<T>;
+/**
+ * Send message with retry logic.
+ */
+export declare function sendMessageWithRetry(ctx: Context, text: string, log?: (msg: string) => void): Promise<void>;
+/**
+ * Send chat action with retry logic.
+ */
+export declare function sendChatActionWithRetry(ctx: Context, action: 'typing' | 'upload_photo' | 'record_video' | 'upload_video' | 'record_voice' | 'upload_voice' | 'upload_document' | 'find_location' | 'record_video_note', log?: (msg: string) => void): Promise<void>;
+/**
+ * Edit message with retry logic.
+ */
+export declare function editMessageWithRetry(_ctx: Context, _messageId: number, _text: string, _log?: (msg: string) => void): Promise<void>;
+//# sourceMappingURL=retry-logic.d.ts.map

package/dist/telegram/retry-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-logic.d.ts","sourceRoot":"","sources":["../../src/telegram/retry-logic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAMjC;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACrD,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,CAAC,CAAC,CA6DZ;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,GAAG,mBAAmB,EACjK,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC3B,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/telegram/retry-logic.js

@@ -0,0 +1,75 @@
+/**
+ * Telegram API retry logic with exponential backoff.
+ * Prevents transient network errors from breaking message delivery.
+ */
+const MAX_RETRIES = 3;
+const BASE_DELAY_MS = 1000; // 1 second
+const MAX_DELAY_MS = 10000; // 10 seconds
+/**
+ * Execute a Telegram API call with retry logic.
+ */
+export async function withRetry(operation, context, log) {
+    let lastError = null;
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            const errorMsg = lastError.message.toLowerCase();
+            // Don't retry on certain errors
+            if (errorMsg.includes('bot was blocked') ||
+                errorMsg.includes('chat not found') ||
+                errorMsg.includes('user not found') ||
+                errorMsg.includes('message not modified')) {
+                throw lastError;
+            }
+            // Network errors, rate limits - retry
+            const isRetryable = errorMsg.includes('network') ||
+                errorMsg.includes('fetch') ||
+                errorMsg.includes('timeout') ||
+                errorMsg.includes('rate limit') ||
+                errorMsg.includes('429') ||
+                errorMsg.includes('50') || // 500, 502, 503, etc.
+                errorMsg.includes('sendchataction');
+            if (!isRetryable) {
+                throw lastError;
+            }
+            // Calculate delay with exponential backoff + jitter
+            const delay = Math.min(BASE_DELAY_MS * Math.pow(2, attempt - 1) + Math.random() * 1000, MAX_DELAY_MS);
+            const logMsg = `[telegram/retry] ${context.action} failed (attempt ${attempt}/${MAX_RETRIES}): ${lastError.message}. Retrying in ${Math.round(delay)}ms...`;
+            if (log) {
+                log(logMsg);
+            }
+            else {
+                console.warn(logMsg);
+            }
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    // All retries exhausted
+    const finalError = new Error(`[telegram/retry] ${context.action} failed after ${MAX_RETRIES} attempts: ${lastError?.message}`);
+    if (log) {
+        log(finalError.message);
+    }
+    throw finalError;
+}
+/**
+ * Send message with retry logic.
+ */
+export async function sendMessageWithRetry(ctx, text, log) {
+    await withRetry(() => ctx.reply(text), { action: 'sendMessage', chatId: ctx.chat?.id }, log);
+}
+/**
+ * Send chat action with retry logic.
+ */
+export async function sendChatActionWithRetry(ctx, action, log) {
+    await withRetry(() => ctx.api.sendChatAction(ctx.chat.id, action), { action: 'sendChatAction', chatId: ctx.chat?.id }, log);
+}
+/**
+ * Edit message with retry logic.
+ */
+export async function editMessageWithRetry(_ctx, _messageId, _text, _log) {
+    // Placeholder - implement based on actual API
+    throw new Error('Not implemented');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolzin/pool-bot",
-  "version": "2026.4.36",
+  "version": "2026.4.37",
   "description": "🎱 Pool Bot - AI assistant with PLCODE integrations",
   "keywords": [],
   "license": "MIT",