paperclipai/paperclip · error · ManagedSandboxUnavailableError

This instance runs agents only in its platform-managed…

Error message

This instance runs agents only in its platform-managed sandbox environment (managed sandbox only), but no active managed sandbox environment exists — its provider plugin may be unavailable. Refusing to fall back to local execution.

What it means

Error "This instance runs agents only in its platform-managed sandbox environment (managed sandbox only), but no active managed sandbox environment exists — its provider plugin may be unavailable. Refusing to fall back to local execution." thrown in paperclipai/paperclip.

Solutions

1. Restore the managed sandbox environment (check its provider plugin availability) before running agents.
2. Change the instance execution policy if local execution fallback is acceptable.

When it happens

Trigger: Thrown at server/src/services/execution-workspace-policy.ts:291 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/9a3094a15b2273cf. Report an issue: GitHub.

Appendix: source

Thrown at server/src/services/execution-workspace-policy.ts:327

    if (input.agentDefaultEnvironmentId) {
      return {
        environmentId: input.agentDefaultEnvironmentId,
        source: "agent",
      };
    }
    if (input.instanceDefaultEnvironmentId) {
      return {
        environmentId: input.instanceDefaultEnvironmentId,
        source: "instance",
      };
    }
    return {
      environmentId: input.localDefaultEnvironmentId,
      source: "default",
    };
  })();
  if (input.managedSandboxOnly !== true || resolved.environmentId !== input.localDefaultEnvironmentId) {
    return resolved;
  }
  if (!input.managedSandboxEnvironmentId) {
    throw new ManagedSandboxUnavailableError();
  }
  return { environmentId: input.managedSandboxEnvironmentId, source: "managed" };
}

export function defaultIssueExecutionWorkspaceSettingsForProject(
  projectPolicy: ProjectExecutionWorkspacePolicy | null,
): IssueExecutionWorkspaceSettings | null {
  if (!projectPolicy?.enabled) return null;
  return {
    mode:
      projectPolicy.defaultMode === "isolated_workspace"
        ? "isolated_workspace"
        : projectPolicy.defaultMode === "operator_branch"
          ? "operator_branch"
          : projectPolicy.defaultMode === "adapter_default"

View on GitHub (pinned to 3f1d897a7c)