paperclipai/paperclip · error

Sandbox provider "${parsed.config.provider}" is installed, b

Error message

Sandbox provider "${parsed.config.provider}" is installed, but sandbox plugin workers are unavailable in this server process.

What it means

Plugin-worker availability failure in acquireRunLease: the sandbox provider is installed as a plugin (state not 'missing'), but the plugin worker runtime is unavailable in this server process (state 'not_ready' — workers not enabled or failed to start). Lease acquisition fails because sandbox work cannot be delegated to a worker.

Source

Thrown at server/src/services/environment-runtime.ts:1629

      driverKey: input.provider,
      workerManager: pluginWorkerManager,
      requireRunning: true,
    });
    if (running) {
      return { state: "running" as const, resolved: running };
    }

    const installed = await resolvePluginSandboxProviderDriverByKey({
      db,
      driverKey: input.provider,
      workerManager: pluginWorkerManager,
      requireRunning: false,
    });
    if (!installed) {
      return { state: "missing" as const, resolved: null };
    }

    if (installed.plugin.status !== "ready") {
      return { state: "not_ready" as const, resolved: installed };
    }

    if (!pluginWorkerManager) {
      return { state: "worker_unavailable" as const, resolved: installed };
    }

    const deadline = Date.now() + Math.max(0, pluginWorkerReadyTimeoutMs);
    while (Date.now() < deadline) {
      const retried = await resolvePluginSandboxProviderDriverByKey({
        db,
        driverKey: input.provider,
        workerManager: pluginWorkerManager,
        requireRunning: true,
      });
      if (retried) {
        return { state: "running" as const, resolved: retried };
      }

View on GitHub (pinned to 01ad858492)

Solutions

1. Restart the server with sandbox plugin workers enabled, or use a built-in provider instead.

When it happens

Trigger: Thrown at server/src/services/environment-runtime.ts:1507 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/0cd7fed0a3102e38. Report an issue: GitHub.