@magnusekdahl/parallix 1.2.0 → 1.3.0

package/lib/agents/opencode-export.js

@@ -1,10 +1,13 @@
-'use strict';
-
-const childProcess = require('child_process');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureOpencodeExport = captureOpencodeExport;
+const node_child_process_1 = __importDefault(require("node:child_process"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
 /**
  * Capture the complete `opencode export <sessionId>` JSON document.
  *
@@ -35,125 +38,121 @@ const path = require('path');
  * @returns {Promise<string|null>} Full JSON string, or null on failure
  */
 function captureOpencodeExport(sessionId, opts = {}) {
-  const {
-    worktree,
-    env,
-    timeoutMs = 30000,
-    maxBytes = 32 * 1024 * 1024,
-    spawn = childProcess.spawn,
-  } = opts;
-
-  return new Promise((resolve) => {
-    if (!sessionId) {
-      resolve(null);
-      return;
-    }
-
-    let settled = false;
-    /** @type {NodeJS.Timeout | null} */
-    let timer = null;
-    let size = 0;
-    /** @type {number | null} */
-    let tmpFd = null;
-    /** @type {string | null} */
-    let tmpPath = null;
-
-    /** @param {string | null} value */
-    const finish = (value) => {
-      if (settled) {return;}
-      settled = true;
-      if (timer) {clearTimeout(timer);}
-      // Clean up temp file
-      if (tmpFd !== null) {
-        try { fs.closeSync(tmpFd); } catch (_) { /* already closed */ }
-      }
-      if (tmpPath) {
-        try { fs.unlinkSync(tmpPath); } catch (_) { /* already gone */ }
-      }
-      resolve(value);
-    };
-
-    /** @param {import('child_process').ChildProcess | undefined} child */
-    const killChild = (child) => {
-      try { if (child) { child.kill('SIGKILL'); } } catch (_) { /* already gone */ }
-    };
-
-    // Create a temp file for stdout to avoid pipe-buffer truncation
-    let tmpFileError = null;
-    try {
-      tmpPath = path.join(os.tmpdir(), `opencode-export-${process.pid}-${Date.now()}.json`);
-      tmpFd = fs.openSync(tmpPath, 'w');
-    } catch (e) {
-      tmpFileError = e;
-    }
-
-    let child;
-    try {
-      child = spawn('opencode', ['export', sessionId], {
-        cwd: worktree,
-        env: { ...process.env, ...(env || {}) },
-        stdio: ['ignore', tmpFd !== null ? tmpFd : 'pipe', 'pipe'],
-      });
-    } catch (_) {
-      finish(null);
-      return;
-    }
-
-    if (tmpFileError) {
-      killChild(child);
-      finish(null);
-      return;
-    }
-
-    timer = setTimeout(() => {
-      // Hung or slow export: kill it and degrade to null. Do not block.
-      killChild(child);
-      finish(null);
-    }, timeoutMs);
-    // Intentionally NOT unref'd: the caller always awaits this Promise, and the
-    // timer is cleared via finish() the moment the export resolves. Leaving it
-    // ref'd keeps the timeout deterministic under Node's test runner (an unref'd
-    // timer can be skipped when the loop is otherwise idle, cancelling the test).
-
-    // Consume stderr to prevent pipe-buffer issues with the opencode binary
-    if (child.stderr) {
-      child.stderr.on('data', () => { /* drain stderr */ });
-    }
-
-    child.on('error', () => finish(null));
-
-    child.on('close', () => {
-      if (settled) {return;}
-      if (tmpFd === null) {
-        finish(null);
-        return;
-      }
-
-      try {
-        fs.closeSync(tmpFd);
-      } catch (_) { /* already closed */ }
-      tmpFd = null;
-
-      let content;
-      if (!tmpPath) { finish(null); return; }
-      try {
-        content = fs.readFileSync(tmpPath, 'utf8');
-      } catch (_) {
-        finish(null);
-        return;
-      }
-
-      size = Buffer.byteLength(content);
-      if (size > maxBytes) {
-        // Explicit failure rather than silent truncation: a partial JSON
-        // document would parse to null/garbage and fabricate zero telemetry.
-        finish(null);
-        return;
-      }
-
-      finish(content);
+    const { worktree, env, timeoutMs = 30000, maxBytes = 32 * 1024 * 1024, spawn = node_child_process_1.default.spawn, } = opts;
+    return new Promise((resolve) => {
+        if (!sessionId) {
+            resolve(null);
+            return;
+        }
+        let settled = false;
+        let timer = null;
+        let size = 0;
+        let tmpFd = null;
+        let tmpPath = null;
+        const finish = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (timer) {
+                clearTimeout(timer);
+            }
+            // Clean up temp file
+            if (tmpFd !== null) {
+                try {
+                    node_fs_1.default.closeSync(tmpFd);
+                }
+                catch (_) { /* already closed */ }
+            }
+            if (tmpPath) {
+                try {
+                    node_fs_1.default.unlinkSync(tmpPath);
+                }
+                catch (_) { /* already gone */ }
+            }
+            resolve(value);
+        };
+        const killChild = (child) => {
+            try {
+                if (child) {
+                    child.kill('SIGKILL');
+                }
+            }
+            catch (_) { /* already gone */ }
+        };
+        // Create a temp file for stdout to avoid pipe-buffer truncation
+        let tmpFileError = null;
+        try {
+            tmpPath = node_path_1.default.join(node_os_1.default.tmpdir(), `opencode-export-${process.pid}-${Date.now()}.json`);
+            tmpFd = node_fs_1.default.openSync(tmpPath, 'w');
+        }
+        catch (e) {
+            tmpFileError = e;
+        }
+        let child;
+        try {
+            child = spawn('opencode', ['export', sessionId], {
+                cwd: worktree,
+                env: { ...process.env, ...(env || {}) },
+                stdio: ['ignore', tmpFd !== null ? tmpFd : 'pipe', 'pipe'],
+            });
+        }
+        catch (_) {
+            finish(null);
+            return;
+        }
+        if (tmpFileError) {
+            killChild(child);
+            finish(null);
+            return;
+        }
+        timer = setTimeout(() => {
+            // Hung or slow export: kill it and degrade to null. Do not block.
+            killChild(child);
+            finish(null);
+        }, timeoutMs);
+        // Intentionally NOT unref'd: the caller always awaits this Promise, and the
+        // timer is cleared via finish() the moment the export resolves. Leaving it
+        // ref'd keeps the timeout deterministic under Node's test runner (an unref'd
+        // timer can be skipped when the loop is otherwise idle, cancelling the test).
+        // Consume stderr to prevent pipe-buffer issues with the opencode binary
+        if (child.stderr) {
+            child.stderr.on('data', () => { });
+        }
+        child.on('error', () => finish(null));
+        child.on('close', () => {
+            if (settled) {
+                return;
+            }
+            if (tmpFd === null) {
+                finish(null);
+                return;
+            }
+            try {
+                node_fs_1.default.closeSync(tmpFd);
+            }
+            catch (_) { /* already closed */ }
+            tmpFd = null;
+            let content;
+            if (!tmpPath) {
+                finish(null);
+                return;
+            }
+            try {
+                content = node_fs_1.default.readFileSync(tmpPath, 'utf8');
+            }
+            catch (_) {
+                finish(null);
+                return;
+            }
+            size = Buffer.byteLength(content);
+            if (size > maxBytes) {
+                // Explicit failure rather than silent truncation: a partial JSON
+                // document would parse to null/garbage and fabricate zero telemetry.
+                finish(null);
+                return;
+            }
+            finish(content);
+        });
     });
-  });
 }
-
-module.exports = { captureOpencodeExport };

package/lib/agents/opencode-export.ts

@@ -0,0 +1,160 @@
+import childProcess from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+interface CaptureOpencodeExportOptions {
+  worktree?: string;
+  env?: Record<string, string>;
+  timeoutMs?: number;
+  maxBytes?: number;
+  spawn?: typeof childProcess.spawn;
+}
+
+/**
+ * Capture the complete `opencode export <sessionId>` JSON document.
+ *
+ * Unlike the limit-hit tail buffer in spawn-tee.js, telemetry needs the WHOLE
+ * export document (it is a single JSON object beginning with `{`), so a tail
+ * buffer would discard the prefix and yield invalid JSON. This collector keeps
+ * the full stdout in memory up to an explicit cap and, critically:
+ *
+ *   - Enforces a timeout that kills a hung/non-exiting export child so the
+ *     launcher can never block on it (mission risk + stop rule).
+ *   - Fails explicitly (resolves null) when output exceeds `maxBytes` rather
+ *     than silently truncating into unparseable JSON.
+ *
+ * Uses a temp-file fd for stdout to avoid pipe-buffer data loss that occurs
+ * with large (>100 KB) child-process output.  The child writes directly to
+ * the fd; after exit we read the file back as a string.
+ *
+ * Never rejects: any error/timeout/oversize resolves to null so telemetry
+ * capture stays best-effort and cannot break the launch.
+ *
+ * @param {string} sessionId - opencode session id (e.g. ses_...)
+ * @param {object} opts
+ * @param {string} [opts.worktree] - cwd for the export process
+ * @param {object} [opts.env] - extra env vars
+ * @param {number} [opts.timeoutMs] - hard timeout before the child is killed
+ * @param {number} [opts.maxBytes] - explicit byte cap; exceeding it fails
+ * @param {Function} [opts.spawn] - injectable spawn (defaults to child_process.spawn)
+ * @returns {Promise<string|null>} Full JSON string, or null on failure
+ */
+function captureOpencodeExport(sessionId: string, opts: CaptureOpencodeExportOptions = {}) {
+  const {
+    worktree,
+    env,
+    timeoutMs = 30000,
+    maxBytes = 32 * 1024 * 1024,
+    spawn = childProcess.spawn,
+  } = opts;
+
+  return new Promise<string | null>((resolve) => {
+    if (!sessionId) {
+      resolve(null);
+      return;
+    }
+
+    let settled = false;
+    let timer: NodeJS.Timeout | null = null;
+    let size = 0;
+    let tmpFd: number | null = null;
+    let tmpPath: string | null = null;
+
+    const finish = (value: string | null) => {
+      if (settled) {return;}
+      settled = true;
+      if (timer) {clearTimeout(timer);}
+      // Clean up temp file
+      if (tmpFd !== null) {
+        try { fs.closeSync(tmpFd); } catch (_) { /* already closed */ }
+      }
+      if (tmpPath) {
+        try { fs.unlinkSync(tmpPath); } catch (_) { /* already gone */ }
+      }
+      resolve(value);
+    };
+
+    const killChild = (child: childProcess.ChildProcess | undefined) => {
+      try { if (child) { child.kill('SIGKILL'); } } catch (_) { /* already gone */ }
+    };
+
+    // Create a temp file for stdout to avoid pipe-buffer truncation
+    let tmpFileError = null;
+    try {
+      tmpPath = path.join(os.tmpdir(), `opencode-export-${process.pid}-${Date.now()}.json`);
+      tmpFd = fs.openSync(tmpPath, 'w');
+    } catch (e) {
+      tmpFileError = e;
+    }
+
+    let child;
+    try {
+      child = spawn('opencode', ['export', sessionId], {
+        cwd: worktree,
+        env: { ...process.env, ...(env || {}) },
+        stdio: ['ignore', tmpFd !== null ? tmpFd : 'pipe', 'pipe'],
+      });
+    } catch (_) {
+      finish(null);
+      return;
+    }
+
+    if (tmpFileError) {
+      killChild(child);
+      finish(null);
+      return;
+    }
+
+    timer = setTimeout(() => {
+      // Hung or slow export: kill it and degrade to null. Do not block.
+      killChild(child);
+      finish(null);
+    }, timeoutMs);
+    // Intentionally NOT unref'd: the caller always awaits this Promise, and the
+    // timer is cleared via finish() the moment the export resolves. Leaving it
+    // ref'd keeps the timeout deterministic under Node's test runner (an unref'd
+    // timer can be skipped when the loop is otherwise idle, cancelling the test).
+
+    // Consume stderr to prevent pipe-buffer issues with the opencode binary
+    if (child.stderr) {
+      child.stderr.on('data', () => { /* drain stderr */ });
+    }
+
+    child.on('error', () => finish(null));
+
+    child.on('close', () => {
+      if (settled) {return;}
+      if (tmpFd === null) {
+        finish(null);
+        return;
+      }
+
+      try {
+        fs.closeSync(tmpFd);
+      } catch (_) { /* already closed */ }
+      tmpFd = null;
+
+      let content;
+      if (!tmpPath) { finish(null); return; }
+      try {
+        content = fs.readFileSync(tmpPath, 'utf8');
+      } catch (_) {
+        finish(null);
+        return;
+      }
+
+      size = Buffer.byteLength(content);
+      if (size > maxBytes) {
+        // Explicit failure rather than silent truncation: a partial JSON
+        // document would parse to null/garbage and fabricate zero telemetry.
+        finish(null);
+        return;
+      }
+
+      finish(content);
+    });
+  });
+}
+
+export { captureOpencodeExport };