@cursor/july 0.1.46 → 0.1.48

package/src/internal/serve-restart.ts

@@ -0,0 +1,120 @@
+/**
+ * Enter-to-restart for `serve` / `dev` on a TTY.
+ *
+ * In-process close+re-serve cannot reload every authored change: Node ESM
+ * caches transitive imports, and module-level state (tsx, singletons) survives.
+ * The parent process therefore supervises a worker and respawns it when the
+ * worker exits with {@link ENTER_RESTART_EXIT_CODE}.
+ */
+
+export const ENTER_RESTART_EXIT_CODE = 75;
+
+export const SERVE_RESTART_WORKER_ENV = "AGENT_SERVE_RESTART_WORKER";
+
+export interface ServeRestartProcess {
+  execPath: string;
+  execArgv: readonly string[];
+  argv: readonly string[];
+  env: NodeJS.ProcessEnv;
+}
+
+export interface ServeRestartSpawnPlan {
+  command: string;
+  args: string[];
+  env: NodeJS.ProcessEnv;
+}
+
+export interface ServeRestartWorkerChild {
+  once(
+    event: "exit",
+    listener: (code: number | null, signal: NodeJS.Signals | null) => void
+  ): void;
+}
+
+export function isServeRestartWorker(
+  env: NodeJS.ProcessEnv = process.env
+): boolean {
+  return env[SERVE_RESTART_WORKER_ENV] === "1";
+}
+
+export function serveRestartSpawnPlan(
+  proc: ServeRestartProcess
+): ServeRestartSpawnPlan {
+  return {
+    command: proc.execPath,
+    args: [...proc.execArgv, ...proc.argv.slice(1)],
+    env: { ...proc.env, [SERVE_RESTART_WORKER_ENV]: "1" },
+  };
+}
+
+export function shouldRespawnServeWorker(
+  code: number | null,
+  signal: NodeJS.Signals | null
+): boolean {
+  return signal === null && code === ENTER_RESTART_EXIT_CODE;
+}
+
+/**
+ * Run the TTY Enter-to-restart supervisor: spawn this CLI as a worker, and
+ * respawn whenever the worker exits asking for a restart. Other exits
+ * (Ctrl-C drain, crash, bind failure) propagate to the caller.
+ */
+export async function runEnterRestartSupervisor(options: {
+  spawn: (
+    command: string,
+    args: string[],
+    spawnOptions: { stdio: "inherit"; env: NodeJS.ProcessEnv }
+  ) => ServeRestartWorkerChild;
+  proc?: ServeRestartProcess;
+  onRestart?: () => void;
+  installSignalGuards?: (handler: () => void) => () => void;
+}): Promise<number> {
+  const proc = options.proc ?? {
+    execPath: process.execPath,
+    execArgv: process.execArgv,
+    argv: process.argv,
+    env: process.env,
+  };
+  const plan = serveRestartSpawnPlan(proc);
+  const uninstallSignals = (
+    options.installSignalGuards ?? installDefaultSignalGuards
+  )(() => undefined);
+
+  try {
+    for (;;) {
+      const child = options.spawn(plan.command, plan.args, {
+        stdio: "inherit",
+        env: plan.env,
+      });
+      const { code, signal } = await waitForExit(child);
+      if (!shouldRespawnServeWorker(code, signal)) {
+        if (signal !== null) {
+          return 1;
+        }
+        return code ?? 1;
+      }
+      options.onRestart?.();
+    }
+  } finally {
+    uninstallSignals();
+  }
+}
+
+function waitForExit(
+  child: ServeRestartWorkerChild
+): Promise<{ code: number | null; signal: NodeJS.Signals | null }> {
+  return new Promise((resolve) => {
+    child.once("exit", (code, signal) => {
+      resolve({ code, signal });
+    });
+  });
+}
+
+function installDefaultSignalGuards(handler: () => void): () => void {
+  process.on("SIGINT", handler);
+  process.on("SIGTERM", handler);
+  return () => {
+    process.off("SIGINT", handler);
+    process.off("SIGTERM", handler);
+  };
+}

package/src/internal/server.ts

@@ -147,7 +147,11 @@ import {
 } from "./resolved-connections.js";
 import { Router } from "./router.js";
 import { ScheduleRunner, UnknownScheduleError } from "./schedule-runner.js";
-import { type AgentRunner, CursorSdkRunner } from "./sdk-runner.js";
+import {
+  type AgentRunner,
+  CursorSdkRunner,
+  resolveServeWorkspaceScanCacheTtlMs,
+} from "./sdk-runner.js";
 import {
   SessionAuthError,
   SessionBusyError,
@@ -364,11 +368,17 @@ export async function startServer(
       "[agent-sdk] warning: --allow-anonymous admits every HTTP caller as the same principal; use only on a trusted network (e.g. Tailscale) and prefer --bearer-token for shared hosts"
     );
   }
+  const workspaceScanCacheTtlMs = resolveServeWorkspaceScanCacheTtlMs({
+    dev,
+  });
   const runner =
     options.runner ??
     new CursorSdkRunner({
       ...(accountKey === undefined ? {} : { apiKey: accountKey.apiKey }),
       logger,
+      ...(workspaceScanCacheTtlMs === undefined
+        ? {}
+        : { workspaceScanCacheTtlMs }),
     });
 
   const router = new Router();