paperclipai/paperclip · error · ToolRuntimeSupervisorError

runtime_restart_suppressed

runtime_restart_suppressed

Error message

Runtime restart storm suppression is active

What it means

assertRestartAllowed storm suppression: the slot's metadata carries restartSuppressedUntil in the future because the process crashed and restarted too often within the storm window. Further restarts are refused with 429 until the suppression window passes, preventing crash-loop resource burn; investigate why the runtime keeps dying.

Source

Thrown at server/src/services/tool-runtime-supervisor.ts:311

          hostCount,
          maxCompanySlots,
          maxHostSlots,
        },
      });
      throw new ToolRuntimeSupervisorError(
        429,
        "No local stdio runtime capacity is currently available",
        "runtime_capacity_unavailable",
        { reasonCode, companyCount, hostCount, maxCompanySlots, maxHostSlots },
      );
    }
  }

  function assertRestartAllowed(row: typeof toolRuntimeSlots.$inferSelect, metadata: Record<string, unknown>) {
    const at = now();
    const suppressedUntil = dateValue(metadata.restartSuppressedUntil);
    if (suppressedUntil && suppressedUntil.getTime() > at.getTime()) {
      throw new ToolRuntimeSupervisorError(
        429,
        "Runtime restart storm suppression is active",
        "runtime_restart_suppressed",
        { slotId: row.id, suppressedUntil: suppressedUntil.toISOString() },
      );
    }
    const backoffUntil = dateValue(metadata.restartBackoffUntil);
    if (backoffUntil && backoffUntil.getTime() > at.getTime()) {
      throw new ToolRuntimeSupervisorError(
        429,
        "Runtime restart backoff is active",
        "runtime_restart_backoff",
        { slotId: row.id, backoffUntil: backoffUntil.toISOString() },
      );
    }
  }

  function restartMetadata(row: typeof toolRuntimeSlots.$inferSelect, metadata: Record<string, unknown>, reason: string) {

View on GitHub (pinned to 120ae5428f)

Solutions

1. Restart storm suppression is active after repeated crashes. Fix the crashing runtime configuration, then wait for suppression to lift.

When it happens

Trigger: Thrown at server/src/services/tool-runtime-supervisor.ts:311 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@120ae5428f (2026-08-18). Data as JSON: /api/errors/5a2545852541a9da. Report an issue: GitHub.