@volter/supercode-terminal 0.2.38 → 0.2.40

package/index.mjs

@@ -1,6 +1,7 @@
 import { execFile, spawn, spawnSync } from 'node:child_process';
 import { randomBytes, randomUUID } from 'node:crypto';
-import { existsSync } from 'node:fs';
+import { cpSync, existsSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 import { connect as netConnect } from 'node:net';
 import { fileURLToPath } from 'node:url';
 import { createServer as defaultCreateServer } from 'node:http';
@@ -810,6 +811,8 @@ export class PtyTerminalHost {
       // The launch directory: another process's current directory is not readable here as tmux reads it.
       cwd: entry.cwd,
       dead: entry.exit !== null,
+      // How a dead pane's program ended (a failed one is kept so its last screen can be read).
+      exitCode: entry.exit ? entry.exit.exitCode ?? null : null,
       id: entry.id,
       label: entry.name,
       owned: true,
@@ -902,6 +905,20 @@ export class PtyTerminalHost {
  * connection; the panes and their programs go on, and the next daemon finds them there. The server starts on first
  * use, detached, and leaves a minute after it holds no pane and no client.
  */
+/** What the pane server loads beyond this package (PtyTerminalHost's dynamic imports). */
+const PANE_RUNTIME_PACKAGES = ['@homebridge/node-pty-prebuilt-multiarch', '@xterm/headless', '@xterm/addon-serialize'];
+
+/** A dependency's package directory: the nearest one above its entry named for it (ESM resolution, as it is loaded). */
+function packageDir(name) {
+  let dir = dirname(fileURLToPath(import.meta.resolve(name)));
+  for (;;) {
+    try { if (JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8')).name === name) return dir; } catch { /* not a package root */ }
+    const up = dirname(dir);
+    if (up === dir) throw new Error(`no package directory for ${name}`);
+    dir = up;
+  }
+}
+
 export class PaneServerHost {
   #connection = null;
   #connecting = null;
@@ -910,11 +927,44 @@ export class PaneServerHost {
   #streams = new Map();
   #pipe;
   #serverScript;
+  #runtimeDir;
 
+  /**
+   * `runtimeDir`: where the pane server runs from, a copy of this package and its runtime dependencies per version
+   * (`<runtimeDir>/<version>`). A running pane server holds node-pty's native module open, and Windows cannot replace
+   * a file in use, so a server started from the installed package would stop the next install of it; started from its
+   * own copy, it leaves the installed package free to change under it. Without one, it runs from the package.
+   */
   constructor(options = {}) {
     if (!options.pipe) throw new TypeError('PaneServerHost requires a pipe name');
     this.#pipe = options.pipe;
-    this.#serverScript = options.serverScript ?? fileURLToPath(new URL('./substrate/pane-server.mjs', import.meta.url));
+    this.#serverScript = options.serverScript ?? null;
+    this.#runtimeDir = options.runtimeDir ?? null;
+  }
+
+  /** The pane server's script: its own versioned copy under runtimeDir, made once, else the package's. */
+  #script() {
+    if (this.#serverScript) return this.#serverScript;
+    const installed = fileURLToPath(new URL('./substrate/pane-server.mjs', import.meta.url));
+    if (!this.#runtimeDir) return installed;
+    const root = fileURLToPath(new URL('.', import.meta.url));
+    const version = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).version;
+    const target = join(this.#runtimeDir, version);
+    const script = join(target, 'node_modules', '@volter', 'supercode-terminal', 'substrate', 'pane-server.mjs');
+    if (existsSync(join(target, '.complete'))) return script;
+    try {
+      const staging = `${target}.${process.pid}.staging`;
+      rmSync(staging, { recursive: true, force: true });
+      cpSync(root, join(staging, 'node_modules', '@volter', 'supercode-terminal'), { recursive: true, filter: (path) => !path.slice(root.length).split(/[\\/]/).includes('node_modules') });
+      for (const name of PANE_RUNTIME_PACKAGES) cpSync(packageDir(name), join(staging, 'node_modules', ...name.split('/')), { recursive: true });
+      writeFileSync(join(staging, '.complete'), `${version}\n`);
+      rmSync(target, { recursive: true, force: true });
+      renameSync(staging, target);
+      return script;
+    } catch {
+      // A copy that cannot be made (a full disk, a racing daemon) leaves the package's own script, as before.
+      return existsSync(join(target, '.complete')) ? script : installed;
+    }
   }
 
   listSessions() { return this.#request('listSessions', []); }
@@ -996,7 +1046,7 @@ export class PaneServerHost {
       } catch (error) {
         // No server on the pipe yet: start one, detached from this daemon, and try again as it comes up.
         if (attempt === 0 && (error.code === 'ENOENT' || error.code === 'ECONNREFUSED')) {
-          const child = spawn(process.execPath, [this.#serverScript, this.#pipe], { detached: true, stdio: 'ignore', windowsHide: true, env: process.env });
+          const child = spawn(process.execPath, [this.#script(), this.#pipe], { detached: true, stdio: 'ignore', windowsHide: true, env: process.env });
           child.on('error', () => {});
           child.unref();
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-terminal",
-  "version": "0.2.38",
+  "version": "0.2.40",
   "type": "module",
   "description": "Optional leak-safe terminal and tmux host adapter for Volter Harness frontends",
   "exports": {