pi-web-ui 0.15.6 → 0.16.0

package/dist/server/agent-service.js

@@ -11,7 +11,7 @@
  * so reconnects just re-request a snapshot.
  */
 import { spawn } from "node:child_process";
-import { existsSync, readFileSync, statSync, writeFileSync, mkdirSync, } from "node:fs";
+import { existsSync, readFileSync, statSync, writeFileSync, mkdirSync, watch, } from "node:fs";
 import { dirname, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, getAgentDir, SessionManager, } from "@earendil-works/pi-coding-agent";
@@ -728,6 +728,14 @@ export class ClientSession {
     disposed = false;
     /** pi-config readiness check, cached briefly so 60ms snapshots don't hit disk. */
     piCheckCache = null;
+    /** fs.watch on the currently-listed directory — file changes push an instant
+     *  refresh (`file_changed`) so the tree updates without waiting for the 10s
+     *  poll. Only the listed directory is watched (one level); navigating
+     *  re-watches the new target. fs.watch isn't available on every platform /
+     *  filesystem — failures silently fall back to the poll. */
+    fsWatcher = null;
+    watchPath = null;
+    watchTimer = null;
     constructor(clientId, cwd, agentDir, stateStore) {
         this.clientId = clientId;
         this.cwd = cwd;
@@ -829,8 +837,11 @@ export class ClientSession {
         this.sinks.delete(send);
         // No sockets left for this client — kill its terminals so processes don't
         // survive a closed tab / dropped connection.
-        if (this.sinks.size === 0)
+        if (this.sinks.size === 0) {
             this.terminals.killAll();
+            // No sockets → nobody to refresh; drop the dir watcher too.
+            this.unwatchDir();
+        }
     }
     /** Broadcast to every connected socket of this client. */
     emit(msg) {
@@ -2432,6 +2443,9 @@ export class ClientSession {
             // always use "/", but relative() returns "\\" on Windows.
             const rel = rawRel.split(sep).join("/");
             const { entries, truncated, error } = await readDirForUI(target, rel);
+            // Watch the listed directory (only after a successful read — a missing
+            // dir throws above and must not create a watcher on a phantom path).
+            this.watchDir(target, rel);
             if (error) {
                 // Windows-only: unreadable system dirs degrade to an empty list
                 // with a warning instead of a hard error — the panel stays usable.
@@ -2461,6 +2475,56 @@ export class ClientSession {
             });
         }
     }
+    /** Watch a directory for changes so the file panel refreshes instantly
+     *  instead of waiting for the 10s poll. Watches the directory exactly as
+     *  listed (one level); navigating re-watches the new target. fs.watch is
+     *  unavailable on some platforms/filesystems — failures silently fall back
+     *  to the poll. */
+    watchDir(absPath, rel) {
+        if (this.disposed || this.watchPath === rel)
+            return;
+        this.unwatchDir();
+        this.watchPath = rel;
+        try {
+            // persistent: false — the watcher must not keep the process alive.
+            this.fsWatcher = watch(absPath, { persistent: false }, () => {
+                // Burst events (npm install, git ops, editor save→rename) are
+                // debounced into a single refresh.
+                if (this.watchTimer)
+                    return;
+                this.watchTimer = setTimeout(() => {
+                    this.watchTimer = null;
+                    this.emit({ type: "file_changed", path: this.watchPath ?? "" });
+                }, 400);
+            });
+            this.fsWatcher.on("error", () => {
+                // Directory deleted / unsupported fs — stop watching; the poll (or
+                // the next navigation) restores things.
+                this.unwatchDir();
+            });
+        }
+        catch {
+            // fs.watch unsupported (some network mounts, containers) — poll covers it.
+            this.fsWatcher = null;
+            this.watchPath = null;
+        }
+    }
+    unwatchDir() {
+        if (this.watchTimer) {
+            clearTimeout(this.watchTimer);
+            this.watchTimer = null;
+        }
+        if (this.fsWatcher) {
+            try {
+                this.fsWatcher.close();
+            }
+            catch {
+                // already closed
+            }
+            this.fsWatcher = null;
+        }
+        this.watchPath = null;
+    }
     /** Read a workspace file for the preview panel (size-capped, binary-safe). */
     async readFile(relPath) {
         try {
@@ -2827,6 +2891,7 @@ export class ClientSession {
             clearInterval(this.widgetsTimer);
             this.widgetsTimer = null;
         }
+        this.unwatchDir();
         this.webUi.dispose();
         for (const conv of this.convs.values()) {
             conv.unsubscribe?.();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-ui",
-  "version": "0.15.6",
+  "version": "0.16.0",
   "description": "Web chat interface for the pi coding agent, powered by the pi SDK (@earendil-works/pi-coding-agent) — one-command run, Docker/systemd/launchd deployable",
   "license": "MIT",
   "type": "module",