pi-sdk-web 0.5.17 → 0.5.18

package/dist/cli.js

@@ -16,6 +16,7 @@ import { getHeapStatistics } from "node:v8";
 import { dirname, join } from "node:path";
 import { findSessionByName, listSessions, loadBuiltinExtensions } from "./session.js";
 import { PiWebServer } from "./server.js";
+import { logError, logInfo } from "./log.js";
 // ---------------------------------------------------------------------------
 // Pretend to be Pi for in-process extensions.
 //
@@ -90,11 +91,11 @@ function ensureHeapHeadroom() {
         return false; // close enough already
     const totalMb = totalmem() / (1024 * 1024);
     if (totalMb < target * 2) {
-        console.log(`heap: keeping the default limit (${heapLimitMb().toFixed(0)}MB) - ` +
+        logInfo(`heap: keeping the default limit (${heapLimitMb().toFixed(0)}MB) - ` +
             `raising it to ${target}MB needs ~${target * 2}MB of RAM, host has ${totalMb.toFixed(0)}MB`);
         return false;
     }
-    console.log(`heap: restarting with --max-old-space-size=${target} (current limit ${heapLimitMb().toFixed(0)}MB)`);
+    logInfo(`heap: restarting with --max-old-space-size=${target} (current limit ${heapLimitMb().toFixed(0)}MB)`);
     const child = spawn(process.execPath, [`--max-old-space-size=${target}`, fileURLToPath(import.meta.url), ...process.argv.slice(2)], { stdio: "inherit", env: { ...process.env, PI_WEB_HEAP_REEXEC: "1" } });
     // Stay alive without acting on the signal ourselves: the child is in the
     // same process group and runs its own graceful shutdown, and we exit with
@@ -103,7 +104,7 @@ function ensureHeapHeadroom() {
     process.on("SIGTERM", () => { });
     child.on("exit", (code, signal) => process.exit(signal ? 1 : (code ?? 1)));
     child.on("error", (err) => {
-        console.error(`heap: failed to restart with a larger heap: ${err.message}`);
+        logError(`heap: failed to restart with a larger heap: ${err.message}`);
         process.exit(1);
     });
     return true;
@@ -145,7 +146,7 @@ async function cmdResume(name, port) {
         }
         catch {
             // Session cwd no longer exists - keep current directory (same as pii)
-            console.error(`Session cwd not found (${cwd}), keeping current directory`);
+            logError(`Session cwd not found (${cwd}), keeping current directory`);
         }
     }
     // Create services the way Pi's CLI does: extensions (including built-in
@@ -186,14 +187,14 @@ async function cmdResume(name, port) {
     const { session } = runtime;
     const server = new PiWebServer(runtime, { port });
     await server.start();
-    console.log(`server at http://127.0.0.1:${port}/ (session: ${info.name ?? info.id})`);
-    console.log(`heap limit: ${heapLimitMb().toFixed(0)}MB`);
+    logInfo(`server at http://127.0.0.1:${port}/ (session: ${info.name ?? info.id})`);
+    logInfo(`heap limit: ${heapLimitMb().toFixed(0)}MB`);
     let shuttingDown = false;
     const shutdown = async (signal) => {
         if (shuttingDown)
             return; // Repeated Ctrl+C must not re-enter teardown
         shuttingDown = true;
-        console.log(`\n${signal} received, shutting down...`);
+        logInfo(`${signal} received, shutting down...`);
         try {
             await server.stop();
         }

package/dist/log.js

@@ -0,0 +1,28 @@
+/**
+ * Timestamped logging for pi-web's own diagnostics.
+ *
+ * pi-web is a long-running server: its warnings (backpressure, memory
+ * watermarks, session issues) are read minutes to hours after the fact and
+ * mixed with other processes' output, so every line carries a local timestamp
+ * (`[2026-09-12 08:15:30] pi-web: …`).
+ *
+ * Only pi-web's own log lines go through here - command output (session
+ * lists, help text) stays plain so it can be piped or copied as-is.
+ */
+function timestamp(now) {
+    const pad = (n) => String(n).padStart(2, "0");
+    return (`${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ` +
+        `${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`);
+}
+/** Informational line (startup, status) on stdout. */
+export function logInfo(message) {
+    console.log(`[${timestamp(new Date())}] ${message}`);
+}
+/** Diagnostic warning on stderr. */
+export function logWarn(message) {
+    console.warn(`[${timestamp(new Date())}] ${message}`);
+}
+/** Error line on stderr. */
+export function logError(message) {
+    console.error(`[${timestamp(new Date())}] ${message}`);
+}

package/dist/server.js

@@ -18,6 +18,7 @@ import { ModelRegistry, VERSION, } from "@earendil-works/pi-coding-agent";
 import { WebSocket, WebSocketServer } from "ws";
 import { listSessions } from "./session.js";
 import { WebUIContext } from "./ui-context.js";
+import { logError, logWarn } from "./log.js";
 const DEFAULT_PORT = 4080;
 // Static frontend: prefer the in-package copy (built by `npm run build` for
 // global installs), fall back to the repo-root static/ during development.
@@ -202,7 +203,7 @@ export class PiWebServer {
                     process.chdir(cwd);
                 }
                 catch {
-                    console.error(`Session cwd not found (${cwd}), keeping current directory`);
+                    logError(`Session cwd not found (${cwd}), keeping current directory`);
                 }
             }
             this.broadcastState();
@@ -272,7 +273,7 @@ export class PiWebServer {
             if (buffered > WS_BUFFER_HARD_LIMIT) {
                 // Far beyond reading - treat as gone. The browser reconnects and
                 // reloads, so no state is lost, and memory stays bounded.
-                console.warn(`pi-web: client not reading (${(buffered / 1048576).toFixed(0)}MB queued) - closing it; ` +
+                logWarn(`pi-web: client not reading (${(buffered / 1048576).toFixed(0)}MB queued) - closing it; ` +
                     "the browser will reconnect and reload history");
                 this.backpressured.delete(client);
                 client.terminate();
@@ -281,14 +282,14 @@ export class PiWebServer {
             if (droppable && buffered > WS_BUFFER_SOFT_LIMIT) {
                 if (!this.backpressured.has(client)) {
                     this.backpressured.add(client);
-                    console.warn(`pi-web: client is behind (${(buffered / 1048576).toFixed(1)}MB queued) - ` +
+                    logWarn(`pi-web: client is behind (${(buffered / 1048576).toFixed(1)}MB queued) - ` +
                         "skipping stream deltas until it catches up");
                 }
                 continue;
             }
             if (this.backpressured.has(client) && buffered < WS_BUFFER_SOFT_LIMIT / 2) {
                 this.backpressured.delete(client);
-                console.warn("pi-web: client caught up - stream deltas resumed");
+                logWarn("pi-web: client caught up - stream deltas resumed");
             }
             try {
                 client.send(message);
@@ -319,7 +320,7 @@ export class PiWebServer {
                 continue;
             this.memoryLogged.add(threshold);
             const queued = [...this.clients].map((c) => `${(c.bufferedAmount / 1048576).toFixed(1)}MB`).join(", ") || "no clients";
-            console.warn(`pi-web: memory ${rssMb.toFixed(0)}MB (heap ${(heapUsed / 1048576).toFixed(0)}/` +
+            logWarn(`pi-web: memory ${rssMb.toFixed(0)}MB (heap ${(heapUsed / 1048576).toFixed(0)}/` +
                 `${(heapTotal / 1048576).toFixed(0)}MB), queued per client: ${queued}`);
         }
     }
@@ -430,7 +431,7 @@ export class PiWebServer {
         // the largest single payload, so a client that never reads it must not be
         // allowed to queue forever.
         if (ws.bufferedAmount > WS_BUFFER_HARD_LIMIT) {
-            console.warn("pi-web: client not reading its initial snapshot - closing it");
+            logWarn("pi-web: client not reading its initial snapshot - closing it");
             ws.terminate();
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-sdk-web",
-  "version": "0.5.17",
+  "version": "0.5.18",
   "description": "Browser Web access for Pi (AI coding agent) via the Pi SDK - standalone module, zero modification to Pi itself",
   "type": "module",
   "bin": {