@ouro.bot/cli 0.1.0-alpha.976 → 0.1.0-alpha.978

package/changelog.json

@@ -1,6 +1,18 @@
 {
   "_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.978",
+      "changes": [
+        "Psyche edits now take effect on the next turn for every agent. Each prompt build compares the content of the psyche and house files with the cached copy and rereads on any change, so an edit by the agent, its owner or a sync pull no longer waits for a restart. Content is compared rather than mtimes, which FUSE shares such as Unraid's do not always update."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.977",
+      "changes": [
+        "The replay gate now reads the Butler's settle answer as his reply. A chef-question run that answered correctly through settle after a narration line was failed for not naming the show, which rolled back alpha.976."
+      ]
+    },
     {
       "version": "0.1.0-alpha.976",
       "changes": [

package/deploy/unraid/sanctuary-replay-gate.mjs

@@ -78,7 +78,11 @@ export function extractTimeline(session) {
   for (const event of events) {
     if (event.role !== "assistant") continue
     if (typeof event.content === "string" && event.content.length > 0) timeline.push({ kind: "reply", text: event.content })
-    for (const call of event.toolCalls ?? []) timeline.push({ kind: "call", name: call.function?.name ?? "", args: call.function?.arguments ?? "", result: results.get(call.id) ?? "" })
+    for (const call of event.toolCalls ?? []) {
+      timeline.push({ kind: "call", name: call.function?.name ?? "", args: call.function?.arguments ?? "", result: results.get(call.id) ?? "" })
+      const answer = settleAnswer(call)
+      if (answer) timeline.push({ kind: "reply", text: answer })
+    }
   }
   return timeline
 }
@@ -148,10 +152,19 @@ export function offersToStartStoppedContainer(text) {
   return new RegExp(`\\b(?:want me to|should i|shall i|do you want me to|would you like me to|i can|i could|i'll|let me)\\b[^.!?\\n]*\\b${START_VERB}\\b`, "i").test(t)
 }
 
-/** Everything the assistant said across a session, in order (a reply may be spread over several messages). */
+/** The answer a settle call delivered, or "" for any other call. The Butler's final reply goes out through settle, not as message text. */
+export function settleAnswer(call) {
+  if (call?.function?.name !== "settle") return ""
+  try { const answer = JSON.parse(call.function.arguments ?? "").answer; return typeof answer === "string" ? answer : "" } catch { return "" }
+}
+
+/** What one assistant event said, in order: its own text, then any settle answers it delivered. */
+const spoken = (event) => event?.role !== "assistant" ? [] : [typeof event.content === "string" ? event.content : "", ...(event.toolCalls ?? []).map(settleAnswer)].filter((text) => text.length > 0)
+
+/** Everything the assistant said across a session, in order (a reply may be spread over several messages, and the last is often a settle answer). */
 export function extractReplies(session) {
   const events = Array.isArray(session?.events) ? session.events : []
-  return events.filter((event) => event.role === "assistant" && typeof event.content === "string" && event.content.length > 0).map((event) => event.content).join("\n")
+  return events.flatMap(spoken).join("\n")
 }
 
 export const STALL_MIN_AGE_HOURS = 6
@@ -640,15 +653,16 @@ export function ownerPolicyUntouched(before, after) {
 const sessionEvents = (session) => (Array.isArray(session?.events) ? session.events : [])
 /** The last thing the assistant said in a session, or "" when it has said nothing. */
 export function lastReply(session) {
-  const replies = sessionEvents(session).filter((event) => event.role === "assistant" && typeof event.content === "string" && event.content.length > 0)
-  return replies.at(-1)?.content ?? ""
+  return sessionEvents(session).flatMap(spoken).at(-1) ?? ""
 }
 
-/** A turn has finished when the session has grown past what it held before the message and ends on a plain reply (no tool calls pending). */
+/** A turn has finished when the session has grown past what it held before the message and ends on a plain reply (no tool calls pending), or on the delivery of a settle answer. */
 export function turnSettled(session, eventsBefore) {
   const events = sessionEvents(session)
   const last = events.at(-1)
-  return events.length > eventsBefore && last?.role === "assistant" && typeof last.content === "string" && last.content.length > 0 && !(Array.isArray(last.toolCalls) && last.toolCalls.length > 0)
+  if (events.length <= eventsBefore) return false
+  if (last?.role === "tool") return events.some((event) => event.role === "assistant" && (event.toolCalls ?? []).some((call) => call.id === last.toolCallId && call.function?.name === "settle"))
+  return last?.role === "assistant" && typeof last.content === "string" && last.content.length > 0 && !(Array.isArray(last.toolCalls) && last.toolCalls.length > 0)
 }
 
 /** After a cut send, wait (bounded) until the turn has settled and the session has stopped growing between two reads. */

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

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.1.0-alpha.976",
+  "runtimeVersion": "0.1.0-alpha.978",
   "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.976</Repository>
+  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.978</Repository>
   <Registry>https://github.com/ourostack/ouroboros/pkgs/container/ouroboros-butler</Registry>
   <Network>host</Network>
   <Shell>sh</Shell>

package/dist/mind/prompt.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.flattenSystemPrompt = flattenSystemPrompt;
+exports.loadPsycheAt = loadPsycheAt;
 exports.resetPsycheCache = resetPsycheCache;
 exports.buildSessionSummary = buildSessionSummary;
 exports.bodyMapSection = bodyMapSection;
@@ -62,6 +63,7 @@ exports.rhythmStatusSection = rhythmStatusSection;
 exports.buildSystem = buildSystem;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
 const core_1 = require("../heart/core");
 const ouro_version_manager_1 = require("../heart/versioning/ouro-version-manager");
 const tools_1 = require("../repertoire/tools");
@@ -94,9 +96,40 @@ function flattenSystemPrompt(sp) {
     const parts = [sp.stable, sp.volatile].filter(Boolean);
     return parts.join("\n\n");
 }
-// Lazy-loaded psyche text cache, scoped by agent root. The daemon can host
-// multiple agents, so identity text must never be cached process-wide.
-let _psycheCache = null;
+// Psyche text cache, one entry per agent root (the daemon can host several agents). An entry is good only while
+// the files it was read from are unchanged: every load hashes their content, so an edit by the agent, its owner or
+// a sync pull takes effect on the very next prompt build. Content, not mtime or inode, because those are unreliable
+// on FUSE shares such as Unraid's /mnt/user; the files are small, so hashing them is cheap.
+const _psycheCache = new Map();
+const PSYCHE_SOURCE_FILES = {
+    soul: ["psyche", "SOUL.md"],
+    identity: ["psyche", "IDENTITY.md"],
+    lore: ["psyche", "LORE.md"],
+    tacitKnowledge: ["psyche", "TACIT.md"],
+    aspirations: ["psyche", "ASPIRATIONS.md"],
+    house: ["house", "HOUSE.md"],
+    houseNames: ["house", "house.json"],
+};
+/** Every file the psyche is built from, read once; null when a file is absent or unreadable. */
+function readPsycheSources(agentRoot) {
+    const sources = {};
+    for (const [key, parts] of Object.entries(PSYCHE_SOURCE_FILES)) {
+        try {
+            sources[key] = String(fs.readFileSync(path.join(agentRoot, ...parts), "utf-8"));
+        }
+        catch {
+            sources[key] = null;
+        }
+    }
+    return sources;
+}
+/** A content hash of the sources; an absent file hashes differently from an empty one. */
+function psycheFingerprint(sources) {
+    const hash = (0, crypto_1.createHash)("sha256");
+    for (const text of Object.values(sources))
+        hash.update(text === null ? "-" : `+${text.length}:${text}`);
+    return hash.digest("hex");
+}
 // A household install names its owner, its Butler and its home in house/house.json,
 // a file the package never overwrites. The packaged psyche writes {{owner}}, {{butler}}
 // and {{household}} where those names go, so one psyche serves every household.
@@ -105,59 +138,48 @@ const HOUSE_NAME_DEFAULTS = {
     butler: "the Butler",
     household: "the household",
 };
-function loadHouseNames(agentRoot) {
+function parseHouseNames(text) {
+    const names = { ...HOUSE_NAME_DEFAULTS };
     try {
-        const parsed = JSON.parse(fs.readFileSync(path.join(agentRoot, "house", "house.json"), "utf-8"));
-        const names = { ...HOUSE_NAME_DEFAULTS };
+        const parsed = JSON.parse(text ?? "");
         for (const [key, field] of [["owner", "ownerName"], ["butler", "butlerName"], ["household", "householdName"]]) {
             const value = parsed[field];
             if (typeof value === "string" && value.trim())
                 names[key] = value.trim();
         }
-        return names;
     }
     catch {
-        return { ...HOUSE_NAME_DEFAULTS };
+        // no house.json, or not JSON: the defaults stand
     }
+    return names;
 }
 function fillHouseNames(text, names) {
-    return text.replace(/\{\{(owner|butler|household)\}\}/gu, (_match, key) => names[key]);
-}
-function loadPsycheFile(agentRoot, name, names) {
-    try {
-        const psycheDir = path.join(agentRoot, "psyche");
-        return fillHouseNames(fs.readFileSync(path.join(psycheDir, name), "utf-8").trim(), names);
-    }
-    catch {
-        return "";
-    }
-}
-function loadHouseFile(agentRoot, names) {
-    try {
-        return fillHouseNames(fs.readFileSync(path.join(agentRoot, "house", "HOUSE.md"), "utf-8").trim(), names);
-    }
-    catch {
-        return "";
-    }
-}
-function loadPsyche() {
-    const agentRoot = (0, identity_1.getAgentRoot)();
-    if (_psycheCache?.agentRoot === agentRoot)
-        return _psycheCache.psyche;
-    const names = loadHouseNames(agentRoot);
+    return (text ?? "").trim().replace(/\{\{(owner|butler|household)\}\}/gu, (_match, key) => names[key]);
+}
+/** The psyche for one agent root. Each call reads its files once and rebuilds only when their content changed. */
+function loadPsycheAt(agentRoot) {
+    const sources = readPsycheSources(agentRoot);
+    const fingerprint = psycheFingerprint(sources);
+    const cached = _psycheCache.get(agentRoot);
+    if (cached?.fingerprint === fingerprint)
+        return cached.psyche;
+    const names = parseHouseNames(sources.houseNames);
     const psyche = {
-        soul: loadPsycheFile(agentRoot, "SOUL.md", names),
-        identity: loadPsycheFile(agentRoot, "IDENTITY.md", names),
-        lore: loadPsycheFile(agentRoot, "LORE.md", names),
-        tacitKnowledge: loadPsycheFile(agentRoot, "TACIT.md", names),
-        aspirations: loadPsycheFile(agentRoot, "ASPIRATIONS.md", names),
-        house: loadHouseFile(agentRoot, names),
+        soul: fillHouseNames(sources.soul, names),
+        identity: fillHouseNames(sources.identity, names),
+        lore: fillHouseNames(sources.lore, names),
+        tacitKnowledge: fillHouseNames(sources.tacitKnowledge, names),
+        aspirations: fillHouseNames(sources.aspirations, names),
+        house: fillHouseNames(sources.house, names),
     };
-    _psycheCache = { agentRoot, psyche };
+    _psycheCache.set(agentRoot, { fingerprint, psyche });
     return psyche;
 }
+function loadPsyche() {
+    return loadPsycheAt((0, identity_1.getAgentRoot)());
+}
 function resetPsycheCache() {
-    _psycheCache = null;
+    _psycheCache.clear();
 }
 const DEFAULT_ACTIVE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
 function buildSessionSummary(options) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.976",
+  "version": "0.1.0-alpha.978",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ouro.bot/cli",
-      "version": "0.1.0-alpha.976",
+      "version": "0.1.0-alpha.978",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.78.0",
         "@azure/identity": "^4.13.0",

package/package.json

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