paperclipai/paperclip · error

Managed sandbox environment changed during reconciliation

Error message

Managed sandbox environment changed during reconciliation

What it means

Concurrency guard in ensureManagedSandboxEnvironment's update path: the targeted row's UPDATE ... RETURNING produced no row, meaning it disappeared or was modified by a concurrent transaction mid-reconciliation. Fails instead of assuming the environment is in the desired state.

Source

Thrown at server/src/services/environments.ts:651

          };
        }

        const updated = await tx
          .update(environments)
          .set({
            name: desiredName,
            description: input.description ?? null,
            config: desiredConfig,
            metadata: withoutManagedEnvironmentArchiveToken(
              mergeManagedEnvironmentMetadata(row.metadata, desiredMetadata, keys),
            ),
            status: "active",
            updatedAt: new Date(),
          })
          .where(eq(environments.id, row.id))
          .returning()
          .then((rows) => rows[0] ?? null);
        if (!updated) throw new Error("Managed sandbox environment changed during reconciliation");
        await writeBindings(
          updated.id,
          input.stockVersion ?? MANAGED_ENVIRONMENT_STOCK_VERSION,
          latestStockHash,
          desiredStock,
          true,
        );
        return {
          environment: toEnvironment(updated),
          action: "updated",
          stockStatus,
          updateAvailable: false,
          stockHash: latestStockHash,
        };
      },
    );
    if (reconciliation.action !== "unchanged" || trackingInitialized) {
      const action = reconciliation.action === "added"

View on GitHub (pinned to 01ad858492)

Solutions

1. Retry the reconciliation; the environment changed concurrently. Investigate concurrent modifications if it persists.

When it happens

Trigger: Thrown at server/src/services/environments.ts:651 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/8a180db28c91659e. Report an issue: GitHub.