@ouro.bot/cli 0.1.0-alpha.856 → 0.1.0-alpha.859

package/changelog.json

@@ -1,6 +1,19 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.859",
+      "changes": [
+        "The Telegram sense no longer re-reads and re-parses every external-event record (hundreds of files, about 11 MB) each second for its system-failsafe sweep; it now reuses the stat-keyed record cache, cutting the Butler's idle Telegram CPU. The trade is memory: parsed records now stay cached in the sense process for its lifetime, so heap grows by roughly the size of the usenet records."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.857",
+      "changes": [
+        "The daemon now caches external-event records by file stat so the one-second reconcile tick no longer re-reads and re-parses every unchanged record, cutting idle CPU.",
+        "The record cache never keeps a filesystem read error and re-reads any entry older than a minute, so a transient read failure or a missed change cannot hide a record."
+      ]
+    },
     {
       "version": "0.1.0-alpha.856",
       "changes": [

package/deploy/unraid/sanctuary.ouro/bundle-meta.json

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.1.0-alpha.856",
+  "runtimeVersion": "0.1.0-alpha.859",
   "bundleSchemaVersion": 3,
   "lastUpdated": "2026-09-03T00:00:00.000Z"
 }

package/deploy/unraid/sanctuary.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <Container version="2">
   <Name>ouro-butler</Name>
-  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.856</Repository>
+  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.859</Repository>
   <Registry>https://github.com/ourostack/ouroboros/pkgs/container/ouroboros-butler</Registry>
   <Network>host</Network>
   <Shell>sh</Shell>

package/dist/heart/daemon/daemon.js

@@ -637,6 +637,7 @@ class OuroDaemon {
     externalEventRoot;
     privilegedEventSpoolRoot;
     privilegedEventScanner;
+    externalEventScanCache = new router_1.ExternalEventScanCache();
     rsvpHabitRunner;
     nativeHabitRunner;
     nativeHabitMatch;
@@ -1701,12 +1702,11 @@ class OuroDaemon {
             if (fs.existsSync(this.privilegedEventSpoolRoot)) {
                 this.privilegedEventScanner({ spoolRoot: this.privilegedEventSpoolRoot, eventRoot: this.externalEventRootPath() });
             }
-            const statuses = (0, router_1.listExternalEventStatus)(this.externalEventRootPath());
+            const scanned = this.externalEventScanCache.scan(this.externalEventRootPath());
             const readinessKeys = new Set();
-            for (const status of statuses) {
-                if (status.corrupt)
+            for (const { record: candidate } of scanned) {
+                if (!candidate)
                     continue;
-                const candidate = (0, router_1.readExternalEventRecord)(status.recordPath);
                 if (candidate.dispatchEnabled === false)
                     continue;
                 const retryDue = candidate.executionState === "retry_wait" && candidate.nextAttemptAt !== null && Date.parse(candidate.nextAttemptAt) <= Date.parse(now);
@@ -1739,10 +1739,10 @@ class OuroDaemon {
             const providerEvidenceByAgent = new Map();
             const runtimeEvidenceByAgent = new Map();
             const recoveredByClass = new Map();
-            for (const status of statuses) {
-                if (status.corrupt)
+            for (const { record: scannedRecord } of scanned) {
+                if (!scannedRecord)
                     continue;
-                let record = (0, router_1.readExternalEventRecord)(status.recordPath);
+                let record = scannedRecord;
                 if (record.dispatchEnabled === false)
                     continue;
                 if (blockedReadinessKeys.has(`${record.agent}\0${record.source}`))

package/dist/heart/external-events/router.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalEventScanCache = void 0;
 exports.getExternalEventRoot = getExternalEventRoot;
 exports.externalEventRecordPath = externalEventRecordPath;
 exports.readExternalEventRecord = readExternalEventRecord;
@@ -622,6 +623,78 @@ function listExternalEventStatus(root) {
     }
     return rows.sort((left, right) => left.agent.localeCompare(right.agent) || left.source.localeCompare(right.source) || left.eventId.localeCompare(right.eventId));
 }
+/**
+ * Stat-keyed record cache for the daemon's reconcile tick. Records are written by atomic rename, so any write
+ * changes inode, mtime or ctime and invalidates the entry. Cached records are only used to decide what is due;
+ * every mutation (claim, revive, reconcile) re-reads the file under its own lock and compare-and-swap check, so a
+ * stale cached record can at worst cause one rejected attempt that the next tick retries from fresh data.
+ * As a backstop against a change the stat key misses, an entry older than `maxAgeMs` is re-read anyway, and a
+ * filesystem read error (one carrying an fs `code`, such as EIO or EMFILE) is reported for this scan but never
+ * cached, so a transient failure cannot hide a healthy record until its file next changes.
+ */
+class ExternalEventScanCache {
+    entries = new Map();
+    maxAgeMs;
+    now;
+    constructor(options = {}) {
+        this.maxAgeMs = options.maxAgeMs ?? 60_000;
+        this.now = options.now ?? Date.now;
+    }
+    scan(root) {
+        const seen = new Set();
+        const rows = [];
+        const nowMs = this.now();
+        if (fs.existsSync(root)) {
+            for (const agent of fs.readdirSync(root, { withFileTypes: true })) {
+                if (!agent.isDirectory() || agent.name.startsWith("."))
+                    continue;
+                const agentPath = path.join(root, agent.name);
+                for (const source of fs.readdirSync(agentPath, { withFileTypes: true })) {
+                    if (!source.isDirectory() || source.name.startsWith("."))
+                        continue;
+                    const sourcePath = path.join(agentPath, source.name);
+                    for (const file of fs.readdirSync(sourcePath, { withFileTypes: true })) {
+                        if (!file.isFile() || file.name.startsWith(".") || !file.name.endsWith(".json"))
+                            continue;
+                        const recordPath = path.join(sourcePath, file.name);
+                        let stat;
+                        try {
+                            stat = fs.statSync(recordPath);
+                        }
+                        catch {
+                            continue;
+                        }
+                        seen.add(recordPath);
+                        const cached = this.entries.get(recordPath);
+                        if (cached && cached.ino === stat.ino && cached.size === stat.size && cached.mtimeMs === stat.mtimeMs && cached.ctimeMs === stat.ctimeMs && nowMs - cached.cachedAtMs < this.maxAgeMs) {
+                            rows.push(cached.entry);
+                            continue;
+                        }
+                        let entry;
+                        let cacheable = true;
+                        try {
+                            entry = { recordPath, record: readExternalEventRecord(recordPath), error: null };
+                        }
+                        catch (error) {
+                            entry = { recordPath, record: null, error: error instanceof Error ? error.message : /* v8 ignore next -- filesystem and JSON parsers throw Error objects @preserve */ String(error) };
+                            cacheable = !(error && typeof error === "object" && typeof error.code === "string");
+                        }
+                        if (cacheable)
+                            this.entries.set(recordPath, { ino: stat.ino, size: stat.size, mtimeMs: stat.mtimeMs, ctimeMs: stat.ctimeMs, cachedAtMs: nowMs, entry });
+                        else
+                            this.entries.delete(recordPath);
+                        rows.push(entry);
+                    }
+                }
+            }
+        }
+        for (const key of this.entries.keys())
+            if (!seen.has(key))
+                this.entries.delete(key);
+        return rows;
+    }
+}
+exports.ExternalEventScanCache = ExternalEventScanCache;
 function readExisting(recordPath) {
     if (!fs.existsSync(recordPath))
         return { record: null, corruptDuplicateCount: 0 };

package/dist/senses/telegram-effect-adapter.js

@@ -599,11 +599,15 @@ async function reconcileTelegramSystemFailsafe(input) {
     return { sent: true, reason: "sent", artifactId: artifact.id };
 }
 async function sweepTelegramSystemFailsafes(input) {
-    const records = (0, router_1.listExternalEventStatus)(input.eventRoot).filter((status) => !status.corrupt && status.agent === "sanctuary" && status.source === "sanctuary-usenet").slice(0, 32);
+    const scanned = (input.scanCache ?? new router_1.ExternalEventScanCache()).scan(input.eventRoot);
+    const records = scanned
+        .flatMap((entry) => entry.record && entry.record.agent === "sanctuary" && entry.record.source === "sanctuary-usenet" && !entry.record.privilegedFailsafe ? [entry.record] : [])
+        .sort((left, right) => left.eventId.localeCompare(right.eventId))
+        .slice(0, 32);
     let sent = 0;
-    for (const status of records) {
+    for (const cached of records) {
         const result = await reconcileTelegramSystemFailsafe({
-            record: (0, router_1.readExternalEventRecord)(status.recordPath),
+            record: cached,
             ...(input.now ? { now: input.now } : {}),
             target: input.target,
             verifyProtectiveState: input.verifyProtectiveState,

package/dist/senses/telegram.js

@@ -1176,6 +1176,7 @@ function createTelegramSenseApp(options) {
             },
         }),
     });
+    const failsafeScanCache = new router_1.ExternalEventScanCache();
     reconcileSystemFailsafes = async () => {
         if (!options.privilegedFailsafe)
             return;
@@ -1185,6 +1186,7 @@ function createTelegramSenseApp(options) {
                 eventRoot: options.privilegedFailsafe.eventRoot,
                 target,
                 verifyProtectiveState: options.privilegedFailsafe.verifyProtectiveState,
+                scanCache: failsafeScanCache,
                 execute: executeAuthorizedEffect,
                 recordArtifact: async (artifact) => {
                     await recordAcceptedEffects((0, shared_turn_1.getSenseSessionPath)(options.agentName, target.friendId, "telegram", target.sessionKey, agentRoot), [artifact]);

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.856",
+  "version": "0.1.0-alpha.859",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ouro.bot/cli",
-      "version": "0.1.0-alpha.856",
+      "version": "0.1.0-alpha.859",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.78.0",
         "@azure/identity": "^4.13.0",
@@ -6532,9 +6532,9 @@
       }
     },
     "node_modules/proxy-addr": {
-      "version": "2.0.7",
-      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
-      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "version": "2.0.8",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.8.tgz",
+      "integrity": "sha512-5nnx0yGyVUcY6t9RnWcARWtwT9F1D8O9rt08htPvnd49W1IgZtmLkhu9WfMzQj1cFxjHIO6connUNVW5k7AVyQ==",
       "license": "MIT",
       "dependencies": {
         "forwarded": "0.2.0",
@@ -6542,6 +6542,10 @@
       },
       "engines": {
         "node": ">= 0.10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
       }
     },
     "node_modules/proxy-from-env": {
@@ -7155,9 +7159,9 @@
       }
     },
     "node_modules/source-map-js": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
-      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.2.tgz",
+      "integrity": "sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==",
       "dev": true,
       "license": "BSD-3-Clause",
       "engines": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.856",
+  "version": "0.1.0-alpha.859",
   "engines": {
     "node": ">=22"
   },