pty-manager 1.2.14 → 1.2.16

package/dist/index.d.mts

@@ -125,6 +125,10 @@ interface AutoResponseRule {
     type: BlockingPromptType;
     /** Response to send automatically */
     response: string;
+    /** How to deliver the response: 'text' writes raw text + CR, 'keys' sends key sequences (default: 'text') */
+    responseType?: 'text' | 'keys';
+    /** Key names to send when responseType is 'keys' (e.g. ['down', 'enter']) */
+    keys?: string[];
     /** Human-readable description of what this does */
     description: string;
     /** Whether this is safe to auto-respond (default: true) */
@@ -271,6 +275,12 @@ interface CLIAdapter {
      * These are applied automatically during startup and execution.
      */
     readonly autoResponseRules?: AutoResponseRule[];
+    /**
+     * Whether this CLI uses TUI menus that require arrow-key navigation.
+     * When true, auto-response rules without an explicit responseType
+     * default to sending Enter via sendKeys instead of writeRaw.
+     */
+    readonly usesTuiMenus?: boolean;
     /**
      * Get the CLI command to execute
      */
@@ -443,7 +453,7 @@ declare class PTYSession extends EventEmitter {
     clearAutoResponseRules(): void;
     /**
      * Start or reset the stall detection timer.
-     * Only active when status is "busy" and stall detection is enabled.
+     * Active when status is "busy" or "authenticating" and stall detection is enabled.
      */
     private resetStallTimer;
     /**
@@ -454,6 +464,10 @@ declare class PTYSession extends EventEmitter {
      * Called when the stall timer fires (no output for stallTimeoutMs).
      */
     private onStallTimerFired;
+    /**
+     * Promise-based delay helper.
+     */
+    private delay;
     /**
      * Simple string hash for deduplication.
      */
@@ -523,6 +537,16 @@ declare class PTYSession extends EventEmitter {
      * @param keys - Key name(s) to send, e.g. "ctrl+c" or ["up", "up", "enter"]
      */
     sendKeys(keys: string | string[]): void;
+    /**
+     * Select a TUI menu option by index (0-based).
+     * Sends Down arrow `optionIndex` times, then Enter, with 50ms delays.
+     */
+    selectMenuOption(optionIndex: number): Promise<void>;
+    /**
+     * Send a sequence of keys with staggered timing.
+     * Each key is sent 50ms apart using setTimeout to keep the caller synchronous.
+     */
+    private sendKeySequence;
     /**
      * Paste text using bracketed paste mode
      *
@@ -689,6 +713,11 @@ declare abstract class BaseCLIAdapter implements CLIAdapter {
      * Subclasses should override this to add CLI-specific rules.
      */
     readonly autoResponseRules: AutoResponseRule[];
+    /**
+     * Whether this CLI uses TUI menus requiring arrow-key navigation.
+     * Defaults to false; coding agent adapters override to true.
+     */
+    readonly usesTuiMenus: boolean;
     abstract getCommand(): string;
     abstract getArgs(config: SpawnConfig): string[];
     abstract getEnv(config: SpawnConfig): Record<string, string>;
@@ -926,6 +955,10 @@ declare class BunCompatiblePTYManager extends EventEmitter {
      * Get all auto-response rules for a session.
      */
     getAutoResponseRules(sessionId: string): Promise<AutoResponseRule[]>;
+    /**
+     * Select a TUI menu option by index (0-based) in a session.
+     */
+    selectMenuOption(id: string, optionIndex: number): Promise<void>;
     /**
      * Clear all auto-response rules for a session.
      */

package/dist/index.d.ts

@@ -125,6 +125,10 @@ interface AutoResponseRule {
     type: BlockingPromptType;
     /** Response to send automatically */
     response: string;
+    /** How to deliver the response: 'text' writes raw text + CR, 'keys' sends key sequences (default: 'text') */
+    responseType?: 'text' | 'keys';
+    /** Key names to send when responseType is 'keys' (e.g. ['down', 'enter']) */
+    keys?: string[];
     /** Human-readable description of what this does */
     description: string;
     /** Whether this is safe to auto-respond (default: true) */
@@ -271,6 +275,12 @@ interface CLIAdapter {
      * These are applied automatically during startup and execution.
      */
     readonly autoResponseRules?: AutoResponseRule[];
+    /**
+     * Whether this CLI uses TUI menus that require arrow-key navigation.
+     * When true, auto-response rules without an explicit responseType
+     * default to sending Enter via sendKeys instead of writeRaw.
+     */
+    readonly usesTuiMenus?: boolean;
     /**
      * Get the CLI command to execute
      */
@@ -443,7 +453,7 @@ declare class PTYSession extends EventEmitter {
     clearAutoResponseRules(): void;
     /**
      * Start or reset the stall detection timer.
-     * Only active when status is "busy" and stall detection is enabled.
+     * Active when status is "busy" or "authenticating" and stall detection is enabled.
      */
     private resetStallTimer;
     /**
@@ -454,6 +464,10 @@ declare class PTYSession extends EventEmitter {
      * Called when the stall timer fires (no output for stallTimeoutMs).
      */
     private onStallTimerFired;
+    /**
+     * Promise-based delay helper.
+     */
+    private delay;
     /**
      * Simple string hash for deduplication.
      */
@@ -523,6 +537,16 @@ declare class PTYSession extends EventEmitter {
      * @param keys - Key name(s) to send, e.g. "ctrl+c" or ["up", "up", "enter"]
      */
     sendKeys(keys: string | string[]): void;
+    /**
+     * Select a TUI menu option by index (0-based).
+     * Sends Down arrow `optionIndex` times, then Enter, with 50ms delays.
+     */
+    selectMenuOption(optionIndex: number): Promise<void>;
+    /**
+     * Send a sequence of keys with staggered timing.
+     * Each key is sent 50ms apart using setTimeout to keep the caller synchronous.
+     */
+    private sendKeySequence;
     /**
      * Paste text using bracketed paste mode
      *
@@ -689,6 +713,11 @@ declare abstract class BaseCLIAdapter implements CLIAdapter {
      * Subclasses should override this to add CLI-specific rules.
      */
     readonly autoResponseRules: AutoResponseRule[];
+    /**
+     * Whether this CLI uses TUI menus requiring arrow-key navigation.
+     * Defaults to false; coding agent adapters override to true.
+     */
+    readonly usesTuiMenus: boolean;
     abstract getCommand(): string;
     abstract getArgs(config: SpawnConfig): string[];
     abstract getEnv(config: SpawnConfig): Record<string, string>;
@@ -926,6 +955,10 @@ declare class BunCompatiblePTYManager extends EventEmitter {
      * Get all auto-response rules for a session.
      */
     getAutoResponseRules(sessionId: string): Promise<AutoResponseRule[]>;
+    /**
+     * Select a TUI menu option by index (0-based) in a session.
+     */
+    selectMenuOption(id: string, optionIndex: number): Promise<void>;
     /**
      * Clear all auto-response rules for a session.
      */

package/dist/index.js

@@ -416,11 +416,11 @@ var PTYSession = class extends import_events.EventEmitter {
   // ─────────────────────────────────────────────────────────────────────────────
   /**
    * Start or reset the stall detection timer.
-   * Only active when status is "busy" and stall detection is enabled.
+   * Active when status is "busy" or "authenticating" and stall detection is enabled.
    */
   resetStallTimer() {
     this.clearStallTimer();
-    if (!this._stallDetectionEnabled || this._status !== "busy") {
+    if (!this._stallDetectionEnabled || this._status !== "busy" && this._status !== "authenticating") {
       return;
     }
     this._stallStartedAt = Date.now();
@@ -443,7 +443,7 @@ var PTYSession = class extends import_events.EventEmitter {
    * Called when the stall timer fires (no output for stallTimeoutMs).
    */
   onStallTimerFired() {
-    if (this._status !== "busy") {
+    if (this._status !== "busy" && this._status !== "authenticating") {
       return;
     }
     const tail = this.outputBuffer.slice(-500);
@@ -463,6 +463,12 @@ var PTYSession = class extends import_events.EventEmitter {
     this.emit("stall_detected", recentOutput, stallDurationMs);
     this._stallTimer = setTimeout(() => this.onStallTimerFired(), this._stallTimeoutMs);
   }
+  /**
+   * Promise-based delay helper.
+   */
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
   /**
    * Simple string hash for deduplication.
    */
@@ -488,7 +494,7 @@ var PTYSession = class extends import_events.EventEmitter {
    * Called by the manager after onStallClassify resolves.
    */
   handleStallClassification(classification) {
-    if (this._status !== "busy") {
+    if (this._status !== "busy" && this._status !== "authenticating") {
       return;
     }
     if (!classification || classification.state === "still_working") {
@@ -507,7 +513,13 @@ var PTYSession = class extends import_events.EventEmitter {
             { sessionId: this.id, response: classification.suggestedResponse },
             "Auto-responding to stall-classified prompt"
           );
-          this.writeRaw(classification.suggestedResponse + "\r");
+          const resp = classification.suggestedResponse;
+          if (resp.startsWith("keys:")) {
+            const keys = resp.slice(5).split(",").map((k) => k.trim());
+            this.sendKeySequence(keys);
+          } else {
+            this.writeRaw(resp + "\r");
+          }
           this.emit("blocking_prompt", promptInfo, true);
         } else {
           this.emit("blocking_prompt", promptInfo, false);
@@ -586,10 +598,14 @@ var PTYSession = class extends import_events.EventEmitter {
     this.ptyProcess.onData((data) => {
       this._lastActivityAt = /* @__PURE__ */ new Date();
       this.outputBuffer += data;
-      if (this._status === "busy") {
+      if (this._status === "busy" || this._status === "authenticating") {
         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;
@@ -599,10 +615,6 @@ var PTYSession = class extends import_events.EventEmitter {
         this.logger.info({ sessionId: this.id }, "Session ready");
         return;
       }
-      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") {
@@ -670,7 +682,13 @@ var PTYSession = class extends import_events.EventEmitter {
             },
             "Auto-responding to blocking prompt"
           );
-          this.writeRaw(detection.suggestedResponse + "\r");
+          const resp = detection.suggestedResponse;
+          if (resp.startsWith("keys:")) {
+            const keys = resp.slice(5).split(",").map((k) => k.trim());
+            this.sendKeySequence(keys);
+          } else {
+            this.writeRaw(resp + "\r");
+          }
           this._lastBlockingPromptHash = null;
           this.emit("blocking_prompt", promptInfo, true);
           return true;
@@ -722,7 +740,15 @@ var PTYSession = class extends import_events.EventEmitter {
             },
             "Applying auto-response rule"
           );
-          this.writeRaw(rule.response + "\r");
+          const useKeys = rule.keys && rule.keys.length > 0;
+          const isTuiDefault = !rule.responseType && !rule.keys && this.adapter.usesTuiMenus;
+          if (useKeys) {
+            this.sendKeySequence(rule.keys);
+          } else if (isTuiDefault) {
+            this.sendKeys("enter");
+          } else {
+            this.writeRaw(rule.response + "\r");
+          }
           this.outputBuffer = this.outputBuffer.replace(rule.pattern, "");
           const promptInfo = {
             type: rule.type,
@@ -852,6 +878,26 @@ var PTYSession = class extends import_events.EventEmitter {
       }
     }
   }
+  /**
+   * Select a TUI menu option by index (0-based).
+   * Sends Down arrow `optionIndex` times, then Enter, with 50ms delays.
+   */
+  async selectMenuOption(optionIndex) {
+    for (let i = 0; i < optionIndex; i++) {
+      this.sendKeys("down");
+      await this.delay(50);
+    }
+    this.sendKeys("enter");
+  }
+  /**
+   * Send a sequence of keys with staggered timing.
+   * Each key is sent 50ms apart using setTimeout to keep the caller synchronous.
+   */
+  sendKeySequence(keys) {
+    keys.forEach((key, i) => {
+      setTimeout(() => this.sendKeys(key), i * 50);
+    });
+  }
   /**
    * Paste text using bracketed paste mode
    *
@@ -1308,6 +1354,11 @@ var BaseCLIAdapter = class {
    * Subclasses should override this to add CLI-specific rules.
    */
   autoResponseRules = [];
+  /**
+   * Whether this CLI uses TUI menus requiring arrow-key navigation.
+   * Defaults to false; coding agent adapters override to true.
+   */
+  usesTuiMenus = false;
   /**
    * Default exit detection - look for common exit patterns
    */
@@ -1928,6 +1979,8 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
           pattern: new RegExp(r.pattern, r.flags || ""),
           type: r.type,
           response: r.response,
+          responseType: r.responseType,
+          keys: r.keys,
           description: r.description,
           safe: r.safe
         }));
@@ -2080,6 +2133,8 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
       flags: rule.pattern.flags || void 0,
       type: rule.type,
       response: rule.response,
+      responseType: rule.responseType,
+      keys: rule.keys,
       description: rule.description,
       safe: rule.safe
     };
@@ -2131,6 +2186,14 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
     const rules = await this.createPending(`getRules:${sessionId}`);
     return rules;
   }
+  /**
+   * Select a TUI menu option by index (0-based) in a session.
+   */
+  async selectMenuOption(id, optionIndex) {
+    await this.waitForReady();
+    this.sendCommand({ cmd: "selectMenuOption", id, optionIndex });
+    await this.createPending(`selectMenuOption:${id}`);
+  }
   /**
    * Clear all auto-response rules for a session.
    */