pty-manager 1.9.7 → 1.9.8

package/dist/index.d.mts

@@ -1,5 +1,30 @@
 import { EventEmitter } from 'events';
 
+/**
+ * Lazy runtime check for node-pty native addon.
+ *
+ * Called once before the first PTY spawn. Ensures the native binary is
+ * loadable and spawn-helper permissions are correct.
+ *
+ * 1. Finds the binary — checks for prebuilt pty.node under
+ *    prebuilds/<platform>-<arch>/ (node-pty >=1.0), then falls back to
+ *    checking for a node-gyp compiled build/Release/pty.node
+ * 2. Fixes spawn-helper permissions — bun install can strip execute
+ *    bits from the spawn-helper Mach-O binary, causing posix_spawnp
+ *    failed at runtime. The script chmod 755s all spawn-helpers under
+ *    prebuilds/
+ * 3. Rebuilds if missing — if no binary is found at all, runs
+ *    node-gyp rebuild as a last resort (with a 2-minute timeout)
+ */
+/**
+ * Ensure node-pty is usable. Called once before first spawn.
+ * Idempotent — subsequent calls are no-ops.
+ *
+ * @param log - logger function (defaults to console.log)
+ * @throws Error if no native binary can be found or built
+ */
+declare function ensurePty(log?: (msg: string) => void): void;
+
 /**
  * PTY Agent Manager Types
  *
@@ -1251,4 +1276,4 @@ declare function isBun(): boolean;
  */
 declare function createPTYManager(options?: BunPTYManagerOptions): BunCompatiblePTYManager;
 
-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 ToolRunningInfo, 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 ToolRunningInfo, type WorkerSessionHandle, buildTaskCompletionTimeline, createAdapter, createPTYManager, ensurePty, extractTaskCompletionTraceRecords, isBun };

package/dist/index.d.ts

@@ -1,5 +1,30 @@
 import { EventEmitter } from 'events';
 
+/**
+ * Lazy runtime check for node-pty native addon.
+ *
+ * Called once before the first PTY spawn. Ensures the native binary is
+ * loadable and spawn-helper permissions are correct.
+ *
+ * 1. Finds the binary — checks for prebuilt pty.node under
+ *    prebuilds/<platform>-<arch>/ (node-pty >=1.0), then falls back to
+ *    checking for a node-gyp compiled build/Release/pty.node
+ * 2. Fixes spawn-helper permissions — bun install can strip execute
+ *    bits from the spawn-helper Mach-O binary, causing posix_spawnp
+ *    failed at runtime. The script chmod 755s all spawn-helpers under
+ *    prebuilds/
+ * 3. Rebuilds if missing — if no binary is found at all, runs
+ *    node-gyp rebuild as a last resort (with a 2-minute timeout)
+ */
+/**
+ * Ensure node-pty is usable. Called once before first spawn.
+ * Idempotent — subsequent calls are no-ops.
+ *
+ * @param log - logger function (defaults to console.log)
+ * @throws Error if no native binary can be found or built
+ */
+declare function ensurePty(log?: (msg: string) => void): void;
+
 /**
  * PTY Agent Manager Types
  *
@@ -1251,4 +1276,4 @@ declare function isBun(): boolean;
  */
 declare function createPTYManager(options?: BunPTYManagerOptions): BunCompatiblePTYManager;
 
-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 ToolRunningInfo, 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 ToolRunningInfo, type WorkerSessionHandle, buildTaskCompletionTimeline, createAdapter, createPTYManager, ensurePty, extractTaskCompletionTraceRecords, isBun };

package/dist/index.js

@@ -40,11 +40,123 @@ __export(index_exports, {
   buildTaskCompletionTimeline: () => buildTaskCompletionTimeline,
   createAdapter: () => createAdapter,
   createPTYManager: () => createPTYManager,
+  ensurePty: () => ensurePty,
   extractTaskCompletionTraceRecords: () => extractTaskCompletionTraceRecords,
   isBun: () => isBun
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/ensure-pty.ts
+var import_fs = require("fs");
+var import_path = require("path");
+var import_child_process = require("child_process");
+var TAG = "[pty-preflight]";
+var platformArch = `${process.platform}-${process.arch}`;
+var checked = false;
+function findNodePtyRoots() {
+  const roots = [];
+  try {
+    const nodePtyMain = require.resolve("node-pty");
+    const nodePtyRoot = (0, import_path.dirname)((0, import_path.dirname)(nodePtyMain));
+    if ((0, import_fs.existsSync)((0, import_path.join)(nodePtyRoot, "package.json"))) {
+      roots.push(nodePtyRoot);
+    }
+  } catch {
+  }
+  const packageRoot = (0, import_path.join)(__dirname, "..");
+  const candidates = [
+    (0, import_path.join)(packageRoot, "node_modules", "node-pty"),
+    // Monorepo hoisted
+    (0, import_path.join)(packageRoot, "..", "node-pty"),
+    (0, import_path.join)(packageRoot, "..", "..", "node-pty")
+  ];
+  for (const candidate of candidates) {
+    if ((0, import_fs.existsSync)((0, import_path.join)(candidate, "package.json")) && !roots.includes(candidate)) {
+      roots.push(candidate);
+    }
+  }
+  return roots;
+}
+function findNativeBinary(nodePtyRoot) {
+  const prebuildPath = (0, import_path.join)(nodePtyRoot, "prebuilds", platformArch, "pty.node");
+  if ((0, import_fs.existsSync)(prebuildPath)) {
+    return { type: "prebuild", path: prebuildPath };
+  }
+  const gypPath = (0, import_path.join)(nodePtyRoot, "build", "Release", "pty.node");
+  if ((0, import_fs.existsSync)(gypPath)) {
+    return { type: "gyp", path: gypPath };
+  }
+  return null;
+}
+function fixSpawnHelpers(nodePtyRoot, log) {
+  if (process.platform === "win32") return;
+  const prebuildsDir = (0, import_path.join)(nodePtyRoot, "prebuilds");
+  if (!(0, import_fs.existsSync)(prebuildsDir)) return;
+  try {
+    for (const entry of (0, import_fs.readdirSync)(prebuildsDir)) {
+      const helperPath = (0, import_path.join)(prebuildsDir, entry, "spawn-helper");
+      if ((0, import_fs.existsSync)(helperPath)) {
+        try {
+          const stat = (0, import_fs.statSync)(helperPath);
+          if ((stat.mode & 73) === 0) {
+            (0, import_fs.chmodSync)(helperPath, 493);
+            log(`${TAG} Fixed spawn-helper permissions: ${(0, import_path.relative)(nodePtyRoot, helperPath)}`);
+          }
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+}
+function rebuildNodePty(nodePtyRoot, log) {
+  log(`${TAG} No native binary found \u2014 attempting node-gyp rebuild...`);
+  try {
+    (0, import_child_process.execSync)("node-gyp rebuild", {
+      cwd: nodePtyRoot,
+      stdio: "pipe",
+      timeout: 12e4
+    });
+    log(`${TAG} node-gyp rebuild succeeded`);
+    return true;
+  } catch (err) {
+    log(`${TAG} node-gyp rebuild failed: ${err instanceof Error ? err.message : err}`);
+    return false;
+  }
+}
+function ensurePty(log = console.log) {
+  if (checked) return;
+  checked = true;
+  const roots = findNodePtyRoots();
+  if (roots.length === 0) {
+    throw new Error(
+      `${TAG} node-pty not found. Install it with: npm install node-pty`
+    );
+  }
+  let anyBinaryFound = false;
+  for (const root of roots) {
+    const binary = findNativeBinary(root);
+    if (binary) {
+      log(`${TAG} Found ${binary.type} binary for ${platformArch}`);
+      anyBinaryFound = true;
+    }
+    fixSpawnHelpers(root, log);
+    if (!binary) {
+      if (rebuildNodePty(root, log)) {
+        if (findNativeBinary(root)) {
+          anyBinaryFound = true;
+        }
+      }
+    }
+    if (anyBinaryFound) break;
+  }
+  if (!anyBinaryFound) {
+    throw new Error(
+      `${TAG} No node-pty native binary available for ${platformArch}. Try: cd node_modules/node-pty && node-gyp rebuild`
+    );
+  }
+}
+
 // src/pty-manager.ts
 var import_events2 = require("events");
 
@@ -896,6 +1008,7 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
     if (this.ptyProcess) {
       throw new Error("Session already started");
     }
+    ensurePty((msg) => this.logger.info({ sessionId: this.id }, msg));
     const nodePty = loadPty();
     this._status = "starting";
     this._startedAt = /* @__PURE__ */ new Date();
@@ -2001,7 +2114,7 @@ function asTimestamp(value) {
 }
 
 // src/adapters/base-adapter.ts
-var import_child_process = require("child_process");
+var import_child_process2 = require("child_process");
 var BaseCLIAdapter = class {
   /**
    * Auto-response rules for handling known blocking prompts.
@@ -2167,7 +2280,7 @@ var BaseCLIAdapter = class {
     return new Promise((resolve) => {
       const command = this.getCommand();
       try {
-        const proc = (0, import_child_process.spawn)(command, ["--version"], {
+        const proc = (0, import_child_process2.spawn)(command, ["--version"], {
           shell: true,
           timeout: 5e3
         });
@@ -2430,7 +2543,7 @@ var ShellAdapter = class {
 };
 
 // src/bun-compat.ts
-var import_child_process2 = require("child_process");
+var import_child_process3 = require("child_process");
 var import_events3 = require("events");
 var path = __toESM(require("path"));
 var readline = __toESM(require("readline"));
@@ -2471,7 +2584,7 @@ var BunCompatiblePTYManager = class extends import_events3.EventEmitter {
     return possiblePaths[0];
   }
   startWorker() {
-    this.worker = (0, import_child_process2.spawn)(this.nodePath, [this.workerPath], {
+    this.worker = (0, import_child_process3.spawn)(this.nodePath, [this.workerPath], {
       stdio: ["pipe", "pipe", "pipe"],
       env: { ...process.env, ...this.env }
     });
@@ -2982,6 +3095,7 @@ function createPTYManager(options) {
   buildTaskCompletionTimeline,
   createAdapter,
   createPTYManager,
+  ensurePty,
   extractTaskCompletionTraceRecords,
   isBun
 });