oh-my-opencode 3.0.0-beta.1 → 3.0.0-beta.3

package/dist/index.js

@@ -19567,6 +19567,18 @@ async function runBunInstallWithDetails() {
 
 // src/hooks/auto-update-checker/index.ts
 var SISYPHUS_SPINNER = ["\xB7", "\u2022", "\u25CF", "\u25CB", "\u25CC", "\u25E6", " "];
+function isPrereleaseVersion(version) {
+  return version.includes("-");
+}
+function isDistTag(version) {
+  const startsWithDigit = /^\d/.test(version);
+  return !startsWithDigit;
+}
+function isPrereleaseOrDistTag(pinnedVersion) {
+  if (!pinnedVersion)
+    return false;
+  return isPrereleaseVersion(pinnedVersion) || isDistTag(pinnedVersion);
+}
 function createAutoUpdateCheckerHook(ctx, options = {}) {
   const { showStartupToast = true, isSisyphusEnabled = false, autoUpdate = true } = options;
   const getToastMessage = (isUpdate, latestVersion) => {
@@ -19637,7 +19649,15 @@ async function runBackgroundUpdateCheck(ctx, autoUpdate, getToastMessage) {
     log("[auto-update-checker] Auto-update disabled, notification only");
     return;
   }
+  if (isPrereleaseVersion(currentVersion)) {
+    log(`[auto-update-checker] Skipping auto-update for prerelease version: ${currentVersion}`);
+    return;
+  }
   if (pluginInfo.isPinned) {
+    if (isPrereleaseOrDistTag(pluginInfo.pinnedVersion)) {
+      log(`[auto-update-checker] Skipping auto-update for prerelease/dist-tag: ${pluginInfo.pinnedVersion}`);
+      return;
+    }
     const updated = updatePinnedVersion(pluginInfo.configPath, pluginInfo.entry, latestVersion);
     if (!updated) {
       await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
@@ -19755,6 +19775,8 @@ var TARGET_TOOLS = new Set([
   "safe_glob",
   "webfetch",
   "context7_resolve-library-id",
+  "context7_query-docs",
+  "websearch_web_search_exa",
   "context7_get-library-docs",
   "grep_app_searchgithub"
 ]);
@@ -44131,8 +44153,8 @@ Session ID: ${task.sessionID}
 
 (No messages found)`;
   }
-  const assistantMessages = messages.filter((m2) => m2.info?.role === "assistant");
-  if (assistantMessages.length === 0) {
+  const relevantMessages = messages.filter((m2) => m2.info?.role === "assistant" || m2.info?.role === "tool");
+  if (relevantMessages.length === 0) {
     return `Task Result
 
 Task ID: ${task.id}
@@ -44142,11 +44164,34 @@ Session ID: ${task.sessionID}
 
 ---
 
-(No assistant response found)`;
+(No assistant or tool response found)`;
   }
-  const lastMessage = assistantMessages[assistantMessages.length - 1];
-  const textParts = lastMessage?.parts?.filter((p2) => p2.type === "text") ?? [];
-  const textContent = textParts.map((p2) => p2.text ?? "").filter((text) => text.length > 0).join(`
+  const sortedMessages = [...relevantMessages].sort((a, b3) => {
+    const timeA = String(a.info?.time ?? "");
+    const timeB = String(b3.info?.time ?? "");
+    return timeA.localeCompare(timeB);
+  });
+  const extractedContent = [];
+  for (const message of sortedMessages) {
+    for (const part of message.parts ?? []) {
+      if ((part.type === "text" || part.type === "reasoning") && part.text) {
+        extractedContent.push(part.text);
+      } else if (part.type === "tool_result") {
+        const toolResult = part;
+        if (typeof toolResult.content === "string" && toolResult.content) {
+          extractedContent.push(toolResult.content);
+        } else if (Array.isArray(toolResult.content)) {
+          for (const block of toolResult.content) {
+            if ((block.type === "text" || block.type === "reasoning") && block.text) {
+              extractedContent.push(block.text);
+            }
+          }
+        }
+      }
+    }
+  }
+  const textContent = extractedContent.filter((text) => text.length > 0).join(`
+
 `);
   const duration3 = formatDuration(task.startedAt, task.completedAt);
   return `Task Result
@@ -44409,19 +44454,43 @@ session_id: ${sessionID}
   }
   const messages = messagesResult.data;
   log(`[call_omo_agent] Got ${messages.length} messages`);
-  const lastAssistantMessage = messages.filter((m2) => m2.info.role === "assistant").sort((a, b3) => (b3.info.time?.created || 0) - (a.info.time?.created || 0))[0];
-  if (!lastAssistantMessage) {
-    log(`[call_omo_agent] No assistant message found`);
+  const relevantMessages = messages.filter((m2) => m2.info?.role === "assistant" || m2.info?.role === "tool");
+  if (relevantMessages.length === 0) {
+    log(`[call_omo_agent] No assistant or tool messages found`);
     log(`[call_omo_agent] All messages:`, JSON.stringify(messages, null, 2));
-    return `Error: No assistant response found
+    return `Error: No assistant or tool response found
 
 <task_metadata>
 session_id: ${sessionID}
 </task_metadata>`;
   }
-  log(`[call_omo_agent] Found assistant message with ${lastAssistantMessage.parts.length} parts`);
-  const textParts = lastAssistantMessage.parts.filter((p2) => p2.type === "text");
-  const responseText = textParts.map((p2) => p2.text).join(`
+  log(`[call_omo_agent] Found ${relevantMessages.length} relevant messages`);
+  const sortedMessages = [...relevantMessages].sort((a, b3) => {
+    const timeA = a.info?.time?.created ?? 0;
+    const timeB = b3.info?.time?.created ?? 0;
+    return timeA - timeB;
+  });
+  const extractedContent = [];
+  for (const message of sortedMessages) {
+    for (const part of message.parts ?? []) {
+      if ((part.type === "text" || part.type === "reasoning") && part.text) {
+        extractedContent.push(part.text);
+      } else if (part.type === "tool_result") {
+        const toolResult = part;
+        if (typeof toolResult.content === "string" && toolResult.content) {
+          extractedContent.push(toolResult.content);
+        } else if (Array.isArray(toolResult.content)) {
+          for (const block of toolResult.content) {
+            if ((block.type === "text" || block.type === "reasoning") && block.text) {
+              extractedContent.push(block.text);
+            }
+          }
+        }
+      }
+    }
+  }
+  const responseText = extractedContent.filter((text) => text.length > 0).join(`
+
 `);
   log(`[call_omo_agent] Got response, length: ${responseText.length}`);
   const output = responseText + `
@@ -44856,6 +44925,29 @@ Use \`background_output\` with task_id="${task.id}" to check progress.`;
 
 Session ID: ${args.resume}`;
         }
+        const POLL_INTERVAL_MS = 500;
+        const MIN_STABILITY_TIME_MS = 5000;
+        const STABILITY_POLLS_REQUIRED = 3;
+        const pollStart = Date.now();
+        let lastMsgCount = 0;
+        let stablePolls = 0;
+        while (Date.now() - pollStart < 60000) {
+          await new Promise((resolve8) => setTimeout(resolve8, POLL_INTERVAL_MS));
+          const elapsed = Date.now() - pollStart;
+          if (elapsed < MIN_STABILITY_TIME_MS)
+            continue;
+          const messagesCheck = await client2.session.messages({ path: { id: args.resume } });
+          const msgs = messagesCheck.data ?? messagesCheck;
+          const currentMsgCount = msgs.length;
+          if (currentMsgCount > 0 && currentMsgCount === lastMsgCount) {
+            stablePolls++;
+            if (stablePolls >= STABILITY_POLLS_REQUIRED)
+              break;
+          } else {
+            stablePolls = 0;
+            lastMsgCount = currentMsgCount;
+          }
+        }
         const messagesResult = await client2.session.messages({
           path: { id: args.resume }
         });
@@ -44878,7 +44970,7 @@ Session ID: ${args.resume}`;
 
 Session ID: ${args.resume}`;
         }
-        const textParts = lastMessage?.parts?.filter((p2) => p2.type === "text") ?? [];
+        const textParts = lastMessage?.parts?.filter((p2) => p2.type === "text" || p2.type === "reasoning") ?? [];
         const textContent = textParts.map((p2) => p2.text ?? "").filter(Boolean).join(`
 `);
         const duration3 = formatDuration2(startTime);
@@ -44992,11 +45084,10 @@ System notifies on completion. Use \`background_output\` with task_id="${task.id
           metadata: { sessionId: sessionID, category: args.category, sync: true }
         });
         let promptError;
-        await client2.session.promptAsync({
+        client2.session.prompt({
           path: { id: sessionID },
           body: {
             agent: agentToUse,
-            model: categoryModel,
             system: systemContent,
             tools: {
               task: false,
@@ -45007,6 +45098,7 @@ System notifies on completion. Use \`background_output\` with task_id="${task.id
         }).catch((error45) => {
           promptError = error45 instanceof Error ? error45 : new Error(String(error45));
         });
+        await new Promise((resolve8) => setTimeout(resolve8, 100));
         if (promptError) {
           if (toastManager && taskId !== undefined) {
             toastManager.removeTask(taskId);
@@ -45023,14 +45115,51 @@ Session ID: ${sessionID}`;
         }
         const POLL_INTERVAL_MS = 500;
         const MAX_POLL_TIME_MS = 10 * 60 * 1000;
+        const MIN_STABILITY_TIME_MS = 1e4;
+        const STABILITY_POLLS_REQUIRED = 3;
         const pollStart = Date.now();
+        let lastMsgCount = 0;
+        let stablePolls = 0;
         while (Date.now() - pollStart < MAX_POLL_TIME_MS) {
           await new Promise((resolve8) => setTimeout(resolve8, POLL_INTERVAL_MS));
+          const asyncError = promptError;
+          if (asyncError) {
+            if (toastManager && taskId !== undefined) {
+              toastManager.removeTask(taskId);
+            }
+            const errorMessage = asyncError.message;
+            if (errorMessage.includes("agent.name") || errorMessage.includes("undefined")) {
+              return `\u274C Agent "${agentToUse}" not found. Make sure the agent is registered in your opencode.json or provided by a plugin.
+
+Session ID: ${sessionID}`;
+            }
+            return `\u274C Failed to send prompt: ${errorMessage}
+
+Session ID: ${sessionID}`;
+          }
           const statusResult = await client2.session.status();
           const allStatuses = statusResult.data ?? {};
           const sessionStatus = allStatuses[sessionID];
-          if (!sessionStatus || sessionStatus.type === "idle") {
-            break;
+          if (sessionStatus && sessionStatus.type !== "idle") {
+            stablePolls = 0;
+            lastMsgCount = 0;
+            continue;
+          }
+          const elapsed = Date.now() - pollStart;
+          if (elapsed < MIN_STABILITY_TIME_MS) {
+            continue;
+          }
+          const messagesCheck = await client2.session.messages({ path: { id: sessionID } });
+          const msgs = messagesCheck.data ?? messagesCheck;
+          const currentMsgCount = msgs.length;
+          if (currentMsgCount > 0 && currentMsgCount === lastMsgCount) {
+            stablePolls++;
+            if (stablePolls >= STABILITY_POLLS_REQUIRED) {
+              break;
+            }
+          } else {
+            stablePolls = 0;
+            lastMsgCount = currentMsgCount;
           }
         }
         const messagesResult = await client2.session.messages({
@@ -45049,7 +45178,7 @@ Session ID: ${sessionID}`;
 
 Session ID: ${sessionID}`;
         }
-        const textParts = lastMessage?.parts?.filter((p2) => p2.type === "text") ?? [];
+        const textParts = lastMessage?.parts?.filter((p2) => p2.type === "text" || p2.type === "reasoning") ?? [];
         const textContent = textParts.map((p2) => p2.text ?? "").filter(Boolean).join(`
 `);
         const duration3 = formatDuration2(startTime);
@@ -45171,10 +45300,12 @@ class ConcurrencyManager {
 
 // src/features/background-agent/manager.ts
 var TASK_TTL_MS = 30 * 60 * 1000;
+var MIN_STABILITY_TIME_MS = 10 * 1000;
 
 class BackgroundManager {
   tasks;
   notifications;
+  pendingByParent;
   client;
   directory;
   pollingInterval;
@@ -45182,11 +45313,18 @@ class BackgroundManager {
   constructor(ctx, config3) {
     this.tasks = new Map;
     this.notifications = new Map;
+    this.pendingByParent = new Map;
     this.client = ctx.client;
     this.directory = ctx.directory;
     this.concurrencyManager = new ConcurrencyManager(config3);
   }
   async launch(input) {
+    log("[background-agent] launch() called with:", {
+      agent: input.agent,
+      model: input.model,
+      description: input.description,
+      parentSessionID: input.parentSessionID
+    });
     if (!input.agent || input.agent.trim() === "") {
       throw new Error("Agent parameter is required");
     }
@@ -45228,6 +45366,9 @@ class BackgroundManager {
     };
     this.tasks.set(task.id, task);
     this.startPolling();
+    const pending = this.pendingByParent.get(input.parentSessionID) ?? new Set;
+    pending.add(task.id);
+    this.pendingByParent.set(input.parentSessionID, pending);
     log("[background-agent] Launching task:", { taskId: task.id, sessionID, agent: input.agent });
     const toastManager = getTaskToastManager();
     if (toastManager) {
@@ -45239,10 +45380,18 @@ class BackgroundManager {
         skills: input.skills
       });
     }
-    this.client.session.promptAsync({
+    log("[background-agent] Calling prompt (fire-and-forget) for launch with:", {
+      sessionID,
+      agent: input.agent,
+      model: input.model,
+      hasSkillContent: !!input.skillContent,
+      promptLength: input.prompt.length
+    });
+    this.client.session.prompt({
       path: { id: sessionID },
       body: {
         agent: input.agent,
+        ...input.model ? { model: input.model } : {},
         system: input.skillContent,
         tools: {
           task: false,
@@ -45266,7 +45415,9 @@ class BackgroundManager {
           this.concurrencyManager.release(existingTask.concurrencyKey);
         }
         this.markForNotification(existingTask);
-        this.notifyParentSession(existingTask);
+        this.notifyParentSession(existingTask).catch((err) => {
+          log("[background-agent] Failed to notify on error:", err);
+        });
       }
     });
     return task;
@@ -45315,11 +45466,15 @@ class BackgroundManager {
       progress: {
         toolCalls: 0,
         lastUpdate: new Date
-      }
+      },
+      parentAgent: input.parentAgent
     };
     this.tasks.set(task.id, task);
     subagentSessions.add(input.sessionID);
     this.startPolling();
+    const pending = this.pendingByParent.get(input.parentSessionID) ?? new Set;
+    pending.add(task.id);
+    this.pendingByParent.set(input.parentSessionID, pending);
     log("[background-agent] Registered external task:", { taskId: task.id, sessionID: input.sessionID });
     return task;
   }
@@ -45341,6 +45496,9 @@ class BackgroundManager {
     };
     this.startPolling();
     subagentSessions.add(existingTask.sessionID);
+    const pending = this.pendingByParent.get(input.parentSessionID) ?? new Set;
+    pending.add(existingTask.id);
+    this.pendingByParent.set(input.parentSessionID, pending);
     const toastManager = getTaskToastManager();
     if (toastManager) {
       toastManager.addTask({
@@ -45351,7 +45509,12 @@ class BackgroundManager {
       });
     }
     log("[background-agent] Resuming task:", { taskId: existingTask.id, sessionID: existingTask.sessionID });
-    this.client.session.promptAsync({
+    log("[background-agent] Resuming task - calling prompt (fire-and-forget) with:", {
+      sessionID: existingTask.sessionID,
+      agent: existingTask.agent,
+      promptLength: input.prompt.length
+    });
+    this.client.session.prompt({
       path: { id: existingTask.sessionID },
       body: {
         agent: existingTask.agent,
@@ -45362,13 +45525,15 @@ class BackgroundManager {
         parts: [{ type: "text", text: input.prompt }]
       }
     }).catch((error45) => {
-      log("[background-agent] resume promptAsync error:", error45);
+      log("[background-agent] resume prompt error:", error45);
       existingTask.status = "error";
       const errorMessage = error45 instanceof Error ? error45.message : String(error45);
       existingTask.error = errorMessage;
       existingTask.completedAt = new Date;
       this.markForNotification(existingTask);
-      this.notifyParentSession(existingTask);
+      this.notifyParentSession(existingTask).catch((err) => {
+        log("[background-agent] Failed to notify on resume error:", err);
+      });
     });
     return existingTask;
   }
@@ -45417,7 +45582,18 @@ class BackgroundManager {
       const task = this.findBySession(sessionID);
       if (!task || task.status !== "running")
         return;
-      this.checkSessionTodos(sessionID).then((hasIncompleteTodos2) => {
+      const elapsedMs = Date.now() - task.startedAt.getTime();
+      const MIN_IDLE_TIME_MS = 5000;
+      if (elapsedMs < MIN_IDLE_TIME_MS) {
+        log("[background-agent] Ignoring early session.idle, elapsed:", { elapsedMs, taskId: task.id });
+        return;
+      }
+      this.validateSessionHasOutput(sessionID).then(async (hasValidOutput) => {
+        if (!hasValidOutput) {
+          log("[background-agent] Session.idle but no valid output yet, waiting:", task.id);
+          return;
+        }
+        const hasIncompleteTodos2 = await this.checkSessionTodos(sessionID);
         if (hasIncompleteTodos2) {
           log("[background-agent] Task has incomplete todos, waiting for todo-continuation:", task.id);
           return;
@@ -45425,8 +45601,10 @@ class BackgroundManager {
         task.status = "completed";
         task.completedAt = new Date;
         this.markForNotification(task);
-        this.notifyParentSession(task);
+        await this.notifyParentSession(task);
         log("[background-agent] Task completed via session.idle event:", task.id);
+      }).catch((err) => {
+        log("[background-agent] Error in session.idle handler:", err);
       });
     }
     if (event.type === "session.deleted") {
@@ -45461,6 +45639,33 @@ class BackgroundManager {
   clearNotifications(sessionID) {
     this.notifications.delete(sessionID);
   }
+  async validateSessionHasOutput(sessionID) {
+    try {
+      const response2 = await this.client.session.messages({
+        path: { id: sessionID }
+      });
+      const messages = response2.data ?? [];
+      const hasAssistantOrToolMessage = messages.some((m2) => m2.info?.role === "assistant" || m2.info?.role === "tool");
+      if (!hasAssistantOrToolMessage) {
+        log("[background-agent] No assistant/tool messages found in session:", sessionID);
+        return false;
+      }
+      const hasContent2 = messages.some((m2) => {
+        if (m2.info?.role !== "assistant" && m2.info?.role !== "tool")
+          return false;
+        const parts = m2.parts ?? [];
+        return parts.some((p2) => p2.type === "text" && p2.text && p2.text.trim().length > 0 || p2.type === "reasoning" && p2.text && p2.text.trim().length > 0 || p2.type === "tool" || p2.type === "tool_result" && p2.content && (typeof p2.content === "string" ? p2.content.trim().length > 0 : p2.content.length > 0));
+      });
+      if (!hasContent2) {
+        log("[background-agent] Messages exist but no content found in session:", sessionID);
+        return false;
+      }
+      return true;
+    } catch (error45) {
+      log("[background-agent] Error validating session output:", error45);
+      return true;
+    }
+  }
   clearNotificationsForTask(taskId) {
     for (const [sessionID, tasks] of this.notifications.entries()) {
       const filtered = tasks.filter((t) => t.id !== taskId);
@@ -45489,8 +45694,15 @@ class BackgroundManager {
     this.stopPolling();
     this.tasks.clear();
     this.notifications.clear();
+    this.pendingByParent.clear();
+  }
+  getRunningTasks() {
+    return Array.from(this.tasks.values()).filter((t) => t.status === "running");
   }
-  notifyParentSession(task) {
+  getCompletedTasks() {
+    return Array.from(this.tasks.values()).filter((t) => t.status !== "running");
+  }
+  async notifyParentSession(task) {
     const duration3 = this.formatDuration(task.startedAt, task.completedAt);
     log("[background-agent] notifyParentSession called for task:", task.id);
     const toastManager = getTaskToastManager();
@@ -45501,33 +45713,70 @@ class BackgroundManager {
         duration: duration3
       });
     }
-    const message = `[BACKGROUND TASK COMPLETED] Task "${task.description}" finished in ${duration3}. Use background_output with task_id="${task.id}" to get results.`;
-    log("[background-agent] Sending notification to parent session:", { parentSessionID: task.parentSessionID });
+    const pendingSet = this.pendingByParent.get(task.parentSessionID);
+    if (pendingSet) {
+      pendingSet.delete(task.id);
+      if (pendingSet.size === 0) {
+        this.pendingByParent.delete(task.parentSessionID);
+      }
+    }
+    const allComplete = !pendingSet || pendingSet.size === 0;
+    const remainingCount = pendingSet?.size ?? 0;
+    const statusText = task.status === "error" ? "FAILED" : "COMPLETED";
+    const errorInfo = task.error ? `
+**Error:** ${task.error}` : "";
+    let notification;
+    if (allComplete) {
+      const completedTasks = Array.from(this.tasks.values()).filter((t) => t.parentSessionID === task.parentSessionID && t.status !== "running").map((t) => `- \`${t.id}\`: ${t.description}`).join(`
+`);
+      notification = `<system-reminder>
+[ALL BACKGROUND TASKS COMPLETE]
+
+**Completed:**
+${completedTasks || `- \`${task.id}\`: ${task.description}`}
+
+Use \`background_output(task_id="<id>")\` to retrieve each result.
+</system-reminder>`;
+    } else {
+      notification = `<system-reminder>
+[BACKGROUND TASK ${statusText}]
+**ID:** \`${task.id}\`
+**Description:** ${task.description}
+**Duration:** ${duration3}${errorInfo}
+
+**${remainingCount} task${remainingCount === 1 ? "" : "s"} still in progress.** You WILL be notified when ALL complete.
+Do NOT poll - continue productive work.
+
+Use \`background_output(task_id="${task.id}")\` to retrieve this result when ready.
+</system-reminder>`;
+    }
+    try {
+      await this.client.session.prompt({
+        path: { id: task.parentSessionID },
+        body: {
+          noReply: !allComplete,
+          agent: task.parentAgent,
+          parts: [{ type: "text", text: notification }]
+        }
+      });
+      log("[background-agent] Sent notification to parent session:", {
+        taskId: task.id,
+        allComplete,
+        noReply: !allComplete
+      });
+    } catch (error45) {
+      log("[background-agent] Failed to send notification:", error45);
+    }
     const taskId = task.id;
-    setTimeout(async () => {
+    setTimeout(() => {
       if (task.concurrencyKey) {
         this.concurrencyManager.release(task.concurrencyKey);
+        task.concurrencyKey = undefined;
       }
-      try {
-        const modelField = task.parentModel?.providerID && task.parentModel?.modelID ? { providerID: task.parentModel.providerID, modelID: task.parentModel.modelID } : undefined;
-        await this.client.session.prompt({
-          path: { id: task.parentSessionID },
-          body: {
-            agent: task.parentAgent,
-            model: modelField,
-            parts: [{ type: "text", text: message }]
-          },
-          query: { directory: this.directory }
-        });
-        log("[background-agent] Successfully sent prompt to parent session:", { parentSessionID: task.parentSessionID });
-      } catch (error45) {
-        log("[background-agent] prompt failed:", String(error45));
-      } finally {
-        this.clearNotificationsForTask(taskId);
-        this.tasks.delete(taskId);
-        log("[background-agent] Removed completed task from memory:", taskId);
-      }
-    }, 200);
+      this.clearNotificationsForTask(taskId);
+      this.tasks.delete(taskId);
+      log("[background-agent] Removed completed task from memory:", taskId);
+    }, 5 * 60 * 1000);
   }
   formatDuration(start, end) {
     const duration3 = (end ?? new Date).getTime() - start.getTime();
@@ -45590,11 +45839,12 @@ class BackgroundManager {
         continue;
       try {
         const sessionStatus = allStatuses[task.sessionID];
-        if (!sessionStatus) {
-          log("[background-agent] Session not found in status:", task.sessionID);
-          continue;
-        }
-        if (sessionStatus.type === "idle") {
+        if (sessionStatus?.type === "idle") {
+          const hasValidOutput = await this.validateSessionHasOutput(task.sessionID);
+          if (!hasValidOutput) {
+            log("[background-agent] Polling idle but no valid output yet, waiting:", task.id);
+            continue;
+          }
           const hasIncompleteTodos2 = await this.checkSessionTodos(task.sessionID);
           if (hasIncompleteTodos2) {
             log("[background-agent] Task has incomplete todos via polling, waiting:", task.id);
@@ -45603,7 +45853,7 @@ class BackgroundManager {
           task.status = "completed";
           task.completedAt = new Date;
           this.markForNotification(task);
-          this.notifyParentSession(task);
+          await this.notifyParentSession(task);
           log("[background-agent] Task completed via polling:", task.id);
           continue;
         }
@@ -45638,6 +45888,32 @@ class BackgroundManager {
             task.progress.lastMessage = lastMessage;
             task.progress.lastMessageAt = new Date;
           }
+          const currentMsgCount = messages.length;
+          const elapsedMs = Date.now() - task.startedAt.getTime();
+          if (elapsedMs >= MIN_STABILITY_TIME_MS) {
+            if (task.lastMsgCount === currentMsgCount) {
+              task.stablePolls = (task.stablePolls ?? 0) + 1;
+              if (task.stablePolls >= 3) {
+                const hasValidOutput = await this.validateSessionHasOutput(task.sessionID);
+                if (!hasValidOutput) {
+                  log("[background-agent] Stability reached but no valid output, waiting:", task.id);
+                  continue;
+                }
+                const hasIncompleteTodos2 = await this.checkSessionTodos(task.sessionID);
+                if (!hasIncompleteTodos2) {
+                  task.status = "completed";
+                  task.completedAt = new Date;
+                  this.markForNotification(task);
+                  await this.notifyParentSession(task);
+                  log("[background-agent] Task completed via stability detection:", task.id);
+                  continue;
+                }
+              }
+            } else {
+              task.stablePolls = 0;
+            }
+          }
+          task.lastMsgCount = currentMsgCount;
         }
       } catch (error45) {
         log("[background-agent] Poll error for task:", { taskId: task.id, error: error45 });
@@ -48454,7 +48730,9 @@ var BuiltinAgentNameSchema = exports_external.enum([
   "frontend-ui-ux-engineer",
   "document-writer",
   "multimodal-looker",
-  "Metis (Plan Consultant)"
+  "Metis (Plan Consultant)",
+  "Momus (Plan Reviewer)",
+  "orchestrator-sisyphus"
 ]);
 var BuiltinSkillNameSchema = exports_external.enum([
   "playwright",
@@ -48468,12 +48746,14 @@ var OverridableAgentNameSchema = exports_external.enum([
   "OpenCode-Builder",
   "Prometheus (Planner)",
   "Metis (Plan Consultant)",
+  "Momus (Plan Reviewer)",
   "oracle",
   "librarian",
   "explore",
   "frontend-ui-ux-engineer",
   "document-writer",
-  "multimodal-looker"
+  "multimodal-looker",
+  "orchestrator-sisyphus"
 ]);
 var HookNameSchema = exports_external.enum([
   "todo-continuation-enforcer",
@@ -48534,12 +48814,14 @@ var AgentOverridesSchema = exports_external.object({
   "OpenCode-Builder": AgentOverrideConfigSchema.optional(),
   "Prometheus (Planner)": AgentOverrideConfigSchema.optional(),
   "Metis (Plan Consultant)": AgentOverrideConfigSchema.optional(),
+  "Momus (Plan Reviewer)": AgentOverrideConfigSchema.optional(),
   oracle: AgentOverrideConfigSchema.optional(),
   librarian: AgentOverrideConfigSchema.optional(),
   explore: AgentOverrideConfigSchema.optional(),
   "frontend-ui-ux-engineer": AgentOverrideConfigSchema.optional(),
   "document-writer": AgentOverrideConfigSchema.optional(),
-  "multimodal-looker": AgentOverrideConfigSchema.optional()
+  "multimodal-looker": AgentOverrideConfigSchema.optional(),
+  "orchestrator-sisyphus": AgentOverrideConfigSchema.optional()
 });
 var ClaudeCodeConfigSchema = exports_external.object({
   mcp: exports_external.boolean().optional(),
@@ -49056,7 +49338,6 @@ ${patterns.join(`
 var DEFAULT_MODEL = "anthropic/claude-opus-4-5";
 var SISYPHUS_ROLE_SECTION = `<Role>
 You are "Sisyphus" - Powerful AI Agent with orchestration capabilities from OhMyOpenCode.
-Named by [YeonGyu Kim](https://github.com/code-yeongyu).
 
 **Why Sisyphus?**: Humans roll their boulder every day. So do you. We're not so different\u2014your code should be indistinguishable from a senior engineer's.
 
@@ -49777,24 +50058,17 @@ var LIBRARIAN_PROMPT_METADATA = {
   ]
 };
 function createLibrarianAgent(model = DEFAULT_MODEL3) {
-  const restrictions = createAgentToolRestrictions([
-    "write",
-    "edit",
-    "task",
-    "sisyphus_task",
-    "call_omo_agent"
-  ]);
   return {
     description: "Specialized codebase understanding agent for multi-repository analysis, searching remote codebases, retrieving official documentation, and finding implementation examples using GitHub CLI, Context7, and Web Search. MUST BE USED when users ask to look up code in remote repositories, explain library internals, or find usage examples in open source.",
     mode: "subagent",
     model,
     temperature: 0.1,
-    ...restrictions,
+    tools: { write: false, edit: false, background_task: false },
     prompt: `# THE LIBRARIAN
 
 You are **THE LIBRARIAN**, a specialized open-source codebase understanding agent.
 
-Your job: Answer questions about open-source libraries. Provide **EVIDENCE** with **GitHub permalinks** when the question requires verification, implementation details, or current/version-specific information. For well-known APIs and stable concepts, answer directly from knowledge.
+Your job: Answer questions about open-source libraries by finding **EVIDENCE** with **GitHub permalinks**.
 
 ## CRITICAL: DATE AWARENESS
 
@@ -49806,20 +50080,64 @@ Your job: Answer questions about open-source libraries. Provide **EVIDENCE** wit
 
 ---
 
-## PHASE 0: ASSESS BEFORE SEARCHING
-
-**First**: Can you answer confidently from training knowledge? If yes, answer directly.
+## PHASE 0: REQUEST CLASSIFICATION (MANDATORY FIRST STEP)
 
-**Search when**: version-specific info, implementation internals, recent changes, unfamiliar libraries, user explicitly requests source/examples.
-
-**If search needed**, classify into:
+Classify EVERY request into one of these categories before taking action:
 
 | Type | Trigger Examples | Tools |
 |------|------------------|-------|
-| **TYPE A: CONCEPTUAL** | "How do I use X?", "Best practice for Y?" | context7 + web search (if available) in parallel |
+| **TYPE A: CONCEPTUAL** | "How do I use X?", "Best practice for Y?" | Doc Discovery \u2192 context7 + websearch |
 | **TYPE B: IMPLEMENTATION** | "How does X implement Y?", "Show me source of Z" | gh clone + read + blame |
-| **TYPE C: CONTEXT** | "Why was this changed?", "What's the history?", "Related issues/PRs?" | gh issues/prs + git log/blame |
-| **TYPE D: COMPREHENSIVE** | Complex/ambiguous requests | ALL available tools in parallel |
+| **TYPE C: CONTEXT** | "Why was this changed?", "History of X?" | gh issues/prs + git log/blame |
+| **TYPE D: COMPREHENSIVE** | Complex/ambiguous requests | Doc Discovery \u2192 ALL tools |
+
+---
+
+## PHASE 0.5: DOCUMENTATION DISCOVERY (FOR TYPE A & D)
+
+**When to execute**: Before TYPE A or TYPE D investigations involving external libraries/frameworks.
+
+### Step 1: Find Official Documentation
+\`\`\`
+websearch("library-name official documentation site")
+\`\`\`
+- Identify the **official documentation URL** (not blogs, not tutorials)
+- Note the base URL (e.g., \`https://docs.example.com\`)
+
+### Step 2: Version Check (if version specified)
+If user mentions a specific version (e.g., "React 18", "Next.js 14", "v2.x"):
+\`\`\`
+websearch("library-name v{version} documentation")
+// OR check if docs have version selector:
+webfetch(official_docs_url + "/versions")
+// or
+webfetch(official_docs_url + "/v{version}")
+\`\`\`
+- Confirm you're looking at the **correct version's documentation**
+- Many docs have versioned URLs: \`/docs/v2/\`, \`/v14/\`, etc.
+
+### Step 3: Sitemap Discovery (understand doc structure)
+\`\`\`
+webfetch(official_docs_base_url + "/sitemap.xml")
+// Fallback options:
+webfetch(official_docs_base_url + "/sitemap-0.xml")
+webfetch(official_docs_base_url + "/docs/sitemap.xml")
+\`\`\`
+- Parse sitemap to understand documentation structure
+- Identify relevant sections for the user's question
+- This prevents random searching\u2014you now know WHERE to look
+
+### Step 4: Targeted Investigation
+With sitemap knowledge, fetch the SPECIFIC documentation pages relevant to the query:
+\`\`\`
+webfetch(specific_doc_page_from_sitemap)
+context7_query-docs(libraryId: id, query: "specific topic")
+\`\`\`
+
+**Skip Doc Discovery when**:
+- TYPE B (implementation) - you're cloning repos anyway
+- TYPE C (context/history) - you're looking at issues/PRs
+- Library has no official docs (rare OSS projects)
 
 ---
 
@@ -49828,15 +50146,15 @@ Your job: Answer questions about open-source libraries. Provide **EVIDENCE** wit
 ### TYPE A: CONCEPTUAL QUESTION
 **Trigger**: "How do I...", "What is...", "Best practice for...", rough/general questions
 
-**If searching**, use tools as needed:
+**Execute Documentation Discovery FIRST (Phase 0.5)**, then:
 \`\`\`
 Tool 1: context7_resolve-library-id("library-name")
-        \u2192 then context7_get-library-docs(id, topic: "specific-topic")
-Tool 2: grep_app_searchGitHub(query: "usage pattern", language: ["TypeScript"])
-Tool 3 (optional): If web search is available, search "library-name topic 2025"
+        \u2192 then context7_query-docs(libraryId: id, query: "specific-topic")
+Tool 2: webfetch(relevant_pages_from_sitemap)  // Targeted, not random
+Tool 3: grep_app_searchGitHub(query: "usage pattern", language: ["TypeScript"])
 \`\`\`
 
-**Output**: Summarize findings with links to official docs and real-world examples.
+**Output**: Summarize findings with links to official docs (versioned if applicable) and real-world examples.
 
 ---
 
@@ -49847,20 +50165,20 @@ Tool 3 (optional): If web search is available, search "library-name topic 2025"
 \`\`\`
 Step 1: Clone to temp directory
         gh repo clone owner/repo \${TMPDIR:-/tmp}/repo-name -- --depth 1
-        
+
 Step 2: Get commit SHA for permalinks
         cd \${TMPDIR:-/tmp}/repo-name && git rev-parse HEAD
-        
+
 Step 3: Find the implementation
         - grep/ast_grep_search for function/class
         - read the specific file
         - git blame for context if needed
-        
+
 Step 4: Construct permalink
         https://github.com/owner/repo/blob/<sha>/path/to/file#L10-L20
 \`\`\`
 
-**For faster results, parallelize**:
+**Parallel acceleration (4+ calls)**:
 \`\`\`
 Tool 1: gh repo clone owner/repo \${TMPDIR:-/tmp}/repo -- --depth 1
 Tool 2: grep_app_searchGitHub(query: "function_name", repo: "owner/repo")
@@ -49873,7 +50191,7 @@ Tool 4: context7_get-library-docs(id, topic: "relevant-api")
 ### TYPE C: CONTEXT & HISTORY
 **Trigger**: "Why was this changed?", "What's the history?", "Related issues/PRs?"
 
-**Tools to use**:
+**Execute in parallel (4+ calls)**:
 \`\`\`
 Tool 1: gh search issues "keyword" --repo owner/repo --state all --limit 10
 Tool 2: gh search prs "keyword" --repo owner/repo --state merged --limit 10
@@ -49895,22 +50213,21 @@ gh api repos/owner/repo/pulls/<number>/files
 ### TYPE D: COMPREHENSIVE RESEARCH
 **Trigger**: Complex questions, ambiguous requests, "deep dive into..."
 
-**Use multiple tools as needed**:
+**Execute Documentation Discovery FIRST (Phase 0.5)**, then execute in parallel (6+ calls):
 \`\`\`
-// Documentation
-Tool 1: context7_resolve-library-id \u2192 context7_get-library-docs
+// Documentation (informed by sitemap discovery)
+Tool 1: context7_resolve-library-id \u2192 context7_query-docs
+Tool 2: webfetch(targeted_doc_pages_from_sitemap)
 
 // Code Search
-Tool 2: grep_app_searchGitHub(query: "pattern1", language: [...])
-Tool 3: grep_app_searchGitHub(query: "pattern2", useRegexp: true)
+Tool 3: grep_app_searchGitHub(query: "pattern1", language: [...])
+Tool 4: grep_app_searchGitHub(query: "pattern2", useRegexp: true)
 
 // Source Analysis
-Tool 4: gh repo clone owner/repo \${TMPDIR:-/tmp}/repo -- --depth 1
+Tool 5: gh repo clone owner/repo \${TMPDIR:-/tmp}/repo -- --depth 1
 
 // Context
-Tool 5: gh search issues "topic" --repo owner/repo
-
-// Optional: If web search is available, search for recent updates
+Tool 6: gh search issues "topic" --repo owner/repo
 \`\`\`
 
 ---
@@ -49955,7 +50272,11 @@ https://github.com/tanstack/query/blob/abc123def/packages/react-query/src/useQue
 
 | Purpose | Tool | Command/Usage |
 |---------|------|---------------|
-| **Official Docs** | context7 | \`context7_resolve-library-id\` \u2192 \`context7_get-library-docs\` |
+| **Official Docs** | context7 | \`context7_resolve-library-id\` \u2192 \`context7_query-docs\` |
+| **Find Docs URL** | websearch_exa | \`websearch_exa_web_search_exa("library official documentation")\` |
+| **Sitemap Discovery** | webfetch | \`webfetch(docs_url + "/sitemap.xml")\` to understand doc structure |
+| **Read Doc Page** | webfetch | \`webfetch(specific_doc_page)\` for targeted documentation |
+| **Latest Info** | websearch_exa | \`websearch_exa_web_search_exa("query 2025")\` |
 | **Fast Code Search** | grep_app | \`grep_app_searchGitHub(query, language, useRegexp)\` |
 | **Deep Code Search** | gh CLI | \`gh search code "query" --repo owner/repo\` |
 | **Clone Repo** | gh CLI | \`gh repo clone owner/repo \${TMPDIR:-/tmp}/name -- --depth 1\` |
@@ -49963,8 +50284,6 @@ https://github.com/tanstack/query/blob/abc123def/packages/react-query/src/useQue
 | **View Issue/PR** | gh CLI | \`gh issue/pr view <num> --repo owner/repo --comments\` |
 | **Release Info** | gh CLI | \`gh api repos/owner/repo/releases/latest\` |
 | **Git History** | git | \`git log\`, \`git blame\`, \`git show\` |
-| **Read URL** | webfetch | \`webfetch(url)\` for blog posts, SO threads |
-| **Web Search** | (if available) | Use any available web search tool for latest info |
 
 ### Temp Directory
 
@@ -49981,16 +50300,18 @@ Use OS-appropriate temp directory:
 
 ---
 
-## PARALLEL EXECUTION GUIDANCE
+## PARALLEL EXECUTION REQUIREMENTS
 
-When searching is needed, scale effort to question complexity:
-
-| Request Type | Suggested Calls |
+| Request Type | Suggested Calls | Doc Discovery Required |
 |--------------|----------------|
-| TYPE A (Conceptual) | 1-2 |
-| TYPE B (Implementation) | 2-3 |
-| TYPE C (Context) | 2-3 |
-| TYPE D (Comprehensive) | 3-5 |
+| TYPE A (Conceptual) | 1-2 | YES (Phase 0.5 first) |
+| TYPE B (Implementation) | 2-3 NO |
+| TYPE C (Context) | 2-3 NO |
+| TYPE D (Comprehensive) | 3-5 | YES (Phase 0.5 first) |
+| Request Type | Minimum Parallel Calls
+
+**Doc Discovery is SEQUENTIAL** (websearch \u2192 version check \u2192 sitemap \u2192 investigate).
+**Main phase is PARALLEL** once you know where to look.
 
 **Always vary queries** when using grep_app:
 \`\`\`
@@ -50014,6 +50335,8 @@ grep_app_searchGitHub(query: "useQuery")
 | grep_app no results | Broaden query, try concept instead of exact name |
 | gh API rate limit | Use cloned repo in temp directory |
 | Repo not found | Search for forks or mirrors |
+| Sitemap not found | Try \`/sitemap-0.xml\`, \`/sitemap_index.xml\`, or fetch docs index page and parse navigation |
+| Versioned docs not found | Fall back to latest version, note this in response |
 | Uncertain | **STATE YOUR UNCERTAINTY**, propose hypothesis |
 
 ---
@@ -50021,7 +50344,7 @@ grep_app_searchGitHub(query: "useQuery")
 ## COMMUNICATION RULES
 
 1. **NO TOOL NAMES**: Say "I'll search the codebase" not "I'll use grep_app"
-2. **NO PREAMBLE**: Answer directly, skip "I'll help you with..." 
+2. **NO PREAMBLE**: Answer directly, skip "I'll help you with..."
 3. **ALWAYS CITE**: Every code claim needs a permalink
 4. **USE MARKDOWN**: Code blocks with language identifiers
 5. **BE CONCISE**: Facts > opinions, evidence > speculation
@@ -50781,15 +51104,19 @@ var metisRestrictions = createAgentToolRestrictions([
   "task",
   "sisyphus_task"
 ]);
-var metisAgent = {
-  description: "Pre-planning consultant that analyzes requests to identify hidden intentions, ambiguities, and AI failure points.",
-  mode: "subagent",
-  model: "anthropic/claude-opus-4-5",
-  temperature: 0.3,
-  ...metisRestrictions,
-  prompt: METIS_SYSTEM_PROMPT,
-  thinking: { type: "enabled", budgetTokens: 32000 }
-};
+var DEFAULT_MODEL8 = "anthropic/claude-opus-4-5";
+function createMetisAgent(model = DEFAULT_MODEL8) {
+  return {
+    description: "Pre-planning consultant that analyzes requests to identify hidden intentions, ambiguities, and AI failure points.",
+    mode: "subagent",
+    model,
+    temperature: 0.3,
+    ...metisRestrictions,
+    prompt: METIS_SYSTEM_PROMPT,
+    thinking: { type: "enabled", budgetTokens: 32000 }
+  };
+}
+var metisAgent = createMetisAgent();
 
 // src/agents/orchestrator-sisyphus.ts
 init_constants();
@@ -50903,7 +51230,6 @@ ${rows.join(`
 **NEVER provide both category AND agent - they are mutually exclusive.**`;
 }
 var ORCHESTRATOR_SISYPHUS_SYSTEM_PROMPT = `You are "Sisyphus" - Powerful AI Agent with orchestration capabilities from OhMyOpenCode.
-Named by [YeonGyu Kim](https://github.com/code-yeongyu).
 
 **Why Sisyphus?**: Humans roll their boulder every day. So do you. We're not so different\u2014your code should be indistinguishable from a senior engineer's.
 
@@ -52196,6 +52522,7 @@ function buildDynamicOrchestratorPrompt(ctx) {
   const skillsSection = buildSkillsSection(skills);
   return ORCHESTRATOR_SISYPHUS_SYSTEM_PROMPT.replace("{CATEGORY_SECTION}", categorySection).replace("{AGENT_SECTION}", agentSection).replace("{DECISION_MATRIX}", decisionMatrix).replace("{SKILLS_SECTION}", skillsSection);
 }
+var DEFAULT_MODEL9 = "anthropic/claude-sonnet-4-5";
 function createOrchestratorSisyphusAgent(ctx) {
   const restrictions = createAgentToolRestrictions([
     "task",
@@ -52204,7 +52531,7 @@ function createOrchestratorSisyphusAgent(ctx) {
   return {
     description: "Orchestrates work via sisyphus_task() to complete ALL tasks in a todo list until fully done",
     mode: "primary",
-    model: "anthropic/claude-sonnet-4-5",
+    model: ctx?.model ?? DEFAULT_MODEL9,
     temperature: 0.1,
     prompt: buildDynamicOrchestratorPrompt(ctx),
     thinking: { type: "enabled", budgetTokens: 32000 },
@@ -52214,7 +52541,7 @@ function createOrchestratorSisyphusAgent(ctx) {
 var orchestratorSisyphusAgent = createOrchestratorSisyphusAgent();
 
 // src/agents/momus.ts
-var DEFAULT_MODEL8 = "openai/gpt-5.2";
+var DEFAULT_MODEL10 = "openai/gpt-5.2";
 var MOMUS_SYSTEM_PROMPT = `You are a work plan review expert. You review the provided work plan (.sisyphus/plans/{name}.md in the current working project directory) according to **unified, consistent criteria** that ensure clarity, verifiability, and completeness.
 
 **CRITICAL FIRST RULE**:
@@ -52544,7 +52871,7 @@ Use structured format, **in the same language as the work plan**.
 
 **Strike the right balance**: Prevent critical failures while empowering developer autonomy.
 `;
-function createMomusAgent(model = DEFAULT_MODEL8) {
+function createMomusAgent(model = DEFAULT_MODEL10) {
   const restrictions = createAgentToolRestrictions([
     "write",
     "edit",
@@ -52575,8 +52902,8 @@ var agentSources = {
   "frontend-ui-ux-engineer": createFrontendUiUxEngineerAgent,
   "document-writer": createDocumentWriterAgent,
   "multimodal-looker": createMultimodalLookerAgent,
-  "Metis (Plan Consultant)": metisAgent,
-  "Momus (Plan Reviewer)": momusAgent,
+  "Metis (Plan Consultant)": createMetisAgent,
+  "Momus (Plan Reviewer)": createMomusAgent,
   "orchestrator-sisyphus": orchestratorSisyphusAgent
 };
 var agentMetadata = {
@@ -52689,7 +53016,11 @@ function createBuiltinAgents(disabledAgents = [], agentOverrides = {}, directory
   }
   if (!disabledAgents.includes("orchestrator-sisyphus")) {
     const orchestratorOverride = agentOverrides["orchestrator-sisyphus"];
-    let orchestratorConfig = createOrchestratorSisyphusAgent({ availableAgents });
+    const orchestratorModel = orchestratorOverride?.model;
+    let orchestratorConfig = createOrchestratorSisyphusAgent({
+      model: orchestratorModel,
+      availableAgents
+    });
     if (orchestratorOverride) {
       orchestratorConfig = mergeAgentConfig(orchestratorConfig, orchestratorOverride);
     }