@raidiant/notifai 11.5.0 → 11.6.0-beta.3

package/dist/hermes-plugin.js

@@ -14,12 +14,140 @@ export function hermesPluginDir(env = process.env) {
 export function hermesPluginSource(adapterPath, nodePath) {
     const command = nodePath === undefined ? [adapterPath] : [nodePath, adapterPath];
     return `${HERMES_PLUGIN_MARKER}
-"""Notifai activation for a proven local Hermes CLI Agent Session."""
+"""Notifai activation and Session Attendant for a local Hermes CLI session."""
+import atexit
 import json
 import os
+import select
 import subprocess
+import threading
+import time
 
 COMMAND = ${JSON.stringify(command)}
+_attendants = {}
+_lock = threading.RLock()
+
+def _attached_session(ctx):
+    cli = getattr(ctx._manager, "_cli_ref", None)
+    return str(getattr(cli, "session_id", "") or "") if cli is not None else ""
+
+def _run_attendant(ctx, session_id, cwd, stopped):
+    proc = None
+    wall_anchor = time.time_ns()
+    mono_anchor = time.monotonic_ns()
+    try:
+        proc = subprocess.Popen(COMMAND + ["hook", "hermes-attend", "--owner", "notifai", "--harness", "hermes"],
+                                cwd=cwd, stdin=subprocess.PIPE, stdout=subprocess.PIPE,
+                                stderr=subprocess.DEVNULL, text=True, bufsize=1)
+        with _lock:
+            _attendants[session_id] = (stopped, proc)
+        def send(frame):
+            with _lock:
+                if proc.stdin is None or proc.stdin.closed:
+                    return False
+                try:
+                    proc.stdin.write(json.dumps(frame, ensure_ascii=False) + "\\n")
+                    proc.stdin.flush()
+                    return True
+                except (OSError, ValueError):
+                    return False
+        if not send({"type": "hello", "session_id": session_id, "cwd": cwd, "pid": os.getpid()}):
+            return
+        pending = bytearray()
+        while not stopped.is_set() and proc.poll() is None:
+            with _lock:
+                current = _attached_session(ctx)
+                working = bool(getattr(ctx._manager._cli_ref, "_agent_running", False)) if current == session_id else False
+            if current != session_id:
+                break
+            if not send({"type": "state", "session_id": session_id,
+                         "activity": "working" if working else "idle"}):
+                break
+            readable, _, _ = select.select([proc.stdout], [], [], 1.0)
+            if not readable:
+                continue
+            chunk = os.read(proc.stdout.fileno(), 65536)
+            if not chunk:
+                break
+            pending.extend(chunk)
+            if len(pending) > 2 * 1024 * 1024:
+                break
+            while b"\\n" in pending:
+                raw, _, rest = pending.partition(b"\\n")
+                pending = bytearray(rest)
+                try:
+                    frame = json.loads(raw.decode("utf-8"))
+                except (UnicodeDecodeError, ValueError):
+                    continue
+                if frame.get("type") != "write" or not isinstance(frame.get("id"), int):
+                    continue
+                accepted = False
+                with _lock:
+                    wall_now = time.time_ns()
+                    mono_now = time.monotonic_ns()
+                    # Fail closed after a backward wall-clock step. Node's
+                    # deadline is wall time because its monotonic origin may
+                    # differ from Python's on the same macOS host.
+                    clock_stable = wall_now - wall_anchor + 100_000_000 >= mono_now - mono_anchor
+                    deadline = frame.get("deadline_ms")
+                    if (not stopped.is_set() and frame.get("session_id") == session_id and
+                            _attached_session(ctx) == session_id and
+                            type(deadline) is int and wall_now < deadline * 1_000_000 and clock_stable):
+                        try:
+                            accepted = bool(ctx.inject_message(frame.get("text", "")))
+                        except Exception:
+                            pass
+                send({"type": "result", "id": frame["id"], "accepted": accepted,
+                      "reason": "session-replaced" if not accepted else ""})
+        send({"type": "end", "session_id": session_id})
+    except (OSError, ValueError):
+        pass
+    finally:
+        with _lock:
+            if _attendants.get(session_id, (None, None))[0] is stopped:
+                _attendants.pop(session_id, None)
+        if proc is not None:
+            try:
+                if proc.stdin is not None:
+                    proc.stdin.close()
+                proc.wait(timeout=4)
+            except (OSError, subprocess.TimeoutExpired):
+                proc.terminate()
+                try:
+                    proc.wait(timeout=2)
+                except subprocess.TimeoutExpired:
+                    proc.kill()
+
+def _start_attendant(ctx, session_id, cwd):
+    if os.name == "nt":
+        return
+    with _lock:
+        if _attached_session(ctx) != session_id or os.environ.get("HERMES_SESSION_ID") != session_id:
+            return
+        if session_id in _attendants:
+            return
+        stopped = threading.Event()
+        _attendants[session_id] = (stopped, None)
+        threading.Thread(target=_run_attendant, args=(ctx, session_id, cwd, stopped),
+                         daemon=True, name="notifai-hermes-attendant").start()
+
+def _stop_attendant(session_id):
+    with _lock:
+        item = _attendants.get(session_id)
+        if item is None:
+            return
+        stopped, proc = item
+        stopped.set()
+        if proc is not None and proc.stdin is not None and not proc.stdin.closed:
+            try:
+                proc.stdin.write(json.dumps({"type": "end", "session_id": session_id}) + "\\n")
+                proc.stdin.flush()
+            except (OSError, ValueError):
+                pass
+
+def _stop_all():
+    for session_id in list(_attendants):
+        _stop_attendant(session_id)
 
 def _activation(info):
     platform = str(info.get("platform") or "")
@@ -27,7 +155,9 @@ def _activation(info):
         return ""
     if os.environ.get("HERMES_SESSION_SOURCE", "").lower() not in ("", "cli"):
         return ""
-    if os.environ.get("_HERMES_GATEWAY") == "1" or os.environ.get("HERMES_TUI_ACTIVE_SESSION_FILE"):
+    # Hermes may import gateway.run inside a classic CLI and set its process
+    # marker there. The attached CLI object and exact session are the proof.
+    if os.environ.get("HERMES_TUI_ACTIVE_SESSION_FILE"):
         return ""
     if os.environ.get("TERMINAL_ENV", "").lower() not in ("", "local"):
         return ""
@@ -57,11 +187,19 @@ def _activation(info):
                                 timeout=10, check=False)
     except (OSError, subprocess.TimeoutExpired):
         return ""
-    return result.stdout.strip() if result.returncode == 0 else ""
+    content = result.stdout.strip() if result.returncode == 0 else ""
+    if content and not worker:
+        _start_attendant(_ctx, session_id, cwd)
+    return content
 
 def register(ctx):
+    global _ctx
+    _ctx = ctx
     ctx.register_system_prompt_section("notifai.activation", _activation,
                                        position="after_memory", max_chars=4000)
+    ctx.register_hook("on_session_finalize", lambda session_id=None, **_: _stop_attendant(str(session_id or "")))
+    ctx.register_hook("on_session_reset", lambda session_id=None, **_: _stop_all())
+    atexit.register(_stop_all)
 `;
 }
 export function isOurHermesPlugin(dir) {
@@ -121,7 +259,7 @@ export function installHermesPlugin(adapterPath, env = process.env, nodePath) {
     else {
         const temp = mkdtempSync(path.join(os.tmpdir(), 'notifai-hermes-plugin-'));
         try {
-            writeFileSync(path.join(temp, 'plugin.yaml'), 'name: notifai\nversion: "1.0.0"\ndescription: "Notifai Project Enablement and agent guidance"\n');
+            writeFileSync(path.join(temp, 'plugin.yaml'), 'name: notifai\nversion: "1.0.0"\ndescription: "Notifai activation and Session Attendant"\nprovides_hooks:\n  - on_session_finalize\n  - on_session_reset\n');
             writeFileSync(path.join(temp, '__init__.py'), source);
             const git = (args) => {
                 const result = spawnSync('git', args, { cwd: temp, env, encoding: 'utf8', timeout: 10_000 });

package/dist/hermes-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"hermes-plugin.js","sourceRoot":"","sources":["../src/hermes-plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hermes-plugin.js","sourceRoot":"","sources":["../src/hermes-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACjG,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAA;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,oCAAoC,CAAA;AAExE,MAAM,UAAU,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IAClE,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAA;IACnG,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,QAAiB;IACvE,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAChF,OAAO,GAAG,oBAAoB;;;;;;;;;;YAUpB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiLlC,CAAA;AACD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;YAC/B,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE;YAClD,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,KAAK,CAAA;QAClE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,oBAAoB,CAAC;YACzF,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAc,EAAE,GAAsB;IAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE;QACvD,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI;KAC9D,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,eAAe,EAAE,CAAC,CAAA;IAChJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACzE,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;QAChD,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI;KAC7D,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,OAAO,aAAa,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC;SAC3D,KAAK,CAAC,OAAO,CAAC;SACd,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACxE,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IACtC,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;IAC1F,CAAC;IACD,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;IACzF,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC;SAClE,KAAK,CAAC,OAAO,CAAC;SACd,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,6DAA6D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAA;IAChG,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,MAAyB,OAAO,CAAC,GAAG,EAAE,QAAiB;IAC9G,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IACtC,qBAAqB,CAAC,GAAG,CAAC,CAAA;IAC1B,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACxD,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;QAClG,aAAa,CAAC,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,GAAG,CAAC,CAAA;IAClD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAA;QAC1E,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,4JAA4J,CAAC,CAAA;YAC3M,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAA;YACrD,MAAM,GAAG,GAAG,CAAC,IAAc,EAAE,EAAE;gBAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC5F,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,YAAY,EAAE,CAAC,CAAA;YAChK,CAAC,CAAA;YACD,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;YACnB,GAAG,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAA;YAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,oCAAoC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;YACvG,aAAa,CAAC,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QACnI,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACvF,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACxE,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IACtC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAA;IACxC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;IAChH,aAAa,CAAC,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,GAAG,CAAC,CAAA;IAChD,IAAI,UAAU,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IAC/F,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAA+B,EAAE,GAAsB;IACzF,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IAChC,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAClF,kBAAkB,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AACjH,CAAC"}

package/dist/hook-lifecycle.d.ts

@@ -65,7 +65,7 @@ export declare function reportHandedOffAfterTheFact(ctx: HookContext, sessionId:
  * hook for this session will ever run again. A question whose
  * agent just exited can receive no answer, so it is orphaned as `expired`.
  */
-export declare function handleSessionEnd(env: NodeJS.ProcessEnv, envelope: HookEnvelope, now?: number): HookOutcome;
+export declare function handleSessionEnd(env: NodeJS.ProcessEnv, envelope: HookEnvelope, now?: number, preserveAccepted?: boolean): HookOutcome;
 /**
  * Registrations still waiting for their first push. More than this in one turn
  * means an agent is looping, not asking, and related questions belong in one

package/dist/hook-lifecycle.js

@@ -8,7 +8,7 @@ import { clearMatchingProjectSession, writeProjectSession } from './hook-project
 import { claimHandoffState, claimQuestionPush, releaseQuestionPush } from './hook-question-lock.js';
 import { closeQuietly, drainOrphanRetirements, drainRetirements, finalizeReplies, selectedForClaimedDelivery, orphanRetirements, pendingAnsweredByPrompt, retirePendings, retiringQuestion, } from './hook-question-retirement.js';
 import { admitQueuedQuestion, clearFrozenSubmission, dropPendingQuestion, isSamePending, pendingQuestions, questionSubmissionAttempted, queuedQuestionStillEligible, rememberQuestionState, sourceContextAtHookEvent, summarizeRequestIds, } from './hook-question-state.js';
-import { clearSessionState, markSessionEnded, pendingList, readSessionState, sessionHasEnded, sessionStatePath, updateSessionState, writeSessionState, writeSessionStateUnlocked, recordSessionNotified, } from './hook-session-state.js';
+import { clearSessionState, markSessionEnded, pendingList, readSessionState, readSessionIncarnation, sessionHasEnded, sessionStatePath, updateSessionState, writeSessionState, writeSessionStateUnlocked, recordSessionNotified, } from './hook-session-state.js';
 import { currentProcessIdentity } from './process-identity.js';
 import { userPromptContextOutput } from './session-activation.js';
 import { answersAlreadyWritten, beginHandOff, recordUnclaimedHandOffs, recoverDeliveryJournal, sweepDeliveryJournals, } from './session-delivery.js';
@@ -313,7 +313,7 @@ function answerCloseDisposition(ctx, route) {
     // question, but an immediate reply can beat the first lease exchange. The
     // service retains the exact-session owner and retries after the lease is
     // ready, so preserve the server's selected delivery claim at close.
-    if (ctx.harness === 'openclaw' && route.kind === 'session-queue')
+    if ((ctx.harness === 'openclaw' || ctx.harness === 'hermes') && route.kind === 'session-queue')
         return 'deliver';
     return claimableRoute(route) && ctx.answerClaims?.lease() != null ? 'deliver' : undefined;
 }
@@ -442,7 +442,9 @@ function withReminder(reminder, context) {
  * the service, or null when none is.
  */
 async function messageAcknowledgementReminder(ctx, sessionId) {
-    const owed = presentedMessageAcknowledgements(readSessionState(sessionId, ctx.env));
+    const generation = ctx.harness === 'openclaw' ? readSessionIncarnation(sessionId, ctx.env)?.openclaw_generation : undefined;
+    const owed = presentedMessageAcknowledgements(readSessionState(sessionId, ctx.env))
+        .filter((entry) => ctx.harness !== 'openclaw' || (generation !== undefined && entry.openclaw_generation === generation));
     if (owed.length === 0)
         return null;
     const still = await reconcileAcknowledgementObligations(ctx, sessionId, owed);
@@ -982,9 +984,11 @@ async function deliverAcceptedAnswers(ctx, sessionId, route, accepted, notes, cw
     }
     await handOff?.finish(delivered.acknowledgement === 'delivered'
         ? 'written'
-        : delivered.log?.['reason'] === WRITE_ABORTED_REASON
-            ? 'aborted'
-            : 'not-written');
+        : delivered.log?.['reason'] === 'write-unconfirmed'
+            ? 'failed'
+            : delivered.log?.['reason'] === WRITE_ABORTED_REASON
+                ? 'aborted'
+                : 'not-written');
     if (delivered.acknowledgement === 'delivered' && deliveryCommitted) {
         await reportUnclaimedHandOff(ctx, sessionId, answered, handOff);
     }
@@ -1178,8 +1182,13 @@ async function claimAnswerHandOff(ctx, sessionId, route, answered) {
         // attendant has had a moment to re-acquire; any other refusal is final.
         const fenced = handOff.claimed.length === 0 &&
             handOff.refused.every((refusal) => refusal.reason === 'generation_fenced');
-        if (!fenced || round >= ANSWER_CLAIM_ROUNDS)
+        if (!fenced || round >= ANSWER_CLAIM_ROUNDS) {
+            if (ctx.harness === 'hermes' && handOff.claimed.length !== subjects.length) {
+                await handOff.finish('not-written');
+                return null;
+            }
             return handOff;
+        }
         await handOff.finish('not-written');
         await ctx.sleep(ANSWER_CLAIM_RETRY_MS);
     }
@@ -1791,7 +1800,7 @@ async function escalate(ctx, envelope, sessionId, unasked, alreadyLive, notes, h
  * hook for this session will ever run again. A question whose
  * agent just exited can receive no answer, so it is orphaned as `expired`.
  */
-export function handleSessionEnd(env, envelope, now = Date.now()) {
+export function handleSessionEnd(env, envelope, now = Date.now(), preserveAccepted = true) {
     const notes = [];
     const sessionId = envelope.session_id;
     if (!sessionId)
@@ -1840,10 +1849,12 @@ export function handleSessionEnd(env, envelope, now = Date.now()) {
         orphanRetirements(env, orphans, now);
         notes.push(`queued ${orphans.length} question${orphans.length > 1 ? 's' : ''} for retirement on the next hook`);
     }
-    if (state.accepted !== undefined ||
+    if ((preserveAccepted && state.accepted !== undefined) ||
         (state.acknowledgement_due?.length ?? 0) > 0 ||
         (state.message_acknowledgement_due?.length ?? 0) > 0) {
         const preserved = { ...stateWithHistory };
+        if (!preserveAccepted)
+            delete preserved.accepted;
         delete preserved.pending;
         delete preserved.retiring;
         delete preserved.acknowledgement_blocks;
@@ -1854,13 +1865,13 @@ export function handleSessionEnd(env, envelope, now = Date.now()) {
             delete preserved.message_acknowledgement_due;
         }
         writeSessionState(sessionId, env, preserved);
-        notes.push(state.accepted !== undefined
+        notes.push(preserveAccepted && state.accepted !== undefined
             ? 'preserved an accepted device answer for this exact session to resume'
             : 'preserved required Agent Acknowledgement obligations for this exact session');
         return {
             notes,
             log: {
-                outcome: state.accepted !== undefined ? 'answer-preserved' : 'acknowledgement-preserved',
+                outcome: preserveAccepted && state.accepted !== undefined ? 'answer-preserved' : 'acknowledgement-preserved',
                 queued_retirements: orphans.length,
                 accepted_answers: state.accepted?.answers.length ?? 0,
                 acknowledgement_due: state.acknowledgement_due?.length ?? 0,