Daytona template capture requires @daytonaio/sdk…

Error message

Daytona template capture requires @daytonaio/sdk Sandbox._experimental_createSnapshot support.

What it means

SDK capability probe in onEnvironmentCaptureTemplate: the loaded @daytonaio/sdk Sandbox does not expose the _experimental_createSnapshot method needed to turn a setup sandbox into a snapshot template. Fires on SDK versions lacking experimental snapshot support — upgrade @daytonaio/sdk to capture templates.

Solutions

Upgrade @daytonaio/sdk to a version supporting Sandbox._experimental_createSnapshot.

Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at packages/plugins/sandbox-providers/daytona/src/plugin.ts:2406 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@3f1d897a7c (2026-08-18). Data as JSON: /api/errors/fcc694c4b7d56e06. Report an issue: GitHub.

Appendix: source

Thrown at packages/plugins/sandbox-providers/daytona/src/plugin.ts:2523

          connectionPayload: null,
          metadata: {
            provider: "daytona",
            missing: true,
          },
        };
      }

      await ensureSandboxStarted(sandbox, toTimeoutSeconds(config.timeoutMs));
      const remoteCwd = await resolveSandboxWorkingDirectory(sandbox);
    const shellCommand = await detectSandboxShellCommand(sandbox, toTimeoutSeconds(config.timeoutMs));
    const connection = params.includeConnectionPayload === true
      ? await createSshConnection(sandbox, resolveConnectionExpiresInMinutes(params.connectionExpiresInMinutes))
      : {
          connectionSummary: {
            type: "ssh" as const,
            username: "token",
            hostRedacted: true,
            portRedacted: true,
            commandRedacted: true,
            metadata: {
              provider: "daytona",
            },
          },
          connectionPayload: null,
        };

      return {
        providerLeaseId: sandbox.id,
        status: "waiting_for_user",
        ...connection,
        metadata: interactiveSetupMetadata({
          config,
          sandbox,
          shellCommand,
          remoteCwd,
        }),

View on GitHub (pinned to 3f1d897a7c)