pty-manager 1.10.2 → 1.11.0

package/dist/index.d.mts

@@ -312,6 +312,21 @@ declare class BunCompatiblePTYManager extends EventEmitter {
      * Check if a session exists
      */
     has(id: string): boolean;
+    /**
+     * Whether the adapter currently classifies the session as actively
+     * processing work.
+     *
+     * This round-trips to the worker since the adapter lives in the
+     * worker process. Orchestrators (like milady's swarm idle watchdog)
+     * should consult this before assuming a session is idle based on
+     * output byte diffs — TUIs that redraw their status row in place
+     * (Codex's "Working… esc to interrupt") can fool a raw text diff
+     * even while the model is actively reasoning.
+     *
+     * Returns `false` for unknown sessions, adapters that don't
+     * implement `detectLoading`, or on IPC errors.
+     */
+    isSessionLoading(id: string): Promise<boolean>;
     /**
      * Subscribe to output from a specific session
      */
@@ -536,6 +551,18 @@ declare class PTYSession extends EventEmitter {
      * signal before transitioning, so stale triggers are safe.
      */
     private scheduleTaskComplete;
+    /**
+     * Whether the adapter's `detectLoading()` currently classifies the
+     * session as actively processing work.
+     *
+     * This wraps `adapter.detectLoading(outputBuffer)` for consumers outside
+     * the PTY layer (e.g. milady's swarm idle watchdog) that need a
+     * reliable "is the agent busy right now?" signal without reimplementing
+     * heuristics over raw terminal output.
+     *
+     * Returns `false` if the adapter does not implement `detectLoading`.
+     */
+    isLoading(): boolean;
     /**
      * Adapter-level task completion check with compatibility fallback.
      * Prefer detectTaskComplete() because detectReady() may be broad for TUIs.
@@ -780,6 +807,18 @@ declare class PTYManager extends EventEmitter {
      * Get the underlying PTYSession (for advanced use)
      */
     getSession(sessionId: string): PTYSession | undefined;
+    /**
+     * Whether the adapter currently classifies the session as actively
+     * processing work (e.g. Codex's "esc to interrupt" status row).
+     *
+     * Orchestrators (like milady's swarm idle watchdog) should consult
+     * this before assuming a session is idle based on output byte diffs,
+     * which are fooled by TUIs that redraw the same status row in place.
+     *
+     * Returns `false` for unknown sessions or adapters that don't
+     * implement `detectLoading`.
+     */
+    isSessionLoading(sessionId: string): boolean;
     /**
      * Configure stall detection at runtime.
      * Affects newly spawned sessions only — existing sessions keep their config.

package/dist/index.d.ts

@@ -312,6 +312,21 @@ declare class BunCompatiblePTYManager extends EventEmitter {
      * Check if a session exists
      */
     has(id: string): boolean;
+    /**
+     * Whether the adapter currently classifies the session as actively
+     * processing work.
+     *
+     * This round-trips to the worker since the adapter lives in the
+     * worker process. Orchestrators (like milady's swarm idle watchdog)
+     * should consult this before assuming a session is idle based on
+     * output byte diffs — TUIs that redraw their status row in place
+     * (Codex's "Working… esc to interrupt") can fool a raw text diff
+     * even while the model is actively reasoning.
+     *
+     * Returns `false` for unknown sessions, adapters that don't
+     * implement `detectLoading`, or on IPC errors.
+     */
+    isSessionLoading(id: string): Promise<boolean>;
     /**
      * Subscribe to output from a specific session
      */
@@ -536,6 +551,18 @@ declare class PTYSession extends EventEmitter {
      * signal before transitioning, so stale triggers are safe.
      */
     private scheduleTaskComplete;
+    /**
+     * Whether the adapter's `detectLoading()` currently classifies the
+     * session as actively processing work.
+     *
+     * This wraps `adapter.detectLoading(outputBuffer)` for consumers outside
+     * the PTY layer (e.g. milady's swarm idle watchdog) that need a
+     * reliable "is the agent busy right now?" signal without reimplementing
+     * heuristics over raw terminal output.
+     *
+     * Returns `false` if the adapter does not implement `detectLoading`.
+     */
+    isLoading(): boolean;
     /**
      * Adapter-level task completion check with compatibility fallback.
      * Prefer detectTaskComplete() because detectReady() may be broad for TUIs.
@@ -780,6 +807,18 @@ declare class PTYManager extends EventEmitter {
      * Get the underlying PTYSession (for advanced use)
      */
     getSession(sessionId: string): PTYSession | undefined;
+    /**
+     * Whether the adapter currently classifies the session as actively
+     * processing work (e.g. Codex's "esc to interrupt" status row).
+     *
+     * Orchestrators (like milady's swarm idle watchdog) should consult
+     * this before assuming a session is idle based on output byte diffs,
+     * which are fooled by TUIs that redraw the same status row in place.
+     *
+     * Returns `false` for unknown sessions or adapters that don't
+     * implement `detectLoading`.
+     */
+    isSessionLoading(sessionId: string): boolean;
     /**
      * Configure stall detection at runtime.
      * Affects newly spawned sessions only — existing sessions keep their config.

package/dist/index.js

@@ -405,6 +405,13 @@ var BunCompatiblePTYManager = class extends import_node_events.EventEmitter {
         this.resolvePending("list", sessions);
         break;
       }
+      case "isSessionLoading": {
+        this.resolvePending(
+          `isSessionLoading:${id}`,
+          Boolean(event.loading)
+        );
+        break;
+      }
       case "rules": {
         const serializedRules = event.rules;
         const rules = serializedRules.map((r) => ({
@@ -566,6 +573,33 @@ var BunCompatiblePTYManager = class extends import_node_events.EventEmitter {
   has(id) {
     return this.sessions.has(id);
   }
+  /**
+   * Whether the adapter currently classifies the session as actively
+   * processing work.
+   *
+   * This round-trips to the worker since the adapter lives in the
+   * worker process. Orchestrators (like milady's swarm idle watchdog)
+   * should consult this before assuming a session is idle based on
+   * output byte diffs — TUIs that redraw their status row in place
+   * (Codex's "Working… esc to interrupt") can fool a raw text diff
+   * even while the model is actively reasoning.
+   *
+   * Returns `false` for unknown sessions, adapters that don't
+   * implement `detectLoading`, or on IPC errors.
+   */
+  async isSessionLoading(id) {
+    if (!this.sessions.has(id)) return false;
+    await this.waitForReady();
+    this.sendCommand({ cmd: "isSessionLoading", id });
+    try {
+      const result = await this.createPending(
+        `isSessionLoading:${id}`
+      );
+      return Boolean(result);
+    } catch {
+      return false;
+    }
+  }
   /**
    * Subscribe to output from a specific session
    */
@@ -1540,6 +1574,20 @@ var PTYSession = class _PTYSession extends import_node_events2.EventEmitter {
       );
     }, _PTYSession.TASK_COMPLETE_DEBOUNCE_MS);
   }
+  /**
+   * Whether the adapter's `detectLoading()` currently classifies the
+   * session as actively processing work.
+   *
+   * This wraps `adapter.detectLoading(outputBuffer)` for consumers outside
+   * the PTY layer (e.g. milady's swarm idle watchdog) that need a
+   * reliable "is the agent busy right now?" signal without reimplementing
+   * heuristics over raw terminal output.
+   *
+   * Returns `false` if the adapter does not implement `detectLoading`.
+   */
+  isLoading() {
+    return this.adapter.detectLoading?.(this.outputBuffer) ?? false;
+  }
   /**
    * Adapter-level task completion check with compatibility fallback.
    * Prefer detectTaskComplete() because detectReady() may be broad for TUIs.
@@ -2556,6 +2604,20 @@ var PTYManager = class extends import_node_events3.EventEmitter {
   getSession(sessionId) {
     return this.sessions.get(sessionId);
   }
+  /**
+   * Whether the adapter currently classifies the session as actively
+   * processing work (e.g. Codex's "esc to interrupt" status row).
+   *
+   * Orchestrators (like milady's swarm idle watchdog) should consult
+   * this before assuming a session is idle based on output byte diffs,
+   * which are fooled by TUIs that redraw the same status row in place.
+   *
+   * Returns `false` for unknown sessions or adapters that don't
+   * implement `detectLoading`.
+   */
+  isSessionLoading(sessionId) {
+    return this.sessions.get(sessionId)?.isLoading() ?? false;
+  }
   // ─────────────────────────────────────────────────────────────────────────────
   // Stall Detection Configuration
   // ─────────────────────────────────────────────────────────────────────────────