pty-manager 1.2.21 → 1.2.22

package/dist/index.d.mts

@@ -405,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
@@ -433,6 +435,8 @@ declare class PTYSession extends EventEmitter {
     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);
@@ -501,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
      */
@@ -612,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

@@ -405,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
@@ -433,6 +435,8 @@ declare class PTYSession extends EventEmitter {
     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);
@@ -501,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
      */
@@ -612,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;
@@ -344,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() {
@@ -519,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;
   }
@@ -580,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
   // ─────────────────────────────────────────────────────────────────────────────
   /**
@@ -641,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;
@@ -654,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") {
@@ -876,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}`,
@@ -986,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");
     }
@@ -1139,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);
@@ -1992,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) {