paperclipai/paperclip · error

dev_server_supervisor_unavailable

Error message

dev_server_supervisor_unavailable

What it means

404 sentinel on POST /dev-server/restart: no persisted dev-server supervisor status record was found, meaning the supervisor is not tracking this deployment and cannot accept restart requests.

Source

Thrown at server/src/routes/health.ts:147

  } = {
    deploymentMode: "local_trusted",
    deploymentExposure: "private",
    authReady: true,
    companyDeletionEnabled: true,
  },
) {
  const router = Router();

  router.post("/dev-server/restart", async (req, res) => {
    const actorType = "actor" in req ? req.actor?.type : null;
    if (opts.deploymentMode === "authenticated" && actorType !== "board") {
      res.status(403).json({ error: "board_access_required" });
      return;
    }

    const persistedDevServerStatus = readPersistedDevServerStatus();
    if (!persistedDevServerStatus) {
      res.status(404).json({ error: "dev_server_supervisor_unavailable" });
      return;
    }

    const restartRequired =
      persistedDevServerStatus.dirty ||
      persistedDevServerStatus.changedPathCount > 0 ||
      persistedDevServerStatus.pendingMigrations.length > 0;
    if (!restartRequired) {
      res.status(409).json({ error: "restart_not_required" });
      return;
    }

    if (!db) {
      res.status(503).json({ error: "database_unavailable" });
      return;
    }

    const requestId = randomUUID();

View on GitHub (pinned to 01ad858492)

Solutions

1. Check the health/connectivity of the backing service (database, dev server supervisor, storage), fix the underlying fault, and retry.

When it happens

Trigger: Thrown at server/src/routes/health.ts:104 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/e8ff96e73367aa31. Report an issue: GitHub.