@vendian/cli 0.0.28 → 0.0.30

package/cli-wrapper.mjs

@@ -1107,7 +1107,7 @@ import path8 from "node:path";
 import readlinePromises from "node:readline/promises";
 
 // src/version.js
-var CLI_VERSION = true ? "0.0.28" : process.env.npm_package_version || "0.0.0-dev";
+var CLI_VERSION = true ? "0.0.30" : process.env.npm_package_version || "0.0.0-dev";
 
 // src/npm-update.js
 var NPM_CHECK_INTERVAL_MS = 30 * 60 * 1e3;
@@ -2399,6 +2399,87 @@ async function loadTerm() {
 }
 var HEADER_ROWS_BASE = 7;
 var SERVE_CONTENT_ROW = 10;
+function clampListIndex(index, count) {
+  if (!Number.isFinite(count) || count <= 0) return 0;
+  if (!Number.isFinite(index)) return 0;
+  return Math.max(0, Math.min(count - 1, index));
+}
+function centeredWindowStart(selectedIdx, visibleCount, totalCount) {
+  if (visibleCount >= totalCount) return 0;
+  const half = Math.floor(visibleCount / 2);
+  const maxStart = Math.max(0, totalCount - visibleCount);
+  return Math.max(0, Math.min(maxStart, selectedIdx - half));
+}
+function computeServeDashboardViewport({
+  termHeight = 24,
+  agentCount = 0,
+  selectedIdx = 0,
+  activityCount = 0,
+  diagnosticsCount = 0
+} = {}) {
+  const availableRows = Math.max(4, (termHeight || 24) - SERVE_CONTENT_ROW + 1);
+  const clampedSelectedIdx = clampListIndex(selectedIdx, agentCount);
+  const viewport = {
+    selectedIdx: clampedSelectedIdx,
+    showBlankAfterStatus: false,
+    showAgentHeader: agentCount > 0,
+    visibleAgentCount: 0,
+    agentWindowStart: 0,
+    showAgentHint: false,
+    showAgentRange: false,
+    visibleActivityCount: 0,
+    showActivityHeader: false,
+    visibleDiagnosticsCount: 0,
+    showDiagnosticsHeader: false,
+    showInlineErrors: (termHeight || 24) >= 24
+  };
+  let remaining = availableRows;
+  remaining -= 1;
+  remaining -= 1;
+  if (agentCount > 0) {
+    remaining -= 1;
+    viewport.visibleAgentCount = 1;
+    remaining -= 1;
+  } else {
+    remaining -= 1;
+  }
+  if (remaining > 0) {
+    viewport.showBlankAfterStatus = true;
+    remaining -= 1;
+  }
+  if (agentCount > 1 && remaining > 0) {
+    const extraAgentRows = Math.min(agentCount - 1, remaining);
+    viewport.visibleAgentCount += extraAgentRows;
+    remaining -= extraAgentRows;
+  }
+  if (agentCount > 0) {
+    viewport.agentWindowStart = centeredWindowStart(
+      clampedSelectedIdx,
+      viewport.visibleAgentCount,
+      agentCount
+    );
+    viewport.showAgentHint = remaining > 0;
+    if (viewport.showAgentHint) remaining -= 1;
+    viewport.showAgentRange = viewport.visibleAgentCount > 0 && viewport.visibleAgentCount < agentCount;
+  }
+  if (activityCount > 0 && remaining > 1) {
+    viewport.showActivityHeader = true;
+    remaining -= 1;
+    viewport.visibleActivityCount = Math.min(activityCount, remaining);
+    remaining -= viewport.visibleActivityCount;
+  }
+  if (diagnosticsCount > 0 && remaining > 1) {
+    viewport.showDiagnosticsHeader = true;
+    remaining -= 1;
+    viewport.visibleDiagnosticsCount = Math.min(diagnosticsCount, remaining);
+  }
+  return viewport;
+}
+function stopSignalForAttempt(attempt = 0) {
+  if (!Number.isFinite(attempt) || attempt <= 0) return "SIGINT";
+  if (attempt === 1) return "SIGTERM";
+  return "SIGKILL";
+}
 async function runTui({
   env = process.env,
   platform = process.platform,
@@ -2912,6 +2993,10 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
   let dashboardClosed = false;
   let exitPromptActive = false;
   let selectedIdx = 0;
+  let pressedAgentIdx = null;
+  let stopRequested = false;
+  let stopSignalAttempt = 0;
+  let stopTimer = null;
   const agentRowMap = /* @__PURE__ */ new Map();
   function agentDisplayList() {
     return state.agents.map((agent, i) => {
@@ -2939,12 +3024,26 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
   }
   function redraw() {
     if (dashboardClosed || overlayActive) return;
+    const agents = agentDisplayList();
+    const activity = recentActivityLines();
+    const diagnostics = daemonDebugLines();
+    const viewport = computeServeDashboardViewport({
+      termHeight: term.height || 24,
+      agentCount: agents.length,
+      selectedIdx,
+      activityCount: activity.length,
+      diagnosticsCount: diagnostics.length
+    });
+    selectedIdx = viewport.selectedIdx;
     drawHeader({ env, platform, serveState: state });
     term.moveTo(1, SERVE_CONTENT_ROW);
     term.eraseDisplayBelow();
     agentRowMap.clear();
     if (startupError) {
       term.red(`  ${fig.cross} ${clip(startupError, (term.width || 80) - 6)}
+`);
+    } else if (stopRequested) {
+      term.yellow(`  ${fig.warning} ${clip(state.activity || "Stopping your agents\u2026", (term.width || 80) - 6)}
 `);
     } else if (state.stopped) {
       term.yellow(`  ${fig.warning} Your agents have stopped.
@@ -2958,12 +3057,15 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
       term.gray(`${clip(state.activity || "Starting up\u2026", 55)}
 `);
     }
-    const agents = agentDisplayList();
     if (agents.length > 0) {
-      term("\n");
+      if (viewport.showBlankAfterStatus) term("\n");
       term.bold.gray("  Your agents:\n");
-      let lineOffset = SERVE_CONTENT_ROW + 3;
-      for (const ag of agents) {
+      let lineOffset = SERVE_CONTENT_ROW + 2 + (viewport.showBlankAfterStatus ? 1 : 0);
+      const visibleAgents = agents.slice(
+        viewport.agentWindowStart,
+        viewport.agentWindowStart + viewport.visibleAgentCount
+      );
+      for (const ag of visibleAgents) {
         const isSelected = ag.num - 1 === selectedIdx;
         agentRowMap.set(lineOffset, ag.num - 1);
         const numStr = String(ag.num).padStart(2);
@@ -3014,26 +3116,32 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
         }
         term("\n");
         lineOffset++;
-        if (ag.errMsg) {
+        if (viewport.showInlineErrors && isSelected && ag.errMsg) {
           term.red(`       \u2514\u2500 ${clip(ag.errMsg, (term.width || 80) - 14)}
 `);
           lineOffset++;
         }
       }
-      term("\n");
-      term.gray(`  Click an agent or use \u2191\u2193 + Enter to see its activity log
+      if (viewport.showAgentRange) {
+        const first = viewport.agentWindowStart + 1;
+        const last = viewport.agentWindowStart + visibleAgents.length;
+        term.gray(`  Showing agents ${first}\u2013${last} of ${agents.length}
+`);
+      }
+      if (viewport.showAgentHint) {
+        term.gray(`  Click an agent or use \u2191\u2193 + Enter to see its activity log
 `);
+      }
     } else {
-      term("\n");
+      if (viewport.showBlankAfterStatus) term("\n");
       term.gray("  Looking for your agents\u2026\n");
     }
-    const activity = recentActivityLines();
-    if (activity.length > 0) {
+    if (viewport.showActivityHeader) {
+      const visibleActivity = activity.slice(-viewport.visibleActivityCount);
       const divW = Math.min((term.width || 80) - 4, 60);
-      term("\n");
       term.gray(`  ${"\u2500".repeat(3)} Recent activity ${"\u2500".repeat(Math.max(0, divW - 18))}
 `);
-      for (const e of activity) {
+      for (const e of visibleActivity) {
         const t = formatLogTime(e.timestamp);
         const name = clip(e._agentName || "Agent", 20);
         const msg = clip(friendlyActivityLine(e), (term.width || 80) - 30);
@@ -3055,13 +3163,12 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
         }
       }
     }
-    const diagnostics = daemonDebugLines();
-    if (diagnostics.length > 0) {
+    if (viewport.showDiagnosticsHeader) {
+      const visibleDiagnostics = diagnostics.slice(-viewport.visibleDiagnosticsCount);
       const divW = Math.min((term.width || 80) - 4, 72);
-      term("\n");
       term.gray(`  ${"\u2500".repeat(3)} Daemon diagnostics ${"\u2500".repeat(Math.max(0, divW - 23))}
 `);
-      for (const entry of diagnostics) {
+      for (const entry of visibleDiagnostics) {
         const t = formatLogTime(entry.timestamp);
         const type = clip(entry.eventType || "event", 24).padEnd(24);
         const msg = clip(entry.message || "", (term.width || 80) - 38);
@@ -3081,6 +3188,10 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
     term("\n");
     if (ctrlCArmed) {
       term.yellow.bold("  Press Ctrl+C again to exit.\n");
+    } else if (stopRequested) {
+      term.yellow("  Stopping your agents\u2026");
+      if (stopSignalAttempt > 0) term.gray("  (retrying shutdown)");
+      term("\n");
     } else {
       term.gray("  ");
       term.brightBlue.bold("S");
@@ -3137,10 +3248,12 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
   }
   return new Promise((resolve) => {
     function openAgentLog(idx) {
-      if (dashboardClosed || exitPromptActive || idx < 0 || idx >= state.agents.length) return;
+      const agents = agentDisplayList();
+      const clampedIdx = clampListIndex(idx, agents.length);
+      if (dashboardClosed || exitPromptActive || agents.length === 0 || idx !== clampedIdx) return;
       overlayActive = true;
-      const ag = agentDisplayList()[idx];
-      showAgentLog({ agent: ag, state, env, platform }).then(() => {
+      const ag = agents[clampedIdx];
+      showAgentLog({ agent: ag, getState: () => state, env, platform }).then(() => {
         if (dashboardClosed) return;
         overlayActive = false;
         term.clear();
@@ -3154,14 +3267,62 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
         ctrlCArmTimer = null;
       }
     }
+    function clearStopTimer() {
+      if (stopTimer) {
+        clearTimeout(stopTimer);
+        stopTimer = null;
+      }
+    }
+    function childIsRunning() {
+      return Boolean(child) && child.exitCode == null && child.signalCode == null;
+    }
+    function scheduleStopEscalation() {
+      clearStopTimer();
+      if (!childIsRunning()) return;
+      stopTimer = setTimeout(() => {
+        if (!stopRequested || dashboardClosed || !childIsRunning()) return;
+        stopSignalAttempt += 1;
+        const signal = stopSignalForAttempt(stopSignalAttempt);
+        state = {
+          ...state,
+          activity: signal === "SIGTERM" ? "Still stopping your agents\u2026" : "Force stopping your agents\u2026"
+        };
+        try {
+          child.kill(signal);
+        } catch {
+        }
+        if (!overlayActive) redraw();
+        if (signal !== "SIGKILL") scheduleStopEscalation();
+      }, 4e3);
+    }
+    function requestStop() {
+      if (dashboardClosed) return;
+      if (stopRequested) return;
+      if (!childIsRunning()) {
+        finish("home");
+        return;
+      }
+      stopRequested = true;
+      stopSignalAttempt = 0;
+      state = { ...state, activity: "Stopping your agents\u2026" };
+      clearCtrlCArm();
+      try {
+        child.kill(stopSignalForAttempt(stopSignalAttempt));
+      } catch {
+      }
+      scheduleStopEscalation();
+      if (!overlayActive) redraw();
+    }
     function detachDashboardHandlers() {
       term.off("key", handleKey);
       term.off("mouse", handleMouse);
+      term.off("resize", handleResize);
     }
     function finish(next) {
       if (dashboardClosed) return;
       dashboardClosed = true;
       clearCtrlCArm();
+      clearStopTimer();
       detachDashboardHandlers();
       resolve(next);
     }
@@ -3181,41 +3342,62 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
         return;
       }
       if (overlayActive) return;
-      const agCount = state.agents.length;
+      if (stopRequested) return;
+      const agCount = agentDisplayList().length;
       if (name >= "1" && name <= "9") {
         openAgentLog(parseInt(name, 10) - 1);
         return;
       }
       if (name === "UP" && agCount > 0) {
-        selectedIdx = (selectedIdx - 1 + agCount) % agCount;
+        selectedIdx = clampListIndex(selectedIdx - 1, agCount);
         redraw();
       } else if (name === "DOWN" && agCount > 0) {
-        selectedIdx = (selectedIdx + 1) % agCount;
+        selectedIdx = clampListIndex(selectedIdx + 1, agCount);
         redraw();
       } else if (name === "ENTER") {
         openAgentLog(selectedIdx);
       } else if (name === "s" || name === "S") {
-        child?.kill("SIGINT");
-        finish("home");
+        requestStop();
       }
     }
     function handleMouse(name, data) {
-      if (overlayActive) return;
+      if (overlayActive || stopRequested) return;
       const idx = agentRowMap.get(data.y);
-      if (idx === void 0) return;
       if (name === "MOUSE_LEFT_BUTTON_PRESSED") {
-        openAgentLog(idx);
-      } else if (name !== "MOUSE_LEFT_BUTTON_RELEASED") {
+        pressedAgentIdx = idx ?? null;
+        if (idx !== void 0 && idx !== selectedIdx) {
+          selectedIdx = idx;
+          redraw();
+        }
+        return;
+      }
+      if (name === "MOUSE_LEFT_BUTTON_RELEASED") {
+        const shouldOpen = idx !== void 0 && idx === pressedAgentIdx;
+        pressedAgentIdx = null;
+        if (shouldOpen) openAgentLog(idx);
+        return;
+      }
+      if (idx === void 0) return;
+      if (name !== "MOUSE_LEFT_BUTTON_RELEASED") {
         if (idx !== selectedIdx) {
           selectedIdx = idx;
           redraw();
         }
       }
     }
+    function handleResize() {
+      if (!overlayActive) redraw();
+    }
     term.on("key", handleKey);
     term.on("mouse", handleMouse);
+    term.on("resize", handleResize);
     if (child) {
       child.once("exit", () => {
+        clearStopTimer();
+        if (stopRequested) {
+          finish("home");
+          return;
+        }
         setTimeout(() => {
           if (dashboardClosed || overlayActive) return;
           exitPromptActive = true;
@@ -3229,14 +3411,23 @@ async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
     }
   });
 }
-async function showAgentLog({ agent, state, env, platform }) {
-  const logs = agentLogEntries(state.agentLogs, agent.path);
-  const agentObj = state.agents.find((a) => (a.relativePath || ".") === agent.path);
-  const runtime = agentObj ? agentRuntimeStatus(agentObj, state.agentRunState) : { status: "unknown", label: "offline" };
-  const status = friendlyStatus(runtime.status);
+async function showAgentLog({ agent, getState, env, platform }) {
+  const liveState = typeof getState === "function" ? getState : () => getState;
   let scrollOffset = 0;
+  let autoScroll = true;
   const visibleCount = Math.max(8, (term.height || 24) - 14);
+  function currentLogs() {
+    return agentLogEntries(liveState().agentLogs, agent.path);
+  }
   function draw() {
+    const state = liveState();
+    const logs = currentLogs();
+    const agentObj = state.agents.find((a) => (a.relativePath || ".") === agent.path);
+    const runtime = agentObj ? agentRuntimeStatus(agentObj, state.agentRunState) : { status: "unknown", label: "offline" };
+    const status = friendlyStatus(runtime.status);
+    if (autoScroll) {
+      scrollOffset = Math.max(0, logs.length - visibleCount);
+    }
     term.clear();
     drawHeader({ env, platform, serveState: state });
     term("\n");
@@ -3301,27 +3492,50 @@ async function showAgentLog({ agent, state, env, platform }) {
     term.gray(" scroll    ");
     term.brightBlue.bold("PgUp/PgDn");
     term.gray(" page    ");
-    term.brightBlue.bold("Esc");
-    term.gray(" back\n");
+    if (autoScroll) {
+      term.brightBlue.bold("Esc");
+      term.gray(" back  ");
+      term.cyan("\u2193 live\n");
+    } else {
+      term.brightBlue.bold("Esc");
+      term.gray(" back  ");
+      term.gray("\u2193 ");
+      term.brightBlue.bold("End");
+      term.gray(" resume live\n");
+    }
   }
   draw();
+  let overlayDone = false;
+  const redrawInterval = setInterval(() => {
+    if (!overlayDone) draw();
+  }, 500);
   await new Promise((resolve) => {
     function handler(name) {
+      const logs = currentLogs();
       const maxOff = Math.max(0, logs.length - visibleCount);
       if (name === "ESCAPE") {
         term.off("key", handler);
+        overlayDone = true;
+        clearInterval(redrawInterval);
         resolve();
       } else if (name === "UP") {
+        autoScroll = false;
         scrollOffset = Math.max(0, scrollOffset - 1);
         draw();
       } else if (name === "DOWN") {
         scrollOffset = Math.min(maxOff, scrollOffset + 1);
+        if (scrollOffset >= maxOff) autoScroll = true;
         draw();
       } else if (name === "PAGE_UP") {
+        autoScroll = false;
         scrollOffset = Math.max(0, scrollOffset - visibleCount);
         draw();
       } else if (name === "PAGE_DOWN") {
         scrollOffset = Math.min(maxOff, scrollOffset + visibleCount);
+        if (scrollOffset >= maxOff) autoScroll = true;
+        draw();
+      } else if (name === "END") {
+        autoScroll = true;
         draw();
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vendian/cli",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "description": "Public Vendian CLI bootstrapper and launcher",
   "license": "UNLICENSED",
   "private": false,