@ouro.bot/cli 0.1.0-alpha.346 → 0.1.0-alpha.347

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_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.347",
+      "changes": [
+        "Post-turn session persist functions now return the events array directly, eliminating a redundant `loadSession` file read after every CLI TUI turn. `postTurnPersist` returns `SessionEvent[]` and `deferPostTurnPersist` returns `Promise<SessionEvent[]>`, so the CLI sense uses the returned data instead of re-reading the file it just wrote."
+      ]
+    },
     {
       "version": "0.1.0-alpha.346",
       "changes": [

package/dist/heart/session-events.js

@@ -676,11 +676,11 @@ function selectProjectedEventIds(currentMessages, currentEventIds, trimmedMessag
 }
 function buildCanonicalSessionEnvelope(options) {
     const existing = options.existing;
-    // Capture ingress timestamps before sanitization strips extra properties
-    const currentIngressTimes = options.currentMessages.map(getIngressTime);
-    const previousMessages = sanitizeProviderMessages(options.previousMessages);
-    const currentMessages = sanitizeProviderMessages(options.currentMessages);
-    const trimmedMessages = sanitizeProviderMessages(options.trimmedMessages);
+    // Callers pass pre-sanitized messages + pre-captured ingress times.
+    const currentIngressTimes = options.currentIngressTimes ?? options.currentMessages.map(getIngressTime);
+    const previousMessages = options.previousMessages;
+    const currentMessages = options.currentMessages;
+    const trimmedMessages = options.trimmedMessages;
     const previousProjectionIds = existing?.projection.eventIds.length
         ? [...existing.projection.eventIds]
         : existing?.events.map((event) => event.id) ?? [];

package/dist/mind/context.js

@@ -39,6 +39,9 @@ exports.saveSession = saveSession;
 exports.appendSyntheticAssistantMessage = appendSyntheticAssistantMessage;
 exports.loadSession = loadSession;
 exports.postTurn = postTurn;
+exports.postTurnTrim = postTurnTrim;
+exports.postTurnPersist = postTurnPersist;
+exports.deferPostTurnPersist = deferPostTurnPersist;
 exports.deleteSession = deleteSession;
 const config_1 = require("../heart/config");
 const session_events_1 = require("../heart/session-events");
@@ -193,12 +196,14 @@ function writeSessionEnvelope(filePath, envelope) {
 function saveSession(filePath, messages, lastUsage, state) {
     const existing = (0, session_events_1.loadSessionEnvelopeFile)(filePath);
     const previousMessages = existing ? (0, session_events_1.projectProviderMessages)(existing) : [];
+    const currentIngressTimes = messages.map(session_events_1.getIngressTime);
     const sanitized = (0, session_events_1.sanitizeProviderMessages)(messages);
     const envelope = (0, session_events_1.buildCanonicalSessionEnvelope)({
         existing,
         previousMessages,
         currentMessages: sanitized,
         trimmedMessages: sanitized,
+        currentIngressTimes,
         recordedAt: new Date().toISOString(),
         lastUsage: lastUsage ?? null,
         state,
@@ -247,7 +252,19 @@ function loadSession(filePath) {
         return null;
     }
 }
+/**
+ * Synchronous post-turn: sanitize, trim (mutates messages in place), and persist to disk.
+ * For non-blocking persist, use postTurnTrim() + deferPostTurnPersist() instead.
+ */
 function postTurn(messages, sessPath, usage, hooks, state) {
+    const prepared = postTurnTrim(messages, usage, hooks);
+    postTurnPersist(sessPath, prepared, usage, state);
+}
+/**
+ * Synchronous phase: run hooks, sanitize, trim, and mutate the messages array in place.
+ * Returns the data needed by postTurnPersist / deferPostTurnPersist.
+ */
+function postTurnTrim(messages, usage, hooks) {
     const preTrimMessages = [...messages];
     if (hooks?.beforeTrim) {
         try {
@@ -266,26 +283,59 @@ function postTurn(messages, sessPath, usage, hooks, state) {
         }
     }
     const { maxTokens, contextMargin } = (0, config_1.getContextConfig)();
+    const currentIngressTimes = messages.map(session_events_1.getIngressTime);
     const currentMessages = (0, session_events_1.sanitizeProviderMessages)(messages);
-    const trimmed = trimMessages(currentMessages, maxTokens, contextMargin, usage?.input_tokens);
-    messages.splice(0, messages.length, ...trimmed);
+    const trimmedMessages = trimMessages(currentMessages, maxTokens, contextMargin, usage?.input_tokens);
+    messages.splice(0, messages.length, ...trimmedMessages);
+    return { currentMessages, trimmedMessages, currentIngressTimes, maxTokens, contextMargin };
+}
+/**
+ * Synchronous persist: load existing envelope, build canonical envelope, write to disk.
+ */
+function postTurnPersist(sessPath, prepared, usage, state) {
     const existing = (0, session_events_1.loadSessionEnvelopeFile)(sessPath);
     const previousMessages = existing ? (0, session_events_1.projectProviderMessages)(existing) : [];
     const envelope = (0, session_events_1.buildCanonicalSessionEnvelope)({
         existing,
         previousMessages,
-        currentMessages,
-        trimmedMessages: trimmed,
+        currentMessages: prepared.currentMessages,
+        trimmedMessages: prepared.trimmedMessages,
+        currentIngressTimes: prepared.currentIngressTimes,
         recordedAt: new Date().toISOString(),
         lastUsage: usage ?? null,
         state,
         projectionBasis: {
-            maxTokens,
-            contextMargin,
+            maxTokens: prepared.maxTokens,
+            contextMargin: prepared.contextMargin,
             inputTokens: usage?.input_tokens ?? null,
         },
     });
     writeSessionEnvelope(sessPath, envelope);
+    return envelope.events;
+}
+/**
+ * Deferred persist: same as postTurnPersist but runs on the next event loop tick.
+ * Returns a promise that resolves when the persist completes.
+ */
+function deferPostTurnPersist(sessPath, prepared, usage, state) {
+    return new Promise((resolve) => {
+        setImmediate(() => {
+            try {
+                const events = postTurnPersist(sessPath, prepared, usage, state);
+                resolve(events);
+            }
+            catch (err) {
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "mind",
+                    event: "mind.deferred_persist_error",
+                    message: "deferred session persist failed",
+                    meta: { error: err instanceof Error ? err.message : String(err) },
+                });
+                resolve([]);
+            }
+        });
+    });
 }
 function deleteSession(filePath) {
     try {

package/dist/senses/cli.js

@@ -1009,8 +1009,10 @@ async function main(agentName, options) {
             lastActivityAt: sessionState?.lastFriendActivityAt,
             _testInputSource: options?._testInputSource,
             onAsyncAssistantMessage: async (messages, _assistantMessage) => {
-                (0, context_1.postTurn)(messages, sessPath, undefined, undefined, sessionState);
-                sessionEvents = (0, context_1.loadSession)(sessPath)?.events ?? sessionEvents;
+                const prepared = (0, context_1.postTurnTrim)(messages);
+                const events = (0, context_1.postTurnPersist)(sessPath, prepared, undefined, sessionState);
+                /* v8 ignore next -- defensive: postTurnPersist always returns events in practice @preserve */
+                sessionEvents = events.length > 0 ? events : sessionEvents;
             },
             runTurn: async (messages, userInput, callbacks, signal, toolContext, userContent) => {
                 // Run the full per-turn pipeline: resolve -> gate -> session -> drain -> runAgent -> postTurn -> tokens
@@ -1022,9 +1024,10 @@ async function main(agentName, options) {
                 /* v8 ignore start -- failover-aware callback wrapper: tested via pipeline integration @preserve */
                 const failoverAwareCallbacks = {
                     ...callbacks,
-                    // Save session after each tool result for crash recovery
+                    // Save session after each tool result for crash recovery (deferred to avoid blocking)
                     onToolResult: (turnMessages) => {
-                        (0, context_1.postTurn)(turnMessages, sessPath, undefined, undefined, sessionState);
+                        const prepared = (0, context_1.postTurnTrim)(turnMessages);
+                        (0, context_1.deferPostTurnPersist)(sessPath, prepared, undefined, sessionState);
                     },
                     onError: (error, severity) => {
                         if (severity === "terminal" && failoverState) {
@@ -1069,9 +1072,14 @@ async function main(agentName, options) {
                         },
                     }),
                     postTurn: (turnMessages, sessionPathArg, usage, hooks, state) => {
-                        (0, context_1.postTurn)(turnMessages, sessionPathArg, usage, hooks, state);
+                        // Trim synchronously (mutates turnMessages for next turn),
+                        // then defer envelope build + disk I/O to avoid blocking the TUI.
+                        const prepared = (0, context_1.postTurnTrim)(turnMessages, usage, hooks);
                         sessionState = state;
-                        sessionEvents = (0, context_1.loadSession)(sessionPathArg)?.events ?? sessionEvents;
+                        (0, context_1.deferPostTurnPersist)(sessionPathArg, prepared, usage, state).then((events) => {
+                            /* v8 ignore next -- defensive: deferPostTurnPersist always resolves events in practice @preserve */
+                            sessionEvents = events.length > 0 ? events : sessionEvents;
+                        });
                     },
                     accumulateFriendTokens: tokens_1.accumulateFriendTokens,
                     signal,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.346",
+  "version": "0.1.0-alpha.347",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",