paperclipai/paperclip · error

Sandbox provider "${parsed.config.provider}" is not register

Error message

Sandbox provider "${parsed.config.provider}" is not registered as a built-in provider and no matching plugin is available.

What it means

Provider resolution failure in acquireRunLease (environment-runtime): the environment's sandbox provider is neither a built-in provider nor resolvable through an installed sandbox-provider plugin (resolveSandboxProviderPlugin returned state 'missing'). The configured provider name simply has no implementation available in this server, so lease acquisition aborts.

Source

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

  // before, so the change never fails a release.
  function runLeaseReleaseWithRunParent<T>(leaseId: string, call: () => Promise<T>): Promise<T> {
    const runParent = runExecParentByLeaseId.get(leaseId);
    runExecParentByLeaseId.delete(leaseId);
    return runParent !== undefined ? runWithRuntimeParent(runParent, call) : call();
  }

  async function resolveSandboxProviderPlugin(input: { provider: string }) {
    const running = await resolvePluginSandboxProviderDriverByKey({
      db,
      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);

View on GitHub (pinned to 01ad858492)

Solutions

1. Register the provider as a built-in or install a plugin that provides the named sandbox provider.
2. Fix the environment config to use an available provider.

When it happens

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