paperclipai/paperclip · error

Plugin environment driver "${pluginDriverProviderKey(config)

Error message

Plugin environment driver "${pluginDriverProviderKey(config)}" is not ready.

What it means

Plugin resolution failure in createPluginEnvironmentDriver's resolvePluginDriver: the registry lookup for config.pluginKey returned no plugin or one whose status is not 'ready' (e.g. 'installed' but worker not started, or errored). The plugin environment driver cannot dispatch to a plugin that is not fully ready, so the operation aborts.

Source

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

        environment: input.environment,
        lease: input.lease,
        failureReason: input.failureReason ?? "lease_destroyed",
      });
    },
  };

  /**
   * Resolve the effective capability snapshot for one sandbox lease. This is
   * the sandbox driver's implementation of the general capability-resolution
   * method: it gates through {@link ENVIRONMENT_DRIVER_CAPABILITY_SUPPORT}'s
   * `sandbox` support (the whole set, so this gate adds no restriction beyond
   * declaration, verification, and narrowing), then reads the per-lease
   * declaration, the live verified worker methods, and the per-lease
   * narrowing, exactly as the runtime resolved them before this method
   * existed.
   */
  async function resolveSandboxCapabilitiesForLease(
    input: EnvironmentDriverLeaseInput,
  ): Promise<EffectiveExecutionCapabilities> {
    const metadata = input.lease.metadata ?? {};
    const providerKey =
      readString(metadata.provider) ??
      (input.environment.driver === "sandbox"
        ? readString((parseEnvironmentDriverConfig(input.environment).config as SandboxEnvironmentConfig).provider)
        : null);
    if (!providerKey) {
      return classifyEnvironmentCapabilities({
        verifiedMethods: [],
        declared: null,
        narrowing: null,
        supportedCapabilities: ENVIRONMENT_DRIVER_CAPABILITY_SUPPORT.sandbox.supportedCapabilities,
      });
    }

    let declared: SandboxProviderCapabilities | null = null;
    let verifiedMethods: readonly string[] = [];

View on GitHub (pinned to 01ad858492)

Solutions

1. Check the plugin environment driver status and restart/reenable the plugin before retrying.

When it happens

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