@runcore-sh/runcore 0.1.2

package/dist/adapters/storage/local.js

@@ -0,0 +1,101 @@
+/**
+ * Local filesystem storage adapter — stores backups in a configurable directory.
+ * Always available. Good for local redundancy or external-drive backups.
+ */
+import { readFile, readdir, mkdir, copyFile, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { createLogger } from "../../utils/logger.js";
+const log = createLogger("backup.local");
+export class LocalStorageAdapter {
+    name = "local";
+    backupDir;
+    constructor(backupDir) {
+        this.backupDir = backupDir;
+    }
+    async isAvailable() {
+        try {
+            await mkdir(this.backupDir, { recursive: true });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async upload(archivePath, remoteName) {
+        try {
+            await mkdir(this.backupDir, { recursive: true });
+            const dest = join(this.backupDir, remoteName);
+            await copyFile(archivePath, dest);
+            // Copy manifest alongside archive
+            const manifestPath = archivePath.replace(/\.tar\.gz$/, ".manifest.json");
+            let manifest;
+            try {
+                const raw = await readFile(manifestPath, "utf-8");
+                manifest = JSON.parse(raw);
+                await copyFile(manifestPath, join(this.backupDir, remoteName.replace(/\.tar\.gz$/, ".manifest.json")));
+            }
+            catch {
+                // No manifest — still ok
+            }
+            log.info("backup uploaded to local storage", { dest });
+            return { ok: true, message: `Saved to ${dest}`, manifest };
+        }
+        catch (err) {
+            log.error("local upload failed", { error: err.message });
+            return { ok: false, message: `Local upload failed: ${err.message}` };
+        }
+    }
+    async download(remoteName, localPath) {
+        try {
+            const src = join(this.backupDir, remoteName);
+            await copyFile(src, localPath);
+            log.info("backup downloaded from local storage", { src, localPath });
+            return { ok: true, message: `Restored from ${src}`, filesRestored: 1 };
+        }
+        catch (err) {
+            log.error("local download failed", { error: err.message });
+            return { ok: false, message: `Local download failed: ${err.message}`, filesRestored: 0 };
+        }
+    }
+    async listBackups() {
+        try {
+            await mkdir(this.backupDir, { recursive: true });
+            const entries = await readdir(this.backupDir);
+            const manifests = [];
+            for (const entry of entries) {
+                if (!entry.endsWith(".manifest.json"))
+                    continue;
+                try {
+                    const raw = await readFile(join(this.backupDir, entry), "utf-8");
+                    manifests.push(JSON.parse(raw));
+                }
+                catch {
+                    continue;
+                }
+            }
+            return manifests.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+        }
+        catch {
+            return [];
+        }
+    }
+    async deleteBackup(backupId) {
+        try {
+            const entries = await readdir(this.backupDir);
+            let deleted = 0;
+            for (const entry of entries) {
+                if (entry.includes(backupId)) {
+                    await unlink(join(this.backupDir, entry));
+                    deleted++;
+                }
+            }
+            if (deleted === 0)
+                return { ok: false, message: `No backup found with id ${backupId}` };
+            return { ok: true, message: `Deleted ${deleted} files for backup ${backupId}` };
+        }
+        catch (err) {
+            return { ok: false, message: `Delete failed: ${err.message}` };
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/adapters/storage/local.js.map

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

package/dist/adapters/storage/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Storage adapter interface for brain backups.
+ * Implementations sync the brain/ directory to a storage backend.
+ */
+export interface BackupManifest {
+    id: string;
+    timestamp: string;
+    files: BackupFileEntry[];
+    totalBytes: number;
+    provider: string;
+}
+export interface BackupFileEntry {
+    relativePath: string;
+    checksum: string;
+    sizeBytes: number;
+    encrypted: boolean;
+}
+export interface BackupResult {
+    ok: boolean;
+    message: string;
+    manifest?: BackupManifest;
+}
+export interface RestoreResult {
+    ok: boolean;
+    message: string;
+    filesRestored: number;
+}
+export interface StorageAdapter {
+    readonly name: string;
+    /** Test if the adapter is available and configured. */
+    isAvailable(): Promise<boolean>;
+    /** Upload a backup archive to the storage backend. */
+    upload(archivePath: string, remoteName: string): Promise<BackupResult>;
+    /** Download a backup archive from the storage backend. */
+    download(remoteName: string, localPath: string): Promise<RestoreResult>;
+    /** List available backups. */
+    listBackups(): Promise<BackupManifest[]>;
+    /** Delete a specific backup by ID. */
+    deleteBackup(backupId: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,uDAAuD;IACvD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC,sDAAsD;IACtD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEvE,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAExE,8BAA8B;IAC9B,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEzC,sCAAsC;IACtC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E"}

package/dist/adapters/storage/types.js

@@ -0,0 +1,6 @@
+/**
+ * Storage adapter interface for brain backups.
+ * Implementations sync the brain/ directory to a storage backend.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/storage/types.js.map

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

package/dist/agents/autonomous.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Autonomous work loop — the missing "first nudge" that makes the agent proactive.
+ *
+ * Two entry points:
+ *   1. Timer: fires 60s after boot, then every 15 min. Checks board, spawns agents.
+ *   2. continueAfterBatch(): called when a batch completes, decides what's next.
+ *
+ * Both use planAndSpawn() which:
+ *   - Reads board state directly (no HTTP, no SSE, no session validation)
+ *   - Asks the LLM to pick tasks and write agent prompts
+ *   - Parses [AGENT_REQUEST] blocks from the response
+ *   - Spawns agents via submitTask()
+ */
+import type { PulseStatus } from "../pulse/types.js";
+/**
+ * Start the autonomous work timer. Idempotent.
+ * First check fires 60s after boot (not immediately — gives system time to init).
+ * Then repeats every 15 min.
+ */
+export declare function startAutonomousTimer(intervalMs?: number): void;
+/** Stop the autonomous timer. */
+export declare function stopAutonomousTimer(): void;
+/** Is the autonomous timer running? */
+export declare function isAutonomousTimerRunning(): boolean;
+/**
+ * Called by PressureIntegrator when tension exceeds threshold.
+ * Wraps checkForWork() with the existing planningInProgress guard.
+ */
+export declare function triggerPulse(): Promise<void>;
+/** Status snapshot for the `auto` chat command. */
+export interface AutonomousStatus {
+    timerRunning: boolean;
+    intervalMs: number;
+    firstCheckDelayMs: number;
+    creditCircuitBreakerActive: boolean;
+    creditCircuitBreakerRemainingMin: number;
+    planningInProgress: boolean;
+    activeAgents: number;
+    maxConcurrentAgents: number;
+    activeSessions: string[];
+    cooldowns: Array<{
+        taskId: string;
+        label?: string;
+        failureCount: number;
+        remainingMin: number;
+    }>;
+    plannerSkippedItems: number;
+    pulse: PulseStatus | null;
+}
+/** Get a snapshot of the autonomous work loop's current state. */
+export declare function getAutonomousStatus(): AutonomousStatus;
+/**
+ * Called by onBatchComplete when all agents in a session finish.
+ * Commits work, then checks if there's more to do.
+ */
+export declare function continueAfterBatch(sessionId: string, results: Array<{
+    label: string;
+    status: string;
+}>): Promise<void>;
+/** Reset continuation tracking for a session. */
+export declare function resetContinuation(sessionId: string): void;
+/**
+ * Periodic check: if agents are idle and there's actionable work, spawn agents.
+ * Exported so PressureIntegrator can call it directly on pulse.
+ */
+export declare function checkForWork(): Promise<void>;
+//# sourceMappingURL=autonomous.d.ts.map

package/dist/agents/autonomous.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autonomous.d.ts","sourceRoot":"","sources":["../../src/agents/autonomous.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAqErD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAoC9D;AAED,iCAAiC;AACjC,wBAAgB,mBAAmB,IAAI,IAAI,CAW1C;AAED,uCAAuC;AACvC,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAWlD;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,OAAO,CAAC;IACpC,gCAAgC,EAAE,MAAM,CAAC;IACzC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjG,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,gBAAgB,CAyBtD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC,CA8Ff;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGzD;AAID;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA6ElD"}