nolo-cli 0.1.45 → 0.1.47

package/client/agentRun.ts

@@ -1,735 +0,0 @@
-import { runLocalAgentTurn } from "../agentRuntimeLocal";
-import { LOCAL_AGENT_CONFIG_MISSING_CODE } from "../agent-runtime/localLoop";
-import type { LocalAgentToolEvent } from "../agent-runtime/localLoop";
-import type { AgentRuntimeHostAdapter, AgentRuntimeRequestedMode } from "../agentRuntimeLocal";
-import { createCliLocalRuntimeAdapter, isBuiltinNoloAgentRef } from "./localRuntimeAdapter";
-import { createStreamingTextWriter } from "./streamingOutput";
-
-type EnvLike = Record<string, string | undefined>;
-
-type OutputLike = {
-  write(chunk: string): unknown;
-};
-type AgentRunSubjectRef = {
-  kind: string;
-  id: string;
-  role?: string;
-};
-
-type TaskContextReviewStatus = "passed" | "needs_changes" | "blocked";
-
-export type TaskRowContext = {
-  rowDbKey: string;
-  artifactIds?: string[];
-};
-
-type RunAgentTurnOptions = {
-  agentName: string;
-  agentKey: string;
-  serverUrl: string;
-  message: string;
-  imageUrls?: string[];
-  continueDialogId?: string;
-  spaceId?: string;
-  category?: string;
-  inheritedFromDialogKey?: string;
-  parentDialogId?: string;
-  subjectDialogKey?: string;
-  subjectRefs?: AgentRunSubjectRef[];
-  background?: boolean;
-  noStream?: boolean;
-  scriptDir: string;
-  env: EnvLike;
-  output: OutputLike;
-  runtimeMode?: AgentRuntimeRequestedMode;
-  localRuntimeAdapter?: AgentRuntimeHostAdapter;
-  localRuntimeAdapterFactory?: (env: EnvLike, options?: { cwd?: string }) => AgentRuntimeHostAdapter;
-  localRuntimeCwd?: string;
-  timeoutMs?: number;
-  traceTools?: boolean;
-  eventsMode?: "jsonl";
-  taskRowContext?: TaskRowContext;
-  fetchImpl?: typeof fetch;
-};
-
-export type RunAgentTurnResult = {
-  exitCode: number;
-  dialogId?: string;
-  streamInterrupted?: boolean;
-};
-
-class Spinner {
-  private timer: any = null;
-  private frameIndex = 0;
-  private frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-  private isTTY: boolean;
-
-  constructor(
-    private output: OutputLike,
-    private text: string
-  ) {
-    this.isTTY = Boolean((output as any).isTTY ?? process.stdout.isTTY);
-  }
-
-  start() {
-    if (!this.isTTY) {
-      this.output.write(`\n${this.text}...\n`);
-      return;
-    }
-
-    this.frameIndex = 0;
-    this.output.write(`\x1b[36m${this.frames[0]}\x1b[39m ${this.text}...`);
-
-    this.timer = setInterval(() => {
-      this.frameIndex = (this.frameIndex + 1) % this.frames.length;
-      this.output.write(`\r\x1b[36m${this.frames[this.frameIndex]}\x1b[39m ${this.text}...`);
-    }, 80);
-  }
-
-  stop() {
-    if (this.timer) {
-      clearInterval(this.timer);
-      this.timer = null;
-    }
-
-    if (this.isTTY) {
-      this.output.write("\r\x1b[K");
-    }
-  }
-}
-
-
-const SERVER_PLATFORM_TOOL_NAMES = new Set([
-  "addTableRow",
-  "addTableRows",
-  "deleteTableRow",
-  "deleteTableRows",
-  "queryTableRows",
-  "streamParallelAgents",
-  "updateTableRow",
-  "updateTableRows",
-]);
-
-export function findServerPlatformTools(toolNames?: string[]) {
-  if (!Array.isArray(toolNames)) return [];
-  return toolNames.filter((toolName) => SERVER_PLATFORM_TOOL_NAMES.has(toolName));
-}
-
-function resolveServerPlatformToolNames(agentConfig: any) {
-  return findServerPlatformTools([
-    ...(Array.isArray(agentConfig?.toolNames) ? agentConfig.toolNames : []),
-    ...(Array.isArray(agentConfig?.runtimeToolPolicy?.agentTools)
-      ? agentConfig.runtimeToolPolicy.agentTools
-      : []),
-  ]);
-}
-
-function isMachineBoundLocalhostCustomProvider(agentConfig: any) {
-  const machineId =
-    agentConfig?.runtimeBinding && typeof agentConfig.runtimeBinding === "object"
-      ? String(agentConfig.runtimeBinding.machineId ?? "").trim()
-      : "";
-  const providerUrl = typeof agentConfig?.customProviderUrl === "string"
-    ? agentConfig.customProviderUrl.trim()
-    : "";
-  if (!machineId || !providerUrl) return false;
-  try {
-    const hostname = new URL(providerUrl).hostname.toLowerCase();
-    return hostname === "127.0.0.1" || hostname === "localhost" || hostname === "::1";
-  } catch {
-    return false;
-  }
-}
-
-function isCliProviderAgentConfig(agentConfig: any) {
-  const cliProvider = typeof agentConfig?.cliProvider === "string"
-    ? agentConfig.cliProvider.trim()
-    : "";
-  const provider = typeof agentConfig?.provider === "string"
-    ? agentConfig.provider.trim()
-    : "";
-  return Boolean(cliProvider) || provider === "agy" || provider === "codex" || provider === "claude";
-}
-
-function resolveAuthToken(env: EnvLike) {
-  return env.AUTH_TOKEN || env.AUTH || env.BENCHMARK_AUTH_TOKEN || "";
-}
-
-function shouldShowUsage(env: EnvLike) {
-  return env.NOLO_DEBUG === "1" || env.NOLO_SHOW_USAGE === "1";
-}
-
-function resolveRequestedRuntimeMode(options: RunAgentTurnOptions) {
-  const envMode = options.env.NOLO_RUNTIME_MODE;
-  if (options.runtimeMode) return options.runtimeMode;
-  if (envMode === "local" || envMode === "server" || envMode === "auto") return envMode;
-  return "auto";
-}
-
-function buildDefaultLocalRuntimeAdapter(options: RunAgentTurnOptions) {
-  return createCliLocalRuntimeAdapter({
-    env: options.env,
-    fetchImpl: options.fetchImpl,
-    cwd: options.localRuntimeCwd,
-    output: options.output,
-  });
-}
-
-function resolveLocalRuntimeAdapter(options: RunAgentTurnOptions) {
-  return (
-    options.localRuntimeAdapter ||
-    options.localRuntimeAdapterFactory?.(options.env, { cwd: options.localRuntimeCwd }) ||
-    buildDefaultLocalRuntimeAdapter(options)
-  );
-}
-
-async function shouldSkipAutoLocalForServerPlatformTools(options: RunAgentTurnOptions) {
-  if (isBuiltinNoloAgentRef(options.agentKey)) return false;
-  if (options.localRuntimeCwd) {
-    return false;
-  }
-  const adapter = resolveLocalRuntimeAdapter(options);
-  if (!adapter) return false;
-  let agentConfig;
-  try {
-    agentConfig = await adapter.loadAgentConfig(options.agentKey);
-  } catch {
-    return false;
-  }
-  if (isCliProviderAgentConfig(agentConfig)) return false;
-  if (isMachineBoundLocalhostCustomProvider(agentConfig)) {
-    options.output.write(
-      `[nolo] auto runtime: skipping local runtime because ${options.agentKey} is a machine-bound localhost custom provider. ` +
-        "Use --local explicitly to force the current machine.\n"
-    );
-    return true;
-  }
-  const serverTools = resolveServerPlatformToolNames(agentConfig);
-  if (serverTools.length === 0) return false;
-  options.output.write(
-    `[nolo] auto runtime: skipping local runtime because ${options.agentKey} declares server platform tools ` +
-      `(${serverTools.join(", ")}). Use --local explicitly to force local workspace tools.\n`
-  );
-  return true;
-}
-
-function buildUserInputContent(message: string, imageUrls: string[] = []) {
-  if (imageUrls.length === 0) return message;
-  return [
-    ...(message.trim() ? [{ type: "text" as const, text: message }] : []),
-    ...imageUrls.map((url) => ({
-      type: "image_url" as const,
-      image_url: { url },
-    })),
-  ];
-}
-
-function buildSubjectRefs(options: RunAgentTurnOptions) {
-  const refs: AgentRunSubjectRef[] = [];
-  const seen = new Set<string>();
-  const pushRef = (ref: AgentRunSubjectRef) => {
-    const kind = ref.kind.trim();
-    const id = ref.id.trim();
-    const role = ref.role?.trim();
-    if (!kind || !id) return;
-    const key = `${kind}\u0000${id}\u0000${role ?? ""}`;
-    if (seen.has(key)) return;
-    seen.add(key);
-    refs.push({ kind, id, ...(role ? { role } : {}) });
-  };
-  for (const ref of options.subjectRefs ?? []) pushRef(ref);
-  if (options.subjectDialogKey) {
-    pushRef({
-      kind: "dialog",
-      id: options.subjectDialogKey,
-      role: "subject",
-    });
-  }
-  if (options.taskRowContext?.rowDbKey) {
-    pushRef({
-      kind: "table-row",
-      id: options.taskRowContext.rowDbKey,
-      role: "task",
-    });
-  }
-  return refs.length ? refs : undefined;
-}
-
-function shouldTraceLocalTools(options: RunAgentTurnOptions) {
-  const setting = (options.env.NOLO_TRACE_TOOLS ?? "").trim().toLowerCase();
-  if (setting === "0" || setting === "false" || setting === "off") return false;
-  return true;
-}
-
-function resolveAgentEventMode(options: RunAgentTurnOptions): "text" | "jsonl" {
-  if (options.eventsMode === "jsonl") return "jsonl";
-  return options.env.NOLO_AGENT_EVENTS === "jsonl" ? "jsonl" : "text";
-}
-
-function isMissingLocalAgentConfigError(error: unknown, agentRef: string) {
-  return Boolean(
-    error &&
-      typeof error === "object" &&
-      "code" in error &&
-      (error as { code?: string; agentRef?: string }).code === LOCAL_AGENT_CONFIG_MISSING_CODE &&
-      (error as { code?: string; agentRef?: string }).agentRef === agentRef
-  );
-}
-
-function formatToolTraceEvent(event: LocalAgentToolEvent) {
-  const round = event.round + 1;
-  const detail = event.argumentsPreview ? ` ${event.argumentsPreview}` : "";
-  if (event.type === "tool-call") {
-    return `[nolo:tool] #${round} -> ${event.toolName}${detail}\n`;
-  }
-  if (event.type === "tool-error") {
-    const elapsed = typeof event.elapsedMs === "number" ? ` ${event.elapsedMs}ms` : "";
-    return `[nolo:tool] #${round} !! ${event.toolName}${elapsed}: ${event.message ?? "failed"}\n`;
-  }
-  const elapsed = typeof event.elapsedMs === "number" ? ` ${event.elapsedMs}ms` : "";
-  const summary = event.summary ? ` ${event.summary}` : "";
-  return `[nolo:tool] #${round} <- ${event.toolName}${elapsed}${summary}\n`;
-}
-
-function formatToolJsonEvent(event: LocalAgentToolEvent) {
-  return `${JSON.stringify({
-    schemaVersion: 1,
-    type: event.type,
-    round: event.round + 1,
-    tool: event.toolName,
-    toolCallId: event.toolCallId,
-    ...(event.argumentsPreview ? { argsPreview: event.argumentsPreview } : {}),
-    ...(typeof event.elapsedMs === "number" ? { elapsedMs: event.elapsedMs } : {}),
-    ...(event.summary ? { summary: event.summary } : {}),
-    ...(event.message ? { message: event.message } : {}),
-    ...(event.metadata ? { metadata: event.metadata } : {}),
-  })}\n`;
-}
-
-function shouldAttemptAutoLocal(options: RunAgentTurnOptions) {
-  if (options.localRuntimeAdapter || options.localRuntimeAdapterFactory) return true;
-  if (
-    options.env.NOLO_DISABLE_CLI_WORKSPACE_TOOLS !== "1" &&
-    isBuiltinNoloAgentRef(options.agentKey) &&
-    resolveAuthToken(options.env)
-  ) {
-    return true;
-  }
-  return Boolean(
-    options.env.NOLO_LOCAL_OPENAI_API_KEY ||
-      options.env.OPENAI_API_KEY ||
-      options.env.NOLO_LOCAL_OPENAI_BASE_URL ||
-      options.env.OPENAI_BASE_URL ||
-      options.env.NOLO_LOCAL_AGENT_KEY
-  );
-}
-
-export function classifyTaskContextReviewStatus(summary?: string): TaskContextReviewStatus | undefined {
-  const normalized = summary?.toLowerCase().trim();
-  if (!normalized) return undefined;
-
-  const explicit = normalized.match(/review\s+decision\s*:\s*(passed|needs_changes|blocked)/);
-  if (explicit?.[1]) return explicit[1] as TaskContextReviewStatus;
-
-  if (/\b(blocked|cannot review|unable to review)\b|无法审查|阻塞/.test(normalized)) {
-    return "blocked";
-  }
-  if (
-    /\b(needs changes|request changes|changes requested|not approved)\b|需要修改|需修改|发现问题/.test(
-      normalized
-    )
-  ) {
-    return "needs_changes";
-  }
-  if (/\b(approved|lgtm|no issues|passed)\b|通过|无问题/.test(normalized)) {
-    return "passed";
-  }
-  return undefined;
-}
-
-
-function formatUsage(usage: any, dialogId: unknown) {
-  const parts: string[] = [];
-  if (typeof dialogId === "string" && dialogId) parts.push(`dialog=${dialogId}`);
-
-  const input = usage?.input_tokens ?? usage?.prompt_tokens ?? 0;
-  const output = usage?.output_tokens ?? usage?.completion_tokens ?? 0;
-  if (input || output) parts.push(`tokens=${input}+${output}`);
-
-  return parts.length ? `  (${parts.join("  ")})` : "";
-}
-
-function buildTransportErrorHint(serverUrl: string, error: unknown) {
-  const endpoint = `${serverUrl}/api/agent/run`;
-  const reason = error instanceof Error ? error.message : String(error);
-
-  let detail =
-    `[nolo] Could not reach ${endpoint}.\n` +
-    `Reason: ${reason}\n`;
-
-  try {
-    const parsed = new URL(serverUrl);
-    if (parsed.hostname === "127.0.0.1" || parsed.hostname === "localhost") {
-      detail +=
-        "If you meant local dev, start the local API first.\n" +
-        "Otherwise set NOLO_SERVER to a reachable server, or re-run `nolo login --server https://nolo.chat`.\n";
-      return detail;
-    }
-  } catch {
-    // Keep the generic hint below when serverUrl is not a valid absolute URL.
-  }
-
-  detail +=
-    "Check NOLO_SERVER / BASE_URL and make sure the configured server is reachable.\n";
-  return detail;
-}
-
-async function runHttpAgentTurn(options: RunAgentTurnOptions, authToken: string) {
-  const spinner = new Spinner(options.output, `${options.agentName} -> working`);
-  spinner.start();
-
-  const fetchImpl = options.fetchImpl ?? fetch;
-  const subjectRefs = buildSubjectRefs(options);
-  let res: Response;
-  try {
-    res = await fetchImpl(`${options.serverUrl}/api/agent/run`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${authToken}`,
-        "Content-Type": "application/json",
-      },
-      body: JSON.stringify({
-        agentKey: options.agentKey,
-        userInput: buildUserInputContent(
-          options.message,
-          options.imageUrls
-        ),
-        runtimeContext: {
-          surface: "cli",
-          host: "terminal",
-          runtime: "bun",
-          entrypoint: "nolo-cli",
-          capabilities: ["text-io", "streaming", "slash-commands"],
-          ...(subjectRefs ? { subjectRefs } : {}),
-        },
-        ...(options.continueDialogId
-          ? { continueDialogId: options.continueDialogId }
-          : {}),
-        ...(options.spaceId ? { spaceId: options.spaceId } : {}),
-        ...(options.category ? { category: options.category } : {}),
-        ...(options.inheritedFromDialogKey
-          ? { inheritedFromDialogKey: options.inheritedFromDialogKey }
-          : {}),
-        ...(options.parentDialogId ? { parentDialogId: options.parentDialogId } : {}),
-        ...(options.background ? { background: true } : {}),
-        ...(typeof options.timeoutMs === "number" ? { timeoutMs: options.timeoutMs } : {}),
-        stream: !options.noStream && !options.background,
-      }),
-    });
-  } catch (error) {
-    spinner.stop();
-    options.output.write(buildTransportErrorHint(options.serverUrl, error));
-    return { exitCode: 1 };
-  }
-
-  const contentType = res.headers.get("content-type") || "";
-  if (contentType.includes("text/event-stream") && res.body) {
-    spinner.stop();
-    const result = await readStreamingAgentRun(options, res);
-    return result;
-  }
-
-  spinner.stop();
-  let data: any = {};
-  try {
-    data = await res.json();
-  } catch {
-    data = {};
-  }
-
-  if (!res.ok) {
-    options.output.write(`[nolo] Agent request failed: HTTP ${res.status}\n`);
-    const errorText = typeof data?.error === "string" ? data.error.trim() : "";
-    const messageText = typeof data?.message === "string" ? data.message.trim() : "";
-    const reasonText = typeof data?.reason === "string" ? data.reason.trim() : "";
-    const codeText = typeof data?.code === "string" ? data.code.trim() : "";
-    const dialogIdText = typeof data?.dialogId === "string" ? data.dialogId.trim() : "";
-    if (errorText || messageText) {
-      options.output.write(`${errorText || messageText}\n`);
-      if (messageText && messageText !== errorText) {
-        options.output.write(`${messageText}\n`);
-      }
-      if (codeText && codeText !== errorText && codeText !== messageText) {
-        options.output.write(`code=${codeText}\n`);
-      }
-      if (reasonText && reasonText !== errorText && reasonText !== messageText) {
-        options.output.write(`reason=${reasonText}\n`);
-      }
-    }
-    if (dialogIdText) {
-      options.output.write(`[nolo] failed dialog: ${dialogIdText}\n`);
-      options.output.write(
-        `[nolo] continue with: nolo agent run ${options.agentKey} --continue ${dialogIdText} --msg "retry"\n`
-      );
-    }
-    return dialogIdText ? { exitCode: 1, dialogId: dialogIdText } : { exitCode: 1 };
-  }
-
-  const content = String(data?.content ?? data?.message ?? "").trim();
-  if (content) {
-    options.output.write(`\n${options.agentName} > ${content}\n`);
-  } else {
-    options.output.write(`\n${options.agentName} > (no text response)\n`);
-  }
-
-  const usage = formatUsage(data?.usage, data?.dialogId);
-  if (usage && shouldShowUsage(options.env)) options.output.write(`${usage}\n`);
-  const result = {
-    exitCode: 0,
-    ...(typeof data?.dialogId === "string" && data.dialogId
-      ? { dialogId: data.dialogId }
-      : {}),
-  };
-  return result;
-}
-
-async function runInjectedLocalAgentTurn(options: RunAgentTurnOptions) {
-  return runLocalAgentTurnForCli(options, { reportFailure: true });
-}
-
-async function refreshMissingLocalAgentConfig(options: RunAgentTurnOptions) {
-  const adapter = resolveLocalRuntimeAdapter(options);
-  if (!adapter) return false;
-  const agentConfig = await adapter.loadAgentConfig(options.agentKey);
-  return Boolean(agentConfig);
-}
-
-async function runLocalAgentTurnForCli(
-  options: RunAgentTurnOptions,
-  settings: { reportFailure: boolean }
-) {
-  const adapter = resolveLocalRuntimeAdapter(options);
-  if (!adapter) {
-    options.output.write("[nolo] Local runtime was requested but no local runtime adapter is available.\n");
-    return { exitCode: 1 };
-  }
-
-  const spinner = new Spinner(options.output, `${options.agentName} -> working locally`);
-  spinner.start();
-  try {
-    const traceLocalTools = shouldTraceLocalTools(options);
-    const eventMode = resolveAgentEventMode(options);
-    const result = await runLocalAgentTurn({
-      adapter,
-      agentRef: options.agentKey,
-      input: buildUserInputContent(
-        options.message,
-        options.imageUrls
-      ),
-      continueDialogId: options.continueDialogId,
-      spaceId: options.spaceId,
-      category: options.category,
-      inheritedFromDialogKey: options.inheritedFromDialogKey,
-      parentDialogId: options.parentDialogId,
-      background: options.background,
-      noStream: options.noStream,
-      ...(typeof options.timeoutMs === "number" ? { timeoutMs: options.timeoutMs } : {}),
-      ...(traceLocalTools
-        ? {
-            onToolEvent: (event) => {
-              if (traceLocalTools) {
-                spinner.stop();
-                options.output.write(
-                  eventMode === "jsonl"
-                    ? formatToolJsonEvent(event)
-                    : formatToolTraceEvent(event)
-                );
-              }
-            },
-          }
-        : {}),
-    });
-    spinner.stop();
-    const content = result.content.trim();
-    if (content) {
-      options.output.write(`\n${options.agentName} > ${content}\n`);
-    } else {
-      options.output.write(`\n${options.agentName} > (no text response)\n`);
-    }
-    return { exitCode: 0, dialogId: result.dialogId };
-  } catch (error) {
-    spinner.stop();
-    if (settings.reportFailure) {
-      options.output.write(
-        `[nolo] Local agent run failed: ${
-          error instanceof Error ? error.message : String(error)
-        }\n`
-      );
-    }
-    return { exitCode: 1, localError: error };
-  }
-}
-
-async function readStreamingAgentRun(
-  options: RunAgentTurnOptions,
-  res: Response,
-): Promise<RunAgentTurnResult> {
-  const reader = res.body?.getReader();
-  if (!reader) {
-    options.output.write("[nolo] Agent stream response did not include a readable body.\n");
-    return { exitCode: 1 };
-  }
-
-  const decoder = new TextDecoder();
-  const writer = createStreamingTextWriter({
-    write: (chunk) => options.output.write(chunk),
-  });
-  let buffer = "";
-  let content = "";
-  let dialogId: string | undefined;
-  let usage: any;
-  let hasPrintedLabel = false;
-
-  const printLabel = () => {
-    if (hasPrintedLabel) return;
-    options.output.write(`\n${options.agentName} > `);
-    hasPrintedLabel = true;
-  };
-
-  const handlePayload = (payload: any) => {
-    if (typeof payload?.dialogId === "string" && payload.dialogId.trim()) {
-      dialogId = payload.dialogId;
-    }
-    if (payload?.error || payload?.type === "error") {
-      throw new Error(String(payload.error || payload.message || "Agent stream failed"));
-    }
-    if (payload?.type === "done") {
-      usage = payload.usage;
-      return;
-    }
-    if (payload?.type === "dialog" || payload?.type === "status") {
-      return;
-    }
-
-    const chunk =
-      payload?.type === "text"
-        ? payload.content
-        : typeof payload?.chunk === "string"
-          ? payload.chunk
-          : "";
-    if (!chunk) return;
-
-    printLabel();
-    content += chunk;
-    writer.push(chunk);
-  };
-
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-
-      buffer += decoder.decode(value, { stream: true });
-      const events = buffer.split("\n\n");
-      buffer = events.pop() ?? "";
-
-      for (const event of events) {
-        const dataLines = event
-          .split("\n")
-          .filter((line) => line.startsWith("data:"))
-          .map((line) => line.slice(5).trim())
-          .filter(Boolean);
-        for (const raw of dataLines) {
-          handlePayload(JSON.parse(raw));
-        }
-      }
-    }
-    if (buffer.trim()) {
-      const raw = buffer
-        .split("\n")
-        .find((line) => line.startsWith("data:"))
-        ?.slice(5)
-        .trim();
-      if (raw) handlePayload(JSON.parse(raw));
-    }
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    if (dialogId) {
-      options.output.write(
-        `\n[nolo] Agent stream transport interrupted after dialog ${dialogId} was created: ${message}\n`
-      );
-      options.output.write("[nolo] The agent run may still finish on the server; read the dialog before retrying.\n");
-      return { exitCode: 0, dialogId, streamInterrupted: true };
-    }
-    options.output.write(`\n[nolo] Agent stream failed: ${message}\n`);
-    return { exitCode: 1 };
-  } finally {
-    writer.flushAll();
-  }
-
-  if (!content) {
-    options.output.write(`\n${options.agentName} > (no text response)\n`);
-  } else {
-    options.output.write("\n");
-  }
-
-  const usageText = formatUsage(usage, dialogId);
-  if (usageText && shouldShowUsage(options.env)) options.output.write(`${usageText}\n`);
-  return {
-    exitCode: 0,
-    ...(dialogId ? { dialogId } : {}),
-  };
-}
-
-export async function runAgentTurn(options: RunAgentTurnOptions) {
-  const authToken = resolveAuthToken(options.env);
-  const runtimeMode = resolveRequestedRuntimeMode(options);
-
-  if (runtimeMode === "local") {
-    return runInjectedLocalAgentTurn(options);
-  }
-
-  if (runtimeMode === "auto" && shouldAttemptAutoLocal(options)) {
-    const skipLocal = await shouldSkipAutoLocalForServerPlatformTools(options);
-    if (!skipLocal) {
-      const localResult = await runLocalAgentTurnForCli(options, { reportFailure: false });
-      if (localResult.exitCode === 0) {
-        return {
-          exitCode: localResult.exitCode,
-          ...(localResult.dialogId ? { dialogId: localResult.dialogId } : {}),
-        };
-      }
-      if (isMissingLocalAgentConfigError(localResult.localError, options.agentKey)) {
-        options.output.write(
-          `[nolo] Local agent config was missing; refreshing from the configured server and retrying local once.\n`
-        );
-        try {
-          const refreshed = await refreshMissingLocalAgentConfig(options);
-          if (refreshed) {
-            const retriedLocalResult = await runLocalAgentTurnForCli(options, {
-              reportFailure: false,
-            });
-            if (retriedLocalResult.exitCode === 0) {
-              return {
-                exitCode: retriedLocalResult.exitCode,
-                ...(retriedLocalResult.dialogId ? { dialogId: retriedLocalResult.dialogId } : {}),
-              };
-            }
-          }
-        } catch {
-          // Fall through to the existing server runtime fallback below.
-        }
-      }
-    }
-  }
-
-  if (!authToken) {
-    options.output.write(
-      "[nolo] This install needs an auth token before it can talk to agents.\n" +
-        "Run `nolo login`, or set AUTH_TOKEN / NOLO_SERVER for non-interactive runs.\n"
-    );
-    return { exitCode: 1 };
-  }
-
-  return runHttpAgentTurn(options, authToken);
-}