paperclipai/paperclip · error · Error

workspace_durable_seed_git_missing

workspace_durable_seed_git_missing

Error message

workspace_durable_seed_git_missing

What it means

Guard during the pack step in prepareSandboxManagedRuntime: the workspace is git-backed and a git-history tar was expected, but no usable git snapshot was available to pack. It fires when the git working tree or snapshot data required for the seed/history tarball is missing at pack time.

Source

Thrown at packages/adapter-utils/src/sandbox-managed-runtime.ts:1317

          // defaults to a no-op, so a caller with no injected runner keeps the
          // current behavior and control flow.
          await runStepSpan("pack", async () => {
            // 1. git-history tar (git-backed workspace only). Both tar targets live under
            //    `runtimeRootDir` (`.paperclip-runtime/<adapterKey>`). The git extract
            //    wipes the target tree EXCEPT `.paperclip-runtime`, so the overlay tar,
            //    which sits under `.paperclip-runtime`, survives to run its own extract.
            if (gitSnapshot) {
              await emitRuntimeStatus(input.onRuntimeProgress, "git_sync", "Syncing git history to environment");
              const gitTarPath = path.join(tempDir, "git-workspace.tar");
              const remoteGitTar = path.posix.join(
                runtimeRootDir,
                "git-workspace-upload.tar",
              );
              if (workspaceInboundMode === "durable_seed") {
                const durableGitArchive =
                  input.workspaceDurableSeed?.gitArchivePath;
                if (!durableGitArchive) {
                  throw new Error("workspace_durable_seed_git_missing");
                }
                await copyDurableSeedArchive({
                  sourcePath: durableGitArchive,
                  targetPath: gitTarPath,
                  expectedSha256: input.workspaceDurableSeed?.gitArchiveSha256,
                });
              } else {
                await withShallowGitWorkspaceClone(
                  {
                    localDir: input.workspaceLocalDir,
                    snapshot: gitSnapshot,
                  },
                  async (cloneDir) => {
                    await createTarballFromDirectory({
                      localDir: cloneDir,
                      archivePath: gitTarPath,
                      exclude: [".paperclip-runtime"],
                    });

View on GitHub (pinned to 01ad858492)

Solutions

1. Ensure the workspace has a valid git repository with at least one commit before preparing the runtime
2. Re-create or repair the git snapshot the runtime relies on
3. Run the workspace in non-git mode if git history is not required

When it happens

Trigger: Thrown at packages/adapter-utils/src/sandbox-managed-runtime.ts:1317 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-09-10). Data as JSON: /api/errors/c610c66e92e1906a. Report an issue: GitHub.