pty-manager 1.2.16 → 1.2.18

package/dist/index.d.mts

@@ -133,6 +133,8 @@ interface AutoResponseRule {
     description: string;
     /** Whether this is safe to auto-respond (default: true) */
     safe?: boolean;
+    /** Fire this rule at most once per session (prevents thrashing on TUI re-renders) */
+    once?: boolean;
 }
 /**
  * Blocking prompt info for events
@@ -416,12 +418,14 @@ declare class PTYSession extends EventEmitter {
     private messageCounter;
     private logger;
     private sessionRules;
+    private _firedOnceRules;
     private _lastBlockingPromptHash;
     private _stallTimer;
     private _stallTimeoutMs;
     private _stallDetectionEnabled;
     private _lastStallHash;
     private _stallStartedAt;
+    private _lastContentHash;
     readonly id: string;
     readonly config: SpawnConfig;
     constructor(adapter: CLIAdapter, config: SpawnConfig, logger?: Logger, stallDetectionEnabled?: boolean, defaultStallTimeoutMs?: number);
@@ -454,6 +458,11 @@ declare class PTYSession extends EventEmitter {
     /**
      * Start or reset the stall detection timer.
      * Active when status is "busy" or "authenticating" and stall detection is enabled.
+     *
+     * Content-based: hashes the ANSI-stripped buffer tail and only resets the
+     * timer when visible content actually changes. This prevents TUI spinners
+     * (which produce new ANSI sequences but no new visible text) from endlessly
+     * resetting the timer.
      */
     private resetStallTimer;
     /**
@@ -473,8 +482,11 @@ declare class PTYSession extends EventEmitter {
      */
     private simpleHash;
     /**
-     * Strip ANSI codes for stall detection output.
-     * Replaces cursor-forward sequences with spaces first.
+     * Strip ANSI codes, cursor movement, box-drawing, and spinner characters.
+     * Used for stall detection hashing and auto-response pattern matching.
+     *
+     * Cursor movement codes are replaced with spaces (not removed) to preserve
+     * word boundaries — e.g. "Do\x1b[5Cyou" becomes "Do you", not "Doyou".
      */
     private stripAnsiForStall;
     /**
@@ -829,7 +841,7 @@ interface WorkerSessionHandle {
     id: string;
     name: string;
     type: string;
-    status: 'starting' | 'ready' | 'stopped' | 'error';
+    status: SessionStatus;
     pid: number | undefined;
     cols: number;
     rows: number;

package/dist/index.d.ts

@@ -133,6 +133,8 @@ interface AutoResponseRule {
     description: string;
     /** Whether this is safe to auto-respond (default: true) */
     safe?: boolean;
+    /** Fire this rule at most once per session (prevents thrashing on TUI re-renders) */
+    once?: boolean;
 }
 /**
  * Blocking prompt info for events
@@ -416,12 +418,14 @@ declare class PTYSession extends EventEmitter {
     private messageCounter;
     private logger;
     private sessionRules;
+    private _firedOnceRules;
     private _lastBlockingPromptHash;
     private _stallTimer;
     private _stallTimeoutMs;
     private _stallDetectionEnabled;
     private _lastStallHash;
     private _stallStartedAt;
+    private _lastContentHash;
     readonly id: string;
     readonly config: SpawnConfig;
     constructor(adapter: CLIAdapter, config: SpawnConfig, logger?: Logger, stallDetectionEnabled?: boolean, defaultStallTimeoutMs?: number);
@@ -454,6 +458,11 @@ declare class PTYSession extends EventEmitter {
     /**
      * Start or reset the stall detection timer.
      * Active when status is "busy" or "authenticating" and stall detection is enabled.
+     *
+     * Content-based: hashes the ANSI-stripped buffer tail and only resets the
+     * timer when visible content actually changes. This prevents TUI spinners
+     * (which produce new ANSI sequences but no new visible text) from endlessly
+     * resetting the timer.
      */
     private resetStallTimer;
     /**
@@ -473,8 +482,11 @@ declare class PTYSession extends EventEmitter {
      */
     private simpleHash;
     /**
-     * Strip ANSI codes for stall detection output.
-     * Replaces cursor-forward sequences with spaces first.
+     * Strip ANSI codes, cursor movement, box-drawing, and spinner characters.
+     * Used for stall detection hashing and auto-response pattern matching.
+     *
+     * Cursor movement codes are replaced with spaces (not removed) to preserve
+     * word boundaries — e.g. "Do\x1b[5Cyou" becomes "Do you", not "Doyou".
      */
     private stripAnsiForStall;
     /**
@@ -829,7 +841,7 @@ interface WorkerSessionHandle {
     id: string;
     name: string;
     type: string;
-    status: 'starting' | 'ready' | 'stopped' | 'error';
+    status: SessionStatus;
     pid: number | undefined;
     cols: number;
     rows: number;

package/dist/index.js

@@ -324,6 +324,7 @@ var PTYSession = class extends import_events.EventEmitter {
   messageCounter = 0;
   logger;
   sessionRules = [];
+  _firedOnceRules = /* @__PURE__ */ new Set();
   _lastBlockingPromptHash = null;
   // Stall detection
   _stallTimer = null;
@@ -331,6 +332,7 @@ var PTYSession = class extends import_events.EventEmitter {
   _stallDetectionEnabled;
   _lastStallHash = null;
   _stallStartedAt = null;
+  _lastContentHash = null;
   id;
   config;
   get status() {
@@ -417,12 +419,28 @@ var PTYSession = class extends import_events.EventEmitter {
   /**
    * Start or reset the stall detection timer.
    * Active when status is "busy" or "authenticating" and stall detection is enabled.
+   *
+   * Content-based: hashes the ANSI-stripped buffer tail and only resets the
+   * timer when visible content actually changes. This prevents TUI spinners
+   * (which produce new ANSI sequences but no new visible text) from endlessly
+   * resetting the timer.
    */
   resetStallTimer() {
-    this.clearStallTimer();
     if (!this._stallDetectionEnabled || this._status !== "busy" && this._status !== "authenticating") {
+      this.clearStallTimer();
+      return;
+    }
+    const tail = this.outputBuffer.slice(-500);
+    const stripped = this.stripAnsiForStall(tail).trim();
+    const hash = this.simpleHash(stripped);
+    if (hash === this._lastContentHash) {
       return;
     }
+    this._lastContentHash = hash;
+    if (this._stallTimer) {
+      clearTimeout(this._stallTimer);
+      this._stallTimer = null;
+    }
     this._stallStartedAt = Date.now();
     this._lastStallHash = null;
     this._stallTimer = setTimeout(() => {
@@ -438,6 +456,7 @@ var PTYSession = class extends import_events.EventEmitter {
       this._stallTimer = null;
     }
     this._stallStartedAt = null;
+    this._lastContentHash = null;
   }
   /**
    * Called when the stall timer fires (no output for stallTimeoutMs).
@@ -482,12 +501,19 @@ var PTYSession = class extends import_events.EventEmitter {
     return hash.toString(36);
   }
   /**
-   * Strip ANSI codes for stall detection output.
-   * Replaces cursor-forward sequences with spaces first.
+   * Strip ANSI codes, cursor movement, box-drawing, and spinner characters.
+   * Used for stall detection hashing and auto-response pattern matching.
+   *
+   * Cursor movement codes are replaced with spaces (not removed) to preserve
+   * word boundaries — e.g. "Do\x1b[5Cyou" becomes "Do you", not "Doyou".
    */
   stripAnsiForStall(str) {
-    const withSpaces = str.replace(/\x1b\[\d*C/g, " ");
-    return withSpaces.replace(/\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g, "");
+    let result = str.replace(/\x1b\[\d*[CDABG]/g, " ");
+    result = result.replace(/\x1b\[\d*(?:;\d+)?[Hf]/g, " ");
+    result = result.replace(/\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g, "");
+    result = result.replace(/[│╭╰╮╯─═╌║╔╗╚╝╠╣╦╩╬┌┐└┘├┤┬┴┼●○❯❮▶◀⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⣾⣽⣻⢿⡿⣟⣯⣷✻✶✳✢⏺←→↑↓]/g, " ");
+    result = result.replace(/ {2,}/g, " ");
+    return result;
   }
   /**
    * Handle external stall classification result.
@@ -498,6 +524,7 @@ var PTYSession = class extends import_events.EventEmitter {
       return;
     }
     if (!classification || classification.state === "still_working") {
+      this._lastContentHash = null;
       this.resetStallTimer();
       return;
     }
@@ -722,10 +749,14 @@ var PTYSession = class extends import_events.EventEmitter {
     if (allRules.length === 0) {
       return false;
     }
-    let stripped = this.stripAnsiForStall(this.outputBuffer);
-    stripped = stripped.replace(/[│╭╰╮╯─═╌║╔╗╚╝╠╣╦╩╬┌┐└┘├┤┬┴┼●○❯❮▶◀⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⏺←→↑↓]/g, " ");
-    stripped = stripped.replace(/ {2,}/g, " ");
+    const stripped = this.stripAnsiForStall(this.outputBuffer);
     for (const rule of allRules) {
+      if (rule.once) {
+        const ruleKey = `${rule.pattern.source}:${rule.pattern.flags}`;
+        if (this._firedOnceRules.has(ruleKey)) {
+          continue;
+        }
+      }
       if (rule.pattern.test(stripped)) {
         const safe = rule.safe !== false;
         const isSessionRule = this.sessionRules.includes(rule);
@@ -749,6 +780,10 @@ var PTYSession = class extends import_events.EventEmitter {
           } else {
             this.writeRaw(rule.response + "\r");
           }
+          if (rule.once) {
+            const ruleKey = `${rule.pattern.source}:${rule.pattern.flags}`;
+            this._firedOnceRules.add(ruleKey);
+          }
           this.outputBuffer = this.outputBuffer.replace(rule.pattern, "");
           const promptInfo = {
             type: rule.type,
@@ -1921,6 +1956,7 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
       case "login_required": {
         const session = this.sessions.get(id);
         if (session) {
+          session.status = "authenticating";
           this.emit("login_required", session, event.instructions, event.url);
         }
         break;
@@ -1982,7 +2018,8 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
           responseType: r.responseType,
           keys: r.keys,
           description: r.description,
-          safe: r.safe
+          safe: r.safe,
+          once: r.once
         }));
         this.resolvePending(`getRules:${id}`, rules);
         break;
@@ -2136,7 +2173,8 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
       responseType: rule.responseType,
       keys: rule.keys,
       description: rule.description,
-      safe: rule.safe
+      safe: rule.safe,
+      once: rule.once
     };
   }
   /**