@runcore-sh/runcore 0.1.2

package/dist/services/backup.js

@@ -0,0 +1,334 @@
+/**
+ * Automated brain backup service — DASH-147.
+ * Schedules periodic backups of the brain/ directory to configured storage providers.
+ * Brain files are already encrypted at rest (DASH-148), so backup is just file sync.
+ * Safe word never leaves the local machine.
+ *
+ * Recovery process: clone repo → pull backup → enter safe word → brain reconstituted.
+ */
+import { readFile, readdir, stat, mkdir, writeFile, rm } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { createHash, randomBytes } from "node:crypto";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createLogger } from "../utils/logger.js";
+import { logActivity } from "../activity/log.js";
+import { isEncryptedLine } from "../lib/encryption.js";
+import { getBackupConfig } from "../settings.js";
+import { LocalStorageAdapter } from "../adapters/storage/local.js";
+import { GDriveBackupAdapter } from "../adapters/storage/gdrive-backup.js";
+const log = createLogger("backup");
+const execFileAsync = promisify(execFile);
+// ── Module state ─────────────────────────────────────────────────────────────
+let timer = null;
+let lastBackup = null;
+let lastBackupError = null;
+const CHECK_INTERVAL_MS = 60 * 60 * 1000; // Check every hour
+// ── Timer lifecycle ──────────────────────────────────────────────────────────
+export function startBackupTimer() {
+    if (timer)
+        return;
+    const config = getBackupConfig();
+    if (!config.enabled) {
+        log.info("backup service disabled, not starting timer");
+        return;
+    }
+    timer = setInterval(async () => {
+        try {
+            await checkAndRunScheduledBackup();
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log.error("backup timer error", { error: msg });
+            logActivity({ source: "system", summary: `Backup timer error: ${msg}` });
+        }
+    }, CHECK_INTERVAL_MS);
+    log.info(`backup timer started: schedule=${config.schedule}, providers=${config.providers.join(",")}`);
+}
+export function stopBackupTimer() {
+    if (timer)
+        clearInterval(timer);
+    timer = null;
+}
+export function isBackupTimerRunning() {
+    return timer !== null;
+}
+export function getLastBackup() {
+    return lastBackup;
+}
+export function getLastBackupError() {
+    return lastBackupError;
+}
+export function getActiveBackupConfig() {
+    return getBackupConfig();
+}
+// ── Schedule check ───────────────────────────────────────────────────────────
+let lastScheduledRun = null;
+async function checkAndRunScheduledBackup() {
+    const now = new Date();
+    const hour = now.getHours();
+    // Only run at the configured hour
+    if (hour !== getBackupConfig().backupHour)
+        return;
+    // Build a date key to avoid running more than once per day
+    const dateKey = now.toISOString().slice(0, 10);
+    if (getBackupConfig().schedule === "weekly") {
+        // Only run on Sundays
+        if (now.getDay() !== 0)
+            return;
+    }
+    // Already ran today
+    if (lastScheduledRun === dateKey)
+        return;
+    lastScheduledRun = dateKey;
+    log.info("running scheduled backup", { schedule: getBackupConfig().schedule, dateKey });
+    const result = await runBackup();
+    if (result.ok) {
+        logActivity({
+            source: "system",
+            summary: `Scheduled backup completed: ${result.message}`,
+        });
+    }
+    else {
+        logActivity({
+            source: "system",
+            summary: `Scheduled backup failed: ${result.message}`,
+        });
+    }
+}
+// ── Core backup logic ────────────────────────────────────────────────────────
+const BRAIN_DIR = join(process.cwd(), "brain");
+const TEMP_DIR = join(process.cwd(), ".core-backups", "tmp");
+/**
+ * Run a backup of the brain/ directory to all configured providers.
+ * Can be called manually or by the scheduler.
+ */
+export async function runBackup(overrideProviders) {
+    const providers = overrideProviders ?? getBackupConfig().providers;
+    const backupId = `backup_${Date.now()}_${randomBytes(4).toString("hex")}`;
+    const timestamp = new Date().toISOString();
+    log.info("starting backup", { backupId, providers });
+    try {
+        // 1. Scan brain directory and build manifest
+        const files = await scanBrainFiles(BRAIN_DIR);
+        const totalBytes = files.reduce((sum, f) => sum + f.sizeBytes, 0);
+        const manifest = {
+            id: backupId,
+            timestamp,
+            files,
+            totalBytes,
+            provider: providers.join(","),
+        };
+        // 2. Create tar.gz archive
+        await mkdir(TEMP_DIR, { recursive: true });
+        const archiveName = `${backupId}.tar.gz`;
+        const archivePath = join(TEMP_DIR, archiveName);
+        const manifestPath = join(TEMP_DIR, `${backupId}.manifest.json`);
+        await writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
+        await createTarGz(BRAIN_DIR, archivePath);
+        // 3. Upload to each provider
+        const adapters = providers.map((p) => getAdapter(p));
+        const results = [];
+        for (const adapter of adapters) {
+            const available = await adapter.isAvailable();
+            if (!available) {
+                results.push({ provider: adapter.name, ok: false, message: `${adapter.name} not available` });
+                continue;
+            }
+            const uploadResult = await adapter.upload(archivePath, archiveName);
+            results.push({ provider: adapter.name, ok: uploadResult.ok, message: uploadResult.message });
+            // Prune old backups
+            if (uploadResult.ok && getBackupConfig().maxBackups > 0) {
+                await pruneOldBackups(adapter, getBackupConfig().maxBackups);
+            }
+        }
+        // 4. Clean up temp files
+        await rm(TEMP_DIR, { recursive: true, force: true }).catch(() => { });
+        // 5. Check results
+        const allOk = results.every((r) => r.ok);
+        const summary = results.map((r) => `${r.provider}: ${r.ok ? "OK" : r.message}`).join("; ");
+        if (allOk) {
+            lastBackup = manifest;
+            lastBackupError = null;
+            log.info("backup completed", { backupId, files: files.length, totalBytes, summary });
+            return { ok: true, message: summary, manifest };
+        }
+        const anyOk = results.some((r) => r.ok);
+        lastBackupError = summary;
+        if (anyOk)
+            lastBackup = manifest;
+        log.warn("backup partially failed", { summary });
+        return { ok: anyOk, message: summary, manifest: anyOk ? manifest : undefined };
+    }
+    catch (err) {
+        lastBackupError = err.message;
+        log.error("backup failed", { backupId, error: err.message });
+        return { ok: false, message: `Backup failed: ${err.message}` };
+    }
+}
+/**
+ * Restore brain/ from a backup archive.
+ * After restore, user must enter safe word to decrypt episodic files.
+ */
+export async function restoreBackup(provider, backupId) {
+    const adapter = getAdapter(provider);
+    const available = await adapter.isAvailable();
+    if (!available)
+        return { ok: false, message: `${provider} not available` };
+    try {
+        await mkdir(TEMP_DIR, { recursive: true });
+        const archiveName = `${backupId}.tar.gz`;
+        const localPath = join(TEMP_DIR, archiveName);
+        // Download archive
+        const dlResult = await adapter.download(archiveName, localPath);
+        if (!dlResult.ok)
+            return { ok: false, message: dlResult.message };
+        // Extract to brain/
+        await extractTarGz(localPath, BRAIN_DIR);
+        // Clean up temp
+        await rm(TEMP_DIR, { recursive: true, force: true }).catch(() => { });
+        log.info("backup restored", { backupId, provider });
+        logActivity({
+            source: "system",
+            summary: `Brain restored from backup ${backupId} (${provider}). Enter safe word to decrypt episodic files.`,
+        });
+        return { ok: true, message: `Restored from ${provider}. Enter safe word to decrypt episodic files.` };
+    }
+    catch (err) {
+        log.error("restore failed", { backupId, error: err.message });
+        return { ok: false, message: `Restore failed: ${err.message}` };
+    }
+}
+/**
+ * Verify a backup by checking manifest checksums against stored files.
+ */
+export async function verifyBackup(provider, backupId) {
+    const adapter = getAdapter(provider);
+    const backups = await adapter.listBackups();
+    const manifest = backups.find((b) => b.id === backupId);
+    if (!manifest) {
+        return { ok: false, message: `Backup ${backupId} not found`, mismatches: [] };
+    }
+    // Verify checksums against current brain files
+    const mismatches = [];
+    for (const entry of manifest.files) {
+        const filePath = join(BRAIN_DIR, entry.relativePath);
+        try {
+            const content = await readFile(filePath);
+            const checksum = createHash("sha256").update(content).digest("hex");
+            if (checksum !== entry.checksum) {
+                mismatches.push(`${entry.relativePath}: checksum mismatch (file changed since backup)`);
+            }
+        }
+        catch {
+            mismatches.push(`${entry.relativePath}: file not found locally`);
+        }
+    }
+    if (mismatches.length === 0) {
+        return { ok: true, message: `Backup ${backupId} verified: all ${manifest.files.length} files match`, mismatches: [] };
+    }
+    return {
+        ok: false,
+        message: `Backup ${backupId}: ${mismatches.length} mismatches out of ${manifest.files.length} files`,
+        mismatches,
+    };
+}
+/**
+ * List available backups across all configured providers.
+ */
+export async function listBackups(provider) {
+    const providers = provider ? [provider] : getBackupConfig().providers;
+    const allManifests = [];
+    for (const p of providers) {
+        const adapter = getAdapter(p);
+        const available = await adapter.isAvailable();
+        if (!available)
+            continue;
+        const manifests = await adapter.listBackups();
+        allManifests.push(...manifests);
+    }
+    return allManifests.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function getAdapter(provider) {
+    switch (provider) {
+        case "local":
+            return new LocalStorageAdapter(getBackupConfig().localBackupDir);
+        case "gdrive":
+            return new GDriveBackupAdapter();
+        default:
+            throw new Error(`Unknown backup provider: ${provider}`);
+    }
+}
+async function scanBrainFiles(dir, base) {
+    const root = base ?? dir;
+    const entries = [];
+    const items = await readdir(dir, { withFileTypes: true });
+    for (const item of items) {
+        const fullPath = join(dir, item.name);
+        const relPath = relative(root, fullPath);
+        // Skip agent runtime files (ephemeral)
+        if (relPath.startsWith(join("agents", "runtime")))
+            continue;
+        if (relPath.startsWith(join("agents", "logs")))
+            continue;
+        if (item.isDirectory()) {
+            const subEntries = await scanBrainFiles(fullPath, root);
+            entries.push(...subEntries);
+        }
+        else if (item.isFile()) {
+            const fileStat = await stat(fullPath);
+            const content = await readFile(fullPath);
+            const checksum = createHash("sha256").update(content).digest("hex");
+            // Check if any line in the file is encrypted
+            let encrypted = false;
+            if (item.name.endsWith(".jsonl")) {
+                const text = content.toString("utf-8");
+                const firstDataLine = text.split("\n").find((l) => l.trim() && !l.includes('"_schema"'));
+                if (firstDataLine && isEncryptedLine(firstDataLine)) {
+                    encrypted = true;
+                }
+            }
+            entries.push({
+                relativePath: relPath,
+                checksum,
+                sizeBytes: fileStat.size,
+                encrypted,
+            });
+        }
+    }
+    return entries;
+}
+async function createTarGz(sourceDir, outputPath) {
+    await mkdir(join(outputPath, ".."), { recursive: true });
+    // Use tar command — available on Windows (Git Bash), macOS, Linux
+    const parentDir = join(sourceDir, "..");
+    const dirName = sourceDir.split(/[\\/]/).pop();
+    await execFileAsync("tar", ["-czf", outputPath, "-C", parentDir, dirName], {
+        timeout: 120_000,
+    });
+}
+async function extractTarGz(archivePath, targetDir) {
+    const parentDir = join(targetDir, "..");
+    await execFileAsync("tar", ["-xzf", archivePath, "-C", parentDir], {
+        timeout: 120_000,
+    });
+}
+async function pruneOldBackups(adapter, maxBackups) {
+    try {
+        const backups = await adapter.listBackups();
+        if (backups.length <= maxBackups)
+            return;
+        // Delete oldest backups
+        const toDelete = backups.slice(maxBackups);
+        for (const backup of toDelete) {
+            await adapter.deleteBackup(backup.id);
+            log.info("pruned old backup", { backupId: backup.id, provider: adapter.name });
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.warn("failed to prune old backups", { error: msg });
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/services/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/services/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAqB,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAEnC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAI1C,gFAAgF;AAEhF,IAAI,KAAK,GAA0C,IAAI,CAAC;AACxD,IAAI,UAAU,GAA0B,IAAI,CAAC;AAC7C,IAAI,eAAe,GAAkB,IAAI,CAAC;AAE1C,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,mBAAmB;AAE7D,gFAAgF;AAEhF,MAAM,UAAU,gBAAgB;IAC9B,IAAI,KAAK;QAAE,OAAO;IAClB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IAEjC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QACxD,OAAO;IACT,CAAC;IAED,KAAK,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,0BAA0B,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAChD,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAEtB,GAAG,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,QAAQ,eAAe,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,KAAK;QAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAEhF,IAAI,gBAAgB,GAAkB,IAAI,CAAC;AAE3C,KAAK,UAAU,0BAA0B;IACvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IAE5B,kCAAkC;IAClC,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC,UAAU;QAAE,OAAO;IAElD,2DAA2D;IAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/C,IAAI,eAAe,EAAE,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC5C,sBAAsB;QACtB,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;YAAE,OAAO;IACjC,CAAC;IAED,oBAAoB;IACpB,IAAI,gBAAgB,KAAK,OAAO;QAAE,OAAO;IACzC,gBAAgB,GAAG,OAAO,CAAC;IAE3B,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACxF,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IAEjC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,WAAW,CAAC;YACV,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,+BAA+B,MAAM,CAAC,OAAO,EAAE;SACzD,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,WAAW,CAAC;YACV,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,4BAA4B,MAAM,CAAC,OAAO,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,iBAAoC;IAEpC,MAAM,SAAS,GAAG,iBAAiB,IAAI,eAAe,EAAE,CAAC,SAAS,CAAC;IACnE,MAAM,QAAQ,GAAG,UAAU,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1E,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,6CAA6C;QAC7C,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAmB;YAC/B,EAAE,EAAE,QAAQ;YACZ,SAAS;YACT,KAAK;YACL,UAAU;YACV,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;SAC9B,CAAC;QAEF,2BAA2B;QAC3B,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,GAAG,QAAQ,SAAS,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,gBAAgB,CAAC,CAAC;QAEjE,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAE1E,MAAM,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAE1C,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,OAAO,GAAyD,EAAE,CAAC;QAEzE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;gBAC9F,SAAS;YACX,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;YAE7F,oBAAoB;YACpB,IAAI,YAAY,CAAC,EAAE,IAAI,eAAe,EAAE,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;gBACxD,MAAM,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,UAAU,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAErE,mBAAmB;QACnB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3F,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,GAAG,QAAQ,CAAC;YACtB,eAAe,GAAG,IAAI,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAClD,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxC,eAAe,GAAG,OAAO,CAAC;QAC1B,IAAI,KAAK;YAAE,UAAU,GAAG,QAAQ,CAAC;QAEjC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACjD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACjF,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC;QAC9B,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAwB,EACxB,QAAgB;IAEhB,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,gBAAgB,EAAE,CAAC;IAE3E,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,GAAG,QAAQ,SAAS,CAAC;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAE9C,mBAAmB;QACnB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAElE,oBAAoB;QACpB,MAAM,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAEzC,gBAAgB;QAChB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAErE,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,WAAW,CAAC;YACV,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,8BAA8B,QAAQ,KAAK,QAAQ,+CAA+C;SAC5G,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,QAAQ,8CAA8C,EAAE,CAAC;IACxG,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAwB,EACxB,QAAgB;IAEhB,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAExD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,QAAQ,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAChF,CAAC;IAED,+CAA+C;IAC/C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAChC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,YAAY,iDAAiD,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,YAAY,0BAA0B,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,QAAQ,kBAAkB,QAAQ,CAAC,KAAK,CAAC,MAAM,cAAc,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACxH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,UAAU,QAAQ,KAAK,UAAU,CAAC,MAAM,sBAAsB,QAAQ,CAAC,KAAK,CAAC,MAAM,QAAQ;QACpG,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAyB;IAEzB,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,SAAS,CAAC;IACtE,MAAM,YAAY,GAAqB,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;QAC9C,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,gFAAgF;AAEhF,SAAS,UAAU,CAAC,QAAwB;IAC1C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,IAAI,mBAAmB,CAAC,eAAe,EAAE,CAAC,cAAc,CAAC,CAAC;QACnE,KAAK,QAAQ;YACX,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC;YACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,IAAa;IACtD,MAAM,IAAI,GAAG,IAAI,IAAI,GAAG,CAAC;IACzB,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEzC,uCAAuC;QACvC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAAE,SAAS;QAC5D,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAAE,SAAS;QAEzD,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEpE,6CAA6C;YAC7C,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACvC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;gBACzF,IAAI,aAAa,IAAI,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC;oBACpD,SAAS,GAAG,IAAI,CAAC;gBACnB,CAAC;YACH,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,YAAY,EAAE,OAAO;gBACrB,QAAQ;gBACR,SAAS,EAAE,QAAQ,CAAC,IAAI;gBACxB,SAAS;aACV,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,SAAiB,EAAE,UAAkB;IAC9D,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,kEAAkE;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAG,CAAC;IAChD,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;QACzE,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,SAAiB;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE;QACjE,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAuB,EAAE,UAAkB;IACxE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;YAAE,OAAO;QAEzC,wBAAwB;QACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3C,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/services/credit-monitor.d.ts

@@ -0,0 +1,40 @@
+/**
+ * OpenRouter credit monitoring timer service.
+ *
+ * Periodically checks credit usage via the openrouterCreditsCheck health
+ * check, registers it with the AlertManager pipeline for threshold-based
+ * alerting, and exposes status + manual trigger for the API.
+ *
+ * Follows the module-level timer pattern (goals/timer.ts, backlogReview.ts).
+ */
+import type { HealthChecker } from "../health/checker.js";
+import type { AlertManager } from "../health/alerting.js";
+export interface CreditStatus {
+    limit: number | null;
+    remaining: number | null;
+    usage: number;
+    usageDaily: number;
+    percentUsed: number | null;
+    isFreeTier: boolean;
+    checkedAt: string;
+}
+/**
+ * Start the credit monitoring timer. Idempotent.
+ *
+ * 1. Registers `openrouterCreditsCheck` with HealthChecker as non-critical.
+ * 2. Starts an interval timer that runs the check and caches CreditStatus.
+ * 3. Fires an immediate first check (credits can be urgent).
+ */
+export declare function startCreditMonitor(health: HealthChecker, alertManager: AlertManager, intervalMs?: number): void;
+/** Stop the credit monitoring timer. */
+export declare function stopCreditMonitor(): void;
+/** Check if the credit monitor is running. */
+export declare function isCreditMonitorRunning(): boolean;
+/** Get the last cached credit status (null if never checked). */
+export declare function getCreditStatus(): CreditStatus | null;
+/**
+ * Trigger an immediate credit check. Returns the fresh status.
+ * Works even if the timer isn't running (uses the registered health check).
+ */
+export declare function triggerCreditCheck(): Promise<CreditStatus | null>;
+//# sourceMappingURL=credit-monitor.d.ts.map

package/dist/services/credit-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-monitor.d.ts","sourceRoot":"","sources":["../../src/services/credit-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAS1D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,YAAY,EAC1B,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CA+BN;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,IAAI,IAAI,CAOxC;AAED,8CAA8C;AAC9C,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,iEAAiE;AACjE,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgBvE"}

package/dist/services/credit-monitor.js

@@ -0,0 +1,147 @@
+/**
+ * OpenRouter credit monitoring timer service.
+ *
+ * Periodically checks credit usage via the openrouterCreditsCheck health
+ * check, registers it with the AlertManager pipeline for threshold-based
+ * alerting, and exposes status + manual trigger for the API.
+ *
+ * Follows the module-level timer pattern (goals/timer.ts, backlogReview.ts).
+ */
+import { openrouterCreditsCheck } from "../health/checks/openrouter.js";
+import { createLogger } from "../utils/logger.js";
+import { resolveEnv } from "../instance.js";
+const log = createLogger("credit-monitor");
+const DEFAULT_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+let timer = null;
+let lastStatus = null;
+let healthRef = null;
+/**
+ * Start the credit monitoring timer. Idempotent.
+ *
+ * 1. Registers `openrouterCreditsCheck` with HealthChecker as non-critical.
+ * 2. Starts an interval timer that runs the check and caches CreditStatus.
+ * 3. Fires an immediate first check (credits can be urgent).
+ */
+export function startCreditMonitor(health, alertManager, intervalMs) {
+    if (timer)
+        return;
+    healthRef = health;
+    // Register the health check (non-critical — instance can still work with cached context)
+    health.register("openrouter_credits", openrouterCreditsCheck(), { critical: false });
+    const interval = intervalMs
+        ?? (parseInt(resolveEnv("CREDIT_CHECK_INTERVAL_MS") ?? "", 10) || DEFAULT_INTERVAL_MS);
+    const runCheck = async () => {
+        try {
+            const result = await health.check("openrouter_credits");
+            const checkResult = result.checks["openrouter_credits"];
+            if (checkResult?.detail) {
+                lastStatus = parseDetailToStatus(checkResult.detail);
+            }
+        }
+        catch (err) {
+            log.error("credit check failed", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    };
+    // Fire immediately, then on interval
+    runCheck();
+    timer = setInterval(runCheck, interval);
+    const mins = Math.round(interval / 60_000);
+    log.info(`Credit monitor: every ${mins} min`);
+}
+/** Stop the credit monitoring timer. */
+export function stopCreditMonitor() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    healthRef = null;
+    log.info("Credit monitor stopped");
+}
+/** Check if the credit monitor is running. */
+export function isCreditMonitorRunning() {
+    return timer !== null;
+}
+/** Get the last cached credit status (null if never checked). */
+export function getCreditStatus() {
+    return lastStatus;
+}
+/**
+ * Trigger an immediate credit check. Returns the fresh status.
+ * Works even if the timer isn't running (uses the registered health check).
+ */
+export async function triggerCreditCheck() {
+    if (!healthRef)
+        return lastStatus;
+    try {
+        const result = await healthRef.check("openrouter_credits");
+        const checkResult = result.checks["openrouter_credits"];
+        if (checkResult?.detail) {
+            lastStatus = parseDetailToStatus(checkResult.detail);
+        }
+        return lastStatus;
+    }
+    catch (err) {
+        log.error("manual credit check failed", {
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return lastStatus;
+    }
+}
+// ─── Internal helpers ───────────────────────────────────────────────────────
+/**
+ * Parse the health check detail string into a structured CreditStatus.
+ *
+ * Formats handled:
+ *   "credits 85% used, $2.30 remaining of $15.00 limit"
+ *   "credits unlimited (no limit set), $4.20 used"
+ *   "credits unknown — OPENROUTER_API_KEY not set"
+ *   "cannot verify credits — ..."
+ */
+function parseDetailToStatus(detail) {
+    const now = new Date().toISOString();
+    // Unlimited case
+    if (detail.includes("unlimited")) {
+        const usageMatch = detail.match(/\$(\d+\.?\d*)\s+used/);
+        return {
+            limit: null,
+            remaining: null,
+            usage: usageMatch ? parseFloat(usageMatch[1]) : 0,
+            usageDaily: 0,
+            percentUsed: null,
+            isFreeTier: false,
+            checkedAt: now,
+        };
+    }
+    // Normal case with percentage
+    const pctMatch = detail.match(/credits\s+(\d+)%\s+used/);
+    const remainingMatch = detail.match(/\$(\d+\.?\d*)\s+remaining/);
+    const limitMatch = detail.match(/of\s+\$(\d+\.?\d*)\s+limit/);
+    if (pctMatch) {
+        const limit = limitMatch ? parseFloat(limitMatch[1]) : null;
+        const remaining = remainingMatch ? parseFloat(remainingMatch[1]) : null;
+        const percentUsed = parseInt(pctMatch[1], 10);
+        const usage = limit !== null && remaining !== null ? limit - remaining : 0;
+        return {
+            limit,
+            remaining,
+            usage,
+            usageDaily: 0,
+            percentUsed,
+            isFreeTier: false,
+            checkedAt: now,
+        };
+    }
+    // Error/unknown case
+    return {
+        limit: null,
+        remaining: null,
+        usage: 0,
+        usageDaily: 0,
+        percentUsed: null,
+        isFreeTier: false,
+        checkedAt: now,
+    };
+}
+//# sourceMappingURL=credit-monitor.js.map

package/dist/services/credit-monitor.js.map

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