pty-manager 1.3.3 → 1.5.0

package/dist/pty-worker.js

@@ -330,6 +330,9 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
   // Task completion detection (idle detection when busy)
   _taskCompleteTimer = null;
   static TASK_COMPLETE_DEBOUNCE_MS = 1500;
+  // Ready detection settle delay — defers session_ready until output goes quiet
+  _readySettleTimer = null;
+  _readySettlePending = false;
   // Deferred output processing — prevents node-pty's synchronous data
   // delivery from starving the event loop (timers, I/O callbacks, etc.)
   _processScheduled = false;
@@ -621,6 +624,45 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
     }
   }
   // ─────────────────────────────────────────────────────────────────────────────
+  // Ready Detection Settle Delay
+  // ─────────────────────────────────────────────────────────────────────────────
+  /**
+   * Schedule or reset the ready-settle timer.
+   * Defers emitting session_ready until output goes quiet for readySettleMs
+   * after detectReady first matches. This prevents sending input while
+   * TUI agents are still rendering (status bar, shortcuts, update notices).
+   */
+  scheduleReadySettle() {
+    this._readySettlePending = true;
+    if (this._readySettleTimer) {
+      clearTimeout(this._readySettleTimer);
+    }
+    const settleMs = this.adapter.readySettleMs ?? 100;
+    this._readySettleTimer = setTimeout(() => {
+      this._readySettleTimer = null;
+      this._readySettlePending = false;
+      if (this._status !== "starting" && this._status !== "authenticating") return;
+      if (!this.adapter.detectReady(this.outputBuffer)) return;
+      this._status = "ready";
+      this._lastBlockingPromptHash = null;
+      this.outputBuffer = "";
+      this.clearStallTimer();
+      this.emit("ready");
+      this.logger.info({ sessionId: this.id }, "Session ready (after settle)");
+    }, settleMs);
+  }
+  /**
+   * Cancel a pending ready-settle timer (ready indicator disappeared
+   * or session status changed).
+   */
+  cancelReadySettle() {
+    if (this._readySettleTimer) {
+      clearTimeout(this._readySettleTimer);
+      this._readySettleTimer = null;
+    }
+    this._readySettlePending = false;
+  }
+  // ─────────────────────────────────────────────────────────────────────────────
   // Lifecycle
   // ─────────────────────────────────────────────────────────────────────────────
   /**
@@ -709,13 +751,16 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
     if (this._status === "busy" || this._status === "authenticating") {
       this.resetStallTimer();
     }
+    if (this._readySettlePending) {
+      if ((this._status === "starting" || this._status === "authenticating") && this.adapter.detectReady(this.outputBuffer)) {
+        this.scheduleReadySettle();
+      } else {
+        this.cancelReadySettle();
+      }
+      return;
+    }
     if ((this._status === "starting" || this._status === "authenticating") && this.adapter.detectReady(this.outputBuffer)) {
-      this._status = "ready";
-      this._lastBlockingPromptHash = null;
-      this.outputBuffer = "";
-      this.clearStallTimer();
-      this.emit("ready");
-      this.logger.info({ sessionId: this.id }, "Session ready");
+      this.scheduleReadySettle();
       return;
     }
     if (this._status === "busy" && this.adapter.detectReady(this.outputBuffer)) {
@@ -1051,6 +1096,7 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
       this._status = "stopping";
       this.clearStallTimer();
       this.cancelTaskComplete();
+      this.cancelReadySettle();
       this.ptyProcess.kill(signal);
       this.logger.info({ sessionId: this.id, signal }, "Killing PTY session");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pty-manager",
-  "version": "1.3.3",
+  "version": "1.5.0",
   "description": "PTY session manager with lifecycle management, pluggable adapters, and blocking prompt detection",
   "main": "dist/index.js",
   "module": "dist/index.mjs",