@rynx-ai/runtime 0.1.11-beta.20 → 0.1.11-beta.21

package/dist/terminal/tmux.d.ts

@@ -49,6 +49,19 @@ export declare function resolveTmuxBin(explicit?: string, env?: NodeJS.ProcessEn
  * shutdown uses the same mapping when the runner child is too wedged to clean
  * up its own tmux server. */
 export declare function tmuxSocketPath(name: string): string;
+/** Read tmux's own output-activity clock for a private terminal window.
+ *
+ * `#{window_activity}` is an epoch timestamp updated by tmux whenever the pane
+ * emits bytes. It is deliberately queried out-of-process rather than inferred
+ * from Rynx's forwarded PTY stream: the forwarder/status path is exactly what
+ * may have stalled when the idle reaper needs an independent liveness signal.
+ * Missing servers, command failures, timeouts, and unparseable output are all
+ * treated as unknown (`null`). */
+export declare function tmuxWindowActivityAt(name: string, tmuxBin?: string): Promise<number | null>;
+/** Whether tmux itself reports an attached client for this private terminal.
+ * This remains authoritative if a parent-side attachment bookkeeping edge was
+ * missed during a transport failure. */
+export declare function tmuxHasAttachedClient(name: string, tmuxBin?: string): Promise<boolean>;
 /** Kill one private tmux server and verify it no longer answers. Missing
  * sockets are already stopped; an existing socket with an unusable tmux
  * command is unproven and returns false. */
@@ -113,6 +126,8 @@ export declare class TmuxTerminal {
      *  terminal appears "stuck"). reference implementation's `_tmux_session_alive` uses an async
      *  subprocess + timeout for exactly this reason. */
     isAliveAsync(): Promise<boolean>;
+    /** PID of the process currently owning the pane. */
+    panePid(): number | undefined;
     /** Type literal text into the pane (agent injection / co-drive from a
      *  non-PTY caller). `-l` sends the text literally rather than as key names. */
     sendKeys(text: string): void;

package/dist/terminal/tmux.js

@@ -42,6 +42,43 @@ export function tmuxSocketPath(name) {
     const key = createHash("sha256").update(name).digest("hex").slice(0, 16);
     return join(tmpdir(), "rynx-term", `${key}.sock`);
 }
+/** Read tmux's own output-activity clock for a private terminal window.
+ *
+ * `#{window_activity}` is an epoch timestamp updated by tmux whenever the pane
+ * emits bytes. It is deliberately queried out-of-process rather than inferred
+ * from Rynx's forwarded PTY stream: the forwarder/status path is exactly what
+ * may have stalled when the idle reaper needs an independent liveness signal.
+ * Missing servers, command failures, timeouts, and unparseable output are all
+ * treated as unknown (`null`). */
+export function tmuxWindowActivityAt(name, tmuxBin = resolveTmuxBin()) {
+    const socketPath = tmuxSocketPath(name);
+    return new Promise((resolve) => {
+        execFile(tmuxBin, ["-S", socketPath, "display-message", "-p", "-t", TMUX_TARGET, "#{window_activity}"], { timeout: 2_000 }, (error, stdout) => {
+            if (error) {
+                resolve(null);
+                return;
+            }
+            const raw = stdout.toString().trim();
+            if (!raw) {
+                resolve(null);
+                return;
+            }
+            const value = Number(raw);
+            resolve(Number.isFinite(value) ? value : null);
+        });
+    });
+}
+/** Whether tmux itself reports an attached client for this private terminal.
+ * This remains authoritative if a parent-side attachment bookkeeping edge was
+ * missed during a transport failure. */
+export function tmuxHasAttachedClient(name, tmuxBin = resolveTmuxBin()) {
+    const socketPath = tmuxSocketPath(name);
+    return new Promise((resolve) => {
+        execFile(tmuxBin, ["-S", socketPath, "list-clients", "-t", TMUX_TARGET, "-F", "#{client_name}"], { timeout: 2_000 }, (error, stdout) => {
+            resolve(!error && stdout.toString().split("\n").some((line) => line.trim().length > 0));
+        });
+    });
+}
 /** Kill one private tmux server and verify it no longer answers. Missing
  * sockets are already stopped; an existing socket with an unusable tmux
  * command is unproven and returns false. */
@@ -281,6 +318,19 @@ export class TmuxTerminal {
             });
         });
     }
+    /** PID of the process currently owning the pane. */
+    panePid() {
+        if (!this.started)
+            return undefined;
+        try {
+            const value = execFileSync(this.tmuxBin, [...this.base(), "list-panes", "-t", TMUX_TARGET, "-F", "#{pane_pid}"], { stdio: ["ignore", "pipe", "ignore"] }).toString().trim().split(/\s+/)[0];
+            const pid = Number(value);
+            return Number.isSafeInteger(pid) && pid > 0 ? pid : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
     /** Type literal text into the pane (agent injection / co-drive from a
      *  non-PTY caller). `-l` sends the text literally rather than as key names. */
     sendKeys(text) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rynx-ai/runtime",
-  "version": "0.1.11-beta.20",
+  "version": "0.1.11-beta.21",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/rynx-ai/rynx.git",
@@ -27,7 +27,7 @@
     "node-pty": "1.2.0-beta.15",
     "smol-toml": "1.7.1",
     "ws": "^8.21.0",
-    "@rynx-ai/core": "0.1.11-beta.20"
+    "@rynx-ai/core": "0.1.11-beta.21"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"