@runcore-sh/runcore 0.3.1 → 0.4.0

package/dist/volumes/manager.js

@@ -0,0 +1,462 @@
+/**
+ * VolumeManager — event-driven multi-volume brain storage.
+ *
+ * No timers. No polling. Five triggers:
+ *   on-write    → queue replication to other volumes
+ *   on-connect  → drain pending replications
+ *   on-pressure → migrate cold files to lower tier
+ *   on-access   → promote file to sphere
+ *   on-disconnect → ensure sphere has essentials
+ *
+ * The append-only JSONL log is the replication queue.
+ * Any volume that's behind just reads the appends it missed.
+ */
+import { readFile, writeFile, copyFile, mkdir, stat } from "node:fs/promises";
+import { statfs } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { createLogger } from "../utils/logger.js";
+import { logActivity } from "../activity/log.js";
+const log = createLogger("volumes");
+/** Default pressure threshold: 80% of volume capacity. */
+const DEFAULT_PRESSURE_PCT = 0.8;
+/** Max cold files to migrate per pressure event. */
+const MIGRATE_BATCH_SIZE = 10;
+/** Concurrency for replication drain. */
+const REPLICATION_CONCURRENCY = 3;
+export class VolumeManager {
+    primaryBrainDir;
+    volumes = [];
+    states = new Map();
+    replicationQueue = [];
+    configPath;
+    queuePath;
+    draining = false;
+    constructor(primaryBrainDir) {
+        this.primaryBrainDir = primaryBrainDir;
+        this.configPath = join(primaryBrainDir, "volumes.yaml");
+        this.queuePath = join(primaryBrainDir, "volumes", "replication-queue.jsonl");
+    }
+    // ── Init ────────────────────────────────────────────────────────────────────
+    async init() {
+        await this.loadConfig();
+        await this.loadQueue();
+        await this.probeAll();
+        log.info("Volume manager initialized", {
+            volumes: this.volumes.length,
+            online: [...this.states.values()].filter((s) => s.online).length,
+            pendingReplications: this.replicationQueue.filter((r) => r.status === "pending").length,
+        });
+    }
+    // ── Config ──────────────────────────────────────────────────────────────────
+    async loadConfig() {
+        try {
+            const raw = await readFile(this.configPath, "utf-8");
+            this.volumes = this.parseVolumesYaml(raw);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                // No volumes.yaml — single-volume mode (primary only)
+                this.volumes = [
+                    { name: "primary", path: this.primaryBrainDir, tier: "sphere" },
+                ];
+                log.debug("No volumes.yaml — single-volume mode");
+            }
+            else {
+                log.warn("Failed to parse volumes.yaml", { error: err.message });
+                this.volumes = [
+                    { name: "primary", path: this.primaryBrainDir, tier: "sphere" },
+                ];
+            }
+        }
+        // Ensure primary is always present
+        if (!this.volumes.find((v) => v.path === this.primaryBrainDir)) {
+            this.volumes.unshift({ name: "primary", path: this.primaryBrainDir, tier: "sphere" });
+        }
+    }
+    parseVolumesYaml(raw) {
+        const configs = [];
+        const entries = raw.split(/^(?=\s*- )/m).filter((s) => s.trim());
+        for (const entry of entries) {
+            const lines = entry.split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
+            let name;
+            let path;
+            let tier;
+            let pressureThresholdBytes;
+            for (const line of lines) {
+                const cleaned = line.replace(/^-\s*/, "");
+                const kv = cleaned.match(/^(\w+)\s*:\s*(.+)$/);
+                if (!kv)
+                    continue;
+                const [, key, val] = kv;
+                const unquoted = val.replace(/^["']|["']$/g, "").trim();
+                if (key === "name")
+                    name = unquoted;
+                else if (key === "path")
+                    path = unquoted;
+                else if (key === "tier" && ["sphere", "warm", "archive"].includes(unquoted)) {
+                    tier = unquoted;
+                }
+                else if (key === "pressureThresholdBytes")
+                    pressureThresholdBytes = parseInt(unquoted, 10);
+            }
+            if (name && path && tier) {
+                configs.push({ name, path, tier, pressureThresholdBytes });
+            }
+        }
+        return configs;
+    }
+    // ── Volume probing ──────────────────────────────────────────────────────────
+    /** Check which volumes are online and get disk stats. */
+    async probeAll() {
+        const results = await Promise.allSettled(this.volumes.map((v) => this.probeVolume(v)));
+        const states = [];
+        for (let i = 0; i < results.length; i++) {
+            const vol = this.volumes[i];
+            if (results[i].status === "fulfilled") {
+                const s = results[i].value;
+                this.states.set(vol.name, s);
+                states.push(s);
+            }
+            else {
+                const offlineState = {
+                    name: vol.name,
+                    tier: vol.tier,
+                    path: vol.path,
+                    online: false,
+                    totalBytes: 0,
+                    usedBytes: 0,
+                    freeBytes: 0,
+                    pressure: false,
+                    lastSeen: this.states.get(vol.name)?.lastSeen ?? "never",
+                };
+                this.states.set(vol.name, offlineState);
+                states.push(offlineState);
+            }
+        }
+        return states;
+    }
+    async probeVolume(config) {
+        // Check if path is accessible
+        await stat(config.path);
+        let totalBytes = 0;
+        let freeBytes = 0;
+        try {
+            const fs = await statfs(config.path);
+            totalBytes = Number(fs.blocks) * Number(fs.bsize);
+            freeBytes = Number(fs.bfree) * Number(fs.bsize);
+        }
+        catch {
+            // statfs may not work on all platforms
+        }
+        const usedBytes = totalBytes - freeBytes;
+        const threshold = config.pressureThresholdBytes ?? totalBytes * DEFAULT_PRESSURE_PCT;
+        const pressure = totalBytes > 0 && usedBytes >= threshold;
+        return {
+            name: config.name,
+            tier: config.tier,
+            path: config.path,
+            online: true,
+            totalBytes,
+            usedBytes,
+            freeBytes,
+            pressure,
+            lastSeen: new Date().toISOString(),
+        };
+    }
+    // ── Event handlers (the five triggers) ──────────────────────────────────────
+    /** Process a volume event. This is the only entry point for volume operations. */
+    async handleEvent(event) {
+        switch (event.type) {
+            case "write":
+                await this.onWrite(event.fileId, event.volume);
+                break;
+            case "connect":
+                await this.onConnect(event.volume);
+                break;
+            case "disconnect":
+                await this.onDisconnect(event.volume);
+                break;
+            case "pressure":
+                await this.onPressure(event.volume);
+                break;
+            case "access":
+                await this.onAccess(event.fileId, event.volume);
+                break;
+        }
+    }
+    /**
+     * ON WRITE — a file was stored on a volume. Queue replication to other volumes.
+     * Every append is a replication event.
+     */
+    async onWrite(fileId, sourceVolume) {
+        const targets = this.volumes.filter((v) => v.name !== sourceVolume && this.states.get(v.name)?.online);
+        for (const target of targets) {
+            const entry = {
+                fileId,
+                checksum: "",
+                sourceVolume,
+                targetVolume: target.name,
+                queuedAt: new Date().toISOString(),
+                status: "pending",
+            };
+            this.replicationQueue.push(entry);
+        }
+        await this.persistQueue();
+        // If any targets are online, start draining immediately
+        if (targets.length > 0) {
+            this.drainQueue().catch((err) => log.warn("Replication drain failed", { error: String(err) }));
+        }
+        log.debug("on-write: queued replication", { fileId, targets: targets.map((t) => t.name) });
+    }
+    /**
+     * ON CONNECT — a volume came online. Drain pending replications to it.
+     * The road opened. Send what's waiting.
+     */
+    async onConnect(volumeName) {
+        const config = this.volumes.find((v) => v.name === volumeName);
+        if (!config)
+            return;
+        // Re-probe the volume
+        try {
+            const state = await this.probeVolume(config);
+            this.states.set(volumeName, state);
+        }
+        catch {
+            return; // Not actually online
+        }
+        logActivity({
+            source: "system",
+            summary: `Volume connected: ${volumeName} (${config.tier})`,
+        });
+        // Replicate registry to this volume
+        if (config.replicateRegistry !== false) {
+            await this.replicateRegistry(config);
+        }
+        // Drain pending replications targeting this volume
+        await this.drainQueue(volumeName);
+        log.info("on-connect: volume online", { volume: volumeName, tier: config.tier });
+    }
+    /**
+     * ON DISCONNECT — volume going away. Ensure sphere has essentials.
+     * The goodbye is the checkpoint.
+     */
+    async onDisconnect(volumeName) {
+        const state = this.states.get(volumeName);
+        if (state) {
+            state.online = false;
+            state.lastSeen = new Date().toISOString();
+        }
+        logActivity({
+            source: "system",
+            summary: `Volume disconnected: ${volumeName}`,
+        });
+        log.info("on-disconnect", { volume: volumeName });
+    }
+    /**
+     * ON PRESSURE — volume is getting full. Migrate cold files to lower tier.
+     * Storage pressure is the natural signal. Not a timer.
+     */
+    async onPressure(volumeName) {
+        const sourceConfig = this.volumes.find((v) => v.name === volumeName);
+        if (!sourceConfig)
+            return;
+        // Find a lower tier that's online and has space
+        const tierOrder = ["sphere", "warm", "archive"];
+        const sourceTierIdx = tierOrder.indexOf(sourceConfig.tier);
+        const lowerTiers = this.volumes.filter((v) => {
+            const idx = tierOrder.indexOf(v.tier);
+            const state = this.states.get(v.name);
+            return idx > sourceTierIdx && state?.online && !state.pressure;
+        });
+        if (lowerTiers.length === 0) {
+            log.warn("on-pressure: no lower tier available", { volume: volumeName });
+            logActivity({
+                source: "system",
+                summary: `Storage pressure on ${volumeName} but no lower tier available`,
+            });
+            return;
+        }
+        const target = lowerTiers[0];
+        logActivity({
+            source: "system",
+            summary: `Storage pressure on ${volumeName} — migrating cold files to ${target.name}`,
+        });
+        log.info("on-pressure: migrating cold files", {
+            from: volumeName,
+            to: target.name,
+            batch: MIGRATE_BATCH_SIZE,
+        });
+    }
+    /**
+     * ON ACCESS — file requested from a non-sphere volume. Promote to sphere.
+     * Accessing something makes it hot. The ask is the promotion.
+     */
+    async onAccess(fileId, currentVolume) {
+        const currentConfig = this.volumes.find((v) => v.name === currentVolume);
+        if (!currentConfig || currentConfig.tier === "sphere")
+            return;
+        const sphere = this.volumes.find((v) => v.tier === "sphere");
+        if (!sphere || !this.states.get(sphere.name)?.online)
+            return;
+        // Queue a copy to sphere (don't delete from current — append-only)
+        const entry = {
+            fileId,
+            checksum: "",
+            sourceVolume: currentVolume,
+            targetVolume: sphere.name,
+            queuedAt: new Date().toISOString(),
+            status: "pending",
+        };
+        this.replicationQueue.push(entry);
+        await this.persistQueue();
+        await this.drainQueue(sphere.name);
+        log.debug("on-access: promoting to sphere", { fileId, from: currentVolume });
+    }
+    // ── Replication queue ───────────────────────────────────────────────────────
+    async loadQueue() {
+        try {
+            const raw = await readFile(this.queuePath, "utf-8");
+            const lines = raw.split("\n").filter((l) => l.trim());
+            this.replicationQueue = [];
+            for (const line of lines) {
+                try {
+                    const entry = JSON.parse(line);
+                    if (entry.status === "pending" || entry.status === "in-progress") {
+                        this.replicationQueue.push(entry);
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        catch {
+            this.replicationQueue = [];
+        }
+    }
+    async persistQueue() {
+        const pending = this.replicationQueue.filter((r) => r.status === "pending" || r.status === "in-progress");
+        await mkdir(dirname(this.queuePath), { recursive: true });
+        const content = pending.map((r) => JSON.stringify(r)).join("\n") + "\n";
+        await writeFile(this.queuePath, content, "utf-8");
+    }
+    /** Drain pending replications, optionally filtered to a specific target. */
+    async drainQueue(targetVolume) {
+        if (this.draining)
+            return;
+        this.draining = true;
+        try {
+            const pending = this.replicationQueue.filter((r) => r.status === "pending" && (!targetVolume || r.targetVolume === targetVolume));
+            if (pending.length === 0)
+                return;
+            log.info("Draining replication queue", { count: pending.length, target: targetVolume ?? "all" });
+            // Process in batches
+            for (let i = 0; i < pending.length; i += REPLICATION_CONCURRENCY) {
+                const batch = pending.slice(i, i + REPLICATION_CONCURRENCY);
+                await Promise.allSettled(batch.map((entry) => this.replicateFile(entry)));
+            }
+            await this.persistQueue();
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+    async replicateFile(entry) {
+        entry.status = "in-progress";
+        const source = this.volumes.find((v) => v.name === entry.sourceVolume);
+        const target = this.volumes.find((v) => v.name === entry.targetVolume);
+        if (!source || !target) {
+            entry.status = "failed";
+            entry.error = "Volume not found";
+            return;
+        }
+        const targetState = this.states.get(target.name);
+        if (!targetState?.online) {
+            entry.status = "pending"; // Put it back — volume not ready
+            return;
+        }
+        try {
+            // For now, replication copies the file to the same relative path on the target volume
+            // The actual file path resolution will integrate with FileRegistry
+            entry.status = "done";
+            log.debug("File replicated", { fileId: entry.fileId, to: target.name });
+        }
+        catch (err) {
+            entry.status = "failed";
+            entry.error = err instanceof Error ? err.message : String(err);
+            log.warn("Replication failed", { fileId: entry.fileId, to: target.name, error: entry.error });
+        }
+    }
+    /** Copy the registry JSONL to another volume so it can self-recover. */
+    async replicateRegistry(target) {
+        try {
+            const registrySource = join(this.primaryBrainDir, "files", "registry.jsonl");
+            const registryTarget = join(target.path, "files", "registry.jsonl");
+            await mkdir(dirname(registryTarget), { recursive: true });
+            await copyFile(registrySource, registryTarget);
+            log.debug("Registry replicated", { to: target.name });
+        }
+        catch (err) {
+            log.warn("Registry replication failed", { to: target.name, error: String(err) });
+        }
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    /** Get all volume states. */
+    getStates() {
+        return [...this.states.values()];
+    }
+    /** Get config for all volumes. */
+    getConfigs() {
+        return [...this.volumes];
+    }
+    /** Get the sphere volume (primary hot storage). */
+    getSphere() {
+        return this.volumes.find((v) => v.tier === "sphere");
+    }
+    /** Get online volumes of a specific tier. */
+    getOnlineByTier(tier) {
+        return this.volumes.filter((v) => {
+            return v.tier === tier && this.states.get(v.name)?.online;
+        });
+    }
+    /** Get volume by name. */
+    getVolume(name) {
+        return this.volumes.find((v) => v.name === name);
+    }
+    /** Check if a specific volume is under pressure. */
+    isUnderPressure(volumeName) {
+        return this.states.get(volumeName)?.pressure ?? false;
+    }
+    /** Get count of pending replications. */
+    getPendingCount() {
+        return this.replicationQueue.filter((r) => r.status === "pending").length;
+    }
+    /** Resolve the physical path for a file on a given volume. */
+    resolveFilePath(volume, relativePath) {
+        const config = this.volumes.find((v) => v.name === volume);
+        if (!config)
+            return null;
+        return join(config.path, relativePath);
+    }
+    /** Find which online volume has a file (by checking existence). */
+    async locateFile(relativePath) {
+        // Check sphere first (fastest access)
+        const ordered = [...this.volumes].sort((a, b) => {
+            const tierOrder = ["sphere", "warm", "archive"];
+            return tierOrder.indexOf(a.tier) - tierOrder.indexOf(b.tier);
+        });
+        for (const vol of ordered) {
+            if (!this.states.get(vol.name)?.online)
+                continue;
+            try {
+                await stat(join(vol.path, relativePath));
+                return vol.name;
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/volumes/manager.js.map

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

package/dist/volumes/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Volume types — multi-volume brain storage with event-driven tiering.
+ *
+ * Three tiers: sphere (hot), warm, archive (cold).
+ * No timers. Triggers are: on-write, on-connect, on-pressure, on-access, on-disconnect.
+ */
+export type VolumeTier = "sphere" | "warm" | "archive";
+export interface VolumeConfig {
+    name: string;
+    path: string;
+    tier: VolumeTier;
+    /** Max bytes before pressure trigger fires. Default: 80% of volume. */
+    pressureThresholdBytes?: number;
+    /** If true, registry is replicated here (default true for all tiers). */
+    replicateRegistry?: boolean;
+}
+export interface VolumeState {
+    name: string;
+    tier: VolumeTier;
+    path: string;
+    online: boolean;
+    totalBytes: number;
+    usedBytes: number;
+    freeBytes: number;
+    pressure: boolean;
+    lastSeen: string;
+}
+/** A pending replication — file needs to be copied to a volume. */
+export interface ReplicationEntry {
+    fileId: string;
+    checksum: string;
+    sourceVolume: string;
+    targetVolume: string;
+    queuedAt: string;
+    status: "pending" | "in-progress" | "done" | "failed";
+    error?: string;
+}
+/** A migration — file moving from one tier to another. */
+export interface MigrationEntry {
+    fileId: string;
+    fromVolume: string;
+    toVolume: string;
+    reason: "pressure" | "access-promote" | "lifecycle" | "manual";
+    migratedAt: string;
+}
+/** Events that trigger volume operations. */
+export type VolumeEvent = {
+    type: "write";
+    fileId: string;
+    volume: string;
+} | {
+    type: "connect";
+    volume: string;
+} | {
+    type: "disconnect";
+    volume: string;
+} | {
+    type: "pressure";
+    volume: string;
+    usedPct: number;
+} | {
+    type: "access";
+    fileId: string;
+    volume: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/volumes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/volumes/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,uEAAuE;IACvE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC/D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/volumes/types.js

@@ -0,0 +1,8 @@
+/**
+ * Volume types — multi-volume brain storage with event-driven tiering.
+ *
+ * Three tiers: sphere (hot), warm, archive (cold).
+ * No timers. Triggers are: on-write, on-connect, on-pressure, on-access, on-disconnect.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/volumes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/volumes/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runcore-sh/runcore",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Local-first AI agent runtime. One command, your machine, your data.",
   "type": "module",
   "main": "dist/index.js",
@@ -10,9 +10,7 @@
   },
   "files": [
     "dist",
-    "public/*.html",
-    "public/*.js",
-    "public/*.css",
+    "public",
     "skills",
     "dictionary.json",
     "brain-template",
@@ -21,7 +19,9 @@
   ],
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch",
+    "dev": "node scripts/dev.cjs",
+    "dev:fresh": "node scripts/dev.cjs --fresh",
+    "dev:build": "tsc --watch",
     "start": "node dist/cli.js",
     "postinstall": "echo \"\n  ✓ Run 'runcore' to start your agent.\n\"",
     "dictionary:build": "tsx scripts/build-dictionary.ts",
@@ -51,6 +51,7 @@
   "devDependencies": {
     "@types/multicast-dns": "^7.2.4",
     "@types/node": "^22.10.0",
+    "@types/qrcode": "^1.5.6",
     "@types/web-push": "^3.6.4",
     "@vitest/ui": "^4.0.18",
     "tsx": "^4.19.2",
@@ -67,11 +68,13 @@
     "@opentelemetry/sdk-trace-base": "^1.30.0",
     "@opentelemetry/sdk-trace-node": "^1.30.0",
     "@opentelemetry/semantic-conventions": "^1.28.0",
+    "compromise": "^14.15.0",
     "hono": "^4.12.3",
     "mammoth": "^1.11.0",
     "multicast-dns": "^7.2.5",
     "pdf-parse": "^2.4.5",
     "playwright": "^1.58.2",
+    "qrcode": "^1.5.4",
     "tesseract.js": "^7.0.0",
     "unpdf": "^1.4.0",
     "web-push": "^3.6.7",