@vendian/cli 0.0.27 → 0.0.29

package/README.md

@@ -8,6 +8,7 @@ vendian
 vendian login
 vendian init --output-dir ./agents
 vendian create "My Agent" --output-dir ./agents
+vendian cloud local run --collection-id YOUR_COLLECTION --path ./agents/my-agent --input-json '{}'
 vendian cloud local serve --agents-dir ./agents
 ```
 
@@ -23,11 +24,13 @@ vendian create "My Agent" --output-dir ./agents
 vendian validate ./agents/my-agent --runtime
 vendian test ./agents/my-agent --dry-run --mock-credentials
 vendian models
+vendian cloud local run --collection-id YOUR_COLLECTION --path ./agents/my-agent --input-json '{}'
 vendian cloud local serve --agents-dir ./agents
 ```
 
 Run `vendian` with no arguments to open the interactive menu. It shows your
-current endpoint connections and guides common local workflows.
+current endpoint connections and guides common local workflows, including
+running one local agent immediately or starting the long-lived local daemon.
 
 `vendian login` opens a browser sign-in, prepares the local runtime, and stores
 the credentials needed by the CLI for the selected endpoint. `vendian setup` is

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.27" : process.env.npm_package_version || "0.0.0-dev";
+var CLI_VERSION = true ? "0.0.29" : 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,
@@ -2412,12 +2493,12 @@ async function runTui({
   await refreshInteractiveManagedRuntime({ env, platform, output });
   await loadTerm();
   term.fullscreen(true);
-  term.hideCursor();
+  setCursorVisible(false);
   term.grabInput({ mouse: "motion" });
   const cleanup = () => {
     try {
       term.grabInput(false);
-      term.showCursor();
+      setCursorVisible(true);
       term.fullscreen(false);
     } catch {
     }
@@ -2451,6 +2532,9 @@ async function mainLoop({ env, platform }) {
   while (true) {
     let next;
     switch (screen) {
+      case "run":
+        next = await showRun({ env, platform });
+        break;
       case "home":
         next = await showHome({ env, platform });
         break;
@@ -2532,6 +2616,7 @@ var HOME_ACTIONS = [
   { value: "connect", label: "Sign in", desc: "Connect to a different account or environment" },
   { value: "create", label: "Create Agent", desc: "Build a new agent from a template" },
   { value: "commands", label: "Commands", desc: "Show all available CLI commands" },
+  { value: "run", label: "Run once", desc: "Execute one local agent immediately" },
   { value: "exit", label: "Exit", desc: "" }
 ];
 async function showHome({ env, platform }) {
@@ -2628,6 +2713,41 @@ async function showCreate({ env, platform }) {
   );
   return "home";
 }
+async function showRun({ env, platform }) {
+  const candidates = findAgentDirectoryCandidates();
+  const picked = await pickSingleAgentToRun({ env, platform, candidates });
+  if (!picked) return "home";
+  const workspace = await chooseCloudWorkspace({
+    env,
+    platform,
+    loadingTitle: "  Getting ready to run this agent\u2026",
+    pickerTitle: "  Which project should own this run?\n\n"
+  });
+  if (!workspace) return "home";
+  term.clear();
+  drawHeader({ env, platform });
+  term("\n");
+  term.bold(`  Run ${picked.displayName}
+
+`);
+  term.gray(`  Agent: ${picked.path}
+`);
+  term.gray(`  Project: ${workspace.label}
+
+`);
+  term.gray("  Input JSON: ");
+  const inputJson = await term.inputField({ cancelable: true, style: term.cyan, default: "{}" }).promise;
+  if (inputJson === null) return "home";
+  await withOutputMode(
+    `Running ${picked.displayName}`,
+    () => forwardToPythonVendian(buildLocalRunArgs({
+      agentPath: picked.path,
+      collectionId: workspace.id,
+      inputJson: inputJson || "{}"
+    }), { env, platform })
+  );
+  return "home";
+}
 var COMMAND_GROUPS = [
   { section: "Getting started", commands: [
     { cmd: "vendian login", desc: "Sign in and set up your computer" },
@@ -2640,6 +2760,7 @@ var COMMAND_GROUPS = [
     { cmd: "vendian models", desc: "List available AI models" }
   ] },
   { section: "Running agents", commands: [
+    { cmd: "vendian cloud local run --collection-id ID --path . --input-json '{}'", desc: "Run one local agent once" },
     { cmd: "vendian cloud local serve --agents-dir .", desc: "Start agents (advanced mode)" },
     { cmd: "vendian login --backend staging", desc: "Sign in to staging environment" }
   ] },
@@ -2680,57 +2801,14 @@ async function showServe({ env, platform }) {
   const picked = await pickAgentsToRun({ env, platform, candidates });
   if (!picked) return "home";
   const { agentsDir } = picked;
-  term.clear();
-  drawHeader({ env, platform });
-  term("\n");
-  term.bold(`  Getting ready to run your agents\u2026
-
-`);
-  let wsResult;
-  try {
-    wsResult = await listCloudWorkspaces({
-      env,
-      platform,
-      onProgress: (msg) => {
-        term.moveTo(1, HEADER_ROWS_BASE + 3);
-        term.eraseLine();
-        term.gray(`  ${clip(msg, 60)}
-`);
-      }
-    });
-  } catch (error) {
-    term.red(`
-  Couldn't connect to the server: ${errMsg(error)}
-`);
-    term.gray("  Make sure you are signed in (choose Sign in from the main menu).\n");
-    await pressEnterToContinue({ grabActive: false });
-    return "home";
-  }
-  if (!wsResult.ok) {
-    term.red(`
-  ${fig.cross} ${wsResult.error}
-`);
-    await pressEnterToContinue({ grabActive: false });
-    return "home";
-  }
-  let collectionId = wsResult.workspaces[0]?.id || "";
-  if (wsResult.workspaces.length > 1) {
-    term.clear();
-    drawHeader({ env, platform });
-    term("\n");
-    term.bold("  Which project do you want to run?\n\n");
-    const wsItems = [...wsResult.workspaces.map((w) => workspaceLabel(w)), "\u2190 Back"];
-    const wsResp = await term.singleColumnMenu(wsItems, {
-      cancelable: true,
-      style: term.gray,
-      selectedStyle: term.bgCyan.black.bold,
-      leftPadding: "    ",
-      selectedLeftPadding: "  \u203A "
-    }).promise;
-    if (wsResp.canceled || wsResp.selectedIndex === wsItems.length - 1) return "home";
-    collectionId = wsResult.workspaces[wsResp.selectedIndex]?.id || "";
-  }
-  return await runServeDashboard({ env, platform, agentsDir, collectionId });
+  const workspace = await chooseCloudWorkspace({
+    env,
+    platform,
+    loadingTitle: "  Getting ready to run your agents\u2026",
+    pickerTitle: "  Which project do you want to run?\n\n"
+  });
+  if (!workspace) return "home";
+  return await runServeDashboard({ env, platform, agentsDir, collectionId: workspace.id });
 }
 async function pickAgentsToRun({ env, platform, candidates }) {
   if (candidates.length === 0) {
@@ -2804,6 +2882,107 @@ async function pickAgentsFromFolder({ env, platform, candidate }) {
   if (resp.selectedIndex === 0) return { agentsDir: candidate.path };
   return { agentsDir: named[resp.selectedIndex - 1].path };
 }
+async function pickSingleAgentToRun({ env, platform, candidates }) {
+  if (candidates.length === 0) {
+    term.clear();
+    drawHeader({ env, platform });
+    term("\n");
+    term.bold("  I couldn't find any agents on your computer.\n\n");
+    term.gray("  Enter the path to one agent folder:\n\n");
+    term.gray("  Folder: ");
+    const input = await term.inputField({ cancelable: true, style: term.cyan, default: "./agents/my-agent" }).promise;
+    if (input === null) return null;
+    const agentPath = input || "./agents/my-agent";
+    return { path: agentPath, displayName: friendlyName(path8.basename(agentPath) || "Agent") };
+  }
+  const agents = candidates.flatMap((candidate) => {
+    const folders = findAgentFolders(candidate.absolutePath);
+    if (folders.length > 0) {
+      return folders.map((folder) => ({
+        path: folder.path,
+        displayName: readManifestName(folder.absolutePath) || friendlyName(folder.name || path8.basename(folder.path))
+      }));
+    }
+    return [{
+      path: candidate.path,
+      displayName: readManifestName(candidate.absolutePath) || friendlyName(path8.basename(candidate.absolutePath) || candidate.path)
+    }];
+  });
+  if (agents.length === 1) return agents[0];
+  term.clear();
+  drawHeader({ env, platform });
+  term("\n");
+  term.bold("  Which agent do you want to run now?\n\n");
+  const items = [...agents.map((agent) => `${agent.displayName.padEnd(32)}  ${agent.path}`), "\u2190 Back"];
+  const resp = await term.singleColumnMenu(items, {
+    cancelable: true,
+    style: term.gray,
+    selectedStyle: term.bgCyan.black.bold,
+    leftPadding: "    ",
+    selectedLeftPadding: "  \u203A "
+  }).promise;
+  if (resp.canceled || resp.selectedIndex === items.length - 1) return null;
+  return agents[resp.selectedIndex];
+}
+async function chooseCloudWorkspace({
+  env,
+  platform,
+  loadingTitle,
+  pickerTitle
+} = {}) {
+  term.clear();
+  drawHeader({ env, platform });
+  term("\n");
+  term.bold(`${loadingTitle}
+
+`);
+  let wsResult;
+  try {
+    wsResult = await listCloudWorkspaces({
+      env,
+      platform,
+      onProgress: (msg) => {
+        term.moveTo(1, HEADER_ROWS_BASE + 3);
+        term.eraseLine();
+        term.gray(`  ${clip(msg, 60)}
+`);
+      }
+    });
+  } catch (error) {
+    term.red(`
+  Couldn't connect to the server: ${errMsg(error)}
+`);
+    term.gray("  Make sure you are signed in (choose Sign in from the main menu).\n");
+    await pressEnterToContinue({ grabActive: false });
+    return null;
+  }
+  if (!wsResult.ok) {
+    term.red(`
+  ${fig.cross} ${wsResult.error}
+`);
+    await pressEnterToContinue({ grabActive: false });
+    return null;
+  }
+  if (wsResult.workspaces.length <= 1) {
+    const workspace2 = wsResult.workspaces[0];
+    return workspace2 ? { id: workspace2.id || "", label: workspaceLabel(workspace2) } : null;
+  }
+  term.clear();
+  drawHeader({ env, platform });
+  term("\n");
+  term.bold(pickerTitle);
+  const wsItems = [...wsResult.workspaces.map((w) => workspaceLabel(w)), "\u2190 Back"];
+  const wsResp = await term.singleColumnMenu(wsItems, {
+    cancelable: true,
+    style: term.gray,
+    selectedStyle: term.bgCyan.black.bold,
+    leftPadding: "    ",
+    selectedLeftPadding: "  \u203A "
+  }).promise;
+  if (wsResp.canceled || wsResp.selectedIndex === wsItems.length - 1) return null;
+  const workspace = wsResult.workspaces[wsResp.selectedIndex];
+  return { id: workspace?.id || "", label: workspaceLabel(workspace) };
+}
 async function runServeDashboard({ env, platform, agentsDir, collectionId }) {
   let state = initialServeState();
   let child = null;
@@ -2814,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) => {
@@ -2841,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.
@@ -2860,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);
@@ -2916,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);
@@ -2957,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);
@@ -2983,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");
@@ -3039,9 +3248,11 @@ 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];
+      const ag = agents[clampedIdx];
       showAgentLog({ agent: ag, state, env, platform }).then(() => {
         if (dashboardClosed) return;
         overlayActive = false;
@@ -3056,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);
     }
@@ -3083,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;
@@ -3350,7 +3630,7 @@ function attachServeChild(child, onUpdate, onExit, logStore = null) {
 }
 async function withOutputMode(label, fn) {
   term.fullscreen(false);
-  term.showCursor();
+  setCursorVisible(true);
   term.grabInput(false);
   process.stdout.write(`
   ${label}
@@ -3366,7 +3646,7 @@ async function withOutputMode(label, fn) {
   }
   await pressEnterToContinue({ grabActive: false });
   term.fullscreen(true);
-  term.hideCursor();
+  setCursorVisible(false);
   term.grabInput({ mouse: "motion" });
 }
 function waitForKey(keys = null) {
@@ -3380,6 +3660,19 @@ function waitForKey(keys = null) {
     term.on("key", handler);
   });
 }
+function setCursorVisible(visible) {
+  if (typeof term?.hideCursor === "function") {
+    term.hideCursor(!visible);
+    return;
+  }
+  if (visible && typeof term?.showCursor === "function") {
+    term.showCursor();
+    return;
+  }
+  if (!visible && typeof term?.hideCursor === "function") {
+    term.hideCursor();
+  }
+}
 async function pressEnterToContinue({ grabActive = true } = {}) {
   if (grabActive) {
     term("\n  Press any key to continue\u2026");
@@ -3499,6 +3792,23 @@ function endpointErrorStatus(error) {
   const message = error && typeof error.message === "string" ? error.message : String(error || "Connection failed");
   return `${fig.cross} ${message}`;
 }
+function buildLocalRunArgs({
+  agentPath = ".",
+  collectionId = "",
+  inputJson = "{}"
+} = {}) {
+  return [
+    "cloud",
+    "local",
+    "run",
+    "--collection-id",
+    collectionId,
+    "--path",
+    agentPath || ".",
+    "--input-json",
+    inputJson || "{}"
+  ];
+}
 function runtimeSummary({ env = process.env, platform = process.platform, now = Date.now() } = {}) {
   const config = loadConfig(env, platform);
   const venvPath = managedVenvPath(env, platform);

package/package.json

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