@ouro.bot/cli 0.1.0-alpha.869 → 0.1.0-alpha.870

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.870",
+      "changes": [
+        "Await ticks now say whether my owner was asked about this await (read from the runtime ask ledger for this await instance, never from model text) and that awaiting a decision is not true when they never were, and the ask_owner guidance counts a stall marked owner_decision_needed; media_queue marks confirmed stalls (no_peers, never_started, unfinished_for_days) with owner_decision_needed, likely_fix ask_owner and the keep_waiting, find_another_release, give_up choices shared with the diagnosis."
+      ]
+    },
     {
       "version": "0.1.0-alpha.869",
       "changes": [

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

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

package/deploy/unraid/sanctuary.ouro/mcp/media-mcp.mjs

@@ -611,6 +611,9 @@ const rowPercent = (r) => ((r.size ?? 0) > 0 ? Math.round((((r.size ?? 0) - (r.s
 // surfaces. `previous` is the persisted progress memory for this download (or undefined).
 // Returns null while the download may still be moving; otherwise the kind, whether the stall
 // is confirmed (only confirmed stalls are acted on) and the facts the owner is told.
+// The owner's three choices when a download is confirmed dead; one source for every surface that asks.
+export const STALL_OWNER_CHOICES = ["keep_waiting", "find_another_release", "give_up"]
+
 export function classifyStall(row, nowMs, previous) {
   const why = stallReason(row, nowMs, previous)
   if (!why) return null
@@ -689,7 +692,7 @@ export function diagnose({ shelf, result, chain, entity, kind }) {
       })
       return { stuck_stage: "download", stuck_reason: "stalled_partial_download",
                likely_fix: "ask_owner", human_action_required: true,
-               choices: ["keep_waiting", "find_another_release", "give_up"],
+               choices: STALL_OWNER_CHOICES,
                percent_complete: result.download.percent_complete,
                detail: items,
                ...(neverStarted.length ? { never_started: { likely_fix: "blocklist_and_research", items: neverStarted } } : {}),
@@ -762,7 +765,7 @@ async function mediaDiagnoseAndFix(a) {
   }
   if (action === "ask_owner") {
     return { action, result: "owner_decision_needed", before, after: null, human_action_required: true,
-             choices: before.diagnosis?.choices ?? ["keep_waiting", "find_another_release", "give_up"],
+             choices: before.diagnosis?.choices ?? STALL_OWNER_CHOICES,
              ...(before.diagnosis?.never_started ? { never_started: before.diagnosis.never_started } : {}),
              human_action_reason: before.diagnosis?.summary ?? "The owner decides." }
   }
@@ -939,7 +942,8 @@ export function queueRowView(r, nowMs, previous) {
     percent: pct(r), timeleft: r.timeleft ?? null, size_left_bytes: r.sizeleft ?? 0, size_bytes: r.size ?? 0,
     protocol: r.protocol ?? null, download_client: r.downloadClient ?? null, indexer: r.indexer ?? null,
     added: r.added ?? null, stalled: Boolean(c?.confirmed),
-    ...(c ? { stall: { kind: c.kind, state: c.state, percent_complete: c.percent_complete, age_hours: c.age_hours, no_eta: c.no_eta, unchanged_since: c.unchanged_since } } : {}),
+    ...(c ? { stall: { kind: c.kind, state: c.state, percent_complete: c.percent_complete, age_hours: c.age_hours, no_eta: c.no_eta, unchanged_since: c.unchanged_since,
+      ...(c.confirmed ? { owner_decision_needed: true, likely_fix: "ask_owner", choices: STALL_OWNER_CHOICES } : {}) } } : {}),
     ...(r.errorMessage ? { error_message: String(r.errorMessage).slice(0, 300) } : {}),
   }
 }

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.869</Repository>
+  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.870</Repository>
   <Registry>https://github.com/ourostack/ouroboros/pkgs/container/ouroboros-butler</Registry>
   <Network>host</Network>
   <Shell>sh</Shell>

package/dist/repertoire/tools-awaiting.js

@@ -37,6 +37,7 @@ exports.awaitingToolDefinitions = void 0;
 exports.readAwaitDefinition = readAwaitDefinition;
 exports.setAwaitToolDeps = setAwaitToolDeps;
 exports.resetAwaitToolDeps = resetAwaitToolDeps;
+exports.readOwnerAskForAwait = readOwnerAskForAwait;
 exports.cancelAwaitTool = cancelAwaitTool;
 exports.cancelStaleAwait = cancelStaleAwait;
 exports.isBrokenBindingReason = isBrokenBindingReason;
@@ -187,6 +188,37 @@ function recordAsk(agentRoot, entry) {
     fs.mkdirSync(awaitingDir(agentRoot), { recursive: true });
     fs.appendFileSync(askLedgerPath(agentRoot), `${JSON.stringify(entry)}\n`, "utf-8");
 }
+/**
+ * The most recent time the owner was asked about this await instance, read from the runtime ask ledger (never from model text).
+ * An instance is the await name filed at `createdAt`; an ask recorded before that belongs to an earlier use of the name.
+ */
+function readOwnerAskForAwait(agentRoot, name, createdAt) {
+    let raw;
+    try {
+        raw = fs.readFileSync(askLedgerPath(agentRoot), "utf-8");
+    }
+    catch {
+        return null;
+    }
+    const createdMs = createdAt ? Date.parse(createdAt) : Number.NaN;
+    let found = null;
+    for (const line of raw.split("\n")) {
+        try {
+            const entry = JSON.parse(line);
+            if (entry.name !== name || typeof entry.at !== "string")
+                continue;
+            const atMs = Date.parse(entry.at);
+            if (!Number.isFinite(atMs) || (Number.isFinite(createdMs) && atMs < createdMs))
+                continue;
+            if (!found || atMs >= Date.parse(found.at))
+                found = { at: entry.at, question: typeof entry.question === "string" && entry.question.length > 0 ? entry.question : null };
+        }
+        catch {
+            continue;
+        }
+    }
+    return found;
+}
 function recentAskCount(agentRoot, filer, now) {
     let raw;
     try {
@@ -286,7 +318,7 @@ async function askOwnerTool(name, observation, question, choices, existing, agen
         /* v8 ignore next -- defensive: archiveAwait only fails on the file-disappears-mid-call race already covered by v8 ignore inside archiveAwait @preserve */
         if (!archive.ok)
             return JSON.stringify({ error: archive.error });
-        recordAsk(agentRoot, { filer: filerId, name, at: askedAt });
+        recordAsk(agentRoot, { filer: filerId, name, at: askedAt, question: parsed.question });
         if (!tellsFriend || delivered(friendNotice))
             fulfillAwaitObligation(agentRoot, archive.file);
         (0, runtime_1.emitNervesEvent)({

package/dist/senses/await-turn-message.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildAwaitTurnMessage = buildAwaitTurnMessage;
 const runtime_1 = require("../nerves/runtime");
+const WAITING_ON_OWNER = /\b(await(ing)?|wait(ing)?)\b[^.]{0,40}\b(ari|owner|decision|decide|choice)\b|\bdecision\b/i;
 function formatElapsed(ms) {
     if (ms < 60_000)
         return "<1m ago";
@@ -48,12 +49,17 @@ function buildAwaitTurnMessage(options) {
         lines.push("");
         lines.push(`history: checked ${options.checkedCount}x so far. last checked ${age ?? "(unknown)"}. ${obs}.`);
     }
+    const ask = options.ownerAsk ?? null;
+    lines.push(ask ? `owner asked: ${ask.at}${ask.question ? ` ("${ask.question}")` : ""}` : "owner asked: never");
+    if (!ask && options.lastObservation && WAITING_ON_OWNER.test(options.lastObservation)) {
+        lines.push("my owner has not been asked about this await, so \"awaiting a decision\" is not true. if the download is confirmed stalled, or media_queue marks it owner_decision_needed, ask now with verdict 'ask_owner'.");
+    }
     if (options.checkpoint) {
         lines.push("");
         lines.push(`last checkpoint: ${options.checkpoint}`);
     }
     lines.push("");
     lines.push("look around and decide. if the condition is met, call resolve_await with verdict='yes' and a one-line observation. otherwise call resolve_await with verdict='no' and a one-line observation of what i saw this tick.");
-    lines.push("verdicts: 'yes' (condition met), 'no' (not yet or unsure), 'ask_owner' (only when the condition cannot be met without my owner deciding, e.g. a confirmed dead download; give a plain question and 2-4 choices).");
+    lines.push("verdicts: 'yes' (condition met), 'no' (not yet or unsure), 'ask_owner' (only when the condition cannot be met without my owner deciding, e.g. a confirmed dead download, or a stall the tool marks owner_decision_needed; give a plain question and 2-4 choices).");
     return lines.join("\n");
 }

package/dist/senses/private-runtime.js

@@ -1194,6 +1194,7 @@ async function runPrivateRuntimeTurn(options) {
                             // No checkpoint: every await shares one private-runtime session, so its last assistant text is whatever the previous
                             // (possibly different) await's tick said. An await's own state is its last observation and checked count.
                             checkpoint: undefined,
+                            ownerAsk: (0, tools_awaiting_1.readOwnerAskForAwait)(agentRoot, awaitName, parsedAwait?.created_at ?? null),
                             now,
                         });
                     }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.869",
+  "version": "0.1.0-alpha.870",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ouro.bot/cli",
-      "version": "0.1.0-alpha.869",
+      "version": "0.1.0-alpha.870",
       "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.869",
+  "version": "0.1.0-alpha.870",
   "engines": {
     "node": ">=22"
   },