paperclipai/paperclip · error

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

Error message

Environment driver "${driver.driver}" does not support workspace realization.

What it means

Capability dispatch guard in the environment-runtime driver facade: the resolved environment driver (driver.driver) does not implement an optional realizeWorkspace method. The runtime was asked to realize a workspace on a driver that only supports other operations, so the facade rejects the call rather than no-oping.

Source

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

          },
          workspace: input.workspace,
        },
      });
    },

    async execute(input) {
      const { plugin, pluginKey, driverKey, driverConfig } = await resolvePluginDriverForRelease({
        environment: input.environment,
        lease: input.lease,
        status: "released",
      });
      return await executePluginEnvironmentCommand({
        db,
        workerManager,
        pluginId: plugin.id,
        config: {
          pluginKey,
          driverKey,
          driverConfig,
        },
        params: {
          driverKey,
          companyId: input.lease.companyId,
          environmentId: input.environment.id,
          issueId: input.lease.issueId,
          config: driverConfig,
          lease: {
            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,

View on GitHub (pinned to 01ad858492)

Solutions

1. Use an environment driver that supports workspace realization for this operation.

When it happens

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