@vendian/cli 0.0.26 → 0.0.28

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.26" : process.env.npm_package_version || "0.0.0-dev";
+var CLI_VERSION = true ? "0.0.28" : process.env.npm_package_version || "0.0.0-dev";
 
 // src/npm-update.js
 var NPM_CHECK_INTERVAL_MS = 30 * 60 * 1e3;
@@ -2412,12 +2412,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 +2451,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 +2535,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 }) {
@@ -2588,17 +2592,10 @@ async function showConnect({ env, platform }) {
     }
     const ep = ENDPOINTS[resp.selectedIndex];
     term("\n");
-    term.gray(`  Connecting to ${ep.label}\u2026
-`);
-    try {
-      await switchOrLoginEndpoint({ backend: ep.key, env, platform });
-      term.green(`  ${fig.check} Signed in to ${ep.label} successfully
-`);
-    } catch (error) {
-      term.red(`  ${endpointErrorStatus(error)}
-`);
+    const outcome = await connectEndpointInteractive({ backend: ep.key, label: ep.label, env, platform });
+    if (outcome.promptedInTui) {
+      await pressEnterToContinue();
     }
-    await pressEnterToContinue({ grabActive: false });
   }
 }
 async function connectCustomUrl({ env, platform }) {
@@ -2611,15 +2608,10 @@ async function connectCustomUrl({ env, platform }) {
   if (!url) return;
   term("\n\n");
   term.gray("  Connecting\u2026\n");
-  try {
-    await switchOrLoginEndpoint({ apiUrl: url, env, platform });
-    term.green(`  ${fig.check} Connected successfully
-`);
-  } catch (error) {
-    term.red(`  ${endpointErrorStatus(error)}
-`);
+  const outcome = await connectEndpointInteractive({ apiUrl: url, label: url, env, platform, successLabel: "Connected successfully" });
+  if (outcome.promptedInTui) {
+    await pressEnterToContinue();
   }
-  await pressEnterToContinue({ grabActive: false });
 }
 async function showCreate({ env, platform }) {
   term.clear();
@@ -2640,6 +2632,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" },
@@ -2652,6 +2679,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" }
   ] },
@@ -2692,57 +2720,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) {
@@ -2816,6 +2801,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;
@@ -3362,7 +3448,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}
@@ -3378,7 +3464,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) {
@@ -3392,6 +3478,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");
@@ -3477,10 +3576,57 @@ async function switchOrLoginEndpoint({
   await setupFn({ backend, apiUrl, forceAuth: true, env, platform });
   return { apiUrl: status.apiUrl, reused: false, activated: true };
 }
+async function connectEndpointInteractive({
+  backend,
+  apiUrl,
+  label,
+  env = process.env,
+  platform = process.platform,
+  setupFn = setup,
+  activateFn = activateCloudProfile,
+  successLabel
+} = {}) {
+  const status = cloudAuthStatus({ backend, apiUrl, env, platform });
+  const destination = label || envLabel(status.apiUrl);
+  if (status.authenticated) {
+    term.gray(`  Connecting to ${destination}\u2026
+`);
+    try {
+      await switchOrLoginEndpoint({ backend, apiUrl, env, platform, setupFn, activateFn });
+      term.green(`  ${fig.check} ${successLabel || `Signed in to ${destination} successfully`}
+`);
+    } catch (error) {
+      term.red(`  ${endpointErrorStatus(error)}
+`);
+    }
+    return { promptedInTui: true };
+  }
+  await withOutputMode(`Connecting to ${destination}`, async () => {
+    await switchOrLoginEndpoint({ backend, apiUrl, env, platform, setupFn, activateFn });
+  });
+  return { promptedInTui: false };
+}
 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.26",
+  "version": "0.0.28",
   "description": "Public Vendian CLI bootstrapper and launcher",
   "license": "UNLICENSED",
   "private": false,