@volter/supercode-terminal 0.2.59 → 0.2.60

package/index.mjs

@@ -157,6 +157,8 @@ export class TerminalWebSocketBridge {
 
 export class TmuxTerminalHost {
   #allowUnownedControl;
+  #generation = 0;
+  #listing = null;
   #attachments = new Map();
   #attachSocket;
   #catalog = new Map();
@@ -186,7 +188,19 @@ export class TmuxTerminalHost {
     this.#ttlMs = positiveInteger(options.attachmentTtlMs ?? DEFAULT_ATTACHMENT_TTL_MS, 'attachmentTtlMs');
   }
 
-  async listSessions() {
+  /**
+   * The panes, as tmux lists them. Callers asking while a listing is running share it (one listing is five tmux
+   * processes, and a daemon's doors ask together); a change made through this host since starts a fresh one.
+   */
+  listSessions() {
+    if (this.#listing && this.#listing.generation === this.#generation) return this.#listing.promise;
+    const listing = { generation: this.#generation, promise: null };
+    listing.promise = this.#listSessions().finally(() => { if (this.#listing === listing) this.#listing = null; });
+    this.#listing = listing;
+    return listing.promise;
+  }
+
+  async #listSessions() {
     this.#pruneAttachments();
     const names = this.#sessionNames();
     const liveNames = new Set(names);
@@ -215,6 +229,8 @@ export class TmuxTerminalHost {
         label: name,
         owned: ownedNames.has(name),
         size: size ? Object.freeze({ columns: size.width, rows: size.height }) : null,
+        // When the pane last printed, as tmux keeps it (milliseconds): idle time without a screen capture.
+        lastOutputAt: size?.activity ? size.activity * 1000 : null,
       });
     });
   }
@@ -246,6 +262,8 @@ export class TmuxTerminalHost {
       settings: TERMINAL_LIKE_SESSION,
       socket: this.#socket,
     });
+    // Raised once tmux has the session: a listing started before then cannot be the one that answers below.
+    this.#generation += 1;
     const id = this.#catalogId(name);
     const created = (await this.listSessions()).find((session) => session.id === id);
     if (!created) {
@@ -285,6 +303,7 @@ export class TmuxTerminalHost {
       throw new TerminalHostError('bind_not_allowed', 'This host does not own that tmux session.');
     }
     await this.#tmux.setSessionOptionAsync(entry.name, this.#contextOption, contextKey, this.#socket);
+    this.#generation += 1;
     const bound = (await this.listSessions()).find((session) => session.id === sessionId);
     if (!bound) {
       throw new TerminalHostError('session_not_found', 'The tmux session exited before it could be bound.');
@@ -372,6 +391,7 @@ export class TmuxTerminalHost {
       throw new TerminalHostError('close_not_allowed', 'This host does not own that tmux session.');
     }
     this.#tmux.killSessionProcessTree({ session: entry.name, socket: this.#socket });
+    this.#generation += 1;
     this.#catalog.delete(sessionId);
     this.#idByName.delete(entry.name);
     for (const [id, grant] of this.#attachments) {

package/package.json

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

package/substrate/tmux.d.ts

@@ -8,6 +8,8 @@ export type TmuxPane = {
 export type TmuxWindowSize = {
     width: number;
     height: number;
+    /** When the window last had output, in Unix seconds (tmux's `window_activity`); absent when tmux did not say. */
+    activity?: number;
 };
 export type TmuxCommand = {
     arguments?: string[];

package/substrate/tmux.js

@@ -670,7 +670,7 @@ export async function listWindowSizesAsync(socket) {
             "list-windows",
             "-a",
             "-F",
-            `#{session_name}${separator}#{window_index}${separator}#{window_width}${separator}#{window_height}`
+            `#{session_name}${separator}#{window_index}${separator}#{window_width}${separator}#{window_height}${separator}#{window_activity}`
         ]))).trim();
     }
     catch (error) {
@@ -692,7 +692,7 @@ export async function listWindowSizesAsync(socket) {
         return sizes;
     }
     for (const line of output.split("\n")) {
-        const [session, windowIndex, width, height] = line.split(separator);
+        const [session, windowIndex, width, height, activity] = line.split(separator);
         // Match getWindowSize, which reads window 0; ignore extra windows of a session.
         if (!session || windowIndex !== "0") {
             continue;
@@ -700,7 +700,8 @@ export async function listWindowSizesAsync(socket) {
         const parsedWidth = Number(width);
         const parsedHeight = Number(height);
         if (Number.isInteger(parsedWidth) && Number.isInteger(parsedHeight) && parsedWidth >= 1 && parsedHeight >= 1) {
-            sizes.set(session, { height: parsedHeight, width: parsedWidth });
+            const parsedActivity = Number(activity);
+            sizes.set(session, { height: parsedHeight, width: parsedWidth, ...(Number.isInteger(parsedActivity) && parsedActivity > 0 ? { activity: parsedActivity } : {}) });
         }
     }
     return sizes;