@sequence0/blockclaw 2.0.0

package/dist/core/heartbeat.js

@@ -0,0 +1,426 @@
+import os from "node:os";
+import fs from "node:fs";
+import dns from "node:dns/promises";
+import { readBlockclawConfig, readAgentConfig } from "../agent/config.js";
+import { logger } from "../utils/logger.js";
+import { EVENTS_LOG, ensureBlockclawDir } from "../utils/paths.js";
+import { getDiskUsage } from "../utils/platform.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_INTERVAL_MS = 30_000; // 30 seconds
+const CONSECUTIVE_FAILURES_THRESHOLD = 3;
+const DISK_USAGE_WARNING_PERCENT = 95;
+const MEMORY_USAGE_WARNING_PERCENT = 90;
+const RPC_STALE_THRESHOLD = 3; // consecutive checks with same block number
+const DEFAULT_RPC_URLS = {
+    testnet: "https://testnet-rpc.sequence0.network",
+    mainnet: "https://rpc.sequence0.network",
+};
+// ---------------------------------------------------------------------------
+// Heartbeat
+// ---------------------------------------------------------------------------
+export class Heartbeat {
+    client;
+    intervalMs;
+    onEvent;
+    timer = null;
+    consecutiveFailures = 0;
+    /** RPC health tracking */
+    lastBlockNumber = null;
+    staleBlockCount = 0;
+    /** Cached RPC URL resolved from config */
+    rpcUrl = null;
+    /** Optional healer — set externally to enable self-healing */
+    healer = null;
+    constructor(client, options) {
+        this.client = client;
+        this.intervalMs = options?.intervalMs ?? DEFAULT_INTERVAL_MS;
+        this.onEvent = options?.onEvent;
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    /** Start the periodic heartbeat loop. */
+    start() {
+        if (this.timer)
+            return; // already running
+        logger.debug(`Heartbeat starting (interval=${this.intervalMs}ms)`);
+        // Run immediately, then on interval
+        void this.runOnce();
+        this.timer = setInterval(() => void this.runOnce(), this.intervalMs);
+    }
+    /** Stop the heartbeat loop. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+            logger.debug("Heartbeat stopped");
+        }
+    }
+    /** Whether the heartbeat loop is currently running. */
+    isRunning() {
+        return this.timer !== null;
+    }
+    // -------------------------------------------------------------------------
+    // Single check cycle
+    // -------------------------------------------------------------------------
+    /** Run a single heartbeat check cycle. Useful for testing. */
+    async runOnce() {
+        const events = [];
+        // 1. Internet connectivity check (must run FIRST)
+        const internetOk = await this._checkInternet(events);
+        // 2. RPC health check (only if internet is up)
+        if (internetOk) {
+            await this._checkRpc(events);
+        }
+        // 3. Agent health check (skip if internet is down — don't misreport agent_down)
+        if (internetOk) {
+            await this._checkHealth(events);
+        }
+        else {
+            logger.debug("Skipping agent health check — internet is unreachable");
+        }
+        // 4. Status check (only if agent is reachable)
+        if (this.consecutiveFailures === 0 && internetOk) {
+            await this._checkStatus(events);
+            await this._checkCommittees(events);
+        }
+        // 5. System resources
+        this._checkMemory(events);
+        await this._checkDisk(events);
+        // Persist & dispatch events
+        for (const event of events) {
+            this._persistEvent(event);
+            this.onEvent?.(event);
+            if (this.healer) {
+                try {
+                    await this.healer.handleEvent(event);
+                }
+                catch (err) {
+                    logger.error(`Healer error: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        return events;
+    }
+    // -------------------------------------------------------------------------
+    // Individual checks
+    // -------------------------------------------------------------------------
+    /** Resolve the RPC URL from config, caching the result. */
+    _getRpcUrl() {
+        if (this.rpcUrl)
+            return this.rpcUrl;
+        const agentCfg = readAgentConfig();
+        if (agentCfg?.rpc_url) {
+            this.rpcUrl = agentCfg.rpc_url;
+            return this.rpcUrl;
+        }
+        const bcCfg = readBlockclawConfig();
+        const network = bcCfg.network ?? "mainnet";
+        this.rpcUrl = DEFAULT_RPC_URLS[network] ?? DEFAULT_RPC_URLS["mainnet"];
+        return this.rpcUrl;
+    }
+    /**
+     * Check internet connectivity. Tries RPC eth_blockNumber first, falls back
+     * to DNS resolution for sequence0.network. Returns true if internet is up.
+     */
+    async _checkInternet(events) {
+        const rpcUrl = this._getRpcUrl();
+        // Primary check: try to reach the RPC endpoint
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5_000);
+            const res = await fetch(rpcUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ jsonrpc: "2.0", method: "net_version", params: [], id: 1 }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (res.ok)
+                return true;
+        }
+        catch {
+            // RPC unreachable — try DNS as secondary check
+        }
+        // Secondary check: DNS resolution
+        try {
+            await dns.resolve4("sequence0.network");
+            return true;
+        }
+        catch {
+            // Both checks failed — internet is down
+        }
+        events.push({
+            timestamp: Date.now(),
+            type: "network_unreachable",
+            message: "Internet connectivity lost — both RPC and DNS resolution failed",
+            data: { rpcUrl },
+        });
+        return false;
+    }
+    /**
+     * Check RPC health by calling eth_blockNumber. Tracks block progression
+     * and emits rpc_unreachable or rpc_stale events.
+     */
+    async _checkRpc(events) {
+        const rpcUrl = this._getRpcUrl();
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 10_000);
+            const res = await fetch(rpcUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ jsonrpc: "2.0", method: "eth_blockNumber", params: [], id: 1 }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (!res.ok) {
+                events.push({
+                    timestamp: Date.now(),
+                    type: "rpc_unreachable",
+                    message: `RPC returned HTTP ${res.status}`,
+                    data: { rpcUrl, httpStatus: res.status },
+                });
+                return;
+            }
+            const json = (await res.json());
+            if (!json.result) {
+                events.push({
+                    timestamp: Date.now(),
+                    type: "rpc_unreachable",
+                    message: "RPC returned invalid response (no result field)",
+                    data: { rpcUrl, response: json },
+                });
+                return;
+            }
+            const blockNumber = BigInt(json.result);
+            if (this.lastBlockNumber !== null && blockNumber === this.lastBlockNumber) {
+                this.staleBlockCount++;
+                if (this.staleBlockCount >= RPC_STALE_THRESHOLD) {
+                    events.push({
+                        timestamp: Date.now(),
+                        type: "rpc_stale",
+                        message: `Chain not producing blocks — block ${blockNumber.toString()} unchanged for ${this.staleBlockCount} consecutive checks`,
+                        data: {
+                            rpcUrl,
+                            blockNumber: blockNumber.toString(),
+                            staleChecks: this.staleBlockCount,
+                        },
+                    });
+                }
+            }
+            else {
+                this.staleBlockCount = 0;
+            }
+            this.lastBlockNumber = blockNumber;
+        }
+        catch (err) {
+            events.push({
+                timestamp: Date.now(),
+                type: "rpc_unreachable",
+                message: `RPC unreachable: ${err instanceof Error ? err.message : String(err)}`,
+                data: {
+                    rpcUrl,
+                    error: err instanceof Error ? err.message : String(err),
+                },
+            });
+        }
+    }
+    /** GET /health — track latency and consecutive failures. */
+    async _checkHealth(events) {
+        const start = Date.now();
+        try {
+            const health = await this.client.health();
+            const latencyMs = Date.now() - start;
+            this.consecutiveFailures = 0;
+            events.push({
+                timestamp: Date.now(),
+                type: "health_ok",
+                message: `Agent healthy (${latencyMs}ms, ${health.connected_peers} peers, uptime ${health.uptime_seconds}s)`,
+                data: {
+                    latencyMs,
+                    peerId: health.peer_id,
+                    connectedPeers: health.connected_peers,
+                    uptimeSeconds: health.uptime_seconds,
+                    version: health.version ?? null,
+                },
+            });
+            // Check for available update
+            if (health.update_available) {
+                events.push({
+                    timestamp: Date.now(),
+                    type: "update_available",
+                    message: `Agent update available: ${health.update_available}`,
+                    data: { version: health.update_available },
+                });
+            }
+        }
+        catch (err) {
+            this.consecutiveFailures++;
+            const message = this.consecutiveFailures >= CONSECUTIVE_FAILURES_THRESHOLD
+                ? `Agent unreachable (${this.consecutiveFailures} consecutive failures)`
+                : `Health check failed (attempt ${this.consecutiveFailures}/${CONSECUTIVE_FAILURES_THRESHOLD})`;
+            if (this.consecutiveFailures >= CONSECUTIVE_FAILURES_THRESHOLD) {
+                events.push({
+                    timestamp: Date.now(),
+                    type: "agent_down",
+                    message,
+                    data: {
+                        consecutiveFailures: this.consecutiveFailures,
+                        error: err instanceof Error ? err.message : String(err),
+                    },
+                });
+            }
+            else {
+                logger.warn(message);
+            }
+        }
+    }
+    /** GET /status — check peers, sessions, wallets. */
+    async _checkStatus(events) {
+        try {
+            const status = await this.client.status();
+            // Detect zero peers
+            if (status.connected_peers === 0) {
+                events.push({
+                    timestamp: Date.now(),
+                    type: "peers_lost",
+                    message: "Agent has 0 connected peers",
+                    data: {
+                        peerId: status.peer_id,
+                        wallets: status.wallets.length,
+                        activeDkgSessions: status.active_dkg_sessions,
+                        activeSigningSessions: status.active_signing_sessions,
+                    },
+                });
+            }
+            // Check for update in status response too
+            if (status.update_available) {
+                // Only emit if not already emitted from health check
+                events.push({
+                    timestamp: Date.now(),
+                    type: "update_available",
+                    message: `Agent update available: ${status.update_available}`,
+                    data: { version: status.update_available },
+                });
+            }
+        }
+        catch (err) {
+            logger.debug(`Status check failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** GET /health/committees — detect degraded/critical committees. */
+    async _checkCommittees(events) {
+        try {
+            const committees = await this.client.committeeHealth();
+            for (const committee of committees) {
+                const status = committee.status.toLowerCase();
+                if (status === "degraded" || status === "atrisk" || status === "at_risk") {
+                    events.push({
+                        timestamp: Date.now(),
+                        type: "health_degraded",
+                        message: `Committee ${committee.wallet_id} is ${committee.status} (${committee.alive}/${committee.total} alive, threshold=${committee.threshold})`,
+                        data: {
+                            walletId: committee.wallet_id,
+                            status: committee.status,
+                            alive: committee.alive,
+                            total: committee.total,
+                            threshold: committee.threshold,
+                            deadPeers: committee.dead_peers ?? [],
+                        },
+                    });
+                }
+                else if (status === "critical" || status === "dead") {
+                    events.push({
+                        timestamp: Date.now(),
+                        type: "health_critical",
+                        message: `Committee ${committee.wallet_id} is ${committee.status} (${committee.alive}/${committee.total} alive, threshold=${committee.threshold})`,
+                        data: {
+                            walletId: committee.wallet_id,
+                            status: committee.status,
+                            alive: committee.alive,
+                            total: committee.total,
+                            threshold: committee.threshold,
+                            deadPeers: committee.dead_peers ?? [],
+                        },
+                    });
+                }
+            }
+        }
+        catch (err) {
+            logger.debug(`Committee health check failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** Check system memory usage via os module. */
+    _checkMemory(events) {
+        const totalMem = os.totalmem();
+        const freeMem = os.freemem();
+        const usedPercent = ((totalMem - freeMem) / totalMem) * 100;
+        if (usedPercent >= MEMORY_USAGE_WARNING_PERCENT) {
+            events.push({
+                timestamp: Date.now(),
+                type: "memory_warning",
+                message: `System memory usage at ${usedPercent.toFixed(1)}% (${(freeMem / 1073741824).toFixed(1)} GB free of ${(totalMem / 1073741824).toFixed(1)} GB)`,
+                data: {
+                    totalBytes: totalMem,
+                    freeBytes: freeMem,
+                    usedPercent: Math.round(usedPercent * 10) / 10,
+                },
+            });
+        }
+    }
+    /** Check disk usage via platform utility. */
+    async _checkDisk(events) {
+        try {
+            const disk = await getDiskUsage(os.homedir());
+            if (disk.usedPercent >= DISK_USAGE_WARNING_PERCENT) {
+                events.push({
+                    timestamp: Date.now(),
+                    type: "disk_warning",
+                    message: `Disk usage at ${disk.usedPercent.toFixed(1)}% (${(disk.free / 1073741824).toFixed(1)} GB free)`,
+                    data: {
+                        totalBytes: disk.total,
+                        freeBytes: disk.free,
+                        usedBytes: disk.used,
+                        usedPercent: Math.round(disk.usedPercent * 10) / 10,
+                    },
+                });
+            }
+        }
+        catch (err) {
+            logger.debug(`Disk check failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Persistence
+    // -------------------------------------------------------------------------
+    /** Maximum events.log size in bytes before rotation (10 MB). */
+    static MAX_LOG_BYTES = 10 * 1024 * 1024;
+    /** Rotate events.log if it exceeds the size limit. */
+    _rotateLogIfNeeded() {
+        try {
+            const stat = fs.statSync(EVENTS_LOG);
+            if (stat.size >= Heartbeat.MAX_LOG_BYTES) {
+                fs.renameSync(EVENTS_LOG, EVENTS_LOG + ".1");
+            }
+        }
+        catch {
+            // File may not exist yet — nothing to rotate.
+        }
+    }
+    /** Append a heartbeat event as a JSON line to the events log file. */
+    _persistEvent(event) {
+        try {
+            ensureBlockclawDir();
+            this._rotateLogIfNeeded();
+            fs.appendFileSync(EVENTS_LOG, JSON.stringify(event) + "\n", "utf8");
+        }
+        catch (err) {
+            logger.debug(`Failed to persist event: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+export default Heartbeat;
+//# sourceMappingURL=heartbeat.js.map

package/dist/core/heartbeat.js.map

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

package/dist/core/memory.d.ts

@@ -0,0 +1,57 @@
+/** A recorded issue or pattern */
+export interface MemoryEntry {
+    id: string;
+    type: "issue" | "pattern" | "learning" | "metric";
+    timestamp: number;
+    summary: string;
+    details?: Record<string, unknown>;
+    /** Number of times this pattern has been seen */
+    occurrences: number;
+    lastSeen: number;
+    resolved?: boolean;
+}
+interface MemoryStore {
+    entries: MemoryEntry[];
+    stats: {
+        totalRestarts: number;
+        totalHealActions: number;
+        lastStartup: number;
+        uptimeRecords: number[];
+    };
+}
+/** Persistent memory for tracking issues, patterns, and learnings */
+export declare class Memory {
+    private store;
+    constructor();
+    /** Record an issue */
+    recordIssue(summary: string, details?: Record<string, unknown>): void;
+    /** Record a pattern observation */
+    recordPattern(summary: string, details?: Record<string, unknown>): void;
+    /** Record a learning */
+    recordLearning(summary: string, details?: Record<string, unknown>): void;
+    /** Mark an issue as resolved */
+    resolveIssue(id: string): void;
+    /** Get recent issues */
+    getIssues(limit?: number): MemoryEntry[];
+    /** Get all patterns */
+    getPatterns(): MemoryEntry[];
+    /** Get learnings */
+    getLearnings(): MemoryEntry[];
+    /** Increment restart counter */
+    recordRestart(): void;
+    /** Increment heal action counter */
+    recordHealAction(): void;
+    /** Record startup */
+    recordStartup(): void;
+    /** Get stats */
+    getStats(): MemoryStore["stats"];
+    /** Get total entry count */
+    get size(): number;
+    /** Clean old resolved issues (older than 7 days) */
+    cleanup(): number;
+    private load;
+    private save;
+    private generateId;
+}
+export {};
+//# sourceMappingURL=memory.d.ts.map

package/dist/core/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/core/memory.ts"],"names":[],"mappings":"AAGA,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;CACH;AAED,qEAAqE;AACrE,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAc;;IAM3B,sBAAsB;IACtB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAwBrE,mCAAmC;IACnC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuBvE,wBAAwB;IACxB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAaxE,gCAAgC;IAChC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ9B,wBAAwB;IACxB,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,WAAW,EAAE;IAO5C,uBAAuB;IACvB,WAAW,IAAI,WAAW,EAAE;IAM5B,oBAAoB;IACpB,YAAY,IAAI,WAAW,EAAE;IAM7B,gCAAgC;IAChC,aAAa,IAAI,IAAI;IAKrB,oCAAoC;IACpC,gBAAgB,IAAI,IAAI;IAKxB,qBAAqB;IACrB,aAAa,IAAI,IAAI;IAKrB,gBAAgB;IAChB,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC;IAIhC,4BAA4B;IAC5B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oDAAoD;IACpD,OAAO,IAAI,MAAM;IAWjB,OAAO,CAAC,IAAI;IAiBZ,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,UAAU;CAGnB"}

package/dist/core/memory.js

@@ -0,0 +1,149 @@
+import fs from "node:fs";
+import { MEMORY_FILE, ensureBlockclawDir } from "../utils/paths.js";
+/** Persistent memory for tracking issues, patterns, and learnings */
+export class Memory {
+    store;
+    constructor() {
+        this.store = this.load();
+    }
+    /** Record an issue */
+    recordIssue(summary, details) {
+        const existing = this.store.entries.find((e) => e.type === "issue" && e.summary === summary && !e.resolved);
+        if (existing) {
+            existing.occurrences++;
+            existing.lastSeen = Date.now();
+            if (details)
+                existing.details = { ...existing.details, ...details };
+        }
+        else {
+            this.store.entries.push({
+                id: this.generateId(),
+                type: "issue",
+                timestamp: Date.now(),
+                summary,
+                details,
+                occurrences: 1,
+                lastSeen: Date.now(),
+            });
+        }
+        this.save();
+    }
+    /** Record a pattern observation */
+    recordPattern(summary, details) {
+        const existing = this.store.entries.find((e) => e.type === "pattern" && e.summary === summary);
+        if (existing) {
+            existing.occurrences++;
+            existing.lastSeen = Date.now();
+        }
+        else {
+            this.store.entries.push({
+                id: this.generateId(),
+                type: "pattern",
+                timestamp: Date.now(),
+                summary,
+                details,
+                occurrences: 1,
+                lastSeen: Date.now(),
+            });
+        }
+        this.save();
+    }
+    /** Record a learning */
+    recordLearning(summary, details) {
+        this.store.entries.push({
+            id: this.generateId(),
+            type: "learning",
+            timestamp: Date.now(),
+            summary,
+            details,
+            occurrences: 1,
+            lastSeen: Date.now(),
+        });
+        this.save();
+    }
+    /** Mark an issue as resolved */
+    resolveIssue(id) {
+        const entry = this.store.entries.find((e) => e.id === id);
+        if (entry) {
+            entry.resolved = true;
+            this.save();
+        }
+    }
+    /** Get recent issues */
+    getIssues(limit = 20) {
+        return this.store.entries
+            .filter((e) => e.type === "issue" && !e.resolved)
+            .sort((a, b) => b.lastSeen - a.lastSeen)
+            .slice(0, limit);
+    }
+    /** Get all patterns */
+    getPatterns() {
+        return this.store.entries
+            .filter((e) => e.type === "pattern")
+            .sort((a, b) => b.occurrences - a.occurrences);
+    }
+    /** Get learnings */
+    getLearnings() {
+        return this.store.entries
+            .filter((e) => e.type === "learning")
+            .sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /** Increment restart counter */
+    recordRestart() {
+        this.store.stats.totalRestarts++;
+        this.save();
+    }
+    /** Increment heal action counter */
+    recordHealAction() {
+        this.store.stats.totalHealActions++;
+        this.save();
+    }
+    /** Record startup */
+    recordStartup() {
+        this.store.stats.lastStartup = Date.now();
+        this.save();
+    }
+    /** Get stats */
+    getStats() {
+        return { ...this.store.stats };
+    }
+    /** Get total entry count */
+    get size() {
+        return this.store.entries.length;
+    }
+    /** Clean old resolved issues (older than 7 days) */
+    cleanup() {
+        const cutoff = Date.now() - 7 * 24 * 60 * 60 * 1000;
+        const before = this.store.entries.length;
+        this.store.entries = this.store.entries.filter((e) => !(e.resolved && e.lastSeen < cutoff));
+        const removed = before - this.store.entries.length;
+        if (removed > 0)
+            this.save();
+        return removed;
+    }
+    load() {
+        try {
+            const content = fs.readFileSync(MEMORY_FILE, "utf8");
+            return JSON.parse(content);
+        }
+        catch {
+            return {
+                entries: [],
+                stats: {
+                    totalRestarts: 0,
+                    totalHealActions: 0,
+                    lastStartup: 0,
+                    uptimeRecords: [],
+                },
+            };
+        }
+    }
+    save() {
+        ensureBlockclawDir();
+        fs.writeFileSync(MEMORY_FILE, JSON.stringify(this.store, null, 2), "utf8");
+    }
+    generateId() {
+        return `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/core/memory.js.map

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