paperclipai/paperclip · error · ManagedSandboxUnavailableError

This instance runs agents only in its platform-managed sandb

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.

Source

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

        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"
            ? "agent_default"
            : "shared_workspace",
  };

View on GitHub (pinned to 120ae5428f)

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@120ae5428f (2026-08-18). Data as JSON: /api/errors/9a3094a15b2273cf. Report an issue: GitHub.