docs(agent): note compaction lock hold ceiling

luoyanglang · luoyanglang · commit 598291d70c0c · 2026-05-22T15:02:12.000Z
diff --git a/src/agents/pi-embedded-runner/run/attempt.ts b/src/agents/pi-embedded-runner/run/attempt.ts
@@ -789,6 +789,9 @@ function resolveEmbeddedAttemptSessionWriteLockOptions(params: {
   compactionTimeoutMs: number;
   env?: NodeJS.ProcessEnv;
 }): { timeoutMs: number; staleMs: number; maxHoldMs: number } {
+  // Bound embedded-attempt lock holds to the compaction window, not the full run timeout.
+  // With defaults this permits roughly 900s compaction time plus the shared 120s
+  // timeout grace before the watchdog releases a stuck live-process lock.
   return resolveSessionWriteLockOptions(params.config, {
     env: params.env,
     maxHoldMsFallback: resolveSessionLockMaxHoldFromTimeout({
