@ouro.bot/cli 0.1.0-alpha.824 → 0.1.0-alpha.826

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.826",
+      "changes": [
+        "Sanctuary: a download sitting at zero bytes is reported as stalled rather than as progress, with a blocklist-and-research repair."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.825",
+      "changes": [
+        "Sanctuary: a single nested emphasis no longer makes a whole Butler reply render as literal asterisks."
+      ]
+    },
     {
       "version": "0.1.0-alpha.824",
       "changes": [

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

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

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

@@ -73,6 +73,10 @@ class ServiceError extends Error {
 }
 
 const seerr = (path, opts = {}) => req(SEERR.url, `/api/v1${path}`, { key: SEERR.apiKey, ...opts })
+// Long enough that an ordinary slow start is not called dead, short enough that
+// nobody waits a day for a release that was never going to arrive.
+const STALL_AFTER_HOURS = 6
+
 const sonarr = (path, opts = {}) => req(SONARR.url, `/api/v3${path}`, { key: SONARR.apiKey, ...opts })
 const radarr = (path, opts = {}) => req(RADARR.url, `/api/v3${path}`, { key: RADARR.apiKey, ...opts })
 const prowlarr = (path, opts = {}) => req(PROWLARR.url, `/api/v1${path}`, { key: PROWLARR.apiKey, ...opts })
@@ -427,14 +431,35 @@ async function mediaRequestStatus(a) {
   const byDownload = new Map()
   for (const r of queueRecs) byDownload.set(r.downloadId ?? `row:${r.id}`, r)
   const downloads = [...byDownload.values()]
+  const sizeLeft = downloads.reduce((s, r) => s + (r.sizeleft ?? 0), 0)
+  const sizeTotal = downloads.reduce((s, r) => s + (r.size ?? 0), 0)
+  // A torrent that has not moved a byte since it was grabbed is not slow, it is
+  // dead: no seeders, or a release the client cannot fetch. Radarr goes on
+  // reporting trackedDownloadStatus "ok" for these indefinitely, so a queue row
+  // on its own reads as healthy and any answer built from it reassures instead
+  // of acting. Measuring progress against age is what separates the two.
+  const now = Date.now()
+  const stalledItems = downloads
+    .filter((r) => (r.size ?? 0) > 0 && (r.sizeleft ?? 0) >= (r.size ?? 0) && r.added
+      && (now - Date.parse(r.added)) / 3_600_000 >= STALL_AFTER_HOURS)
+    .map((r) => ({
+      title: r.title ?? null,
+      added_at: r.added ?? null,
+      age_hours: Math.round((now - Date.parse(r.added)) / 3_600_000),
+      size_gb: Number(((r.size ?? 0) / 1073741824).toFixed(2)),
+      queue_id: r.id ?? null,
+    }))
   result.download = {
     active_downloads: downloads.length,
     active_items: queueRecs.length,
     states: [...new Set(downloads.map((r) => r.status))],
     tracked_states: [...new Set(downloads.map((r) => r.trackedDownloadState).filter(Boolean))],
     errors: [...new Set(downloads.map((r) => r.errorMessage).filter(Boolean))],
-    size_left_bytes: downloads.reduce((s, r) => s + (r.sizeleft ?? 0), 0),
-    size_total_bytes: downloads.reduce((s, r) => s + (r.size ?? 0), 0),
+    size_left_bytes: sizeLeft,
+    size_total_bytes: sizeTotal,
+    percent_complete: sizeTotal > 0 ? Math.round(((sizeTotal - sizeLeft) / sizeTotal) * 100) : null,
+    stalled: stalledItems.length > 0,
+    stalled_items: stalledItems,
   }
 
   const chain = await chainHealth()
@@ -453,6 +478,15 @@ function diagnose({ shelf, result, chain, entity, kind }) {
     return { stuck_stage: null, stuck_reason: null, likely_fix: null, human_action_required: false,
              summary: "On the shelf and complete. Nothing is stuck." }
   }
+  if (result.download.stalled) {
+    const items = result.download.stalled_items
+    const oldest = Math.max(...items.map((i) => i.age_hours))
+    return { stuck_stage: "download", stuck_reason: "stalled_no_progress",
+             likely_fix: "blocklist_and_research", human_action_required: false,
+             percent_complete: result.download.percent_complete,
+             detail: items,
+             summary: `Stalled, not slow. ${items.length === 1 ? "The release" : `${items.length} releases`} ${items.length === 1 ? "has" : "have"} not downloaded a single byte in ${oldest} hours, which means no seeders rather than a quiet queue. Waiting will not fix it; blocklist the release and search again for a different one.` }
+  }
   if (result.download.active_downloads > 0) {
     const left = result.download.size_left_bytes
     const total = result.download.size_total_bytes
@@ -528,9 +562,23 @@ async function mediaDiagnoseAndFix(a) {
       ? (action === "force_import_scan" ? { name: "RescanSeries", seriesId: svcId } : { name: "SeriesSearch", seriesId: svcId })
       : (action === "force_import_scan" ? { name: "RescanMovie", movieIds: [svcId] } : { name: "MoviesSearch", movieIds: [svcId] })
     commanded = kind === "series" ? await sonarr("/command", { method: "POST", body: cmd }) : await radarr("/command", { method: "POST", body: cmd })
+  } else if (action === "blocklist_and_research") {
+    // Removing with blocklist=true is what stops the same dead release being
+    // grabbed straight back. The search that follows is then free to pick a
+    // different one.
+    const stalled = before.download.stalled_items ?? []
+    if (!stalled.length) return { action, result: "nothing_to_blocklist", before, after: null, human_action_required: false,
+                                  human_action_reason: "No download has been sitting at zero long enough to call it stalled." }
+    for (const item of stalled) {
+      if (item.queue_id === null) continue
+      const client = kind === "series" ? sonarr : radarr
+      await client(`/queue/${item.queue_id}`, { method: "DELETE", query: { removeFromClient: true, blocklist: true, skipRedownload: true } })
+    }
+    const cmd = kind === "series" ? { name: "SeriesSearch", seriesId: svcId } : { name: "MoviesSearch", movieIds: [svcId] }
+    commanded = kind === "series" ? await sonarr("/command", { method: "POST", body: cmd }) : await radarr("/command", { method: "POST", body: cmd })
   } else {
     return { action, result: "unsupported_action", before, after: null, human_action_required: true,
-             human_action_reason: `Action "${action}" is not implemented. Supported: rescan, enable_monitoring, force_import_scan, report_only.` }
+             human_action_reason: `Action "${action}" is not implemented. Supported: rescan, enable_monitoring, force_import_scan, blocklist_and_research, report_only.` }
   }
 
   await new Promise((r) => setTimeout(r, 12_000))
@@ -553,6 +601,7 @@ function describeAction(action) {
     rescan: "Trigger a fresh indexer search and grab the best acceptable release.",
     enable_monitoring: "Mark it monitored, then search.",
     force_import_scan: "Re-scan the disk so an already-downloaded file gets imported.",
+    blocklist_and_research: "Blocklist the stalled release so it cannot be grabbed again, then search for a different one.",
     report_only: "Report only; change nothing.",
   }[action] ?? "Unknown action."
 }
@@ -625,7 +674,7 @@ const TOOLS = [
   },
   {
     name: "media_request_status",
-    description: "One call, every stage: request, indexer search, download, file on disk, plus acquisition-chain health and a deterministic `diagnosis` block naming what is stuck, why, and the fix. Use this for any 'is it here yet?' or 'why hasn't X downloaded?' question. Never infer the cause yourself — read diagnosis.summary.",
+    description: "One call, every stage: request, indexer search, download, file on disk, plus acquisition-chain health and a deterministic `diagnosis` block naming what is stuck, why, and the fix. Use this for any 'is it here yet?' or 'why hasn't X downloaded?' question. A queue row is not proof of progress: a release sitting at zero bytes comes back as stalled, not as downloading. Never infer the cause yourself — read diagnosis.summary.",
     inputSchema: { type: "object", properties: {
       request_id: { type: "string", description: "e.g. jellyseerr:42" },
       tmdb_id: { type: "number" },
@@ -634,10 +683,10 @@ const TOOLS = [
   },
   {
     name: "media_diagnose_and_fix",
-    description: "Act on a stuck request. Omit `action` to apply the fix that media_request_status already identified. Refuses to act (result 'rejected_fix_unsafe') when the acquisition chain itself is down, because re-searching cannot help then. Use dry_run to preview.",
+    description: "Act on a stuck request. Omit `action` to apply the fix that media_request_status already identified, including 'blocklist_and_research' for a release that has stalled at zero bytes. Refuses to act (result 'rejected_fix_unsafe') when the acquisition chain itself is down, because re-searching cannot help then. Use dry_run to preview.",
     inputSchema: { type: "object", properties: {
       request_id: { type: "string" }, tmdb_id: { type: "number" }, title: { type: "string" },
-      action: { type: "string", enum: ["rescan", "enable_monitoring", "force_import_scan", "report_only"] },
+      action: { type: "string", enum: ["rescan", "enable_monitoring", "force_import_scan", "blocklist_and_research", "report_only"] },
       dry_run: { type: "boolean" },
     } },
   },

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

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

@@ -76,25 +76,54 @@ function preparedTexts(effect) {
         return [requireText(effect.text, "Telegram text")];
     return [effect.text?.trim() || null];
 }
+// Bold spans may carry one level of emphasis inside them, because `**bold with
+// *italic* inside**` is ordinary model prose. The inner span is rendered by the
+// same conservative scan, so a bold run that does not resolve cleanly still
+// degrades the whole message to literal text rather than emitting partial
+// markup. Everything else stays as strict as before: a span must open on a
+// letter or digit and close on a non-space, which is what keeps `**/src/**`,
+// `2 ** 3` and `a_b_c` literal.
+const TELEGRAM_BOLD_WITH_NESTING = /`([^`\n]+)`|\*\*([\p{L}\p{N}](?:[^*_`\n]|\*(?!\*)|_)*\S|[\p{L}\p{N}])\*\*|\*([\p{L}\p{N}](?:[^*_`\n]*\S)?)\*|_([\p{L}\p{N}](?:[^*_`\n]*\S)?)_/gu;
+const TELEGRAM_EMPHASIS_ONLY = /`([^`\n]+)`|\*([\p{L}\p{N}](?:[^*_`\n]*\S)?)\*|_([\p{L}\p{N}](?:[^*_`\n]*\S)?)_/gu;
 function renderTelegramButlerHtml(text) {
+    return renderTelegramStyledSpan(text, true) ?? (0, telegram_client_1.escapeTelegramHtml)(text);
+}
+// Returns null when the span cannot be rendered cleanly, so every caller falls
+// back to escaping rather than emitting half-applied markup.
+function renderTelegramStyledSpan(text, allowBold) {
     let html = "";
     let cursor = 0;
-    const styledText = /`([^`\n]+)`|\*\*([\p{L}\p{N}](?:[^*_`\n]*\S)?)\*\*|\*([\p{L}\p{N}](?:[^*_`\n]*\S)?)\*|_([\p{L}\p{N}](?:[^*_`\n]*\S)?)_/gu;
-    for (const match of text.matchAll(styledText)) {
+    const pattern = allowBold ? TELEGRAM_BOLD_WITH_NESTING : TELEGRAM_EMPHASIS_ONLY;
+    pattern.lastIndex = 0;
+    for (const match of text.matchAll(pattern)) {
         const gap = text.slice(cursor, match.index);
         if (/[*_`]/u.test(gap))
-            return (0, telegram_client_1.escapeTelegramHtml)(text);
+            return null;
         html += (0, telegram_client_1.escapeTelegramHtml)(gap);
-        if (match[1] !== undefined)
-            html += `<code>${(0, telegram_client_1.escapeTelegramHtml)(match[1])}</code>`;
-        else if (match[2] !== undefined || match[3] !== undefined)
-            html += `<b>${(0, telegram_client_1.escapeTelegramHtml)((match[2] ?? match[3]))}</b>`;
+        const code = match[1];
+        const bold = allowBold ? match[2] : undefined;
+        const italic = allowBold ? match[3] : match[2];
+        const underscored = allowBold ? match[4] : match[3];
+        if (code !== undefined)
+            html += `<code>${(0, telegram_client_1.escapeTelegramHtml)(code)}</code>`;
+        else if (bold !== undefined) {
+            const inner = renderTelegramStyledSpan(bold, false);
+            if (inner === null)
+                return null;
+            html += `<b>${inner}</b>`;
+            // A single-marker span is bold at the top level, which is the long-standing
+            // convention here, but inside a bold run it is the nested emphasis the
+            // author meant - and nesting <b> in <b> would be markup Telegram has no
+            // reason to accept.
+        }
+        else if (italic !== undefined)
+            html += allowBold ? `<b>${(0, telegram_client_1.escapeTelegramHtml)(italic)}</b>` : `<i>${(0, telegram_client_1.escapeTelegramHtml)(italic)}</i>`;
         else
-            html += `<i>${(0, telegram_client_1.escapeTelegramHtml)(match[4])}</i>`;
+            html += `<i>${(0, telegram_client_1.escapeTelegramHtml)(underscored)}</i>`;
         cursor = match.index + match[0].length;
     }
     const tail = text.slice(cursor);
-    return /[*_`]/u.test(tail) ? (0, telegram_client_1.escapeTelegramHtml)(text) : html + (0, telegram_client_1.escapeTelegramHtml)(tail);
+    return /[*_`]/u.test(tail) ? null : html + (0, telegram_client_1.escapeTelegramHtml)(tail);
 }
 function assertEffectTarget(target, effect, idempotencyKey) {
     if (target.kind === "admission_gate") {

package/npm-shrinkwrap.json

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