openclaw-scheduler 0.2.10 → 0.2.11

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.11] -- 2026-06-23
+
+### Fixed
+- fix(dispatch): clarify that completion markers must run in the originating local dispatch shell, and allow watcher delivery from clean terminal `stop_reason=end_turn` replies without broadening plain `lastReply` success detection
+- fix(watcher): use the fatal idle threshold for stalled-session errors while keeping quiet high-thinking sessions pending at the probe threshold
+
 ## [0.2.5] -- 2026-04-27
 
 ### Fixed

package/dispatch/completion.mjs

@@ -1134,6 +1134,7 @@ export function buildCompletionSignalInstructions({ label, taskPrompt, doneScrip
   readinessChecks.forEach((line, idx) => lines.push(`  ${idx + 1}. ${line}`));
   lines.push('');
   lines.push('Call this as your ABSOLUTE FINAL action -- nothing else runs after this:');
+  lines.push('  IMPORTANT: run this command in the dispatch session shell on this host. Do not run it inside ssh, docker, tmux, or any remote shell; remote label stores cannot mark this dispatch complete.');
   lines.push(`  node '${doneScriptPath}' done --label '${escapedLabel}' \\`);
   lines.push('    --summary "<human-readable summary of what you actually did>" \\');
   lines.push(`    --checklist '${checklistExample}' \\`);

package/dispatch/watcher.mjs

@@ -1052,6 +1052,22 @@ function hasStructuredCompletion(result) {
   return hasCompletionSignal(result?.completion);
 }
 
+function getCleanTerminalReply(status) {
+  if (!status?.sessionKey) return null;
+  const entry = getSessionStoreEntry(status.sessionKey);
+  const sessionId = entry?.sessionId || null;
+  const sessionAgent = status.sessionKey.split(':')[1] || 'main';
+  const terminalJsonlReply = sessionId ? getSessionTerminalReply(sessionId, sessionAgent) : null;
+  if (!sessionId || !terminalJsonlReply) return null;
+  return isSessionCleanlyFinished(sessionId, sessionAgent) ? terminalJsonlReply : null;
+}
+
+function getStrictTerminalReply(result, status) {
+  const terminalJsonlReply = getCleanTerminalReply(status);
+  if (!terminalJsonlReply) return null;
+  return result?.lastReply || terminalJsonlReply;
+}
+
 if (!label) {
   process.stderr.write('[watcher] --label is required\n');
   process.exit(2);
@@ -1159,16 +1175,13 @@ function runOnceAndExit() {
   }
 
   if (status.sessionKey) {
-    const entry = getSessionStoreEntry(status.sessionKey);
-    const sessionId = entry?.sessionId || null;
-    const sessionAgent = status.sessionKey.split(':')[1] || 'main';
-    const terminalJsonlReply = sessionId ? getSessionTerminalReply(sessionId, sessionAgent) : null;
-    if (sessionId && terminalJsonlReply && isSessionCleanlyFinished(sessionId, sessionAgent)) {
+    const terminalJsonlReply = getCleanTerminalReply(status);
+    if (terminalJsonlReply) {
       const result = dispatch('result', ['--label', label]);
       if (hasStructuredCompletion(result)) {
         deliverResult(label, result?.lastReply || terminalJsonlReply, 'completed (stop_reason=end_turn)', result?.completion || null);
       }
-      process.stderr.write(`[watcher] stop_reason=end_turn observed without completion signal -- continuing to monitor\n`);
+      deliverResult(label, terminalJsonlReply, 'completed (stop_reason=end_turn)', null);
     }
   }
 
@@ -1181,6 +1194,10 @@ function runOnceAndExit() {
     if (hasStructuredCompletion(result)) {
       deliverResult(label, result?.lastReply || null, null, result?.completion || null);
     }
+    const terminalReply = getStrictTerminalReply(result, status);
+    if (terminalReply) {
+      deliverResult(label, terminalReply, 'completed (stop_reason=end_turn)', null);
+    }
 
     const stallReason = ageMs >= idleFailureMs
       ? getRunningSessionStallReason(status, idleFailureMs)
@@ -1550,7 +1567,7 @@ while (Date.now() < deadline) {
         deliverResult(label, result?.lastReply || terminalJsonlReply, 'completed (stop_reason=end_turn)', result?.completion || null);
         // deliverResult exits
       }
-      process.stderr.write(`[watcher] stop_reason=end_turn observed without completion signal -- continuing to monitor\n`);
+      deliverResult(label, terminalJsonlReply, 'completed (stop_reason=end_turn)', null);
     }
   }
 
@@ -1569,6 +1586,10 @@ while (Date.now() < deadline) {
     if (hasStructuredCompletion(result)) {
       deliverResult(label, result?.lastReply || null, null, result?.completion || null);
     }
+    const terminalReply = getStrictTerminalReply(result, status);
+    if (terminalReply) {
+      deliverResult(label, terminalReply, 'completed (stop_reason=end_turn)', null);
+    }
 
     const stallReason = ageMs >= idleFailureMs
       ? getRunningSessionStallReason(status, idleFailureMs)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-scheduler",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "description": "SQLite-backed job scheduler and workflow engine for OpenClaw agents",
   "type": "module",
   "main": "./index.js",