pty-manager 1.2.20 → 1.2.22

package/dist/index.d.mts

@@ -37,6 +37,11 @@ interface SpawnConfig {
     adapterConfig?: Record<string, unknown>;
     /** Per-session stall timeout in ms. Overrides PTYManagerConfig.stallTimeoutMs. */
     stallTimeoutMs?: number;
+    /** Override or disable specific adapter auto-response rules for this session.
+     *  Keys are regex source strings (from rule.pattern.source).
+     *  - null value disables that rule entirely
+     *  - Object value merges fields into the matching adapter rule */
+    ruleOverrides?: Record<string, Partial<Omit<AutoResponseRule, 'pattern'>> | null>;
 }
 /**
  * Handle to a running session
@@ -400,6 +405,8 @@ interface PTYSessionEvents {
     exit: (code: number) => void;
     error: (error: Error) => void;
     stall_detected: (recentOutput: string, stallDurationMs: number) => void;
+    status_changed: (status: SessionStatus) => void;
+    task_complete: () => void;
 }
 /**
  * Special key mappings to escape sequences
@@ -420,12 +427,16 @@ declare class PTYSession extends EventEmitter {
     private sessionRules;
     private _firedOnceRules;
     private _lastBlockingPromptHash;
+    private _ruleOverrides;
+    private _disabledRulePatterns;
     private _stallTimer;
     private _stallTimeoutMs;
     private _stallDetectionEnabled;
     private _lastStallHash;
     private _stallStartedAt;
     private _lastContentHash;
+    private _taskCompleteTimer;
+    private static readonly TASK_COMPLETE_DEBOUNCE_MS;
     readonly id: string;
     readonly config: SpawnConfig;
     constructor(adapter: CLIAdapter, config: SpawnConfig, logger?: Logger, stallDetectionEnabled?: boolean, defaultStallTimeoutMs?: number);
@@ -494,6 +505,17 @@ declare class PTYSession extends EventEmitter {
      * Called by the manager after onStallClassify resolves.
      */
     handleStallClassification(classification: StallClassification | null): void;
+    /**
+     * Schedule a task_complete transition after a debounce period.
+     * If new non-whitespace output arrives before the timer fires,
+     * the timer is cancelled (by cancelTaskComplete in onData).
+     */
+    private scheduleTaskComplete;
+    /**
+     * Cancel a pending task_complete timer (new output arrived that
+     * doesn't match the idle prompt, so the agent is still working).
+     */
+    private cancelTaskComplete;
     /**
      * Start the PTY session
      */
@@ -605,6 +627,8 @@ interface PTYManagerEvents {
     message: (message: SessionMessage) => void;
     question: (session: SessionHandle, question: string) => void;
     stall_detected: (session: SessionHandle, recentOutput: string, stallDurationMs: number) => void;
+    session_status_changed: (session: SessionHandle) => void;
+    task_complete: (session: SessionHandle) => void;
 }
 declare class PTYManager extends EventEmitter {
     private sessions;

package/dist/index.d.ts

@@ -37,6 +37,11 @@ interface SpawnConfig {
     adapterConfig?: Record<string, unknown>;
     /** Per-session stall timeout in ms. Overrides PTYManagerConfig.stallTimeoutMs. */
     stallTimeoutMs?: number;
+    /** Override or disable specific adapter auto-response rules for this session.
+     *  Keys are regex source strings (from rule.pattern.source).
+     *  - null value disables that rule entirely
+     *  - Object value merges fields into the matching adapter rule */
+    ruleOverrides?: Record<string, Partial<Omit<AutoResponseRule, 'pattern'>> | null>;
 }
 /**
  * Handle to a running session
@@ -400,6 +405,8 @@ interface PTYSessionEvents {
     exit: (code: number) => void;
     error: (error: Error) => void;
     stall_detected: (recentOutput: string, stallDurationMs: number) => void;
+    status_changed: (status: SessionStatus) => void;
+    task_complete: () => void;
 }
 /**
  * Special key mappings to escape sequences
@@ -420,12 +427,16 @@ declare class PTYSession extends EventEmitter {
     private sessionRules;
     private _firedOnceRules;
     private _lastBlockingPromptHash;
+    private _ruleOverrides;
+    private _disabledRulePatterns;
     private _stallTimer;
     private _stallTimeoutMs;
     private _stallDetectionEnabled;
     private _lastStallHash;
     private _stallStartedAt;
     private _lastContentHash;
+    private _taskCompleteTimer;
+    private static readonly TASK_COMPLETE_DEBOUNCE_MS;
     readonly id: string;
     readonly config: SpawnConfig;
     constructor(adapter: CLIAdapter, config: SpawnConfig, logger?: Logger, stallDetectionEnabled?: boolean, defaultStallTimeoutMs?: number);
@@ -494,6 +505,17 @@ declare class PTYSession extends EventEmitter {
      * Called by the manager after onStallClassify resolves.
      */
     handleStallClassification(classification: StallClassification | null): void;
+    /**
+     * Schedule a task_complete transition after a debounce period.
+     * If new non-whitespace output arrives before the timer fires,
+     * the timer is cancelled (by cancelTaskComplete in onData).
+     */
+    private scheduleTaskComplete;
+    /**
+     * Cancel a pending task_complete timer (new output arrived that
+     * doesn't match the idle prompt, so the agent is still working).
+     */
+    private cancelTaskComplete;
     /**
      * Start the PTY session
      */
@@ -605,6 +627,8 @@ interface PTYManagerEvents {
     message: (message: SessionMessage) => void;
     question: (session: SessionHandle, question: string) => void;
     stall_detected: (session: SessionHandle, recentOutput: string, stallDurationMs: number) => void;
+    session_status_changed: (session: SessionHandle) => void;
+    task_complete: (session: SessionHandle) => void;
 }
 declare class PTYManager extends EventEmitter {
     private sessions;

package/dist/index.js

@@ -306,7 +306,7 @@ var SPECIAL_KEYS = {
 };
 var BRACKETED_PASTE_START = "\x1B[200~";
 var BRACKETED_PASTE_END = "\x1B[201~";
-var PTYSession = class extends import_events.EventEmitter {
+var PTYSession = class _PTYSession extends import_events.EventEmitter {
   constructor(adapter, config, logger, stallDetectionEnabled, defaultStallTimeoutMs) {
     super();
     this.adapter = adapter;
@@ -315,6 +315,15 @@ var PTYSession = class extends import_events.EventEmitter {
     this.logger = logger || consoleLogger;
     this._stallDetectionEnabled = stallDetectionEnabled ?? false;
     this._stallTimeoutMs = config.stallTimeoutMs ?? defaultStallTimeoutMs ?? 8e3;
+    if (config.ruleOverrides) {
+      for (const [key, value] of Object.entries(config.ruleOverrides)) {
+        if (value === null) {
+          this._disabledRulePatterns.add(key);
+        } else {
+          this._ruleOverrides.set(key, value);
+        }
+      }
+    }
   }
   ptyProcess = null;
   outputBuffer = "";
@@ -326,6 +335,8 @@ var PTYSession = class extends import_events.EventEmitter {
   sessionRules = [];
   _firedOnceRules = /* @__PURE__ */ new Set();
   _lastBlockingPromptHash = null;
+  _ruleOverrides = /* @__PURE__ */ new Map();
+  _disabledRulePatterns = /* @__PURE__ */ new Set();
   // Stall detection
   _stallTimer = null;
   _stallTimeoutMs;
@@ -333,6 +344,9 @@ var PTYSession = class extends import_events.EventEmitter {
   _lastStallHash = null;
   _stallStartedAt = null;
   _lastContentHash = null;
+  // Task completion detection (idle detection when busy)
+  _taskCompleteTimer = null;
+  static TASK_COMPLETE_DEBOUNCE_MS = 1500;
   id;
   config;
   get status() {
@@ -508,10 +522,12 @@ var PTYSession = class extends import_events.EventEmitter {
    * word boundaries — e.g. "Do\x1b[5Cyou" becomes "Do you", not "Doyou".
    */
   stripAnsiForStall(str) {
-    let result = str.replace(/\x1b\[\d*[CDABG]/g, " ");
+    let result = str.replace(/\x1b\[\d*[CDABGdEF]/g, " ");
     result = result.replace(/\x1b\[\d*(?:;\d+)?[Hf]/g, " ");
+    result = result.replace(/\x1b\[\d*[JK]/g, " ");
     result = result.replace(/\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g, "");
-    result = result.replace(/[│╭╰╮╯─═╌║╔╗╚╝╠╣╦╩╬┌┐└┘├┤┬┴┼●○❯❮▶◀⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⣾⣽⣻⢿⡿⣟⣯⣷✻✶✳✢⏺←→↑↓]/g, " ");
+    result = result.replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "");
+    result = result.replace(/[│╭╰╮╯─═╌║╔╗╚╝╠╣╦╩╬┌┐└┘├┤┬┴┼●○❯❮▶◀⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⣾⣽⣻⢿⡿⣟⣯⣷✻✶✳✢⏺←→↑↓⬆⬇◆◇▪▫■□▲△▼▽◈⟨⟩⌘⏎⏏⌫⌦⇧⇪⌥]/g, " ");
     result = result.replace(/ {2,}/g, " ");
     return result;
   }
@@ -548,6 +564,7 @@ var PTYSession = class extends import_events.EventEmitter {
             this.writeRaw(resp + "\r");
           }
           this.emit("blocking_prompt", promptInfo, true);
+          this.outputBuffer = "";
         } else {
           this.emit("blocking_prompt", promptInfo, false);
         }
@@ -568,6 +585,39 @@ var PTYSession = class extends import_events.EventEmitter {
     }
   }
   // ─────────────────────────────────────────────────────────────────────────────
+  // Task Completion Detection
+  // ─────────────────────────────────────────────────────────────────────────────
+  /**
+   * Schedule a task_complete transition after a debounce period.
+   * If new non-whitespace output arrives before the timer fires,
+   * the timer is cancelled (by cancelTaskComplete in onData).
+   */
+  scheduleTaskComplete() {
+    if (this._taskCompleteTimer) return;
+    this._taskCompleteTimer = setTimeout(() => {
+      this._taskCompleteTimer = null;
+      if (this._status !== "busy") return;
+      if (!this.adapter.detectReady(this.outputBuffer)) return;
+      this._status = "ready";
+      this._lastBlockingPromptHash = null;
+      this.outputBuffer = "";
+      this.clearStallTimer();
+      this.emit("status_changed", "ready");
+      this.emit("task_complete");
+      this.logger.info({ sessionId: this.id }, "Task complete \u2014 agent returned to idle prompt");
+    }, _PTYSession.TASK_COMPLETE_DEBOUNCE_MS);
+  }
+  /**
+   * Cancel a pending task_complete timer (new output arrived that
+   * doesn't match the idle prompt, so the agent is still working).
+   */
+  cancelTaskComplete() {
+    if (this._taskCompleteTimer) {
+      clearTimeout(this._taskCompleteTimer);
+      this._taskCompleteTimer = null;
+    }
+  }
+  // ─────────────────────────────────────────────────────────────────────────────
   // Lifecycle
   // ─────────────────────────────────────────────────────────────────────────────
   /**
@@ -629,10 +679,6 @@ var PTYSession = class extends import_events.EventEmitter {
         this.resetStallTimer();
       }
       this.emit("output", data);
-      const blockingPrompt = this.detectAndHandleBlockingPrompt();
-      if (blockingPrompt) {
-        return;
-      }
       if ((this._status === "starting" || this._status === "authenticating") && this.adapter.detectReady(this.outputBuffer)) {
         this._status = "ready";
         this._lastBlockingPromptHash = null;
@@ -642,6 +688,15 @@ var PTYSession = class extends import_events.EventEmitter {
         this.logger.info({ sessionId: this.id }, "Session ready");
         return;
       }
+      if (this._status === "busy" && this.adapter.detectReady(this.outputBuffer)) {
+        this.scheduleTaskComplete();
+      } else {
+        this.cancelTaskComplete();
+      }
+      const blockingPrompt = this.detectAndHandleBlockingPrompt();
+      if (blockingPrompt) {
+        return;
+      }
       if (this._status !== "ready" && this._status !== "busy") {
         const loginDetection = this.adapter.detectLogin(this.outputBuffer);
         if (loginDetection.required && this._status !== "authenticating") {
@@ -717,6 +772,7 @@ var PTYSession = class extends import_events.EventEmitter {
             this.writeRaw(resp + "\r");
           }
           this._lastBlockingPromptHash = null;
+          this.outputBuffer = "";
           this.emit("blocking_prompt", promptInfo, true);
           return true;
         }
@@ -744,7 +800,10 @@ var PTYSession = class extends import_events.EventEmitter {
    * Session rules are checked first, then adapter rules.
    */
   tryAutoResponse() {
-    const adapterRules = this.adapter.autoResponseRules || [];
+    const adapterRules = (this.adapter.autoResponseRules || []).filter((r) => !this._disabledRulePatterns.has(r.pattern.source)).map((r) => {
+      const override = this._ruleOverrides.get(r.pattern.source);
+      return override ? { ...r, ...override } : r;
+    });
     const allRules = [...this.sessionRules, ...adapterRules];
     if (allRules.length === 0) {
       return false;
@@ -860,6 +919,7 @@ var PTYSession = class extends import_events.EventEmitter {
    */
   send(message) {
     this._status = "busy";
+    this.emit("status_changed", "busy");
     this.resetStallTimer();
     const msg = {
       id: `${this.id}-msg-${++this.messageCounter}`,
@@ -970,6 +1030,7 @@ var PTYSession = class extends import_events.EventEmitter {
     if (this.ptyProcess) {
       this._status = "stopping";
       this.clearStallTimer();
+      this.cancelTaskComplete();
       this.ptyProcess.kill(signal);
       this.logger.info({ sessionId: this.id, signal }, "Killing PTY session");
     }
@@ -1123,6 +1184,12 @@ var PTYManager = class extends import_events2.EventEmitter {
     session.on("error", (error) => {
       this.emit("session_error", session.toHandle(), error.message);
     });
+    session.on("status_changed", () => {
+      this.emit("session_status_changed", session.toHandle());
+    });
+    session.on("task_complete", () => {
+      this.emit("task_complete", session.toHandle());
+    });
     session.on("stall_detected", (recentOutput, stallDurationMs) => {
       const handle = session.toHandle();
       this.emit("stall_detected", handle, recentOutput, stallDurationMs);
@@ -1976,6 +2043,24 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
         }
         break;
       }
+      case "status_changed": {
+        const session = this.sessions.get(id);
+        if (session) {
+          session.status = event.status;
+          session.lastActivityAt = /* @__PURE__ */ new Date();
+          this.emit("session_status_changed", session);
+        }
+        break;
+      }
+      case "task_complete": {
+        const session = this.sessions.get(id);
+        if (session) {
+          session.status = "ready";
+          session.lastActivityAt = /* @__PURE__ */ new Date();
+          this.emit("task_complete", session);
+        }
+        break;
+      }
       case "stall_detected": {
         const session = this.sessions.get(id);
         if (session) {