pty-manager 1.6.8 → 1.7.0

package/dist/index.d.mts

@@ -48,6 +48,10 @@ interface SpawnConfig {
      *  - null value disables that rule entirely
      *  - Object value merges fields into the matching adapter rule */
     ruleOverrides?: Record<string, Partial<Omit<AutoResponseRule, 'pattern'>> | null>;
+    /** When true, adapter detectBlockingPrompt() results with suggestedResponse
+     *  are emitted as autoResponded=false instead of being auto-responded.
+     *  Auto-response rules (ruleOverrides) are unaffected. */
+    skipAdapterAutoResponse?: boolean;
 }
 /**
  * Handle to a running session
@@ -99,8 +103,23 @@ interface LoginDetection {
     required: boolean;
     type?: 'api_key' | 'oauth' | 'browser' | 'device_code';
     url?: string;
+    deviceCode?: string;
     instructions?: string;
 }
+/**
+ * Normalized authentication methods for runtime event consumers.
+ */
+type AuthRequiredMethod = 'api_key' | 'oauth_browser' | 'device_code' | 'unknown';
+/**
+ * Structured authentication-required payload emitted by PTY session/manager.
+ */
+interface AuthRequiredInfo {
+    method: AuthRequiredMethod;
+    url?: string;
+    deviceCode?: string;
+    instructions?: string;
+    promptSnippet?: string;
+}
 /**
  * Types of blocking prompts that can occur
  */
@@ -425,6 +444,7 @@ interface PTYSessionEvents {
     output: (data: string) => void;
     ready: () => void;
     login_required: (instructions?: string, url?: string) => void;
+    auth_required: (info: AuthRequiredInfo) => void;
     blocking_prompt: (prompt: BlockingPromptInfo, autoResponded: boolean) => void;
     message: (message: SessionMessage) => void;
     question: (question: string) => void;
@@ -527,6 +547,10 @@ declare class PTYSession extends EventEmitter {
      * Simple string hash for deduplication.
      */
     private simpleHash;
+    private mapLoginTypeToAuthMethod;
+    private extractDeviceCode;
+    private getPromptSnippet;
+    private emitAuthRequired;
     /**
      * Strip ANSI codes, cursor movement, box-drawing, and spinner characters.
      * Used for stall detection hashing and auto-response pattern matching.
@@ -697,6 +721,7 @@ interface PTYManagerEvents {
     session_stopped: (session: SessionHandle, reason: string) => void;
     session_error: (session: SessionHandle, error: string) => void;
     login_required: (session: SessionHandle, instructions?: string, url?: string) => void;
+    auth_required: (session: SessionHandle, info: AuthRequiredInfo) => void;
     blocking_prompt: (session: SessionHandle, promptInfo: BlockingPromptInfo, autoResponded: boolean) => void;
     message: (message: SessionMessage) => void;
     question: (session: SessionHandle, question: string) => void;
@@ -1156,4 +1181,4 @@ declare function isBun(): boolean;
  */
 declare function createPTYManager(options?: BunPTYManagerOptions): BunCompatiblePTYManager;
 
-export { type AdapterFactoryConfig, AdapterRegistry, type AutoResponseRule, BaseCLIAdapter, type BlockingPromptDetection, type BlockingPromptInfo, type BlockingPromptType, type BuildTimelineOptions, BunCompatiblePTYManager, type BunPTYManagerOptions, type CLIAdapter, type LogOptions, type Logger, type LoginDetection, type MessageType, PTYManager, type PTYManagerConfig, type PTYManagerEvents, PTYSession, type PTYSessionEvents, type ParsedOutput, SPECIAL_KEYS, type SessionFilter, type SessionHandle, type SessionMessage, type SessionStatus, ShellAdapter, type ShellAdapterOptions, type SpawnConfig, type StallClassification, type StopOptions, type TaskCompletionTimelineResult, type TaskCompletionTimelineStep, type TaskCompletionTraceRecord, type TaskCompletionTurnTimeline, type TerminalAttachment, type WorkerSessionHandle, buildTaskCompletionTimeline, createAdapter, createPTYManager, extractTaskCompletionTraceRecords, isBun };
+export { type AdapterFactoryConfig, AdapterRegistry, type AuthRequiredInfo, type AuthRequiredMethod, type AutoResponseRule, BaseCLIAdapter, type BlockingPromptDetection, type BlockingPromptInfo, type BlockingPromptType, type BuildTimelineOptions, BunCompatiblePTYManager, type BunPTYManagerOptions, type CLIAdapter, type LogOptions, type Logger, type LoginDetection, type MessageType, PTYManager, type PTYManagerConfig, type PTYManagerEvents, PTYSession, type PTYSessionEvents, type ParsedOutput, SPECIAL_KEYS, type SessionFilter, type SessionHandle, type SessionMessage, type SessionStatus, ShellAdapter, type ShellAdapterOptions, type SpawnConfig, type StallClassification, type StopOptions, type TaskCompletionTimelineResult, type TaskCompletionTimelineStep, type TaskCompletionTraceRecord, type TaskCompletionTurnTimeline, type TerminalAttachment, type WorkerSessionHandle, buildTaskCompletionTimeline, createAdapter, createPTYManager, extractTaskCompletionTraceRecords, isBun };

package/dist/index.d.ts

@@ -48,6 +48,10 @@ interface SpawnConfig {
      *  - null value disables that rule entirely
      *  - Object value merges fields into the matching adapter rule */
     ruleOverrides?: Record<string, Partial<Omit<AutoResponseRule, 'pattern'>> | null>;
+    /** When true, adapter detectBlockingPrompt() results with suggestedResponse
+     *  are emitted as autoResponded=false instead of being auto-responded.
+     *  Auto-response rules (ruleOverrides) are unaffected. */
+    skipAdapterAutoResponse?: boolean;
 }
 /**
  * Handle to a running session
@@ -99,8 +103,23 @@ interface LoginDetection {
     required: boolean;
     type?: 'api_key' | 'oauth' | 'browser' | 'device_code';
     url?: string;
+    deviceCode?: string;
     instructions?: string;
 }
+/**
+ * Normalized authentication methods for runtime event consumers.
+ */
+type AuthRequiredMethod = 'api_key' | 'oauth_browser' | 'device_code' | 'unknown';
+/**
+ * Structured authentication-required payload emitted by PTY session/manager.
+ */
+interface AuthRequiredInfo {
+    method: AuthRequiredMethod;
+    url?: string;
+    deviceCode?: string;
+    instructions?: string;
+    promptSnippet?: string;
+}
 /**
  * Types of blocking prompts that can occur
  */
@@ -425,6 +444,7 @@ interface PTYSessionEvents {
     output: (data: string) => void;
     ready: () => void;
     login_required: (instructions?: string, url?: string) => void;
+    auth_required: (info: AuthRequiredInfo) => void;
     blocking_prompt: (prompt: BlockingPromptInfo, autoResponded: boolean) => void;
     message: (message: SessionMessage) => void;
     question: (question: string) => void;
@@ -527,6 +547,10 @@ declare class PTYSession extends EventEmitter {
      * Simple string hash for deduplication.
      */
     private simpleHash;
+    private mapLoginTypeToAuthMethod;
+    private extractDeviceCode;
+    private getPromptSnippet;
+    private emitAuthRequired;
     /**
      * Strip ANSI codes, cursor movement, box-drawing, and spinner characters.
      * Used for stall detection hashing and auto-response pattern matching.
@@ -697,6 +721,7 @@ interface PTYManagerEvents {
     session_stopped: (session: SessionHandle, reason: string) => void;
     session_error: (session: SessionHandle, error: string) => void;
     login_required: (session: SessionHandle, instructions?: string, url?: string) => void;
+    auth_required: (session: SessionHandle, info: AuthRequiredInfo) => void;
     blocking_prompt: (session: SessionHandle, promptInfo: BlockingPromptInfo, autoResponded: boolean) => void;
     message: (message: SessionMessage) => void;
     question: (session: SessionHandle, question: string) => void;
@@ -1156,4 +1181,4 @@ declare function isBun(): boolean;
  */
 declare function createPTYManager(options?: BunPTYManagerOptions): BunCompatiblePTYManager;
 
-export { type AdapterFactoryConfig, AdapterRegistry, type AutoResponseRule, BaseCLIAdapter, type BlockingPromptDetection, type BlockingPromptInfo, type BlockingPromptType, type BuildTimelineOptions, BunCompatiblePTYManager, type BunPTYManagerOptions, type CLIAdapter, type LogOptions, type Logger, type LoginDetection, type MessageType, PTYManager, type PTYManagerConfig, type PTYManagerEvents, PTYSession, type PTYSessionEvents, type ParsedOutput, SPECIAL_KEYS, type SessionFilter, type SessionHandle, type SessionMessage, type SessionStatus, ShellAdapter, type ShellAdapterOptions, type SpawnConfig, type StallClassification, type StopOptions, type TaskCompletionTimelineResult, type TaskCompletionTimelineStep, type TaskCompletionTraceRecord, type TaskCompletionTurnTimeline, type TerminalAttachment, type WorkerSessionHandle, buildTaskCompletionTimeline, createAdapter, createPTYManager, extractTaskCompletionTraceRecords, isBun };
+export { type AdapterFactoryConfig, AdapterRegistry, type AuthRequiredInfo, type AuthRequiredMethod, type AutoResponseRule, BaseCLIAdapter, type BlockingPromptDetection, type BlockingPromptInfo, type BlockingPromptType, type BuildTimelineOptions, BunCompatiblePTYManager, type BunPTYManagerOptions, type CLIAdapter, type LogOptions, type Logger, type LoginDetection, type MessageType, PTYManager, type PTYManagerConfig, type PTYManagerEvents, PTYSession, type PTYSessionEvents, type ParsedOutput, SPECIAL_KEYS, type SessionFilter, type SessionHandle, type SessionMessage, type SessionStatus, ShellAdapter, type ShellAdapterOptions, type SpawnConfig, type StallClassification, type StopOptions, type TaskCompletionTimelineResult, type TaskCompletionTimelineStep, type TaskCompletionTraceRecord, type TaskCompletionTurnTimeline, type TerminalAttachment, type WorkerSessionHandle, buildTaskCompletionTimeline, createAdapter, createPTYManager, extractTaskCompletionTraceRecords, isBun };

package/dist/index.js

@@ -98,19 +98,8 @@ var AdapterRegistry = class {
 // src/pty-session.ts
 var import_events = require("events");
 var import_crypto = require("crypto");
-var ptyCache = null;
-function loadPty() {
-  if (!ptyCache) {
-    try {
-      ptyCache = require("node-pty");
-    } catch {
-      throw new Error(
-        "node-pty is required but not installed. Run: npm install node-pty"
-      );
-    }
-  }
-  return ptyCache;
-}
+
+// src/logger.ts
 var consoleLogger = {
   debug: (...args) => {
     if (typeof args[0] === "string") {
@@ -141,6 +130,21 @@ var consoleLogger = {
     }
   }
 };
+
+// src/pty-session.ts
+var ptyCache = null;
+function loadPty() {
+  if (!ptyCache) {
+    try {
+      ptyCache = require("node-pty");
+    } catch {
+      throw new Error(
+        "node-pty is required but not installed. Run: npm install node-pty"
+      );
+    }
+  }
+  return ptyCache;
+}
 function generateId() {
   return `pty-${Date.now()}-${(0, import_crypto.randomUUID)().slice(0, 8)}`;
 }
@@ -575,6 +579,51 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
     }
     return hash.toString(36);
   }
+  mapLoginTypeToAuthMethod(type) {
+    switch (type) {
+      case "api_key":
+        return "api_key";
+      case "device_code":
+        return "device_code";
+      case "oauth":
+      case "browser":
+        return "oauth_browser";
+      default:
+        return "unknown";
+    }
+  }
+  extractDeviceCode(text) {
+    const stripped = this.stripAnsiForClassifier(text);
+    const explicitMatch = stripped.match(
+      /(?:one-time|one time|device)?\s*code[:\s]+([A-Z0-9]{3,}(?:-[A-Z0-9]{3,})+)/i
+    );
+    if (explicitMatch?.[1]) {
+      return explicitMatch[1].toUpperCase();
+    }
+    if (!/code/i.test(stripped)) {
+      return void 0;
+    }
+    const fallbackMatch = stripped.match(/\b([A-Z0-9]{3,}(?:-[A-Z0-9]{3,})+)\b/);
+    return fallbackMatch?.[1]?.toUpperCase();
+  }
+  getPromptSnippet(maxChars = 280) {
+    const normalized = this.stripAnsiForClassifier(this.outputBuffer).replace(/\s+/g, " ").trim();
+    if (!normalized) {
+      return void 0;
+    }
+    return normalized.length <= maxChars ? normalized : normalized.slice(-maxChars);
+  }
+  emitAuthRequired(details) {
+    const info = {
+      method: this.mapLoginTypeToAuthMethod(details.type),
+      url: details.url,
+      deviceCode: details.deviceCode ?? this.extractDeviceCode(this.outputBuffer),
+      instructions: details.instructions,
+      promptSnippet: this.getPromptSnippet()
+    };
+    this.emit("auth_required", info);
+    this.emit("login_required", info.instructions, info.url);
+  }
   /**
    * Strip ANSI codes, cursor movement, box-drawing, and spinner characters.
    * Used for stall detection hashing and auto-response pattern matching.
@@ -934,7 +983,12 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
       if (loginDetection.required && this._status !== "authenticating") {
         this._status = "authenticating";
         this.clearStallTimer();
-        this.emit("login_required", loginDetection.instructions, loginDetection.url);
+        this.emitAuthRequired({
+          type: loginDetection.type,
+          url: loginDetection.url,
+          deviceCode: loginDetection.deviceCode,
+          instructions: loginDetection.instructions
+        });
         this.logger.warn(
           { sessionId: this.id, loginType: loginDetection.type },
           "Login required"
@@ -977,7 +1031,7 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
           instructions: detection.instructions,
           url: detection.url
         };
-        if (detection.canAutoRespond && detection.suggestedResponse) {
+        if (detection.canAutoRespond && detection.suggestedResponse && !this.config.skipAdapterAutoResponse) {
           this.logger.info(
             {
               sessionId: this.id,
@@ -1000,7 +1054,13 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
         }
         if (detection.type === "login") {
           this._status = "authenticating";
-          this.emit("login_required", detection.instructions, detection.url);
+          const inferred = this.adapter.detectLogin(this.outputBuffer);
+          this.emitAuthRequired({
+            type: inferred.required ? inferred.type : void 0,
+            url: detection.url ?? inferred.url,
+            deviceCode: inferred.required ? inferred.deviceCode : void 0,
+            instructions: detection.instructions ?? inferred.instructions
+          });
         }
         this.logger.warn(
           {
@@ -1289,36 +1349,6 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
 };
 
 // src/pty-manager.ts
-var consoleLogger2 = {
-  debug: (...args) => {
-    if (typeof args[0] === "string") {
-      console.debug(args[0], args[1]);
-    } else {
-      console.debug(args[1], args[0]);
-    }
-  },
-  info: (...args) => {
-    if (typeof args[0] === "string") {
-      console.info(args[0], args[1]);
-    } else {
-      console.info(args[1], args[0]);
-    }
-  },
-  warn: (...args) => {
-    if (typeof args[0] === "string") {
-      console.warn(args[0], args[1]);
-    } else {
-      console.warn(args[1], args[0]);
-    }
-  },
-  error: (...args) => {
-    if (typeof args[0] === "string") {
-      console.error(args[0], args[1]);
-    } else {
-      console.error(args[1], args[0]);
-    }
-  }
-};
 var PTYManager = class extends import_events2.EventEmitter {
   sessions = /* @__PURE__ */ new Map();
   outputLogs = /* @__PURE__ */ new Map();
@@ -1332,7 +1362,7 @@ var PTYManager = class extends import_events2.EventEmitter {
   constructor(config = {}) {
     super();
     this.adapters = new AdapterRegistry();
-    this.logger = config.logger || consoleLogger2;
+    this.logger = config.logger || consoleLogger;
     this.maxLogLines = config.maxLogLines || 1e3;
     this._stallDetectionEnabled = config.stallDetectionEnabled ?? false;
     this._stallTimeoutMs = config.stallTimeoutMs ?? 8e3;
@@ -1393,6 +1423,9 @@ var PTYManager = class extends import_events2.EventEmitter {
     session.on("login_required", (instructions, url) => {
       this.emit("login_required", session.toHandle(), instructions, url);
     });
+    session.on("auth_required", (info) => {
+      this.emit("auth_required", session.toHandle(), info);
+    });
     session.on("blocking_prompt", (promptInfo, autoResponded) => {
       this.emit("blocking_prompt", session.toHandle(), promptInfo, autoResponded);
     });
@@ -2430,6 +2463,14 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
         }
         break;
       }
+      case "auth_required": {
+        const session = this.sessions.get(id);
+        if (session) {
+          session.status = "authenticating";
+          this.emit("auth_required", session, event.info);
+        }
+        break;
+      }
       case "message": {
         const msg = event.message;
         this.emit("message", {