nolo-cli 0.1.14 → 0.1.15

package/agentRunCommand.ts

@@ -0,0 +1,104 @@
+import { DEFAULT_NOLO_SERVER_URL } from "./defaultServer";
+import { runAgentTurn, type RunAgentTurnResult } from "./client/agentRun";
+import type { AgentRuntimeRequestedMode } from "./agentRuntimeLocal";
+
+type EnvLike = Record<string, string | undefined>;
+
+type OutputLike = {
+  write(chunk: string): unknown;
+};
+
+type AgentRunCommandDeps = {
+  env?: EnvLike;
+  scriptDir: string;
+  output?: OutputLike;
+  runner?: typeof runAgentTurn;
+};
+
+type ParsedAgentRunArgs = {
+  agentKey: string;
+  message: string;
+  runtimeMode?: AgentRuntimeRequestedMode;
+  continueDialogId?: string;
+};
+
+function readFlagValue(args: string[], flag: string) {
+  const index = args.indexOf(flag);
+  if (index < 0) return undefined;
+  return args[index + 1];
+}
+
+function runtimeModeFromArgs(args: string[]): AgentRuntimeRequestedMode | undefined {
+  if (args.includes("--local")) return "local";
+  if (args.includes("--server")) return "server";
+  if (args.includes("--auto")) return "auto";
+  return undefined;
+}
+
+function positionalArgs(args: string[]) {
+  const values: string[] = [];
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--local" || arg === "--server" || arg === "--auto") continue;
+    if (arg.startsWith("--")) {
+      index += 1;
+      continue;
+    }
+    values.push(arg);
+  }
+  return values;
+}
+
+export function parseAgentRunArgs(args: string[]): ParsedAgentRunArgs | null {
+  const agentKey = readFlagValue(args, "--agent") ?? positionalArgs(args)[0];
+  const explicitMsg = readFlagValue(args, "--msg");
+  const message = explicitMsg ?? positionalArgs(args).slice(1).join(" ");
+  if (!agentKey || !message.trim()) return null;
+  const runtimeMode = runtimeModeFromArgs(args);
+  const continueDialogId = readFlagValue(args, "--continue") ?? readFlagValue(args, "--dialog");
+  return {
+    agentKey,
+    message: message.trim(),
+    ...(runtimeMode ? { runtimeMode } : {}),
+    ...(continueDialogId ? { continueDialogId } : {}),
+  };
+}
+
+function resolveServerUrl(env: EnvLike) {
+  return (env.NOLO_SERVER || env.BASE_URL || DEFAULT_NOLO_SERVER_URL).replace(/\/+$/, "");
+}
+
+function writeUsage(output: OutputLike) {
+  output.write(
+    "Usage: nolo agent run <agent> <message> [--local|--server|--auto] [--continue <dialogId>]\n" +
+      "       nolo agent run --agent <agent> --msg <message> [--local|--server|--auto]\n"
+  );
+}
+
+export async function runAgentRunCommand(args: string[], deps: AgentRunCommandDeps) {
+  const env = deps.env ?? process.env;
+  const output = deps.output ?? process.stdout;
+  const parsed = parseAgentRunArgs(args);
+  if (!parsed) {
+    writeUsage(output);
+    return 1;
+  }
+
+  const runner = deps.runner ?? runAgentTurn;
+  const result: RunAgentTurnResult = await runner({
+    agentName: parsed.agentKey,
+    agentKey: parsed.agentKey,
+    serverUrl: resolveServerUrl(env),
+    message: parsed.message,
+    scriptDir: deps.scriptDir,
+    env,
+    output,
+    ...(parsed.runtimeMode ? { runtimeMode: parsed.runtimeMode } : {}),
+    ...(parsed.continueDialogId ? { continueDialogId: parsed.continueDialogId } : {}),
+  });
+
+  if (result.dialogId) {
+    output.write(`\n[nolo] dialog ${result.dialogId}\n`);
+  }
+  return result.exitCode;
+}

package/commandRegistry.ts

@@ -29,6 +29,7 @@ export const COMMANDS: CommandEntry[] = [
 
   { path: ["agent", "list"], script: "listMyAgents.ts", description: "List owned agents" },
   { path: ["agent", "read"], script: "readAgent.ts", description: "Read a single agent" },
+  { path: ["agent", "run"], script: "", description: "Run an agent" },
   { path: ["agent", "update"], script: "updateAgent.ts", description: "Update agent fields" },
   { path: ["agent", "bind-current"], script: "", description: "Bind an agent to this machine" },
   { path: ["agent", "smoke-current"], script: "", description: "Smoke test a bound agent through this machine" },
@@ -94,6 +95,7 @@ export function renderHelpText() {
     '  nolo skill-doc create --title "Agent Query Skill" --description "Inspect recent agent dialogs" --sync local,main,us',
     "  nolo agent list --json",
     "  nolo agent read agent-pub-01APPBUILDER00000001YAII3I",
+    '  nolo agent run frontend-implementer --msg "polish notifications" --local',
     "  nolo agent bind-current agent-user-1-agent-1",
     "  nolo agent runtime-doctor agent-user-1-agent-1",
     '  nolo agent smoke-current agent-user-1-agent-1 --msg "ping"',

package/index.ts

@@ -11,6 +11,7 @@ import {
   runAgentSmokeCurrentCommand,
   runDoctorRuntimeCommand,
 } from "./agentRuntimeCommands";
+import { runAgentRunCommand } from "./agentRunCommand";
 import { buildEnvFromProfile, loadProfileConfig } from "./client/profileConfig";
 import { resolveTuiLaunchMode } from "./runtimeModeArgs";
 import {
@@ -118,10 +119,17 @@ if (args[0] === "agent" && args[1] === "bind-current") {
   process.exit(await runAgentBindCurrentCommand(args.slice(2), { env: runtimeEnv }));
 }
 
-if (args[0] === "agent" && args[1] === "smoke-current") {
-  process.exit(await runAgentSmokeCurrentCommand(args.slice(2), { env: runtimeEnv }));
-}
-
+if (args[0] === "agent" && args[1] === "smoke-current") {
+  process.exit(await runAgentSmokeCurrentCommand(args.slice(2), { env: runtimeEnv }));
+}
+
+if (args[0] === "agent" && args[1] === "run") {
+  process.exit(await runAgentRunCommand(args.slice(2), {
+    env: runtimeEnv,
+    scriptDir: SCRIPT_DIR,
+  }));
+}
+
 if (args[0] === "agent" && args[1] === "runtime-doctor") {
   process.exit(await runAgentRuntimeDoctorCommand(args.slice(2), { env: runtimeEnv }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nolo-cli",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "type": "module",
   "description": "Agent-first terminal workspace for Nolo",
   "bin": {
@@ -12,6 +12,7 @@
     "agentRuntimeLocal.ts",
     "localRuntimeDb.ts",
     "agentRuntimeCommands.ts",
+    "agentRunCommand.ts",
     "authCommands.ts",
     "commandRegistry.ts",
     "connectorWebSocketTarget.ts",