paperclipai/paperclip · error

Environment driver "${driver.driver}" does not support nativ

Error message

Environment driver "${driver.driver}" does not support native file sync.

What it means

Capability dispatch guard in the environment-runtime facade's syncIn path: the resolved environment driver does not implement native file sync (supportsSync returned false / no syncIn). A native sync was requested for a driver that never opted into it, so the facade rejects instead of falling back to the base64-over-exec path implicitly.

Source

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

            providerLeaseId: input.lease.providerLeaseId,
            metadata: input.lease.metadata ?? undefined,
            expiresAt: input.lease.expiresAt?.toISOString() ?? null,
          },
          command: input.command,
          args: input.args,
          cwd: input.cwd,
          env: input.env,
          stdin: input.stdin,
          timeoutMs: input.timeoutMs,
        },
      });
    },

    async resolveCapabilities(input) {
      const metadata = input.lease.metadata ?? {};
      const pluginId = readString(metadata.pluginId);
      const driverKey = readString(metadata.driverKey);
      const noCapabilities = () =>
        classifyEnvironmentCapabilities({
          verifiedMethods: [],
          declared: null,
          narrowing: null,
          supportedCapabilities: ENVIRONMENT_DRIVER_CAPABILITY_SUPPORT.plugin.supportedCapabilities,
        });

      if (!pluginId || !driverKey) {
        // The lease carries no plugin pin, so there is no exact plugin to read
        // the declaration or the live worker methods from. Fail closed: resolve
        // every capability false.
        return noCapabilities();
      }

      // Read the declaration from the exact plugin that acquired the lease, not
      // the plugin the environment's current config names. A plugin uninstall,
      // a manifest change, or a config edit between the acquire and this call
      // must not let a stale declaration or a different plugin's worker grant a

View on GitHub (pinned to 01ad858492)

Solutions

1. Use an environment driver that supports native file sync, or use an alternative sync mechanism.

When it happens

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