npm - @cursor/july - Versions diffs - 0.1.47 → 0.1.48 - Mend

@cursor/july 0.1.47 → 0.1.48

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (88) hide show

package/dist/bin/agent-serve.js +30 -35
package/dist/docs/404.html +1 -1
package/dist/docs/ab.html +2 -2
package/dist/docs/assets/{app.IEXEim5m.js → app.BC1P20xI.js} +1 -1
package/dist/docs/assets/chunks/@localSearchIndexroot.DV5SAHnQ.js +1 -0
package/dist/docs/assets/chunks/{VPLocalSearchBox.78s6nqsH.js → VPLocalSearchBox.C_900xn2.js} +1 -1
package/dist/docs/assets/chunks/{theme.DroGdz_Q.js → theme.CT135Jhh.js} +2 -2
package/dist/docs/building-with-agents.html +2 -2
package/dist/docs/concepts.html +2 -2
package/dist/docs/deployment.html +2 -2
package/dist/docs/evals.html +2 -2
package/dist/docs/example-agents/approval-buddy.html +2 -2
package/dist/docs/example-agents/benny.html +2 -2
package/dist/docs/example-agents/bugbot.html +2 -2
package/dist/docs/example-agents/codebase-wiki.html +2 -2
package/dist/docs/example-agents/codeowners-review.html +2 -2
package/dist/docs/example-agents/concierge.html +2 -2
package/dist/docs/example-agents/fsd.html +2 -2
package/dist/docs/example-agents/index.html +2 -2
package/dist/docs/example-agents/knowledge-base.html +2 -2
package/dist/docs/example-agents/oncall.html +2 -2
package/dist/docs/example-agents/security-reviewer.html +2 -2
package/dist/docs/example-agents/slack-agent.html +2 -2
package/dist/docs/example-agents/weather-agent.html +2 -2
package/dist/docs/guides/agent-to-agent.html +2 -2
package/dist/docs/guides/cloud-runtime.html +2 -2
package/dist/docs/guides/github.html +2 -2
package/dist/docs/guides/human-in-the-loop.html +2 -2
package/dist/docs/guides/mcp-oauth.html +2 -2
package/dist/docs/guides/opentelemetry.html +2 -2
package/dist/docs/guides/slack.html +2 -2
package/dist/docs/guides/webhooks.html +2 -2
package/dist/docs/hillclimbing.html +2 -2
package/dist/docs/index.html +2 -2
package/dist/docs/quickstart.html +2 -2
package/dist/docs/reference/agent-config.html +2 -2
package/dist/docs/reference/artifacts.html +2 -2
package/dist/docs/reference/channels.html +2 -2
package/dist/docs/reference/cli.html +2 -2
package/dist/docs/reference/connections.html +2 -2
package/dist/docs/reference/hooks.html +2 -2
package/dist/docs/reference/http-api.html +2 -2
package/dist/docs/reference/instructions.html +2 -2
package/dist/docs/reference/playground.html +2 -2
package/dist/docs/reference/project-layout.html +2 -2
package/dist/docs/reference/prompt.html +2 -2
package/dist/docs/reference/schedules.html +2 -2
package/dist/docs/reference/sessions.html +2 -2
package/dist/docs/reference/skills.html +2 -2
package/dist/docs/reference/subagents.html +2 -2
package/dist/docs/reference/tools.html +2 -2
package/dist/docs/scaffolding-agents.html +2 -2
package/dist/docs/storage.html +2 -2
package/dist/docs/templates/triage.html +2 -2
package/dist/docs/troubleshooting.html +2 -2
package/dist/internal/authored-loaders.d.ts +19 -0
package/dist/internal/authored-loaders.d.ts.map +1 -1
package/dist/internal/authored-loaders.js +39 -0
package/dist/internal/cli-deploy.d.ts +2 -1
package/dist/internal/cli-deploy.d.ts.map +1 -1
package/dist/internal/cli-deploy.js +97 -1
package/dist/internal/deploy-client.d.ts +7 -2
package/dist/internal/deploy-client.d.ts.map +1 -1
package/dist/internal/deploy-client.js +12 -0
package/dist/internal/discovery.d.ts.map +1 -1
package/dist/internal/discovery.js +2 -8
package/dist/internal/eval-runner.d.ts.map +1 -1
package/dist/internal/eval-runner.js +3 -8
package/dist/internal/logs-client.d.ts +1 -1
package/dist/internal/logs-client.d.ts.map +1 -1
package/dist/internal/logs-client.js +3 -0
package/dist/internal/serve-restart.d.ts +42 -0
package/dist/internal/serve-restart.d.ts.map +1 -0
package/dist/internal/serve-restart.js +85 -0
package/dist/playground/assets/index-CiCmH6R-.css +1 -0
package/dist/playground/assets/{index-BgUHfe3L.js → index-DEVTyeOu.js} +46 -46
package/dist/playground/index.html +2 -2
package/package.json +1 -1
package/src/bin/agent-serve.ts +39 -38
package/src/internal/authored-loaders.ts +45 -0
package/src/internal/cli-deploy.ts +103 -1
package/src/internal/deploy-client.ts +19 -1
package/src/internal/discovery.ts +5 -12
package/src/internal/eval-runner.ts +3 -12
package/src/internal/logs-client.ts +4 -0
package/src/internal/serve-restart.ts +120 -0
package/dist/docs/assets/chunks/@localSearchIndexroot.D7w61u6Y.js +0 -1
package/dist/playground/assets/index-uFaeqVZS.css +0 -1

package/dist/playground/index.html CHANGED Viewed

@@ -8,8 +8,8 @@
     />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>agent-serve playground</title>
-    <script type="module" crossorigin src="./assets/index-BgUHfe3L.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-uFaeqVZS.css">
+    <script type="module" crossorigin src="./assets/index-DEVTyeOu.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-CiCmH6R-.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cursor/july",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "description": "(early alpha) Filesystem-first framework for defining Cursor agents as markdown and TypeScript and serving them over channels with the Cursor SDK.",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {

package/src/bin/agent-serve.ts CHANGED Viewed

@@ -16,6 +16,7 @@
  *   agent-serve slack     <subcommand>
  */
+import { spawn } from "node:child_process";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { parseArgs } from "node:util";
@@ -44,6 +45,7 @@ import {
   cmdTrajectory,
 } from "../internal/cli-ax.js";
 import {
+  cmdDelete,
   cmdDeploy,
   cmdDeploymentStatus,
   cmdDeployments,
@@ -61,6 +63,11 @@ import {
   packageVersion,
 } from "../internal/distribution.js";
 import { loadAgentLocalEnv } from "../internal/local-env.js";
+import {
+  ENTER_RESTART_EXIT_CODE,
+  isServeRestartWorker,
+  runEnterRestartSupervisor,
+} from "../internal/serve-restart.js";
 import { clearTerminal, stdoutPalette } from "../internal/terminal-style.js";
 import { cmdUpdate, warnIfOutdated } from "../internal/update-check.js";
 import type { AgentProject, AgentServeHandle } from "../types.js";
@@ -134,6 +141,7 @@ Usage:
   ${CLI} deployments [--team <id>] [--json]
   ${CLI} deployment  <slug> [--team <id>] [--json]
   ${CLI} stop        <slug> [--team <id>] [--json] [--no-wait]
+  ${CLI} delete      <slug> [--team <id>] [--json] [--no-wait]
   ${CLI} rotate-token <slug> [--team <id>]
   ${CLI} rotate-pod-credential <slug> [--team <id>]
   ${CLI} secrets     set <slug> NAME... | list <slug> | unset <slug> NAME
@@ -143,7 +151,8 @@ Usage:
 Commands:
   serve       Serve agents under /<slug>/... (index at /). On a TTY, press
-              Enter to restart (reloads agent code + Vite HMR child).
+              Enter to restart (re-executes this process so agent code, evals,
+              and Vite reload).
   dev         Local development: same as \`${CLI} serve --dev\` (manual
               schedule/reminder dispatch, unsigned GitHub loopback, Vite HMR).
   chat        Interactive REPL against a running server (follow-ups keep the
@@ -252,6 +261,8 @@ Commands:
   deployments List the team's deployments (slug, status, generation, kind).
   deployment  Show one deployment in full (status, lastError, engine info).
   stop        Stop a deployment and wait until it reports stopped.
+  delete      Delete a deployment (teardown + purge the record) and wait
+              until GET 404s. The slug is then free to redeploy.
   rotate-token Mint a new alias token for a deployment (shown once); the old
               token stops working immediately.
   rotate-pod-credential
@@ -555,7 +566,12 @@ async function main(argv: string[]): Promise<number> {
   // Best-effort, cached, and silent on failure. `update` does its own fresh
   // lookup, --json runs stay quiet for machine consumers, and `mcp` skips it
   // so MCP client spawns stay fast (stdout there is the protocol wire).
-  if (command !== "update" && command !== "mcp" && values.json !== true) {
+  if (
+    command !== "update" &&
+    command !== "mcp" &&
+    values.json !== true &&
+    !isServeRestartWorker()
+  ) {
     await warnIfOutdated();
   }
@@ -731,6 +747,10 @@ async function main(argv: string[]): Promise<number> {
       return cmdStop(positionals[0], deployOptionsFromValues(values));
     }
+    case "delete": {
+      return cmdDelete(positionals[0], deployOptionsFromValues(values));
+    }
     case "rotate-token": {
       return cmdRotateToken(positionals[0], deployOptionsFromValues(values));
     }
@@ -1227,6 +1247,16 @@ async function main(argv: string[]): Promise<number> {
         },
       };
       const enterToRestart = process.stdin.isTTY === true;
+      if (enterToRestart && !isServeRestartWorker()) {
+        return runEnterRestartSupervisor({
+          spawn: (command, args, spawnOptions) =>
+            spawn(command, args, spawnOptions),
+          onRestart: () => {
+            clearTerminal();
+          },
+        });
+      }
       const bannerOpts = {
         noPlayground: values["no-playground"] === true,
         dev,
@@ -1244,9 +1274,9 @@ async function main(argv: string[]): Promise<number> {
         return next;
       };
-      let handle = await start();
+      const handle = await start();
       let closing = false;
-      let restarting = false;
+      let restartRequested = false;
       await new Promise<void>((resolve) => {
         const shutdown = (): void => {
@@ -1268,40 +1298,17 @@ async function main(argv: string[]): Promise<number> {
         process.stdin.on("data", (chunk: string | Buffer) => {
           const text =
             typeof chunk === "string" ? chunk : chunk.toString("utf8");
-          if (!isEnterOnly(text) || closing || restarting) {
+          if (!isEnterOnly(text) || closing) {
             return;
           }
-          restarting = true;
-          // Close + re-serve reloads authored agent modules and respawns Vite.
-          // Hold the "restarting…" frame briefly so a fast close doesn't look
-          // like Enter did nothing.
+          closing = true;
+          restartRequested = true;
           clearTerminal();
           process.stdout.write(style.dim("restarting…\n"));
-          void Promise.all([handle.close(), sleep(450)])
-            .then(() => {
-              clearTerminal();
-              return start();
-            })
-            .then((next) => {
-              handle = next;
-            })
-            .catch((error: unknown) => {
-              process.stderr.write(
-                `[agent-sdk] restart failed: ${
-                  error instanceof Error
-                    ? (error.stack ?? error.message)
-                    : String(error)
-                }\n`
-              );
-              closing = true;
-              resolve();
-            })
-            .finally(() => {
-              restarting = false;
-            });
+          void handle.close().finally(resolve);
         });
       });
-      return 0;
+      return restartRequested ? ENTER_RESTART_EXIT_CODE : 0;
     }
     default: {
@@ -1437,12 +1444,6 @@ function isEnterOnly(text: string): boolean {
   return text.length > 0 && [...text].every((ch) => ch === "\n" || ch === "\r");
 }
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => {
-    setTimeout(resolve, ms);
-  });
-}
 /**
  * `dev [path]` takes a positional project root; `serve` keeps `--dir` only.
  * Reject mixing a positional with an explicit `--dir`, and extra args on `dev`.

package/src/internal/authored-loaders.ts CHANGED Viewed

@@ -16,6 +16,7 @@
  * them.
  */
+import { stat } from "node:fs/promises";
 import { register as registerModuleHooks } from "node:module";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
@@ -38,6 +39,50 @@ import {
 const TSX_REGISTERED_KEY = Symbol.for("cursor.agentkit.tsxRegistered");
 const ALIASES_REGISTERED_KEY = Symbol.for("cursor.agentkit.aliasesRegistered");
+/**
+ * ESM specifier for an authored agent/eval file.
+ *
+ * Node caches `import()` by URL for the life of the process, so a long-lived
+ * `agent-sdk dev` would otherwise keep serving the first load of eval files
+ * and agent modules. The mtime query string is ignored by the filesystem
+ * resolver and is the cache key.
+ *
+ * Truncate to an integer: vitest/esbuild treat the substring after the last
+ * `.` as a loader id, so `?mtime=1700000000000.4949` fails with
+ * `Invalid loader value: "4949"`. Named `mtime` rather than `t` so Vite does
+ * not treat it as its HMR timestamp and collapse the specifier to the path.
+ */
+export function authoredModuleSpecifier(
+  absolutePath: string,
+  mtimeMs: number
+): string {
+  const url = pathToFileURL(absolutePath);
+  url.searchParams.set("mtime", String(Math.trunc(mtimeMs)));
+  return url.href;
+}
+/**
+ * Dynamically import an authored TypeScript/JavaScript module, re-reading it
+ * from disk when the file's mtime has changed since the last import.
+ */
+export async function importAuthoredModule(
+  absolutePath: string
+): Promise<Record<string, unknown>> {
+  let mtimeMs = 0;
+  try {
+    mtimeMs = (await stat(absolutePath)).mtimeMs;
+  } catch {
+    // import() reports the real missing-file error.
+  }
+  const loaded: unknown = await import(
+    authoredModuleSpecifier(absolutePath, mtimeMs)
+  );
+  if (typeof loaded !== "object" || loaded === null) {
+    throw new Error(`authored module is not an object: ${absolutePath}`);
+  }
+  return loaded as Record<string, unknown>;
+}
 let registration: Promise<void> | undefined;
 /**

package/src/internal/cli-deploy.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * `agent-sdk deploy | deployments | deployment | stop | rotate-token |
+ * `agent-sdk deploy | deployments | deployment | stop | delete | rotate-token |
  * rotate-pod-credential | secrets set|list|unset` — Heroku-style deploys
  * onto Cursor's managed agent-serve hosting.
  *
@@ -24,6 +24,7 @@ import {
 import { authorizeCursorAccountConnectors } from "./cursor-account-mcp-auth.js";
 import {
   AgentServeDeployClient,
+  type DeleteAccepted,
   type DeployAccepted,
   DeployApiError,
   type Deployment,
@@ -1117,6 +1118,54 @@ export async function cmdStop(
   return 0;
 }
+// ============================================================================
+// delete <slug>
+// ============================================================================
+export async function cmdDelete(
+  slug: string | undefined,
+  options: DeployCliOptions
+): Promise<number> {
+  if (slug === undefined || slug === "") {
+    (options.err ?? ((t: string) => void process.stderr.write(t)))(
+      `Usage: ${CLI} delete <slug> [--team <id>] [--json] [--no-wait]\n`
+    );
+    return 1;
+  }
+  const ctx = await prepare(options);
+  if (typeof ctx === "number") {
+    return ctx;
+  }
+  let accepted: DeleteAccepted;
+  try {
+    accepted = await ctx.client.deleteDeployment({
+      teamId: ctx.teamId,
+      slug,
+    });
+  } catch (error) {
+    return renderApiError(error, ctx.err);
+  }
+  if (ctx.noWait) {
+    if (ctx.json) {
+      ctx.out(`${JSON.stringify(accepted, null, 2)}\n`);
+    } else {
+      ctx.out(`Delete accepted for ${slug} (status: ${accepted.status}).\n`);
+    }
+    return 0;
+  }
+  try {
+    await pollUntilGone(ctx, slug);
+  } catch (error) {
+    return renderApiError(error, ctx.err);
+  }
+  if (ctx.json) {
+    ctx.out(`${JSON.stringify({ slug, status: "deleted" }, null, 2)}\n`);
+  } else {
+    ctx.out(`Deleted ${slug} (team ${ctx.teamId}).\n`);
+  }
+  return 0;
+}
 // ============================================================================
 // rotate-token <slug>
 // ============================================================================
@@ -1526,6 +1575,59 @@ async function pollUntil(
   }
 }
+/**
+ * Wait until GET 404s (the delete reconciler purged the record). Treats
+ * other errors as failures. Throws DeployApiError on timeout.
+ */
+async function pollUntilGone(
+  ctx: DeployCliContext,
+  slug: string
+): Promise<void> {
+  const startedAt = Date.now();
+  const tty = process.stderr.isTTY === true;
+  let sawProgress = false;
+  const report = (label: string): void => {
+    if (ctx.json) {
+      return;
+    }
+    const elapsed = Math.round((Date.now() - startedAt) / 1000);
+    if (tty) {
+      ctx.err(`\r\x1b[2K${slug}: ${label} (${elapsed}s)`);
+      sawProgress = true;
+    }
+  };
+  const finishProgressLine = (): void => {
+    if (tty && sawProgress) {
+      ctx.err("\n");
+    }
+  };
+  for (;;) {
+    try {
+      const detail = await ctx.client.getDeployment({
+        teamId: ctx.teamId,
+        slug,
+      });
+      report(deployProgressLabel(detail));
+    } catch (error: unknown) {
+      if (error instanceof DeployApiError && error.status === 404) {
+        finishProgressLine();
+        return;
+      }
+      finishProgressLine();
+      throw error;
+    }
+    if (Date.now() - startedAt >= ctx.timeoutMs) {
+      finishProgressLine();
+      throw new DeployApiError(
+        `Timed out after ${Math.round(ctx.timeoutMs / 1000)}s waiting for ${slug} to disappear. It may still be deleting — check \`${CLI} deployment ${slug} --team ${ctx.teamId}\`.`,
+        0
+      );
+    }
+    await sleep(ctx.pollIntervalMs);
+  }
+}
 function aliasTokenBlock(aliasToken: string): string {
   return (
     `\n  Alias token (shown ONCE — save it now, it cannot be retrieved again):\n\n` +

package/src/internal/deploy-client.ts CHANGED Viewed

@@ -25,7 +25,8 @@ export type DeploymentStatus =
   | "degraded"
   | "failed"
   | "stopping"
-  | "stopped";
+  | "stopped"
+  | "deleting";
 /** Customer-safe deploy progress (no hosting phase / infra names). */
 export type DeploymentProgress =
@@ -39,6 +40,7 @@ export type DeploymentProgress =
   | "failed"
   | "stopping"
   | "stopped"
+  | "deleting"
   | "degraded";
 export const TERMINAL_DEPLOY_STATUSES: ReadonlySet<DeploymentStatus> = new Set([
@@ -211,6 +213,8 @@ export interface StopAccepted {
   status: string;
 }
+export type DeleteAccepted = StopAccepted;
 /** One secret's metadata from the list endpoint — names only, never values. */
 export interface SecretInfo {
   name: string;
@@ -276,6 +280,7 @@ const deploymentSchema = z.object({
     "failed",
     "stopping",
     "stopped",
+    "deleting",
   ]),
   progress: z
     .enum([
@@ -289,6 +294,7 @@ const deploymentSchema = z.object({
       "failed",
       "stopping",
       "stopped",
+      "deleting",
       "degraded",
     ])
     .optional(),
@@ -495,6 +501,18 @@ export class AgentServeDeployClient {
     return stopAcceptedSchema.parse(raw);
   }
+  async deleteDeployment(args: {
+    teamId: number;
+    slug: string;
+  }): Promise<DeleteAccepted> {
+    const raw = await this.request({
+      method: "DELETE",
+      path: `/internal/agent-serve/deployments/${encodeURIComponent(args.slug)}?teamId=${args.teamId}`,
+      context: { verb: "delete", slug: args.slug },
+    });
+    return stopAcceptedSchema.parse(raw);
+  }
   /** Returns the new alias token exactly once; the old one dies now. */
   async rotateAliasToken(args: {
     teamId: number;

package/src/internal/discovery.ts CHANGED Viewed

@@ -16,7 +16,6 @@ import {
   relative,
   resolve,
 } from "node:path";
-import { pathToFileURL } from "node:url";
 import { type ABConfigFile, resolveABMaxPlaygroundSessions } from "../ab.js";
 import { resolveArtifactsMax } from "../artifacts.js";
 import { httpChannel } from "../channels.js";
@@ -61,7 +60,10 @@ import {
   type ToolDefinition,
   toPublicCloudInfo,
 } from "../types.js";
-import { registerAuthoredModuleLoaders } from "./authored-loaders.js";
+import {
+  importAuthoredModule,
+  registerAuthoredModuleLoaders,
+} from "./authored-loaders.js";
 import { normalizePositiveInt } from "./bounded-int.js";
 import { getDefinitionKind } from "./brand.js";
 import {
@@ -94,15 +96,6 @@ export interface LoadAgentProjectOptions {
 type ImportModule = (absolutePath: string) => Promise<Record<string, unknown>>;
-async function defaultImportModule(
-  absolutePath: string
-): Promise<Record<string, unknown>> {
-  return (await import(pathToFileURL(absolutePath).href)) as Record<
-    string,
-    unknown
-  >;
-}
 interface DiscoveryContext {
   rootDir: string;
   diagnostics: Diagnostic[];
@@ -282,7 +275,7 @@ export async function loadAgentProject(
   const ctx: DiscoveryContext = {
     rootDir,
     diagnostics,
-    importModule: options.importModule ?? defaultImportModule,
+    importModule: options.importModule ?? importAuthoredModule,
   };
   const name = (await readPackageName(rootDir)) ?? basename(rootDir);

package/src/internal/eval-runner.ts CHANGED Viewed

@@ -11,7 +11,6 @@
 import type { Dirent } from "node:fs";
 import { readdir } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
 import type {
   EvalAssertionHandle,
   EvalAssertions,
@@ -62,6 +61,7 @@ import {
   normalizeEvalMaxConcurrency,
 } from "../evals.js";
 import type { ModelSetting, SessionEvent } from "../types.js";
+import { importAuthoredModule } from "./authored-loaders.js";
 import { isDefinitionOfKind } from "./brand.js";
 import {
   callJudgeModel,
@@ -131,15 +131,6 @@ export interface RunEvalsOptions extends EvalSelectionOptions {
   signal?: AbortSignal;
 }
-async function defaultImport(
-  absolutePath: string
-): Promise<Record<string, unknown>> {
-  return (await import(pathToFileURL(absolutePath).href)) as Record<
-    string,
-    unknown
-  >;
-}
 async function listEvalFiles(dir: string): Promise<string[]> {
   const out: string[] = [];
   async function walk(current: string): Promise<void> {
@@ -172,7 +163,7 @@ export async function discoverEvals(
   projectRoot: string,
   importModule: (
     absolutePath: string
-  ) => Promise<Record<string, unknown>> = defaultImport
+  ) => Promise<Record<string, unknown>> = importAuthoredModule
 ): Promise<{
   evals: DiscoveredEval[];
   config: Partial<EvalConfigFile>;
@@ -291,7 +282,7 @@ export async function runDiscoveredEvals(
     selected = options.discovered.evals;
     config = options.discovered.config;
   } else {
-    const importModule = options.importModule ?? defaultImport;
+    const importModule = options.importModule ?? importAuthoredModule;
     const discovered = await discoverEvals(options.projectRoot, importModule);
     config = discovered.config;
     selected = filterDiscoveredEvals(discovered.evals, {

package/src/internal/logs-client.ts CHANGED Viewed

@@ -43,6 +43,7 @@ export type LogsProgress =
   | "failed"
   | "stopping"
   | "stopped"
+  | "deleting"
   | "degraded";
 const PROGRESS_MESSAGES: Readonly<Record<LogsProgress, string>> = {
@@ -56,6 +57,7 @@ const PROGRESS_MESSAGES: Readonly<Record<LogsProgress, string>> = {
   failed: "Deploy failed",
   stopping: "Stopping deployment…",
   stopped: "Deployment stopped",
+  deleting: "Deleting deployment…",
   degraded: "Deployment degraded",
 };
@@ -385,6 +387,8 @@ function resolveProgress(detail: DeploymentDetail): LogsProgress {
       return "stopping";
     case "stopped":
       return "stopped";
+    case "deleting":
+      return "deleting";
     default:
       return "queued";
   }

package/src/internal/serve-restart.ts ADDED Viewed

@@ -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);
+  };
+}